<div align="center"> <a href="https://github.com/ant0-blase/GekkoAOT"> <img src="https://raw.githubusercontent.com/ant0-blase/GekkoAOT/main/assets/gekkoaot-logo.png" alt="GekkoAOT — GameCube native recompilation" width="520"> </a>

🚀 THIS PROJECT HAS MOVED TO GEKKOAOT

This repository is archived in spirit and no longer maintained.

No more fixes, compatibility updates or new enhancements will be developed here.

<a href="https://github.com/ant0-blase/GekkoAOT"><strong>➡️ GO TO GEKKOAOT — THE NEW PROJECT</strong></a>

One modern GameCube recompilation project. New runtime, graphics, performance improvements and ongoing compatibility work.

<a href="https://github.com/ant0-blase/GekkoAOT#compatibility">Check game compatibility</a> · <a href="https://github.com/ant0-blase/GekkoAOT/releases">Releases</a> · <a href="https://github.com/ant0-blase/GekkoAOT">Source code</a>

_{GekkoAOT is pre-alpha: compatibility varies by game, and full playthroughs are not guaranteed.}

</div>

---

<div align="center"> <img src="assets/logo.png" alt="Medal of Honor: Frontline" width="620">

Medal of Honor: Frontline — GameCube Static Recompilation

Experimental native PC recompilation of the USA GameCube release (GMFE69) using DolRecomp + ModernGekko.

Linux · PowerPC → native C recompilation · Vulkan · Wayland · Multi-image ABI v5

</div> <p align="center"> <a href="#visual-comparison">GC vs enhanced recompilation</a> · <a href="#quick-start">Quick start</a> · <a href="#live-pc-settings">Live PC settings</a> · <a href="#runtime-enhancement-options">Launcher options</a> </p> <p align="center"> <a href="assets/enhanced/windmill.png"><img src="assets/enhanced/windmill.png" alt="Enhanced GameCube recompilation with PS3 assets, 16:10 widescreen and 105° FOV" width="100%"></a> <br> <em>GameCube recompilation · PS3 textures & fonts · 1920×1200 / 16:10 · 105° FOV</em> </p>

[!IMPORTANT] This repository does not contain the original game ISO, extracted game data, or PS3 textures, fonts or other PS3 assets. You must provide your own legally obtained USA GameCube copy of Medal of Honor: Frontline (GMFE69) and your own legally obtained PS3 assets to use the optional remaster layer.

[!TIP] The remaster layer can now use either an extracted PS3_FILES directory or a finalized retail PS3 .pkg directly. With a PKG source, texture/material/lighting/mesh data is decrypted and read on demand; the package is not fully extracted to disk.

Visual comparison

Original GC presentation → enhanced native recompilation with PS3 assets. Both columns show the GameCube project: “PS3 assets” means the optional textures and fonts used by the recompilation, not the game running on a PS3.

<table> <tr> <th width="50%">GC — original presentation</th> <th width="50%">Recompilation — PS3 assets + PC enhancements</th> </tr> <tr> <td><a href="assets/main-menu.png"><img src="assets/main-menu.png" alt="Original GameCube menu without widescreen enhancements" width="100%"></a></td> <td><a href="assets/enhanced/main-menu.png"><img src="assets/enhanced/main-menu.png" alt="Enhanced menu with PS3 textures and fonts" width="100%"></a></td> </tr> <tr> <td><a href="assets/mission_gameplay.png"><img src="assets/mission_gameplay.png" alt="GameCube countryside with original assets and field of view" width="100%"></a></td> <td><a href="assets/enhanced/countryside.png"><img src="assets/enhanced/countryside.png" alt="Enhanced countryside with PS3 assets, 16:10 widescreen and 105 degree field of view" width="100%"></a></td> </tr> <tr> <td>Original GC textures and fonts, original aspect ratio and FOV; no widescreen patch.</td> <td>PS3 textures and fonts, 16:10 widescreen at 1920×1200, 105° FOV and enhanced graphics.</td> </tr> </table>

The older GC captures and new enhanced captures use different viewpoints and capture sizes. They illustrate the overall presentation; they are not a frame-matched comparison of individual effects. Click any image to open it at full size.

