[{"data":1,"prerenderedAt":410},["ShallowReactive",2],{"/docs/scripts/sky-dj/reference/troubleshooting":3,"/docs/scripts/sky-dj/reference/troubleshooting-surround":397,"/docs/scripts/sky-dj/reference/troubleshooting-implemented-suggestions":409},{"id":4,"title":5,"body":6,"description":387,"extension":388,"head":389,"implementedSuggestions":389,"meta":390,"navigation":391,"path":392,"schemaOrg":389,"seo":393,"sitemap":394,"stem":395,"__hash__":396},"docs/1.docs/scripts/7.sky-dj/4.reference/2.troubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":377},"minimark",[9,14,80,84,96,264,268,336,340,361,365,368],[10,11,13],"h2",{"id":12},"ui-and-access","UI and access",[15,16,17,45,51,67],"accordion",{},[18,19,21,38],"accordion-item",{"label":20},"/djadmin or another UI does not open",[22,23,24,25,29,30,33,34,37],"p",{},"Check that ",[26,27,28],"code",{},"sky_dj"," started, then read the first server/F8 error. Confirm the effective ",[26,31,32],{},"AdminCommand",", ESX group or ",[26,35,36],{},"AdminAce","; saved SQL settings may retain a different command.",[22,39,40,41,44],{},"After an update, install the complete matching runtime, including ",[26,42,43],{},"source/html/index.html"," and its hashed assets. The UI is already built; customers do not need a frontend toolchain. A mouse cursor alone does not confirm that the page loaded.",[18,46,48],{"label":47},"A DJ cannot operate a club",[22,49,50],{},"Check the assigned job, minimum grade, console distance and routing bucket. Visible controls do not bypass server permissions.",[18,52,54],{"label":53},"Config changes do not apply",[22,55,56,57,60,61,66],{},"With ",[26,58,59],{},"Config.IngameSettings = true",", saved SQL settings override the managed file values. Use the in-game editor or deliberately select file mode in ",[62,63,65],"a",{"href":64},"/docs/scripts/sky-dj/setup/configuration","Configuration",". Club/device layouts remain in SQL in either mode.",[18,68,70,73],{"label":69},"Saving reports a conflict or database error",[22,71,72],{},"For a revision conflict, reload that section and reapply your edit. For a database error, inspect the first error and stored record before retrying: a timed-out write may already have committed, and that section can remain locked until restart.",[22,74,75,76,79],{},"Back up ",[26,77,78],{},"sky_dj_state"," before updates. Do not delete settings, clubs or playlists as an installation fix.",[10,81,83],{"id":82},"music-and-audio","Music and audio",[22,85,86,87,91,92,95],{},"The project and optional on-demand delivery are ",[88,89,90],"strong",{},"EXPERIMENTAL / NOT STABLE",". Both modes use original MP3s in the same ",[26,93,94],{},"sky_dj/config/music/"," folder. They require no separate converter or music-hosting service.",[15,97,98,140,159,185,228,255],{},[18,99,101,132],{"label":100},"Music is missing or silent",[102,103,104,108,119,122,129],"ul",{},[105,106,107],"li",{},"Check the effective delivery mode/directory, assigned playlist, loaded track and deck-ready state.",[105,109,110,111,114,115,118],{},"Verify the original ",[26,112,113],{},".mp3"," exists in ",[26,116,117],{},"config/music/",", with the exact saved filename. Linux paths are case-sensitive. The catalogue accepts at most 500 files and 50 MiB per file; it does not scan nested folders or symlinks.",[105,120,121],{},"Keep the supplied optional music-pack manifest. Restart the owning resource after adding or replacing music so its pack and catalogue are rebuilt; changing the in-game delivery checkbox alone needs no restart.",[105,123,124,125,128],{},"Install matching Lua, server JavaScript and the complete built ",[26,126,127],{},"source/html/"," together. A partial update can break the transfer protocol or metadata callbacks even when the mixer opens.",[105,130,131],{},"Check deck faders, crossfader, master and speaker mute/level/range. Stand inside the speaker's listening area and check direction, room boundary and routing bucket.",[22,133,134,135,139],{},"Both modes need the original MP3 library. Do not delete saved playlists or SQL records to repair missing files. See ",[62,136,138],{"href":137},"/docs/scripts/sky-dj/setup/installation","Installation",".",[18,141,143,149,152],{"label":142},"Players still download music while connecting",[22,144,145,146,148],{},"With the supplied manifest and ",[26,147,117],{},", neither mode requests the music library automatically during connection. Normal requests the complete optional pack at first local MP3 use, including PFL. Experimental requests only songs currently needed by a deck, preview or audible club.",[22,150,151],{},"Test with a fresh-cache client outside a playing club. Spawning inside an audible club can start its music load after joining, which is different from an unconditional connection download.",[22,153,154,155,158],{},"Check for additional copies in ordinary client ",[26,156,157],{},"files",", streamed assets or another resource. Advanced published-folder overrides also cause their own connection downloads. The checkbox cannot remove those copies, cancel an already started Normal pack download or erase FiveM's existing native cache.",[18,160,162,172,175,182],{"label":161},"The deck shows DURATION LOADING or its progress stops",[22,163,164,165,168,169,139],{},"A cold Experimental track must finish transferring before duration, seeking and playback become ready. Increasing ",[88,166,167],{},"Experimental MP3: loading …%"," is progress, even when the total load takes more than 65 seconds. Each accepted block refreshes the playback reporter's inactivity timer; ",[88,170,171],{},"65 seconds is not a total download limit",[22,173,174],{},"In Normal mode, the first optional-pack download can take longer. The player waits for that mount separately, with a bounded 30-minute observation period, then allows metadata to load. The entire library may be involved, even if only one track was selected.",[22,176,177,178,181],{},"If progress stalls, inspect the first F8 and server errors. Experimental transfer checks include an opening timeout, a 45-second wait for a pending block and a 60-second idle limit; the playback reporter also rejects a player with no metadata or loading progress for 65 seconds, except while a Normal pack mount is pending. An explicit ",[88,179,180],{},"PLAYER ERROR"," needs attention; increasing volume does not repair it. Check server load, network delivery and the complete matching resource/frontend update, then try loading the track again.",[22,183,184],{},"Experimental sends original MP3 data in 48 KiB blocks, with at most four blocks ahead per transfer. These bounds and the configured per-player/global budgets do not guarantee a download time. Metadata alone starts no audio transfer.",[18,186,188,207,210],{"label":187},"Experimental transfers time out, report busy or fill the cache",[22,189,190,191,194,195,198,199,202,203,206],{},"Keep files within ",[88,192,193],{},"50 MiB"," each. ",[88,196,197],{},"Experimental cache limit"," defaults to ",[88,200,201],{},"128 MiB per player"," and accepts ",[88,204,205],{},"64–512 MiB",". Loading reserves twice the compressed file size, so a 50 MiB track needs 100 MiB of available budget before playback. Active decoder memory is additional; tracks still used by decks or PFL cannot be evicted.",[22,208,209],{},"Unload unused decks and close private previews before retrying a cache-full error. Idle compressed tracks can be evicted; this temporary NUI cache is not a persistent music folder or IndexedDB store. A busy error can occur when the bounded transfer/hash queues are full. Retry after other loads complete; increasing every limit is not proof of multiplayer capacity.",[22,211,212,213,219,220,223,224,227],{},"Experimental delivery uses FiveM's latent events. Check whether your server configuration explicitly disabled ",[62,214,218],{"href":215,"rel":216},"https://docs.fivem.net/docs/server-manual/server-commands/#sv_enableneteventreassembly-truefalse",[217],"nofollow","network-event reassembly",", which defaults to ",[26,221,222],{},"true",". If it was disabled, restore ",[26,225,226],{},"setr sv_enableNetEventReassembly true"," so server and clients enable it. This restores the required transport; it is not a speed setting. Keep event limits bounded and check your artifact version if its behaviour differs.",[18,229,231,249,252],{"label":230},"Changing the delivery mode resets loading or seems not to apply",[22,232,233,234,237,238,241,242,244,245,248],{},"Use ",[26,235,236],{},"/djadmin"," → ",[88,239,240],{},"Settings → Music & Playlists → Experimental on-demand MP3",", confirm when enabling it, and save. With ",[26,243,59],{},", SQL owns this choice; editing the managed value in ",[26,246,247],{},"config.lua"," does not replace the saved setting. Existing saved choices survive updates, while a fresh installation defaults to Normal.",[22,250,251],{},"A successful save switches loaded sources live, cancels stale transfers and requests fresh player metadata. Current tracks may need to load again; preparation or an active automatic transition is reset while tracks and queues are retained. Reload a track if its interrupted request reports cancellation. You do not need another resource, a different music folder or a restart just to switch modes.",[22,253,254],{},"Switching to Normal can start its complete optional-pack download as soon as a deck or PFL opens an MP3. Switching back to Experimental cannot undo that download or erase the native cache. Adding or replacing music files remains a separate operation that needs the owning resource restarted. Never reset SQL to change delivery modes.",[18,256,258,261],{"label":257},"Audio crackles, drifts or transitions badly",[22,259,260],{},"Start with neutral EQ, reasonable gains and an unclipped source file. Avoid unnecessary overlapping identical speakers; verify tower alignment delays, which deliberately change arrival time.",[22,262,263],{},"Compare two clients with the same track: steady playback, entering/leaving range, seek, loop and tempo changes. Note whether Main PA, booth or private PFL is affected. Shared timing cannot guarantee sample-exact playback or repair a corrupt source file.",[10,265,267],{"id":266},"effects-and-client-performance","Effects and client performance",[15,269,270,287,307,324],{},[18,271,273,284],{"label":272},"Flames or CO₂ do not fire",[22,274,275,276,279,280,283],{},"Trigger one device ",[88,277,278],{},"without music"," first. If it works but a preset does not, check the FOH's disabled-device counts and restore the relevant family or device to ",[88,281,282],{},"Automatic",". Presets intentionally preserve device OFF.",[22,285,286],{},"Device OFF and All devices off cancel a manual burst. FOH channel OFF stops its show cues, but a separately triggered test can finish its timed window.",[18,288,290,293],{"label":289},"Music Sync does not react",[22,291,292],{},"Check a ready playing track, audible deck/mix, enabled sync/channels and device ON/Automatic. Test a rhythmic passage as well as a quiet one.",[22,294,295,298,299,302,303,139],{},[88,296,297],{},"Normal clubs:"," use global Settings → Music synchronization. ",[88,300,301],{},"Festival:"," use the separate FOH → Music Sync page. Save on that FOH page to release festival manual channel ownership; a global settings save does not do this. Individual device opt-outs still remain. See ",[62,304,306],{"href":305},"/docs/scripts/sky-dj/features/lights-and-effects","Lights and effects",[18,308,310,321],{"label":309},"How do I capture an effect diagnostic?",[22,311,312,313,316,317,320],{},"Run ",[26,314,315],{},"vantisfxstats"," in client F8 ",[88,318,319],{},"during an expected burst",". This legacy-named, on-demand report shows defined/streamed/visible devices, requested/alive effects, dictionary/model waits, budget waits and native start failures.",[22,322,323],{},"Zero requested effects is normal between finite cues. Include the preset, participation counts and whether the single-device test worked; a visible prop alone does not mean emission was requested.",[18,325,327,333],{"label":326},"The festival raises resmon time or lowers FPS",[22,328,329,332],{},[88,330,331],{},"Festival grounds can increase client resmon time and GPU load."," Compare the same position with grounds disabled/enabled and effects idle/active. Check FPS too: stable resmon does not establish low GPU cost, and no fixed resmon/FPS value is guaranteed.",[22,334,335],{},"Include an in-game measurement and effect diagnostic. Browser previews and mock-native tests cannot prove FiveM visibility or performance.",[10,337,339],{"id":338},"boombox-and-map-checks","Boombox and map checks",[15,341,342,352],{},[18,343,345],{"label":344},"The boombox menu, range or Spotify behaves unexpectedly",[22,346,347,348,139],{},"The menu opens after placement is accepted. Cancelling a new placement should create no device and consume no item. Range is server-wide, with no per-device slider. Spotify Embed is personal playback, not a shared spatial stream. See ",[62,349,351],{"href":350},"/docs/scripts/sky-dj/features/boombox","Boombox",[18,353,355],{"label":354},"Old map geometry or LODs remain after an update",[22,356,357,358,360],{},"Install the full updated resource, completely exit FiveM and relaunch. Check for duplicate older copies or another map editing the area. Compare with ",[26,359,28],{}," stopped; report terrain/LOD issues separately from audio.",[10,362,364],{"id":363},"support","Support",[22,366,367],{},"Include the resource version, reproduction steps, affected track/device, delivery mode and relevant server/F8 errors. For effects, add the diagnostic above and an in-game screenshot or measurement. Omit passwords, database credentials and private URLs.",[369,370],"u-button",{"color":371,"icon":372,"label":373,"target":374,"to":375,"variant":376},"neutral","i-simple-icons-discord","Join Discord","_blank","https://discord.gg/sky-systems","subtle",{"title":378,"searchDepth":379,"depth":380,"links":381},"",1,2,[382,383,384,385,386],{"id":12,"depth":380,"text":13},{"id":82,"depth":380,"text":83},{"id":266,"depth":380,"text":267},{"id":338,"depth":380,"text":339},{"id":363,"depth":380,"text":364},"Check UI access, local MP3 delivery, experimental transfer progress, effects, boomboxes and client performance.","md",null,{},true,"/docs/scripts/sky-dj/reference/troubleshooting",{"title":5,"description":387},{"loc":392},"1.docs/scripts/7.sky-dj/4.reference/2.troubleshooting","_mIc-nkBUa8bM4WbvZvA6q96ayOi8486CCuflSdZvKA",[398,403],{"title":399,"path":400,"stem":401,"description":402,"children":-1},"Exports","/docs/scripts/sky-dj/reference/exports","1.docs/scripts/7.sky-dj/4.reference/1.exports","Client and server audio exports with signatures, short descriptions, return values and Lua examples.",{"title":404,"path":405,"stem":406,"description":407,"icon":408,"children":-1},"Changelog","/docs/scripts/sky-dj/changelog","1.docs/scripts/7.sky-dj/5.changelog","Release notes and installation steps for sky_dj.","i-lucide-history",[],1792951548860]