Whats New

What's New — 5.x Beta Preview

🧪 Beta channel. Everything on this page was added on the 5.x line, after the last stable release (4.1.0). It is built and released as beta prereleases (5.x+java.1.21.4) but not yet promoted to stable — most of it ships off by default. To try it, run the beta channel (in the launcher pick beta, or channel set java 1.21.4 pre; see Installation). Some pieces are not yet fully live-tested — those are flagged below.

The 5.x line turns AquariusProxy from "an automation bot you alone control" into "an automation bot you can safely let a group control" — a permission system, a companion client mod, remote pearl pulls, and a whisper command surface. Highlights:

🔐 Access control (RBAC) — replaces the whitelist

A full role-based access control system that replaces ZenithProxy's all-or-nothing owner/whitelist model. Per-user roles (admin ▸ operator ▸ user ▸ guest, hierarchical), capability preset groups (movement / travel / combat / crafting / automation), per-user grants & denies, and hashed per-user API tokens. It gates login (control vs spectator), every command, module toggles, and even movement/chat/interact. Default-deny — an unknown player gets nothing.

Manage it from the perms command, a Discord panel (perms panel), or the in-game admin screen in the ProxyBridge mod. There's also a one-shot whitelist → roles migration (perms migrate).

➡️ Access Control (RBAC) — full guide.

🔌 ProxyBridge companion mod

A separate Fabric client mod (aquariusnetwork9/ProxyBridge) that pairs with the proxy. It gives a member:

• Live waypoints — the bot's PearlDrop empty stasis chambers stream to your client and render in-world + on a HUD list (and into Xaero's Minimap).
• Pearl pull from anywhere — /pb pull or a keybind pulls your stasis pearl, over the instant bridge channel when you're connected through the proxy, or over the bot's HTTP API when you're out in the world.
• In-game RBAC admin screen — /pb admin to manage roles/tokens without Discord.
• Position reporting — /pb reportpos on lets a far-away commander be reached by come/protect (opt-in).
• Off-chat goto (new in 5.3) — /pb goto <x y z> sends a destination to the bot over its API so the coordinates never touch chat.

➡️ ProxyBridge — full guide.

🗣️ WhisperControl — whisper the bot

Authorized players whisper the bot plain verbs and it acts: protect (guard you, kill nearby hostiles, swap to a chestplate), come, goto (off-chat coordinates), patrol, mine, stop. protect and goto are new in 5.3.

➡️ WhisperControl — full guide.

🪝 Pearl pull, anywhere

Members with a pearl.pull token can pull their own stasis pearl without owner involvement:

• Over the bridge channel (instant) when connected through the proxy, or over the HTTP API (pearlpull) from out in the world.
• The ProxyBridge mod adds /pb pull, a pull keybind, and a /w <bot> load fast-path that reroutes to the API.
• Self-scoped and RBAC-gated, so a member can only pull a pearl stored under their own name.

📣 Discord & monitoring

• Members channel — a read-only Discord feed members can watch.
• VisualRange notice — a heads-up (with an optional coordinate toggle) when players enter the bot's visual range.

✈️ ElytraPilot fixes (5.2.1)

Two flight fixes for ElytraPilot:

• Trip routing is now bot-relative — fly trip measures distance from the bot to the target, not from spawn. A bot parked at a deep base now flies the short hop in, instead of nether-routing millions of blocks back through 0,0.
• Optimistic takeoff — the takeoff rocket now fires inside the airborne window instead of waiting on a server round-trip, so flat-ground takeoffs stop missing under 2b2t latency.

🛣️ Diagonal-highway e-bounce + fall recovery (5.5.0)

More ElytraPilot highway work:

• Diagonal highways now bounce at full speed. The no-firework e-bounce used a proportional nose-down dive tuned for the cardinal (N/S/E/W) highways; on a diagonal (NE/SE/SW/NW) it over-climbed and the server rubber-banded it down to a crawl (~4 b/s of mostly walking). On diagonals it now holds a constant steep pitch, so the apex stays low and the server accepts the flight — ~35 b/s, 0 setbacks, still no fireworks, the same as the cardinals. Cardinal highways are unchanged. Auto-detected per direction; tune with fly bounceconstdiag / fly bouncediagpitch. (Validated live on a diagonal highway.)
• Falls recover back onto the road instead of aborting. If the bot drops off the highway, or the obstacle passer can't route past a griefed section, it now Baritone-paths back onto the road centerline at road level and resumes bouncing instead of ending the flight. Only after several failed recoveries does it fall back to a graceful land-and-log-out. Tune with fly recover / fly recoverepisodes / fly passattempts. (Built; not yet live-tested.)

