6.9 KiB
Source entity resources and contact investigation
Read-only 2026-10-24. tools/extractors/entities.py prepares exact GAM typed fields, sourceSHA/offsets/raw bytes, transforms, duplicate tags, object-link candidate ordinals, and explicit database/type/id references. It does not decide gameplay visibility or turn editor SpriteDatabase icons into game actors. --decode preserves referenced PCM WAV, Canv RGBA/PNG and3DSh decoded JSON. Tests check preservation, case lookup/ambiguity, path boundaries and actual lab/VR01 resources.
LV1B has129 entities:19 PIC,20AIT,13CAM,12MCA,16PAT,4OMT,2LOAD,2buttons and a bars object, plus actors/effects. Its62 explicit resources resolve. VR01 has16 entities, 4star pickups IDs3001..3004 (sprites.omt Canv135 star, PointValue5,radius100), 2RETURN gates,2phone booths, trophy and a3-shot voicepractice intro24/23/22; 10 unique explicit resources resolve. Static level geometry omits dynamic actors.
Verified visual mappings
- Carl STOP carlstop.ase0x4EDBC0 registered413DDC; texturecarl.png0x4EDBB4 at413DF2. TALK/WALK/INHALE/CHEER/TELE registrations413D8C..413DE8; actual strings have HI quality prefixes. Raw morph animation timing/quality dispatch remains incomplete.
- Goddard godsit.ASE0x4EEA0C registered41CDDE, goddard02.png0x4EE980 at41CE58. HI-prefixed registrations41CDA0..41CE5F include FLY/EAT/RUN/SIT/SCOOT/WAG/GROWL/ ROCK/POINT. Godpoint has complete UVs; godsit/run/growl have none. Current actor preparation retains godpoint UVs for the common222-point/411-face topology; this base choice is an inference. Godwag has30 different expanded corner UVs. Follow-up40DF18..22 proves unregistered STOP/TALK/WALK requests preserve the current clip/name. The consumer retains that source no-op; it invents no aliases.
- Trophy trophy.ase0x4F16E4 at448E1F; trophy.png0x4F16D8 at448E3A. Update448EC0 spins Y90deg/sec (constant0x4A7388). Contact448F20 accepts active player, hides, adds300 score, plays effect230, disables contact. No task/level completion in that callback.
- Phone class43579D opens phone.omt0x4F0314, shape3DSh0 via477BA0 at4357C9. Do not substitute similarly named phone.ASE/phone.png without evidence.
- Buttons explicit down/up ASEbuttondown/buttonup and switch.png bind411695/ 4116C3/411722. Bars explicit GAM ASEFilebars.ase/PNGFilechain.png.
- SpriteSize is actual world width/height: EXE4645F0 sets complete+AC/B0, C4 bit1; OMTget_canv_wordsize10029930 reads them. Align values3/3 center offsets by half size via10029890. Exact billboard flag248 handling remains under investigation.
Contact and pickup rules
PIC interface+C8 vtable4AE548 contactslot40->435CE0. LOAD interface+C8 vtable4D025C contactslot40->457EC0. Shared0x47A430 uses sphere path0x47B3E0 unless collisionmode slot178 returns2, which uses specialized box path47A5E0. Sphere overlap obtains roots via slot310, quick_magnitude, compares STRICT distance <radiusA+radiusB (slot260), applies exclusion lists47CA90, invokes enter40 once, stay48 while recorded, leave44 on separation. It is not a per-frame pickup callback.
quick_magnitude (OMT1001FF70..10020059, imported48D104) uses abs components, squared ratio and original acos/cos lookup tables; Vector3.Distance is an approximation. Jimmy normal interaction radius60 (different state160) is established in original collision notes; this is not evidence to resize the provisional physical capsule.
PIC accepts only global active player5099E4. Acquired flag table4F8438 indexed by PickupIndex prevents repeat. RequiredPicNum gate436830 requires group2 inventory state nonzero and count>=ReqPicNumAmount, then consumes that amount and clears inventory if depleted. This is a consuming prerequisite, not only a check. PointValue>0 adds global score through42ADC0, lower-clamped0; repeat count gates it. Normal collected flag1 hides/disables; PickedUpIndex!=-1 path uses flag2/effect. Inventory/special pickup effects remain to be completed before broad collection.
These data/executable findings are not full runtime entity or interaction support. Only Carl/Goddard and Jimmy morph consumers are currently integrated into --story; source sprites/OMT props/phones/trophy/buttons/bars still require runtime consumers.
Implemented sprite/contact subset (primary follow-up)
Source3ANI update40ED40 adds dt to a float timer and advances only when timer is strictly greater than1/FPS; resets timer0, advances one frame per invocation, discarding remainder. Loop0 stops on last visible frame,1 repeats,2 hides/stops (40EF02..41). Toggle40F160 resets index/timer and shows/starts on1, hides/stops on0, -1 toggles subject to its one-second debounce. Port implements explicit0/1 from the director; debounced-1 sprite toggles remain pending. Task activation is separate from the AnimatedSprite Activated field: a visible apple can be idle.
SourceSprite1..9 resources are now exported, and source-sized centered quads render3PIC/3ANI from their explicit Canv resources. Camera-facing orientation is still an approximation. Color modulation is retained; translucent alpha/blending and all billboard flags remain to be recovered. Editor icons are not rendered.
SceneInteractions currently accepts the ordinary3000..3999,PointValue5, no-inventory star subset and trophy; broader pickup inventory/special effects report unsupported. Normal acquired flag1 at435E11 hides/disables; score path435FC3..436002 adds positive PointValue under repeat gating. Special tags4365D0..436829 are intentionally not silently treated as plain score pickups. Original VR01 fixture tests collect4stars for20, trophy for300, prevent repeat, serialize/reload acquired flags, and emit a single stored RETURN request per contact entry. Original quick_magnitude and exclusion/box contact rules remain unresolved; modern root-sphere distance is used.
The executable's RETURN branch457F92..4580BE reads Jimmy complete+88C (saved third string) and+8F0 (fourth string), supporting stored ReturnLevel/ReturnStart semantics. Headless VR01->LV1B renderer/window-lifetime integration passes. Fades are not yet implemented. Acquisition is serialized in TSK; full game-state/UI saving remains unfinished. Trophy disable is per scene; no invented permanent trophy flag is added.
All35 GAM files are present, including Level3B.gam and Level3E.gam. Their matching OMT geometry archives are absent and named by the executable at4F1F24/4F1FFC. Both1777-byte GAMs have identical bytes after the level identifier and four entities; no serialized incoming GAM transition or supplied save selects them. Original class registration/loading paths do not establish use in normal progression. Their absence is not a proven required-content blocker.33 available pairs are generated; scene-catalog.json records unavailable geometry without substitution. See level-resource-mapping.md for loader and corpus evidence. Additional unresolved explicit references: LEV1 icons.omt Canv45 (editor icon), LV5A musicrocketmaze.omt Wave2, LV2A musicschool.omt Wave2. No substitutions.