Перейти к содержимому
Mineforgian

SpySpectator

Advanced Spectator mode with advanced tools and world set detection and first-person spectating for Minecraft servers

Загрузки
817
Подписчики
1
Обновлён
23 июня 2026 г.
Лицензия
MIT

Опубликован 25 декабря 2025 г.

Исходный кодСообщить об ошибке

SpySpectator v3.0.0

SpySpectator is a high-performance, feature-rich spectator mode plugin designed for modern Minecraft servers. Built on the Paper API, it extends standard vanilla spectator capabilities by implementing complete player invisibility, persistence of inventories and positions across restarts, isolated chat channels, and interactive moderator utilities.

This plugin is optimized for Minecraft 1.21.11 and is compatible with Spigot, Paper, Folia, and Purpur server environments.

Key Features

Complete Player Occlusion

  • Vanish Integration: Spectators are hidden from normal players and excluded from client renderings, packets, and server tablists.
  • Client-Side Self-Rendering: Spectators retain visibility of their own avatars and equipment rather than relying on confusing invisibility potion effects.
  • Evasion & Night Vision: Mobs ignore spectating players. Spectators automatically receive permanent night vision.

State & Inventory Persistence

  • Inventory Caching: Survival inventories and player configurations are stored securely when entering spectator mode and restored exactly upon exit.
  • Location Synchronization: Players return to their precise origin coordinates when leaving spectator mode.
  • Persistence Across Restarts: Active spectator statuses and exit parameters are saved to disk (spectators.yml), keeping players in spectator mode after server reboots.

Interactive Spectator Utilities

Upon entering spectator mode, players receive a utility hotbar:

  • Chat Settings (Slot 1): Toggle spectator chat preferences or manage ignored players.
  • Player Teleporter (Slot 4): Right-click opens a graphical user interface displaying all online players for quick teleportation.
  • Visibility Toggle (Slot 7): Change spectator visibility preferences or hide specific spectators.
  • Leave Mode (Slot 8): Right-click to exit spectator mode and return to the lobby or survival location.

Isolated Communication

  • Isolated Chat Channels: Messages sent by spectators are filtered so they are only readable by other spectators.
  • World Group Synchronizations: Spectators only see and communicate with other spectators residing within the same world groups.

Developer Integrations

SpySpectator includes a developer API allowing third-party plugins to programmatically register spectators and listen to custom events:

  • SpySpectatorAPI: Static interface for managing spectator states.
  • PlayerSpectateEvent / PlayerUnspectateEvent: Cancelable Bukkit events for controlling entry and exit flows.

For detailed developer instructions, see the API Documentation.

Commands and Permissions

Command Description Permission
/spectator Toggle spectator mode for the executing player. spyspectator.use (Default: OP)
/spectator <player> Toggle spectator mode for another player. spyspectator.admin
/spectator lobby set Set the target lobby location when players exit spectator mode. spyspectator.admin
/spectator lobby remove Remove the configured lobby location. spyspectator.admin

Installation

  1. Download the latest compiled SpySpectator.jar.
  2. Place the file into your server's plugins/ directory.
  3. Restart the server to initialize the default configurations.
  4. (Optional) Define an exit lobby using /spectator lobby set.

Configuration

The plugin manages two primary files inside its data directory:

  • config.yml: Standard configuration parameters.
  • spectators.yml: Flat-file database containing the UUIDs and restoration settings for active spectators. Do not modify this file manually while the server is active.

Ченджлог

3.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 23 июня 2026 г.

Changelog

[3.0.0] - 2026-06-23

Added

  • Developer API Interface: Introduced SpySpectatorAPI containing static access points (isSpectator, enableSpectator, disableSpectator, getSpectators) for seamless external plugin integrations.
  • Custom Bukkit Events: Created custom cancelable events PlayerSpectateEvent and PlayerUnspectateEvent allowing plugins to intercept, block, or validate transitions into and out of spectator mode.
  • Target Platform Compatibility: Fully verified and optimized for Minecraft 1.21.11 (Paper API, Folia, Spigot, and Purpur platforms).
  • Developer API Documentation: Added a comprehensive ApiDocs explaining Maven/Gradle dependencies, event handling, and method signatures.

