A native Windows engine rewrite of Kingdom Hearts II Final Mix in Rust, using Bevy. It reads your own Steam installation at runtime. No game assets are distributed.
Status: very early. All worlds playable and explorable and works as a sandbox.
DISCLAIMER: If you haven't noticed, this is entirely vibecoded using Claude AI. If you do not like it then you can simply move on with your life.
- Sora walks, runs, jumps, lands and attacks with his own animations and Kingdom Key, in a Twilight Town room.
- Movement numbers are read from Sora's installed parameter records. Some values, such as gravity and body size, are still test-room choices, so the room is not an exact copy of the game.
- Enemies, damage, sound, saves and the rest of the campaign are not implemented.
For scope and progress, see the fidelity contract, milestones and unknowns.
| Measure | Accepted / tracked | Percentage |
|---|---|---|
| Complete functions decompiled and checked | 0 / 4 (inventory incomplete) | Unmeasured |
| Required behavior scenarios verified 1:1 | 0 / 0 (inventory incomplete) | Unmeasured |
| Final roadmap gates accepted | 0 / 32 | 0.00% |
Whole-game 1:1 coverage is unmeasured until the complete function and behavior inventories are qualified. Partial work, synthetic tests and successful builds do not count as 1:1 passes. Gate percentage measures accepted gates, not game size or implementation effort.
Progress details · Coverage ledger · Automatic updates
You need Windows, your own legally obtained Steam copy of Kingdom Hearts HD 1.5 + 2.5 ReMIX, and the pinned Rust toolchain. See CONTRIBUTING.md.
cargo build --release -p windows_shell --locked
& '.\target\release\KH2RW Launcher.exe'The first launch opens a short quick start guide (F1 in the launcher brings it back). The launcher then finds your Steam install (or lets you browse to it), checks that it is a supported build, makes the test configs from your installed files, and offers the title screen and test room. Each launch re-checks your files.
Command-line runs also work:
cargo run -p windows_shell --bin kh2fm --locked -- room '<selected-install-root>' '<private-directory>/source-manifest.json' '<private-directory>/test-room.json'title and talk take the same arguments with their own configuration. The configuration format is in T056.
| Action | Keyboard | Controller |
|---|---|---|
| Move | WASD | Left stick |
| Walk | Hold Left Alt | Tilt the stick slightly |
| Camera | Mouse | Right stick |
| Attack | Enter, left click | A |
| Jump | Space | B |
| Guard | Right Shift, right click | X |
| Talk | F | Y |
| Shortcuts | Hold Left Shift | LB |
| Skateboard (needs the Skate 3 ISO) | J | |
| Collision overlay | F1 | |
| Leave the test | Esc |
cargo build --workspace --locked
cargo test --workspace --locked
cargo run -p windows_shell --locked -- --frames 180The full list of checks, and the rules for contributing, are in CONTRIBUTING.md. Developer tools for reading the installed game are in docs/developer-tools.md.
Source manifests, package records, captures and saves stay outside this repository, in %LOCALAPPDATA%\KH2FinalRewrite\. See ARCHITECTURE.md for the layout.
- Project owner: TheGlurbus (@BurBaGlurbus), who maintains the project.
- Code: written with Claude, an AI coding assistant, under the owner's direction.
- Format research: OpenKH (Apache-2.0) documents the game's file formats, and the project's reader follows it. The attribution list is in NOTICE.
- Other third-party code: Bevy, the
imageandpngcrates, zlib-rs, Microsoft DirectXTex (MIT), the .NET runtime (MIT), andbevy_mikktspace(Morten Mikkelsen). Release licences are in docs/release/. - Skate 3 crates (
crates/skate3/, GPL-3.0): adapted from SK8-ENGINE/skate-3-rust-engine. See its README. - Games: Kingdom Hearts is by Square Enix and Disney. This project is not affiliated with or endorsed by either company.
Apache-2.0, see LICENSE. Third-party licences are listed in NOTICE.
0 comments
log in to comment.