Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Skin Browser
  • Cape Gallery
  • Seed Vault
  • Blog
  • Guides

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

Site & Legal

  • About
  • Authors
  • Editorial Policy
  • Corrections
  • Contact
  • Privacy Policy
  • Terms of Service
  • DMCA
  • Sitemap

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
PunisherX-Proxy-Bridge
PluginMIT

PunisherX-Proxy-Bridge

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.

55
Downloads
0
Followers
1 months ago
Updated
📦
3
Versions
managementsocialutilitybungeecordvelocity
Download Latestv1.0.2-R0.1-SNAPSHOTView on Modrinth

📖About PunisherX-Proxy-Bridge

PunisherX Proxy-Bridge

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.

Description

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:

  • PunisherX on Paper/Folia (where punishments are executed),
  • Velocity/BungeeCord Proxy (where the player is actually connected),
  • a shared database (where punishment events are stored).

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.

Features

  • ✅ Synchronization of BAN/BANIP between PunisherX and Velocity
  • ✅ Works with punishments issued via commands, console, and offline players
  • ✅ Immediate enforcement of punishments on the proxy
  • ✅ Simple configuration (MySQL + polling interval)
  • ✅ No manual kicking and no bypassing punishments between backends

Requirements

  • Java 21+
  • Velocity 3.4+ / 3.5+
  • PunisherX running on Paper/Folia servers
  • Shared MySQL/MariaDB database for PunisherX and the bridge

Installation

  1. Place PunisherX-<proxy>-Bridge-<version>.jar into the plugins folder on Velocity.
  2. Start the proxy to generate bridge.properties.
  3. Configure DB credentials (host, port, database, username, password) identical to PunisherX.
  4. (Optional) Set poll-interval-ms (default: 1000 ms, minimum: 200 ms).
  5. Restart Velocity.

Disclaimer

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.

👥 Team & Contributors

No authors recorded.

⚙️ Compatibility

Environment
🖥️ Server-side
Loaders
bungeecordvelocity
Minecraft Versions
1.20.61.211.21.11.21.21.21.31.21.41.21.51.21.6+8 more

🔗 Links

Modrinth Page