Skip to content

Control Surface

Jump to bottom
Shallowplague edited this page Jun 25, 2026 · 5 revisions

Live Control Surface (Mission Control)

The Control Surface turns the bot manager into a live, front-facing cockpit for each AquariusProxy bot — every module, the world map, vitals, and a command palette on one page. The proxy console is still there as a fallback; the Control Surface is the human-friendly way to drive a bot day to day.

Added in ABM v3.0.0. Served per-bot at /control?inst=<name> and relayed over the same authenticated tunnel as the live viewer — the bot only binds its viewer to loopback, so nothing is exposed publicly.

Mission Control — Live Map

Opening it

  • From a bot's viewer drawer → Control tab, click ⛶ Open full control surface.
  • Or go straight to /control?inst=<bot-name> in the dashboard (same login/session).
  • Pick the appearance with &style=v1|v2|v3, or use the appearance dropdown in the top bar (your choice is remembered for next time).

The page boots into the Live Map for the selected bot and starts streaming.

Appearance — three themes

The surface is the same data and the same live wiring rendered three ways. Switch any time from the top-bar dropdown; the Live Map is built into all of them.

Theme Style key Best for
Mission Control (default) v1 A module rail + one focused workspace. Calm, scales to deep per-module config.
Aurora Glass v2 Frosted-glass cards, a pill filter, every module visible at a glance.
Console Pro v3 Dense, mono, power-user 3-pane (rail → tables → inspector). Wants ≥ 1080p.
Aurora Glass Console Pro
V2 · Aurora Glass V3 · Console Pro

What's live right now

Feature Status Notes
Module states + status dots ✅ live From /control/state, refreshed every few seconds.
Module enable toggles ✅ live Sends <module> on/off; the state poll shows the truth a moment later.
Action buttons (▶ run / ■ stop) ✅ live Best-effort per module; Elytra's Fly there sends fly trip <dim> <x> <z>.
Vitals (health, food, position, dimension, speed) ✅ live From the ~20 Hz SSE viewer feed.
Live Map ✅ live Real bot-centred map tile + SSE entity overlay; click the map to set an Elytra destination.
Command palette / runner ✅ live Runs any console command and shows the structured result.
Live configuration (per module) ✅ live (v3.1) A ⚙ Live configuration panel on each module reads the bot's real config and writes single fields back instantly (GET/POST /control/config); secrets are redacted and never writable. The friendly mockup subcards remain as a read-only overview.
Pearl pins on the map · trade-list editor 🧩 planned A later release; they need new bot-side data exposure.

The settings subcards show sensible defaults, not the bot's live config yet. Don't treat the values there as the bot's current configuration until v3.1 wires them to the real config. Everything marked ✅ above reflects the real, live bot.

The Live Map

  • Bot-centred real map tile that refreshes continuously, with the bot at the centre.
  • Entity overlay from the live feed — players (blue), hostiles (red), passives (green), items (amber).
  • Click anywhere → set an Elytra destination. A crosshair drops, the world coordinates are computed from the bot's position, and ▶ Send to Elytra dispatches fly trip <dimension> <x> <z>.
  • ⛶ Fullscreen expands the map; ◎ Recenter re-centres on the bot.

The click-to-coordinate math uses an approximate map span. For pinpoint long-haul targets, confirm the X/Z in the Elytra module's Destination card.

Requirements (bot side)

The bot must be running an AquariusProxy build with the viewer + control endpoints, and in its config.json:

"server": {
  "viewer": {
    "enabled": true,     // serves the live feed (map / vitals / entities)
    "control": true,     // ALLOWS the surface to run commands & toggle modules
    "bindHost": "127.0.0.1",
    "port": 2998
  }
}
  • With control: false (or the flag absent) the surface still works as a read-only viewer — vitals and the map render, but toggles/commands return 403 and do nothing.
  • The viewer binds to loopback only; the dashboard fetches it server-side and relays it over the authenticated (and, across boxes, SSH-tunnelled) connection. Nothing the bot serves is reachable directly from the internet.

Security & safety

  • Secrets are never shown. The MSA password, SOCKS proxy password, and Discord token render as masked fields with a reveal-eye. Don't paste tokens into chat or screenshots.
  • Coordinate masking. The floating 🙈 Mask coordinates button blurs every coordinate field for streaming/screenshots.
  • Authorization gates carry over. Whisper Control and Proxy Bridge still honour their allow-lists — the surface doesn't bypass RBAC.
  • 2b2t / anti-cheat. Aggressive movement and combat modules (Elytra e-bounce, Combat Assist, Spawn Patrol) carry detection/ban risk on anarchy servers. Test in safe areas.