Changed

  • Refactored SpectatorManager to trigger and honor the cancellable states of the custom spectator events.
  • Updated project metadata, build configurations, and manifest versions to 3.0.0.
2.0.1Релиз1.21.9, 1.21.10, 1.21.11 · 8 февраля 2026 г.

SpySpectator v2.0.1 Changelog

🔧 Improvements & Fixes

🌍 World Change Persistence

  • Fixed an issue where spectators lost their items, flight, and visibility settings when teleporting between worlds (e.g., from Lobby to a Game Slot).
  • Spectator state is now automatically re-applied with a slight delay after world changes to override other plugin logic.

🚫 Chunk Loading Prevention

  • Spectators are now prevented from generating new chunks.
  • Movement and teleportation into unloaded chunks are blocked to improve server performance.

✈️ Flight Stability

  • Resolved conflicts with lobby protection plugins (SpyHunts) that were disabling spectator flight.

👁️ Enhanced Visibility

  • Spectators can now instantly see players in active games (e.g., Manhunt matches) upon teleporting, bypassing strict game isolation rules.

🧭 Improved Compass Navigation

  • The Spectator Compass now displays clean world aliases (e.g., "Manhunt Slot 1") instead of raw file paths.
2.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 7 февраля 2026 г.

SpySpectator v2.0.0 Changelog

SpySpectator v2.0.0 is a complete rewrite of the original spectator plugin, focusing on performance, robust state management, and enhanced user experience.

🌟 Key Features

👻 True Spectator Mode

  • Vanish-Style Invisibility: Spectators are completely invisible to normal players but can see each other.
  • Self-Visibility: Spectators can now see their own bodies, hands, and items (removed invisibility potion effect).
  • Tablist Hiding: Spectators are hidden from the tablist for normal players.
  • Mob Ignorance: Hostile mobs will completely ignore spectators (no targeting/aggro).
  • Infinite Night Vision: Spectators have permanent night vision for better visibility.

💾 Persistence & State Management

  • Inventory Saving: Player inventories are saved when entering spectator mode and restored upon leaving.
  • Location Persistence: Players return to their exact previous location when leaving spectator mode.
  • Reboot Safe: Spectator state and return locations are saved to disk (spectators.yml), persisting across server restarts.
  • Join/Quit Handling: Spectators stay in spectator mode when reconnecting. Join/Quit messages are silenced.

🛠️ Tools & GUI

  • Spectator Compass: Slot 4 contains a "Player Teleporter" compass. Right-click to open a GUI listing all online players for one-click teleportation.
  • Leave Item: Slot 8 contains a "Leave Spectator Mode" bed item for quick exit.
  • Admin Commands:
    • /spectator lobby set/remove: Set a specific lobby location for spectators to go to when leaving (optional).
    • /spectator: Toggle mode.

💬 Chat Isolation

  • Spectator Chat: Messages sent by spectators are only visible to other spectators.
  • Prefix: Spectator messages are prefixed with [Spec] for clarity.
  • Monitoring: Spectators can still see normal player chat to monitor the server.

🛡️ Protections & Mechanics

  • No Interactions: Spectators cannot break/place blocks, drop/pickup items, or interact with inventories/entities.
  • Invulnerability: Spectators take no damage (void, drowning, attacks, etc.).
  • Hunger & Air Lock: Hunger and oxygen levels are locked at maximum (no drowning bubbles).
  • GameMode Switching: Switching GameMode (e.g., to Creative) automatically exits Spectator mode cleanly, preserving the new GameMode.
⚙️ Custom Preferences (New!)
  • Chat Toggle: Toggle spectator chat visibility (Global or per-player).
  • Visibility Toggle: Toggle visibility of other spectators (Global or per-player).
  • Settings GUI: New item in hotbar opens a Settings GUI to manage these preferences easily.
  • World Group Sync: Spectator chat and visibility are now synced based on world groups (only see/chat with spectators in the same world group).

