ActRaiser Recompiled
ActRaiser Recompiled is a native port of ActRaiser for the Super Nintendo Entertainment System that recompiles your own cartridge dump into a standalone executable with features like widescreen rendering and layered 3D action stages.
- Type: PC port
- Game: ActRaiser
- Runs on Windows, Linux and macOS
- By DerrickGold
- Latest release v0901, 2026-11-17
- Source: https://github.com/DerrickGold/ar-recomp
README
ActRaiser Recomp
Play the full SNES ActRaiser campaign on your computer. The Builder recompiles the code from your USA ROM into a native game you can launch directly. You can keep the original look, play in widescreen, or give the action stages and towns depth with optional 3D views.

Download the Builder · Quick start · Features · Quality of life · Project status · Manual · Release notes · Build from source · AI disclosure
AI disclosure
Multiple AI coding assistants have contributed to the tools, runtime, debugging, and documentation under my direction and review.
The Builder translates the original game's code from your ROM on your computer. That generated code stays out of this repository. The widescreen renderer, 3D views, settings, and other additions are original project work.
Reverse-engineering notes
The research notes describe how the original game works. They contain no ROM-derived code and may help people working on an independent decompilation.
Progress at a glance
| Area | Status | Details |
|---|---|---|
| USA campaign | ✅ Playable end to end | Playtesting covered all six towns, all twelve acts, Death Heim, and the ending. |
| Action stage graphics | 🔵 Mostly Done | Action stages in all six lands have their own environmental effects. I'm still extending artwork for widescreen and refining Diorama backgrounds, skyboxes, and Voxel rooms. |
| Desktop platforms | ✅ Major platforms tested | Windows, Apple Silicon macOS, and Steam Deck are playable. Builds are also available for Intel macOS and desktop Linux. |
| Android | 🟡 Preview | Build and install the preview from source. See Android preview builds. |
| Localization | ✅ Available | Create, share, and install translations through the Workshop. See Language packs. |
| Regional rules | 🔵 Ready for more testing | US, Japanese, and European rules are implemented. More playtesting across campaigns and settings combinations is needed. |
| Decompilation | 🟡 In progress | I'm rewriting parts of the game in code that people can read and maintain, with the goal of matching the original behavior. |
| ActRaiser 2 | 📋 Full campaign planned | You can already import its Master from your own ActRaiser 2 (USA) ROM and play as him in the first game's stages. |
| Achievements | 📋 Planned | — |
My long-term goal is to make this the definitive way to play ActRaiser. I'm working toward separating game timing from rendering so a handheld could draw fewer frames without slowing down gameplay. I'd also like to let players travel between the two ActRaiser worlds during a campaign. A randomizer that swaps stages between games is an idea for later.
Quick start
You need your own unmodified ActRaiser (USA) cartridge dump. The Builder checks it before building. The download includes the build tools, and the build runs offline on your computer. You supply the ROM separately.
How to identify the USA ROM
| Field | Expected value |
|---|---|
| Internal title | ACTRAISER-USA |
| Size without copier header | 1,048,576 bytes (1 MiB) |
| Internal checksum | 0x83DB |
| SHA-256 | b8055844825653210d252d29a2229f9a3e7e512004e83940620173c57d8723f0 |
| SHA-1 | e8365852cc20178d42c93cd188a7ae9af45369d7 |
| CRC32 | 0xEAC3358D |
1. Download and open the Builder
Get the download for your machine from GitHub Releases.
Extract ZIP and .tar.xz downloads to a writable folder. Download names include
the release tag. These examples use v0900.
| Platform | Download | Open |
|---|---|---|
| macOS (Apple Silicon or Intel) | ActRaiserRecompBuilder-v0900-macos-arm64-portable.zip or -macos-x86_64-portable.zip | ActRaiserRecompBuilder.app |
| Windows (x64 or ARM64) | ActRaiserRecompBuilder-v0900-windows-x64-portable.zip or -windows-arm64-portable.zip | ActRaiserRecompBuilder.exe |
| Linux x64, including Steam Deck | ActRaiserRecompBuilder-v0900-linux-x64.AppImage | Open the AppImage. On Steam Deck, use Desktop Mode for a manual install. |
| Linux ARM64 | ActRaiserRecompBuilder-v0900-linux-arm64.AppImage | Open the AppImage on Ubuntu 26.04 LTS or a system that meets the Linux AppImage requirements. |
| Linux browser Builder fallback (x64 or ARM64) | ActRaiserRecompBuilder-v0900-linux-x64.tar.xz or -linux-arm64.tar.xz | Run ./run-build.sh in the extracted folder. It opens the Workshop in your browser. |
Older releases label the Linux x64 AppImage steam-deck. Keep the portable
Builder beside its .portable file. On first launch, the Builder may take a
few minutes to check and prepare its tools.
Troubleshoot Builder startup
2. Choose a game folder and build
The desktop Builder asks where to put the game. It suggests an
ActRaiserRecomp folder next to the Builder. Open Build & play, select
your USA ROM, and click Build game. You can explore the Workshop while
the build runs.

