VelocityVanish

A lightweight vanish plugin for Velocity proxy servers. Vanished players are hidden from the tab list and trigger fake leave/join messages for players without the see permission.

Installation

1. Drop VelocityVanish.jar into your Velocity proxy's plugins/ folder.
2. Restart (or reload) the proxy.

Do not install this on your backend (Paper/Purpur) servers. It runs on the proxy only.

Commands

Command	Description
/vanish	Toggle vanish on yourself
/vanish <player>	Toggle vanish on another online player
/v	Alias for /vanish

Permissions

Permission	Description
vanish.use	Required to use /vanish at all
vanish.others	Required to vanish/unvanish other players
vanish.see	See vanished players in tab list; skip fake join/quit messages

How It Works

• Tab list — When a player vanishes, their entry is removed from the tab list of every player who does not have vanish.see. Players with vanish.see always see everyone.
• Fake messages — When a player vanishes, a fake left the game message is broadcast to players without vanish.see. When they unvanish, a fake joined the game message is broadcast.
• Server switches — The tab list is refreshed every time any player changes backend servers, keeping it accurate across your network.
• Disconnect cleanup — If a vanished player disconnects, they are automatically removed from the vanished set and the tab list is updated.

Limitations

• Vanish state is stored in memory only. If the proxy restarts, all players will be unvanished.
• Backend servers are unaware of vanish state. Players on the same backend server may still see vanished players through means other than the tab list (e.g. nearby detection in-game). For full invisibility, pair this with a backend vanish plugin.

Requirements

• Velocity 3.4.0 or newer
• Java 21+