SpySpectator v3.0.0

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 apidoc.md 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

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.

---

Developed by SpyGamingOG

SpySpectator v2.0.0

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

Spectator++ v1.0.6

SpectatorPlusPlus v1.0.6

📅 Release Information

• Version: 1.0.6
• Release Date: 10 January 2026

🎯 Major Improvements

🎮 Complete Gamemode Integration Overhaul

• Fixed /spectate command reliability – Now works correctly on first use for ALL gamemodes (Survival, Creative, Adventure)
• Eliminated double-command requirement – No longer need to execute /spectate twice to enter proper spectator mode
• Consistent entry experience – Same seamless transition regardless of starting gamemode

🔄 State Management & Transitions

• Fixed gamemode restoration – Players now correctly return to their original gamemode when leaving spectator mode
• Proper inventory cleanup – All spectator items are completely removed during gamemode transitions
• Flight state preservation – Flight abilities are correctly maintained when exiting spectator mode
• Clean visibility reset – Transparency/invisibility effects are properly cleared when changing gamemodes

🧭 Enhanced First-Person Spectating

• Fixed compass GUI interaction – Clicking player heads now works as intended
• Improved sneak-to-exit – Pressing sneak while in first-person view properly exits to SpectatorPlusPlus mode
• Resolved mode conflicts – No longer accidentally switches to vanilla Minecraft spectator mode

🛠️ System Architecture Improvements

• Removed deprecated features – Eliminated the spectator++ gamemode option from F3+F4 menu
• Stabilized state tracking – Improved management of player states across gamemode changes
• Enhanced exit mechanisms – Both bed usage and /spectator leave now work correctly

🔧 Technical Fixes

• Fixed spectator entry for Survival/Creative players (previously required Adventure mode first)
• Resolved inventory cleanup issues during gamemode transitions
• Fixed flight state corruption when leaving spectator mode
• Corrected visibility/transparency persistence bugs
• Improved first-person spectating exit behavior
• Eliminated spectator item retention in non-spectator gamemodes

📋 Behavior Matrix

Scenario	Before v1.0.6	After v1.0.6
Survival → Spectator	❌ Required 2 commands	✅ Works instantly
Creative → Spectator	❌ Items didn't work	✅ Proper spectator mode
Exit via bed	❌ Wrong gamemode/flight	✅ Correct restoration
First-person exit	❌ Went to Survival	✅ Returns to Spectator++
Gamemode switch	❌ Kept spectator items	✅ Clean inventory

🎮 User Experience Improvements

• Instant activation – Single /spectate command works immediately
• Predictable behavior – Consistent results across all gamemodes
• Clean transitions – No leftover spectator properties
• Intuitive controls – Sneak to exit first-person works reliably
• Professional workflow – Suitable for tournament observers and admins

🔗 Download

• Modrinth

---

Note: This release represents a significant stability improvement for gamemode transitions and spectator mode activation. The spectator system now behaves predictably and reliably regardless of the player's starting state, making it ideal for professional server administration and tournament observation scenarios.

Spectator++ v1.0.5

SpectatorPlusPlus v1.0.5

📅 Release Information

• Version: 1.0.5
• Release Date: 10 January 2026

🎯 What's New

🌍 World Transition Stability

• Fixed state persistence – Spectators now maintain all abilities and items when switching worlds
• Seamless world hopping – No more loss of spectator status during world transitions
• Consistent experience – Reliable spectator behavior across Overworld, Nether, and End dimensions

✈️ Flight System Improvements

• Uninterrupted flight – Flight ability is now preserved when changing worlds
• No manual re-enabling – Spectators no longer need to re-enable flight after world transitions
• Smooth movement – Consistent flying mechanics across all dimensions

🔧 Technical Enhancements

• Optimized spectator tags – "[Spectator]" prefix management is now more efficient
• Reduced performance overhead – Improved handling of spectator name updates
• Better event handling – World change events are now properly processed for spectators

🎮 Player Experience Fixes

• Persistent invisibility – Spectator invisibility no longer breaks during world changes
• Retained inventory – All spectator items remain in inventory after world transitions
• Reliable state management – Spectator mode is consistently applied across all worlds

🐛 Key Fixes

• Fixed spectator losing invisibility when switching worlds
• Fixed spectator flight being disabled after world changes
• Fixed spectator items disappearing during world transitions
• Improved efficiency of "[Spectator]" name tag system
• Resolved world-change state synchronization issues

🔄 World Transition Behavior (Before vs After)

