QuakeC Studio User guide

Troubleshooting

Play says it cannot find Quake

The Your Quake files guide opens when no game is found, or only part of one. It names what the folder holds and lacks:

The folder you choose is kept in your settings (game.folder) and used the next time.

The project opens with many errors

A mod written for FTEQCC opened in the vanilla dialect reports FTEQCC's syntax as errors. Add a quakec.toml that names the dialect, or open it from the command line with --dialect fteqcc. The starters already have one.

A warning W0402 says a file name's case differs from the file on disk. It builds on macOS and Windows but not on Linux, so fix the name in progs.src.

A save does not reach the game

The agent does not start

Where the log is

The app writes a log, which stays on your computer:

OS Folder
macOS ~/Library/Logs/QuakeC Studio
Windows %LOCALAPPDATA%\QuakeC Studio\logs
Linux ~/.local/state/quakec-studio/logs

The file is quakec-studio.log. A crash writes crash-<time>-<pid>.log beside it. Set the log.filter setting, or RUST_LOG, to debug for more detail.

Reporting a problem

File an issue at https://github.com/quakecstudio/editor/issues with what you did, what happened, and the log. Do not attach your game's files.