Online co-op mod for Kingdom Hearts II Final Mix (PC). The goal: each player runs their own game, sees the others in the same room, fights the same enemies and travels the story together — then plays as other characters. Today the mod hooks the game in-process and drives a party member's movement and animation; online play is not working yet.

Friend entity control (M3 — in progress)

• Press F5 in-game to take control of Donald (Friend1)
• Left stick moves Donald with proportional walk/run speed
• Camera follows Donald, right stick orbits
• Idle/walk/run animations match stick input (loops correctly at any distance from Sora)
• Sora frozen in place while controlling Donald
• Facing persists when stick is released

Networking layer (M0-M2 — complete)

• Binary codec for all domain types with little-endian framing
• Host-authoritative session server: version gating, slot assignment, snapshot broadcast
• ENet transport with heartbeat, 3-client integration tested
• Server-side fake physics for protocol testing without KH2

Runtime bridge (M1-M2 — complete)

• Attaches to live KH2 via ReadProcessMemory/WriteProcessMemory
• Entity discovery, room/actor/HP state reads, camera retargeting
• Shared-memory IPC (InputMailbox) between runtime and inject DLL

Planned model (docs/ONLINE_COOP_PLAN.md): every player is the native player character on their own machine and streams it; other players appear as puppets in the friend slots; the host's game owns enemies, rooms and story state. Public Realm and PvP (docs/ARCHITECTURE_MODES.md) are parked until co-op is playable.

                    ┌──────────────────┐
                    │   KH2 Process    │
                    │  ┌────────────┐  │     shared memory
                    │  │ inject DLL │◄─┼──── (InputMailbox) ◄── runtime process
                    │  └────────────┘  │                         │
                    │   hooks entity   │                         │ ENet
                    │   update loop    │                    ┌────▼────┐
                    └──────────────────┘                    │ server  │
                                                           └─────────┘

# Build everything
cmake -B build -S . -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
cmake --build build --config Release

# Run E2E test (no KH2 needed)
.\build\Release\kh2coop_fake_sim.exe

# Build just the inject DLL
cmake --build build --target kh2coop_inject --config Release

# Launch KH2 with the inject DLL loaded (no Cheat Engine)
.\build\tools\kh2ctl\Release\kh2ctl.exe launch

# Kill rig instances, rebuild the DLL, relaunch + inject
.\build\tools\kh2ctl\Release\kh2ctl.exe restart

See docs/DEVELOPMENT_WORKFLOW.md for the full inject/test loop.