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

Command	Description	Permission
`/spectator`	Toggle spectator mode on/off.	`spyspectator.use` (default: op)
`/spectator <player>`	Toggle spectator mode for another player.	`spyspectator.admin`
`/spectator lobby set`	Set the lobby location where players go when leaving spectator mode.	`spyspectator.admin`
`/spectator lobby remove`	Remove the set lobby location.	`spyspectator.admin`

🚀 Installation

Download SpySpectator.jar.
Place it in your server's plugins/ folder.
Restart your server.
(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