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

87 lines
5.2 KiB
Markdown

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