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.

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.

ActRaiser Recomp title screen with the optional high-resolution logo

Download the Builder · Quick start · Features · Quality of life · Project status · Manual · Release notes · Build from source · AI disclosure

Total GitHub release downloads Downloads for the latest GitHub release GitHub commits since the release tag

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

AreaStatusDetails
USA campaign✅ Playable end to endPlaytesting covered all six towns, all twelve acts, Death Heim, and the ending.
Action stage graphics🔵 Mostly DoneAction 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 testedWindows, Apple Silicon macOS, and Steam Deck are playable. Builds are also available for Intel macOS and desktop Linux.
Android🟡 PreviewBuild and install the preview from source. See Android preview builds.
Localization✅ AvailableCreate, share, and install translations through the Workshop. See Language packs.
Regional rules🔵 Ready for more testingUS, Japanese, and European rules are implemented. More playtesting across campaigns and settings combinations is needed.
Decompilation🟡 In progressI'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 plannedYou 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
FieldExpected value
Internal titleACTRAISER-USA
Size without copier header1,048,576 bytes (1 MiB)
Internal checksum0x83DB
SHA-256b8055844825653210d252d29a2229f9a3e7e512004e83940620173c57d8723f0
SHA-1e8365852cc20178d42c93cd188a7ae9af45369d7
CRC320xEAC3358D
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.

PlatformDownloadOpen
macOS (Apple Silicon or Intel)ActRaiserRecompBuilder-v0900-macos-arm64-portable.zip or -macos-x86_64-portable.zipActRaiserRecompBuilder.app
Windows (x64 or ARM64)ActRaiserRecompBuilder-v0900-windows-x64-portable.zip or -windows-arm64-portable.zipActRaiserRecompBuilder.exe
Linux x64, including Steam DeckActRaiserRecompBuilder-v0900-linux-x64.AppImageOpen the AppImage. On Steam Deck, use Desktop Mode for a manual install.
Linux ARM64ActRaiserRecompBuilder-v0900-linux-arm64.AppImageOpen 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.xzRun ./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.

The Builder after selecting a ROM, during the build, and when the game is ready

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

Bloodpool Act 2 in original 4:3 and expanded 16:9

Diorama and Voxel 3D for action stages

Open Action 3D → Scene → Action 3D to choose how the stages look:

ModeWhat you'll see
OffThe original flat view. Widescreen still works. A fresh installation starts here.
DioramaBackgrounds 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 Act 1, with a sloped ice bridge and icicles hanging from the cave ceiling

Voxel 3D in Northwall's ice caves.

Aitos Act 2 with separated layers and the moving Diorama camera

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.

Fillmore with scanlines, curved glass, and a CRT phosphor mask

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.

A tilted view of Aitos in simulation mode, with 3D buildings, cliffs, and waterways

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.

The Sky Palace flying over the globe

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.

Fillmore Act 1 in two windows, with the enhanced game on the left and the original SNES view on the right

Separate window. Enhanced gameplay on the left and the original SNES view on the right.

See the picture-in-picture example

The original 4:3 view inset over an enhanced widescreen stage

Quality of life
Gameplay and town menus
Boss rush, character switching, and town menu options
FeatureWhat you can do
Death Heim boss rosterBefore 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 orderShuffle 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 MasterSwitch characters during an ActRaiser stage after importing the winged Master from your own ActRaiser 2 (USA) ROM. Import instructions
Remember last townStart over the last town you visited when you choose Continue. This is on by default.
Bridge-free limitKeep 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 useSkip optional explanations when you choose Use in the original town menu. Confirmations and outcomes still play as usual. Town menu guide
Modern town menuBrowse town commands by category and return to your last selection. Works in flat and 3D towns. Modern SIM menu
Describe menu itemUse 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 sizeScale the modern town menu independently from 50% to 100%.
PausePress P or bind a controller button to pause and resume.
Turbo multiplierToggle fast-forward with T or a controller binding. Choose 2–64 game frames per rendered frame. The default is 8.
Correct Aitos messagesPrevent overlapping events from showing the wrong town message.
Wind stops every windmillKeep 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
FeatureWhat you can do
Rebindable controlsSet keyboard and gamepad bindings separately. Keyboard bindings follow physical key positions when you change layouts.
Gamepad selectionPick 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 shortcutsBind settings, pause, fast-forward, camera reset, and rendering comparison to controller buttons.
Stick as D-padUse the left stick for digital movement and adjust how far it must move before it counts as a direction.
Analog angel movementFly in any direction in towns, vary speed with the left stick, and adjust the angel's own deadzone.
Twin-stick shootingBind Shoot up, Shoot down, Shoot left, and Shoot right to fire independently of movement in towns.
Camera controlsOrbit 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 framingKeep manually controlled action scenes framed near room edges and centered when zoomed out. Camera control
Steam Deck controlsUse Steam Input or the built-in pad in Desktop Mode. L3 opens settings. Steam Deck controls
Android touch controlsRebind the preview's on-screen buttons. They hide when a physical controller is connected. Android controls
Xbox One USB on macOSUse 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 overlayOpen settings with Esc, F1, or L3, including after the ending. Changes save automatically, and you can reset defaults by section.
In-game manualInstall your manual through the Workshop and read it from the settings overlay. Install your own manual
Enhanced textAdjust 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
FeatureWhat you can do
Ten campaign slotsPreview character level, completed acts, and save time. Each slot keeps its own regional rules, randomizer setup, and character name.
Campaign import and exportMove saved progress and campaign settings between slots or installations with a complete .arsave archive.
Raw savesImport or export SRAM for emulator use or lossless INI for tools. Choose either format when creating a new slot.
Save editorInspect and edit town progress, unlocks, character stats, magic, items, and scores. Confirm changes to the active slot before applying them.
Automatic backupsKeep a copy of the previous campaign before the first saved edit or import in a session when backups are enabled.
Save recoverySee when a slot's save is missing or damaged and use Import save to restore a backup.
Restart in the same windowSwitch slots, apply save edits and restart, or restart from the menu. Save with the Progress Log before switching slots.
Automatic import of older savesThe first launch in an older data folder adopts your save into Slot 1 and keeps the originals. [Upgrading o