strats: custom object types can be edited and deleted with undo (code rebuilt, objects follow their type), low-confidence opcodes re-checked (353 high, 2 low left), script view with do-while, while, break, continue, switch and else-if (gotos 11019 -> 400), first script compiler (structured script -> assembly, script stored with the type)

notes/strat-language.md

@@ -9,7 +9,8 @@ the STPC chunk as **code units** (one per compiled source file; notes/editor-cro
 | `OpTable` | opcode/property names and docs (resources `ops.tsv`, `props.tsv`; notes/strat-opcodes.md) |
 | `StratListing` | unit → assembly text (+ per-line metadata: offsets, editable constants) |
 | `StratAssembler` | text → unit words; layout = where the unit goes + model/anim/unit offsets |
-| `StratPseudo` | read-only structured view (expressions, if/else, loops) |
+| `StratPseudo` | read-only structured view (expressions, if/else, loops, switch, break/continue) |
+| `StratCompiler` | script language → assembly (new behaviour) |
 | `Num` | literals: `42`, `0x2a`, `1.5` (20.12), `90deg` |
 
 **Round trip (golden test `StratRoundTripTest`)**: disassemble → assemble is byte-identical for
@@ -95,11 +96,23 @@ own-unit addresses), plus the model/animation/unit offsets of the target STPC fo
 
 ## Script view (`StratPseudo`)
 
-Read-only. Stack code folded into expressions (`self.y = self.floorHeight + 204`), properties as
-`self.x`, `player.y`, `parent.v3`, `camera.…`; forward `jz/jnz` → `if {…}` (with `else` when the
-block ends in a forward `jmp`), backward `jmp`/`jmpYield` → `loop {… yield}`; blocks are only
-built when they nest, everything else stays `goto label`. Inline operands in `<>`:
-`spawn<3, 6, 0, 0, 0>(10.0, 204, 450, unit:35+0x28)`. Example (Coin):
+Read-only (not parsed back). Stack code folded into expressions (`self.y = self.floorHeight + 204`),
+properties as `self.x`, `player.y`, `parent.v3`, `camera.…`. Control flow is rebuilt from the jumps
+where the blocks nest:
+
+| Jumps | Shown as |
+|---|---|
+| forward `jz`/`jnz` over a block (+ `jmp` over a second block) | `if (…) {…} else {…}`; an `if` that is the whole else part → `} else if (…) {`; an empty then-part is negated |
+| backward `jmp`/`jmpYield` | `loop {… yield}`; first statement `if (c) break` → `while (!c) {…}` |
+| backward conditional jump | `do {…} while (c)` (`/*yield*/` for jzYield/jnzYield; empty body: `do {} while (c) /*yield*/`) |
+| jump to the end / head of the innermost loop | `break` / `continue` (also as `if (c) break`) |
+| `switch` + `jmp end` with the cases in between | `switch (v) { case 1.0: … break … }` (`default:` when the jmp goes to a case-like block) |
+
+Everything else stays `goto label` (mostly multi-level breaks out of nested loops and `||` chains
+that jump to a common far target). Over all 1461 units: **11 019 → 400 gotos** (2026-11-07;
+guarded by `StratPseudoTest`, which also checks balanced blocks and that every remaining goto has
+its label). Inline operands in `<>`: `spawn<3, 6, 0, 0, 0>(10.0, 204, 450, unit:35+0x28)`.
+Example (Coin):
 
 ```
 strat Coin:
@@ -116,6 +129,58 @@ if (v0) {
 loop { turnLeft(5.625deg); yield }
 ```
 
+## Script language (`StratCompiler`) – writing NEW behaviour
+
+A small structured language in the style of the script view, compiled to the assembly above (so
+everything the assembler checks still applies). Implemented slice (2026-11-07): strats, subroutines,
+aliases, assignments, expressions, if/else if/else, while, loop, do-while, break/continue, yield,
+calls of any opcode by name. Tests: `StratCompilerTest`; verified in game (village 1:
+`img/mods/strats_script_game.jpg`).
+
+```
+// bobs one cell up and down and turns
+strat Bobber {
+    alias base = v0              // .alias base = v0
+    alias phase = v1
+    setModel(model:5)            // any opcode: name<inline operands>(stack arguments)
+    base = self.y + 1.0
+    phase = 0
+    loop {
+        phase = phase + 4deg
+        self.y = base + sin(phase)
+        turnLeft(4deg)
+        yield                    // last statement of a loop → the loop's jmpYield back edge
+    }
+}
+
+sub wobble {                     // called with "call wobble", ends with return
+    self.rotZ = sin(self.rotY) * 0.1
+}
+```
+
+| Construct | Compiles to |
+|---|---|
+| `strat Name { … }` | `.string "Name"`, label `Name:`, `debugName "Name"`, body, `end` unless the body cannot fall through |
+| `sub name { … }` / `call name` / `return` | label, body, `return` / `call name` / `return` |
+| `x = e`, `x += e` (`-=`, `*=`, `/=`) | e, pop op of x; `x += 1.0` / `x -= 1.0` → address + `inc`/`dec` |
+| places | `vN`, alias, `gN`, `self.prop`, `player.prop`, `parent.prop`, `parent.vN`, `camera.`/`target.`/`target2.`/`boss.`/`dialog.prop` (props.tsv names or `propN`) |
+| literals | as in the assembly: `10.0` = ten, `10` = 10 raw units (1/4096), `90deg`, `0x10`; 16-bit values use `pushShort`, others `push` |
+| references | `model:N`, `anim:N`, `unit:N` (`address`), `sound:N` (`soundAddress`), `tex:N` (`push`) |
+| operators (low → high) | `||` `|` (or) · `&&` (and) · `&` · `==` `!=` · `<` `>` `<=` `>=` · `<<` `>>` · `+` `-` · `*` `/` · unary `-` `!` |
+| `op<a, b>(e1, e2)` | e1, e2, `op a, b`; the argument count must match the opcode's pops; a value-returning op used as a statement is followed by `pop` |
+| `if (c) {…} else if … else {…}` | `c; jz else; …; jmp end; else: …` |
+| `while (c) {…}` / `loop {…}` | head label, `c; jz end`, body, `jmp`/`jmpYield head` |
+| `do {…} while (c)` | body, `c; jnz head` |
+| `break` / `continue` / `yield` / `end` | `jmp end` / `jmp head` (do: the condition) / `jmpYield next` / `end` |
+
+The generated assembly starts with the script as `;| ` comment lines, so the editor can show the
+script again (*Edit type…*). Comments: `//`, `/* */`; `;` and newlines separate statements.
+
+**Next steps (not implemented)**: event handlers (`on touched { … }` → `.event` table + `onEvent`),
+`switch`, `spawn` with typed arguments, local names for parameters from the object schema, `for`,
+constant folding, typed numbers (int vs fixed) instead of the assembly's literal rules,
+short-circuit `&&`/`||` (now: both sides are evaluated, like the original `and`/`or` opcodes).
+
 ## Editing in the level editor (`editor.tools.strats`)
 
 * **Script panel** (bottom dock, View → Panels → Script, Ctrl+Shift+K): unit chooser (all code units
@@ -136,6 +201,15 @@ loop { turnLeft(5.625deg); yield }
   Verification: the merged STPC is disassembled again (no decode errors, entry decoded, every
   `address` operand of the new unit hits a model, animation set or code, and the new unit's
   listing re-assembles to the same words).
+* **Edit type… / Delete type…** (Script panel, Inspector *Script* section of a custom object):
+  edit opens the same dialog with the type's source (script or assembly), *Apply* rebuilds all
+  custom units (`TypeEdits.edit`, one undo step) and the placed objects move to the new entry.
+  Delete warns with the number of objects that use the type and removes them with it
+  (`TypeEdits.delete`: `Edits.delete` of the users + the type list change, one undo step).
+  Creating is undoable too (`TypeEdits.create`), except when imported types follow the custom
+  block (then appended as before).
+* **Language** (dialog): *Assembly* or *Script* (compiled by `StratCompiler`, see above);
+  switching Script → Assembly shows the generated code.
 * **Load order** (`ProjectIO.LoadHook.order()`): constants of base units (−10) → imported types
   (CrossImport, 0) → constants of imported units and custom types (+10). Custom units are always
   last on load; if types were imported after a custom type in the session, the stored strat codes
@@ -143,8 +217,11 @@ loop { turnLeft(5.625deg); yield }
 
 ## Limits
 
-* Custom types cannot be removed or re-edited in place (clone again; the old unit stays as dead
-  code until the project is recreated). Constants of custom types are changed through their source.
+* Custom types are edited and deleted as a whole list: the custom units are cut off the code and
+  appended again (objects follow their type's new entry). Not possible while object types imported
+  after the custom ones sit behind them in the code (save and reopen the project first; on load the
+  custom types always come last). A custom type that addresses another custom type's unit with
+  `unit:N` breaks when that index changes. Constants of custom types are changed through their source.
 * `pushShort` holds only −8.0…7.99; bigger values need a source edit (`push`).
 * The script view is a reading aid (gotos where blocks do not nest; expressions assume the
   documented pop/push counts; ops with variable stack use are shown raw).

notes/strat-opcodes.md

@@ -10,8 +10,19 @@ properties). Language/syntax: `notes/strat-language.md`. Disassembler/assembler:
   of the word, 0x45+ "long" with inline operand words). All of them have a name and a one-line
   semantics from reading every handler (headless Ghidra decompile of the two handler tables
   0x5796bc / 0x578ff4, plus the helpers they call).
