Flow Control

​

delay

  smash:
  - particlering{particle=flame;radius=5;points=48} @self  # warn
  - delay 0.5s                                             # wind up
  - damage{amount=10} @playersRadius[4]                    # hit

​

run

- run smash #onHurt @target

​

if

- if{cond=var.phase >= 2;then=enrage;else=calm} #onHurt @target
- if{cond=random < 0.3;then=rare_drop}          #onDeath @self

​

loop

- loop{effect=ring_blast;times=3;every=10} @self

​

while

- while{cond=var.charging;effect=charge_tick;every=5;max=200} @self

​

Bodies: named effects or inline blocks

• Statements are full effect lines, mechanic plus optional @targeter, separated by ;.
• Blocks nest: a statement can itself be an if/loop/while with its own block.
• A block may span multiple lines, and continuation lines may start with - for readability. The loader joins them before YAML parsing, so the raw multi-line form doesn’t need to be valid YAML on its own.

- if{cond=random < 0.5;then={narrate "&dheads!";sound{sound=block.bell.use}};else={narrate "&dtails"}}
- if{cond=var.phase >= 2;then={
  - narrate "&cThe boss is enraged!" @playersRadius[20]
  - setspeed{amount=0.45} @self
  - glow{glowing=true} @self
  };else=calm_down}

• No #triggers inside a block. The trigger belongs to the outer line.
• No comments inside a multi-line block.
• A malformed or empty block fails the whole line at load time, logged and skipped.
• Prefer a named effect over a block when the body should be reusable or run-able. Blocks are for short one-off branches.

​

randomskill

- randomskill{skills=slam,fire_breath,summon_wave} #onAttack @target

​

randommessage

- randommessage{messages=&7Hello!\|&7Greetings.\|&7Oh, you again.} #onInteract @target

​

Conditions

• Operators: >= <= > < == !=.
• Truthy check: a lone operand with no comparison is true when the value is set and non-zero, non-empty and not "false". Example: if{cond=var.enraged;then=...}.
• Operands: numbers; variable references without angle brackets (var.x, target.var.x, global.var.x, world.var.x, skill.var.x); the keywords random (alias chance, a fresh 0-1 roll per evaluation, so random < 0.3 is a 30% chance), health and maxhealth (the casting mob’s), and time (world ticks). Anything else is a string literal, bare word, no quotes needed.
• Both sides numeric means numeric comparison. Otherwise case-insensitive string equality, == and != only; ordered operators on strings are always false.
• Unset variables count as 0 in numeric comparisons and "" in string ones.
• target.var.x reads from the line’s first target.
• A malformed condition fails the whole line at load time, logged and skipped, like any other parse error.

- if{cond=health <= 150 && var.phase == 1;then=enrage} #onHurt @self

​

Behavior notes

• A branch or loop body runs with the caller’s context: same targets (unless its lines set their own @targeter) and the same skill. variable scope, so loop counters via var{...} work across iterations.
• A delay inside a looped effect pauses that iteration only, not the loop schedule.
• Spaced loop and while stop early if the mob dies or despawns. while’s max is a hard safety cap against infinite loops.

​

The counter pattern

  effects:
  - var{n=0}                                          #onInteract @target
  - while{cond=var.n < 5;effect=step;every=10} @self  #onInteract @target
  step:
  - var{n+=1}
  - actionbar{message=&6charge <var.n> of 5} @playersRadius[16]