ProxyBridge

ProxyBridge — companion client mod

🧪 Beta preview — pairs with the 5.x line. ProxyBridge is a separate Fabric client mod that the bot's members install in their own Minecraft. Repo + downloads: github.com/aquariusnetwork9/ProxyBridge (MC 1.21.4, Fabric, Java 21). Built but not yet fully live-tested in-world.

ProxyBridge is the client half of AquariusProxy. It talks to a bot two ways: a plugin channel (proxybridge:main) when you're connected through the proxy, and the bot's HTTP command API (token-authed, gated by Access Control) when you're out in the world. Think of it as a stripped-down, in-game Discord for the bot — commands and feedback, governed by your RBAC role.

Commands are under /proxybridge (alias /pb).

What it does

• Live waypoints — the bot streams its PearlDrop empty stasis chambers to your client; they render as in-world boxes + an on-screen HUD list, and mirror into Xaero's Minimap if installed. They update hands-free as chambers fill.
• Pearl pull from anywhere — /pb pull (or a keybind) pulls your stasis pearl: instantly over the bridge channel when you're connected through the proxy, else over the bot's HTTP API. Works for a member out in the world with just an IP + token.
• Multi-bot — register several bots you have tokens for and target them individually (/pb pull <bot>, /pb cmd <bot> …).
• In-game RBAC admin — /pb admin opens a GUI to manage roles, capability checkboxes, and tokens (needs an admin token) — the Access Control panel without Discord.
• Position reporting (opt-in) — /pb reportpos on POSTs your live location to the bot so its WhisperControl come/protect can reach you when you're outside its render distance.
• Off-chat goto (new, mod 0.4.0 / proxy 5.3) — /pb goto <x y z> sends a destination to the bot over the API only; the coordinates never travel over Minecraft chat. It even captures a habitual /w <bot> goto … whisper and reroutes it (or blocks it if there's no API), so a base location can't leak.
• Whisper-intercept (mute bypass) — /w <bot> <command> to a registered bot is rerouted over the API instead of in-game chat, so a chat-muted member can still drive their bot.

Setup

1. Install the mod (Fabric + Fabric API on 1.21.4). Optional: Xaero's Minimap for the map waypoints.
2. Ask the bot owner for the bot's API address + your token (they perms token issue <you> and expose the API — see Access Control).
3. Register the bot and make it your default:

/pb bots add <id> <ip:port> <token>
/pb bots default <id>
/pb bots ign <id> <botIGN>      # so /w <botIGN> … reroutes to its API

4. Bind the pull keybind under Controls → ProxyBridge if you want one-key pulls.

Commands

/pb status                         # bridge / channel / waypoint status
/pb pull [bot]                     # pull your pearl (channel-first, else HTTP)
/pb goto <x> <y> <z>               # send the bot to coords over the API (never chat)
/pb cmd <command>                  # send a command to the proxy you're connected through
/pb bots list
/pb bots add <id> <url> <token>
/pb bots del <id> | default <id>
/pb bots ign <id> <ign>            # match /w <ign> … to this bot
/pb bots pearlid <id> <pearlId>    # which pearl /pb pull loads
/pb bots cmd <id> <command>        # run a command on one specific bot's API
/pb admin [bot]                    # open the in-game RBAC admin screen
/pb reportpos <on/off>             # report your position to your default bot
/pb reportpos interval <ticks>     # how often (20 = ~1/s)
/pb whisper <on/off>               # whisper-intercept (mute-safe API reroute)
/pb bridgepull <on/off>            # use the instant plugin channel for pulls
/pb hud <on/off> | boxes <on/off> | xaero <on/off>   # waypoint rendering

⚠️ Privacy. reportpos shares your live location with the bot's owner — it's off by default. Turn it on only for bots you trust.