PunisherX-Velocity-Bridge is a lightweight addon for Velocity networks that synchronizes bans and IP bans from PunisherX (Paper/Folia) via a shared database and instantly disconnects punished players on the proxy.
PunisherX Proxy-Bridge is a lightweight addon for Velocity/BungeeCord networks that synchronizes bans and IP bans from PunisherX (Paper/Folia) via a shared database and instantly disconnects punished players on the proxy.
Do you run a server network and find it frustrating when a player gets banned on one backend but can still stay on the lobby or hop between servers?
PunisherX Proxy-Bridge solves this problem.
The addon acts as a bridge between:
When an administrator issues a BAN/BANIP (even from the console and even if the backend is empty), PunisherX records the event in the bridge_events table.
Proxy-Bridge periodically reads these entries and immediately disconnects matching players on the proxy. After handling, it marks the entry as processed, ensuring the same event is not executed again.
Result: punishments are enforced across the entire network, not just on a single server.
PunisherX-<proxy>-Bridge-<version>.jar into the plugins folder on Velocity.bridge.properties.host, port, database, username, password) identical to PunisherX.poll-interval-ms (default: 1000 ms, minimum: 200 ms).This is an addon (bridge), not a standalone punishment system.
It requires the main PunisherX plugin on Paper/Folia and a shared database to function.