TIMMYG StudiosTroubleshooting
Symptom-based fixes for tAFK — startup errors, the camera never firing, missing music or beat sync, editor and permission problems.
Startup
| Symptom | Fix |
|---|---|
attempt to index a nil value (global 'tlib') | tLib missing or late. Use its release zip, ensure tLib first, restart — refresh does not re-order |
No such export ScanResourceFiles | tLib predates assets. Replace the folder wholesale |
| Every export returns nil | The folder is not named exactly tAFK. It is case-sensitive |
The camera never fires
Nothing happens after 30 seconds
| Check | Detail |
|---|---|
| In a vehicle? | Auto-AFK never fires on foot |
| Switched off? | /tafk → AFK System. The client logs it at start |
| An interface open? | NUI focus anywhere counts as input |
| Ragdolling? | Auto-AFK is suppressed |
| Timeout zero? | timeoutSeconds of 0 disables auto-trigger |
Enter AFK Mode does nothing
It bypasses the timer, not the gates: in a vehicle, system enabled, editor closed, not ragdolling or mid-cutscene, one sequence applying. Each refusal names itself in a toast. No toast and no fade is none of these — report it.
The camera enters, then instantly exits
Something counts as input during the fade: the camera threshold is 0.001°, so the smallest drift cancels it. With the mouse still, suspect stick drift or a resource moving the camera.
Sequences
| Symptom | Fix |
|---|---|
| Only a few sequences play | Unchecked in the editor, vehicles missing your model, or the player opted out. Shots whose camera would clip scenery are also skipped |
| One never plays for others | Scope: This model only plays on that model alone, and locks after the first save |
| A hand edit changed nothing | data.json is read once, at start. restart tAFK |
| A pack's sequences are missing | Manifest needs both tafk_config and tafk.json in files { }, keys lowercase; or another resource claimed the model |
Music and beat sync
No music during the cinematic
| Check | Detail |
|---|---|
| Player setting | /tafk → Play Music During AFK |
| Server default | Server Defaults → useMusic |
| Volume | 0.04 is very quiet; a player can sit at 0 |
| Any files? | The banner's Tracks: row has the count |
| Radio failing? | It replaces the folder, then falls back |
I added a track and it never plays
audio/ is scanned at resource start only. restart tAFK; Tracks: goes up by one.
Cuts do not land on the beat
No grid for that track yet, so shots take random lengths. Usually just wait — analysis runs in the background from 30 seconds after load. The banner reads Beats: 39 of 40 analysed, 1 queued; a changed track reads changed since it was analysed. For a better grid, run the offline analyser — Beat data.
radio unavailable (...) — falling back to local tracks
| Reason | What happened | What to do |
|---|---|---|
element | Mount would not load, or redirected to http | Open it in a browser; the setting must be the final https URL |
silent | Audio played, analyser got zeroes: no CORS | curl -I <url> for Access-Control-Allow-Origin. Absent means no browser can beat-match it |
suspended | The audio context refused to start | Usually transient; if it persists, use local tracks |
tap | The browser audio tap could not start | Report it — this should not happen |
context | No Web Audio at all | As above |
Fixed if the console prints radio: playing via worklet tap at 48000Hz, 25s behind live.
Radio plays but cuts are off the beat
Expect a few unsynced seconds around each track change. If it never syncs, raise radioDelaySeconds toward 25 — below 15 it cannot stay ahead.
Editor and permissions
| Symptom | Fix |
|---|---|
| Admin only. toast | add_ace group.admin tlib.admin allow, and put your identifier in group.admin. Checked per command, so it applies on the next run |
| "You must be in a vehicle." | Get in one |
| "Exit AFK mode first." | Press a key to leave the cinematic, then re-run |
| Keys 1–4 do nothing | A text field has focus. Click the viewport first |
I lost an unsaved sequence
A double-press discards it: Exit and a click on another row each warn once, then go through on a second press within four seconds. No recovery — press 4 first.
Still stuck
Open a ticket in Discord with the server console from resource start, the client F8 output including any red error, and your tLib and artifact versions.
AFK Cinematics
Still stuck? Support can answer it directly.
Was this page helpful?