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+