Macro steps: chat, waits, movement and items

Commands, chat and log lines

Step	What it does
Type Command	Sends a slash command. Enter it with the slash, for example `/home 1`.
Send Chat	Sends a chat message as the account.
Log Message	Writes a line to the account’s console only. Nothing is sent to the server. Useful for printing a variable while you test.

All three accept tokens, which are replaced when the step runs:

Token	Becomes
`%username%`	The account’s own name.
`%random_username%`	A random player the account can currently see, never one of your own connected accounts.
`%random_java_username%`, `%random_bedrock_username%`	The same, limited to Java names or to Bedrock names (the ones that start with a period).
`%online_count%`	How many players the account sees online.
`%random_number%`, `%random_number(1,100)%`	A random digit, or a random whole number in the range you give.
`%loop%`	The current loop number of the run, starting at 1.
`%var:NAME%`	The value of a variable, or a field of it such as `%var:home.x%`. See variables.

Waits

Step	Settings
Wait / Delay	A fixed pause in milliseconds, from 50 up to one hour (3,600,000).
Random Delay	A pause somewhere between a minimum and a maximum, each up to one hour. Use it between repeated actions so the timing is not perfectly regular.
Wait for Chat Reply	Waits for a new incoming message that contains any of your comma separated keywords, ignoring capitals and colour codes; server messages count, action bars do not. Set a timeout in milliseconds and choose whether a timeout continues or stops this macro. Messages that arrived before the step started are not counted.
Wait Until Spawned	After a Reconnect or Disconnect step, waits until the account is fully in the world again, up to the timeout (1,000 to 120,000 ms). More reliable than a blind wait after a rejoin.
Wait For Time	Pauses until the world is day, night, or at a specific time tick (0 sunrise, 6000 noon, 12000 sunset, 18000 midnight). The default timeout of 1,200,000 ms is one full Minecraft day.

Waits tied to menus, dialogs, slots, and conditions are covered in inventory, menus and dialogs and variables, conditions and loops.

Looking, moving and the mouse

Step	Settings
Look At	Direction turns forward, backward, left, right, up, or down. Coordinates faces a block position. Head Position (angles) sets an exact view: Left/Right is the yaw (0 south, -90 east, 90 west, 180 north) and Up/Down is the pitch (-90 straight up, 90 straight down), the same numbers as Head Position.
Walk Direction	Holds forward, backward, left, or right for a duration of 100 to 60,000 ms.
Stop Movement	Releases every movement key and cancels any pathing.
Toggle Sprint	Sprint on or off.
Jump	One jump.
Toggle Sneak, Toggle Jump	Turn that account’s saved Sneak or Jump setting on or off. These are the same settings as Settings → Behavior, so they stay on after the macro ends and come back after a reconnect until something turns them off.
Swing Arm	One attack swing with whatever the account holds.
Use Item	One right click with the held item.
Hold Mouse Button	Holds the left button, the right button, or both for a number of seconds, from 1 to 3600.
Mouse Click	Real clicks on whatever the crosshair is on: left click hits a mob or player or punches a block, right click presses buttons and levers, opens containers, interacts with entities, or uses the held item. Choose the button, the number of clicks (1 to 100), and the delay between them. Each click looks again, so aim with Look At first.
Enter Vehicle	Gets into the nearest boat, raft, minecart or rideable mob (horse, camel, pig, strider, llama, happy ghast) within reach and waits until the account is seated. Works on Java and Bedrock. With Turn head towards nearest vehicle ticked the head turns to the vehicle first; unticked, the account only clicks a vehicle it is already looking at, so aim with Look At before it. Sneak is released first because sneaking cancels entering. While seated the account cannot drive, but it can look around, use items, click and break blocks. To get out, add Toggle Sneak on, then Toggle Sneak off. The step stops the macro when no vehicle is within reach.
Play Recording	Repeats a Macro Recording you made in Point of View exactly, tick for tick: walking, looking, mining, menus and chat. Tier 2. See Macro Recording.

Pathfinding and following

Step	Settings
Goto Coords	Pathfinds to X, Y, Z and waits until the account arrives. The fields accept tokens such as `%var:home.x%`. Options: sprint while pathing, allow breaking blocks (Java), humanized movement, and abort the macro if no path is found.
Save Position	Stores the account’s current X, Y, Z in a variable.
Walk to Saved Position	Pathfinds back to a position stored by Save Position.
Follow Player	Follows a player by username, stopping at the distance you set (1 to 20 blocks), for a duration up to one hour, or 0 to follow until the macro is stopped. It climbs ladders and vines, swims, jumps gaps and drops down after the player, also drops that hurt or kill the account. Tick Safe pathfinding (take no fall damage) to allow only drops of 3 blocks or less or into water; the account then waits at the edge when there is no safe way down.
Random Walk	Walks to random spots around where the step starts for the time you set (1 second to one hour), staying within the radius (4 to 96 blocks). It jumps up blocks, walks around walls, pauses briefly at each spot and looks around, then stops when the time is up. It is real walking, so servers that only count playtime while you move, such as DonutSMP, count it.
Walk Blocks	Walks a number of blocks (1 to 2000) forward, back, left or right of where the account faces, or north, south, east or west, and ends on that block. It jumps up 1 block steps and walks around obstacles. Optional sprint.

These steps use the same engine as the Tasks in Control → Movement: full pathfinding on Java, and on Bedrock a pathfinder that walks around obstacles, steps up one block and drops up to 3 blocks, without breaking or placing blocks. Follow Player and Click Block also take longer drops and swim on both editions (see Follow Player above). Check what lies between the account and its goal before you rely on a long path.

Mining