Before v1.0.5	After v1.0.5
❌ Lost invisibility on world change	✅ Invisibility maintained
❌ Flight disabled after transition	✅ Flight persists
❌ Items disappeared	✅ Inventory preserved
⚠️ Inconsistent spectator tags	✅ Reliable tagging

🎯 Use Case Scenarios

• Tournament Observers: Seamlessly spectate matches across different arena worlds
• Server Admins: Monitor players in all dimensions without interruption
• Content Creators: Smooth recording experience when moving between worlds
• Multi-world Servers: Reliable spectator tools for complex server setups

📋 Updated Behavior Summary

• Spectators maintain full abilities across all world changes
• No manual intervention needed after dimension transitions
• All spectator tools and effects persist indefinitely
• Improved server performance for spectator management

🔗 Download

• Modrinth

---

Note: This release focuses on stability and consistency, ensuring spectators have a flawless experience when navigating between different worlds and dimensions. Perfect for servers with complex world setups or tournament environments requiring cross-world observation!

Spectator++ v1.0.4

SpectatorPlusPlus v1.0.4

📅 Release Information

• Version: 1.0.4
• Release Date: 10 January 2026

🎯 What's New

🎮 Enhanced Stealth & Audio Fixes

• Silenced spectator actions – Nearby players no longer hear spectator attack or swing sounds
• Completely silent spectators – All damage-related audio from spectator interactions is now muted
• Improved immersion – Non-spectators remain unaware of spectator presence during gameplay

👥 Tablist & Visibility Improvements

• Restored "[Spectator]" tags – Clear visual identification in player tablists
• Better player management – Admins can easily identify spectators at a glance

⚙️ Configuration & Management Upgrades

• Simplified lobby system – Consolidated into single spectator_lobby configuration section
• Configurable spectator effects – Night vision and invisibility now respect spectator.give-... settings
• Customizable hotbar layout – Item slots can be configured via hotbar-items.* settings
• Enhanced lobby command – /spectator lobby set now saves complete location data (world, coordinates, rotation)

🔧 Technical Improvements

• Better event handling – Proper cancellation of spectator-triggered damage and animation events
• Consistent lobby teleportation – Leaving spectator mode always uses the configured lobby location
• Optimized configuration management – Streamlined config parsing and validation

🐛 Key Fixes

• Fixed spectator attack/swing sounds being audible to nearby players
• Restored missing spectator tags in player tablists
• Improved configuration structure for better usability
• Enhanced command reliability for lobby setup

📋 Updated Configuration Structure

# New simplified structure:
spectator_lobby:
  world: world
  x: 0.5
  y: 64.0
  z: 0.5
  yaw: 0.0
  pitch: 0.0

# Configurable effects:
spectator:
  give-night-vision: true
  give-invisibility: true

# Customizable hotbar:
hotbar-items:
  compass-slot: 0
  eye-slot: 1
  # ... other slots

Spectator++ v1.0.3

SpectatorPlusPlus v1.0.3

📅 Release Information

• Version: 1.0.3
• Release Date: [08 January 2026]
• Previous Version: 1.0.2 (Released 8 days ago)

🚀 What's New & Fixed

Flight System Overhaul

• Completely fixed spectator flight mechanics
• Spectators can now fly smoothly without any movement restrictions or glitches

Visibility System Improvements

• Ender Eye Fix: The spectator's invisibility toggle item now works correctly
• Hand Item Visibility: Non-spectators no longer see the floating hand items of spectators
• Spectator Rendering: Non-spectators cannot see spectators at all when they're invisible

Tablist Enhancements

• Fixed multiple tablist display issues
• Improved spectator identification in player lists

New Command: /spectator visibility

A powerful new command for server operators to control spectator visibility manually:

• /spectator visibility on - Force spectators to be visible
• /spectator visibility off - Force spectators to be invisible
• /spectator visibility toggle - Toggle between visibility states

🐛 Bug Fixes Summary

• Fixed broken spectator flight mechanics
• Fixed non-functional Ender Eye toggle item
• Fixed tablist display glitches
• Fixed spectator visibility leaks where non-spectators could see hand items
• Added missing permission checks for visibility commands

🙌 Community Contributions

Special thanks to these community members who helped identify and report issues:

• Minemozi - Reported flight mechanics and visibility bugs
• Griffin - Found the Ender Eye toggle bug and provided testing feedback

📈 Coming Soon

• More frequent updates (aiming for weekly/bi-weekly releases)
• Additional spectator tools and features
• Performance optimizations

🔗 Download

• Modrinth

---

Note: This release focuses on stability and fixing critical issues that were affecting the core spectator experience. Your feedback continues to shape SpectatorPlusPlus!

Spectator++ v1.0.2

SpectatorPlusPlus v1.0.2