Enhanced capture settings

Setting	Enhanced presentation
Output / aspect ratio	1920×1200 · 16:10 widescreen
Horizontal field of view	105°
Remaster assets	PS3 textures + PS3 fonts
Internal resolution / filtering	5× internal resolution + 16× anisotropic filtering
Bloom	Enabled
Enhanced screen-space lighting	Enabled
Ambient Occlusion	Enabled
Contact Shadows	Enabled
Sharpening	Enabled

Enhanced gameplay gallery

<table> <tr> <td><a href="assets/enhanced/stonework.png"><img src="assets/enhanced/stonework.png" alt="Enhanced stonework textures" width="100%"></a></td> <td><a href="assets/enhanced/country-road.png"><img src="assets/enhanced/country-road.png" alt="Widescreen country road" width="100%"></a></td> </tr> <tr> <td><a href="assets/enhanced/landscape.png"><img src="assets/enhanced/landscape.png" alt="Enhanced countryside lighting and landscape" width="100%"></a></td> <td><a href="assets/enhanced/windmill.png"><img src="assets/enhanced/windmill.png" alt="Windmill landscape at 105 degree FOV" width="100%"></a></td> </tr> </table>

Live PC settings

Press Ctrl+F10 or <kbd>`</kbd> to open the in-game PC settings menu. Changes apply live, so you can adjust the presentation while playing.

<details> <summary><strong>View the graphics settings used in the enhanced captures</strong></summary> <table> <tr> <td><a href="assets/enhanced/pc-graphics.png"><img src="assets/enhanced/pc-graphics.png" alt="Live PC graphics settings" width="100%"></a></td> <td><a href="assets/enhanced/pc-enhanced-graphics.png"><img src="assets/enhanced/pc-enhanced-graphics.png" alt="Bloom, screen-space lighting, ambient occlusion, contact shadows and sharpening settings" width="100%"></a></td> </tr> <tr> <td><a href="assets/enhanced/pc-settings.png"><img src="assets/enhanced/pc-settings.png" alt="Additional live PC settings" width="100%"></a></td> <td><a href="assets/enhanced/pc-resolution.png"><img src="assets/enhanced/pc-resolution.png" alt="PC resolution selection" width="100%"></a></td> </tr> </table> </details>

Overview

This project statically recompiles the PowerPC executable code used by Medal of Honor: Frontline into a native host shared library. ModernGekko provides the GameCube runtime environment around that native code: memory, exceptions, GX/video, audio, input, timing, DVD/filesystem services and executable-image switching.

Unlike a simple main.dol port, Frontline loads multiple executable images during normal gameplay. The build therefore discovers and recompiles the complete executable chain and links it into a single overlap-safe module:

sys/main.dol / files/Moh2BootRel.dol
              │
              ├── files/Moh2RelGC.elf       main game executable
              └── files/Moh2StubRelGC.elf   restart / loader stub

The boot and stub images overlap in guest address space but contain different code. The project uses a multi-image ABI v5 and runtime byte hashes to select the correct native implementation whenever executable memory changes.

Current status

Area	Status
GMFE69 detection and ISO extraction	✅
Multi-DOL / ELF discovery	✅
Native recompilation of boot, main and stub executables	✅
Overlap-safe runtime image switching	✅
Non-stripped ELF symbol recovery	✅
Native burst / dispatcher optimizations	✅
Main menu and mission selection	✅
Gameplay	✅ experimental
Widescreen / custom FOV	✅
Configurable frame target	✅ experimental
Long-session audio / low-address reads	🚧 under investigation

The project is usable for development and gameplay testing, but it is still an experimental recompilation, not a finished compatibility release.

Highlights

• One native module for every executable image used by GMFE69.
• Runtime hash ownership for overlapping boot/stub code instead of pretending both images are identical.
• 5,665 recovered named functions from the non-stripped runtime ELF files.
• DolRecomp MAP integration so generated code keeps useful original CodeWarrior-style symbols.
• O3 by default for the generated native module.
• Native burst enabled by default only where multi-image ownership is unambiguous.
• Permanent GMFE69 post-generation optimizations through tools/gmfe69_postgen.py.
• Optional aspect ratio, FOV and FPS controls exposed directly by run.sh.
• No game-specific interpreter fallback range enabled by default.

Detailed optimization notes live in docs/GMFE69_OPTIMIZATIONS.md.

---

Recompilation launcher

The release ships a dedicated MOHFrontline-Recompiled launcher for Windows and Linux. It is separate from the generic ModernGekko/Dolphin frontend and only orchestrates this recompilation.

Portable release — no development toolchain required

The normal end-user path is:

1. download the Windows or Linux release archive;
2. extract it to a writable directory;
3. start MOHFrontline-Launcher.exe on Windows or MOHFrontline-Launcher on Linux;
4. select your legally obtained USA GMFE69 disc image;
5. press Prepare / Build recompilation;
6. press PLAY.

The release bundles the build environment required to generate the game-derived native module locally:

• CMake;
• Ninja;
• Zig;
• Python;
• DolRecomp;
• encounter/nod;
• the prebuilt ModernGekko runtime;
• the standalone launcher and disc-cache helper.

No Visual Studio, LLVM/Clang, Python, CMake or Ninja installation is required for the release package.

Supported disc-image containers through encounter/nod:

ISO / GCM
RVZ
WIA
WBFS
CISO
GCZ
TGC
NFS

The original disc is not fully extracted. The launcher creates only a small local AOT cache containing the GameCube system metadata and executable containers required by DolRecomp. At runtime the original ISO/RVZ/etc. remains the mounted game source.

disc image
   │
   ├── encounter/nod ──► minimal DOL/ELF/FST AOT cache ──► DolRecomp ──► gGMFE69_recomp
   │
   └── direct disc mount ──────────────────────────────────────────────► runtime

ModernGekko also contains a native nod-backed DiscSource / FST VFS for its native/legacy DI path. It can perform logical DI reads and file-by-path reads directly from compressed images without materializing the retail filesystem.

The launcher also provides PS3 remaster source selection. You can point it at either:

• an extracted PS3_FILES directory; or
• a finalized retail PS3 .pkg using Choose PS3 PKG.

For a PKG source, the runtime parses the package table and performs AES-CTR random-access reads directly from the package. TPK/VIV/BIG/C0FB containers can therefore feed the existing texture/material resolver without a full PKG extraction. The launcher also exposes PS3/enhanced-graphics toggles and shortcuts to the user, logs and AOT-cache folders.

The legacy SFNH font directory scanner is still directory-oriented; the new PKG path currently targets the remaster texture/material/lighting/mesh asset pipeline first.

The launcher does not contain or download the original game or PS3 assets. You provide your own legally obtained files.

Developer build

The following section is for contributors building the runtime itself from source. Release users do not need these dependencies.

1. Clone

git clone <your-repository-url>
cd MOHFrontline-GC-RECOMP

2. Install build dependencies

For a source/developer build on 64-bit Linux, you need at least:

• CMake 3.20+
• Ninja
• Python 3
• GCC or Clang
• pkg-config
• a working Vulkan driver/runtime
• Wayland development files and protocols
• libxkbcommon

On Arch Linux, a typical starting point is:

sudo pacman -S --needed \
  base-devel cmake ninja python pkgconf clang \
  wayland wayland-protocols libxkbcommon vulkan-icd-loader

ModernGekko/Dolphin may request additional development packages depending on your distribution and enabled host features. X11 is disabled by default in this project.

3. Add your own game

Put your legally obtained USA GMFE69 ISO in:

iso/MOH-FRONTLINE-USA.iso

The filename is only a convenience. If exactly one .iso exists in iso/, build.sh will use it automatically.

You can also point directly to a dump elsewhere:

ISO=/path/to/your/Medal-of-Honor-Frontline-USA.iso ./build.sh

If you already have an extracted GameCube filesystem, place it under extracted/ instead:

extracted/
├── sys/
│   ├── boot.bin
│   └── main.dol
└── files/
    ├── Moh2BootRel.dol
    ├── Moh2RelGC.elf
    ├── Moh2StubRelGC.elf
    └── ...

The build validates the six-character disc ID and refuses unsupported releases.

4. Build

chmod +x build.sh run.sh tools/*.sh tools/*.py
./build.sh

A clean build automatically:

1. builds a small DolRecomp ISO extractor;
2. validates and extracts your GMFE69 disc when needed;
3. configures and builds ModernGekko;
4. discovers every .dol and .elf recursively;
5. removes only exact byte-for-byte executable duplicates;
6. converts ELF load segments into address-preserving DolRecomp input;
7. recovers named ELF function symbols and creates function maps;
8. recompiles every unique executable image;
9. applies the permanent GMFE69 post-generation optimizations;
10. builds the overlap/hash tables for ABI v5;
11. links one gGMFE69_recomp.so;
12. publishes the runtime and module locally.

Generated output appears in:

runtime/moderngekko-run
module/gGMFE69_recomp.so
module/multi-image-report.json
module/symbols/

These directories are intentionally ignored by Git.

5. Run

Original game behavior:

./run.sh

Widescreen:

./run.sh --aspect 16:9

Enhanced 16:10 presentation with PS3 assets and 105° FOV:

./run.sh --aspect 1920x1200 --fov 105 --ps3-assets --enhanced-graphics

--aspect 1920x1200 sets the 16:10 aspect ratio, not the output resolution. In the live PC menu (Ctrl+F10 or <kbd>`</kbd>), select 1920×1200, 5× internal resolution and 16× AF, then configure the effects listed in Enhanced capture settings.

