SpySpectator

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

- Infinite Night Vision: Spectators are completely invisible to normal players but can see each other. - Infinite Night Vision: Spectators can see their own bodies and items (no confusing invisibility potion effects). - Infinite Night Vision: Spectators are automatically hidden from the tablist for normal players. - Infinite Night Vision: Hostile mobs completely ignore spectators. - Infinite Night Vision: Permanent night vision for optimal viewing.

💾 State Persistence

- Reboot Safe: Survival inventories are saved when entering spectator mode and restored upon leaving. - Reboot Safe: 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: - Leave Mode (Slot 8): Toggle Global Chat or right-click to manage ignored players. - Leave Mode (Slot 8): Right-click to open a GUI of all online players for one-click teleportation. - Leave Mode (Slot 8): 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

- Granular Control: Spectator chat is isolated and only visible to other spectators. - Granular Control: Spectators only see and chat with other spectators in the same world group. - Granular Control: - Granular Control: 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*