BedWars1058-SpectatorFix

BedWars1058 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 held items, which can push iron golems off bridges or block item placement. - The ability to held items on them (and then sneaking to exit) does not always reset the spectator’s state correctly. - Spectators' held items 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.

all particle effects – 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”.

not – Normal players (including those who drink invisibility potions from the shop) are not 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`)

```yaml

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

- Works on any version supported by BedWars1058 – 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 after 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.*