khorne-hub/gu-native

It takes three steps, and you only do them once.

Step 1: Get your game files

You need two folders from your own game: exefs and romfs. They must include the 1.4.0 update.

If your copy is in the Ryujinx emulator on your PC:

1. Make sure the 1.4.0 update is applied to the game.
2. Right-click the game, open Extract Data, and extract ExeFS and then RomFS into one empty folder.

Keep both in one folder, for example C:\MHGU:

MHGU
├─ exefs
└─ romfs

This project does not explain how to dump a game from your console, and does not provide game files, keys or links to them.

Step 2: Create the game code

The app has no game code in it, so you create yours from your own copy. It runs on your PC and sends nothing anywhere.

1. Install Python. On Windows, tick Add python.exe to PATH in the installer.

2. On this page, click the green Code button, then Download ZIP, and unzip it.

3. Open the unzipped folder, then its tools folder.

4. Windows: click the address bar of that window, type cmd and press Enter. Linux: open a terminal in that folder.

5. Type this, with your own folder, and press Enter:

   python build_game.py --android C:\MHGU
   

The first time, it downloads Google's Android compiler (about 1.8 GB). Then it works on its own: about 6 minutes on a fast PC, longer on a slower one. When it says Done, your folder has two new files:

MHGU
├─ exefs
├─ romfs
├─ libmhgugame.so
└─ libmhgugame.id

These files are made from your game: keep them for yourself and don't share them.

Do you also play on PC? Leave out --android: one run makes the game code for both, and also adds mhgugame.dll and mhgugame.id. It then downloads llvm-mingw too, the compiler for the PC game (about 150 MB), and takes a few minutes more. Running it again keeps what is already made and up to date.

Step 3: Install it

1. Copy the whole MHGU folder to your device, for example with a USB cable. It can go anywhere in its storage or on an SD card, except inside Android/data.
2. On your device, download the APK from Releases and open it. Android may ask you to allow installing apps from your browser.
3. Open MHGU, tap Give permission and choose folder, and turn on file access when Android asks. The game only reads that folder.
4. Find your MHGU folder (it shows a ✓) and tap Use this folder. The app has its own folder browser; if you'd rather use Android's, tap Android's picker.

The app checks the folder, tells you exactly what is missing if something is wrong, and starts the game.

Your saves and settings are kept separately, in Android/data/com.mhgu.recomp/files. To choose another folder later: gear button, Menu Options, Game folder.