The optional PS3 layer reads your locally supplied assets from HD/PS3_FILES, or a directory passed with --ps3-files /path/to/PS3_FILES. These assets are not distributed in this repository.

GC baseline with original aspect/FOV and no PS3 asset layer or enhanced post-processing:

./run.sh --aspect default --fov default --no-ps3-assets --original-graphics

Ultrawide + custom FOV:

./run.sh --aspect 21:9 --fov 105

Custom frame target:

./run.sh --fps 60
./run.sh --fps 120

Everything together:

./run.sh --aspect 3440x1440 --fov 105 --fps 120

Show launcher options:

./run.sh --moh-help

With no MOH-specific options, run.sh preserves the original FOV, aspect-ratio and frame-timing behavior.

---

Runtime enhancement options

Option	Description
--aspect default	Original presentation
--aspect auto	Derive aspect from MOH_OUTPUT_SIZE or host output when available
--aspect 4:3	Original aspect
--aspect 16:10	16:10 widescreen
--aspect 16:9	16:9 widescreen
--aspect 21:9	Ultrawide
--aspect 32:9	Super-ultrawide
--aspect WIDTHxHEIGHT	Arbitrary aspect ratio
--fov N	Final horizontal FOV, 20 <= N < 179
--fps N	Target frame rate from 1 to 120
--fps 0	Remove the explicit target limiter
--ps3-assets / --no-ps3-assets	Enable / disable locally supplied PS3 assets
--ps3-files PATH	Set the local PS3 asset directory
--enhanced-graphics / --original-graphics	Enable / disable enhanced post-processing