3. Play
Select Run game when the build finishes. After that, you can launch the
game directly: open ActRaiserRecomp.app on macOS, ActRaiserRecomp.exe on
Windows, or ActRaiserRecomp.AppImage on Linux and Steam Deck. On Windows,
keep the executable and the rest of the game folder together.
Press Esc or F1 on the keyboard, or L3 on your controller, to open settings. See the controls guide to change bindings.
4. Update or import an existing installation
Use Check for updates in the Builder sidebar to find newer downloads.
Important
Close the game and back up your saves/ folder before rebuilding.
Open the newer Builder and build into your existing game folder. Your saves, settings, language packs, and custom assets carry over. If the update replaces bundled Diorama scenery, it keeps a backup of your previous edits. For per-user macOS or Linux installs, replace the generated app and keep your existing data folder.
If you're moving from another installation, use Import previous
installation… in the Builder before you launch the game. On first launch,
the game checks its selected data folder for older saves. It imports an old
save automatically into Slot 1 and keeps the original files in
saves/legacy-layout/. Choose Continue to resume. See
Upgrading older saves.
5. Keep the game after building
You can keep playing without the Builder. To move a portable game, copy the
whole game folder, including any .portable file. On macOS or Linux, copying
just the game app or AppImage without that file uses per-user storage. Copy
your saves and settings separately if you're switching storage modes.
See where your game stores its data.
The game you build contains data from your ROM and is for your own use.
Features
Widescreen
See more of the stage at 16:9 or 16:10. The game draws beyond the original screen edges, so backgrounds still scroll at different speeds and enemies can appear in the extra space. Auto fits the view to your window. In action stages it adds side bars on displays wider than 16:9.
With widescreen set up, press F9 to cycle between original 4:3, raw
widescreen, and full widescreen with a separately scaled HUD.
Display shortcuts

Diorama and Voxel 3D for action stages
Open Action 3D → Scene → Action 3D to choose how the stages look:
| Mode | What you'll see |
|---|---|
| Off | The original flat view. Widescreen still works. A fresh installation starts here. |
| Diorama | Backgrounds and sprites sit on separate layers. The camera can tilt and pull back to show the space between them. |
| Voxel 3D (WIP) | Supported rooms have modeled floors, ramps, doorways, and selected objects. They keep the original artwork and gameplay. Other rooms use Diorama. |
Diorama is the default 3D option. Dynamic Cam moves with the action. Free Cam lets you orbit and zoom, and keeps the room centered when you zoom far out. Switch back to Diorama to use your saved background and layer settings. See Action 3D modes.

Voxel 3D in Northwall's ice caves.

Diorama in Aitos Act 2.
In Diorama and Voxel 3D, turn on Environmental effects to add glow and drifting dust to Death Heim's final battle. The Death Heim completion scene setting under Action 3D → Scene adds an ocean vista to the ending and works with any skybox setting. Death Heim visuals
GPU and CRT effects
Many Environmental effects work in both flat and 3D views. Watch mist drift over Bloodpool's marsh, lava light the rock in Aitos, and snow blow across Northwall. Some effects use the 3D view, including Northwall's aurora and the extra lava bubble animation in Aitos. See the stage guide.
Use Action spell lighting and Action spell particles to adjust magic effects separately from the scenery.
In Video → General, use Render resolution to choose Native or a preset from 480p to 2160p. 3D anti-aliasing smooths jagged edges: try FXAA for a lighter filter or SMAA to keep more detail around corners. 3D supersampling lets a higher preset draw above the size of the game view, then shrink the image. It takes more GPU time and uses its own filter in place of FXAA or SMAA while active. Both options start off and apply to 3D scenes, leaving the flat HUD and menus alone. See Display and scaling.
Under Video → CRT, you can add scanlines, curved glass, and a phosphor mask. Diorama also offers depth of field, rim lighting, and optional frame interpolation for smoother motion on high refresh rate displays.

3D simulation towns
Tilt the town map and see hills, buildings, and bridges rise from the ground. You can still place buildings and aim miracles in the tilted view. The optional 3D church shows the town through its windows during audiences and offerings.

3D world navigation
Fly the Sky Palace over a globe with mountains, clouds, and the towns you've built. You can turn the camera and zoom in for a closer look. The original menus still handle travel and town entry. With Sky Palace globe backdrop enabled, you can also see the globe behind the Palace pillars and menus. See the camera controls.

Live authentic comparison
Bind Compare rendering under Settings → Controls. A quick press switches to or from the original SNES picture and sound. Hold the button to see the original picture as an inset while you keep playing in the enhanced view. Hold it again to close the inset.
Under Video → General, you can move the inset to any corner. On desktop, PiP separate window puts it in its own window. Resize it or make it fullscreen on a second monitor. Close that window to return to the inset. See comparison controls.

