Release 0.10.0-test

suyu MHGU native export 0.10.0 (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a native Windows game. This release contains no game code, no keys and no game files.

What's new since 0.9.0

Online (experimental)

• Play online against a self-hosted NEX server such as MHGU-NEX: the game's login, matchmaking and NAT checks go to the server you name in Online Server IP (online_server_host in game_settings.ini, or the F10 menu). Nintendo's servers are never contacted.
• Network services the online path needs: SSL Peek, real host sockets for non-LAN TCP and UDP while online, UDP sockets rebound to the port the game asks for, friend DeclareOpen / DeclareCloseOnlinePlaySession.
• Diagnostics for the game's peer-to-peer receive path ([Debug] pia_probe), off when diagnostics are off.
• Protocol 0 maps to the host default and poll result asserts are no longer fatal.

Game menu (F10)

• Multiplayer is split into Local (suyu rooms, Ryujinx LDN, public rooms) and Online (Online Server IP).
• Closing the window (X or Alt+F4) asks "Are you sure you want to exit?" first. [Display] confirm_exit = false turns it off.

Rendering

• Handheld present now blits only the 720/1080 content part of the present texture, fixing the wrong picture size in handheld mode.

Mod host

• A guest call into code with no recompiled block (Thumb, code a mod loaded itself) now runs on the emulator's JIT instead of failing. Forge PC 0.7 uses this.

Download

• suyu-mhgu-0.10.0-test-windows-x64.zip: suyu with the exporter (Windows 10/11, 64-bit)
  SHA-256: 3e6af297edfbc9f63eca9212b2713f4f0bf27d93d3b500bcf2fe51e4999d3d07
• suyu-mhgu-0.10.0-test-linux-x64.tar.xz: the same release for Linux (x64, glibc 2.35 or newer; FSR 3.1 only)
  SHA-256: 574d5a6f9ab0e7cacfe1bc79f5204636074d8a4bbc28de64530bfb5474fd61bf

You need

• Visual Studio 2022 17.14 or newer, or Visual Studio 2026 (free Community or Build Tools), with "Desktop development with C++".
• About 25 GB free disk for the export, a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: docs/a32recomp/INSTALL.md

Known issues

• Test build: online play needs a NEX server you run yourself, and parts of the matchmaking replies are still guesses.
• Linux gets FSR 3.1 only (FSR 4 through Steam + Proton, at an FPS cost).

Credits

suyu, Eden and yuzu developers (emulator base and shader recompiler sync). AMD FidelityFX FSR (MIT). Online server protocol work builds on NextendoNetwork/nextendo-nex (PolyForm Shield 1.0.0). Public MHGU patches used as references, not shipped: 60 FPS by masagrator, 90/120 FPS by minderrx, pchtxt pack by Fl4sh9174, 16:10 by TLin-Y. Forge by Fexty (Forge PC is a port, with permission).

AI disclosure

See docs/a32recomp/AI_DISCLOSURE.md.

License

GPL-3.0-or-later; source for this build is the tagged commit. Third-party licenses are in the zip. Not affiliated with Nintendo or Capcom.

Release 0.9.0-test

suyu MHGU native export 0.9.0 (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a native Windows game. This release contains no game code, no keys and no game files.

What's new since 0.8.0

Upscaling (FSR)

• FSR 3.1 temporal upscaler inside the replacement renderer (vendored FSR 3.1.4 Vulkan subset, MIT), with camera jitter, motion vectors from scene depth, object motion vectors (block matching and transform feedback), reactive masks for cloth, animated surfaces and ghost trails, and a HUD layer composited over the upscaled picture.
• FSR 4 (optional, AMD GPUs): uses the amd_fidelityfx_dx12.dll already installed with your AMD driver, or one you place in the game folder. Nothing from AMD is shipped. Falls back to FSR 3.1 when it can't load.
• Quality modes with separate render and output scale on the Direct renderer.

Renderer and resolution

• Settings: renderer = Emulated | Direct.
• Render scale steps now use the console size as 1X (1080 docked / 720 handheld); output size comes from resolution, else the window, else the base.
• native_render no longer widens the guest render size on top of the step scale.
• The picture fills the window layout instead of being pillarboxed when the window is wide.

Performance

• Lock-free pool tables, per-frame render-target memo, cheaper pitch-linear hashing, slimmer NVN call recording, per-core counters instead of global atomics.
• Presenting no longer waits for the GPU by default (present_nodrain = false restores the old behaviour).
• Probes and diagnostics cost nothing when off.

Shader recompiler / video core

• Shader recompiler synced with Eden (quad ops, warp shuffles, int64 lowering, and more).
• Ported from Eden: deferred clears, descriptor buffers, multi-range buffers.

Robustness

• Fixed a bug that was causing performance problems in 0.8. Native Linux was tested to hit 200+ FPS without FSR in this build.
• VkResult checks on every fence wait and queue submit, honest crash records (nvn_vk_crash.txt), pipeline cache saved periodically on a worker thread, a stale or cut-off shader cache no longer stops the launch.

Game menu (F10) and settings

• New Upscaler section, Advanced mode, "Restart now" button, software rendering when RivaTuner's hooks are detected.
• game_settings.ini is regrouped into one section each and migrated once, with a backup of the old file.

Logs and privacy

• Paths, user and computer name and IP addresses are redacted from logs by default ([Debug] log_redact_paths). tools/scrub-log.ps1 cleans older logs.

Download

• suyu-mhgu-0.9.0-test-windows-x64.zip: suyu with the exporter (Windows 10/11, 64-bit)
  SHA-256: d6c8b6dc86a948f361c20c3956180b377d4ef4b80822b7f9c427d0f939fa9999
• suyu-mhgu-0.9.0-test-linux-x64.tar.xz: the same release for Linux (x64, glibc 2.35 or newer; FSR 3.1 only)
  SHA-256: f90e7daede24a44efe28cf384a0a453e39b0d3d683ee723a62c893d5baab6d5d

You need

• Visual Studio 2022 17.14 or newer, or Visual Studio 2026 (free Community or Build Tools), with "Desktop development with C++".
• About 25 GB free disk for the export, a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: docs/a32recomp/INSTALL.md

Known issues

• Test build: FSR image quality (ghosting on fast objects, cloth) is still being tuned.
• Linux gets FSR 3.1 only (FSR 4 through Steam + Proton, at an FPS cost).

Credits

suyu, Eden and yuzu developers (emulator base and shader recompiler sync). AMD FidelityFX FSR (MIT). Public MHGU patches used as references, not shipped: 60 FPS by masagrator, 90/120 FPS by minderrx, pchtxt pack by Fl4sh9174, 16:10 by TLin-Y. Forge by Fexty (Forge PC is a port, with permission).

AI disclosure

See docs/a32recomp/AI_DISCLOSURE.md.

License

GPL-3.0-or-later; source for this build is the tagged commit. Third-party licenses are in the zip. Not affiliated with Nintendo or Capcom.

suyu MHGU native export 0.8.0-test

suyu MHGU native export 0.8.0-test (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a
native Windows or Linux game. suyu recompiles the game's 32-bit ARM code to C on your PC, compiles it
with your C compiler and links it into one game executable. This release contains no game
code, no keys and no game files.

New in 0.8.0-test

This is the biggest update so far, so the version jumps from 0.3.1.

• Replacement renderer ([Graphics] native_gpu). The game's own graphics calls (NVN) are
  now turned into Vulkan directly instead of going through suyu's GPU emulation. It was checked
  draw by draw against suyu's output.
  • Real render scaling: render targets, viewports, scissors and clears are scaled
    properly, using suyu's own rescaling code paths. The largest scale is limited by what your
    GPU supports, and your saved setting is never changed.
  • Shader and pipeline cache that learns: programs and pipelines are built ahead of time
    on a worker pool, remembered between runs and prewarmed at start, so there is less
    stuttering in play.
  • Many fixes found while comparing against suyu: shadows, sampler border colours, depth-only
    draws, cube maps, textures whose memory is replaced by the game, clears that respect the
    scissor box, and more.
  • A vsync option, and a render thread for presenting.
• Crossplay rooms (RyuLdn). The game's local play now works over a suyu room and a RyuLdn
  server at the same time, so exported-game players and Ryujinx players can share lobbies.
  • Hosting opens what is needed by itself: the room, this PC's own lobby server, or both.
    Suyu friends join your room; Ryujinx friends use your address as their LDN server.
  • Joining lists the lobbies of your room, your friend's server and Ryujinx's public
    server together.
  • The game menu's Multiplayer tab is now Join Room and Public rooms. One Name
    is used everywhere.
  • Addresses and MAC addresses inside game traffic are translated between the two worlds.
  • The host of a suyu room can kick players.
  • Guide: RYULDN.md
• Game menu (F10): a new Advanced tab with every suyu setting (shown with
  [Menu] show_advanced = true; it saves on every change), and a resolution scale in
  Settings.
• Custom resolutions now fill a bigger window: the final pass uses the full viewport.
• Fixed on Linux: the F10 game menu was broken (it had no window to draw in) on some
  distributions. It now uses the system SDL3 when it is installed.
• Logs: each run writes its own <pid>_suyu_log.txt. A per-second frame interval log with
  whole-run lows is available for people who want to measure smoothness
  (user/frame_stats*.txt, with [Debug] diagnostics = true).
• RivaTuner: [Debug] rtss_overlay = true now lets only RTSS's own Vulkan layer load, so
  other overlay layers in the chain no longer crash the game.
• Options for developers and testers under [Debug], all off by default: motion blur probe,
  stall and timing probes, a fence-thread sleep-poll setting.
• To get all of this, export the game again with this build. Keep your game folder's user
  folder and recomp_modules.txt as usual.

AI disclosure

Parts of this project are written with an AI coding assistant, under the maintainer's direction
and testing. What it did and did not do:
AI_DISCLOSURE.md.
Pull requests are limited for now: only large contributions are being accepted.

Download

• suyu-mhgu-0.8.0-test-windows-x64.zip: Windows 10/11, 64-bit
  SHA-256: af3a84be16d3106d90cfc908c2a1b29be0426abb4ea6e6c07bd99b01d2955b75

You need

• Windows: Visual Studio 2022 17.14 or newer, or Visual Studio 2026 (free Community or
  Build Tools), with "Desktop development with C++".
• About 25 GB of free disk space for the export, and a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: INSTALL.md

What works

• Town, hunts, menus, local play and crossplay with Ryujinx players have been tested. Please
  report anything that breaks.
• 30, 60, 90, 120 FPS or auto. These, like every option, are set in game_settings.ini or the
  game menu, with no re-export.
• Any resolution and aspect ratio (ultrawide), with native rendering up to 3840x2160 and
  render scaling.
• Fullscreen with F11 or Alt+Enter.
• Optional faster area loading by unpacking the game's archives at export.
• Typing on the PC keyboard where the game asks for text.
• Mods: romfs replacements, and code mods through Forge PC.

Known issues

• The HUD is stretched on screens that aren't 16:9. The fix is the HudFix plugin for
  Forge PC.
• suyu.exe can stay open in the background after an export. End it in Task Manager before
  updating.
• A Linux build is available as a separate pre-release, v0.8.0-test-linux, until it has been tested on real Linux hardware.

Credits

suyu, Eden and yuzu developers (emulator base). Ryujinx Team and Contributors (RyuLdn protocol;
LdnServer and Ryujinx's LDN client, MIT; our implementation was written from the protocol). Dear
ImGui (game menu). Public MHGU patches were used as references and are not shipped: 60 FPS by
masagrator, 90/120 FPS by minderrx, pchtxt pack by Fl4sh9174, 16:10 by TLin-Y. Forge by Fexty
(Forge PC is a port, made with permission).

License

GPL-3.0-or-later. The source for this build is the tagged commit. Third-party licenses are in
the package (LICENSE.txt, LICENSES.txt, licenses/). Not affiliated with Nintendo or Capcom.

suyu MHGU native export 0.8.0-test (Linux, pre-release)

suyu MHGU native export 0.8.0-test, Linux (pre-release)

Linux build of 0.8.0-test. It is the same as the Windows release, plus Linux build fixes, and it
has only been tested in WSL (software Vulkan), not on real Linux hardware. That is why it is a
pre-release. Reports from real Linux machines (Steam Deck, desktops) are very welcome.

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a
native game. suyu recompiles the game's 32-bit ARM code to C on your PC, compiles it with your C
compiler and links it into one game executable. This release contains no game code, no keys and
no game files. What is new in 0.8.0-test is listed in the
Windows release.

• Fixed on Linux: the F10 game menu was broken (it had no window to draw in) on some
  distributions. It now uses the system SDL3 when it is installed.

Download

• suyu-mhgu-0.8.0-test-linux-x64.tar.xz: 64-bit x86 Linux (glibc 2.35+)
  SHA-256: 0db782a98a110f8aae9f0564b7a266d9d28bb9ae95ab5e6325a498e590ca6e7b
  (built from commit 73b6e47)

You need

• gcc or clang, CMake 3.13+ and Ninja (recommended), plus common system libraries (Vulkan
  loader, OpenSSL 3, libusb, Brotli, zlib, PulseAudio/ALSA). One install command per distribution
  is in INSTALL-LINUX.md, section 2.
• About 25 GB of free disk space for the export, and a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Known issues

• Not tested on real Linux hardware. In WSL the game only has a software Vulkan device (llvmpipe),
  which is far too slow to judge rendering.
• Please include your distribution, GPU and driver in reports.

AI disclosure

Parts of this project are written with an AI coding assistant, under the maintainer's direction
and testing: AI_DISCLOSURE.md.

License

GPL-3.0-or-later. The source for this build is commit 73b6e47. Third-party licenses are in the
package. Not affiliated with Nintendo or Capcom.

suyu MHGU native export 0.3.1-test

suyu MHGU native export 0.3.1-test (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a
native Windows or Linux game. suyu recompiles the game's 32-bit ARM code to C on your PC,
compiles it with your C compiler and links it into one game executable. This release contains
no game code, no keys and no game files.

New in 0.3.1-test

• One Name for multiplayer: the Name at the top of the Multiplayer tab
  ([Multiplayer] nickname) is now used in suyu rooms and in Ryujinx lobbies, so Public rooms
  and Ryujinx players see it instead of "suyu".

New in 0.3.0-test

• Play with Ryujinx players (RyuLdn, experimental). Local play (Gathering Hall local mode)
  can now go through a RyuLdn server, the lobby server Ryujinx uses for LDN multiplayer, so
  exported-game players and Ryujinx players can join the same lobbies. Choose it in the game
  menu (F10) under Multiplayer, Play over: Ryujinx LDN (applies at the next start), or set
  [Multiplayer] backend = ryuldn in game_settings.ini. Suyu rooms stay the default and are
  unchanged.
  • Server: Ryujinx's public server (ldn.ryujinx.app, default), Host for friends (the
    game runs the lobby server itself, for example over Radmin VPN or any VPN/LAN; Linux players
    can use ZeroTier or Tailscale), or Join a friend's server. Switches at once outside a
    lobby.
  • Public rooms lists this game's open lobbies on the current and any extra servers.
  • Optional passphrase (Ryujinx- plus 8 hex digits) for private lobbies.
  • Guide: RYULDN.md
• To get it, export the game again with this build. Keep your game folder's user folder and
  recomp_modules.txt as usual.

Fixed in 0.2.1-test

• Linux: the game looks for the Forge PC mod loader as mods/0100770008DD8000/Forge/forge.so
  (a forge.dll setting from 0.2.0 is read as forge.so). Windows is unchanged.

New in 0.2.0-test

• Linux: suyu with the exporter for 64-bit Linux (glibc 2.35+: Ubuntu 22.04+, Debian 12+,
  Fedora 36+, current SteamOS, Arch). Exports a native Linux game. Guide:
  INSTALL-LINUX.md
• Game menu: press F10, or hold Minus + Plus on the controller for a second. It opens
  in its own window with these tabs:
  • Controls: pick a controller, remap buttons, swap A/B or X/Y.
  • Multiplayer: host or join with an invite. Addresses stay hidden until you click them.
  • Settings: every game_settings.ini option, and FPS changes take effect immediately.
  • General: FPS, folders and the list of mods.
• Controllers map themselves automatically. The exporter can also copy your Player 1
  setup from suyu into the game.
• Texture packs now work in exported games. Put suyu-style romfs mods in
  <game folder>/mods/0100770008DD8000/<mod name>/romfs/. The log lists each mod it loads.
• FPS display: set [Display] show_fps = true to show FPS in the title bar.

Fixed in 0.2.0-test

• The game crashed at start when RivaTuner Statistics Server was running. Its Vulkan overlay is
  now kept out of the game; use show_fps instead, or set [Debug] rtss_overlay = true.
• Texture mods in mods/ were ignored by exported games.
• The "Visual Studio not found" message now names Visual Studio 2026 as well.
• The developer reports (profiler, call census, file monitor) are now off by default. Turn
  them on with [Debug] diagnostics = true.

Download

• suyu-mhgu-0.3.1-test-windows-x64.zip: Windows 10/11, 64-bit
  SHA-256: e6f45a387e0ee9cbdccd32fb0e322254e73e74464475dcb8a99dd7f806a83694
• suyu-mhgu-0.3.1-test-linux-x64.tar.xz: 64-bit x86 Linux
  SHA-256: f17c76660962a942897cde28fb6cb9254ebaebee8fca9ffc35720612428290bb

You need

• Windows: Visual Studio 2022 17.14 or newer, or Visual Studio 2026 (free Community or
  Build Tools), with "Desktop development with C++".
• Linux: gcc or clang, CMake 3.13+ and Ninja (recommended), plus common system libraries
  (Vulkan loader, OpenSSL 3, libusb, Brotli, zlib, PulseAudio/ALSA). One install command per
  distribution is in INSTALL-LINUX.md, section 2.
• About 25 GB of free disk space for the export, and a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: INSTALL.md

What works

• Town, hunts, menus and local play have been tested. Please report anything that breaks.
• 30, 60, 90, 120 FPS or auto. These, like every option, are set in game_settings.ini or the
  game menu, with no re-export.
• Any resolution and aspect ratio (ultrawide), with native rendering up to 3840x2160.
• Fullscreen with F11 or Alt+Enter.
• Local play over a suyu room, for example through Radmin VPN.
• Typing on the PC keyboard where the game asks for text.
• Mods: romfs replacements, and code mods through Forge PC.

Known issues

• The HUD is stretched on screens that aren't 16:9. The fix is the HudFix plugin for
  Forge PC.
• suyu.exe can stay open in the background after an export. End it in Task Manager before
  updating.
• The Linux build has been tested in WSL only. Real Linux hardware (Steam Deck, desktops)
  hasn't been tested yet, and neither has mixed Linux/Windows multiplayer.

Credits

suyu, Eden and yuzu developers (emulator base). Ryujinx Team and Contributors (RyuLdn protocol;
LdnServer and Ryujinx's LDN client, MIT; our implementation was written from the protocol). Dear ImGui (game menu). Public MHGU patches
were used as references and are not shipped: 60 FPS by masagrator, 90/120 FPS by minderrx,
pchtxt pack by Fl4sh9174, 16:10 by TLin-Y. Forge by Fexty (Forge PC is a port, made with
permission).

License

GPL-3.0-or-later. The source for this build is the tagged commit. Third-party licenses are in
the package (LICENSE.txt, LICENSES.txt, licenses/). Not affiliated with Nintendo or Capcom.

suyu MHGU native export 0.3.0-test

suyu MHGU native export 0.3.0-test (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a
native Windows or Linux game. suyu recompiles the game's 32-bit ARM code to C on your PC,
compiles it with your C compiler and links it into one game executable. This release contains
no game code, no keys and no game files.

New in 0.3.0-test

• Play with Ryujinx players (RyuLdn, experimental). Local play (Gathering Hall local mode)
  can now go through a RyuLdn server, the lobby server Ryujinx uses for LDN multiplayer, so
  exported-game players and Ryujinx players can join the same lobbies. Choose it in the game
  menu (F10) under Multiplayer, Play over: Ryujinx LDN (applies at the next start), or set
  [Multiplayer] backend = ryuldn in game_settings.ini. Suyu rooms stay the default and are
  unchanged.
  • Server: Ryujinx's public server (ldn.ryujinx.app, default), Host for friends (the
    game runs the lobby server itself, for example over Radmin VPN or any VPN/LAN; Linux players
    can use ZeroTier or Tailscale), or Join a friend's server. Switches at once outside a
    lobby.
  • Public rooms lists this game's open lobbies on the current and any extra servers.
  • Optional passphrase (Ryujinx- plus 8 hex digits) for private lobbies.
  • Guide: RYULDN.md
• To get it, export the game again with this build. Keep your game folder's user folder and
  recomp_modules.txt as usual.

Fixed in 0.2.1-test

• Linux: the game looks for the Forge PC mod loader as mods/0100770008DD8000/Forge/forge.so
  (a forge.dll setting from 0.2.0 is read as forge.so). Windows is unchanged.

New in 0.2.0-test

• Linux: suyu with the exporter for 64-bit Linux (glibc 2.35+: Ubuntu 22.04+, Debian 12+,
  Fedora 36+, current SteamOS, Arch). Exports a native Linux game. Guide:
  INSTALL-LINUX.md
• Game menu: press F10, or hold Minus + Plus on the controller for a second. It opens
  in its own window with these tabs:
  • Controls: pick a controller, remap buttons, swap A/B or X/Y.
  • Multiplayer: host or join with an invite. Addresses stay hidden until you click them.
  • Settings: every game_settings.ini option, and FPS changes take effect immediately.
  • General: FPS, folders and the list of mods.
• Controllers map themselves automatically. The exporter can also copy your Player 1
  setup from suyu into the game.
• Texture packs now work in exported games. Put suyu-style romfs mods in
  <game folder>/mods/0100770008DD8000/<mod name>/romfs/. The log lists each mod it loads.
• FPS display: set [Display] show_fps = true to show FPS in the title bar.

Fixed in 0.2.0-test

• The game crashed at start when RivaTuner Statistics Server was running. Its Vulkan overlay is
  now kept out of the game; use show_fps instead, or set [Debug] rtss_overlay = true.
• Texture mods in mods/ were ignored by exported games.
• The "Visual Studio not found" message now names Visual Studio 2026 as well.
• The developer reports (profiler, call census, file monitor) are now off by default. Turn
  them on with [Debug] diagnostics = true.

Download

• suyu-mhgu-0.3.0-test-windows-x64.zip: Windows 10/11, 64-bit
  SHA-256: 96eef74629c5fbf9452fdd9bb63535e7563cb31f5bf0b503aab7c9fca6bd8e3a
• suyu-mhgu-0.3.0-test-linux-x64.tar.xz: 64-bit x86 Linux
  SHA-256: ed9a50bbc9c7863280132964967181b9865f71e861bfa04730197e55d9d2565a

You need

• Windows: Visual Studio 2022 17.14 or newer, or Visual Studio 2026 (free Community or
  Build Tools), with "Desktop development with C++".
• Linux: gcc or clang, CMake 3.13+ and Ninja (recommended), plus common system libraries
  (Vulkan loader, OpenSSL 3, libusb, Brotli, zlib, PulseAudio/ALSA). One install command per
  distribution is in INSTALL-LINUX.md, section 2.
• About 25 GB of free disk space for the export, and a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: INSTALL.md

What works

• Town, hunts, menus and local play have been tested. Please report anything that breaks.
• 30, 60, 90, 120 FPS or auto. These, like every option, are set in game_settings.ini or the
  game menu, with no re-export.
• Any resolution and aspect ratio (ultrawide), with native rendering up to 3840x2160.
• Fullscreen with F11 or Alt+Enter.
• Local play over a suyu room, for example through Radmin VPN.
• Typing on the PC keyboard where the game asks for text.
• Mods: romfs replacements, and code mods through Forge PC.

Known issues

• The HUD is stretched on screens that aren't 16:9. The fix is the HudFix plugin for
  Forge PC.
• suyu.exe can stay open in the background after an export. End it in Task Manager before
  updating.
• The Linux build has been tested in WSL only. Real Linux hardware (Steam Deck, desktops)
  hasn't been tested yet, and neither has mixed Linux/Windows multiplayer.

Credits

suyu, Eden and yuzu developers (emulator base). Ryujinx Team and Contributors (RyuLdn protocol;
LdnServer and Ryujinx's LDN client, MIT; our implementation was written from the protocol). Dear ImGui (game menu). Public MHGU patches
were used as references and are not shipped: 60 FPS by masagrator, 90/120 FPS by minderrx,
pchtxt pack by Fl4sh9174, 16:10 by TLin-Y. Forge by Fexty (Forge PC is a port, made with
permission).

License

GPL-3.0-or-later. The source for this build is the tagged commit. Third-party licenses are in
the package (LICENSE.txt, LICENSES.txt, licenses/). Not affiliated with Nintendo or Capcom.

suyu MHGU native export 0.2.1-test

suyu MHGU native export 0.2.1-test (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a
native Windows or Linux game. suyu recompiles the game's 32-bit ARM code to C on your PC,
compiles it with your C compiler and links it into one game executable. This release contains
no game code, no keys and no game files.

Fixed since 0.2.0-test

• Linux: the game now looks for the Forge PC mod loader as mods/0100770008DD8000/Forge/forge.so
  instead of the Windows file name forge.dll. A game_settings.ini written by 0.2.0 that still
  says loader = Forge/forge.dll is read as forge.so on Linux, so there's nothing to edit.
  Windows is unchanged.
• To get the fix, export the game again with this build. Keep your game folder's user folder
  and recomp_modules.txt as usual.

New in 0.2.0-test

• Linux: suyu with the exporter for 64-bit Linux (glibc 2.35+: Ubuntu 22.04+, Debian 12+,
  Fedora 36+, current SteamOS, Arch). Exports a native Linux game. Guide:
  INSTALL-LINUX.md
• Game menu: press F10, or hold Minus + Plus on the controller for a second. It opens
  in its own window with these tabs:
  • Controls: pick a controller, remap buttons, swap A/B or X/Y.
  • Multiplayer: host or join with an invite. Addresses stay hidden until you click them.
  • Settings: every game_settings.ini option, and FPS changes take effect immediately.
  • General: FPS, folders and the list of mods.
• Controllers map themselves automatically. The exporter can also copy your Player 1
  setup from suyu into the game.
• Texture packs now work in exported games. Put suyu-style romfs mods in
  <game folder>/mods/0100770008DD8000/<mod name>/romfs/. The log lists each mod it loads.
• FPS display: set [Display] show_fps = true to show FPS in the title bar.

Fixed in 0.2.0-test

• The game crashed at start when RivaTuner Statistics Server was running. Its Vulkan overlay is
  now kept out of the game; use show_fps instead, or set [Debug] rtss_overlay = true.
• Texture mods in mods/ were ignored by exported games.
• The "Visual Studio not found" message now names Visual Studio 2026 as well.
• The developer reports (profiler, call census, file monitor) are now off by default. Turn
  them on with [Debug] diagnostics = true.

Download

• suyu-mhgu-0.2.1-test-windows-x64.zip: Windows 10/11, 64-bit
  SHA-256: fcaecb89db4fd35c48a9b8d132ef013177b813db29cede0bde6e2e3a37832630
• suyu-mhgu-0.2.1-test-linux-x64.tar.xz: 64-bit x86 Linux
  SHA-256: 49ff6465a3ebb276148e846aeed6bd7128aeaf71f261e5e7da5bf64b5f493cc2

You need

• Windows: Visual Studio 2022 17.14 or newer, or Visual Studio 2026 (free Community or
  Build Tools), with "Desktop development with C++".
• Linux: gcc or clang, CMake 3.13+ and Ninja (recommended), plus common system libraries
  (Vulkan loader, OpenSSL 3, libusb, Brotli, zlib, PulseAudio/ALSA). One install command per
  distribution is in INSTALL-LINUX.md, section 2.
• About 25 GB of free disk space for the export, and a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: INSTALL.md

What works

• Town, hunts, menus and local play have been tested. Please report anything that breaks.
• 30, 60, 90, 120 FPS or auto. These, like every option, are set in game_settings.ini or the
  game menu, with no re-export.
• Any resolution and aspect ratio (ultrawide), with native rendering up to 3840x2160.
• Fullscreen with F11 or Alt+Enter.
• Local play over a suyu room, for example through Radmin VPN.
• Typing on the PC keyboard where the game asks for text.
• Mods: romfs replacements, and code mods through Forge PC.

Known issues

• The HUD is stretched on screens that aren't 16:9. The fix is the HudFix plugin for
  Forge PC.
• suyu.exe can stay open in the background after an export. End it in Task Manager before
  updating.
• The Linux build has been tested in WSL only. Real Linux hardware (Steam Deck, desktops)
  hasn't been tested yet, and neither has mixed Linux/Windows multiplayer.

Credits

suyu, Eden and yuzu developers (emulator base). Dear ImGui (game menu). Public MHGU patches
were used as references and are not shipped: 60 FPS by masagrator, 90/120 FPS by minderrx,
pchtxt pack by Fl4sh9174, 16:10 by TLin-Y. Forge by Fexty (Forge PC is a port, made with
permission).

License

GPL-3.0-or-later. The source for this build is the tagged commit. Third-party licenses are in
the package (LICENSE.txt, LICENSES.txt, licenses/). Not affiliated with Nintendo or Capcom.

suyu MHGU native export 0.2.0-test

suyu MHGU native export 0.2.0-test (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a
native Windows or Linux game. suyu recompiles the game's 32-bit ARM code to C on your PC,
compiles it with your C compiler and links it into one game executable. This release contains
no game code, no keys and no game files.

New in 0.2.0-test

• Linux: suyu with the exporter for 64-bit Linux (glibc 2.35+: Ubuntu 22.04+, Debian 12+,
  Fedora 36+, SteamOS 3.5+, Arch). Exports a native Linux game. Guide:
  INSTALL-LINUX.md
• Game menu: press F10, or hold Minus + Plus on the controller for a second. It opens
  in its own window with these tabs:
  • Controls: pick a controller, remap buttons, swap A/B or X/Y.
  • Multiplayer: host or join with an invite. Addresses stay hidden until you click them.
  • Settings: every game_settings.ini option, and FPS changes take effect immediately.
  • General: FPS, folders and the list of mods.
• Controllers map themselves automatically. The exporter can also copy your Player 1
  setup from suyu into the game.
• Texture packs now work in exported games. Put suyu-style romfs mods in
  <game folder>/mods/0100770008DD8000/<mod name>/romfs/. The log lists each mod it loads.
• FPS display: set [Display] show_fps = true to show FPS in the title bar.

Fixed since 0.1.2-test

• The game crashed at start when RivaTuner Statistics Server was running. Its Vulkan overlay is
  now kept out of the game; use show_fps instead, or set [Debug] rtss_overlay = true.
• Texture mods in mods/ were ignored by exported games.
• The "Visual Studio not found" message now names Visual Studio 2026 as well.
• The developer reports (profiler, call census, file monitor) are now off by default. Turn
  them on with [Debug] diagnostics = true.

Download

• suyu-mhgu-0.2.0-test-windows-x64.zip: Windows 10/11, 64-bit
  SHA-256: 5caf6d0670a3909d033298cbfd036088c93a5ab70af41a5cd4c54d3fb46680ed
• suyu-mhgu-0.2.0-test-linux-x64.tar.xz: 64-bit x86 Linux
  SHA-256: 3269a20766b236744181316d9fb2b8e8d0e8571bab31252218d2aac421057e9b

You need

• Windows: Visual Studio 2022 17.14 or newer, or Visual Studio 2026 (free Community or
  Build Tools), with "Desktop development with C++".
• Linux: gcc or clang, CMake 3.13+ and Ninja (recommended), plus common system libraries
  (Vulkan loader, OpenSSL 3, libusb, Brotli, zlib, PulseAudio/ALSA). One install command per
  distribution is in INSTALL-LINUX.md, section 2.
• About 25 GB of free disk space for the export, and a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: INSTALL.md

What works

• Town, hunts, menus and local play have been tested. Please report anything that breaks.
• 30, 60, 90, 120 FPS or auto. These, like every option, are set in game_settings.ini or the
  game menu, with no re-export.
• Any resolution and aspect ratio (ultrawide), with native rendering up to 3840x2160.
• Fullscreen with F11 or Alt+Enter.
• Local play over a suyu room, for example through Radmin VPN.
• Typing on the PC keyboard where the game asks for text.
• Mods: romfs replacements, and code mods through Forge PC.

Known issues

• The HUD is stretched on screens that aren't 16:9. The fix is the HudFix plugin for
  Forge PC.
• suyu.exe can stay open in the background after an export. End it in Task Manager before
  updating.
• The Linux build has been tested in WSL only. Real Linux hardware (Steam Deck, desktops)
  hasn't been tested yet, and neither has mixed Linux/Windows multiplayer.

Credits

suyu, Eden and yuzu developers (emulator base). Dear ImGui (game menu). Public MHGU patches
were used as references and are not shipped: 60 FPS by masagrator, 90/120 FPS by minderrx,
pchtxt pack by Fl4sh9174, 16:10 by TLin-Y. Forge by Fexty (Forge PC is a port, made with
permission).

License

GPL-3.0-or-later. The source for this build is the tagged commit. Third-party licenses are in
the package (LICENSE.txt, LICENSES.txt, licenses/). Not affiliated with Nintendo or Capcom.

suyu MHGU native export 0.1.2-test

suyu MHGU native export 0.1.2-test (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a
native Windows game. suyu recompiles the game's 32-bit ARM code to C on your PC, compiles it
with Microsoft's C++ compiler and links it into one .exe. This release contains no game
code, no keys and no game files.

Fixed since 0.1.1-test

• Export with Visual Studio 2026: the game's modules were built in Debug mode and the
  compiler refused them ("'/RTC1' and '/O1' command-line options are incompatible").
  They're now always built as Release, with Ninja when Visual Studio provides it.

Fixed in 0.1.1-test

• Export: the game's code is now always compiled inside the Visual Studio environment. On
  some PCs 0.1.0 ran a CMake that found no compiler ("'nmake' '-?' failed",
  "CMAKE_C_COMPILER not set") and ended with "The static recompiled executable was not
  produced".
• Export: without the Visual Studio C++ tools it now stops right away and says what to
  install, instead of failing at the end.

Download

• suyu-mhgu-0.1.2-test-windows-x64.zip: suyu with the exporter (Windows 10/11, 64-bit)
  SHA-256: d0162002f68a3e28850420ef29cbc44845244ff19b5133fe3eb28537d4ffe2a4

You need

• Visual Studio 2022 17.14 or newer, or Visual Studio 2026 (free Community or Build Tools), with
  "Desktop development with C++". It's the only extra install.
• About 25 GB free disk for the export, a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: INSTALL.md

What works

• Town, hunts, menus and local play tested; reports welcome for anything that breaks
• 30, 60, 90, 120 FPS or auto (game_settings.ini, no re-export)
• Any resolution and aspect ratio (ultrawide), native render up to 3840x2160
• Fullscreen (F11 / Alt+Enter), F12 panel (status, controller binding, mods, multiplayer)
• Local play over a suyu room (e.g. Radmin VPN), host/join from the F12 panel
• Typing on the PC keyboard where the game asks for text
• Mods: romfs replacements, and code mods through a drop-in loader DLL (Forge PC, to be
  released separately)

Known issues

• The HUD is stretched on screens that aren't 16:9. The fix is the HudFix plugin for Forge PC,
  to be released separately.
• suyu.exe can stay open in the background after an export; end it in Task Manager before
  updating.
• A first start has once failed with a Vulkan out-of-memory error; starting again worked.

Credits

suyu, Eden and yuzu developers (emulator base). Public MHGU patches used as references, not
shipped: 60 FPS by masagrator, 90/120 FPS by minderrx, pchtxt pack by Fl4sh9174, 16:10 by
TLin-Y. Forge by Fexty (Forge PC is a port, with permission).

License

GPL-3.0-or-later; source for this build is the tagged commit. Third-party licenses are in the
zip (LICENSE.txt, LICENSES.txt, licenses/). Not affiliated with Nintendo or Capcom.

suyu MHGU native export 0.1.1-test

suyu MHGU native export 0.1.1-test (test build)

Turns your own copy of Monster Hunter Generations Ultimate (Switch, version 1.4.0) into a
native Windows game. suyu recompiles the game's 32-bit ARM code to C on your PC, compiles it
with Microsoft's C++ compiler and links it into one .exe. This release contains no game
code, no keys and no game files.

Fixed since 0.1.0-test

• Export: the game's code is now always compiled inside the Visual Studio environment. On
  some PCs 0.1.0 ran a CMake that found no compiler ("'nmake' '-?' failed",
  "CMAKE_C_COMPILER not set") and ended with "The static recompiled executable was not
  produced".
• Export: without the Visual Studio C++ tools it now stops right away and says what to
  install, instead of failing at the end.

Download

• suyu-mhgu-0.1.1-test-windows-x64.zip: suyu with the exporter (Windows 10/11, 64-bit)
  SHA-256: 033e218bc190dce174a8c8e5017530602aa7e625cf503e2e524683b9c673c01f

You need

• Visual Studio 2022 17.14 or newer (free Community or Build Tools) with
  "Desktop development with C++". It's the only extra install.
• About 25 GB free disk for the export, a GPU with a current Vulkan driver.
• Your own keys and your own dump of MHGU with the 1.4.0 update.

Step-by-step guide: INSTALL.md

What works

• Town, hunts, menus and local play tested; reports welcome for anything that breaks
• 30, 60, 90, 120 FPS or auto (game_settings.ini, no re-export)
• Any resolution and aspect ratio (ultrawide), native render up to 3840x2160
• Fullscreen (F11 / Alt+Enter), F12 panel (status, controller binding, mods, multiplayer)
• Local play over a suyu room (e.g. Radmin VPN), host/join from the F12 panel
• Typing on the PC keyboard where the game asks for text
• Mods: romfs replacements, and code mods through a drop-in loader DLL (Forge PC, to be
  released separately)

Known issues

• The HUD is stretched on screens that aren't 16:9. The fix is the HudFix plugin for Forge PC,
  to be released separately.
• suyu.exe can stay open in the background after an export; end it in Task Manager before
  updating.
• A first start has once failed with a Vulkan out-of-memory error; starting again worked.

Credits

suyu, Eden and yuzu developers (emulator base). Public MHGU patches used as references, not
shipped: 60 FPS by masagrator, 90/120 FPS by minderrx, pchtxt pack by Fl4sh9174, 16:10 by
TLin-Y. Forge by Fexty (Forge PC is a port, with permission).

License

GPL-3.0-or-later; source for this build is the tagged commit. Third-party licenses are in the
zip (LICENSE.txt, LICENSES.txt, licenses/). Not affiliated with Nintendo or Capcom.