# Changelog ## [3.0.1] - 2026-09-04 ### Added - Native Minecraft target selector support (`@s`, `@p`, `@a`, `@r`, `@e`) for `/spectate` and `/spectator switch`. - First-person camera spectating by right-clicking players (sneak to exit). - Tab completion for target selectors, player names, and subcommands. - Console command support for `/spectator reload`, `/spectator switch`, and `/spectator leave`. - Multi-page pagination for the Teleporter GUI. - `/spectator reload` command to hot-reload `config.yml`. - First-person camera and lobby management methods in `SpySpectatorAPI`. ### Fixed - Fixed critical item loss bug on server reboot by serializing inventories and armor to `spectators.yml`. - Fixed `/spectate` command not being registered. - Fixed permission issue preventing normal players from toggling spectator mode. - Fixed off-hand swap exploit with spectator utility tools. - Fixed skull click handling failing on colored names by using `PersistentDataContainer` UUIDs. - Fixed spectator death edge-cases to prevent utility item drops. - Removed phantom `SpyInventories` dependency from `plugin.yml`. ### Changed & Performance - Replaced synchronous chunk loading with `isChunkLoaded()` to eliminate chunk-crossing lag spikes. - Switched teleports to `player.teleportAsync()` for Paper and Folia thread safety. - Fully wired all messages, speeds, item slots, and titles to `config.yml`.

# 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.0.5)

## 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.0.4)

## 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.0.3)

## 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.0.2)

## 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.0.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.0.0)