Known Issues

Known Issues

Status checked 2026-08-06. For the complete game-by-game matrix, see Game Status.

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

• Track 02 handoff: the authentic capture reaches the BIOS CD-read path, but a game-owned $E009 data read has not yet been observed.
• Record semantics: object/later-level records and bitmap/palette bindings remain bounded parser work until the handoff is proven.
• Screenshots: no Theron capture is eligible for public screenshots while the provenance gate reports no semantic loader evidence.
• CUE/BIN/ISO: validation is strict; an ISO alone does not replace the record-based Track 02 source.

The same fail-closed rule applies to all games: a parser receipt, generated asset pack, or fallback bitmap may support development diagnostics, but it is not presented as original-media parity or a public gameplay screenshot.

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.