MatyMeatBoy/ReKHCoM

PC and browser port of Kingdom Hearts: Chain of Memories (Game Boy Advance), built on top of the matching decompilation by Pheenoh/khcom.

The decompiled game runs as a real Windows program, with its own renderer, audio and launcher, with widescreen and ultrawide support at the cartridge's original speed.

⬇ Download ReKHCoM v1.9 for Windows  ·  ▶ Play in your browser · Alpha 3  ·  Changelog  ·  Previous version tags

Works with the European, US and Japanese cartridges (your own dump; no ROM is included), in all five European languages, English (US) and Japanese.

Development versions are tracked in Git tags. Only stable versions appear as public releases. The current Windows stable is v1.9. Android and browser builds are alpha.

• Cleaner Riku cinematics. The opening keeps one shaded circle; scenery fills added borders using native tiles, with the original picture preserved.
• Safer save handling. Riku's unlock setting survives relaunches. His save slots appear when the cheat is enabled or Sora's story has been completed. Existing saves stay intact when the option is switched off.
• More display choices. x4 remains the default; 4:3 and the original GBA 3:2 aspect ratios can also use the numbered zoom levels.
• Lower rendering cost. Reused buffers and tile-row processing reduce CPU work, especially at the widest zooms.
• Optional return-stock control. Under Experimental, off by default: hold V or the right stick for half a second to return Sora's stocked cards to his hand.
• Android and browser alpha updates. Touch controls, local ROM/save file selection and browser resizing improvements. Android currently uses ARMv7; some 64-bit-only devices are not supported. Native Linux/Steam Deck and RG34XX packages are still in development.

The gameplay, menu, language and launcher screenshots below were captured from v1.8.3. The unchanged new-game selection screens remain reference images.

• 16:9 and ultrawide without stretching. Fields and battles show more of the world on any window shape, 16:10 to 32:9; the menus that stay GBA-sized get margins drawn from the screen's own art (bars, boxes, panels, stipple, checkerboards) on the picture's exact pixel grid at any scale. An Aspect ratio option keeps the picture at 16:9 or 21:9 on wider monitors.
• Original pace, smoother sound. Play at the cartridge's original speed, with optional audio smoothing and native movie playback.
• Launcher. Installs and checks your dump (SHA-1), picks the version, language, graphics, sound, controls and saves; imports GBA saves.
• Two ways to play. New Game asks for the version: the original, exactly as on the cartridge, or Re:Chain of Memories, with PS2-inspired difficulty levels, HD text and one-button dodge and stock.
• HD text and smooth audio as optional enhancements.

The view expands to 21:9 and 32:9 screens: the world gets wider, the HUD stays in the corners and the menus carry their own art out to the edges.

Every new game starts by asking which version to play. Original is the Game Boy Advance game exactly as on the cartridge. Re:Chain of Memories brings improvements from the PS2 remake: a choice of difficulty, faster dialogue, HD text and one-button dodge and stock. Each save remembers its version, and everything can be changed later with START + SELECT.

In Fill height mode the movies are cropped to the video, without their letterbox, and scaled up at their own proportions. With HD text on, the subtitles use a crisp font at the window's resolution.

English (US)	Français	Deutsch
Español	Italiano	日本語

Use your own cartridge dump with the launcher or the browser player:

Each region uses its own save file; the launcher picks the matching version.

• The 269 decompiled C units are compiled for 32-bit x86, so pointers keep their GBA size.
• The GBA address space (work RAM, I/O, palette, VRAM, OAM, ROM, SRAM) lives at its original addresses inside the executable image; register writes and ROM pointers work unchanged.
• Asset data is read straight from your ROM: 61k data symbols are pinned to their ROM addresses, and the few ROM tables that point at code are patched at start-up.
• port/ holds the platform layer: software PPU (all modes, affine, windows, blending, mosaic, HBlank effects), m4a sequencer/mixer in C, PSG emulation, BIOS, DMA, input, settings and the wide-view renderer.

