Troubleshooting & fixes
Verified workarounds for Windows Defender warnings, startup crashes, Linux font/audio issues, and controller deadzones in v0.2.0.
- Log: SuperOdysseyRecomp.log
- Dump key: F9
- Config: powermoon.ini
- Open issues: 12
Known issues & verified upstream fixes (v0.2.0)
Every symptom and workaround below is taken directly from the Simon3Sarkis/super-odyssey-pc-recomp README and GitHub issue tracker (github.com/Simon3Sarkis/super-odyssey-pc-recomp/issues):
| Symptom / Issue Number | Verified Fix or Workaround |
|---|---|
Windows Defender or SmartScreen flags SuperOdysseyRecomp.exe or extracted\odyssey_game.dll | Documented in the upstream README: neither binary is signed with a paid Microsoft code-signing certificate, and the installer invokes a bundled compiler to emit a brand-new DLL on disk. Detections ending in !ml (such as Trojan:Win32/Bearfoos.A!ml or Watacat.B!ml) are heuristic machine-learning false positives. Verify your archive’s SHA-256 on Download & SHA-256, then add your game folder to Windows Security exclusions. |
Crash with exception c0000005 (accessing 0x0000000000000008) (#4) | Null-pointer read (`0x8` struct offset) during startup or transition when `extracted/odyssey_game.dll` or `romfs` is incomplete. Confirm that your 1.0.0 or 1.4.1 dump contains a full merged `romfs` (all 11 folders from `ActionGuideData` through `SystemData`), click Reinstall in the launcher, and attach `SuperOdysseyRecomp.log` to Issue #4 if it persists. |
| Linux crash during opening cinematic at 120 FPS + audio crackling (#15, #18) | Running the experimental native 120 FPS mode during the opening cutscene on Linux can cause audio buffer underruns and a crash in the intro sequence. Switch the framerate mode to 60 FPS (or use 120 Hz Frame Interpolation) under F1 > Graphics before starting a new save. |
Linux startup error: FATAL: no usable system font substitute (#16) | Occurs on minimal Linux setups when no fallback TrueType font is found by the host font service. Install `fonts-dejavu-core` / `ttf-dejavu` or `noto-fonts` via your package manager. |
| Mouse cursor stays hidden when opening the F1 menu (#5) | When Direct Mouse Camera is enabled, press Esc instead of F1 to release cursor capture cleanly, or Alt-Tab once if using borderless fullscreen across multiple monitors (#8). |
| High RAM usage during compilation or gameplay (#7) | Compiling the lifted C shards with Zig/LLVM and loading the precompiled shader cache requires at least 8 GB of RAM (16 GB recommended). Close background browsers during the one-time Install Game step and ensure your OS swap / page file is enabled. |
| Slow camera turning on ASUS ROG Ally Z1 Extreme (#13) | The ROG Ally’s built-in XInput controller profile applies a conservative outer stick curve. Lower the Right Stick deadzone in F1 > Input or set the right stick outer threshold to 100% in Armoury Crate SE. |
| Game runs in slow motion on Steam Deck | Caused by setting the SteamOS Quick Access Menu frame limiter below 60 FPS (such as 30 or 40 FPS). Set the SteamOS frame limiter to 60 FPS or Off. |
| Changing in-game language does not persist or fails (#17) | Ensure your `romfs/LocalizedData/` folder contains all regional language subdirectories from your full dump (some trimmed dumps strip non-English `LocalizedData` folders). |
Diagnostic shortcuts & log files
| Shortcut / File | Diagnostic Function |
|---|---|
| F1 / Esc / Guide | Opens or hides the Dear ImGui top menu bar (Game, Graphics, Audio, Input, Mods, Updates). |
| F9 | Writes a single-frame diagnostic snapshot to SuperOdysseyRecomp.log for bug reports. |
SuperOdysseyRecomp.log | Main runtime log file located next to SuperOdysseyRecomp.exe (Windows) or inside your Linux data folder. |
powermoon.ini | Plain-text configuration file; delete or edit it to reset window mode, resolution scale, or experimental 120 FPS settings if the game fails to boot. |
How to reset a broken configuration or rebuild cleanly
- If an experimental graphics or 120 FPS setting causes a startup crash, open
powermoon.iniin a text editor (or deletepowermoon.ini) to return to the safe 1x 60 FPS defaults. - If a game update or interrupted build leaves
extracted/in a bad state, launchSuperOdysseyRecompwithout starting the game and click Reinstall to regenerateodyssey_game.dll(orlibodyssey_game.so) andcache/. - When filing a bug report at github.com/Simon3Sarkis/super-odyssey-pc-recomp/issues, attach
SuperOdysseyRecomp.log, state whether your dump is 1.0.0 or 1.4.1, and never upload copyrighted game files or ROMs.
Recommended PC controllers
Super Odyssey PC Recomp supports XInput and SDL2 controllers with automatic button prompt switching, plus native gyro motion controls for Cappy spin throws and downward cap throws on DualSense and Switch Pro controllers:
| Controller | Best For in Odyssey Recomp | Hardware Advantage | Link |
|---|---|---|---|
| Sony DualSense | Gyro motion throws & SDL2 HID | Built-in 6-axis gyroscope for Cappy motion throws + crisp D-pad | View on Amazon |
| GameSir Cyclone 2 | Precision 3D platforming & gyro | TMR sticks, 6-axis gyro in Switch mode, 1000 Hz wireless dongle | View on Amazon |
| 8BitDo Ultimate 2 Wireless | Windows & SteamOS dock play | Zero-drift TMR sticks, charging dock, Switch/XInput mode toggle | View on Amazon |
| Xbox Wireless Controller | Plug-and-play Windows 10/11 | Native XInput layout with instant button prompt switching | View on Amazon |
As an Amazon Associate, this site earns from qualifying purchases.
Common questions
Where is powermoon.ini located on Linux and Steam Deck?
By default it sits in ~/.local/share/super-odyssey-pc-recomp/powermoon.ini, or inside the custom SD card folder listed in ~/.config/super-odyssey-pc-recomp/data-folder.txt.
How do I fix multi-monitor fullscreen placement (Issue #8)?
Switch from Fullscreen to Windowed under F1 > Graphics, drag the window to your target monitor, and switch back to Fullscreen (with Fill window enabled if using an ultrawide display).