A macro is a small flow your bot follows on its own: something starts it, the bot runs a few steps, and a stop condition ends it. This guide builds one that sends a chat line a few seconds after the bot joins. The same moves work for every other macro.
Macros are in beta. Every plan can build and save them. Turning one on or testing it needs a paid plan, and walking steps need the bot's Physics toggle. See the macros page for everything a macro can do.
Before you start
- A bot, and a saved server for it. Every macro belongs to a server, so if the Macros page says there are no server profiles yet, add one on the Servers page first.
- The macro editor works the same on a phone and on a desktop. Names below use the desktop wording; the phone has the same buttons, such as New for New macro and Save changes for Save.
1. Start a macro
Open Macros in the sidebar and press New macro. The editor opens with a macro named Untitled macro that starts when the bot joins and has no steps.
Press the pencil next to the name to rename it, for example Say hello.
2. Pick the bots
Open the bot chooser at the top and tick at least one bot. You can also run the macro on all bots on the server. Saving is blocked until a bot is picked ("Pick at least one bot").
3. Choose what starts it
The trigger is the first card on the canvas, labelled When. It is Join to begin with, which fits this guide. Click it and open Runs when to pick another one: a chat message, a timer, a schedule, damage, a full inventory, and more. A macro has one trigger, and changing it keeps your steps.
4. Add steps
Press the + after the trigger on the canvas, or Add step on a phone, and pick a step from the list.
- Add Wait and set Pause for to 3 seconds. The bot is still loading in when it joins, so a short pause helps.
- Add Chat and type your line in Message, for example
Hello, I am back online!.
Steps run in order, from top to bottom. Click a step to change its settings. Dragging a card only moves it on the canvas; it does not change the order the steps run in.
A macro can hold up to 100 steps. To branch, add an If step and pick a check, such as Health is low. It has a Yes and a No branch, and both rejoin at End if.
5. Add a stop condition
Above the flow, press Add stop condition and pick one, for example Death. When any stop condition happens, the macro stops on that bot. You can add more than one; each is checked on its own.
Stop conditions are optional. A macro with none runs until its steps finish.
6. Save and test
Press Save. Once the macro is saved, Test on your bot sends it through once. A test needs a paid plan, and the bot must be online. It runs the real steps on the real server, so only test chat lines you are happy to send.
A step the bot cannot carry out fails with a message. Walking with Physics off fails with "physics is off", covered below.
7. Let it run on its own
Go back to the Macros list and switch Auto on. With Auto on, the macro starts by itself whenever its trigger happens. Auto needs a paid plan, and each plan allows a number of macros on Auto at once. See the plan limits or compare plans. On the Free plan, turning Auto on opens the plans dialog instead, but you can still build and save macros there.
A bot runs one macro at a time. When two are due together, the second waits its turn.
To run a macro once without changing Auto, open the bot's Macros tab and press Run now.
Walking and jumping need Physics
Move, Walk to and Jump once need the bot's body to react to the world. That is the Physics toggle, and it is off by default. Turn it on in the bot's Plugins list. The editor also shows a warning with a Turn on Physics button when your macro uses one of these steps and a picked bot has Physics off.