Minecraft plugin SuperVanish

🔌 About SuperVanish

SuperVanish is a Minecraft plugin for Bukkit/Spigot servers that allows server operators and staff to become completely invisible to other players. It aims to provide an undetectable vanish state suitable for moderation and testing while exposing an API for other plugins to interact with vanish state.

🎯 Purpose

The plugin's core purpose is moderation and administrative monitoring: let trusted staff observe player behavior without appearing in the playerlist, join/leave messages, or in-world presence for most players. It is intended for server owners, administrators, and plugin developers who need a reliable vanish implementation.

⚙️ Features

• Fully hides vanished players from other players (in-world visibility).
• Hides vanished players in the player list (tab) with configurable appearance for observers.
• Adjusts the reported online player count/server list when ProtocolLib is available.
• Layered permissions model to configure precisely who can see whom.
• Keeps vanish state across joins, restarts, and reloads.
• Optional integration points requiring ProtocolLib for advanced packet-based features.
• Optional recommendation to install OpenInv for improved "silent chest" behavior.
• Public VanishAPI for other plugins: methods to hide/show players, query invisible players, and listen to PlayerHideEvent/PlayerShowEvent.

🧩 Who It Is For

• Survival and SMP servers that need stealth moderation tools.
• Servers that want a vanish API for other moderation or utility plugins.
• Administrators who require configurable visibility rules and tablist control.

🏗️ Example Use Cases

• A moderator goes invisible to investigate a grief report without alerting suspects.
• A plugin queries VanishAPI to exclude vanished players from gameplay mechanics or reports.
• Server operators hide their presence during live tests to simulate player-only conditions.

⚙️ Installation

📥 Setup

• Download the official plugin JAR and place it in your server's plugins/ directory.
• Restart the server and verify SuperVanish loaded by checking console logs.
• If using ProtocolLib for extended features, install ProtocolLib as well and restart.

📦 Dependencies

• ProtocolLib (optional): required for packet-based features such as adjusting the player count and certain action-bar features.
• OpenInv (optional recommendation): improves silent chest behavior when interacting with inventories while vanished.

🧠 Technical Notes

• Platform: implemented as a Bukkit/Spigot plugin and exposes a Java API for other plugins.
• API: provides VanishAPI with methods to hide/show players, check vanish status, and retrieve lists of invisible players; includes PlayerHideEvent and PlayerShowEvent for event-driven integrations.
• Persistence: can return lists of all invisible players (online and offline) via the API; retrieving all invisible players may involve database access and should be used carefully off the main thread.
• License: released under the MIT license and source code is available in the project's repository.

🤝 When This Plugin Is Useful

If you need a vanish implementation that integrates with other plugins and supports nuanced visibility rules for moderation, SuperVanish provides an API-driven, configurable vanish with optional ProtocolLib/OpenInv integrations for improved behavior.