**BedWarsSpectatorFix** is a lightweight patch for the **BedWars1058** plugin that fixes long\u2011standing spectator annoyances without breaking the original gameplay experience.<\/p>\n
## The Problem
\nBedWars1058’s built\u2011in spectator mode has several glitches that distract players:
\n– Spectators have **collision boxes**, which can push iron golems off bridges or block item placement.
\n– The ability to **spectate other players by clicking** on them (and then sneaking to exit) does not always reset the spectator\u2019s state correctly.
\n– Spectators’ **invisibility particles** are visible to other players.
\n– Spectators’ **held items** are visible to other players.<\/p>\n
## What This Plugin Does<\/p>\n
**Removes spectator collision boxes** \u2013 Prevents spectators from blocking players, interfering with placed blocks, or pushing custom entities (iron golems, etc.). A low\u2011frequency refresh task (every 10 seconds) ensures the fix stays active.<\/p>\n
**Makes spectators fully invisible** \u2013 Hides nameplates, removes **all particle effects**, and conceals the held item. No visible particles. No visible hand items. Perfect stealth.<\/p>\n
**Preserves original spectator items** \u2013 The compass, team tracker, and any custom spectator items from other add\u2011ons remain untouched and fully functional (the plugin never changes your game mode).<\/p>\n
**Click\u2011to\u2011spectate works flawlessly** \u2013 Left\u2011click or right\u2011click on any alive player to start spectating them; sneak (hold shift) to return to normal spectator mode.<\/p>\n
**Handles state reset after spectating** \u2013 When you exit spectate mode by sneaking, the plugin automatically reapplies invisibility and collision fixes \u2013 you never become \u201cglitched\u201d.<\/p>\n
**Zero false positives** \u2013 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()`).<\/p>\n
**Emergency cleanup** \u2013 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\u2011cleanup also runs when the plugin disables.<\/p>\n
## Installation & Requirements<\/p>\n
1. Make sure you have **BedWars1058** installed.
\n2. Drop the `BedWarsSpectatorFix.jar` into your server\u2019s `plugins\/` folder.
\n3. Restart the server or reload the plugins.
\n4. The plugin works out of the box \u2013 no configuration needed unless you wish to enable `debug\u2011mode` in `config.yml`.<\/p>\n
### Configuration (`config.yml`)
\n“`yaml
\n# Whether to suppress extra particles\/sounds (recommended: true)
\nmute-effects: true<\/p>\n
# Debug logging (recommended: false)
\ndebug-mode: false<\/p>\n
# How often (in seconds) to re-apply collision fix (prevents pushing entities)
\ncollision-refresh-interval: 10<\/p>\n
# Automatically cleanup effects when plugin disables (recommended: true)
\nauto-cleanup-on-disable: true
\n“`<\/p>\n
## Commands<\/p>\n
– `\/bwsfix cleanup` \u2013 Remove all infinite invisibility effects added by this plugin and restore player visibility.
\n Permission: `bwsfix.cleanup` (OP by default).<\/p>\n
## Version Support<\/p>\n
– **Built against Paper 1.12.2** \u2013 fully tested on this version.
\n– **Works on any version supported by BedWars1058** (1.8 \u2013 1.21) \u2013 uses only stable BedWars1058 API calls.
\n– Java 11 or later required.<\/p>\n
## Notes<\/p>\n
– This add\u2011on does **not** modify any core BedWars1058 files \u2013 it only listens to API events.
\n– If you use other spectator\u2011related add\u2011ons, place them **after** BedWarsSpectatorFix in the plugin load order (just rename the jar to start with `zz_` if needed).
\n– The plugin keeps the inventory intact \u2013 it never clears your hotbar or spectator items.
\n– Uninstalling? Run `\/bwsfix cleanup` first, then remove the jar. No leftover invisibility.<\/p>\n
—<\/p>\n
*Enjoy a smoother spectating experience \u2013 no glitches, no false positives, no residual effects.*<\/p>\n","protected":false},"excerpt":{"rendered":"
Fixes Bedwars1058 spectator collision box, invisibility particles, and held item visibility while preserving spectator items (compass, etc.). Supports spectating players by clicking on them and properly resets when sneaking.<\/p>\n","protected":false},"featured_media":27146,"template":"","meta":{"_minecraft_slug":"bedwars1058-spectatorfix","_minecraft_project_id":"mYVh6jS5","_minecraft_author":"xiyiji322","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":18,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bedwars1058-spectatorfix.zip","_minecraft_size_bytes":68034,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T22:38:05.270915Z","_minecraft_date_created":"2026-05-08T19:10:31.488090Z","_minecraft_date_modified":"2026-05-05T01:24:12.868955Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bedwars1058-spectatorfix","_minecraft_icon_attachment_id":27146,"_minecraft_imported_at":"2026-06-01T10:19:46+00:00","_minecraft_import_hash":"3a41f032dd707ca26eb66fd3a71904fa","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[866,90,127,129,92],"mod_loader":[132,134],"minecraft_version":[385,48,49,50,52,53,54,55,57,58,59,36,60,93,94,101,102,62,37,73,74,38,30,31],"class_list":["post-27145","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-minigame","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-12-2","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-8-8","minecraft_version-1-8-9"],"yoast_head":"\n