Troubleshooting

Troubleshooting

Firestaff says game data is missing

Run:

firestaff --scan-data

Check that the data directory is correct in the start menu under Original Data.

Firestaff matches supported originals by hash. If a file is not recognized, it may be an unsupported version, a damaged file, or a container that needs an external extractor.

For Theron's Quest, keep the CUE file beside every referenced BIN and place the complete set under ~/.firestaff/data/theron/. An ISO is not sufficient for the record-based Track 02 loader path.

Game launches without expected intro or title animation

Required gameplay files and optional startup files are separate. A game can be launchable while optional intro/title/logo files are missing.

Put all original files from the same game release under the data directory and scan again.

Controls feel wrong

Check keyboard focus first. On Steam Deck, verify Steam Input mapping.

Default turn keys are arrow left/right, Home/End, and Q/E.

Save files are not found

Check the Firestaff config directory under ~/.firestaff/. Save locations can vary by game while compatibility work is ongoing.

Report a Bug

Open a GitHub issue and include:

• Firestaff version
• Operating system
• Game target
• What happened
• What you expected
• Whether --scan-data found the game files