Files
Neutron/docs/reviews/jn-engine-gameplay.md
T

5.2 KiB

jn-engine gameplay review

2026-11-03. Read-only source/document comparison. J: denotes ../../../jn-engine-master/; N: denotes this GamePort repository. No original execution, network, builds or friend-repository changes. Confidence is high for what these source files implement; original-behavior claims below remain candidates until checked against our guarded binary evidence.

Verdict

Useful chiefly as an address/naming index, decompilation supplement and campaign research map. Do not replace our movement or recovered gadgets with its C runtime. The ledger really contains 208 rows, all spec, with 181 Medium and 27 Low confidence, and every named report exists (J:docs/decomp_ledger.csv). That is specification coverage, not 208 faithfully implemented classes. Three resolver rows are deliberately inert, including the unported rock-placement controller (J:src/game/behaviors/behavior_resolver_inert.c:1-19).

Concrete comparisons

  • Locomotion is intentionally different. Its live player defers parsed acceleration/deceleration and uses instant tank movement, jump650 and turn2.8 radians/s (J:src/game/behaviors/behavior_player.c:14-27,113-155). World gravity is1600, versus our recovered800 magnitude (J:src/engine/physics.h:6-8). These are explicit native tunings, not evidence against our controller. Collision is axis-separated AABB resolution plus a mesh adapter (J:src/engine/physics.c:24-50,87-134).

  • Gadget names/modes cannot be transplanted. Its eight-gadget list includes Jetpack and excludes Baseball (J:src/game/behaviors/behavior_gadgets.c:71-80); our recovered eight tiles include Baseball, with Jetpack outside that tile set (N:docs/gameplay/gadget-controls.md:67-79). Native Shrink Ray writes mode6 (J:src/game/behaviors/behavior_gadgets.c:180-182), whereas our item6/raw6 is Baseball (N:docs/gameplay/baseball-implementation.md:11-15). Its own AMI table sends mode6 toVR07, and its header admits gadget-to-AMI mapping was unrecovered (J:src/game/gadget_menu.c:52-61; gadget_menu.h:25-30).

  • Our recent slices are substantially deeper. Friend Invisible hides Jimmy immediately on equip and calls the mechanic native design (J:src/game/behaviors/behavior_gadgets.c:31-37,175-178); our recovered activation has recharge7, duration7, cost2, alpha.7 and a separate AI eligibility flag (N:docs/gameplay/invisible.md:64-91). Friend Bubble recovers visual phases but explicitly invents follow placement; it has no corresponding mode2 body/input implementation (J:src/game/behaviors/behavior_gadgets.c:286-325,467-479; compare N:docs/gameplay/bubble-implementation.md:11-18,37-43). Its Baseball is a forward projectile at800 with2.5s lifetime (J:src/game/behaviors/behavior_player.c:139-155); ours implements source aim/release, twenty retained slots and speed1800 without inventedTTL (N:docs/gameplay/baseball-implementation.md:11-21).

  • Rocket/Grappler/Scooter are prototypes, not shortcuts through recovery. Rocket selection force-boards the nearest3ROC within6000 (J:src/game/behaviors/behavior_gadgets.c:154-160). Grappler chooses the nearest hook and directly translates Jimmy with tuned reach2200/pull1500/arrival120 (same:348-350,387-399,481-490). Scooter has tuned movement, no wheel children, and mounts directly on selection (J:src/game/behaviors/behavior_scooter.c:25-30, 48-55,75-77,155-161). Our recovered Scooter instead separates equip from later interaction mount and requires four constructed wheel actors (N:docs/gameplay/scooter.md:50-75). Reuse their asset/class leads and investigate Jimmy429D00/426A70; do not adopt these replacement mechanics.

Highest-value next reuse

Animation: J:docs/decomp/C3DAnimated.md:221-232 identifies repeated last-frame completion, including paused one-shots, no completion latch, and selection timing reset rules. Runtime implements these at J:src/game/animated_dispatch.c:210-258; player HIT/SPLAT/FENCE/LADDER hooks switch toSTOP (player_anim.c:137-142). This is useful beyond our currently limited pose enum (N:src/GamePort/Game/LabSimulation.cs:8). Preserve its own linked-blocked boundary: nativeASE metadata does not prove originalA3dm import/timing or faithful FENCE entry (J:docs/decomp/C3DAnimated.md:183-193,334-358). Mutation-sensitive native oracles establish implementation wiring, not execution of the original.

Campaign/state: use J:src/game/behaviors/behavior_ai_trigger.c:140-193 as a compact SCENE/KITTY transition checklist. Its explicit deferrals include AIState, AISpeed, animation selection and state-gated object dispatch (same:37-40), plus reward/menu/Goddard/energy effects (same:140-145,192-193). Its arm-on-exit trigger policy (same:13-17) requires independent validation.

Trust corrections: survey says +86C timer naming was corrected, but J:docs/decomp/C3DPlayer.md:70 still says jump_gate_timer. Jimmy's field-map pointer bases are mixed (C3DJimmy.md:18,24-26,35); normalize complete versus game-interface+C0 before reusing offsets. Target6 also forces generic thiscall signatures and warns about unaff_retaddr/dt artifacts (J:docs/decomp/evidence/c3djimmy_target6.md:19-32). Treat its function definitions as useful recovery leads, not ABI proof.