Bring your game
1. Open Space Grunts on GOG in your owned library and download the full Windows offline backup installer for the supported build (1.7.5). 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 spacegrunts.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>/spacegrunts/spacegrunts.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 spacegrunts.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 (spacegrunts.dat):
bf9ffdd25dd9ea58f29247bf7a48c0be6ccec513344c9623eb6ce2c506074016Compare it with Get-FileHash -Algorithm SHA256 "spacegrunts.dat" in PowerShell, or sha256sum "spacegrunts.dat" on Linux. A different build needs a compatibility check.
Install the port
- Update PortMaster. Copy SpaceGrunts.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
spacegrunts/as described above. Launch Space Grunts from your ports menu.
Manual installation paths
1. Update PortMaster. Put SpaceGrunts.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>/spacegrunts/spacegrunts.dat. 3. Launch Space Grunts from your firmware's ports menu.
For manual installation on muOS, extract the ZIP on your computer and copy Space Grunts.sh to <SD card>/roms/PORTS/, and the spacegrunts/ folder to <SD card>/ports/ on the card configured as the firmware's ports location. The required file is <SD card>/ports/spacegrunts/spacegrunts.dat.
For ArkOS/dArkOS and standard ports layouts, extract the ZIP into your configured ports directory (for example /roms/ports/ or /roms2/ports/) so Space Grunts.sh and spacegrunts/ are beside each other. Use the firmware's configured ports location; the launcher uses PortMaster's directory value. Avoid creating an extra SpaceGrunts/ 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 | ESC / Back / pause |
| X | I |
| Y | M |
| L1 | 1 |
| R1 | 2 |
| L2 | 3 |
| R2 | 4 |
| 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 spacegrunts/saves/ before updates. Read spacegrunts/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.
