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

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