[{"data":1,"prerenderedAt":292},["ShallowReactive",2],{"/docs/scripts/sky-dj/reference/troubleshooting":3,"/docs/scripts/sky-dj/reference/troubleshooting-surround":279,"/docs/scripts/sky-dj/reference/troubleshooting-implemented-suggestions":291},{"id":4,"title":5,"body":6,"description":269,"extension":270,"head":271,"implementedSuggestions":271,"meta":272,"navigation":273,"path":274,"schemaOrg":271,"seo":275,"sitemap":276,"stem":277,"__hash__":278},"docs/1.docs/scripts/7.sky-dj/4.reference/2.troubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":259},"minimark",[9,14,80,84,146,150,218,222,243,247,250],[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",[15,85,86,128,137],{},[18,87,89,125],{"label":88},"Music is missing or silent",[90,91,92,96,107,122],"ul",{},[93,94,95],"li",{},"Check the effective delivery mode/directory, assigned playlist, loaded track and deck-ready state.",[93,97,98,102,103,106],{},[99,100,101],"strong",{},"Resource MP3:"," verify exact filenames and the owning resource's client ",[26,104,105],{},"files"," entries; restart after adding files. Linux paths are case-sensitive.",[93,108,109,112,113,116,117,121],{},[99,110,111],{},"HTTPS Opus:"," keep the complete prepared catalogue on FXServer and verify the hashed ",[26,114,115],{},".opus"," URLs, valid certificate, CORS headers and byte ranges. Follow the advanced setup and warning in ",[62,118,120],{"href":119},"/docs/scripts/sky-dj/setup/installation","Installation","; do not disable certificate validation.",[93,123,124],{},"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,126,127],{},"A browser download can succeed while CORS still blocks WebAudio.",[18,129,131],{"label":130},"Players still download music while connecting",[22,132,133,134,136],{},"A copy remains published in a FiveM client manifest. Streaming does not automatically remove MP3s or change manifests. Follow the backup and manifest-exclusion steps in ",[62,135,120],{"href":119},".",[18,138,140,143],{"label":139},"Audio crackles, drifts or transitions badly",[22,141,142],{},"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,144,145],{},"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,147,149],{"id":148},"effects-and-client-performance","Effects and client performance",[15,151,152,169,189,206],{},[18,153,155,166],{"label":154},"Flames or CO₂ do not fire",[22,156,157,158,161,162,165],{},"Trigger one device ",[99,159,160],{},"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 ",[99,163,164],{},"Automatic",". Presets intentionally preserve device OFF.",[22,167,168],{},"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,170,172,175],{"label":171},"Music Sync does not react",[22,173,174],{},"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,176,177,180,181,184,185,136],{},[99,178,179],{},"Normal clubs:"," use global Settings → Music synchronization. ",[99,182,183],{},"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,186,188],{"href":187},"/docs/scripts/sky-dj/features/lights-and-effects","Lights and effects",[18,190,192,203],{"label":191},"How do I capture an effect diagnostic?",[22,193,194,195,198,199,202],{},"Run ",[26,196,197],{},"vantisfxstats"," in client F8 ",[99,200,201],{},"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,204,205],{},"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,207,209,215],{"label":208},"The festival raises resmon time or lowers FPS",[22,210,211,214],{},[99,212,213],{},"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,216,217],{},"Include an in-game measurement and effect diagnostic. Browser previews and mock-native tests cannot prove FiveM visibility or performance.",[10,219,221],{"id":220},"boombox-and-map-checks","Boombox and map checks",[15,223,224,234],{},[18,225,227],{"label":226},"The boombox menu, range or Spotify behaves unexpectedly",[22,228,229,230,136],{},"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,231,233],{"href":232},"/docs/scripts/sky-dj/features/boombox","Boombox",[18,235,237],{"label":236},"Old map geometry or LODs remain after an update",[22,238,239,240,242],{},"Install the full updated resource, completely exit FiveM and relaunch. Check for duplicate older copies or another map editing the area. Compare with ",[26,241,28],{}," stopped; report terrain/LOD issues separately from audio.",[10,244,246],{"id":245},"support","Support",[22,248,249],{},"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.",[251,252],"u-button",{"color":253,"icon":254,"label":255,"target":256,"to":257,"variant":258},"neutral","i-simple-icons-discord","Join Discord","_blank","https://discord.gg/sky-systems","subtle",{"title":260,"searchDepth":261,"depth":262,"links":263},"",1,2,[264,265,266,267,268],{"id":12,"depth":262,"text":13},{"id":82,"depth":262,"text":83},{"id":148,"depth":262,"text":149},{"id":220,"depth":262,"text":221},{"id":245,"depth":262,"text":246},"Quick checks for UI access, music, effects, boomboxes and client performance.","md",null,{},true,"/docs/scripts/sky-dj/reference/troubleshooting",{"title":5,"description":269},{"loc":274},"1.docs/scripts/7.sky-dj/4.reference/2.troubleshooting","bdGTzi0Zb_d1Elcdm-0FmF24l94Lo4ENYsXTpcGQgNE",[280,285],{"title":281,"path":282,"stem":283,"description":284,"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":286,"path":287,"stem":288,"description":289,"icon":290,"children":-1},"Changelog","/docs/scripts/advent/changelog","1.docs/scripts/advent/1.changelog","Release notes for sky_advent.","i-lucide-history",[],1792547848233]