FlowGate-Bridge
一个轻量级的 Paper/Spigot 插件,允许 Citizens NPC(或玩家)执行 /servername 命令,并通过 BungeeCord/Waterfall/FlameCord 代理无缝连接至服务器。
功能特性
- 来自配置的动态命令(
/servername)
- 支持 Citizens NPC(由玩家执行)
- 无需权限
- 无命令冲突
- 极其轻量(无监听器,无循环)
- 完全兼容代理(BungeeCord、Waterfall、FlameCord)
- 零硬编码值 — 完全可配置
工作原理
FlowGate-Bridge 充当后端桥接组件:
玩家/NPC → /command → Bridge (Paper) → 插件消息 → 代理 → 服务器切换
- 该插件在后端服务器上注册命令
- 当命令被执行时,它会向代理发送一条插件消息
- 你的代理端插件(例如 FlowGate-Lite)负责处理实际的服务器连接
安装指南
-
安装代理服务器:
- BungeeCord / Waterfall / FlameCord
-
在你的代理端安装插件(例如 FlowGate-Lite)
-
在您的后端服务器(Paper/Spigot)上安装 FlowGate-Bridge
-
使用相同的 slash-servers 部分配置这两个插件
-
重启服务器
配置
config.yml
slash-servers:
survival: survival
skyblock: skyblock
wonderland: wonderland
格式
<命令>: <目标服务器>
命令 → 玩家/NPC 执行的操作(例如 /survival)
目标服务器 → 代理配置中的服务器名称
重载命令
/flowgate-bridge reload
NPC 示例
/npc command add -p survival
- 玩家点击 NPC → 执行
/survival
- Bridge 转发到代理
- 玩家已连接
注意事项
- 命令必须与您的代理配置匹配
- 目标服务器必须在代理上存在
- 本插件不自行处理服务器切换
- 需要代理插件来完成路由
为什么需要这个插件
Minecraft 会首先在后台服务器上处理命令。
如果没有这个桥接,仅适用于代理的命令(如 /survival)将会失败并提示:
未知命令
FlowGate-Bridge 通过以下方式优雅地解决了这个问题:
性能表现
开销几乎为零。
? 兼容性
- Paper / Spigot(推荐使用 1.16+ 版本)
- BungeeCord / Waterfall / FlameCord
- Citizens(可选)
FlowGate-Bridge
A lightweight Paper/Spigot plugin that allows Citizens NPCs (or players) to execute /servername commands and seamlessly connect to servers through a BungeeCord/Waterfall/FlameCord proxy.
Features
- Dynamic commands from config (
/servername)
- Works with Citizens NPCs (player execution)
- No permissions required
- No command conflicts
- Extremely lightweight (no listeners, no loops)
- Fully proxy-compatible (BungeeCord, Waterfall, FlameCord)
- Zero hardcoded values — fully configurable
How It Works
FlowGate-Bridge acts as a backend bridge:
Player/NPC → /command → Bridge (Paper) → Plugin Message → Proxy → Server Switch
- The plugin registers commands on the backend server
- When executed, it sends a plugin message to the proxy
- Your proxy plugin (e.g. FlowGate-Lite) handles the actual server connection
Installation
-
Install a proxy:
- BungeeCord / Waterfall / FlameCord
-
Install your proxy-side plugin (e.g. FlowGate-Lite)
-
Install FlowGate-Bridge on your backend server (Paper/Spigot)
-
Configure both plugins with the same slash-servers section
-
Restart server
Configuration
config.yml
slash-servers:
survival: survival
skyblock: skyblock
wonderland: wonderland
Format
<command>: <target-server>
command → what players/NPCs execute (/survival)
target-server → server name in your proxy config
Reload Command
/flowgate-bridge reload
- Reloads config
- Re-registers commands
- Applies changes instantly
Citizens NPC Example
/npc command add -p survival
- Player clicks NPC → executes
/survival
- Bridge forwards to proxy
- Player is connected
Important Notes
- Commands must match your proxy configuration
- Target servers must exist on proxy
- This plugin does not handle server switching itself
- Requires proxy plugin to complete routing
Why This Plugin Exists
Minecraft processes commands on backend servers first.
Without this bridge, proxy-only commands like /survival will fail with:
Unknown command
FlowGate-Bridge solves this cleanly by:
- registering commands on backend
- forwarding them properly to proxy
Performance
- No event listeners
- No async tasks
- No heavy logic
Overhead is effectively zero.
? Compatibility
- Paper / Spigot (1.16+ recommended)
- BungeeCord / Waterfall / FlameCord
- Citizens (optional)
评论 0
登录后参与评分
还没有评论,来抢沙发吧