Files
Neutron/docs/gameplay/shrink-targets.md
T

12 KiB

Original 3SOL shrink targets

Status: recovered static binary/asset contract for a bounded first shrink interaction. Original runtime verification, full soldier AI, and exact collision integration remain open. Originals were read only; REA inspected generated hashed copies, never executed originals. Run python3 tools/binary/shrink_targets.py ../Original to produce the guarded contract, including PE-mapped file offsets for every address below. Saved output: artifacts/shrink-targets/source-contract.json. Addresses in this note are preferred-base VAs.

Evidence ledger

REA results, complete evidence, snapshots, and closed-session records are retained under artifacts/shrink-targets/. REA observations are static analysis, not runtime traces.

Question REA Evidence ID Saved directory
Shared Yokian construction ev_19d3441021faa1f39087a8e65e3b04df57315de2ee53f75b2e70fce2dc8a432d rea-soldier/
Shared Yokian update ev_c7d9d0bd6ea80f021689545e79baca422ca5b526d69c89d7ccf54c4ea2142a18 rea-soldier/
Actual soldier construction ev_64b0152bae4f3a51a80c70f6470212b5c5cb9036e449d5eefe6129b35ace70c2 rea-soldier-bindings/
Soldier model/texture loading ev_4e46100718fc9d13d99409941d2494de216d281317a04fd9e56ad33e1aa3e6ec rea-soldier-bindings/
Generic load caller ev_efdc2d429180a0cd692326a261bc274ac5cb0daf45ab167c0627a858acabf041 rea-soldier-bindings/
Engine sequence selection ev_67aff8ee9529fa39014ae438e22e3dc52ecd2ce71d0886974d0682d6eea58f8b rea-sequence/
Engine endpoint/loop handling ev_e0d4f2ee9131d62ea289ea1aeb0f24b7de4a2bd696149309e9dfb2e3d14614df rea-loop/
Dynamic mode setter ev_8286c3d9b13f47f1e6fbf211d85636b54fb5ccb7cc7e55dd1e0f0366a7170b84 rea-mode-local-ipc/
AIState property registration ev_aa47a422ce39fc5bf5bbca319fe3c37e27526299abeb9f6cdb9d065d46de9f50 rea-mode-local-ipc/
Generic load/reset state ev_c448bb4062e760eb4bf3b09d39e630b130a8eafd377a27625a25b69ab7679a27 rea-mode-local-ipc/

The first mode-closure attempt (rea-mode/00.json) failed because the sandbox blocked Ghidra's local Unix-socket bind. The successful invocation above used local IPC permission; no provider/client configuration was changed. Its complete Evidence and close/snapshot records are retained. The failed call is not used as evidence for source behavior.

Neutron.exe SHA-256: f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8. OMT2.dll SHA-256: 3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943. The helper guards eight bounded code ranges, decisive byte sites, vtable targets, resource strings, and all three ASE hashes; it fails on an unexpected identity.

Class ownership and initialization — recovered

44A730 constructs shared C3DYokian, not the final soldier. Actual soldier constructor 44BEE0..44C028 calls it at 44BF32, then registers FourCC 3SOL at 44BFF5. Soldier complete-object vtable is 4C1E64, game-interface vtable 4C19C4 at complete object +C0, and embedded morph vtable 4C1E14 at +90. The generic model loader 40E270 dispatches complete slot 10C at 40E331, reaching soldier loader 44C0B0..44C1BB. Derived update 44C1C0 calls shared Yokian update 44AA00 at 44C1C9.

Complete slot / callsite Recovered binding
D8 / 40D4A0 Register model animation definition
E0 / 40DD90 Select named action; chooses HI/LO family
E4 / 40DA30 Select underlying sequence and copy loop flag
10C / 44C0B0 Soldier model load

At 44C19D the soldier pushes float 90 into game-interface slot 110 (471240, authored radius setter; live setter slot 264). At 44C1AC it pushes float 1 into game-interface slot 100 (4711E0, authored factor; live setter slot 254). Live read slots 260/250 reach 471B30/471AF0. These are soldier body defaults; they do not establish the full collision solver.

Model, texture, and authored shrink geometry — recovered

Registration site Action Original ASE
44C0C3/44C0C8 HIWALK ASE/soldwalk.ASE
44C0DC/44C0E1 HISHRINK ASE/soldshrink.ASE
44C0F0/44C0F5 HITALK ASE/soldatak.ASE
44C104/44C109 HISTOP ASE/soldatak.ASE

The loader compares scene FourCC against VR01..VR08 at 44C121/44C128. For those scenes both texture indices 0 and 1 use vryoksoldier.png (44C133/44C144, string 4F1950). Supplied filename is png/VRyoksoldier.png; portable lookup must ignore case. Other scenes bind index 0 to png/yoksold.png (44C14F) and index 1 to png/yoksoldtalk.png (44C160). Loader selects WALK with second argument 1 at 44C184.

All three ASE clips have 190 vertices and 377 faces. soldwalk and soldshrink have five samples at ticks 0,960,1920,2880,3840 (5 fps, 960 ticks/frame); soldatak has two samples (10 fps, 480 ticks/frame). In existing ASE→OMT coordinates, shrinking sample Y bounds are:

Tick Minimum Y Maximum Y Height
0 -55.6508 260.1789 315.8297
960 -19.5291 208.5813 228.1104
1920 -28.4904 156.9837 185.4741
2880 -4.0918 105.3861 109.4779
3840 -1.3301 53.7885 55.1186

This is actual morph deformation. A uniform quarter-scale soldier would be an unsupported replacement. No extra uniform render scale was established in the inspected source. The visual can retain original vertex units and authored root.

Shrink, animation ownership, and expiry — recovered

