SpySpectator

Changelog

---

[3.0.0] - 2026-06-23

Added

- Developer API Interface: Introduced SpySpectatorAPI containing static access points (isSpectator, enableSpectator, disableSpectator, getSpectators) for seamless external plugin integrations. - Custom Bukkit Events: Created custom cancelable events PlayerSpectateEvent and PlayerUnspectateEvent allowing plugins to intercept, block, or validate transitions into and out of spectator mode. - Target Platform Compatibility: Fully verified and optimized for Minecraft 1.21.11 (Paper API, Folia, Spigot, and Purpur platforms). - Developer API Documentation: Added a comprehensive [ApiDocs](https://https://github.com/spygamingog/SpySpectator) explaining Maven/Gradle dependencies, event handling, and method signatures.

Changed

- Refactored SpectatorManager to trigger and honor the cancellable states of the custom spectator events. - Updated project metadata, build configurations, and manifest versions to 3.0.0. ---

SpySpectator v2.0.1 Changelog

Improvements & Fixes

World Change Persistence

- Fixed an issue where spectators lost their items, flight, and visibility settings when teleporting between worlds (e.g., from Lobby to a Game Slot). - Spectator state is now automatically re-applied with a slight delay after world changes to override other plugin logic.

Chunk Loading Prevention

- Spectators are now prevented from generating new chunks. - Movement and teleportation into unloaded chunks are blocked to improve server performance.

Flight Stability

- Resolved conflicts with lobby protection plugins (SpyHunts) that were disabling spectator flight.

Enhanced Visibility

- Spectators can now instantly see players in active games (e.g., Manhunt matches) upon teleporting, bypassing strict game isolation rules.

Improved Compass Navigation

- The Spectator Compass now displays clean world aliases (e.g., "Manhunt Slot 1") instead of raw file paths. ---

SpySpectator v2.0.0 Changelog

SpySpectator v2.0.0 is a complete rewrite of the original spectator plugin, focusing on performance, robust state management, and enhanced user experience.

Key Features

True Spectator Mode

- Vanish-Style Invisibility: Spectators are completely invisible to normal players but can see each other. - Self-Visibility: Spectators can now see their own bodies, hands, and items (removed invisibility potion effect). - Tablist Hiding: Spectators are hidden from the tablist for normal players. - Mob Ignorance: Hostile mobs will completely ignore spectators (no targeting/aggro). - Infinite Night Vision: Spectators have permanent night vision for better visibility.

Persistence & State Management

- Inventory Saving: Player inventories are saved when entering spectator mode and restored upon leaving. - Location Persistence: Players return to their exact previous location when leaving spectator mode. - Reboot Safe: Spectator state and return locations are saved to disk (spectators.yml), persisting across server restarts. - Join/Quit Handling: Spectators stay in spectator mode when reconnecting. Join/Quit messages are silenced.

Tools & GUI

- Spectator Compass: Slot 4 contains a "Player Teleporter" compass. Right-click to open a GUI listing all online players for one-click teleportation. - Leave Item: Slot 8 contains a "Leave Spectator Mode" bed item for quick exit. - Admin Commands: - /spectator lobby set/remove: Set a specific lobby location for spectators to go to when leaving (optional). - /spectator: Toggle mode.

Chat Isolation

- Spectator Chat: Messages sent by spectators are only visible to other spectators. - Prefix: Spectator messages are prefixed with [Spec] for clarity. - Monitoring: Spectators can still see normal player chat to monitor the server.

Protections & Mechanics

- No Interactions: Spectators cannot break/place blocks, drop/pickup items, or interact with inventories/entities. - Invulnerability: Spectators take no damage (void, drowning, attacks, etc.). - Hunger & Air Lock: Hunger and oxygen levels are locked at maximum (no drowning bubbles). - GameMode Switching: Switching GameMode (e.g., to Creative) automatically exits Spectator mode cleanly, preserving the new GameMode. ##### Custom Preferences (New!) - Chat Toggle: Toggle spectator chat visibility (Global or per-player). - Visibility Toggle: Toggle visibility of other spectators (Global or per-player). - Settings GUI: New item in hotbar opens a Settings GUI to manage these preferences easily. - World Group Sync: Spectator chat and visibility are now synced based on world groups (only see/chat with spectators in the same world group).

Bug Fixes

- Fixed issue where players were invisible to themselves. - Fixed mobs occasionally tracking spectators. - Fixed non-spectators sometimes not seeing others after mode changes. - Fixed chat leaking to normal players. - Fixed visibility issues where spectators could sometimes see hidden players. --- Developed by SpyGamingOG

SpectatorPlus++ v1.0.6

Release Date: 10 January 2026 Minecraft: 1.21+

Bug Fixes

- Fixed /spectate command activation for all gamemodes - Removed need for double command entry - Fixed original gamemode restoration on exit - Fixed inventory cleanup when leaving spectator - Corrected flight state persistence - Fixed first-person spectate head clicks - Fixed sneak-to-exit in first-person view - Prevented accidental default spectator switching - Fixed visibility reset on gamemode change

Improvements

- Removed spectator++ from F3+F4 menu - Improved state management and cleanup - Consistent behavior across all starting gamemodes - Reliable exit via beds or /spectator leave [View v1.0.5 Changelog](https://modrinth.com/plugin/spectator-plus-plus/version/1…

SpectatorPlus++ v1.0.5

Release Date: 10 January 2026 Minecraft: 1.21+

Bug Fixes

- Fixed spectator state breaking on world change - Fixed invisibility resetting between worlds - Fixed spectator tools/inventory loss during transitions

Improvements

- Flight now persists across world changes - Optimized "[Spectator]" name tag performance - Maintains all spectator properties between worlds [View v1.0.4 Changelog](https://modrinth.com/plugin/spectator-plus-plus/version/1…

SpectatorPlus++ v1.0.4

Release Date: 10 January 2026 Minecraft: 1.21+

Sound Fixes

- Silenced spectator attack/swing sounds for other players - Removed spectator-caused damage sounds

Tablist Improvements

- Restored "[Spectator]" prefix in player tablist

Configuration Updates

- Consolidated lobby config into spectator_lobby section - Night vision/invisibility now respect spectator.give-... settings - Hotbar items configurable via hotbar-items.*

Command Improvements

- /spectator lobby set now saves yaw/pitch rotation - Leaving always teleports to configured spectator_lobby [View v1.0.3 Changelog](https://modrinth.com/plugin/spectator-plus-plus/version/1…

SpectatorPlus++ v1.0.3

Release Date: 08 January 2026 Minecraft: 1.21+

Bug Fixes

- Fixed spectator flight mechanics - Fixed Ender Eye invisibility toggle - Fixed tablist display issues - Fixed floating hand item visibility

New Features

- Added /spectator visibility command (on/off/toggle) [View v1.0.2 Changelog](https://modrinth.com/plugin/spectator-plus-plus/version/1…

SpectatorPlus++ v1.0.2

Release Date: 31 Dec 2025 Minecraft: 1.21+

Technical Improvements

- Refactored codebase for maintainability - Enhanced error handling and user feedback - Optimized event handling performance - Improved configuration organization - Locked spectator items with proper lore

Bug Fixes

- Fixed compass right-click GUI opening - Fixed GUI player head click spectating - Fixed mode transition smoothness - Fixed visibility show/hide logic - Fixed inventory sync during spectating - Fixed permission checking for commands - Fixed world change handling

Performance Optimizations

- Removed conflicting event listeners - Optimized inventory sync tasks - Reduced scheduler usage [View v1.0.1 Changelog](https://modrinth.com/plugin/spectator-plus-plus/version/1…

SpectatorPlus++ v1.0.1

Release Date: [Date] Minecraft: 1.21+

Bug Fixes

- Fixed spectator state loss - Fixed first-person spectating exit - Fixed /spectator leave reliability - Fixed compass GUI flash display - Fixed hotbar item functionality - Fixed mutual spectator visibility - Fixed admin commands (/spectator switch, lobby) - Fixed multi-spectator interference - Fixed spectator status detection

Improvements

- Improved state transition management - Better error messages for debugging - Enhanced command reliability - Improved tablist spectator indicators

Changes

- First-person spectating now only camera sync - Spectators can pass through entities/players - Added /spectator switch <player> command - Exit via sneak or bed item [View v1.0.0 Changelog](https://modrinth.com/plugin/spectator-plus-plus/version/1…

Spectator++ v1.0.0

Initial Release!

Spectator++ is an advanced spectator mode plugin for Minecraft Paper servers with world set support, body spectating, and intelligent visibility management.

Features

- Advanced spectator mode with invisibility - World set detection (MultiVerse support) - Body spectating with screen sync - Spectator compass GUI - Smart chat system - Full configuration support

Documentation

- [GitHub README](https://github.com/SpyGamingOG/SpectatorPlusPlus#readme)

Reporting Issues

Please report bugs on [GitHub Issues](https://github.com/SpyGamingOG/SpySpectator/issues) --- Made with ❤️ by SpyGamingOG