Implement verified Grappler body camera and helpers in VR08
This commit is contained in:
1 parent
ffea678e90
commit
43806fe862
39 files changed
+2429
-40
No files matched your search
@@ -0,0 +1,58 @@
|
||||
# Grappler shared body/contact composition
|
||||
|
||||
2026-11-04. Original EXE SHA256 f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8.
|
||||
Static VAs in this report map to file offset VA−400000. Source ranges/hashes,
|
||||
relocation allowlist and generator: `tools/binary/grappler_body.py`;
|
||||
`artifacts/grappler-body-live/source.json`. Reuses REA47B4B0
|
||||
`ev_d45e078c585d3773494c0e0dfb1696178dd0b8ce8b696caf133892ff070e552e`
|
||||
and43AA40 `ev_4f2a6aa666451db831efd46f5c587573e22d8072315626b8bc2f844f9c6f0cae`.
|
||||
This checkpoint adds execution of copied components, not new whole-original play.
|
||||
|
||||
## Recovered ownership and order
|
||||
|
||||
479BC0..479D1B traverses enabled body integration before ordinary object callbacks.
|
||||
479D20 initializes shared sphere state once: last polygon695D4C=NULL,
|
||||
nearest face695D5C=130000, nearest edge5CFBE0=radius. Sphere hit point is5CFBE8.
|
||||
Body motion invokes47B4B0; callback370 handles normalY<=−.7 and374 handles
|
||||
normalY>−.7. Support47B890→47C6E0 and ray47C210 use selected polygon695D54 /
|
||||
hit5CFC60 instead. They preserve all four sphere state fields.
|
||||
|
||||
429D00's attached branch invokes47B4B0 at42A016 without resetting that sphere
|
||||
context. Therefore movement *away* from a previously accepted wall can replay
|
||||
374 even when the new movement accepts no polygon. Zero delta skips dispatch.
|
||||
A fresh context on each attached move would silently lose this callback.
|
||||
|
||||
Jimmy374→42A660 first invokes full Player43AA40. For the bounded VR08 material
|
||||
IDs0/2/3/4, all probed grounded/mature combinations leave the body unchanged.
|
||||
The derived suffix clears horizontal swing globals4F82BC/C0, then detaches
|
||||
strictly when their incoming magnitude exceeds60; equality60 stays attached.
|
||||
The action latch is set by this same fast-contact branch. Detach429C10 zeros
|
||||
velocity, selects FALL, damps swing .96 and stops loop34; it adds no impulse.
|
||||
Ordinary ceiling370→472690 clears positive Y velocity and acceleration separately.
|
||||
Attached input later clears Vy unconditionally. After an attached callback the
|
||||
429D00 tail still executes, including swing publication and pre-collision rope root.
|
||||
Normal frame/player update still runs after input returns.
|
||||
|
||||
## Copied-original observations
|
||||
|
||||
`artifacts/grappler-body-live/probe/wine.log` ends
|
||||
GRAPPLER_BODY_COMPONENT_COMPLETE; private Wine32 probe exit0. Generated code
|
||||
uses copied original body/support/ray/static dispatcher, synthetic grid and
|
||||
callback counters. Its8 chained observations cover body wall+floor, support/ray
|
||||
preservation, stale replay, zero delta and the −.7 boundary.32 cases execute full
|
||||
43AA40 then42A660 across four materials ×grounded ×mature ×fast/slow swing.
|
||||
A final case checks ceiling's independent positive-Y rules.41 observations and
|
||||
input/log hashes are retained in `tests/GamePort.GrapplerLiveTests/original-body-reference.json`.
|
||||
These are original-component execution with synthetic inputs, not whole-game,
|
||||
original scheduler, historical hardware or original render evidence.
|
||||
|
||||
## Implemented bridge and limits
|
||||
|
||||
OriginalBodyPhysics retains its mutable StaticCollisionContext. MoveAttached
|
||||
requires the preceding body phase and reuses that object. LabSimulation invokes
|
||||
370/374 after publication, feeds attached contact back to GrapplerGadget and
|
||||
continues ordinary player update. Normal physics wall callbacks also reach it.
|
||||
Bounded live admission adds only VR08, whose materials are independently guarded.
|
||||
Other actors/global sphere-context interleavings, dynamic pairs, special-material
|
||||
callbacks and other levels remain outside this integration. The per-player
|
||||
context is a bounded adapter, not a recovered general scene-global scheduler.
|
||||
@@ -0,0 +1,125 @@
|
||||
# Grappler follow camera: local fields, consumers and live adapter
|
||||
|
||||
2026-11-03. Static recovery against Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Originals remain untouched. All VAs below have PE file offset VA−400000 at
|
||||
the guarded sites. `tools/binary/grappler_camera.py` emits actual mapped offsets,
|
||||
span hashes, virtual targets and constants to
|
||||
`artifacts/grappler-camera-live/source.json`. Its twelve tests exercise a bounded
|
||||
Python projection, not original game execution or a live camera comparison.
|
||||
|
||||
## State writers are not camera poses
|
||||
|
||||
Jimmy complete+7C8/7CC/7D0 stores local eye XYZ; +7D8/7DC/7E0 local look XYZ;
|
||||
+854/858/85C stores follow gains. These fields feed shared viewport eye
|
||||
+44/48/4C and pitch/yaw +50/52 through the active follow callback. They are not
|
||||
ready-to-use world coordinates or camera height/distance parameters.
|
||||
|
||||
| State / original writer | Eye local | Look local | Stored gains XYZ |
|
||||
|---|---|---|---|
|
||||
|Normal defaults437740..43778D, complete170|0,200,−350|0,80,0|1.6,1,1.6|
|
||||
|Equip42981A..429844|0,50,−350|0,150,80|**Unchanged**|
|
||||
|Attach426D59..426D7F|X unchanged,400,−650|**Unchanged**|.8,1,.8|
|
||||
|Attached detach429C34..429C74|0,50,−350|0,130,100|1.6,1,1.6|
|
||||
|Cleanup4287FC..42880A|Detach then normal defaults|Detach then normal defaults|Normal defaults|
|
||||
|
||||
Detach429C10 is a strict no-op when attached4F8210 is already false. Cleanup
|
||||
still calls437740 in that case. Equip does not clear attachment or first rope
|
||||
length in its selected branch. Higher-level selection/cleanup order owns those
|
||||
transitions. Attaching again after detach retains look(0,130,100); equipping
|
||||
again restores look(0,150,80). Always rebuilding a generic "attached camera"
|
||||
would erase this observable difference.
|
||||
|
||||
## Ordinary walking follow
|
||||
|
||||
Complete124→438BC0 uses the normal subpath439625..4398EF when special camera
|
||||
flag828 is false. The source adjustment complete84C defaults to10 and normal
|
||||
walking resets it to10 at438CC6 when its enclosing camera/gadget conditions
|
||||
permit; Grappler raw7 is not the special raw6 exception.
|
||||
|
||||
The effective points are:
|
||||
|
||||
```
|
||||
eye = root + fullEulerRotate(eyeX, eyeY − 2*adjustment, eyeZ)
|
||||
look = root + fullEulerRotate(lookX, lookY + 1.9*adjustment, lookZ)
|
||||
gain = (storedX, storedY + .2, storedZ)
|
||||
```
|
||||
|
||||
439652 and4396DA invoke game384→472980, the full logical Euler point
|
||||
transform, using the source negative Z/X/Y table rotation. Thus equipped normal
|
||||
eyeY is30 and lookY169 at zero rotation; attached eyeY380. Neither is a direct
|
||||
substitution into the port's existing ordinary hardcoded follow offsets.
|
||||
439658..439686 caches desired eye at complete804..810. Normal4397B1..4397F8
|
||||
multiplies each delta by its effective gain, obstacle gain and dt; there is no
|
||||
final interpolation-factor clamp in this path.
|
||||
|
||||
Flag828 can instead choose a different transformed/cached eye and uniform
|
||||
gains; flag851 selects fixed .2 smoothing independent of the normal branch.
|
||||
These are explicit excluded branches, not proven absent from every level.
|
||||
|
||||
## Ordinary airborne follow
|
||||
|
||||
Complete128→439900 captures OLD viewport eye at439E33.439E38..439E6B
|
||||
passes raw eye locals to complete120→43A5D0. This helper does **not** add120
|
||||
to Y:120 is a virtual-slot coordinate. At43A5EA it reads logical Euler, then
|
||||
43A5F0..43A67B uses pitch0, yaw=`AddAxis(logicalYaw, complete6D4)`, and logical
|
||||
roll. The helper applies the table rotation, reads root310 at43A6FB, and adds
|
||||
root XYZ. Complete6D4 is the source turning accumulator, not a camera-local Y
|
||||
offset. Negative yaw addition follows the previously recovered truncation/360
|
||||
seam from `RocketOrientation.AddAxis`.
|
||||
|
||||
439E81..439EAA transforms unadjusted look locals using game384 full Euler.
|
||||
For ordinary movement mode other than2,43A03C..43A06C uses **fixed**
|
||||
gains(1.2,2,1.2), multiplied by obstacle gain and dt. It never reads stored
|
||||
854..85C there. Attached air therefore uses eyeY400, with look150/80 on first
|
||||
attach or130/100 after detach/reattach. Body pitch affects the look but not air
|
||||
eye pitch; body roll affects both. Turn accumulator affects only air eye yaw.
|
||||
Movement mode2 has separate Bubble gains and flag851 still selects its special
|
||||
.2 branch. Do not claim these ordinary Grappler formulas cover those branches.
|
||||
|
||||
## Shared obstruction and old-eye orientation
|
||||
|
||||
Both paths call complete16C→43B820 after computing points. Its caller supplies
|
||||
look by value and desired eye by pointer; the two preliminary actor310 reads
|
||||
are not additional point offsets.47C210(false) traces look→eye with original
|
||||
static grid/order/filter semantics. On hit43B884..43B8F4 writes:
|
||||
|
||||
```
|
||||
desiredEye = look − .75*(look − hit) = .25*look + .75*hit
|
||||
obstacleGain = 1.5 # miss returns1
|
||||
newEye = oldEye + (desiredEye − oldEye) * gain * obstacleGain * dt
|
||||
aim = look − oldEye # deliberately NOT look − newEye
|
||||
```
|
||||
|
||||
Walking captures old eye in complete714/718/71C before this path and uses it
|
||||
at439830..439865. Air captures old eye in locals and uses it at43A09F..43A0CE.
|
||||
OMT vector `angles` IAT48D108 yields signed14-bit orientation; subsequent
|
||||
viewport delta arithmetic gives the new quantized pitch/yaw. Reusing the Rocket
|
||||
orientation helper is justified; using its gain2 obstacle callback instead of
|
||||
the Jimmy gain1.5 is not. See [camera-ray-predicate.md](../checkpoint/camera-ray-predicate.md)
|
||||
for the independently recovered obstruction query.
|
||||
|
||||
## Adapter recommendation and verification boundary
|
||||
|
||||
Keep a small mutable source-local camera state with the exact writers above.
|
||||
For bounded VR08, dispatch ground versus air with the stored movement-mode
|
||||
decision recovered in438A60, then use full source transforms and one source
|
||||
camera ray. Preserve shared viewport history and compute aim from old eye.
|
||||
Do not use support alone to pick a camera branch, reset look on each attach,
|
||||
apply stored gains to air, or post-correct with a second collision query.
|
||||
Resetting camera state at a reconstructed scene boundary must follow the actual
|
||||
PostLoad/default/control event; the persistent-state report is separate.
|
||||
|
||||
REA was used through the existing local launcher on a generated EXE copy.
|
||||
The first new helper request mistakenly supplied VA as a numeric file offset;
|
||||
the corrected file offset3A5D0 mapped to43A5D0 but Ghidra12.1.4 had no recognized
|
||||
procedure there. Both complete failures are retained in
|
||||
`artifacts/grappler-camera-live/rea-eye*/`. No pseudocode success is claimed and
|
||||
no unchanged failed request was repeated. Existing successful REA evidence for
|
||||
437740 is ev_d2502f41c45731b86d4365634fbc6f0d1b3b70d880fd5741275fd36f1d585aa4;
|
||||
47C210 is ev_ff5aab3bdc275e6626753743a3567a556f698209ad9f65689cf49a4b5f56107d.
|
||||
Guarded disassembly supplies the missing follow/eye entries.
|
||||
|
||||
Unresolved: runtime original-versus-port VR08 camera comparison; flag828/851
|
||||
transitions outside the bounded normal case; complete scene-entry shared-camera
|
||||
cache continuity. No new copied-original camera probe was run in this chunk.
|
||||
@@ -0,0 +1,132 @@
|
||||
# Grappler lifecycle and retained state
|
||||
|
||||
2026-11-03. Static source contract, EXE SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Preferred-base VAs map to raw file offset VA−400000 at the guarded code sites.
|
||||
Source guards/projection tests are recorded in grappler-camera-live/source.json
|
||||
and python.log. No original gameplay was executed for this investigation.
|
||||
|
||||
## State ownership and reset boundaries
|
||||
|
||||
Jimmy complete owns rope+B0C, cursor+B14, companion+A1C and sound handle+1E04.
|
||||
Raw selected gadget4F0588 and Grappler globals are process storage, not fields
|
||||
serialized into the TSK inventory. Retained Jimmy is reused by ordinary loads;
|
||||
its constructor must not be simulated on every scene entry.
|
||||
|
||||
| Storage | Fresh Jimmy constructor | Attach | Detach / selected cleanup |
|
||||
|---|---|---|---|
|
||||
|attached4F8210|422761→false|426C7F→true|429C28/428810→false|
|
||||
|anchor index4F82CC, first anchor XYZ4F8214..1C|422767..422782→zero|Current ray hit copied to indexed anchor|No clear|
|
||||
|first length4F82B4|422796→0|426C24 tests0;426C6B writes current length only on zero sentinel|**Preserved**|
|
||||
|current length4F82B8|42278C→0|426C1E stores distance−100|Preserved; reel/swing own later updates|
|
||||
|swingX/Z4F82BC/C0|4227A0/AA→0|426CE2/EC→0|429C7E..CA5 multiply each by float.96|
|
||||
|elapsed4F82C4|4227B4→0|426D2E→0|Preserved|
|
||||
|fast target4F82C8|No explicit constructor write; process zero-fill initially|426D4D→anchorY−rootY−200|Preserved|
|
||||
|complete864 action byte|Not renamed as generic control state|426C85→true|429C2E/428816→false|
|
||||
|loop34 handle complete1E04|4227CD→−1|Stop old, play new34, save handle|Stop if valid; store−1|
|
||||
|
||||
The complete EXE disassembly scan has only two direct writes to first lengthB4:
|
||||
constructor zero422796 and first-attach assignment426C6B. The inspected retained
|
||||
Init437890 and full PostLoad423610 route do not repeat that constructor reset;
|
||||
the global writes in equip/detach/cleanup are bounded above. This supports
|
||||
retaining B4 across ordinary retained-player loads and re-equips. It does not
|
||||
establish a disk save/load serialization contract or arbitrary indirect memory
|
||||
write absence. First attachment's length/600 scales owned rope Z only whenB4=0;
|
||||
recreating the port visual requires preserving/reconstructing that first scale
|
||||
as an implementation bridge, not rescaling it from each current length.
|
||||
|
||||
Constructor reset is tied to a newly constructed Jimmy, not just a new game
|
||||
screen. Current length and swing state also survive the listed cleanup paths,
|
||||
but attach always assigns/reset them. Session storage is appropriate for these
|
||||
globals; a scene-local active attachment/query reference still needs an explicit
|
||||
safe boundary in a modern adapter. Such teardown is not evidence that the
|
||||
original ordinary stage reset attachment.
|
||||
|
||||
## Equip, attach, detach and helper visibility
|
||||
|
||||
4297DD equip hides the companion via complete58(1), gameD0(0), game214(0)
|
||||
when present, writes camera locals and raw7. No attach/reset is implicit. The
|
||||
optional inventory/tutorial menu command9B is a separate branch.
|
||||
|
||||
426A70 attachment is reached only after429D00's enclosing aim/blocking gates.
|
||||
It stops prior +A3C audio, repeats its ray, stores length/anchor/first scale,
|
||||
sets attached/action, clears jump+7E8 and linked jump effect+6C0, plays one-shot
|
||||
31 and restarts loop34. It zeros swing scalars/time, preserves velocityXZ,
|
||||
writes velocityY100, sets fast target, and changes camera fields. The rope's
|
||||
non-null/resource-visible guard426D85..426D9D calls complete58(0) and records
|
||||
the visibility-related70 state. The exact owned-resource rendering is separate
|
||||
from the camera/lifecycle contract.
|
||||
|
||||
Held primary while attached reduces length by250*dt only while old length>250,
|
||||
ensuring loop34; the alternate branch stops that loop. Before raw7 dispatch,
|
||||
429D5D..429DBB maintains loop34 according to42A7A0 held-primary and attached.
|
||||
This prelude is not an unconditional loop: it stops a valid handle when the
|
||||
appropriate predicate fails. Fast reel950*dt and its target test are separate.
|
||||
Do not combine all sources into a forever-running equipped sound.
|
||||
|
||||
429C10 returns immediately if already unattached. Otherwise it clears attached
|
||||
and action, resets detached camera locals, damps residual swing.96, **sets body
|
||||
velocity XYZ0**, directly selects FALL, stops loop34 and marks−1, and hides rope
|
||||
via complete58(1). It does not supply launch velocity, reset first length, clear
|
||||
movement speed, rewrite jump/movement mode or erase pending impulse. Caller
|
||||
preparation may do some of those things independently.
|
||||
|
||||
Selected cleanup4287AC conditionally restores the companion if its+9E8 gate is
|
||||
zero: show58(0) only when visibility-related70 is nonzero, then gameD0(1) and
|
||||
game214(1). It calls detach204, ordinary camera170, clears attached/action again,
|
||||
hides cursor58(1), and sets raw−1 in common tail428832. The +9E8 guard prevents
|
||||
unconditional companion visibility restoration. Inactive detach is not an
|
||||
independent catch-all loop stop; valid source state keeps loop ownership aligned.
|
||||
The prior independent resource investigation owns exact helper retention/draw.
|
||||
|
||||
## SWING is protected from ordinary action requests
|
||||
|
||||
The controlled frame calls438A60 then429D00 before later primary426A70. A true
|
||||
429D00 return ends remaining426030 input only; normal Jimmy437940 still runs.
|
||||
An attached swing sets logical Euler pitch/roll0 while preserving yaw at429E4A..
|
||||
429E7C, then requests complete150(`SWING`) at429E84..429E8B before rope/body
|
||||
constraint work. Ordinary437940's movement/body publication must continue.
|
||||
|
||||
Complete150→43AFF0 first compares current action with the requested action and
|
||||
protected actions. Literal SWING4EF6D8 is checked at43B096..43B0B0; matching
|
||||
current SWING returns43B597 before RUN/STOP/LEFT/RIGHT conditional changes.
|
||||
Thus normal437940 requests do not overwrite SWING. Detach uses direct complete
|
||||
E0(`FALL`,1) and bypasses that conditional action guard. The air jump/FALL path
|
||||
in437F90 can directly request FALL only for jump modes3/4; attachment already
|
||||
clears jump mode0. A retained SWING render pose is justified while this contract
|
||||
holds; it must yield to direct scripted/hit/death action ownership rather than
|
||||
being a universal per-render override of every action.
|
||||
|
||||
## Control and transition events are different boundaries
|
||||
|
||||
Source [cutscene-preparation.md](../checkpoint/cutscene-preparation.md) recovers:
|
||||
|
||||
| Event | Proven operation affecting Grappler |
|
||||
|---|---|
|
||||
|CAM with NULL control|Jimmy438→42AE00→selected cleanup178, then410 speed/velocity preparation, orientation flatten, raw control clear|
|
||||
|Initial non-none MCA activation|410 first, orientation flatten, then438 selected cleanup and raw clear|
|
||||
|Later MCA shot|No repeated410/438/raw-clear preparation|
|
||||
|AI with NULL control|410 and raw clear; **no438 selected cleanup**|
|
||||
|Raw control owner changes alone|Controlled426030/437940 tail stops; no generic detach follows from that fact|
|
||||
|RETURN457FF7|Selected cleanup178 before return flags and staging|
|
||||
|Ordinary LOAD/practice stage43B5A0|No selected cleanup;148→429A00 only stops+A44, distinct from loop34|
|
||||
|Retained Init/PostLoad|No blanket first-length reset; specific scene/gadget/camera rules remain separate|
|
||||
|
||||
410→42AFC0 clears speed/velocity through43A750 and requests conditional STOP.
|
||||
When SWING is current,43AFF0 can preserve it; do not infer detach from STOP
|
||||
preparation alone. Menus pause or gate input under their existing phase rules.
|
||||
Debug noclip is a modern policy, with no source semantics. A chosen noclip/scene
|
||||
safety detach should be labeled as that adapter boundary and retain proven B4
|
||||
persistence. Debug force control likewise changes modern effective ownership;
|
||||
it must not erase already delivered authored selected-cleanup events.
|
||||
|
||||
## Remaining questions and claim boundary
|
||||
|
||||
The ordinary VR08 lifecycle is sufficiently specified for a bounded live
|
||||
adapter plus tests for first attach, held reel, jump release, high-contact
|
||||
detach, reattach, re-equip, CAM/MCA cleanup and RETURN. Save-file serialization
|
||||
of global first length is not recovered. Whole-original menu/control/render
|
||||
comparisons, malformed selected/attached/loop combinations and all other
|
||||
levels' special follow/action policies remain open. These are static facts and
|
||||
projection checks; managed compilation or VR08 smoke must be reported separately
|
||||
by the integrating primary, and Windows user testing remains runtime evidence.
|
||||
@@ -0,0 +1,91 @@
|
||||
# Live Grappler: bounded VR08
|
||||
|
||||
2026-11-04. Supersedes component-only status in grappler-query.md. Original
|
||||
EXE/DLL/assets remain authoritative and untouched. The playable orbit70cba65,
|
||||
lab69d0187 and parked collision35a2a66/0272f7b checkpoints remain preserved.
|
||||
All prior investigators returned ownership; primary integrated and verified.
|
||||
|
||||
## Coverage and implementation
|
||||
|
||||
| Contract | Original evidence | Current adapter / verification |
|
||||
|---|---|---|
|
||||
|Root/full-Euler first-hit ray, material/close gate|429D00 and enclosing426030;23 native aim cases|GrapplerRay/Geometry; actualVR08 and close-surface regression. Early input return still permits ordinary player update.|
|
||||
|Attach/reel/swing/detach scalars|426A70/429D00/429C10;30 native scalar +10 constraint cases|GrapplerGadget composes recovered components; no direct-pull replacement, reel clamp or launch impulse. Normal body and frame phases continue.|
|
||||
|Shared sphere/body/base contact|479D20→47B4B0,42A016,43AA40→42A660;41 new native cases|OriginalBodyPhysics retains mutable context; attached Move reuses it. Normal and attached wall callbacks both reach Grappler. Live actual-wall scalar/root fixture verifies high-contact detachment.|
|
||||
|Camera|438BC0/439900,437740, attach/equip/detach writers; guarded static/Python projection|GrapplerCamera dispatches by movement mode, uses distinct ground/air transforms/gains, obstruction gain and old-eye quantized aim. Managed checks and rendered replay; no original-camera runtime comparison.|
|
||||
|Rope/SWING/cursor|HIROPE/HISWING bindings, OMT shape-scale consumer,445580 final110 dimensions|Exact exported art, dedicated source-pivot morph; fixed first-length scale, pre-collision rope root, alpha cursor. Generic billboard remains modern renderer bridge.|
|
||||
|Selection/companion/control|427FF0→4287AC, CAM/MCA vs AI_NULL, RETURN457FF7|Normal selection and F1 grant; cleanup hides helpers/stops34/restores camera and eligible companion. Raw control loss alone does not detach. Actual intro and RETURN tests pass.|
|
||||
|Persistence|Ctor/first-attach-only B4 writes; source lifecycle in grappler-lifecycle.md|GrapplerMemory lives in Main across reconstructed scenes; helpers are scene-local. Retained scalars tested; not serialized into TSK.|
|
||||
|Debug policy|Modern tool boundary, not original recovery|F3 releases attachment/selection. R resets memory. GiveGrappler outsideVR08 retains practice selection but enables no unsupported live mechanics.|
|
||||
|
||||
State belongs to three scopes: process/session scalar memory (anchor, first/current
|
||||
length, reel target, swing), scene-local helper/controller state (equipped/attached,
|
||||
loop/cursor/pose), and LabSimulation body/shared viewport history. Cleanup releases
|
||||
attached motion, default camera, visuals and sound without erasing first scale.
|
||||
RETURN raises selected cleanup before the transition event. An ordinary modern
|
||||
scene teardown also releases scene-local resources before SceneAudio disposal;
|
||||
this is a modern safety boundary, **not** a claim that every original LOAD detaches.
|
||||
Retained scalar memory survives that boundary; scene-entry shared-eye continuity
|
||||
and arbitrary non-RETURN attached transitions remain unresolved.
|
||||
|
||||
On attach, clear jump word/effect only, set Vy100, preserve movement mode, hold,
|
||||
acceleration and pending impulse. Input runs before ordinary player apply on fresh
|
||||
entry and after it on retained entry. StepCamera precedes gadget input. SWING uses
|
||||
a separate source-pivot draw and preserves ordinary body publication. Collision
|
||||
may detach during attached movement; the source tail still updates swing/helper
|
||||
state using the unclipped constraint root. Surface aim is then recomputed; fire
|
||||
performs a fresh trace when unattached. No cached cursor-to-anchor substitution.
|
||||
|
||||
## Checks and captured evidence
|
||||
|
||||
-113 original-component observations total: prior72 scalar/aim/constraint/contact
|
||||
plus41 body/support/ray/full-contact cases. Native probe generation/log/reference
|
||||
hashes are retained; source execution uses copies under artifacts, never Original.
|
||||
-13 managed live groups (`tests/GamePort.GrapplerLiveTests`) cover fresh/retained
|
||||
input order, attachment/normal body, held reel/simultaneous fire+jump, detach/
|
||||
reattach/first-scale, strict60 impact, actual wall constraint collision, shared
|
||||
stale-contact replay/zero delta, camera consumers/transitions, ownership/intro,
|
||||
actual RETURN, noclip/reset/retained memory, helper art and close-surface gate.
|
||||
The actual-wall test explicitly positions Jimmy and sets rope/swing state;
|
||||
this is distinct from the unseeded input replay below.
|
||||
-40 Grappler Python checks: guarded original spans, camera projections, assets and
|
||||
saved native-body observations. The broader Python suite passed296 tests before
|
||||
adding the final source-presentation guard; its final total is297.
|
||||
-Existing managed suites,33-scene GPU/material audits and original hash check are
|
||||
driven by scripts/test.sh. Selected-source Patrol/Interaction projects needed
|
||||
explicit Grappler/heading dependencies; initial compile failures were fixed.
|
||||
-Headless llvmpipe1280×720 and native Linux GTX1070/private Xvfb1920×1080 replay
|
||||
pass all9 phases with enabled Vulkan validation, zero errors. SDL Left/Ctrl/Up/
|
||||
Shift/F3 events are received.120 extra ordinary ticks reuse received input;
|
||||
no root/velocity/rope scalar/timer is seeded. Capture stages include attach,
|
||||
original SWING/rope, detach, reattach, cutscene, noclip and reset. Images inspected.
|
||||
Logs `artifacts/grappler-live-{smoke,window}.log`; captures share those prefixes.
|
||||
-1920×1080 Player-page capture (`artifacts/grappler-debug-wide.ppm`) fits all32
|
||||
rows including Give/Select Grappler. Managed navigation/repeat/bounds checks pass.
|
||||
|
||||
Reproduce from GamePort with `source scripts/env.sh`, then:
|
||||
|
||||
```
|
||||
dotnet run --project tests/GamePort.GrapplerLiveTests
|
||||
dotnet run -- --scene artifacts/extracted/VR08/scene.json --level gam/VR08.gam \
|
||||
--smoke-grappler --headless --screenshot artifacts/grappler-check.ppm
|
||||
```
|
||||
|
||||
Native-window replay uses `--width 1920 --height 1080` without `--headless`,
|
||||
private Xvfb and SDL_AUDIODRIVER=dummy
|
||||
where no hardware output is available. Dummy audio verifies stream/lifecycle,
|
||||
not audible quality. Original whole-game VR08 and native Windows play remain
|
||||
unverified; cross-publishing is recorded separately below.
|
||||
|
||||
## Remaining work
|
||||
|
||||
Full scene-global body interleavings/dynamic pairs, other levels/material policies,
|
||||
special camera828/851/mode2, complete source renderer flags/lighting, arbitrary
|
||||
attached ordinary LOAD continuity and save serialization of globals remain open.
|
||||
These do not block the boundedVR08 implementation. Next gadget candidate is
|
||||
Scooter, whose support/wheel/contact contracts are explicitly unresolved in
|
||||
scooter.md; recover them before implementing its vehicle behavior. Preserve the
|
||||
parked general collision work and avoid expanding Grappler to other levels until
|
||||
those shared contracts and actual original comparisons support it.
|
||||
|
||||
Package/provenance results are appended after final local packaging.
|
||||
@@ -0,0 +1,50 @@
|
||||
# Grappler source resources and helper presentation
|
||||
|
||||
2026-11-04. Exporter: `tools/extractors/grappler_resources.py`; generated manifest
|
||||
`artifacts/extracted/grappler/grappler.json`. Six source-file SHA256 values are
|
||||
checked before export; originals remain untouched. Export includes rope01.ASE,
|
||||
jimswing.ASE, jimstop topology, jimycarl pixels and RetainedSprites canvas8.
|
||||
|
||||
## Recovered bindings and consumers
|
||||
|
||||
EXE VAs map to file offset VA−400000 at these sites. HIROPE points to rope01.ASE;
|
||||
HISWING→jimswing.ASE and SWING are bound422BCC..422BDA. Source rope has6 indexed
|
||||
vertices/6 triangles, longitudinal Z0..600.9758 after the established ASE axis
|
||||
conversion. Init41F0FA..41F12E applies roll180; attached429D00 sets pitch/yaw
|
||||
from the quantized constraint offset and resets roll0. Render position is the
|
||||
unclipped constraint desired root+Y116, even when collision clips Jimmy elsewhere.
|
||||
First attachment426C63 mutates shape geometry through virtual34 using
|
||||
(firstLength/600) longitudinal scale. Original OMT2.dll10005970 (file5970) is
|
||||
OMedia3DShape::scale, not an actor transform or radius setter. Reeling does not
|
||||
repeat that geometry mutation. The modern renderer equivalently applies the
|
||||
retained first scale to fresh base vertices each render; it never accumulates it.
|
||||
|
||||
SWING has426 indexed vertices,814 faces, source samples0/480. Its absent UVs use
|
||||
jimstop's source topology and exact jimycarl atlas.43AFF0 protects SWING from
|
||||
ordinary conditional RUN/STOP requests; body integration is still active. The
|
||||
port draws a dedicated source-pivot morph and hides the ordinary standing draw.
|
||||
|
||||
Cursor4453B0 inherits SpriteSize150, but its init445580 (file45580), invoked by
|
||||
virtual40C, converts final signed words complete5E8/5EA=110 to world dimensions
|
||||
completeAC/B0. Thus the visible cursor is110×110.4645F0 sets alpha blend6/7 and
|
||||
center alignment3/3; canvas8 is64×64, decoded SHA256
|
||||
8d31014cb9b9661ebed902c864bf740f562460e74da3f6b86ed3d2be4d10f0ec.
|
||||
Flags248 and source constructor metadata remain in the manifest.
|
||||
|
||||
## REA and verification boundary
|
||||
|
||||
REA on generated copies retained complete replies/snapshots in
|
||||
`artifacts/grappler-assets-live/rea-{shape,sprite,bind}/`. Shape consumer Evidence
|
||||
`ev_e337ad879cea5877eb463324d48d15f860ceacf80c8225e66e9f35bc4b8ed660`;
|
||||
sprite replies include `ev_9af340590afc1e0c64a249af250a520b2f09eba484e95d097f134b3254b67a8d`,
|
||||
`ev_ab13438ec345f10472d10965048c34d31654e6d9303d729df98b65aa92d37a1e`,
|
||||
`ev_69c4b496b5da7846245164028f0cb994222b0f136d24bb5fa3da7fdf236b228d`.
|
||||
464430 was not recognized; failure retained, no decompilation success claimed.
|
||||
Disassembly and guarded byte spans supplement those results.
|
||||
|
||||
Six Python checks verify exact source samples/pixels, source binding/consumer
|
||||
spans, final cursor sizing and bounded output. Managed live tests verify constant
|
||||
first-scale rendering, helper cleanup and110-unit cursor dimensions. Native
|
||||
Linux VR08 captures show rope/SWING/cursor. Generic sprite billboarding uses the
|
||||
existing modern camera-facing bridge; full original flags/renderer behavior,
|
||||
lighting and original-versus-port visual comparison remain unresolved.
|
||||
Reference in new issue
Block a user