For exact auto aspect detection under a pure Wayland session you can provide the output size yourself:

MOH_OUTPUT_SIZE=5120x1440 ./run.sh --aspect auto

[!NOTE] Higher FPS targets are experimental. Game logic and timing were authored around the original console behavior, so not every target is expected to be equally stable.

Build configuration

The normal native module is compiled at O3:

./build.sh

For debugging compiler/codegen issues:

MODULE_OPT_LEVEL=0 ./build.sh

Other useful build variables:

JOBS=8 ./build.sh
TOOLCHAIN=gcc ./build.sh
TOOLCHAIN=clang ./build.sh
RUNTIME_X11=ON ./build.sh
DOL_SHA256=<expected-main-dol-sha256> ./build.sh

The all-executable GMFE69 module currently requires the C backend.

Multi-image recompilation

For the inspected USA release, the runtime executables are approximately:

Image	Role	Generated chunks
sys/main.dol / Moh2BootRel.dol	Boot / loader	10
Moh2RelGC.elf	Main game	87
Moh2StubRelGC.elf	Restart stub	10

Moh2BootRel.dol is byte-identical to sys/main.dol, so the build records it as an alias rather than recompiling duplicate code.

The boot and stub images overlap around 0x8068..... The ABI v5 selector hashes the executable bytes currently present in guest memory and selects the corresponding native image. Unknown hashes are rejected rather than dispatched to the wrong native function.

