Reconstruct lab story, interactions, patrol and jet pack practice flow
This commit is contained in:
1 parent
58424120bb
commit
c929f942e1
84 files changed
+7957
-305
No files matched your search
@@ -0,0 +1,104 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user