PunisherX Proxy-Bridge
PunisherX Proxy-Bridge 是一个轻量级插件,适用于 Velocity/BungeeCord 网络,通过共享数据库同步 PunisherX(Paper/Folia)上的封禁和 IP 封禁信息,并在代理层即时断开被封禁玩家的连接。
描述
你是否在运营服务器网络时感到困扰:玩家在一个后端服务器上被封禁后,仍然可以留在大厅或在服务器之间跳转?
PunisherX Proxy-Bridge 解决了这个问题。
该插件充当以下三者之间的桥梁:
- Paper/Folia 上的 PunisherX(执行处罚的地方),
- Velocity/BungeeCord 代理(玩家实际连接的地方),
- 共享数据库(存储处罚事件的地方)。
当管理员发出 BAN/BANIP 命令时(即使是从控制台发出,即使后端服务器为空),PunisherX 会将该事件记录到 bridge_events 表中。
Proxy-Bridge 会定期读取这些条目,并立即在代理端断开匹配玩家的连接。处理完成后,它会将条目标记为已处理,确保同一事件不会被重复执行。
结果:处罚将在整个网络中生效,而不仅仅是在单个服务器上。
功能
- ✅ PunisherX 与 Velocity 之间的 BAN/BANIP 同步
- ✅ 支持通过命令、控制台以及离线玩家发出的处罚
- ✅ 在代理层即时执行处罚
- ✅ 配置简单(MySQL + 轮询间隔)
- ✅ 无需手动踢人,防止在后端服务器之间绕过处罚
要求
- Java 21+
- Velocity 3.4+ / 3.5+
- 在 Paper/Folia 服务器上运行的 PunisherX
- PunisherX 和桥接插件共用的 MySQL/MariaDB 数据库
安装
- 将
PunisherX-<proxy>-Bridge-<version>.jar 放入 Velocity 的 plugins 文件夹中。
- 启动代理以生成
bridge.properties 文件。
- 配置数据库凭据(
host、port、database、username、password),需与 PunisherX 保持一致。
- (可选)设置
poll-interval-ms(默认值:1000 ms,最小值:200 ms)。
- 重启 Velocity。
免责声明
这是一个附加插件(桥接模块),而非独立的处罚系统。
它需要在 Paper/Folia 上安装主插件 PunisherX 并共用数据库才能正常工作。
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
- Place
PunisherX-<proxy>-Bridge-<version>.jar into the plugins folder on Velocity.
- Start the proxy to generate
bridge.properties.
- Configure DB credentials (
host, port, database, username, password) identical to PunisherX.
- (Optional) Set
poll-interval-ms (default: 1000 ms, minimum: 200 ms).
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