BedWars1058-SpectatorFix

BedWarsSpectatorFix is a lightweight patch for the BedWars1058 plugin that fixes long‑standing spectator annoyances without breaking the original gameplay experience.

The Problem

BedWars1058's built‑in spectator mode has several glitches that distract players:

• Spectators have collision boxes, which can push iron golems off bridges or block item placement.
• The ability to spectate other players by clicking on them (and then sneaking to exit) does not always reset the spectator’s state correctly.
• Spectators' invisibility particles are visible to other players.
• Spectators' held items are visible to other players.

What This Plugin Does

Removes spectator collision boxes – Prevents spectators from blocking players, interfering with placed blocks, or pushing custom entities (iron golems, etc.). A low‑frequency refresh task (every 10 seconds) ensures the fix stays active.

Makes spectators fully invisible – Hides nameplates, removes all particle effects, and conceals the held item. No visible particles. No visible hand items. Perfect stealth.

Preserves original spectator items – The compass, team tracker, and any custom spectator items from other add‑ons remain untouched and fully functional (the plugin never changes your game mode).

Click‑to‑spectate works flawlessly – Left‑click or right‑click on any alive player to start spectating them; sneak (hold shift) to return to normal spectator mode.

Handles state reset after spectating – When you exit spectate mode by sneaking, the plugin automatically reapplies invisibility and collision fixes – you never become “glitched”.

Zero false positives – Normal players (including those who drink invisibility potions from the shop) are never affected. The plugin only touches players that BedWars1058 identifies as true spectators (arena.isSpectator() and not in arena.getPlayers()).

Emergency cleanup – If anything goes wrong (e.g., after uninstalling the plugin), run /bwsfix cleanup to instantly remove all infinite invisibility effects and restore visibility for everyone. Auto‑cleanup also runs when the plugin disables.

Installation & Requirements

1. Make sure you have BedWars1058 installed.
2. Drop the BedWarsSpectatorFix.jar into your server’s plugins/ folder.
3. Restart the server or reload the plugins.
4. The plugin works out of the box – no configuration needed unless you wish to enable debug‑mode in config.yml.

Configuration (config.yml)

# Whether to suppress extra particles/sounds (recommended: true)
mute-effects: true

# Debug logging (recommended: false)
debug-mode: false

# How often (in seconds) to re-apply collision fix (prevents pushing entities)
collision-refresh-interval: 10

# Automatically cleanup effects when plugin disables (recommended: true)
auto-cleanup-on-disable: true

Commands

• /bwsfix cleanup – Remove all infinite invisibility effects added by this plugin and restore player visibility.
  Permission: bwsfix.cleanup (OP by default).

Version Support

• Built against Paper 1.12.2 – fully tested on this version.
• Works on any version supported by BedWars1058 (1.8 – 1.21) – uses only stable BedWars1058 API calls.
• Java 11 or later required.

Notes

• This add‑on does not modify any core BedWars1058 files – it only listens to API events.
• If you use other spectator‑related add‑ons, place them after BedWarsSpectatorFix in the plugin load order (just rename the jar to start with zz_ if needed).
• The plugin keeps the inventory intact – it never clears your hotbar or spectator items.
• Uninstalling? Run /bwsfix cleanup first, then remove the jar. No leftover invisibility.

---

Enjoy a smoother spectating experience – no glitches, no false positives, no residual effects.