Godzilla-Save-the-Earth-Xbox-static-recompilation
Godzilla-Save-the-Earth-Xbox-static-recompilation is a native Windows port of Godzilla: Save the Earth for Xbox with widescreen and high frame rate support.
- Type: PC port
- Game: Godzilla: Save the Earth
- Runs on Windows
- By JLAgamer
- Latest release v0.2.0, 2026-11-14
- Source: https://github.com/JLAgamer/Godzilla-Save-the-Earth-Xbox-static-recompilation
README
Godzilla: Save the Earth — Xbox static recompilation
A native Windows port of the Xbox version of Godzilla: Save the Earth (2004), made by statically
recompiling the game's default.xbe into C with the xboxrecomp
toolkit and running it on a Direct3D 11 renderer.
You need your own copy of the game: a disc image or extracted files dumped from a disc you own. This
repository holds no game code or data; building from source translates your default.xbe. Release
builds contain the game's program translated to C and compiled, and read everything else (art, sound,
stages, movies) from your copy.
How to play
- Download
GodzillaSTE-Recomp-<version>-Windows-x64.zipfrom Releases and unzip it. - Drag your copy of Godzilla: Save the Earth for Xbox (USA/Europe) onto
Play.bat: the disc image (.iso,.xiso.iso) or the extracted folder withdefault.xbe. The first start unpacks the disc next to the program (about 800 MB) and remembers where it is; after that, double-clickPlay.bat. - Or let RecompLauncher install and set it up.
Windows 10/11 (64-bit) with a Direct3D 11 graphics card. Movies need ffmpeg.exe next to the program or on
PATH; without it they are skipped.
Features
- Runs natively on Windows with a D3D11 renderer for the Xbox GPU's command stream
- Higher internal resolution (up to 6x), mip-mapped 16x anisotropic filtering, borderless fullscreen
- Widescreen 16:9: a wider view at the camera (culling follows), HUD kept in shape and pinned to the corners
- Frame rate 60 / 120 / 144, at the game's own speed. Pick a rate your PC can hold: the game steps by frames, so a PC that falls short of 120 or 144 plays a little slow, as the console did when it dropped frames
- In-game Options entries: tournament mode, PlayStation or Xbox button icons (with a PlayStation controller picture), frame rate, aspect ratio, game speed
- Turbo game speed: the whole game runs 1.2x faster (a player suggestion; System Link stays at normal speed)
- Tournament mode: every monster and city unlocked, whatever the profile holds (cheats stay as you set them)
- Biollante: the cut monster (complete on the disc) gets a cell on the monster select screen
- FMV movies (intro, story, credits) decoded with ffmpeg
- System Link over the internet/LAN (the game's own Xbox LAN multiplayer, on UDP sockets)
- Texture replacement packs (drop BMPs into a folder), screenshots (F12)
Progress
Estimates from what has been checked in game so far. Overall is the average of the areas.
| Area | Done | Status |
|---|---|---|
| Boot and menus | 95% | Every menu works, including the new Options entries and the Biollante cell; they stay after returning from a match |
| Versus fights | 95% | Played on all ten city and arena stages: HUD, beams, destruction, win/lose |
| Other modes | 25% | Action's first stage plays through to its results screen; the rest of Action, Melee, Survival and Challenges have not been played through yet |
| Stages | 80% | The ten city and arena stages and the Mothership are checked in fights; the challenge stages are not |
| Graphics | 93% | Combiners, cube maps, water reflections, fog, point-sprite particles; rare effects may still be wrong. Fixed: MechaGodzilla 2 and 3's missiles now show in flight with their trails |
| Audio | 95% | Music, effects and voices sound right in play; fixed: menu crackle, corrupted voice lines and UI sounds (memory and timing bugs in the sound emulation) |
| Movies | 100% | Intro, story and credits play through ffmpeg; skipping them (GZ_MOVIES=0) is silent |
| Widescreen | 97% | Wider view with matching culling in fights and menus, HUD in the corners. Fixed: the round-end screen dims the whole picture, and the Action results screen keeps its layout. The pause menu's dimming may still cover only the middle (not rechecked) |
| High frame rate | 95% | Up to 144 fps (higher rates were too unstable in play); game speed correct at a rate the PC holds (it used to run up to 30% fast at 120/144) |
| Online (System Link) | 60% | Works between two copies on one PC; not yet tested PC to PC over the internet |
Requirements (building from source)
- Windows 10/11, a GPU with Direct3D 11
- Your own dump of Godzilla: Save the Earth (Xbox, USA/Europe) — a
.iso/.xiso.isodisc image or the extracted folder containingdefault.xbe. Tested withdefault.xbeSHA-1c2ef3448786662e5797a1d9e545b3859967c01ed; setup warns if yours differs. - Git, Python 3.10+ with
py -3 -m pip install capstone - Visual Studio 2022 or newer (Community or Build Tools) with Desktop development with C++
- Optional: ffmpeg on
PATHfor the movies (without it they are skipped)
Build
From PowerShell in the repository folder:
.\setup.ps1 -Iso "D:\dumps\Godzilla - Save the Earth.iso"
# or, for an extracted disc:
.\setup.ps1 -GameDir "D:\dumps\GodzillaSTE"
This fetches xboxrecomp v0.17.0 into third_party\, applies patches\xboxrecomp-v0.17.0.patch,
extracts the game into game\GodzillaSTE, translates default.xbe to C (several minutes), builds the
menu additions from your ControlRoom.bdl into mods\, and compiles
build\Release\godzilla_ste_recomp.exe. Re-run .\setup.ps1 with no arguments to rebuild.
If PowerShell refuses to run the script: powershell -ExecutionPolicy Bypass -File .\setup.ps1 -Iso ...
Play
Run play.bat. Controllers go through SDL3, so Xbox, PlayStation (DualSense, DualShock 4, over USB or
Bluetooth), Switch Pro and most other pads work directly, without Steam Input or DS4Windows. Without
SDL3.dll next to the program (or with RECOMP_PAD=xinput) it uses XInput as before. Pads are ignored
while another program's window is in front (RECOMP_PAD_BACKGROUND=1 reads them anyway).
-
Controller layout:
gz_controls.ini(written with comments the first time the game starts) maps every Xbox button and stick to a control of your pad by position (south,east,left_shoulder, ...), with stick deadzones and a trigger threshold. Delete it to get the defaults back. -
Options menu (last entries): Tournament mode, Button icons, Frame rate, Aspect, Game speed — saved in
gz_settings.ini, which lists every setting with a comment. The first start picks button icons from the controller plugged in. -
play.batoptions at the top: fullscreen, window size, internal resolution, texture filtering, online play, movies -
Keys: F12 screenshot (
screenshots\), F9 trace one frame into the log, F10 water reflection on/off -
Biollante: the green "?" cell at the end of the top row of the monster select screen
-
play_fight.batboots straight into a match replaying the last match you started from the menus -
Online: set
online=1(andonline_peer=<other player's IP>over the internet) ingz_settings.ini, orGZ_NET/GZ_NET_PEERinplay.bat, on both PCs, forward UDP ports 1000–1002 or use a VPN such as Tailscale/ZeroTier, then Multi-Player > System Link. Online uses tournament mode so both sides have the same roster.
Logs go to play.log next to the launcher; include it when reporting a problem.
Saves are in %LOCALAPPDATA%\GodzillaSTE. Earlier versions used the toolkit's shared
%LOCALAPPDATA%\xboxrecomp; the first start copies this game's saves from there (the old folder is left alone).
RecompLauncher and command-line options
recomplauncher.json lets RecompLauncher set the game up from your disc
image or folder and start it, with the main settings on the game's page. The same options work from
a shortcut or script (without them the program starts exactly as before, from game\GodzillaSTE):
| Option | |
|---|---|
--game <path> | Your copy: an Xbox disc image (.iso, .xiso.iso) or the extracted folder with default.xbe. A disc image is unpacked once into game\GodzillaSTE next to the program (about 800 MB). Settings, mods\, shader_cache\ and screenshots\ are then kept next to the program, and play.bat's defaults apply. |
--prepare | With --game: no window. Checks the copy (its default.xbe must be the one the program was built from), unpacks it, builds the menu additions in mods\, and exits. |
--log <file> | Writes the log there; the two before it are kept as <file>.1 and <file>.2. |
--fullscreen, --windowed | Window mode (GZ_FULLSCREEN). Started from RecompLauncher's Big Picture mode it is full screen unless you pick otherwise. |
--window-scale N, --render-scale N, --aniso N, --movies 0|1 | The same as GZ_WINDOW_SCALE, GZ_RENDER_SCALE, GZ_ANISO, GZ_MOVIES in play.bat. |
Started with --game from a folder it can write to (a RecompLauncher install), or with a portable.txt
next to the program, it keeps saves in the program's saves\ folder too. .\package.ps1 -Version 1.0.0 packs a build into
dist\GodzillaSTE-Recomp-v1.0.0-Windows-x64.zip with recomplauncher.json next to the program.
Known issues
- Not every stage and mode has been played through; the recompilation can still hit untranslated paths.
- The frame rate setting goes up to 144. The first run compiles shaders into
shader_cache\and is less smooth than later ones. - Fixed since v0.1.7: a crash at startup, while the main menu loaded, after a file had gone missing
from the game's disk cache (
%LOCALAPPDATA%\GodzillaSTE\Cache). The game rebuilds the cache itself. - Online play has been tested between two copies on one PC (including simulated lag and loss), not yet between two PCs over the internet.
How it works
src/recomp_manual.c— hand-written replacements and hooks for specific game functions (by address): frame pacing, widescreen camera, Options entries, tournament mode, Biollante, quick-fight boot, the network (XNet → Winsock) shimssrc/gpu_d3d11.c— the D3D11 back end: register combiners and vertex programs as HLSL, render targets, texture cache and replacement, widescreen presentationsrc/gz_movie.c,src/gz_net.c,src/gz_settings.c,src/gz_controls.c— movies, sockets, settings, controller layoutsrc/gz_launch.c—--game/--prepare(disc unpacking and menu additions in C), save foldersrc/gz_ach.c— achievement events when a match ends (match_won,match_won_<monster>, ...)patches/— changes to xboxrecomp this game needs (overlay folder, vertex-program export, APU mixdown, …)recomp_config/— function seeds for the lifter, the menu patch tools, and the automated test scripts used during development (bash, Git for Windows)textures_ps/— original drawings of cross/circle/square/triangle prompts and a generic controller, named after the textures they replace
Credits
- xboxrecomp by sp00nznet — the recompilation toolkit and runtime
- Capstone (disassembly), FFmpeg (movies)
- Reverse engineering, code and button artwork were produced with Claude Code (Anthropic's Claude models) directed by the project author.
- SDL3 (controllers, zlib license); Recomp Achievements (achievement events for RecompLauncher, its own license, free for games), with rcheevos and cJSON (MIT)
License
MIT for the code in this repository (see LICENSE).
Godzilla: Save the Earth is © its respective owners (Atari, Pipeworks Software, Toho). This project is not affiliated with or endorsed by them. The repository contains none of their code or assets; release builds contain the game's program code translated to C, and no game assets.