Separate window. Enhanced gameplay on the left and the original SNES view on the right.
See the picture-in-picture example

Quality of life
Gameplay and town menus
Boss rush, character switching, and town menu options
| Feature | What you can do |
|---|---|
| Death Heim boss roster | Before the final boss, fight the six Act 2 bosses, swap in the six Act 1 bosses, or take on all twelve. Boss rush guide |
| Death Heim boss order | Shuffle the selected roster with a seed saved to your campaign. Find the controls under Randomizer → Bosses after enabling debug settings. Boss order settings |
| ActRaiser 2 Master | Switch characters during an ActRaiser stage after importing the winged Master from your own ActRaiser 2 (USA) ROM. Import instructions |
| Remember last town | Start over the last town you visited when you choose Continue. This is on by default. |
| Bridge-free limit | Keep completed bridges out of the 128-structure cap, including in existing towns. Bridges still let people cross and support 32 residents each. |
| Native menu quick use | Skip optional explanations when you choose Use in the original town menu. Confirmations and outcomes still play as usual. Town menu guide |
| Modern town menu | Browse town commands by category and return to your last selection. Works in flat and 3D towns. Modern SIM menu |
| Describe menu item | Use a rebindable control to read a command without using it in the modern menu, or run the full original flow when Native menu quick use is on. |
| Town menu size | Scale the modern town menu independently from 50% to 100%. |
| Pause | Press P or bind a controller button to pause and resume. |
| Turbo multiplier | Toggle fast-forward with T or a controller binding. Choose 2–64 game frames per rendered frame. The default is 8. |
| Correct Aitos messages | Prevent overlapping events from showing the wrong town message. |
| Wind stops every windmill | Keep newly built windmills still during Aitos's no-wind event in the enhanced town view. |
Find the boss roster, character switch, bridge limit, last-town option, quick use, and turbo speed under System → Game → Quality of life. The same menu has a section for fixes to the original game. Enhancements
Controls and interface
Controller bindings, twin-stick shooting, and camera controls
| Feature | What you can do |
|---|---|
| Rebindable controls | Set keyboard and gamepad bindings separately. Keyboard bindings follow physical key positions when you change layouts. |
| Gamepad selection | Pick a connected pad or follow the first connected pad as devices are plugged in and unplugged. Use gamecontrollerdb.txt to add SDL controller mappings. |
| Controller shortcuts | Bind settings, pause, fast-forward, camera reset, and rendering comparison to controller buttons. |
| Stick as D-pad | Use the left stick for digital movement and adjust how far it must move before it counts as a direction. |
| Analog angel movement | Fly in any direction in towns, vary speed with the left stick, and adjust the angel's own deadzone. |
| Twin-stick shooting | Bind Shoot up, Shoot down, Shoot left, and Shoot right to fire independently of movement in towns. |
| Camera controls | Orbit with the right stick or right-drag, zoom with triggers or the wheel, and recenter with R3 or middle-click. Adjust sensitivity, deadzone, and vertical inversion. |
| Free Cam framing | Keep manually controlled action scenes framed near room edges and centered when zoomed out. Camera control |
| Steam Deck controls | Use Steam Input or the built-in pad in Desktop Mode. L3 opens settings. Steam Deck controls |
| Android touch controls | Rebind the preview's on-screen buttons. They hide when a physical controller is connected. Android controls |
| Xbox One USB on macOS | Use an original Xbox One controller over USB in a macOS source build. Set AR_XBOX_USB_ROOT to the separate bridge module when configuring CMake. Build from source |
| Settings overlay | Open settings with Esc, F1, or L3, including after the ending. Changes save automatically, and you can reset defaults by section. |
| In-game manual | Install your manual through the Workshop and read it from the settings overlay. Install your own manual |
| Enhanced text | Adjust font size, choose Crisp or Smooth rendering, or give enhanced text a low-resolution pixel look. Language packs |
See the controls reference and the settings overlay guide.
Saves and recovery
Campaign slots, save editing, transfers, and backups
| Feature | What you can do |
|---|---|
| Ten campaign slots | Preview character level, completed acts, and save time. Each slot keeps its own regional rules, randomizer setup, and character name. |
| Campaign import and export | Move saved progress and campaign settings between slots or installations with a complete .arsave archive. |
| Raw saves | Import or export SRAM for emulator use or lossless INI for tools. Choose either format when creating a new slot. |
| Save editor | Inspect and edit town progress, unlocks, character stats, magic, items, and scores. Confirm changes to the active slot before applying them. |
| Automatic backups | Keep a copy of the previous campaign before the first saved edit or import in a session when backups are enabled. |
| Save recovery | See when a slot's save is missing or damaged and use Import save to restore a backup. |
| Restart in the same window | Switch slots, apply save edits and restart, or restart from the menu. Save with the Progress Log before switching slots. |
| Automatic import of older saves | The first launch in an older data folder adopts your save into Slot 1 and keeps the originals. [Upgrading o |