Node macros
Node macros are built on a visual canvas and executed by the native client. Users never type or inspect the stored graph JSON. Add an event, drag actions/values from the palette, and connect compatible dots; fields on a block are used when an input is not wired.
Connection rules
The editor prevents invalid graphs instead of accepting them and failing later. It rejects incompatible value types, connections into an event, multiple flow edges from one output, cycles, branches with no event root, mixing incompatible event scopes, packet-field reads outside their packet event, and packet reads after Wait. Event and action/value handles are distinct.
Flow arrows decide execution order. Value arrows carry number, text, bool, array, or any. If has yes and no branches. Wait saves only copied event/value data and resumes that branch on a later tick; a live packet is no longer available.
Events and cancellation
Available roots are Every tick, On replay event, incoming/outgoing Packet, incoming/outgoing packet-derived Chat, and On key. Packet selection expands the event with one output for each field in that version. Chat exposes message/argument. Tick exposes phase, replay exposes type/phase/ID, and key exposes key/pressed.
Tick the cancellation option on packet/chat events to cancel immediately. Cancellation is cumulative across plugins and macros and affects the same underlying packet. It is intentionally impossible to wire a delayed cancellation.
Palette
| Group | Blocks |
|---|---|
| When | Every tick; replay event; packet in/out; chat in/out; key. |
| Chat | Log (macro log, Mint log, or local chat); Send chat (normal server message). |
| Player | Walk, Jump, Sneak, Sprint, Stop moving, Look at, Walk to, Follow player, Stop pathing, Swing arm, Use item, Click, Hold key, Crosshair/player info. |
| World | Mine block at/crosshair, Show a fake block, World info, Block at. The pathfinder itself never mines or places blocks. |
| Items | Select hotbar, Equip, Drop, Click slot, Swap slots, Close screen, My items, Open screen. |
| Replay | Replay control and Replay info. |
| Logic | If, Wait, Remember, Count up, Remembered value. |
| Value | Fixed/random values; Maths and Compare; join/split/replace/case/trim text; make/add/get/length/join lists. |
| Others | Nearest player/entity. |
Block dropdowns describe their exact operation. Read blocks output the chosen property; wire it directly into an action or comparison. Text fields also support {{variableName}} and {{event.field}} interpolation.
Canvas shortcuts
Ctrl/Cmd+C,X,V: copy, cut, paste selected nodes.Ctrl/Cmd+D: duplicate.Ctrl/Cmd+A: select all.Delete/Backspace: remove selection.Escape: clear/cancel the current selection/connection.- Mouse drag pans/selects according to the canvas tool; wheel zooms.
Paste assigns new node and edge IDs and offsets the copy, so it cannot create duplicate identities. Saving performs the same graph validation used by the runtime.
Runtime limits
Graphs compile once when loaded, keep variables while enabled, and dispatch only event roots they actually listen to. One dispatch is limited to 1,024 execution steps to contain accidental runaway graphs. The complete payload must remain under 64 KiB.
See Macro examples for the diagnostic graph and smaller starters.