Everyday ToolsMacro steps: chat, waits, movement and items
Every everyday step: commands and chat with tokens, delays, looking and moving, mining, items by name, and connection steps.
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 or right button 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. Java only. 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. |
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. |
These steps use the same engine as the Tasks in Control → Movement: full pathfinding on Java, and a reactive walker on Bedrock that steps over obstacles. 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 2000) 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. |
| 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 is Java only. 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 (Java) | 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. |
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. The exceptions: the four server dialog steps need a Java account on 1.21.6 or newer, Right-Click Spawner is Java only, Allow breaking blocks in Goto Coords and the automatic tool choice in Dig Down apply on Java, 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.
Need a hand?
Check the troubleshooting guide or return to all guides.