Behaviour blocks: conditions, effects, counters and Lua signals in the brain

[sp00ktober]

Phase 3 of the moveset editor: the behaviour graph's blocks get conditions, effects, counters, flags and Lua signals, and the brain runs them. Stacked on #65.

• The brain (C, framework api 4):
  • A rule can hold up to 4 conditions: HP %, part broken, enraged or calm, the hunter's side, a chance, and counters.
  • It can hold up to 2 effects: add to a counter, set a counter.
  • A rule can fire on a Lua signal, and a rule can play nothing.
  • Each frame every no-play rule runs first; then the first playing rule that holds fires.
  • New events: enraged and calmed.
  • A blackboard per monster holds 16 counters and 16 signals.
  • The caps go to 48 rules and 48 own moves, +5 KB of partition memory.
  • addresses.toml is the one contract for C, Python and Lua.
• Lua: port:var(name [, v]) and port:fire(name).
• Graph and studio:
  • New blocks: Any time, Base monster idle, On signal, Monster HP, Part broken, Monster is (enraged or calm), Hunter side, Chance, Counter is, Flag is, Add to counter, Set counter, Set flag.
  • Effect blocks get their own colour and palette group.
  • Counter and signal names are picked or typed on the node.
  • The rule table lists no-play paths first, so the #n badges are the order the brain runs.
• Fixes found live:
  • An own move started as the monster enters its hub after a reaction is no longer cut at frame 0: SCRIPT_WAKE is quieted on the hub.
  • A part whose break bit another part shares (em75's two forelegs) now raises part_broken.
• The Zinogre demo, the owner's examples:
  • The horns break → head flinch.
  • A foreleg breaks → falls to the side, lies there, gets up, then stamps.
  • After the 2nd flinch → charges up.
  • The hunter far away → dash.
  • Below 30 % HP → one howl.
  • port:fire("roar") → howl.
  • An in_combat flag gates the idle paths.

Live, lane 3:

• Every demo path, the counters, the signal, the HP gate, the distance cooldown (300 frames exactly) and the hunter's four sectors check out.
• The notice howl and the native tail cut and drop still work.
• No crash in ~1.5 h over 3 cold boots.
• The three bugs it found are fixed: fixed and retested live (in_combat survives a re-notice, both forelegs topple in either order, the charge plays 4 of 4 after a flinch).

Tests: 2941 passed with game data on macOS; CI's test job passes on Linux 3.11 and 3.14 (2358 passed).

🤖 Generated with Claude Code