TeamGDB/Yakumo

English · Русский · Español

A native port of Monster Hunter Portable 3rd HD Ver. made by static recompilation: the game's PSP code is translated ahead of time into C++ and compiled for your machine, then run on a reimplementation of the PSP system software. It is not an emulator — there is no interpreter or JIT at the heart of it — and it is not a decompilation.

This project does not include any game assets. You must provide the files from your own legally obtained copy of Monster Hunter Portable 3rd HD Ver. (NPJB-40001) to install or build Yakumo.

Yakumo is an independent, open-source project and is not affiliated with, authorized by, sponsored by, or endorsed by CAPCOM, Sony, or any of their affiliates.

Monster Hunter, Monster Hunter Portable 3rd HD Ver., CAPCOM, PlayStation, PSP, and all related trademarks, game assets, artwork, audio, characters, and other intellectual property belong to their respective owners.

Yakumo does not include any game assets or original game files: no disc image, no copy of the game's executable or data, and no textures, models, audio or video from the game. You must provide the files from your own legally obtained copy of Monster Hunter Portable 3rd HD Ver. to install or build Yakumo; the installer checks that copy and accepts only the original release.

To use Yakumo, users must provide the required files from their own legally obtained copy of Monster Hunter Portable 3rd HD Ver. for PlayStation 3.

Users are solely responsible for obtaining, dumping, extracting, and using their game copy in accordance with the laws applicable in their jurisdiction.

Yakumo does not support, provide, link to, or encourage the use of unauthorized or pirated copies of the game.

Any references to the original game or its trademarks are made solely for identification, compatibility, and interoperability purposes.

Screenshots and other depictions of the original game may be used solely to document or demonstrate Yakumo's functionality. All depicted third-party game content remains the property of its respective rights holders.

The license covering Yakumo applies only to the project's own original code and materials and does not grant any rights to third-party intellectual property.

Yakumo provides the software, not the game. You must provide your own legally obtained copy.

You can load a save copied from a PSP or start a new game, hunt, play with other hunters and save your progress, with music, movies and lighting. The game simulation stays at the PSP's 30 frames per second; optional frame interpolation presents it at 45, 60, 90, 120 or the display's refresh rate without changing game speed. Loads are shorter than on a PSP: while the game loads in silence, it runs ahead of real time (Fast loading, on by default).

Tested on macOS (Apple Silicon, Vulkan through MoltenVK), on a Steam Deck in Game Mode with native Vulkan and the built-in controls, and on Windows 11 with MSVC.

The state of each part of the game on each platform is in docs/COMPATIBILITY.md.

A prebuilt release needs nothing but your disc image. Pick the file for your device from the release's Assets, start it, and point the first-run setup at your image: it checks the image, prepares the game from it and keeps everything in a per-user directory. Updating keeps your settings and saves.

Test builds. The releases page also lists test builds, marked (test) (older ones (unstable)) and published as pre-releases. They carry the newest changes and may have new bugs: install one only if you want to help test. If you just want to play, use the latest stable release above.

Available in Yakumo v0.7.5 and later.

Translations of the game's text are maintained by their authors and downloaded separately. See each project's README for compatibility details and updates.

The catalog links only to public GitHub repositories and downloads hosted on GitHub (repository files or Releases).

Download the .lang file, open System → Text → Import Translation…, select the imported language under Game Text Language, then restart. See Text translation for details.

Building from source is a fully supported way to play. It needs:

• Your own copy of the game (see above)
• CMake 3.20 or newer, Ninja and a C++20 compiler
• Python 3
• SDL3, Vulkan and glslangValidator
• make and a C compiler on macOS and Linux: the build makes its own FFmpeg for the music and the movies. Nothing to install for it on Windows
• A few gigabytes of free memory for the build; the recompiled code is large

In short:

1. Prepare the game's executable from your disc image: build Yakumo once without recompiled code and run it with --install /path/to/image.iso. No external decryption tool is needed. Then link the image and that executable into the profile with profiles/mhp3rd/scripts/prepare_game.sh.
2. Configure, generate the recompiled code with profiles/mhp3rd/scripts/generate.sh, and build Yakumo.
3. Recompile the code overlays with profiles/mhp3rd/scripts/build_overlays.sh (about 40 minutes the first time; resumable).
4. Run out/mhp3rd/bin/Yakumo.

The full instructions, including every setting, are in profiles/mhp3rd/README.md. Building on every platform, Windows included, how long each stage takes, and how to work on the code without full rebuilds: docs/BUILDING.md.

On a gamepad the buttons are where you expect them: on a PlayStation pad circle confirms and cross backs out, as the game's prompts say, and the right stick drives the camera and aiming. Control presets (Default, Modern with attacks on the triggers, Left-handed, Classic keyboard, and your own) cover every control, and any of them can be bound to a single button or a combination such as L1 + ○. Keyboard and mouse play is complete; by default WASD moves, the mouse controls the camera, and its buttons attack. The full tables are in the profile README.

Esc, or both sticks pressed together (L3+R3), opens Yakumo's own menu. It holds video, audio, control, network and save settings, including aspect ratio, frame rate, internal resolution and HD texture pack import. The first start sets the game up from your disc image in the same window, and works with a gamepad alone.

• Android on real phones: device testing, graphics drivers and performance (#127, #17)
• One consistent visual style across Yakumo's setup screens, menus and overlays (#33)
• Touch controls for gameplay, menus, camera movement and aiming

The executable is analyzed and every instruction of its code is emitted as C++, which is compiled into the program. The game also loads 355 code overlays at run time into a handful of shared memory slots; each is recompiled into its own library, and when the game loads one, the matching library is installed between frames. An interpreter covers any code the recompiled set does not reach, so nothing stops the game — it only runs slower there.

Around that code sits a reimplementation of the PSP system: a kernel with threads, semaphores, event flags and timers; disc I/O read straight from the image; a Vulkan renderer for the PSP's graphics engine; software voice mixing for audio; and input from SDL3.

docs/ARCHITECTURE.md describes the execution model and docs/DATA_BIN.md the game's archive format. docs/TESTING.md has the smoke test and how to report results.

include/psprecomp/   Framework interfaces: runtime, memory, Allegrex state
src/                 Framework: ELF loading, decoder, runtime, interpreter
tools/               Framework: analyzer and C++ code generator
tests/               Framework regression tests
configs/             PSP NID data and generic examples
profiles/mhp3rd/     Everything specific to this game: host, kernel, renderer,
                     audio, input, configuration and build scripts
docs/                Architecture, archive format, profile guide, source rules

The recompiled code itself is generated locally from your copy of the game and is never committed.

Yakumo is built on PSPRecomp, a static recompilation framework for PSP software. The framework is game-neutral and can be built on its own:

cmake -S . -B out/framework -DPSPRECOMP_PROFILE=""
cmake --build out/framework --config Release
ctest --test-dir out/framework -C Release --output-on-failure

To target another title, see docs/PROFILE_GUIDE.md. docs/SOURCE_PROVENANCE.md sets out the rules for independently written code and third-party source.

• @MHunterG
• @mojitosunrise

• PSPRecomp — the recompilation framework this project builds on
• SDL3 — windowing, input and audio output
• FFmpeg — music and movie decoding
• Vulkan and MoltenVK — rendering
• Dear ImGui — Yakumo's menus and setup screens
• tiny-AES-c — the installer and PSP save-data support
• stb_truetype — font rasterization
• svanheulen/mhef — community documentation of the game's archive format
• Cinzel and Shippori Mincho — the logo's lettering, under the SIL Open Font License

The repository is distributed under the MIT License; see LICENSE. Third-party files keep their own notices beside them; docs/SOURCE_PROVENANCE.md lists their origins and licences.