72 lines
5.3 KiB
Markdown
72 lines
5.3 KiB
Markdown
# Decisions
|
|
|
|
1. **Preserve input directory.** Keep Original in place, baseline all file hashes,
|
|
generate outputs elsewhere. No legacy binary execution in the source directory.
|
|
2. **Nested local repository.** Workspace `.git` is reserved and not a functioning
|
|
repository. Initialize GamePort/.git, no remotes, commit code/docs/tools only.
|
|
3. **Evidence-first data recovery.** Native x86 executable does not imply little
|
|
endian formats: GAM and OMT use big endian metadata. Require bounded readers,
|
|
full consumption and real original-file regressions.
|
|
4. **Initial scene.** NewGame.tsk starts LV1B and player GAM references STARTEXP.
|
|
Prioritize that scene; use smaller VR01 for data/render verification. The LV1B
|
|
LABEXP start trigger means simple camera spawning is insufficient for fidelity.
|
|
5. **Local dependencies.** Missing SDK/native tools installed under `.tools` or
|
|
`/tmp` after approved official downloads, without assuming root or altering host.
|
|
6. **Useful parallelism.** Three independent agents own binary/rendering, asset
|
|
recovery and infrastructure, while primary owns gameplay data and integration.
|
|
Shared runtime/format changes must be coordinated. No external coordination.
|
|
7. **Honest compatibility.** Build, headless Vulkan frame, SDL presentation,
|
|
gameplay fidelity and native Windows execution are separate evidence categories.
|
|
8. **Preview ground contact and idle clarity.** User testing exposed floor overlap
|
|
and a misleading animated-default description. Original idle vertices are
|
|
identical; do not invent idle motion. Expose moving source clips explicitly.
|
|
Until original actor transforms/collision settling are recovered, apply one
|
|
model-only floor correction derived from standing soles and visible geometry,
|
|
with explicit preview labeling and regression tests. Preserve GAM/ASE data and
|
|
per-frame morph displacement; this is not the original collision algorithm.
|
|
9. **Controllable lab before complete scene.** Integrate evidence-backed no-gadget
|
|
walking/jumping/camera now, with separate stateful simulation and explicit
|
|
provisional source-triangle capsule collision. Rendering does not set the number
|
|
of movement calls: use60Hz until original cadence is recovered. Preserve source
|
|
GAM/ASE positions; keep physical feet, inferred actor-root height and visual
|
|
pivot separate. Include invisible geometry rather than inventing visibility
|
|
masks. Document the skipped intro, missing interactions, transient jump-state
|
|
simplification, animation timing and close-wall camera limitation. Test against
|
|
source geometry and build both packages without calling this a faithful full scene.
|
|
|
|
10. **Source-driven scene interpreter.** Preserve synchronous AI action dispatch,
|
|
original camera formulas and audio-duration advancement rather than adding a
|
|
fixed intro timer or completingSCENE on intro end. Separate task activation,
|
|
sprite playback, draw visibility and physical collision. Report unrecovered
|
|
behavior explicitly. Preserve unknown TSK fields and original checkpoint resume;
|
|
no claim of arbitrary-position/full-state save support.
|
|
11. **Separate supplied records from required content.** All35 GAM entity files
|
|
exist;33 have matching OMT geometry archives. Level3B/Level3E GAMs contain the
|
|
same four entities apart from their level code, with no incoming serialized
|
|
GAM transition or supplied save selecting them. Their original classes name
|
|
absent OMT archives, but registration alone does not prove normal gameplay use.
|
|
Record unavailable geometry without substitution; do not classify it as a
|
|
reconstruction blocker or request more files unless progression requires it.
|
|
|
|
12. **Preserve source physics boundaries.** Recovered quick magnitude, support trace,
|
|
radii/factors and3DUD broadphase/triangle ordering stay separate from provisional
|
|
wall/capsule response. Check isolated original DLL results without executing or
|
|
modifying originals in place. Keep visual soles distinct from logical root75.9.
|
|
13. **Correct prototype names from original evidence.** The pickup tagged SHRINKRAY
|
|
is the jet pack in original objective art and inventory slot0/3 code. Practice0
|
|
entersVR04/PHONEBOOTH with current GAM/STRT return context. Do not invent a
|
|
shrink-ray weapon, VR01 mapping or TSK StoredVector checkpoint meaning.
|
|
14. **Compose original UI and effect assets.** Draw source640x480 UI in a separate
|
|
depth-disabled overlay; retain clipped original coordinates. Use exact default
|
|
SoundEffects.omt identities for lab effects, preserve encoded RIFF resources
|
|
and document unsupported decoders. Do not substitute editor fonts/audio banks.
|
|
15. **Default recovered scene play.** Start the integrated lab story/interactions by
|
|
default; retain --inspect and deterministic smoke modes. Passing direct-contact
|
|
tests does not establish navigation, original fidelity or full-game completion.
|
|
16. **Use recovered control and UI lifetimes.** MCA PlayerControlled restores its
|
|
target at completion; active valid shots clear control. O changes the objective
|
|
animation timer rather than gadget layout. Reset air-turn state at the recovered
|
|
grounded/released branch. Use per-level geometry-layer far limits; the current
|
|
merged renderer uses their maximum until separate layer masks are implemented.
|
|
Source evidence and regression limits are recorded in the focused analysis docs.
|