See docs/gmfe69-executables.md for the detailed executable layout.

Recovered ELF symbols

The two runtime ELF images retain useful symbol tables:

• Moh2RelGC.elf: 5,005 named executable functions
• Moh2StubRelGC.elf: 660 named executable functions
• combined: 5,665 function symbols

Examples include:

GameLoop__Fv
LoadTheGame__Fv
InitCORE__Fi
RestartGame__Fv
AdjustAim__FR8CVector3f

After a build the symbol inventory is published under module/symbols/ as JSON, CSV, MAP and generated headers for reverse-engineering and profiling workflows.

Permanent performance work

The build carries the validated optimizations in source control; you do not need to run local patch scripts after regeneration.

Current permanent work includes:

• native cache-control and generic SPR helpers instead of interpreter fallback;
• overlap-safe unique-image native burst;
• cached chunk lookup inside burst dispatch;
• direct image dispatch without a second binary search;
• GameCube /12 timebase specialization;
• x86-64 hardware FMA target;
• GMFE69 idle-loop override at 0x80115F64;
• CP gather-pipe and blocking-loop hot-path reductions;
• hot FP-availability specialization;
• particle renderer LFD reconstruction and validated MEM1 write fast paths.

Generated-code-specific work is reapplied by:

tools/gmfe69_postgen.py

so deleting port-build/ and rebuilding does not lose those optimizations.

Failed or unproven experiments are deliberately excluded from the default build; see docs/GMFE69_OPTIMIZATIONS.md.

Inspect and profile

Inspect the executable images found in your extracted game:

./tools/inspect_game.sh

Profile a running build for 30 seconds:

./tools/profile_cpu.sh 30

For a temporary diagnostic fallback range:

STATICRECOMP_FALLBACK_RANGES=80000000-80000100 ./run.sh

No GMFE69 forced fallback range is enabled by default.

Repository layout

.
├── assets/                         README screenshots
├── docs/
│   ├── GMFE69_OPTIMIZATIONS.md
│   ├── bringup.md
│   └── gmfe69-executables.md
├── extracted/                      your extracted game; ignored
├── iso/                            your ISO; ignored
├── ModernGekko/                    runtime + Dolphin/DolRecomp sources
├── multi-module-template/          GMFE69 native-module template
├── tools/
│   ├── build_all_exec_module.py    discover / recompile / link all executables
│   ├── elf2dol.py                  ELF → address-preserving DOL container
│   ├── elf_symbols.py              recover ELF function symbols
│   ├── gmfe69_postgen.py           permanent generated-code optimizations
│   ├── inspect_game.sh
│   └── profile_cpu.sh
├── build.sh                        clean build / publish pipeline
├── run.sh                          launcher + optional PC enhancements
├── LICENSE
└── README.md

Generated locally and ignored by Git:

.cache/
build/
port-build/
module/
runtime/
user/

Clean rebuild

To verify that the repository is genuinely reproducible and does not rely on stale generated files:

rm -rf .cache build port-build module runtime user
./build.sh
./run.sh

The permanent post-generator means the GMFE69-specific generated-code optimizations are restored automatically during that clean build.

Known issues

• Long gameplay sessions can currently expose repeated low-address reads, primarily from the game's sound/timbre parsing paths. The root cause is being investigated; speculative low-memory/ARAM remapping is intentionally not included as a production workaround.
• Custom high frame targets are experimental and may expose original-engine timing assumptions.
• Linux/Wayland is the primary tested host configuration.

Legal

This project is an independent reverse-engineering/static-recompilation effort and is not affiliated with or endorsed by Electronic Arts, Nintendo, the original developers, or other rightsholders.

No original game ISO, DOL, ELF, extracted copyrighted game data, PS3 textures, PS3 fonts or other PS3 assets are distributed in this repository. Users must provide their own legally obtained game copies and assets. The screenshots demonstrate the optional PS3 asset layer; the assets themselves are not included.

License

Project code is distributed under the GNU General Public License v3.0. See LICENSE.

Third-party components under ModernGekko/ retain their own respective licenses and notices.