Step	Settings
Mine Blocks	Pathfinds to the nearest block with the name you type, mines it, and repeats up to the count (1 to 10000) inside the search radius (2 to 96 blocks). Don’t move mines only what is already within reach; Mine all block types ignores the name. The block under the account is never broken. Java and Bedrock. Java accounts also have: Only blocks open to the sky (the top block of its column, never underground or under water, so a patch is mined layer by layer), Pick up the drops (walks onto the dropped items) and Stop when the inventory is full. An optional variable receives mined, collected and the reason it ended: full, none (nothing left in the radius), done (count reached) or stuck.
Dig Down	Digs straight down under the account. Before every block it checks below and beside the shaft and ends the step, without an error, at bedrock or before breaking into lava, water, fire, magma, powder snow, or a drop longer than the Max safe drop (1 to 10 blocks, default 3). Blocks to dig 0 means until bedrock; otherwise it also stops after that many. Auto-equip the fastest tool equips the fastest tool in the inventory for each block. Tick 3x3 drill tool when the account mines with a drill such as the DonutSMP one, so the hazard scan covers the whole break area and the drill stays equipped. An optional variable receives why it stopped: bedrock, lava, water, hazard, drop, limit, or error.
Right-Click Spawner	Finds the nearest spawner within the radius (2 to 48 blocks), looks at it, and right-clicks it with the held item. Optional sneak during the click and abort if no spawner is in range.
Click Block	Finds the nearest block with a name you type (up to 10, separated by commas), walks there like a player, turns the head smoothly onto it and right or left clicks it with the held item, then goes on to the next one until it has clicked the number you set (1 to 1000) or none is left in the search radius (2 to 96 blocks). Each block is clicked once per run of the step, so it suits event heads, buttons and levers. A name also finds its wall version, so `player_head` finds heads on walls too. Blocks the account cannot see are skipped. Don’t move clicks only blocks already in reach, Safe pathfinding avoids fall damage, and Don’t turn the head clicks without looking at the block, which anti-cheats such as Grim can flag. Hold an empty hand or an item that is not a block, or a right click places the block you hold.

Fishing

Auto Fish fishes like a player: it takes a fishing rod into the hand, casts, waits until a fish really bites on the account’s own bobber, reels in after a short human reaction, and casts again. It works on Java accounts. It does not walk or turn around, so face open water first with Look At, the Head Position setting or Point of View. Other players fishing next to the account never set it off.

Setting	What it does
Fish until	A number of catches (1 to 10,000), A time limit (1 to 1,440 minutes), The inventory is full (no empty slot left), or Forever, until stopped (keeps fishing with a full inventory; what does not fit stays on the ground, like in the game).
Cast again when nothing bites for	After this many seconds without a bite (10 to 300, default 45) it reels in and casts again. Bites under a roof take about twice as long, so raise it there.
Prefer enchanted rods	Takes the rod with the best Lure, Luck of the Sea, Mending and Unbreaking. Untick it to keep the rod that is already in the hand.
When the rod is almost broken	Switch to another rod (the default; the step stops when none is left), Stop fishing, or Keep fishing until it breaks. Almost broken means the number of uses left you set or fewer (default 3; a rod has 64).
Save the result to a variable	Optional. The variable holds `catches`, `items` (for example `cod x5, salmon x2`), `reason` (done, time, inventory-full, rod-low, no-rod) and `casts`, so a Discord Alert can say `%var:fish.catches% fish: %var:fish.items%`.

Items by name

Item names are the Minecraft ids, such as diamond_sword or ender_pearl. The pickers search as you type.

Step	Settings
Hold Item	Selects the first hotbar slot holding that item. It never moves items out of the main inventory. If the item is not in the hotbar the selection stays as it was, unless you tick abort if missing.
Equip Item	Finds the item anywhere in the inventory, moving it into the hotbar slot you choose (0 to 8) when it is not already there, then holds it.
Use Item by Name	Equip Item followed by a right click held for the duration you set (50 to 60,000 ms), then optionally switches back to the previous slot. About 200 ms for a pearl, about 1800 ms to finish a potion.
Eat Now	Finds any food, holds it, eats for the duration (800 to 5000 ms), and optionally switches back. Abort if no food is available when you tick that option.
Equip Armor	Puts the best armour the account carries into all four slots: netherite, diamond, iron or turtle, chainmail, gold, leather. Equal materials prefer the piece with more durability left; enchantments are not compared. Close any menu first.
Stop on Low Tool Durability	Watches the held item for the rest of this run, including during waits and mining, and stops this macro when its remaining durability reaches your percentage (default 10). Put it before the mining step. Items without durability are ignored.
Drop Held Item, Drop Item, Drop All Items	Covered in inventory, menus and dialogs.

Connection and alerts

Step	Settings
Disconnect	Leaves the server. Cancel Auto Reconnect is ticked by default, which keeps the account offline until you press Connect, the same as a manual disconnect. Untick it if the account should come back through Auto Reconnect.
Reconnect	Rejoins the server. Follow it with Wait Until Spawned before the next action.
Discord Alert	Sends a message through a Discord webhook URL or, on Tier 3, through your hosted bot to a channel you pick. The message accepts the tokens above; a username override applies to webhooks only. Sends from one account are at least two seconds apart.

A manual macro that is still running when the account drops pauses and carries on about thirty seconds after the account is back in the world. An Automation step does not resume; see chat replies and payments.

Java and Bedrock

Almost every step works on both editions without changes, including Right-Click Spawner, Enter Vehicle, Dig Down with its automatic tool choice, and the four dialog steps, which answer Bedrock forms too. Goto Coords, Walk to Position and Follow Player climb ladders, jump small gaps and swim on both editions, and Allow breaking blocks works on both. The exceptions: the dialog steps need 1.21.6 or newer on a Java account, and the off-hand slot number exists on Java only. A step an account cannot run is skipped with a console line rather than stopping the macro.