Modules
Area excavation
The bot digs out a rectangular area you define, top to bottom on its own: two-layer slices, picking up dropped items, inventory-full options and an exit ramp.
Last updated: November 11, 2026
The area excavation module lets the bot dig out a rectangular area (width × length × depth) you define, all by itself. Use it for pools, basements, tunnels or mining pits. The bot walks inside the area, breaks the blocks in reach from each spot and drops down to the next slice.
How is the area defined?
The area is defined like the cactus farm: by a corner, a facing and three sizes. It starts at the corner and runs width blocks to the right of the facing and length blocks along it; the depth goes down and includes the corner's own layer.
| Setting | Default | Description |
|---|---|---|
| Width (blocks) | 5 | 1-64. To the right of the facing. |
| Length (blocks) | 5 | 1-64. Along the facing. |
| Depth (blocks) | 3 | 1-48. Downwards, including the corner's layer. |
| Use corner coordinates | No | When on, the area is dug from the X/Y/Z corner you entered, in the facing you chose. When off, the corner is the block the bot's feet are in and the bot digs the way it looks. |
| Facing | South | North, East, South or West. Only with the corner coordinates on. |
How does it dig?
- Top to bottom, two layers at a time. The bot stands at the bottom of a slice and digs the two layers within its reach together; then it digs down and walks the lanes back. It never goes down more than two blocks at once.
- Top block first. In every column the upper block is broken first, then the lower one, so sand or gravel from above does not fall on the bot.
- Blocks next to liquid are skipped. Blocks that touch lava or water are not broken, so the liquid cannot flow into the pit; those columns are left alone.
- Falling sand and gravel. If sand or gravel falls back into a broken block, the bot breaks it a few more times; if it keeps filling, the bot gives that block up and carries on.
- Safety stops. The bot stops if a drop is too big (more than two empty blocks under its feet) or if its health gets low.
Exit ramp
With Leave an exit ramp on, the bot leaves the first row of blocks undug as a staircase. When the dig is finished the bot can climb out along these steps and does not get stuck in a deep pit. When off, the area is dug completely flat.
Speed modes
| Mode | What it does |
|---|---|
| Safe | Slow head movement and longer gaps. For servers with strict anti-cheat. |
| Normal | Works at the bot's general head pace (Bot behavior card). |
| Fast | Quick head movement and the shortest gap vanilla allows. With combinations that break a block in one tick, such as Efficiency V + Haste II, the bot digs in a rapid series, as if the left button were held down. |
When the inventory is full
| Option | What happens? |
|---|---|
| Stop | The bot stops digging (default). Empty the inventory and continue with .excavate resume. |
| Carry on (with a full inventory) | Keeps digging; items that do not fit in the inventory cannot be picked up. |
| Run a macro | The macro you chose runs (for example putting items into a chest) and the bot carries on where it left off. |
| Drop the listed items | Throws the items in the drop list (e.g. cobblestone, dirt) on the ground and carries on. |
With Collect dropped items on, the bot walks to nearby dropped items and picks them up. Tool choice, durability protection, dig time, head and walking settings are not specific to area excavation; they come from the bot's Bot behavior card, which the Generator and the Cactus farm use as well.
Starting
- 1In the bot's settings turn on Enable the area excavation module, enter the area and save. Restart the bot.
- 2Place the bot inside the area or at most 3 blocks away. Have a suitable pickaxe or shovel (with auto tool choice on, it takes one from the inventory).
- 3On the Area excavation card in the console, type the corner and the size; the boxes save as you type. Pick the direction from the cards under Other corners (a click saves it), then press Start or type the command.
.excavate start
.excavate start 100 64 -20
.excavate start 100 64 -20 8 12 6 east
.excavate pause
.excavate resume
.excavate stop
.excavate status
.excavate speed safe|normal|fast| Command | What it does |
|---|---|
.excavate start | Starts with the saved settings (from where it stands when the corner is off). |
.excavate start x y z | Starts from the corner you give. |
.excavate start x y z genişlik uzunluk derinlik [yön] | Starts with corner, sizes and facing (north, south, east, west). |
.excavate pause / resume | Pauses / resumes. |
.excavate stop | Stops the dig. |
.excavate status | Prints progress, blocks dug and the speed. |
.excavate speed safe|normal|fast | Changes the speed right now. |
