SuperVanish
repository·master·Indexed 40 days ago
https://github.com/leonmangler/supervanishA Bukkit plugin for Spigot/CraftBukkit servers that allows administrators to become invisible and undetectable to players. It includes features for managing vanished states, toggling item pickup visibility, and administrative tools such as configuration reloading and file recreation. Version 6.2.18-3 is available via JitPack for integration into Java projects.
What's inside SuperVanish
- SuperVanish is a Bukkit plugin designed for Spigot/CraftBukkit Minecraft servers. It provides server administrators with the ability to become completely invisible and undetectable to other players, facilitating administrative tasks without interference.
Install SuperVanish via Maven
masterTo use SuperVanish as a dependency in your Java project, add the JitPack repository and the SuperVanish dependency to your
pom.xmlfile. This allows you to integrate SuperVanish functionality into your own Bukkit/Spigot plugins.<repositories> <repository> <id>jitpack.io</id> <url>https://jitpack.io</url> </repository> </repositories> <dependencies> <!-- SuperVanish --> <dependency> <groupId>com.github.LeonMangler</groupId> <artifactId>SuperVanish</artifactId> <version>6.2.18-3</version> </dependency> </dependencies>Vanish another player via subcommand
masterThe
VanishOthersubcommand allows administrators to force a specific player into a vanished (invisible) state or make them visible again. This command supports both online players and offline players (via name lookup).Usage Patterns
To vanish an online player:
[command] <on|enable|vanish> <player_name> [options]To make an online player visible:
[command] <player_name> [options]To vanish an offline player:
[command] <on|enable|vanish> <player_name>Options
-s: Silent mode. When used, the command will not send a confirmation message to the sender (though behavior regarding whether the target is notified depends on the specificShowOtherMessageimplementation).
Permissions and Restrictions
- Permission Required: The sender must have the
CommandAction.VANISH_OTHERpermission. - Player Protection: If a target player has the permission
sv.notoggle, they cannot be hidden by other players unless the sender has higher authority (the code checkstarget.hasPermission("sv.notoggle")). - Layered Permissions: If the setting
IndicationFeatures.LayeredPermissions.HideInvisibleInCommandsis enabled, players who do not have permission to see a vanished player will receive aPlayerNonExistentmessage instead of being told the player is already invisible.
Recreate configuration and messages files
masterUse the
recreatefilessubcommand to refresh yourconfig.ymland/ormessages.ymlfiles. This is typically used when a plugin update introduces new settings or messages that are missing from your existing configuration files.Usage
Confirming an update: If the plugin detects that updates are required, you must provide a confirmation argument to proceed with recreating the files.
/supervanish recreatefiles confirmForcing an update: If no updates are detected by the plugin, or if you want to overwrite your current files regardless of version changes, use the
forceargument. This will recreate both the config and the messages files./supervanish recreatefiles forceDismissing warnings: If you are seeing update warnings but do not wish to recreate the files, you can dismiss the warning for your current version.
/supervanish recreatefiles dismissArguments
Argument Description confirmConfirms the recreation of files that the plugin has flagged as needing an update. forceForces the recreation of both config.ymlandmessages.yml, even if no updates are detected.dismissDismisses the update warning for the current version. Permissions
Requires the
RECREATE_FILESaction permission./supervanish recreatefiles forceUse the vanish command to hide or show yourself
masterThe
vanishsubcommand (implemented viaVanishSelf) allows players with theVANISH_SELFpermission to toggle their visibility.Usage Patterns
- Toggle visibility: Running the command without arguments toggles your vanished state. If you are vanished, you will reappear; if you are visible, you will vanish.
- Reappear: Use
off,reappear, ordisableas an argument to force yourself to become visible. If you are not currently vanished, you will receive aNotVanishedError. - Silent toggle: Use the
-sflag to toggle your vanished state without triggering visibility changes for other players (silent vanish/reappear). - Manual vanish: Providing any other single argument while visible will trigger a vanish. If you are already vanished, you will receive an
AlreadyVanishedError.
# Toggle vanish state /vanish # Force reappear /vanish off /vanish reappear /vanish disable # Silent toggle (no visibility changes for others) /vanish -sList all vanished players with /vanish list
masterUse the
/vanish listsubcommand to retrieve a list of all players currently in vanish mode.- If no players are vanished, the command returns a message containing
none. - If players are vanished, it lists their names separated by commas.
- Players who are currently offline will have an
[offline]suffix appended to their name in red text. - This command requires the
VANISHED_LISTpermission.
/vanish list- If no players are vanished, the command returns a message containing
Toggle item pickup visibility with /supervanish toggleitempickups
masterUse this subcommand to toggle whether a vanished player's item pickups are visible to others. When enabled, other players will see the items being picked up by the vanished player; when disabled, these actions are hidden.
Note: This command requires the
TOGGLE_ITEM_PICKUPSpermission./supervanish toggleitempickupsBroadcast logout messages via /sv broadcast logout
masterThe
broadcast logoutsubcommand allows authorized users to force a broadcast of logout messages to all online players. This is useful for notifying the server when a player leaves, using the configuredVanishMessagetemplate.Execution requires the
BROADCAST_LOGOUTpermission. If the sender does not have this permission, the command will not execute./sv broadcast logoutReload SuperVanish configuration
masterThe
reloadsubcommand allows administrators to reload the SuperVanish plugin configuration without restarting the entire server. This command triggers a plugin reload process and notifies the sender upon successful completion.Note: This command requires the
RELOADpermission level. If the reload fails because the plugin fails to restart itself, an error message will be sent in red text, and details will be logged to the server console.Use the /supervanish help subcommand
masterThe
ShowHelpsubcommand displays a list of all available SuperVanish commands and their usage. The output includes the command usage, a brief description, and the required permission for each action. Access to this help command is governed by theCommandAction.SHOW_HELPpermission./* Note: This is a subcommand of the main SuperVanish command. Usage depends on the primary command prefix. */Use the printstacktrace subcommand
masterThe
printstacktracesubcommand allows authorized users to trigger a stacktrace log in the server console. This is typically used for debugging plugin issues or inspecting the current state of the plugin's execution flow. Execution requires thePRINT_STACKTRACEpermission./sv printstacktraceUse the /broadcastlogin subcommand
masterThe
/broadcastloginsubcommand allows authorized users to manually trigger a broadcast message to all online players, notifying them of a player's reappearance (typically used when a vanished player reappears).This command requires the
BROADCAST_LOGINpermission. When executed, it iterates through all online players and sends them the message defined by theReappearMessageconfiguration key./broadcastlogin