# FlowGate-Bridge<\/p>\n
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.<\/p>\n
## \u2728 Features<\/p>\n
* Dynamic commands from config (`\/servername`)
\n* Works with Citizens NPCs (player execution)
\n* No permissions required
\n* No command conflicts
\n* Extremely lightweight (no listeners, no loops)
\n* Fully proxy-compatible (BungeeCord, Waterfall, FlameCord)
\n* Zero hardcoded values \u2014 fully configurable<\/p>\n
—<\/p>\n
## \ud83d\udce6 How It Works<\/p>\n
FlowGate-Bridge acts as a backend bridge:<\/p>\n
“`text
\nPlayer\/NPC \u2192 \/command \u2192 Bridge (Paper) \u2192 Plugin Message \u2192 Proxy \u2192 Server Switch
\n“`<\/p>\n
* The plugin registers commands on the backend server
\n* When executed, it sends a plugin message to the proxy
\n* Your proxy plugin (e.g. FlowGate-Lite) handles the actual server connection<\/p>\n
—<\/p>\n
## \u2699\ufe0f Installation<\/p>\n
1. Install a proxy:<\/p>\n
* BungeeCord \/ Waterfall \/ FlameCord<\/p>\n
2. Install your proxy-side plugin (e.g. FlowGate-Lite)<\/p>\n
3. Install **FlowGate-Bridge** on your backend server (Paper\/Spigot)<\/p>\n
4. Configure both plugins with the same `slash-servers` section<\/p>\n
5. Restart server<\/p>\n
—<\/p>\n
## \ud83d\udcdd Configuration<\/p>\n
`config.yml`<\/p>\n
“`yaml
\nslash-servers:
\n survival: survival
\n skyblock: skyblock
\n wonderland: wonderland
\n“`<\/p>\n
### Format<\/p>\n
“` * `command` \u2192 what players\/NPCs execute (`\/survival`) —<\/p>\n ## \ud83d\udd01 Reload Command<\/p>\n “`bash * Reloads config —<\/p>\n ## \ud83e\udd16 Citizens NPC Example<\/p>\n “`bash * Player clicks NPC \u2192 executes `\/survival` —<\/p>\n ## \u26a0\ufe0f Important Notes<\/p>\n * Commands must match your proxy configuration —<\/p>\n ## \ud83e\udde0 Why This Plugin Exists<\/p>\n Minecraft processes commands on backend servers first. “` FlowGate-Bridge solves this cleanly by:<\/p>\n * registering commands on backend —<\/p>\n ## \ud83d\ude80 Performance<\/p>\n * No event listeners Overhead is effectively zero.<\/p>\n —<\/p>\n ## \ud83d\udd17 Compatibility<\/p>\n * Paper \/ Spigot (1.16+ recommended) —<\/p>\n ## \ud83d\udcc4 License<\/p>\n MIT License (or your preferred license)<\/p>\n —<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" Lightweight backend-to-proxy command bridge using plugin messaging.<\/p>\n","protected":false},"featured_media":71348,"template":"","meta":{"_minecraft_slug":"flowgate-bridge","_minecraft_project_id":"WAIcE2sc","_minecraft_author":"DarkZmaj","_minecraft_license":"MIT","_minecraft_downloads":30,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"flowgate-bridge.zip","_minecraft_size_bytes":4861,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:07:25.997658Z","_minecraft_date_created":"2026-03-22T03:05:09.829694Z","_minecraft_date_modified":"2026-03-22T01:47:50.510489Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/flowgate-bridge","_minecraft_icon_attachment_id":71348,"_minecraft_imported_at":"2026-06-04T01:19:37+00:00","_minecraft_import_hash":"d136d99fbb8bee5d51fbcbd8e75e20e4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,129,123,869],"mod_loader":[130,131,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-71347","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-transportation","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n
\n“`<\/p>\n
\n* `target-server` \u2192 server name in your proxy config<\/p>\n
\n\/flowgate-bridge reload
\n“`<\/p>\n
\n* Re-registers commands
\n* Applies changes instantly<\/p>\n
\n\/npc command add -p survival
\n“`<\/p>\n
\n* Bridge forwards to proxy
\n* Player is connected<\/p>\n
\n* Target servers must exist on proxy
\n* This plugin does **not** handle server switching itself
\n* Requires proxy plugin to complete routing<\/p>\n
\nWithout this bridge, proxy-only commands like `\/survival` will fail with:<\/p>\n
\nUnknown command
\n“`<\/p>\n
\n* forwarding them properly to proxy<\/p>\n
\n* No async tasks
\n* No heavy logic<\/p>\n
\n* BungeeCord \/ Waterfall \/ FlameCord
\n* Citizens (optional)<\/p>\n