SpySpectator 👻
SpySpectator is a robust, feature-rich spectator mode plugin designed for modern Minecraft servers. It goes beyond vanilla spectator mode by offering true invisibility, state persistence, chat isolation, and advanced management tools.
✨ Key Features
🛡️ True Spectator Mode
- Vanish-Style Invisibility: Spectators are completely invisible to normal players but can see each other.
- Self-Visibility: Spectators can see their own bodies and items (no confusing invisibility potion effects).
- Tablist Hiding: Spectators are automatically 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
