Bring your game
1. Open Ashworld on GOG in your owned library and download the full Windows offline backup installer for the supported build (1.8.1b). Download every accompanying .bin part, if listed, and keep them beside the .exe. Use the full installer, not a patch or the Galaxy installer. 2. Run the installer on Windows and open the installed game directory. Find ashworld.dat beside the game executable. Enable file extensions in Explorer so its name is visible. 3. Copy that file unchanged into the installed port at <ports directory>/ashworld/ashworld.dat. Keep its exact name, capitalization and spaces. The Windows EXE and bundled Windows Java runtime are not needed.
Alternatively, extract your full offline installer using innoextract. Run innoextract -d extracted "your-full-offline-installer.exe", then locate ashworld.dat inside the extracted files (usually extracted/app/) and copy it to the same destination. Installer layouts vary; use Windows installation if your extractor cannot read that installer. Do not unpack or rename the game archive itself.
No game-data conversion is required on a PC or handheld. The handheld verifies the supplied archive and creates its save folders. It cannot generate the purchased game data from nothing.
Supported archive SHA-256 (ashworld.dat):
672f2ba91677d2279c1a630255eece0d09fbc9f0061b6323514689b23217446fCompare it with Get-FileHash -Algorithm SHA256 "ashworld.dat" in PowerShell, or sha256sum "ashworld.dat" on Linux. A different build needs a compatibility check.
Install the port
- Update PortMaster. Copy Ashworld.zip into its
autoinstall/folder and open PortMaster. - Allow PortMaster to download Westonpack and Java 17. An internet connection is needed if these runtimes are not installed.
- Copy the owned game files into
ashworld/as described above. Launch Ashworld from your ports menu.
Manual installation paths
1. Update PortMaster. Put Ashworld.zip in PortMaster's autoinstall/ directory, then open PortMaster to install it. Connect to the network to download Java 17 and Westonpack if they are not installed yet. 2. Copy the owned file to <ports directory>/ashworld/ashworld.dat. 3. Launch Ashworld from your firmware's ports menu.
For manual installation on muOS, extract the ZIP on your computer and copy Ashworld.sh to <SD card>/roms/PORTS/, and the ashworld/ folder to <SD card>/ports/ on the card configured as the firmware's ports location. The required file is <SD card>/ports/ashworld/ashworld.dat.
For ArkOS/dArkOS and standard ports layouts, extract the ZIP into your configured ports directory (for example /roms/ports/ or /roms2/ports/) so Ashworld.sh and ashworld/ are beside each other. Use the firmware's configured ports location; the launcher uses PortMaster's directory value. Avoid creating an extra Ashworld/ wrapper folder.
Handheld controls
| Control | Action |
|---|---|
| D-pad up | UP / Up / navigate |
| D-pad down | DOWN / Down / navigate |
| D-pad left | LEFT / Left / navigate |
| D-pad right | RIGHT / Right / navigate |
| A | X / Action / confirm |
| B | Z |
| X | TAB |
| Y | F |
| L1 | F1 |
| R1 | Z |
| L2 | O / Options |
| R2 | X / Action / confirm |
| Start | O / Options |
| Select | ESC / Back / pause |
| Left stick | Same directions as the D-pad |
| Select + Start | Exit; save through the game first |
Use the game's default keyboard bindings. Start sends O for options.
Saves & troubleshooting
Back up ashworld/saves/ before updates. Read ashworld/log.txt if startup fails. Report your device, exact firmware version, resolution and steps to reproduce, and attach the log. Test menu navigation, gameplay, audio, game speed, save/reload, suspend/resume and clean exit. Keep purchased game files private.
