AquariusMiner

AquariusMiner — AFK quarry

An autonomous single-block quarry. It clears a rectangular area top-down, layer by layer, mines with the right tool, eats, dodges hazards, banks the haul into shulkers via an ender chest (or chests), and self-heals the stalls that normally kill AFK miners on a laggy server.

Command: .aquariusminer (alias .aqm).

What it does

• Top-down, layer-major clearing of a finite area (or an unlimited outward spiral), within a configurable Y band.
• Ender-chest buffer storage: when inventory fills it places an ender chest, pulls an empty shulker, shift-click-fills it, stores the full shulker, then silk-touch-recovers the ender chest. Filled shulkers are never carried in the mining inventory. (Optionally deposits to physical chests instead.)
• Tool handling: auto-selects the best non-silk pickaxe/shovel to break with, while keeping a silk-touch pick reserved in the hotbar purely for ender-chest recovery. Optional gravel-shovel handling.
• Hotbar model: hotbar holds tools + ender chest + food; mined keep-blocks get swept to main inventory; junk (mob drops, non-keep items) is dropped as aggressively as the anticheat-safe action rate allows. Equipped armor and the offhand totem are never dropped.
• Survival: pauses for AutoEat, optional food restock from a food shulker in the ender chest, optional pause when a player is near, optional auto-disconnect on completion.
• Anti-stall self-healing: reach floor + manual-break assist for fence/edge-block stalls, verify-and-retry of uncleared sub-boxes, and a tool tug-of-war fix.

Setup guide

1. Put the bot at the start corner with a stack of ender chests, a silk-touch pickaxe, an efficiency (non-silk) pickaxe, optionally a shovel and food, and empty shulker boxes in the ender chest (it pulls these to bank into).
2. Set the vertical band: .aqm minY -59 and .aqm maxY -50 (defaults sit in the deepslate layer).
3. Choose what to keep: .aqm keep add cobbled_deepslate (everything not in the keep-list is treated as junk and dropped). .aqm keep list to review.
4. Define the area, either:
   • .aqm here <length> <width> — a box length blocks forward and width blocks right of the bot's position+facing, or
   • .aqm area corners <x1> <z1> <x2> <z2> — explicit corners, or
   • .aqm area chunks <width> <length> + .aqm area anchor center|corner, or
   • .aqm area unlimited — infinite outward spiral.
5. (Optional) .aqm reach 2.5 keeps the bot tight to what it mines so drops land next to it; .aqm sprint on speeds up repositioning.
6. Start: .aqm on. Watch progress with .aqm scan. Stop with .aqm off.

Commands

.aquariusminer on/off
.aqm minY <y>
.aqm maxY <y>
.aqm here <length> <width>            # box: length forward, width right, from bot pos+facing
.aqm area unlimited
.aqm area chunks <width> <length>
.aqm area anchor <center/corner>
.aqm area corners <x1> <z1> <x2> <z2>
.aqm keep add <item> | remove <item> | list | clear | reset
.aqm cave on/off
.aqm legit on/off                     # break only blocks in line of sight
.aqm reach <blocks>                   # legit reach; lower = closer/better pickup; ~4.5 vanilla
.aqm sprint on/off                    # faster repositioning (toggle off/on to apply)
.aqm fullstacks on/off
.aqm freeslots <n>                    # store margin when full-stacks is off
.aqm dryrun on/off                    # log echest shulkers + abort, no pull/store
.aqm badfood on/off
.aqm autodc on/off                    # auto-disconnect on completion
.aqm pauseplayer on/off               # pause when a player is near
.aqm restock on/off
.aqm shovel on/off
.aqm food on/off | food count <n> | food min <n>
.aqm clearbox <size>
.aqm layer <blocks>
.aqm verify on/off | verify retries <n>
.aqm collect on/off | collect seconds <n>
.aqm scan                             # print the current area scan / progress

# Storage (ender-chest buffer is default; or deposit to physical chests):
.aqm deposit on/off
.aqm deposit chest add <x> <y> <z> | clear
.aqm deposit supply add <x> <y> <z> | clear
.aqm deposit refill on/off | empties <n> | maxdist <blocks>

Packet-capture commands live under .aqm sniff … — see AquariusSniffer.