# PunisherX Proxy-Bridge<\/p>\n
**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.<\/p>\n
## Description<\/p>\n
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?
\n**PunisherX Proxy-Bridge** solves this problem.<\/p>\n
The addon acts as a bridge between:<\/p>\n
* **PunisherX on Paper\/Folia** (where punishments are executed),
\n* **Velocity\/BungeeCord Proxy** (where the player is actually connected),
\n* **a shared database** (where punishment events are stored).<\/p>\n
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.
\nProxy-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.<\/p>\n
Result: punishments are enforced across the entire network, not just on a single server.<\/p>\n
## Features<\/p>\n
* \u2705 Synchronization of BAN\/BANIP between PunisherX and Velocity
\n* \u2705 Works with punishments issued via commands, console, and offline players
\n* \u2705 Immediate enforcement of punishments on the proxy
\n* \u2705 Simple configuration (MySQL + polling interval)
\n* \u2705 No manual kicking and no bypassing punishments between backends<\/p>\n
## Requirements<\/p>\n
* Java 21+
\n* Velocity 3.4+ \/ 3.5+
\n* PunisherX running on Paper\/Folia servers
\n* Shared MySQL\/MariaDB database for PunisherX and the bridge<\/p>\n
## Installation<\/p>\n
1. Place `PunisherX- ## Disclaimer<\/p>\n > This is an **addon (bridge)**, not a standalone punishment system. 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.<\/p>\n","protected":false},"featured_media":126217,"template":"","meta":{"_minecraft_slug":"punisherx-proxy-bridge","_minecraft_project_id":"WgXPpl4d","_minecraft_author":"WieszczY","_minecraft_license":"MIT","_minecraft_downloads":14,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"punisherx-proxy-bridge.zip","_minecraft_size_bytes":7915619,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:52:44.988659Z","_minecraft_date_created":"2026-04-15T22:13:40.076795Z","_minecraft_date_modified":"2026-04-11T16:03:02.910715Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/punisherx-proxy-bridge","_minecraft_icon_attachment_id":126217,"_minecraft_imported_at":"2026-06-07T10:03:31+00:00","_minecraft_import_hash":"a05a0a5274fa923634f1d5282e9cd513","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[894,126,867,92,985],"mod_loader":[895],"minecraft_version":[40,41,80,81,82,83,167,163],"class_list":["post-126216","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bungeecord","mod_category-management","mod_category-social","mod_category-utility","mod_category-velocity","mod_loader-bungeecord","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n2. Start the proxy to generate `bridge.properties`.
\n3. Configure DB credentials (`host`, `port`, `database`, `username`, `password`) identical to PunisherX.
\n4. (Optional) Set `poll-interval-ms` (default: `1000 ms`, minimum: `200 ms`).
\n5. Restart Velocity.<\/p>\n
\n> It requires the main **PunisherX** plugin on Paper\/Folia and a shared database to function.<\/p>\n","protected":false},"excerpt":{"rendered":"