Hamtaro Native
Hamtaro native PC port of Hamtaro Ham-Ham Heartbreak for Game Boy Advance with keyboard and gamepad support.
- Type: PC port
- Game: Hamtaro: Ham-Ham Heartbreak
- Runs on Windows
- By josealmon
- Latest release v1.0.0, 2026-10-30
- Source: https://github.com/josealmon/hamtaro-native
README
Hamtaro: Ham-Ham Heartbreak — Native PC Port
A native Windows port of Hamtaro: Ham-Ham Heartbreak for Game Boy Advance, based on the game's decompilation. The game logic runs as compiled x64 code, with SDL3 handling the desktop window, audio and controllers.
You need your own European ROM to play. The ROM and extracted gameplay resources are not included.
Features
- Keyboard and gamepad support, with remappable buttons, optional WASD movement, controller selection and adjustable stick deadzone.
- Resizable window and fullscreen, preserving the original aspect ratio. Nearest-neighbor rendering keeps pixels sharp; integer scaling is optional.
- Volume and mute controls, plus optional pausing when switching applications.
- Compatible save files: import an original 32 KiB
.savand continue playing. Saves and settings stay in your profile when you replace the executable. - Pause and resume with Escape, with access to settings while playing.
- Cable Link over LAN: exchange Ham-Jam dances between two PCs using Create connection and Join by IP.
Single-player routes have been tested through the ending, all 21 reconciliations and all 86 Ham-Chats. See tested scope for coverage details.
Getting started
- Download the Windows ZIP from the latest release and extract it into a folder.
- Run
Hamtaro - Ham-Ham Heartbreak.exe. - Select your compatible
.gbafile in the launcher. - Choose Play.
Requires Windows 10 or 11, 64-bit. No BIOS file is needed. The launcher copies the validated ROM into your local profile; it does not modify the file you selected.
Supported ROM
| Property | Required version |
|---|---|
| Game | Hamtaro: Ham-Ham Heartbreak |
| Region | Europe |
| Game code | AH3P |
| Revision | 0 |
| Size | 16 MiB (16,777,216 bytes) |
| Languages | English, French, German, Spanish and Italian |
The launcher checks the ROM's identity and full SHA-256 hash:
401968322b3245381da64dab35bdaacb3f82a404425c584867f00c45e469ffd8
Other regions, revisions and modified ROMs are not supported. The game's language is selected in its own title menu, independently of the launcher language.
Default controls
| Action | Keyboard | Gamepad |
|---|---|---|
| Move | Arrow keys or WASD | D-pad or left stick |
| A | Z | South face button |
| B | X | East face button |
| L / R | Q / E | Left / right shoulder |
| Start | Enter | Start |
| Select | Right Shift | Back / View |
| Open pause menu | Escape | Right-stick click |
| Resume | Escape, or Home → Resume | Home → Resume |
| Toggle fullscreen | F11 | — |
Change game bindings in Controls. Assigning W, A, S or D to an action turns off the WASD movement shortcut. Once all four keys are free, you can enable it again. Reset controls restores the default bindings and enables WASD.
Cable Link over LAN
- Start the game on both PCs, then press Escape and open Cable Link.
- On one PC, choose Create connection. On the other, enter the displayed IPv4 address for your shared Wi-Fi or Ethernet network and choose Join by IP.
- Once both show Connected, press Escape or choose Home → Resume. Open Ham-Jam from the game's title menu, choose a song and dance, then open Trade. Both players can select Send Ham-Jam to swap dances, or one can select Get Ham-Jam to receive only. Save each received dance in a slot.
Both PCs need this port with a compatible Cable Link protocol and their own ROM. The host listens on TCP port 24816. If Windows Firewall prompts the host, allow the application on the private network. Choose Disconnect in the Cable Link tab when finished.
Saves and settings
The launcher stores your ROM, settings and save in %USERPROFILE%\.hamtaro-native.
Use Import save or Open save folder on Home to manage your save. The game
uses its original save system and keeps one previous save backup. Emulator save
states are not supported.
For a separate profile, launch the application with --data-dir "PATH_TO_PROFILE".
Building from source
Install Visual Studio Build Tools with the Desktop development with C++ workload, including the Windows SDK and the bundled CMake tools (3.25 or newer). Run these commands from the repository root in Developer PowerShell.
cmake -S . -B build -A x64
cmake --build build --config Release
CMake fetches SDL3 and Dear ImGui automatically. The executable is written to
build/Release/Hamtaro - Ham-Ham Heartbreak.exe. To run the tests, use
ctest --test-dir build -C Release --output-on-failure.
Documentation and credits
- Architecture and tested scope
- Testing and packaging
- Hamtaro: Ham-Ham Heartbreak decompilation
- Third-party notices
This is an unofficial fan project, with no affiliation with Nintendo or the
Hamtaro rights holders. Code and third-party licensing details are in NOTICE.md.