Skip to content

Game Data

Daniel Nylander edited this page Jul 11, 2026 · 10 revisions

Game Data

Firestaff needs original game files supplied by the user.

Default data directory:

~/.firestaff/data/

Recommended layout:

~/.firestaff/data/dm1/
~/.firestaff/data/csb/
~/.firestaff/data/dm2/
~/.firestaff/data/nexus/
~/.firestaff/data/theron/

The layout is only a recommendation. Firestaff scans recursively and matches by hash, not only by file name.

Supported Containers

The scanner can find supported game files inside common containers, including:

  • ZIP-compatible archives
  • ISO/BIN/IMG-style disc images
  • CUE sheets with data tracks
  • TAR/TGZ/GZ
  • LHA/LZH stored entries
  • CHD when chdman is installed
  • several other archive and disk-image formats through available local tools

Virtual matches are materialized into Firestaff's local asset cache when a game needs ordinary files at runtime.

Required Files

DM1, CSB, and DM2 require matching graphics and dungeon files.

Nexus and Theron's Quest require their primary original media markers.

Optional title, intro, logo, and audio files are used when found.

Scan From Command Line

firestaff --scan-data
firestaff --scan-game-data
firestaff --data-dir ~/Games/FirestaffData --scan-data

The start menu also scans automatically and reports missing data before launch.

Clone this wiki locally