🐛 Bug Fixes

  • Fixed issue where players were invisible to themselves.
  • Fixed mobs occasionally tracking spectators.
  • Fixed non-spectators sometimes not seeing others after mode changes.
  • Fixed chat leaking to normal players.
  • Fixed visibility issues where spectators could sometimes see hidden players.

Developed by SpyGamingOG

1.0.6Релиз1.21.9, 1.21.10, 1.21.11 · 10 января 2026 г.

SpectatorPlus++ v1.0.6

Release Date: 10 January 2026
Minecraft: 1.21+

🐛 Bug Fixes

  • Fixed /spectate command activation for all gamemodes
  • Removed need for double command entry
  • Fixed original gamemode restoration on exit
  • Fixed inventory cleanup when leaving spectator
  • Corrected flight state persistence
  • Fixed first-person spectate head clicks
  • Fixed sneak-to-exit in first-person view
  • Prevented accidental default spectator switching
  • Fixed visibility reset on gamemode change

✨ Improvements

  • Removed spectator++ from F3+F4 menu
  • Improved state management and cleanup
  • Consistent behavior across all starting gamemodes
  • Reliable exit via beds or /spectator leave

View v1.0.5 Changelog

1.0.5Релиз1.21.9, 1.21.10, 1.21.11 · 10 января 2026 г.

SpectatorPlus++ v1.0.5

Release Date: 10 January 2026
Minecraft: 1.21+

🐛 Bug Fixes

  • Fixed spectator state breaking on world change
  • Fixed invisibility resetting between worlds
  • Fixed spectator tools/inventory loss during transitions

✨ Improvements

  • Flight now persists across world changes
  • Optimized "[Spectator]" name tag performance
  • Maintains all spectator properties between worlds

View v1.0.4 Changelog

1.0.4Релиз1.21.9, 1.21.10, 1.21.11 · 9 января 2026 г.

SpectatorPlus++ v1.0.4

Release Date: 10 January 2026
Minecraft: 1.21+

🔇 Sound Fixes

  • Silenced spectator attack/swing sounds for other players
  • Removed spectator-caused damage sounds

📋 Tablist Improvements

  • Restored "[Spectator]" prefix in player tablist

⚙️ Configuration Updates

  • Consolidated lobby config into spectator_lobby section
  • Night vision/invisibility now respect spectator.give-... settings
  • Hotbar items configurable via hotbar-items.*

🛠️ Command Improvements

  • /spectator lobby set now saves yaw/pitch rotation
  • Leaving always teleports to configured spectator_lobby

View v1.0.3 Changelog

1.0.3Релиз1.21.9, 1.21.10, 1.21.11 · 7 января 2026 г.

SpectatorPlus++ v1.0.3

Release Date: 08 January 2026
Minecraft: 1.21+

🐛 Bug Fixes

  • Fixed spectator flight mechanics
  • Fixed Ender Eye invisibility toggle
  • Fixed tablist display issues
  • Fixed floating hand item visibility

✨ New Features

  • Added /spectator visibility command (on/off/toggle)

View v1.0.2 Changelog

1.0.2Релиз1.21.9, 1.21.10, 1.21.11 · 30 декабря 2025 г.

SpectatorPlus++ v1.0.2

Release Date: 31 Dec 2025
Minecraft: 1.21+

🔧 Technical Improvements

  • Refactored codebase for maintainability
  • Enhanced error handling and user feedback
  • Optimized event handling performance
  • Improved configuration organization
  • Locked spectator items with proper lore

🐛 Bug Fixes

  • Fixed compass right-click GUI opening
  • Fixed GUI player head click spectating
  • Fixed mode transition smoothness
  • Fixed visibility show/hide logic
  • Fixed inventory sync during spectating
  • Fixed permission checking for commands
  • Fixed world change handling

⚡ Performance Optimizations

  • Removed conflicting event listeners
  • Optimized inventory sync tasks
  • Reduced scheduler usage

View v1.0.1 Changelog

Комментарии

Загружаем…