Open ReKHCoM Web · Alpha 2, select your ROM and press Play. Your ROM stays on your device. The web alpha supports keyboard, gamepad and centered touch controls, optional HD text with the PC fonts, and normal save import and export. The website starts in English and also offers Spanish; game language is selected separately. Fullscreen and embedded views readjust automatically. Export a backup before clearing browser data.

Development version tags.

1. Download the stable v1.9 ZIP and extract ReKHCoM-v1.9-windows-x86.zip into a writable folder.
2. Run ReKHCoM.exe and install your cartridge dump with Install ROM... (or drag the file onto the window). The dump is checked by SHA-1 and copied to roms/.
3. Press Play. The launcher starts khcom_eu.exe, khcom_us.exe or khcom_jp.exe for the version you chose.

The launcher also sets the European game's language, shows each version's save (open its folder, or back it up to backups/ with a date stamp), and edits the graphics, sound, enhancement and control settings shared with the game.

The ZIP includes SDL3; you do not need to install it separately. The executables are 32-bit x86 and have been tested locally on Windows only.

Settings (kh_com.ini), your cartridge saves (kh_com.sav, kh_com_us.sav, kh_com_jp.sav), and the diagnostic log (kh_com.log) are stored next to the executables. Back up your saves before trying new builds. Save states are specific to the build that created them.

• Some HD text can overlap the Deck View submenu; that separate issue is still open.
• Movie transitions during events and the ending still need verification.
• Neither Sora's story nor Reverse/Rebirth has a verified full playthrough.
• Some rendering, audio streaming, and widescreen scenes still need verification.
• Linux and macOS builds are not available.

Requirements: Python 3 with PyYAML, llvm-mingw, SDL3 mingw devel and ninja. By default the tools are looked up in ../toolchain/.

git clone https://github.com/MatyMeatBoy/ReKHCoM.git
cd ReKHCoM
python -m pip install pyyaml
# Copy your dumps to roms/B8CP.gba, roms/B8CE.gba and/or roms/B8CJ.gba first.
python port/configure_pc.py              # European game + launcher, build/pc; --debug for a console build
python port/configure_pc.py --version us # USA game, build/pc-us
python port/configure_pc.py --version jp # Japanese game, build/pc-jp
ninja -f build/pc/build.ninja
build/pc/ReKHCoM.exe                     # launcher (decompui); or run a khcom.exe directly

The launcher, ReKHCoM.exe (source in port/decompui, Dear ImGui), installs your dumps after checking their SHA-1, edits the game's settings and enhancements and starts the executable built for the chosen version.

Use --toolchain PATH --sdl PATH when your dependencies are outside ../toolchain/. The SDL package must include i686-w64-mingw32/. Build from the repository root. Asset glue and text are generated locally from your dump during the first configure step.

To make a distributable ZIP without ROMs, saves or local settings:

python port/tools/package_release.py --version v1.7.1 --sdl ../toolchain/SDL3-3.4.18

These are the defaults; every action takes two keys and a gamepad button, edited on the launcher's Controls page (or kb_* / pad_* in kh_com.ini). The one-button stock and dodge roll can be turned off in the options; their gamepad buttons then act as A and B.

F11 or Alt+Enter toggles fullscreen.

F1, Esc, or Start + Select (keyboard or controller, as bound) opens the options overlay anywhere; at the title screen Select alone opens it. F5 saves a state, F9 loads a state, and F6/F7 change the state slot. Save states do not include cartridge SRAM.

During the opening movie, A shows a prompt; A again skips the movie.

See CONTRIBUTING.md for the project layout and verification workflow.

• Decompilation: Pheenoh/khcom and contributors (CC0).
• Third-party asset credits: NOTICE.md.
• PC port: ReKHCoM contributors.

The original decompilation README is kept in docs/README.decomp.md.

This is an independent fan project, unaffiliated with Square Enix, Disney or Nintendo. Their game content and trademarks are not covered by the source code's CC0 license. SDL3 is distributed under its own license, included in the Windows package.