Known issues
Static checklist of problems we see often in setup threads. It is not a substitute for GitHub Issues when you have a reproducible engine bug.
Install & downloads
- Wrong CPU arch: Linux x86_64 vs arm64, Intel Mac vs Apple silicon — see the filename cheatsheet on Releases.
- Windows SmartScreen / AV: only accept overrides for binaries you fetched straight from an official release asset.
- Steam Deck: use the x86_64 Linux zip, not the ARM64 Linux build.
Game data
- SHA-1 mismatch: wrong region, truncated rip, or patched image — re-dump or fix the file before expecting stable play (Setup).
- Expecting Wii builds: this guide focuses on supported GameCube retail hashes unless upstream announces otherwise.
Graphics & performance
- Black screen / no render: update GPU drivers; confirm your hardware can expose D3D12, Vulkan, or Metal (see Requirements).
- Intel/Adreno quirks: more common on older integrated parts or certain phones — gather OS/GPU versions when opening an issue.