strats: custom types stay editable after importing object types (custom code kept last), references between custom types by name, edit can change where fields come from, opcode aliases with clearer names, script view gotos 400 -> 31 (labeled break/continue, condition chains, jumps to return), script language 2: event handlers, switch, short-circuit && ||, constant folding, schema parameter names, plain numbers in cells

notes/strat-opcodes.md

@@ -21,8 +21,13 @@ properties). Language/syntax: `notes/strat-language.md`. Disassembler/assembler:
   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.
+  Still low: 0x34 and 0xf2 (no reader of their flag bits found); see the table for the new descriptions.
+* **Renamed opcodes (aliases)**: placeholder names whose meaning the review established got clear
+  names – 0x2f `flagEC10000` → `freezeOffCamera`, 0x31 `flagEC2` → `touchable`, 0x33 `flagEC100` →
+  `noFloorPhysics`, 0x14a `hudReset2` → `hudResetNoop`. The old names stay valid mnemonics
+  (resource `op-aliases.tsv`, `OpTable.alias`), so stored sources still assemble; listings and the
+  compiler use the new names. Names of flags without a known reader (0x32, 0x34, 0x141–0x144,
+  0x14b) keep their address-style names.
 * **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).
@@ -120,11 +125,11 @@ ops = operands (inline words for long ops, the 16-bit argument for short ops); p
 | 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 | 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> |
+| 0x2f | `freezeOffCamera` (was `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 | 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> |
+| 0x31 | `touchable` (was `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> |
+| 0x33 | `noFloorPhysics` (was `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> |
@@ -403,7 +408,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 |  | 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> |
+| 0x14a | `hudResetNoop` (was `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> |