105 lines
6.9 KiB
Markdown
105 lines
6.9 KiB
Markdown
# 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.
|