Jimmy callback 42AC10 (investigated separately in shrink-ray.md) receives an enemy game interface and subtracts C0 to obtain the complete object. It selects SHRINK with argument 0 at 42AC33, selects mode 5 at 42AC50, writes timer complete 974 = 30 at 42AC68, and writes flag complete 970 = true at 42AC8A. The shared constructor initializes that flag false at 44A905 and timer zero at 44A7EA. Game-interface-relative offsets are timer 8B4 and flag 8B0; authored/reset mode is interface 87C, complete 93C.

Mode setter and restoration ownership — closure

Soldier complete vtable 4C1E64 slot 124 points to generic enemy setter 4089B0. At 4089E5..4089FE it copies current complete 6C8 into previous 6CC, then stores the requested mode in 6C8. Requested mode 5 takes jump table entry 408BA8 directly to the return at 408B8E; there is no further mode-5 callback or copy into 93C. Thus SHRINK selection does not snapshot the dynamic prior mode into the expiry field.

Interface 87C is registered as the GAM AIState property at 407F67..407F77 (name string 4ECA90). Shared Yokian construction initializes both complete 6C8 and 93C to 2 at 44A7D3/44A7F7/44A7FD. Generic load/reset 409480, at 409503..40951E, copies interface 608 back to 87C and passes it to complete slot 124; the separate initialization path 409460 copies 87C into 608. The expiry body reads 87C, not previous dynamic mode 6CC. For the three authored VR04 soldiers this restores GAM AIState 2. A port which snapshots its dynamic current AI state when shrinking would diverge once AI begins changing modes; preserve a separate authored/reset AIState field. Its value is 2 by constructor default, rather than an uninitialized zero.

Named selector 40DD90 forwards the caller's second argument through slot E4 at 40DF4C..40DF5E. Wrapper 40DA30 calls embedded engine sequence selection at 40DA61, then explicitly writes the argument byte to complete AD at 40DA64. Since the embedded animation starts at 90, this is engine animation offset 1D. Engine find_next_frame (OMT2.dll:10021000) reads +1D at 10021079: false holds the current endpoint (100210B4), true wraps to first frame (10021080). Therefore source SHRINK(...,0) does not loop; source WALK(...,1) does loop.

The engine sequence-selection boolean also controls restart: 100209F0, especially 10020A3A..10020A78, restarts at first frame when true; when false and an old frame exists it walks old/new lists to preserve the frame ordinal. Thus changing WALK→SHRINK need not begin at shrink frame 0. Both have five samples. Exact within-frame clock preservation remains open; any time-zero transition in the port is an explicit approximation until closed.

Shared update 44AA00 decrements timer only when it is strictly positive (44AE5E..44AE6F), subtracting delta at 44AE75..44AE7F. It expires only when the resulting value is strictly negative (44AE85..44AE90). Exact zero does not expire in this body and is skipped next tick: preserve/document this source edge case instead of silently substituting <= 0.

Expiry zeros timer (44AE96), clears flag (44AE9C), clears interface 88C, reads authored/reset mode 87C (44AEA8), invokes complete mode slot 124 (44AEBD), and requests WALK with argument 1 (44AEC6). String 4ECA54 is WALK, not STOP. It restores interface 604 speed 200 (44AED3). While shrunk the inspected branch can move current mode 0 to mode 5, set interface-related value 1500, and speed 400 (44AE42..44AE54). Full AI meaning of those transitions is not closed here.

Calls 43F870(40,15) while shrunk and (140,50) on expiry operate on owned effect interface 8EC. They are effect sizes, not soldier body radius. No body-radius setter was found in this bounded shrink/expiry branch; that negative observation does not prove no other mode/base update changes physics.

First real targets: VR04 — original level data

gam/VR04.gam contains three 3SOL actors; all set AIState=2, CanMove=1, and HasCollision=1. Values below come directly from the bounded GAM parser.

GAM offset ObjectTag Position X,Y,Z PatrolPoint VisibleRange / FOV
4431 yoke1 -2463.1035,6327.9810,-7001.6870 dyok1 1000 / 259
582C C3DYOKIANSOLDIER 1677.5118,6422.5869,-4131.2129 eyok1 2500 / 259
67C5 yoke2 -529.4881,6378.4834,1319.0276 fyok1 1000 / 359

These are authored actors high in the scene, not entrance test dummies. A bounded interaction test can move the player near one as an explicit test fixture; it must not relocate original actors or claim their AI has been reconstructed.

Implementation boundary and unresolved work

At investigation start the runtime's SceneActorVisuals supported Carl, Goddard, and trophy families; it did not render 3SOL. MorphAnimation.Sample looped all clips. The supported next chunk is to export these real soldier clips/textures, render authored actors, support a nonlooping last-frame hold, and apply the recovered SHRINK/timer/WALK transition. Parent owns runtime work; this report does not assert those changes have shipped or run.

Existing OriginalScenePhysics can provide provisional radius-90/factor-1 settling for that bounded interaction. Reusing it is an implementation choice, not proof of original soldier physics. The following remain explicitly open:

  • Full soldier patrol, targeting, attack, damage, death, shadow/effect and sound updates.
  • Exact collision/support/root defaults and all dynamic radius changes through base/AI modes.
  • Other script/load/reset callers that can modify authored AIState independently of dynamic mode.
  • Exact sequence-switch subframe timing and special empty/mismatched sequence cases.
  • Non-VR texture-index animation switching and low-detail action availability.
  • Original runtime comparison of shrink geometry, 30-second restoration, targeting, and actor placement; native Windows gameplay verification remains required.

Regression checks validate original identities/dispatch, clip topology and shrink geometry, authored VR04 actors, and a bounded timer control-flow projection. They do not execute original code or establish original runtime equivalence.