Troubleshooting
Troubleshooting guidance for FS-devtools.
The workbench will not open
Check FS-Lib, OneSync, fsdevtools.open and at least the intended capability. No default key is assigned; try the command and then set a personal FiveM binding.
A resource action times out
A timeout does not cancel server work. Check actual resource state and server logs before retrying. Resource actions allow up to 60 seconds for the game/server response.
Entity deletion or freezing is refused
Player peds and player-occupied vehicles are protected. Server validation also checks networked targets. Do not assume a visible entity is eligible.
Settings disappear after a restart
Personal favorites and preferences are saved locally, but snippets/output are in memory. World overrides and overlays do not automatically reactivate.
Information to include when asking for help
Record your installed resource version, the exact command/action, the symptom, the relevant config values and the matching client/server error. Remove credentials, webhook URLs and player identifiers from shared logs. Start with the symptom checks above so the report identifies which step failed.