Velocity Vanish

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

- Disconnect cleanup — 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. - Disconnect cleanup — 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. - Disconnect cleanup — 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 21 or newer - Java 21+