Common Errors

Common Errors — Tutorial Creator Troubleshooting | Quasar Store | Quasar Store

It plays every time somebody joins

Only once per character is off for that tutorial (Settings tab). Dispatch ships with it off on purpose.
Nothing can be saved: check the console for a database error.
Your framework adapter returns no identifier, so progress goes nowhere. Check getIdentifier in custom/<framework>/server.lua.

It never plays on spawn

Config.Tutorial.autoStart is off — correct if your spawn script starts it.
This character has already watched it. /resettutorial and rejoin to test.
Auto-start is waiting for a spawn screen that never reported closing. A custom spawn script must call exports['qs-tutorial']:SetSpawnBusy(false) once the player is in the world.
The live tutorial has no enabled steps.

It opens on top of the character selection

Your multicharacter or spawn resource is not one of the stock ones the tutorial listens to. Call SetSpawnBusy(true) when its screen opens and SetSpawnBusy(false) after the player spawns, or start the tutorial from the spawn script yourself — see Integrations.

Players are stuck on a step

The step waits for a click and there is no visible Continue element — or it is scoped with Shows on to another step. The Settings tab and the checklist both warn about this. Add a Continue element, or set the step to advance After a while. Typing /tutorial again always stops it.

The Skip button does nothing

Let players skip it is off for that tutorial. The element still draws in the creator so the layout can be designed, but it is inert in game.

Buildings are missing or the shot fades in on an empty world

The shot did not finish loading in time. Leave Config.Cinematic.focusStreaming on and raise streamWait (between steps) or maxStreamWait (the first shot). Very distant shots in a row stream slowest — a blend between nearby shots hides it best.

The weather or time stays changed afterwards

Check that Config.Cinematic.restoreWeather and restoreTime are on. A weather sync script then puts the server's weather back on its next tick.

A button that runs a command does nothing

The command is in Config.Actions.blockedCommands — the F8 console says a tutorial button tried to run the blocked command — or the player is not allowed to run it. The command runs exactly as if the player had typed it.

I restarted the resource during a tutorial

Handled. On stop and start, the camera is destroyed, focus is released, the player is made visible and unfrozen and the screen fades back in — nobody is left in a black void.

Message	Means
`<driver> never started`	The database resource was found but did not finish starting within 20 seconds. Nothing will be saved until a restart.
`preset "<name>" is missing from presets/`	A bundled tutorial file was deleted or renamed, or is no longer valid JSON. Restore it from the download.
`tutorial "<id>" could not be decoded`	A saved tutorial's row in `qs_tutorial_tutorials` was edited by hand and broken. It is skipped.
`there is no tutorial with the id "<id>"`	An export, command or event asked for an id that does not exist. The id is under Settings in the creator.
`there is no tutorial to play`	Nothing is live and the default could not be found. Set one live in the creator.
`the tutorial overlay never mounted`	The interface did not answer in time; focus was released. See the loading message above.

Installation and Access#

Common Errors

Installation and Access#

Playing the Tutorial#

The Creator#

Music, Video and Media#

Console Messages#