Assess supplied jn-engine research and capture evidence
This commit is contained in:
1 parent
c0acf58d9c
commit
c6eb1861cd
8 files changed
+347
-1
No files matched your search
@@ -0,0 +1,86 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user