Skip to content

Troubleshooting

Blizz127 edited this page Oct 7, 2026 · 2 revisions

Troubleshooting

  • Missing files: choose the folder containing XANTH.EXE and all 90 files in DATA_FILES.txt directly, 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) or zenity (GNOME), or run ./launch.sh /path/to/game-data from 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.

Clone this wiki locally