[{"data":1,"prerenderedAt":167},["ShallowReactive",2],{"/docs/guide/reporting-issues":3,"/docs/guide/reporting-issues-surround":156},{"id":4,"title":5,"body":6,"description":145,"extension":146,"head":147,"meta":148,"navigation":149,"path":151,"schemaOrg":147,"seo":152,"sitemap":153,"stem":154,"__hash__":155},"docs/1.docs/1.guide/5.reporting-issues.md","Reporting Issues",{"type":7,"value":8,"toc":135},"minimark",[9,13,18,21,55,59,62,72,76,82,86,89,104,112,116,119,125,128,132],[10,11,12],"p",{},"Good bug reports are faster to solve. If important information is missing, support first has to ask basic questions before the real debugging can start.",[14,15,17],"h2",{"id":16},"before-reporting","Before Reporting",[10,19,20],{},"Before opening a ticket, quickly check:",[22,23,24,33,36,43,46,49,52],"ul",{},[25,26,27,28,32],"li",{},"The resource is installed correctly and starts in ",[29,30,31],"code",{},"server.cfg",".",[25,34,35],{},"Required dependencies start before it.",[25,37,38,39,42],{},"You are not using ",[29,40,41],{},"ensure [sky_scripts]"," for Sky-Systems resources.",[25,44,45],{},"Recent config edits were checked for syntax mistakes.",[25,47,48],{},"SQL was imported if the resource needs it.",[25,50,51],{},"Old conflicting resources are stopped.",[25,53,54],{},"You can reproduce the issue after a restart.",[14,56,58],{"id":57},"what-we-need","What We Need",[10,60,61],{},"Include this information in your report:",[63,64,70],"pre",{"className":65,"code":67,"language":68,"meta":69},[66],"language-text","Resource:\nVersion:\nFramework: ESX / QBCore / Qbox\nInventory:\nTarget:\nSQL resource:\nServer artifacts version:\nOneSync enabled: yes/no\n\nWhat happened:\nWhat you expected:\nSteps to reproduce:\nConsole errors:\nF8 errors:\nRelevant config changes:\nOther resources involved:\n","text","",[29,71,67],{"__ignoreMap":69},[14,73,75],{"id":74},"example-report","Example Report",[63,77,80],{"className":78,"code":79,"language":68,"meta":69},[66],"Resource: sky_ambulancejob\nVersion: 2.18.0\nFramework: ESX\nInventory: ox_inventory\nTarget: ox_target\nSQL resource: oxmysql\nServer artifacts version: 12345\nOneSync enabled: yes\n\nWhat happened:\nWhen a player crashes into a wall and is ejected by our seatbelt script, the deathscreen says Gunshot.\n\nWhat you expected:\nIt should show a vehicle or unknown cause, not gunshot.\n\nSteps to reproduce:\n1. Enter a car.\n2. Drive into a wall at high speed.\n3. Seatbelt script ejects the player.\n4. Deathscreen opens.\n\nConsole errors:\nNo server console errors.\n\nF8 errors:\nNo F8 errors.\n\nRelevant config changes:\nVehicleImpactProtection is enabled. We use a custom seatbelt resource.\n\nOther resources involved:\ncustom_seatbelt\n",[29,81,79],{"__ignoreMap":69},[14,83,85],{"id":84},"logs","Logs",[10,87,88],{},"Send the actual error text, not only \"there is an error\". For visual or UI bugs, add a screenshot or short video.",[10,90,91,92,95,96,99,100,103],{},"If the console shows many errors at once, include the first error after the resource restart. Later errors such as ",[29,93,94],{},"Locales nil",", ",[29,97,98],{},"ToggleFeatures nil",", or ",[29,101,102],{},"table expected, got nil"," are often follow-up errors from a broken config file.",[10,105,106,107,32],{},"Send the full startup log around the first error and mention what config file you edited before the issue started. For examples, see ",[108,109,111],"a",{"href":110},"/docs/guide/common-console-errors","Common Console Errors",[14,113,115],{"id":114},"what-not-to-send","What Not To Send",[10,117,118],{},"Avoid sending only this:",[63,120,123],{"className":121,"code":122,"language":68,"meta":69},[66],"It does not work.\nFix pls.\nThere is an error.\n",[29,124,122],{"__ignoreMap":69},[10,126,127],{},"We need enough context to reproduce or understand the issue.",[14,129,131],{"id":130},"sensitive-data","Sensitive Data",[10,133,134],{},"Do not post database passwords, license keys, Tebex secret keys, Discord webhook URLs, or tokens in public channels. If support asks for sensitive data, send it only through the requested private channel.",{"title":69,"searchDepth":136,"depth":137,"links":138},1,2,[139,140,141,142,143,144],{"id":16,"depth":137,"text":17},{"id":57,"depth":137,"text":58},{"id":74,"depth":137,"text":75},{"id":84,"depth":137,"text":85},{"id":114,"depth":137,"text":115},{"id":130,"depth":137,"text":131},"What to include when reporting a bug or asking for support.","md",null,{},{"icon":150},"i-lucide-message-circle-warning","/docs/guide/reporting-issues",{"title":5,"description":145},{"loc":151},"1.docs/1.guide/5.reporting-issues","L6NTirkRnQZCDEm_41w9iQWDOG6jkVp7bAGgmzJPxUQ",[157,163],{"title":158,"path":159,"stem":160,"description":161,"icon":162,"children":-1},"Updates & Backups","/docs/guide/updates-backups","1.docs/1.guide/4.updates-backups","How to update Sky-Systems resources safely without losing your configuration.","i-lucide-refresh-cw",{"title":111,"path":110,"stem":164,"description":165,"icon":166,"children":-1},"1.docs/1.guide/6.common-console-errors","Understand frequent FiveM and Sky-Systems console errors and what they usually mean.","i-lucide-terminal",1780173461716]