🎯 Overview

SpectatorPlusPlus v1.0.2 is a major stability and usability update that fixes critical issues with the compass GUI system and improves overall plugin performance. This release focuses on making the spectator experience seamless and intuitive.

🚀 What's Changed

🔧 Technical Improvements

• Refactored Code Structure: Completely reorganized the codebase for better maintainability and extensibility
• Enhanced Error Handling: Added comprehensive error recovery with user-friendly feedback messages
• Optimized Performance: Reduced event handling overhead with smarter listener registration
• Improved Config System: Reorganized configuration with better documentation and sensible defaults
• Better Item Management: Implemented proper locked spectator items with descriptive lore

🐛 Bug Fixes

• Fixed Compass Interaction: Resolved issue where compass wouldn't open GUI on right-click
• Fixed GUI Click Handling: Player heads in selection GUI now correctly initiate spectating
• Fixed Mode Transitions: Smooth transitions between normal, spectator, and first-person modes
• Fixed Visibility System: Proper show/hide logic between spectators and normal players
• Fixed Inventory Sync: Correct inventory handling during spectating sessions
• Fixed Permission Issues: Granular permission checking for all commands and features
• Fixed World Change Handling: Better spectator state management during world transitions

⚡ Performance Optimizations

• Removed redundant event listeners that caused conflicts
• Optimized inventory synchronization tasks
• Improved visibility update algorithms
• Reduced unnecessary Bukkit scheduler usage
• Cleaned up unused code and imports

📋 Installation & Upgrade

New Installation

1. Download SpectatorPlusPlus-1.0.2.jar
2. Place in your server's plugins/ folder
3. Start/Restart your server
4. Configure plugins/SpectatorPlusPlus/config.yml as needed

Upgrade from v1.0.1

1. Backup your current config.yml
2. Replace the old JAR file with v1.0.2
3. Start the server to generate new config options
4. Merge any custom settings from your backup
5. Run /spectator reload to apply changes

🔧 Configuration Changes

• Added spectator-items section for customizable item names and lore
• Enhanced messages section with more descriptive feedback
• Added performance tuning options
• Better default values and documentation

🎮 Key Features Working in This Release

• ✅ Compass GUI for player selection
• ✅ First-person spectating with sneak-to-exit
• ✅ Visibility toggle (Ender Eye)
• ✅ Chat toggle (Paper)
• ✅ Admin management commands
• ✅ World set detection

📊 Compatibility

• Minecraft: 1.21+
• Server Software: Spigot, Paper, Purpur
• Java: 17+
• Permissions: LuckPerms, PermissionsEx, etc.

🛠️ For Developers

• Cleaner plugin API
• Extensible architecture
• Comprehensive logging options
• No external dependencies

❤️ Thanks

Special thanks to all the testers and community members who reported issues and provided feedback!

---

Download: Modrinth (Recommended)
Issues: GitHub Issues
Source: GitHub Repository

Happy Spectating! 🎮

Spectator++ v1.0.1

SpectatorPlusPlus v1.0.1

🎯 What's Fixed

This release addresses critical spectator state management issues and improves overall stability.

🛠️ Fixed Issues

• Spectator State Management: Players no longer lose spectator status incorrectly
• First-Person Exit: Sneaking out of first-person view no longer breaks spectator mode
• Compass GUI: Fixed flash-display issue and improved stability
• Spectator Visibility: Spectators can now properly see each other
• Hotbar Items: All spectator tools function properly throughout sessions
• Admin Commands: /spectator switch and lobby commands work correctly
• Multi-Spectator: Multiple spectators no longer interfere with each other

⚙️ Improved

• Better state tracking for spectator mode transitions
• More descriptive error messages for debugging
• Consistent command functionality in all spectator states
• Proper tablist integration for spectator indicators

📋 Requirements

• Server: Paper/Spigot 1.21+
• Java: Java 17 or newer recommended

📦 Installation

1. Download SpectatorPlusPlus-1.0.1.jar
2. Place in your server's plugins/ folder
3. Restart server
4. Set lobby with /spectator lobby set

📚 Documentation

• Installation Guide
• Configuration Guide
• Usage Guide

🔗 Links

• Full Changelog
• Issue Tracker
• Wiki

⚠️ Important Notes

• Always backup your configuration before updating
• Test in development environment first
• Use /spectator reload instead of server /reload

---

Made with ❤️ by SpyGamingOG
For Minecraft 1.21+ servers

Spectator++ v1.0.0

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
• Commands & Permissions

🐛 Reporting Issues

Please report bugs on GitHub Issues

---

Made with ❤️ by SpyGamingOG