The AutoBuilder language lets you script a programmable builder, which executes actions like moving, placing blocks, breaking blocks, waiting, and more — using a concise, macro-friendly syntax.

Each AutoBuilder program is split into 2 or 3 parts, separated by the pipe symbol |:

BLOCK_MAP | MACROS | MAIN_PROGRAM

You may also skip macros:

BLOCK_MAP | MAIN_PROGRAM

Defines what blocks can be used and assigns them numeric IDs. The syntax is:

0(minecraft:stone),1(minecraft:dirt),2(minecraft:oak_planks)

Each entry is:

<number>(<block_id>)

Block IDs must not contain NBT data, but can include blockstates for example:

0(minecraft:oak_log[axis=y])

Macros are reusable blocks of code, defined using square brackets:

[macroName](instructions)

Example:

[stairs](P(0)D) [floor](3{P(1)E})

In your main program, use them like:

[floor][stairs]

Macro expansion is limited to 50 recursive levels to prevent infinite loops.

This is where your logic goes. It can use raw instructions, loops, macros, and block placement.

Each move shifts the builder cursor by 1 block in that direction.

P(n)

Places a block defined in the block map. For example:

P(0)

Places block with ID 0, e.g. minecraft:stone.

X

Breaks the block at the current position.

3{ ... }

Repeats the contents of the curly braces 3 times.

Example:

4{P(1)E}

Places block "1" and moves east, 4 times.

Loops can be nested.

Example:

2{3{P(1)W}U}

Repeat: 3x place + move west, then move up. Do this sequence 2 times.

Z(n)

Waits for "n" Minecraft ticks (20 ticks = 1 second).

Example:

P(0)Z(40)P(1)

Place block 0, wait 2 seconds, place block 1.

R

Returns the builder to its starting position.

Defined in the macro section, and used in the program with:

[macroName]

Macros can include other macros, loops, etc.

Example:

[stairStep](P(0)U E)

0(minecraft:stone) | P(0)E P(0)E P(0)

Same using a loop:

0(minecraft:stone) | 3{P(0)E}

0(minecraft:oak_planks) | X Z(20) P(0)

Break block, wait 1 second, place oak planks.

0(minecraft:oak_planks) | 5{P(0)U E}

Builds 5 steps upward and eastward.

0(minecraft:stone) | 4{P(0)E} R

Build a path 4 blocks east, then return to start.

0(minecraft:stone),1(minecraft:dirt) | [line](3{P(0)E}) [top](U [line]) | [line][top][line]

• Defines a "line" of stone (3 blocks east).
• Defines "top" as 1 layer higher with the same line.

The language is strict:

• P(n) with missing ID in block map → error.
• Unbalanced brackets ({}, (), []) → error.
• Infinite macro recursion → error after 50 expansions.

0(minecraft:stone)
|
[layer](
X
10{10{N X} 10{S} E} 10{W}
10{10{E X} 10{W} S} 10{N}
10{10{S X} 10{N} W} 10{E}
10{10{W X} 10{E} N} 10{S}
)
|
50{[layer] U}