Repository navigation
Troubleshooting
Blizz127 edited this page Oct 7, 2026
·
2 revisions
-
Missing files: choose the folder containing
XANTH.EXEand all 90 files inDATA_FILES.txtdirectly, not a parent folder. - Hash mismatch: incomplete, changed or different-release files fail validation. Supply your own matching pinned XANBUD set.
-
No folder chooser: install
kdialog(KDE) orzenity(GNOME), or run./launch.sh /path/to/game-datafrom a terminal. - SDL2 missing: install your distribution’s runtime SDL2 package. Alpha.5 uses system SDL2; it is not bundled.
- Old Linux/glibc error: alpha.5 requires glibc 2.34 or newer.
- Black startup screen on alpha.1/alpha.2: the alpha.3 release notes report the startup fix, included in alpha.5. Try the current package and report exact output if it persists.
- Empty warp/finish entries: locally build and sweep checkpoints. Failed or missing checkpoints are skipped. No cheats or quick save/load are available.
- Controller/audio/display failure: public docs do not establish a universal fix. Report the release, exact output and reproduction steps; physical handheld and complete retail audio/display parity remain unverified.
Run from a terminal for messages. Do not attach game files or generated checkpoint saves to bug reports.
Sources checked 2026-10-07: README.md, releases/GETTING_STARTED.txt, docs/KNOWN_DIVERGENCES.md, docs/DEV_MENU.md, published v0.1.0-alpha.5 notes.