Skip to content

Known Issues

Jump to bottom
Daniel Nylander edited this page Aug 1, 2026 · 3 revisions

Known Issues

Known limitations and incomplete areas in Firestaff 3.0.214 (2026-08-01). For bugs and errors, see Troubleshooting.

All Games

  • Tests requiring game data: some viewport and boot tests require original game data files under ~/.firestaff/data/. These tests will fail or time out if the data is not present. This is expected and not a bug.
  • Custom presentation: the Custom rendering mode is still in progress for some games. The Original mode is the proven baseline for all games.
  • Controller mapping: in-app controller mapping is active work. Use Steam Input or OS-level controller mapping as a workaround. See Controls.

Dungeon Master

  • Music tracks: only the game-won track (C2) is proven playable. Other SONG.DAT tracks remain fail-closed pending full verification.
  • Custom camera: the Custom presentation camera and modern rendering continue to be refined.

Chaos Strikes Back

  • Amiga file compatibility: CSB Amiga files (IMG1 nibble RLE) are not interchangeable with PC files (IMG3). Only PC 3.4 files are supported.
  • Custom presentation: still being hardened.

DM2: Skullkeep

  • Authentic save data: some runtime verification requires authentic SKSAVE.DAT files. Tests targeting save round-trips may be limited without original save data.

Dungeon Master Nexus

  • Viewport rendering: Nexus viewport rendering with real Saturn assets is not yet complete. Parsing and runtime slices are proven, but full visual playback is active work.
  • No original mouse: the original Saturn game had no mouse support. Mouse input in Firestaff is a Firestaff addition, not an original feature.
  • Audio: SCSP sound processor output is being mapped to SDL3. Full audio fidelity is active work.

Theron's Quest

  • Playability hardening: Theron's Quest is playable but still being hardened. Some edge cases in progression and quest-block state may remain.
  • Track 02 CD-DA: real-media startup and Track 02 audio behavior are being finalized.
  • CUE validation: disc image format validation (CUE/BIN) is being tightened.

Build and Platform

  • GCC on macOS: do not use gcc on macOS. Use the system cc (Clang). The build is tested with Clang on macOS and GCC on Linux.
  • SDL3 availability: SDL3 may not be in all Linux distribution package managers yet. Building SDL3 from source may be required on some systems.

Clone this wiki locally