SpySpectator 👻

SpySpectator is the ultimate spectator plugin for modern Minecraft servers. It takes vanilla spectating to the next level with true invisibility, isolated chat, saved player states, and easy-to-use management tools that just work.

✨ Key Features

🛡️ True Spectator Mode

• Vanish-Style Invisibility: Spectators are completely invisible to normal players but spectators can see both.
• Self-Visibility: Spectators can see their own bodies and items.
• Tablist Hiding: Spectators names are hidden from the tablist for normal players.
• Mob Ignorance: Hostile mobs completely ignore spectators.
• Infinite Night Vision: Permanent night vision for optimal viewing.

💾 State Persistence

• Inventory Saving: Survival inventories are saved when entering spectator mode and restored upon leaving.
• Location Return: Players return to their exact previous location when exiting spectator mode.
• Reboot Safe: Spectator state and locations are saved to disk (spectators.yml), so players remain in spectator mode even after a server restart.

🎮 Interactive Tools & GUI

Spectators receive a hotbar of tools:

• Chat Settings (Slot 1): Toggle Global Chat or right-click to manage ignored players.
• Player Teleporter (Slot 4): Right-click to open a GUI of all online players for one-click teleportation.
• Visibility Settings (Slot 7): Toggle Global Visibility or right-click to hide specific spectators.
• Leave Mode (Slot 8): Right-click to quickly return to the lobby/survival mode.

💬 Chat & Visibility Control

• Chat Isolation: Spectator chat is isolated and only visible to other spectators.
• World Group Sync: Spectators only see and chat with other spectators in the same world group.
• Custom Preferences:
  • Global Toggles: Turn off all spectator chat or hide all other spectators.
  • Granular Control: Use the Settings GUI to ignore/hide specific players.

📜 Commands

🚀 Installation

1. Download SpySpectator.jar.
2. Place it in your server's plugins/ folder.
3. Restart your server.
4. (Optional) Set a lobby location using /spectator lobby set.

⚙️ Configuration

The plugin generates a config.yml (currently minimal) and a spectators.yml database.

• spectators.yml: Stores the UUIDs and return locations of active spectators. Do not edit this file manually while the server is running.

Developed by SpyGamingOG