# 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 =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.