Module reference

Friendly name first, with the raw config key in code. ⚠ marks the warnings/caveats worth knowing before you flip a module on. Modules marked command-driven have no persistent toggle — run their command instead.

Control surfaces

Module What it does ⚠ Warnings & caveats
Live Map · LiveViewer The live world map this page is built around. Read-only viewer; needs viewer.enabled. Entity/positions are from the SSE feed; map span is approximate.
Elytra Autopilot · ElytraPilot Trip planner & long-haul flight (cruise / highway / e-bounce). ⚠ A worn elytra silently breaks e-bounce — carry spare elytras, don't fly in one you also want to bounce with. Pre-flight audit expects ≥ 2 elytras, ≥ 2 totems, fireworks. E-bounce is tuned Grim-accepted (~30–38 b/s) but anarchy anti-cheat is a moving target. Native nether routing needs the correct world seed. "Last elytra" safety can log you out.
Villager Trading · VillagerTrader Stationary auto trade hall (emerald economy). Needs supply/output chest coordinates set. ⚠ Trade-list editing is preview for now — manage trades from the console until the editor lands.
Pearl Stasis · PearlManager Ender-pearl stasis loader. Needs stasis chamber coordinates. ⚠ Map pin-to-add is planned (Phase C); coords are entered manually today.
Stash Manager · StashScanner Indexes & sorts an owned stash. Operates on your own stash; point it at the right chests/region.
Auto Miner · AquariusMiner Top-down quarry & ore search with auto-deposit. ⚠ Uses the ender chest as the field buffer — never carry filled shulkers in the mining inventory (it'll mis-deposit). On laggy anarchy, drops can fly up to ~2 blocks, so it settles/chases/confirms each break. Pauses for Auto Eat. Set bounds + deposit chests.
Auto Enchanter · Enchanter Anvil auto-enchant station. Needs the anvil/input/output/book station laid out and coordinates set.
Kit Builder · KitMaker Fills template shulker kits. Define the slot template + item sources.
Packet Sniffer · AquariusSniffer Live packet inspector (debug). ⚠ Debug tool — high log/throughput volume; leave off in normal operation.
Highway Builder · HighwayBuilder Auto nether-highway paver: clears the tunnel + lays an obsidian road. ⚠ Destructive — it clears blocks along the path. Off by default. Needs obsidian + restock; intended for nether highways.
Schematic Builder · Litematica Builds .litematic / .nbt schematics via Baritone. Needs a real schematic file staged on the bot; build pacing depends on materials + Baritone.
Boat Autopilot · Boat Open-water boat travel. Command-driven (.boat goto x z). ⚠ Open water only; rubber-band risk on high latency (not heavily field-tested).
Auto Regear · Regear One-shot gear restock from an ender-chest kit shulker. Needs a kit shulker in the ender chest matching the profile.
Order Filler · OrderFiller Payment-gated order picker. ⚠ Requires a configured database + stash; advanced setup.
Pearl Drop · PearlDrop Throws pearls into stasis chambers. Pairs with Pearl Stasis; aim/chamber setup matters.
Flight Gear · FlightGear Pre-flight gear-up — runs Regear with an elytra kit. Depends on a valid elytra kit profile; run before long flights.

Combat

Module What it does ⚠ Warnings & caveats
Combat Assist · KillAura Auto-attacks nearby targets. ⚠ Aggressive; anti-cheat / ban risk on anarchy. Tune target filters.
Auto Bow · AutoBow Auto-draws & fires a bow / crossbow at range. Same anti-cheat caution as melee assist.
Auto Armor · AutoArmor Equips the best available armor. ⚠ Can fight the worn elytra during flight — be mindful when combining with Elytra Autopilot.

Survival

Module What it does ⚠ Warnings & caveats
Auto Eat · AutoEat Eats automatically when low on health/hunger. ⚠ Pauses other tasks (mining/building) while eating; keep food stocked.
Auto Totem · AutoTotem Keeps a totem in your off-hand. Competes for the off-hand slot — features that use the off-hand are designed to be AutoTotem-safe, but watch for conflicts.
Auto Respawn · AutoRespawn Respawns immediately on death. Will respawn you into danger if your spawn is hot.
Auto Mend · AutoMend Repairs held gear with XP (Mending). Needs an XP source; only mends Mending-enchanted gear.
Auto Disconnect · AutoDisconnect Logs out when things go wrong. Set thresholds (low totems/health) sensibly so it doesn't bail too early/late.

Connection

Module What it does ⚠ Warnings & caveats
Account & Login · Authentication Microsoft login, target server, optional login proxy. 🔒 Holds secrets (MSA + proxy passwords) — masked in the UI; never expose. Editing here is preview; change account details carefully.
Auto Reconnect · AutoReconnect Rejoins after a disconnect. Pairs with Auto Re-queue on queued servers.
Anti-Kick · AntiKick Survives the 2b2t inactivity kick. Tuned for 2b2t timing.
Anti-AFK · AntiAFK Small actions so you look active. ⚠ Patterns can still be flagged; vary behaviour.
Action Limiter · ActionLimiter Locks down what the account may do (movement, interactions, illegal items). A safety guardrail — over-restricting will block other modules' actions.
Auto Re-queue · Requeue Rejoins the server queue. Handled together with Auto Reconnect.
Queue Alert · QueueWarning Alerts as you near the front of the queue. Notification only.
Active Hours · ActiveHours Only stays online during scheduled times. ⚠ Will disconnect the bot outside its window.
Session Time Limit · SessionTimeLimit Warns/acts on the 2b2t session time limit. Configure the action (warn vs disconnect).

Privacy & security

Module What it does ⚠ Warnings & caveats
Coordinate Privacy · CoordObfuscation Feeds the server fake coordinates to hide your base. ⚠ Can interfere with features that rely on real coordinates — use deliberately.
Anti-Leak · AntiLeak Blocks chat that leaks numbers near your coordinates. Heuristic; tune sensitivity.
Visual Range Alerts · VisualRange Alerts when players enter render distance. Notification/awareness only.
Whisper Control · WhisperControl Authorized players drive the bot by whisper (protect / come / goto / patrol / mine). 🔒 RBAC — keep the allow-list tight; anyone on it can move/command the bot.
Proxy Bridge · Bridge Links to the ProxyBridge client mod (waypoints + allow-listed commands). 🔒 Allow-list gated; pairs with the ProxyBridge Fabric mod.

Automation

Module What it does ⚠ Warnings & caveats
Auto Fish · AutoFish Automatic AFK fishing. Standard AFK caveats.
Auto Drop · AutoDrop Drops unwanted items as they pile up. ⚠ Double-check the drop list — it discards items.
Chat Broadcaster · Spammer Posts chat / whisper messages on a timer. ⚠ Spam gets you muted/banned — use responsibly and within server rules.
Auto Reply · AutoReply Auto-replies to incoming whispers. ⚠ Can loop with other auto-repliers; rate-limit.
Auto Portal · AutoPortal Builds & lights a nether portal. Command-driven (.portal build). Uses the off-hand air-place primitive; needs obsidian + flint & steel.
Bad Omen · AutoOmen Manages Bad Omen / Ominous bottles for raids. Niche; raid-specific.
Chat · Chat Chat display, filtering, prefix/suffix & clickable links. Cosmetic/utility.

Diagnostics

Module What it does ⚠ Warnings & caveats
Replay Recorder · ReplayMod Records sessions to ReplayMod files. ⚠ Disk usage grows with session length.
Spawn Patrol · SpawnPatrol Patrols spawn and engages fresh players. ⚠ PvP at spawn — risky; combines with combat modules.
Discord Notifications · Discord Discord bot — status, alerts, chat relay. 🔒 The Discord token is a secret (masked); never expose it.

How it works (under the hood)

The surface is static assets (control/) served by the manager and made live by control-live.js, which talks to the bot's loopback endpoints through the dashboard's authenticated relay:

  • GET /control/state → module list + enabled flags (the rail status dots + header chips).
  • POST /control/command → runs a console command, returns its structured output.
  • GET /control/config → the live config tree (secrets redacted); POST /control/config {path,value} sets one field by dot-path and persists. Powers the ⚙ Live configuration panel.
  • GET /viewer/stream (SSE, ~20 Hz) → position, vitals, dimension, nearby entities.
  • GET /viewer/map.png → the bot-centred map tile (Live Map backdrop).
  • GET /viewer/inventory → vitals + armor + inventory (used by the cockpit panels).

All three themes load the same model and the same live brain, so a fix or a new live binding lands everywhere at once.

See also: Usage · Security · Architecture & Limitations.

Aquarius Bot Manager

Clone this wiki locally