Movement and Transport

Movement & Transport

AquariusProxy moves the bot with a server-side port of the Baritone pathfinder, plus two AquariusProxy-specific transport integrations: bubble-column traversal and boat autopilot. For air travel see ElytraPilot.

Quick command lists are on the Command Reference; this page explains the two integrations in more detail.

Pathfinder (Baritone)

Command: pathfinder — aliases path, b.

The pathfinder routes the bot to a goal, mines/breaks/places blocks, follows players, and picks up drops:

.b goto <x> <z>            walk to coordinates (XZ)
.b goto <x> <y> <z>        walk to an exact block
.b goto <waypointId>       walk to a saved waypoint
.b follow [<player>]       follow a player
.b thisway <blocks>        walk forward N blocks
.b mine <block>            strip-mine for a block type
.b getTo <block>           path to the nearest block of a type
.b clearArea <pos1> <pos2> clear a cuboid
.b stop                    cancel the current path

Bubble-column traversal

New in AquariusProxy. The pathfinder can now enter, ride, and exit bubble columns as first-class movements — both soul-sand columns (up) and magma columns (down). This is automatic: when a bubble column lies on the route, the planner uses it like any other move. No special command is needed — just .b goto / .b mine / etc. as usual.

How it works:

• Soul-sand bubble columns push the bot up; magma columns pull it down. The pathfinder treats riding a column as a cheaper-than-walking move, so it prefers one when available, and exits laterally onto the first walkable floor.
• The planner needs a solid, standable block at the top as the goal — you can't path into the column itself, because the bubbles push you off.

Diagnosing a column that won't path: .b bubbledebug <x> <y> <z> dumps the pathfinder's per-block view of the shaft (passability, isBubbleColumnUp, walkable-floor) to the console log — grep [bubbledebug]. This is useful when the column's water is held in place with signs (the bot must be able to path through the signs to reach the column).

⚠️ Known rough edge: the lateral exit can overshoot slightly before the bot steps off the top of the column. It works, but the exit timing is a polish item.

Boat control

Command: boat.

New in AquariusProxy. AquariusProxy reimplements Minecraft's boat physics server-side, so the bot can drive a boat across open water to a coordinate. The bot becomes the controlling client and reports its motion via the MoveVehicle packet.

.boat mount            right-click the nearest empty boat to seat the bot, then arm control
.boat goto <x> <z>     autopilot: steer across open water to the coordinate, then stop
.boat on / off         enable / disable boat control
.boat fwd / back       manual: hold forward / reverse
.boat left / right     manual: hold turn
.boat fwdleft / fwdright   manual: forward while turning
.boat stop             release manual input / cancel goto (stays enabled)

Typical use: get within ~8 blocks of a boat, .boat mount, then .boat goto <x> <z>.

⚠️ Open water only. The autopilot is designed for open water. It steers toward the target and stops within a few blocks of it; it does not currently route around islands or land obstacles. Seat the bot in a boat first (.boat mount, or have a controlling player right-click a boat).