Files
Neutron/docs/gameplay/grappler-resources.md

51 lines
3.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.