🎒 Unified kit profiles (5.5.0)

One editable place — CONFIG.client.extra.kits plus the new kit command — for every gear flow's "kit": which shulker to pull, what to equip, the pull mode, and the flight-checklist contents. Each flow points at a profile by name:

• Spawn / combat regear → regear profile <name>
• Nether-flight gear-up → fly flightkit <name>
• E-bounce elytra resupply → fly ebouncekit <name>

Manage them with kit list / kit add <name> / kit del <name> / kit <name> <field> <value> (or edit config.json directly). Opt-in — assignments are blank by default, so existing setups keep their exact current behavior until you point a flow at a profile. (Built; not yet live-tested.)

➡️ Regear · ElytraPilot — full guides.

🛑 ElytraPilot pitstop & goal stop (5.8.0)

ElytraPilot can now stop at a programmed goal to log out and/or anchor its respawn point — at an intermediate pitstop along the route, and/or at the trip's ultimate destination. Two independent, off-by-default behaviours that can also run together:

• Logout stop with an optional relogin timer — no timer (timer off) means it stays logged out for a manual reconnect; a trip resumes toward its destination automatically on relogin.
• Set-spawn — places + sets a bed in the overworld, or a glowstone-charged respawn anchor in the nether. Best-effort: if it can't, it warns and still logs out. relogonfail off keeps the bot logged out on a failed spawn-set, so it never returns to an unanchored spot.

fly pitstop at <x> <z> arms the geofenced intermediate stop; fly goal … configures the same at the final destination. (Built; not yet live-tested.)

➡️ ElytraPilot — full guide.

🛰️ Live control plane & dashboard (5.6.0 – 5.7.0)

The proxy gained a read-only viewer feed (a live 2D map + a fullbright POV, streamed ~20 Hz) and a control-plane API (live module toggles, vitals, command runner, and GET/POST /control/config for live config editing). These power the Aquarius Bot Manager dashboard, which drives a bot's modules and watches it on a map from the browser. Also landed in this window: an experimental HighwayBuilder (auto obsidian-road builder) and a Litematica schematic auto-builder, and nether grief-hardening became intrinsic to ElytraPilot (no master on/off gate).

🧪 Experimental / under the hood

• AirPlace + AutoPortal — an offhand-swap "place a block into thin air" primitive and an AutoPortal consumer that builds + lights a nether portal in front of the bot. Groundwork only — no command, not auto-wired, not live-tested. Listed for completeness; don't rely on it yet.

---

Version history (since 4.1.0)

Version	Added
5.8.0	ElytraPilot pitstop & goal stop — logout + bed/respawn-anchor set-spawn at an intermediate or final goal
5.7.0	Control-plane config API (GET/POST /control/config) for live config editing from the dashboard
5.6.0	Live map + POV viewer feed and control-plane API (power the bot-manager dashboard); experimental HighwayBuilder + Litematica auto-build; intrinsic nether grief-hardening
5.5.0	Diagonal-highway e-bounce fix (constant-pitch) + fall recovery + unified kit profiles
5.4.0	WhisperControl protect chase-to-melee + wander, AutoBow ranged combat, native-build/CI fixes
5.3.0	WhisperControl protect (replaces follow) + off-chat goto
5.2.2	WhisperControl whisper commands (follow/come/patrol/mine) + cross-session position telemetry
5.2.1	ElytraPilot fixes — bot-relative trip routing + optimistic takeoff
5.2.0	Members Discord channel, VisualRange notice, instant pearl pull over the bridge
5.1.0	RBAC promoted to mainline (beta) + ProxyBridge + AirPlace/AutoPortal, cut as a release
5.0.0	RBAC system, ProxyBridge bridge, AirPlace foundation (dev line)
4.1.0	(last stable) boat autopilot, bubble-column traversal, KitMaker fixes

All 5.x releases are prereleases on the +java.1.21.4 tag; the launcher's beta channel pulls the newest one. The stable channel stays on 4.1.0 until this line is promoted.