-* Confidence: **329 high, 71 medium, 34 low**. Of the **222 opcodes the 34 level WADs use**: 170 high,
-  37 medium, 15 low; high-confidence opcodes cover **96.8 %** of the 556314 instructions in the levels.
+* Confidence: **353 high, 79 medium, 2 low**. Of the **222 opcodes the 34 level WADs use**: 177 high,
+  44 medium, 1 low; high-confidence opcodes cover **97.3 %** of the 556314 instructions in the levels.
+* **Low-confidence review (2026-11-07)**: all 34 former low opcodes re-read (handler table entry checked
+  against the exe, Ghidra decompile of handler + callees, `objdump` of the exe where Ghidra's C was
+  incomplete – e.g. it drops the bone index of 0xc7 and every reader of +0x114), and cross-checked
+  with their uses in the WADs. Findings: 0x107 setAnimSpeed is the per-frame animation step (sub-frame
+  accumulator +0x116, 1.0 = one frame per game frame); 0x2f freezes a strat while it is off-camera
+  (with the camera pass's +0xEC 0x8000); 0x28 is read by the camera scripts to look at the strat
+  registered with 0x113; 0x14a is a no-op (FUN_004268c0 only acts for 0); 0x9c's value is dead;
+  0x18a/0x18b set the pending particle settings consumed by the next spawnParticle; 0x1a9's top
+  value is the rain texture and the others are wind x, amount, wind z; all no-op/drop stubs verified.
+  Still low: 0x34 and 0xf2 (no reader of their flag bits found). Names unchanged (stored sources use
+  them); see the table for the new descriptions.
 * **252 opcodes matched to Argonaut names** (column *ref*: Croc 2 PSX demo jump table / Croc 1
   handler names), by handler behaviour and table position. 99 slots are no-ops, error stubs or
   pop-only stubs (dropped Croc features).
@@ -100,30 +111,30 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0x23 | `error_0x23` | - | 0 | 0 |  | high | stCollide_AlienVarAddress | Prints "stCollide_AlienVarAddress" not-implemented error; unused. <sub>54d220</sub> |
 | 0x24 | `pushTarget2Prop` | prop | 0 | 1 |  | medium | stTarget_AlienVar | Pushes property n of the second target strat (DAT_006D9E34, set by 0xca), 0 if none; unused. <sub>552bd0</sub> |
 | 0x25 | `pushTarget2PropAddr` | prop | 0 | 1 |  | medium | stTarget_AlienVarAddress | Pushes address of target2 property n (0 if none); unused. <sub>552c00</sub> |
-| 0x26 | `pushBossProp` | prop | 0 | 1 |  | low | stBoss_AlienVar | Pushes property n of the strat in DAT_006D9E24 (set by 0xef), no null check; unused. <sub>552b10</sub> |
-| 0x27 | `pushBossPropAddr` | prop | 0 | 1 |  | low | stBoss_AlienVarAddress | Pushes address of property n of the DAT_006D9E24 strat; unused. <sub>552b30</sub> |
-| 0x28 | `pushDialogProp` | prop | 0 | 1 | 1678 | low | stDialog_AlienVar | Pushes property n of the strat in DAT_006D9E2C (set by 0x113, used by NPC/puzzle strats), 0 if none. <sub>552cb0</sub> |
-| 0x29 | `pushDialogPropAddr` | prop | 0 | 1 |  | low | stDialog_AlienVarAddress | Pushes address of property n of the DAT_006D9E2C strat (0 if none); unused. <sub>552ce0</sub> |
+| 0x26 | `pushBossProp` | prop | 0 | 1 |  | high | stBoss_AlienVar | Pushes property n of the boss strat DAT_006D9E24 (set by 0xef isBoss) via the getter FUN_00550E60; no null check; unused in the levels. <sub>552b10</sub> |
+| 0x27 | `pushBossPropAddr` | prop | 0 | 1 |  | high | stBoss_AlienVarAddress | Pushes the address of property n of the boss strat DAT_006D9E24 (setter FUN_005509F0 returns the address); no null check; unused. <sub>552b30</sub> |
+| 0x28 | `pushDialogProp` | prop | 0 | 1 | 1678 | high | stDialog_AlienVar | Pushes property n of the strat registered by 0x113 (DAT_006D9E2C: the NPC/puzzle/door that a cut-scene is about), 0 if none. WAD use: Camera and CutSceneCameraDirectional read its x/y/z/rotY to look at it (1585 of 1678 uses). <sub>552cb0</sub> |
+| 0x29 | `pushDialogPropAddr` | prop | 0 | 1 |  | high | stDialog_AlienVarAddress | Pushes the address of property n of the DAT_006D9E2C strat (0 if none); unused. <sub>552ce0</sub> |
 | 0x2a | `shadow` | imm | 0 | 0 | 887 | medium | stShadow | arg!=0 sets, 0 clears +0xE8 bit 0x20 (shadow on; shadow pass requires it plus size from 0x59 and texture from 0x5a). <sub>54e8e0</sub> |
 | 0x2b | `jmpYield` | rel | 0 | 0 | 2958 | high | - | Jumps to next+arg*4 and yields this frame (loop back-edge / wait one frame). <sub>553da0</sub> |
 | 0x2c | `nop_0x2c` | - | 0 | 0 |  | high | - | No-op (shared empty handler); unused. <sub>426500</sub> |
 | 0x2d | `nop_0x2d` | - | 0 | 0 |  | high | - | No-op (shared empty handler); unused. <sub>426500</sub> |
 | 0x2e | `nop_0x2e` | - | 0 | 0 |  | high | - | No-op (shared empty handler); unused. <sub>426500</sub> |
-| 0x2f | `flagEC10000` | imm | 0 | 0 | 1888 | low | - | arg!=0 sets, 0 clears +0xEC bit 0x10000 (with 0x8000 both set the strat skips player-distance updates; property 0xf2 reads it); meaning unclear. <sub>54f720</sub> |
+| 0x2f | `flagEC10000` | imm | 0 | 0 | 1888 | medium | - | arg!=0 sets, 0 clears +0xEC bit 0x10000 = "freeze when off-camera": the camera pass (FUN_00436190) sets +0xEC 0x8000 when the strat is outside the camera range; with both bits set the frame loop (0x54c603) and the strat-vs-strat collision loop (0x54cc1a) skip it. Used by ~1350 strats (pickups, triggers, enemies). <sub>54f720</sub> |
 | 0x30 | `trackPlayer` | imm | 0 | 0 |  | medium | - | If no player yet: re-executes itself next frame (pc-=4, yield); else arg sets/clears +0xEC bit 0x4000 = update distance to player each frame (+0x148). <sub>54fa80</sub> |
-| 0x31 | `flagEC2` | imm | 0 | 0 | 410 | low | - | arg sets/clears +0xEC bit 2 (checked by collision/floor code via +0xC0, readable as property 0x1f). <sub>54e090</sub> |
-| 0x32 | `flagE8_80000000` | imm | 0 | 0 |  | low | - | arg sets/clears +0xE8 bit 31; unused. <sub>54dd90</sub> |
-| 0x33 | `flagEC100` | imm | 0 | 0 | 60 | low | - | arg sets/clears +0xEC bit 0x100 (tested in the collision response, skips floor handling; used by drops/projectiles/rollercoaster). <sub>54dd30</sub> |
-| 0x34 | `flagEC200000` | imm | 0 | 0 | 50 | low | - | arg sets/clears +0xEC bit 0x200000 (used by NPC helpers/canoe/llama). <sub>54dd60</sub> |
+| 0x31 | `flagEC2` | imm | 0 | 0 | 410 | medium | - | arg sets/clears +0xEC bit 2 = "others can stand on / touch me": in the strat collision loop (0x54cc96) a strat touching a strat with this bit gets +0xE8 0x400000 (and 0x800000 when it moves) = properties 32/33; also readable as property 0x1f. Set by Llama, Coin, Jar, EnemyCoin, RubyIdol. <sub>54e090</sub> |
+| 0x32 | `flagE8_80000000` | imm | 0 | 0 |  | medium | - | arg sets/clears +0xE8 bit 31; no reader of the bit found in the exe (scan of all +0xE8 flag tests); unused in the levels. <sub>54dd90</sub> |
+| 0x33 | `flagEC100` | imm | 0 | 0 | 60 | medium | - | arg sets/clears +0xEC bit 0x100; the collision response (0x4044f7) skips the floor/slope handling when it is set. Used by LlamaSpit, DropObject, RollerCoaster, KuscoTurtle (objects that move by script, not by floor physics). <sub>54dd30</sub> |
+| 0x34 | `flagEC200000` | imm | 0 | 0 | 50 | low | - | arg sets/clears +0xEC bit 0x200000; no direct test of the bit found in the exe (all +0xEC flag tests scanned). Used by Llama, RiverCroc, RiverLog, Rock, river NPCs (river/canoe level objects). <sub>54dd60</sub> |
 | 0x35 | `nop_0x35` | - | 0 | 0 |  | high | - | No-op (shared empty handler); unused. <sub>426500</sub> |
 | 0x36 | `nop_0x36` | - | 0 | 0 |  | high | - | No-op (shared empty handler); unused. <sub>426500</sub> |
 | 0x37 | `popPlayerProp` | playerProp | 1 | 0 | 1131 | high | - | Pops value and stores it into player property n (discarded if no player). <sub>553920</sub> |
 | 0x38 | `popCameraProp` | prop | 1 | 0 | 564 | high | - | Pops value into camera strat property n (discarded if none). <sub>553950</sub> |
 | 0x39 | `popTargetProp` | prop | 1 | 0 | 186 | medium | - | Pops value into camera target (DAT_006D9E30) property n (discarded if none). <sub>553980</sub> |
 | 0x3a | `popTarget2Prop` | prop | 1 | 0 |  | medium | - | Pops value into DAT_006D9E34 strat property n (discarded if none); unused. <sub>5539b0</sub> |
-| 0x3b | `popDialogProp` | prop | 1 | 0 |  | low | - | Pops value into DAT_006D9E2C strat property n (discarded if none); unused. <sub>5539e0</sub> |
+| 0x3b | `popDialogProp` | prop | 1 | 0 |  | high | - | Pops a value into property n of the DAT_006D9E2C strat (discarded if none); unused. <sub>5539e0</sub> |
 | 0x3c | `error_0x3c` | - | 0 | 0 |  | high | - | Prints "stCollide_AlienVar_Equals" not-implemented error; unused. <sub>54d240</sub> |
-| 0x3d | `popBossProp` | prop | 1 | 0 |  | low | - | Pops value into DAT_006D9E24 strat property n (no null check); unused. <sub>553a10</sub> |
+| 0x3d | `popBossProp` | prop | 1 | 0 |  | high | - | Pops a value into property n of the boss strat DAT_006D9E24 (no null check); unused. <sub>553a10</sub> |
 | 0x3e | `popParentVar` | var | 1 | 0 | 204 | high | - | Pops value into variable n of the +0xC strat. <sub>553a40</sub> |
 | 0x3f | `popParentProp` | prop | 1 | 0 |  | high | - | Pops value into property n of the +0xC strat; unused. <sub>553a60</sub> |
 | 0x40 | `popProp` | prop | 1 | 0 | 15730 | high | - | Pops value into own property n (via FUN_005509F0 address). <sub>553a90</sub> |
@@ -197,15 +208,15 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0x84 | `collHeight` | - | 0 | 0 |  | high | stCollHeight | Unimplemented: logs "stCollheight" only. <sub>54d300</sub> |
 | 0x85 | `collExtent` | - | 1 | 0 |  | medium | stCollextent | pops extent; stores its low 16 bits raw into short +0xC4. <sub>54e930</sub> |
 | 0x86 | `collView` | - | 0 | 0 |  | high | stCollView | Unimplemented: logs "stCollview" only. <sub>54d320</sub> |
-| 0x87 | `nop_0x87` | - | 0 | 0 |  | low | stCollPoints | Shared no-op handler (0x426500); unused. Slot of Croc2 stCollPoints. <sub>426500</sub> |
-| 0x88 | `nop_0x88` | - | 0 | 0 |  | low | stCollSetPoint | Shared no-op handler (0x426500); unused. Slot of Croc2 stCollSetPoint. <sub>426500</sub> |
+| 0x87 | `nop_0x87` | - | 0 | 0 |  | high | stCollPoints | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. Slot of Croc2 stCollPoints. <sub>426500</sub> |
+| 0x88 | `nop_0x88` | - | 0 | 0 |  | high | stCollSetPoint | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. Slot of Croc2 stCollSetPoint. <sub>426500</sub> |
 | 0x89 | `createTrigger` | - | 0 | 0 | 45 | medium | stCreateTrigger | Sets flag 0x40 in +0xE8 (strat becomes a trigger/touchable, used by pickups like Health, Carrot). <sub>54e4c0</sub> |
 | 0x8a | `killTrigger` | - | 0 | 0 |  | medium | stKillTrigger | Clears flags 0x40 and 0x4000000 in +0xE8 (undoes createTrigger). <sub>54e4b0</sub> |
 | 0x8b | `wait` | - | 1 | 0 | 1671 | high | stWait | pops frames (fixed, >>12) into wait counter short +0xFE and sets flag 0x2 in +0xE8 (strat sleeps until the counter runs out). <sub>54fb40</sub> |
 | 0x8c | `hold` | - | 0 | 0 | 110 | medium | stHold | Sets flags 0x12 (0x2 wait + 0x10 stopped) in +0xE8: suspends the strat indefinitely until released. <sub>54fce0</sub> |
 | 0x8d | `release` | - | 0 | 0 |  | high | stRelease | Unimplemented: logs "stRelease" only. <sub>54d340</sub> |
 | 0x8e | `remove` | - | 0 | 0 | 985 | high | stRemove | Sets flags 0x6 in +0xE8 (yield + kill); same handler as 0xb4 end. <sub>5535e0</sub> |
-| 0x8f | `nop_0x8f` | - | 0 | 0 |  | low | stMapRemove | Shared no-op handler (0x426500); unused. Slot of Croc2 stMapRemove. <sub>426500</sub> |
+| 0x8f | `nop_0x8f` | - | 0 | 0 |  | high | stMapRemove | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. Slot of Croc2 stMapRemove. <sub>426500</sub> |
 | 0x90 | `mapAdd` | - | 0 | 0 |  | high | stMapAdd | Unimplemented: logs "stMapadd" only. <sub>54d360</sub> |
 | 0x91 | `mapReplace` | - | 0 | 0 |  | high | stMapReplace | Unimplemented: logs "stMapreplace" only. <sub>54d380</sub> |
 | 0x92 | `activated` | - | 0 | 0 |  | medium | stActivated | Sets bit 0x8 in byte +0x44 of the strat's map-instance record (+0xF0): marks the map object as activated (persistent state). <sub>54db40</sub> |
@@ -218,8 +229,8 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0x99 | `soundStop` | - | 1 | 0 | 209 | high | stSoundStop | pops sound channel; stops that channel if owned by this strat, or (channel <0/invalid) all sounds of this strat. <sub>54e1c0</sub> |
 | 0x9a | `musicPlay` | - | 1 | 0 | 108 | high | stCdPlay | pops music track index (fixed, >>12); if different from the current track (0x586430) starts that ASF music stream (FUN_00546b70). <sub>54d4c0</sub> |
 | 0x9b | `streamPlay` | - | 0 | 0 |  | high | - | Unimplemented: logs "stStreamPlay" only. <sub>54d3e0</sub> |
-| 0x9c | `speechSetPos` | - | 1 | 0 | 31 | low | - | pops a value (fixed, >>12) into global 0x6DA2B8 (meaning unknown, likely speech volume/range) and moves the speech/voice stream (handle 0x6D94B4, started by '#' text) to this strat's position. <sub>54d530</sub> |
-| 0x9d | `discard_0x9d` | - | 1 | 0 | 28 | low | stMidiVolume | pops a value (>>12) and passes it to the no-op debug print; effectively drop. Croc2 slot midiVolume/cdFade. <sub>54d4f0</sub> |
+| 0x9c | `speechSetPos` | - | 1 | 0 | 31 | high | - | Pops a value into global 0x6DA2B8 (written only, never read: no effect) and moves the speech/voice channel (DAT_006D94A0, started by "#" texts) to this strat's position (+0x30..0x38), so the voice plays from the speaker. <sub>54d530</sub> |
+| 0x9d | `discard_0x9d` | - | 1 | 0 | 28 | high | stMidiVolume | Pops a value (>>12) and passes it to the empty function 0x426500: a pure drop on PC. Croc2 slot midiVolume/cdFade. <sub>54d4f0</sub> |
 | 0x9e | `speechStop` | - | 0 | 0 | 141 | high | stMidiStop | Stops the current speech/voice stream (handle 0x6D94B4) if one is playing and resets the handle to -1. <sub>54d510</sub> |
 | 0x9f | `streamQueue` | - | 0 | 0 |  | high | stMidiQueue | Unimplemented: logs "stStreamQueue" only. <sub>54d400</sub> |
 | 0xa0 | `isLight` | - | 0 | 0 |  | high | stIsLight | Unimplemented: logs "stIsLight" only. <sub>54d420</sub> |
@@ -239,7 +250,7 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0xae | `cos` | - | 1 | 1 | 3149 | high | stCos | pops angle; pushes cos (table 0x574318 offset by quarter turn 0x400). <sub>54e810</sub> |
 | 0xaf | `not` | - | 1 | 1 | 4952 | high | stNot | pops x; pushes 1 if x==0 else 0. <sub>54fc20</sub> |
 | 0xb0 | `pop` | - | 1 | 0 |  | high | stPop | Drops the top stack value (stack pointer +0x104 -= 4). <sub>553dd0</sub> |
-| 0xb1 | `stkCmp` | imm | 0 | 1 |  | low | stStkCmp | Peeks (does not pop) the top stack entry, dereferences it as a pointer and pushes imm minus the pointed-to int (compare helper). <sub>553de0</sub> |
+| 0xb1 | `stkCmp` | imm | 0 | 1 |  | high | stStkCmp | Reads one inline word imm (pc += 4), peeks the top stack entry (no pop), dereferences it as an int pointer and pushes imm − *top. Unused in the levels. <sub>553de0</sub> |
 | 0xb2 | `address` | addr | 0 | 1 | 7890 | high | stAddress | Patches itself into 0x45 (push immediate) after resolving the operand to an absolute address (negative = import table 0x6DA324, else + STPC base 0x6D9DBC) and pushes it (code/model/anim address). <sub>553630</sub> |
 | 0xb3 | `return` | - | 1 | 0 | 4974 | high | stReturn | pops code address and jumps there (pc = popped). <sub>5537d0</sub> |
 | 0xb4 | `end` | - | 0 | 0 | 2006 | high | stEndStrat | Sets flags 0x6 in +0xE8 (yield + kill): ends the strat. Same handler as 0x8e. <sub>5535e0</sub> |
@@ -249,36 +260,36 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0xb8 | `bitwiseAnd` | - | 2 | 1 | 6814 | high | stBitwiseAnd | pops b, a; pushes a & b. <sub>552e30</sub> |
 | 0xb9 | `discard_0xb9` | - | 1 | 0 |  | medium | - | Shared stub 0x554fb0: pops one value and discards it. Unused (Croc2 ext-var slots). <sub>554fb0</sub> |
 | 0xba | `discard_0xba` | - | 1 | 0 |  | medium | - | Shared stub 0x554fb0: pops one value and discards it. Unused. <sub>554fb0</sub> |
-| 0xbb | `nop_0xbb` | - | 0 | 0 |  | low | - | Shared no-op handler (0x426500); unused. <sub>426500</sub> |
+| 0xbb | `nop_0xbb` | - | 0 | 0 |  | high | - | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. <sub>426500</sub> |
 | 0xbc | `notEqual` | - | 2 | 1 | 2576 | high | stNotEqual | pops b, a; pushes 1 if a != b else 0. <sub>54fbd0</sub> |
 | 0xbd | `greaterEqual` | - | 2 | 1 | 1169 | high | stGreaterEqual | pops b, a; pushes 1 if a >= b else 0. <sub>553b80</sub> |
 | 0xbe | `lessEqual` | - | 2 | 1 | 2129 | high | stLessEqual | pops b, a; pushes 1 if a <= b else 0. <sub>553b50</sub> |
 | 0xbf | `rnd` | - | 1 | 1 | 4990 | high | stRnd | pops n; pushes random value (two rand() halves) modulo n, 0 if n==0; result is in the same units as n (fixed in, fixed out). <sub>54f960</sub> |
 | 0xc0 | `loseHeart` | - | 0 | 0 | 219 | high | stLoseHeart | In game state 3, unless player invulnerable (0x584710 bit 0): health 0x584E70 -= 1.0, or if already 0 sets 0x584638 = 2 (player dies); refreshes HUD (FUN_004268c0(1)). <sub>54f5c0</sub> |
-| 0xc1 | `nop_0xc1` | - | 0 | 0 |  | low | stResettoCheckPoint | Shared no-op handler (0x426500); unused. Croc2 slot stResettoCheckPoint. <sub>426500</sub> |
+| 0xc1 | `nop_0xc1` | - | 0 | 0 |  | high | stResettoCheckPoint | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. Croc2 slot stResettoCheckPoint. <sub>426500</sub> |
 | 0xc2 | `forceCollision` | - | 0 | 0 | 1619 | medium | stForceCollision | Runs world collision for this strat (FUN_00403020 with level geometry): updates floor/ceiling/wall info in the collision block +0xC0 (ground height, surface type). <sub>54e9c0</sub> |
 | 0xc3 | `turnFromPlayerY` | - | 1 | 0 |  | medium | stTurnFromPlayerY | pops max turn step (angle, 0x1000000 = full turn); turns yaw +0x24 toward the direction from the player (0x6D9E1C) to this strat, i.e. away from the player, by at most step. <sub>54f1c0</sub> |
-| 0xc4 | `rumble` | - | 2 | 0 | 93 | low | stRumble | Shared stub 0x555090: pops two values and discards them (PSX pad rumble/vibrate not implemented on PC). <sub>555090</sub> |
-| 0xc5 | `suspendIfTooFar` | - | 1 | 0 | 232 | low | stSuspendIfTooFar | Shared stub 0x554fb0: pops one value (likely distance) and discards it. <sub>554fb0</sub> |
+| 0xc4 | `rumble` | - | 2 | 0 | 93 | high | stRumble | Shared stub 0x555090: pops two values and discards them (PSX pad rumble is not implemented on PC). <sub>555090</sub> |
+| 0xc5 | `suspendIfTooFar` | - | 1 | 0 | 232 | high | stSuspendIfTooFar | Shared stub 0x554fb0: pops one value (distance) and discards it – no effect on PC (op 0x2f gives the off-camera freeze instead). <sub>554fb0</sub> |
 | 0xc6 | `collisionBone` | - | 2 | 0 | 90 | medium | stCollisionBone | pops value (short), then bone id (fixed, >>12); sets/adds entry {id, value} in the bone table at +0xC8 (count +0xC6). <sub>54e6c0</sub> |
-| 0xc7 | `useBone` | - | 1 | 0 | 345 | low | stUseBone | pops one value (ignored); if a model/anim is set (+0x14) rebuilds the rotation matrix and stores a transformed point (matrix * local vector + translation +0x94) into +0xD8/+0xDC/+0xE0. <sub>54e4d0</sub> |
+| 0xc7 | `useBone` | - | 1 | 0 | 345 | high | stUseBone | Pops bone n (>>12); if the strat has an animated model (+0x14) it takes bone n of the current animation frame (+0x110; anim+0x1C frame table, 64 bytes per bone, offset +0x30..0x38 = bone position), rotates it by the strat's rotation matrix and adds the position: world point in +0xD8/+0xDC/+0xE0 = properties boneX/Y/Z. (The Ghidra C output drops the bone index; read from the assembly.) Used to spawn effects at hands/mouths. <sub>54e4d0</sub> |
 | 0xc8 | `isCamera` | - | 0 | 0 | 34 | high | stIsCamera | Registers this strat as the camera (global 0x6D9E28) and sets flag 0x8000000 in +0xE8. <sub>5500f0</sub> |
 | 0xc9 | `lookAtMe` | - | 0 | 0 | 86 | high | stLookatme | Sets camera look-at target global 0x6D9E30 = this strat. <sub>5500e0</sub> |
 | 0xca | `lookAtMe2` | - | 0 | 0 |  | medium | stLookatme | Sets secondary look-at global 0x6D9E34 = this strat. Unused. <sub>5500d0</sub> |
 | 0xcb | `pushCamera` | - | 0 | 0 |  | high | stPushCamera | Pushes current camera (0x6D9E28) and look-at (0x6D9E30) pair onto the camera stack 0x6D9DCC (index 0x6D9E40). <sub>54dbb0</sub> |
 | 0xcc | `popCamera` | - | 0 | 0 |  | high | stPopCamera | If the camera stack is not empty, restores camera and look-at from it and increments camera-change counter 0x6D9D34. <sub>54db00</sub> |
-| 0xcd | `nop_0xcd` | - | 0 | 0 |  | low | stResetCamerapos | Shared no-op handler (0x426500); unused. Croc2 slot stResetCamerapos. <sub>426500</sub> |
+| 0xcd | `nop_0xcd` | - | 0 | 0 |  | high | stResetCamerapos | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. Croc2 slot stResetCamerapos. <sub>426500</sub> |
 | 0xce | `gainHeart` | - | 0 | 0 | 94 | high | stGainHeart | Health 0x584E70 += 1.0 if below max 0x584E6C; refreshes HUD (FUN_004268c0(1)). <sub>54f650</sub> |
-| 0xcf | `nop_0xcf` | - | 0 | 0 |  | low | stGainHeartPot | Shared no-op handler (0x426500); unused. Croc2 slot stGainHeartPot. <sub>426500</sub> |
+| 0xcf | `nop_0xcf` | - | 0 | 0 |  | high | stGainHeartPot | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. Croc2 slot stGainHeartPot. <sub>426500</sub> |
 | 0xd0 | `addInv` | imm | 0 | 0 |  | medium | stAddInv | Adds inline item to inventory via FUN_00426860(item,1,1,0,0), which is a stub returning 0 on PC (no effect). <sub>54da00</sub> |
-| 0xd1 | `nop_0xd1` | - | 0 | 0 |  | low | stGainCrystal | Shared no-op handler (0x426500); unused. Croc2 slot stGainCrystal. <sub>426500</sub> |
-| 0xd2 | `discard_0xd2` | - | 1 | 0 |  | low | stCutscene | Shared stub 0x554fb0: pops one value and discards it. Unused (Croc2 slot stCutscene). <sub>554fb0</sub> |
+| 0xd1 | `nop_0xd1` | - | 0 | 0 |  | high | stGainCrystal | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. Croc2 slot stGainCrystal. <sub>426500</sub> |
+| 0xd2 | `discard_0xd2` | - | 1 | 0 |  | high | stCutscene | Shared stub 0x554fb0: pops one value and discards it. Unused (Croc2 slot stCutscene). <sub>554fb0</sub> |
 | 0xd3 | `inventory` | imm | 0 | 1 |  | medium | stInventory | Queries inline item via stub FUN_00426860 and pushes result<<12 (always 0 on PC). <sub>54d9d0</sub> |
 | 0xd4 | `debugName` | imm,count | 0 | 0 | 1804 | high | stDebugname | Strat name: skips the first inline word, reads the byte length of the following name string, sets the name pointer (+0x18) to that string and jumps past it. <sub>553ef0</sub> |
 | 0xd5 | `soundPlay` | - | 1 | 0 | 1835 | high | stSoundPlay | pops sound id; plays it on this strat (FUN_00546170); outside game states 3/4 first sets game state 0x5846E4 = 5. <sub>54e230</sub> |
 | 0xd6 | `soundPlayAss` | - | 1 | 1 | 288 | high | stSoundPlayass | pops sound id; in game states 3/4 plays it and pushes the channel (raw int), else pushes -1. <sub>54e1e0</sub> |
 | 0xd7 | `soundAddress` | sound | 0 | 1 | 2996 | high | stSoundAddress | Pushes the inline sound id (same handler as 0x45 push immediate). <sub>5535f0</sub> |
-| 0xd8 | `nop_0xd8` | - | 0 | 0 |  | low | stOnground | Shared no-op handler (0x426500); unused. Croc2 slot stOnground/stObjectFallslow. <sub>426500</sub> |
+| 0xd8 | `nop_0xd8` | - | 0 | 0 |  | high | stOnground | Shared empty handler 0x426500 (verified in the handler table); unused in the levels. Croc2 slot stOnground/stObjectFallslow. <sub>426500</sub> |
 | 0xd9 | `collisionOffset` | - | 3 | 0 | 403 | high | stCollisionOffset | pops z, y, x; stores low 16 bits into shorts +0xD0, +0xCE, +0xCC (collision centre offset). <sub>54e050</sub> |
 | 0xda | `abs` | - | 1 | 1 | 1847 | high | stAbs | pops x; pushes \|x\|. <sub>5508d0</sub> |
 | 0xdb | `pickup` | imm | 0 | 0 |  | medium | stPickup | inline flag: nonzero sets bit 0x200 in +0xEC, zero clears it (strat can be picked up/carried). <sub>54dd00</sub> |
@@ -304,7 +315,7 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0xef | `isBoss` | - | 0 | 0 |  | high | stIsboss | registers this strat as the boss: DAT_006d9e24 = self <sub>550130</sub> |
 | 0xf0 | `topSay` | text | 0 | 0 | 1308 | high | stTopsay | shows dialog text (inline text index) in the top text box: sets DAT_006d9858=1 and formats via FUN_0040d4c0 <sub>40d480</sub> |
 | 0xf1 | `getParentPos` | - | 0 | 0 | 48 | high | stGetparentpos | copies parent's (+0xC) orientation+position block (+0x20..+0x3C, 8 words) into this strat <sub>54e030</sub> |
-| 0xf2 | `setDrawMode` | - | 1 | 0 |  | low | - | pops mode (raw int): 1 sets flag 0x80000 in +0xEC, 2 sets 0x100000, other clears both (exact effect of the bits unknown); unused <sub>54fe40</sub> |
+| 0xf2 | `setDrawMode` | - | 1 | 0 |  | low | - | Pops mode (raw int): 1 sets +0xEC 0x80000, 2 sets 0x100000, anything else clears both; no reader of these two bits found in the exe; unused in the levels. <sub>54fe40</sub> |
 | 0xf3 | `afterBoss` | - | 0 | 0 |  | high | stAfterboss | if no boss (DAT_006d9e24) rewinds pc and yields (waits); else relinks this strat in the process list right after the boss <sub>553290</sub> |
 | 0xf4 | `afterPlayer` | - | 0 | 0 | 144 | high | stAfterPlayer | if no player (DAT_006d9e1c) rewinds pc and yields (waits); else relinks this strat in the process list right after the player <sub>553380</sub> |
 | 0xf5 | `beforePlayer` | - | 0 | 0 | 22 | high | stBeforePlayer | if no player rewinds pc and yields (waits); else relinks this strat in the process list right before the player <sub>553300</sub> |
@@ -325,7 +336,7 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0x104 | `moveDownQ` | - | 1 | 0 | 314 | high | stMoveDownq | pops distance (fixed); y(+0x34) -= d <sub>550940</sub> |
 | 0x105 | `forcePlayerDist` | - | 0 | 0 |  | high | stForcePlayerdist | recomputes the cached squared player distance +0x148 (coords >>6) and clears +0x1C; 0x200000 if no player; unused <sub>54e950</sub> |
 | 0x106 | `nop_0x106` | - | 0 | 0 |  | high | stShadeType? | no-op handler FUN_00426500 (does nothing, no inline operands); unused <sub>426500</sub> |
-| 0x107 | `setAnimSpeed` | - | 1 | 0 | 645 | low | stSetanimSpeed? | pops value and stores its low 16 bits (raw, not >>12) in halfword +0x114 (animation timing field, zeroed when the anim frame is set) <sub>54d880</sub> |
+| 0x107 | `setAnimSpeed` | - | 1 | 0 | 645 | high | stSetanimSpeed? | Pops the animation speed (20.12, 1.0 = one animation frame per game frame) into halfword +0x114; while animating (+0xE8 bit 8) the frame loop adds it to the sub-frame counter +0x116 and advances the frame (+0x110) each time it passes 1.0 (0x54c630). WAD use: 1.0, 0.25, 1.5 and computed values. <sub>54d880</sub> |
 | 0x108 | `nop_0x108` | - | 0 | 0 |  | high | stCheckleveldoor? | no-op handler FUN_00426500 (does nothing, no inline operands); unused <sub>426500</sub> |
 | 0x109 | `nop_0x109` | - | 0 | 0 |  | high | - | no-op handler FUN_00426500 (does nothing, no inline operands); unused <sub>426500</sub> |
 | 0x10a | `nop_0x10a` | - | 0 | 0 |  | high | - | no-op handler FUN_00426500 (does nothing, no inline operands); unused <sub>426500</sub> |
@@ -392,7 +403,7 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0x147 | `nop_0x147` | - | 0 | 0 |  | high | - | Empty handler FUN_00426500 (shared no-op); does nothing. <sub>426500</sub> |
 | 0x148 | `gotoLevel4_1` | - | 0 | 0 |  | medium | - | Hardcoded level change: next level (0x584EB4/EB8/EBC/EC0) = 4/1/1/0, previous level (0x585008..14) = 4/1/4/0, game state 0x584638 = 7 (load level). <sub>54e430</sub> |
 | 0x149 | `nop_0x149` | - | 0 | 0 |  | high | - | Empty handler FUN_00426500 (shared no-op); does nothing. <sub>426500</sub> |
-| 0x14a | `hudReset2` | - | 0 | 0 |  | low | - | Calls HUD/panel init FUN_004268c0(2): re-initialises the on-screen counter panels (coins, lives, etc.) for the current level. <sub>54f700</sub> |
+| 0x14a | `hudReset2` | - | 0 | 0 |  | high | - | Calls FUN_004268c0(2), which returns at once for any argument other than 0 (verified in the assembly): a no-op. Unused. <sub>54f700</sub> |
 | 0x14b | `setGlobal5fd086` | imm | 0 | 0 |  | medium | - | Stores the low 16 bits of the inline word in global 0x5FD086 (never read elsewhere; dead leftover). <sub>54e890</sub> |
 | 0x14c | `removeCollPoint` | - | 1 | 0 | 49 | medium | stSetCollPoint (inverse) | pops id (fixed, >>12); removes the collision point with that id from the strat's collision point list (+0xC8 array of 4-byte entries, count +0xC6). Counterpart of 0xc6 (add/set collision point). <sub>54e720</sub> |
 | 0x14d | `setFlagEC_400000` | flags | 0 | 0 |  | high | - | Inline word: nonzero sets, zero clears bit 0x400000 of strat flags2 (+0xEC); the bit selects which height constant own property 0xF2 returns. <sub>54f780</sub> |
@@ -410,7 +421,7 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0x159 | `nop_0x159` | - | 0 | 0 |  | high | - | Empty handler FUN_00426500 (shared no-op); does nothing. <sub>426500</sub> |
 | 0x15a | `setPosToPlayer` | - | 0 | 0 | 27 | high | - | Copies the player's position x/y/z (+0x30..+0x38) and +0x3C into the strat (player strat = 0x6D9E1C). <sub>554480</sub> |
 | 0x15b | `setPosToPlayerXZ` | - | 0 | 0 |  | high | - | Copies the player's x and z (+0x30, +0x38) into the strat; y unchanged. <sub>5544b0</sub> |
-| 0x15c | `setShadowHeight` | - | 1 | 0 | 1 | low | - | pops v; stores it in strat +0x14C, used by the shadow renderer as the shadow/ground height override (-0x1000 = use default 0x586424). <sub>5544d0</sub> |
+| 0x15c | `setShadowHeight` | - | 1 | 0 | 1 | medium | - | Pops v into +0x14C, the water/floor height limit used by the shadow pass (FUN_00555140: -0x1000 = use the camera-cell floor height DAT_00586424, prop camFloorHeight); the shadow is skipped when the floor under the strat lies below it. One use (SinkingStatuePad). <sub>5544d0</sub> |
 | 0x15d | `packRgb` | - | 3 | 1 | 98 | high | - | pops c (top), b, a (fixed 0..255); pushes (c<<16)\|(b<<8)\|a as a raw packed colour int (push order r,g,b gives 0x00BBGGRR). <sub>5544f0</sub> |
 | 0x15e | `trailCreate` | - | 2 | 1 | 6 | medium | - | pops vertB (top), vertA (fixed vertex indices of the strat's model/anim frame); allocates a free trail/ribbon slot (0x5FD180, 0x42C bytes each) owned by this strat and pushes its handle (0 if none free). <sub>554530</sub> |
 | 0x15f | `trailAddPoint` | - | 3 | 0 | 6 | medium | - | pops colourB (top), colourA, trail handle; transforms the two trail vertices of the current anim frame into world space and appends them to the trail history (20 points) with the given colours; no-op if handle 0. <sub>5545c0</sub> |
@@ -456,8 +467,8 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0x187 | `emitterInit` | - | 7 | 0 | 113 | medium | stSpawnparticle | pops colour/texture (top, raw), z, y, x (vector/offset), type (fixed 1..0x2B preset, or >=0x1000 type flags), size/speed (fixed, 0x1000 default), slot (0..2, >=3 = extra slot +0x153); (re)initialises the strat's particle emitter in that slot (records at 0x5FE230, 0x34 bytes; texture/colour stored per type). <sub>552f40</sub> |
 | 0x188 | `emitParticles` | - | 3 | 0 |  | medium | - | pops yStep (top, fixed), count, slot; emits count particles from the slot's emitter at own position with random XZ velocity, each raised by yStep. <sub>552fb0</sub> |
 | 0x189 | `randSigned` | - | 1 | 1 | 922 | high | - | pops n; pushes a random value in (-n, n) ((rand32 - rand32) % n, same fixed scale as n). <sub>54f9a0</sub> |
-| 0x18a | `emitterSetParams` | - | 5 | 0 | 113 | low | - | pops e (top), d, c, b, slot; sets emitter slot params: +0x254 = b (rate/speed), +0x24A = c>>12 (life); if e==0 +0x25C = (d>>12)*32-32 else +0x246 = e, +0x23C = d. Allocates the slot if empty. <sub>5530b0</sub> |
-| 0x18b | `emitterSetColour` | - | 5 | 0 | 9 | low | - | pops colour (top, raw packed, see 0x15d), b, g, r, slot; sets emitter colour (+0x250) and fade/alpha (+0x240..243): if r has no fraction it is an alpha value only, else r,g,b are per-channel fade values. <sub>553100</sub> |
+| 0x18a | `emitterSetParams` | - | 5 | 0 | 113 | medium | - | Pops e (top), d, c, b, slot (>>12): pending particle settings of this strat (slot 0–2 → record index at strat+0x150+slot, ≥3 → +0x153, record allocated on demand in the 0x34-byte table 0x5FE23C): b = size scale (1.0 = default), c>>12 = extra lifetime in frames, e≠0: +0x246 = e (drift), +0x23C = d; e==0: +0x25C = (d>>12)*32-32 (sprite size). spawnParticle consumes and resets the +0x153 record; same as spawnParticle type 0x19. <sub>5530b0</sub> |
+| 0x18b | `emitterSetColour` | - | 5 | 0 | 9 | medium | - | Pops colour (top, raw packed, see 0x15d), b, g, r, slot: pending particle colour for the next particle(s) of this strat (record as 0x18a; same as spawnParticle type 0x1e): +0x250 = colour; r without fraction = alpha r>>12 (7 bits), else r,g,b>>12 = per-channel fade, +0x243 = 0x80; alpha 0 = 0xFF/lifetime. <sub>553100</sub> |
 | 0x18c | `emitParticlesStill` | - | 3 | 0 | 50 | medium | - | pops yStep (top, raw fixed), count, slot; emits count particles from the slot's emitter at own position without velocity, stacked by yStep. <sub>552ff0</sub> |
 | 0x18d | `stubPop2_0x18d` | - | 2 | 0 |  | high | - | Stub FUN_00555090: pops and discards 2 values (feature removed in PC port). <sub>555090</sub> |
 | 0x18e | `stubPop2_0x18e` | - | 2 | 0 |  | high | - | Stub FUN_00555090: pops and discards 2 values (feature removed in PC port). <sub>555090</sub> |
@@ -487,7 +498,7 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 0x1a6 | `emitterKill` | - | 1 | 0 |  | high | - | pops slot (fixed); frees the strat's particle emitter in that slot (+0x150+slot = 0xFF) and resets the record. <sub>553150</sub> |
 | 0x1a7 | `stubPush0_0x1a7` | - | 0 | 1 |  | high | - | Stub FUN_0054e880: pushes 0. <sub>54e880</sub> |
 | 0x1a8 | `processFirst` | - | 0 | 0 | 1 | high | - | Moves self to the head of the strat update list (0x6D9E38) if not already there. <sub>554e20</sub> |
-| 0x1a9 | `setRain` | - | 4 | 0 | 4 | low | - | pops colour (top, raw -> 0x6D9BE8), b (->0x578EF4), a2 (->0x6D9BF4), a1 (->0x578EF0) (all >>12); if the three counts/params are 0 rain is stopped and cleared, else rain is enabled (0x6D9BE4 = 1). <sub>554fc0</sub> |
+| 0x1a9 | `setRain` | - | 4 | 0 | 4 | medium | - | Weather: pops texture (top, raw tex index → 0x6D9BE8, read by the rain renderer), windZ (>>12 → 0x578EF4), c (>>12 → 0x6D9BF4, only used for the off test), windX (>>12 → 0x578EF0); each raindrop restarts with velocity (windX, -256, windZ) per frame. windX, c, windZ all 0 = rain off (drops cleared, 0x6D9BE4 = 0), else on. Rain type: setRain(v0, v1, v2, tex:768) with params 16.0, 0, 16.0. <sub>554fc0</sub> |
 | 0x1aa | `stubPop1Push0_0x1aa` | - | 1 | 1 |  | high | - | Stub FUN_005550b0: pops 1 value and pushes 0. <sub>5550b0</sub> |
 | 0x1ab | `stubPop2_0x1ab` | - | 2 | 0 |  | high | - | Stub FUN_00555090: pops and discards 2 values (feature removed in PC port). <sub>555090</sub> |
 | 0x1ac | `stubPop1Push0_0x1ac` | - | 1 | 1 |  | high | - | Stub FUN_005550b0: pops 1 value and pushes 0. <sub>5550b0</sub> |