# 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.