[{"data":1,"prerenderedAt":404},["ShallowReactive",2],{"/docs/guide/first-steps":3,"/docs/guide/first-steps-surround":393},{"id":4,"title":5,"body":6,"description":382,"extension":383,"head":384,"meta":385,"navigation":386,"path":388,"schemaOrg":384,"seo":389,"sitemap":390,"stem":391,"__hash__":392},"docs/1.docs/1.guide/1.first-steps.md","First Steps",{"type":7,"value":8,"toc":375},"minimark",[9,13,18,44,55,84,87,92,99,112,115,123,132,135,138,144,160,170,174,177,242,256,260,283,287,290,293,331,334,338,371],[10,11,12],"p",{},"This guide explains the basics we expect every server owner or developer to know before editing Sky-Systems resources. Start here if you want a quick, practical overview of configs, resources, server logs, and support reports.",[14,15,17],"h2",{"id":16},"what-you-should-know-first","What You Should Know First",[10,19,20,21,25,26,29,30,29,33,29,36,39,40,43],{},"A FiveM server is built from resources. A resource is a folder with an ",[22,23,24],"code",{},"fxmanifest.lua"," file inside it. Sky-Systems scripts are resources too, for example ",[22,27,28],{},"sky_base",", ",[22,31,32],{},"sky_jobs_base",[22,34,35],{},"sky_ambulancejob",[22,37,38],{},"sky_policejob",", or ",[22,41,42],{},"sky_mechanicjob",".",[10,45,46,47,50,51,54],{},"Your server starts resources from ",[22,48,49],{},"server.cfg"," using ",[22,52,53],{},"ensure"," lines:",[56,57,62],"pre",{"className":58,"code":59,"filename":49,"language":60,"meta":61,"style":61},"language-cfg shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","ensure sky_base\nensure sky_jobs_base\nensure sky_ambulancejob\n","cfg","",[22,63,64,72,78],{"__ignoreMap":61},[65,66,69],"span",{"class":67,"line":68},"line",1,[65,70,71],{},"ensure sky_base\n",[65,73,75],{"class":67,"line":74},2,[65,76,77],{},"ensure sky_jobs_base\n",[65,79,81],{"class":67,"line":80},3,[65,82,83],{},"ensure sky_ambulancejob\n",[10,85,86],{},"The order matters. Shared dependencies must start before scripts that use them.",[10,88,89,90,43],{},"Each Sky-Systems resource must stay in its own folder with its own ",[22,91,24],{},[10,93,94,95,98],{},"You may organize resources inside a category folder. Category folders must use square brackets, for example ",[22,96,97],{},"[sky_scripts]",". The folders inside it are still the real resources.",[10,100,101,102,105,106,108,109,111],{},"Do not start the whole category folder for Sky-Systems resources. When you use ",[22,103,104],{},"ensure [sky_scripts]",", FiveM starts the resources inside that folder alphabetically. That can break the required dependency order, because ",[22,107,28],{}," must start before ",[22,110,32],{},", and both must start before the job resources.",[10,113,114],{},"Wrong:",[56,116,121],{"className":117,"code":119,"language":120,"meta":61},[118],"language-text","resources/\n  [sky_scripts]/\n    sky_ambulancejob/\n      fxmanifest.lua\n    sky_base/\n      fxmanifest.lua\n    sky_jobs_base/\n      fxmanifest.lua\n","text",[22,122,119],{"__ignoreMap":61},[56,124,126],{"className":58,"code":125,"filename":49,"language":60,"meta":61,"style":61},"ensure [sky_scripts]\n",[22,127,128],{"__ignoreMap":61},[65,129,130],{"class":67,"line":68},[65,131,125],{},[10,133,134],{},"This starts resources alphabetically instead of in the order your scripts need.",[10,136,137],{},"Correct:",[56,139,142],{"className":140,"code":141,"language":120,"meta":61},[118],"resources/\n  [sky_scripts]/\n    sky_base/\n      fxmanifest.lua\n    sky_jobs_base/\n      fxmanifest.lua\n    sky_ambulancejob/\n      fxmanifest.lua\n",[22,143,141],{"__ignoreMap":61},[56,145,146],{"className":58,"code":59,"filename":49,"language":60,"meta":61,"style":61},[22,147,148,152,156],{"__ignoreMap":61},[65,149,150],{"class":67,"line":68},[65,151,71],{},[65,153,154],{"class":67,"line":74},[65,155,77],{},[65,157,158],{"class":67,"line":80},[65,159,83],{},[10,161,162,163,166,167,169],{},"Use category folders only to keep your ",[22,164,165],{},"resources"," folder clean. Start the actual resources one by one in ",[22,168,49],{}," so the order is clear.",[14,171,173],{"id":172},"recommended-start-order","Recommended Start Order",[10,175,176],{},"Use this general order for Sky-Systems job scripts:",[56,178,180],{"className":58,"code":179,"filename":49,"language":60,"meta":61,"style":61},"ensure oxmysql\nensure your_framework\nensure your_inventory\nensure your_target\n\nensure sky_base\nensure sky_jobs_base\n\nensure sky_ambulancejob\nensure sky_policejob\nensure sky_mechanicjob\n",[22,181,182,187,192,197,203,210,215,220,225,230,236],{"__ignoreMap":61},[65,183,184],{"class":67,"line":68},[65,185,186],{},"ensure oxmysql\n",[65,188,189],{"class":67,"line":74},[65,190,191],{},"ensure your_framework\n",[65,193,194],{"class":67,"line":80},[65,195,196],{},"ensure your_inventory\n",[65,198,200],{"class":67,"line":199},4,[65,201,202],{},"ensure your_target\n",[65,204,206],{"class":67,"line":205},5,[65,207,209],{"emptyLinePlaceholder":208},true,"\n",[65,211,213],{"class":67,"line":212},6,[65,214,71],{},[65,216,218],{"class":67,"line":217},7,[65,219,77],{},[65,221,223],{"class":67,"line":222},8,[65,224,209],{"emptyLinePlaceholder":208},[65,226,228],{"class":67,"line":227},9,[65,229,83],{},[65,231,233],{"class":67,"line":232},10,[65,234,235],{},"ensure sky_policejob\n",[65,237,239],{"class":67,"line":238},11,[65,240,241],{},"ensure sky_mechanicjob\n",[10,243,244,245,29,248,251,252,255],{},"Replace ",[22,246,247],{},"your_framework",[22,249,250],{},"your_inventory",", and ",[22,253,254],{},"your_target"," with the resources your server actually uses.",[14,257,259],{"id":258},"important-rules","Important Rules",[261,262,263,267,274,277,280],"ul",{},[264,265,266],"li",{},"Do not rename Sky-Systems resource folders. The resource name is used by exports, events, NUI callbacks, and escrow.",[264,268,269,270,273],{},"Do not edit files inside protected escrow code. Use the files in ",[22,271,272],{},"config/"," unless documentation says otherwise.",[264,275,276],{},"Always restart the resource after editing a config file.",[264,278,279],{},"Always read the server console after a restart. Most config mistakes are printed there.",[264,281,282],{},"Stop old conflicting resources when replacing them with a Sky-Systems resource.",[14,284,286],{"id":285},"common-conflicts","Common Conflicts",[10,288,289],{},"If you install a Sky-Systems replacement for an existing job system, do not run both systems at the same time.",[10,291,292],{},"Examples:",[56,294,296],{"className":58,"code":295,"filename":49,"language":60,"meta":61,"style":61},"# Stop these if you use sky_ambulancejob\n# ensure esx_ambulancejob\n# ensure qb-ambulancejob\n# ensure qbx_medical\n# ensure qbx-ambulancejob\n\nensure sky_ambulancejob\n",[22,297,298,303,308,313,318,323,327],{"__ignoreMap":61},[65,299,300],{"class":67,"line":68},[65,301,302],{},"# Stop these if you use sky_ambulancejob\n",[65,304,305],{"class":67,"line":74},[65,306,307],{},"# ensure esx_ambulancejob\n",[65,309,310],{"class":67,"line":80},[65,311,312],{},"# ensure qb-ambulancejob\n",[65,314,315],{"class":67,"line":199},[65,316,317],{},"# ensure qbx_medical\n",[65,319,320],{"class":67,"line":205},[65,321,322],{},"# ensure qbx-ambulancejob\n",[65,324,325],{"class":67,"line":212},[65,326,209],{"emptyLinePlaceholder":208},[65,328,329],{"class":67,"line":217},[65,330,83],{},[10,332,333],{},"Two resources controlling the same death, revive, garage, duty, or job logic can create bugs that look random but are caused by duplicate systems.",[14,335,337],{"id":336},"where-to-go-next","Where To Go Next",[261,339,340,347,353,359,365],{},[264,341,342],{},[343,344,346],"a",{"href":345},"/docs/guide/editing-configs","Editing Configs",[264,348,349],{},[343,350,352],{"href":351},"/docs/guide/fivem-basics","FiveM Basics",[264,354,355],{},[343,356,358],{"href":357},"/docs/guide/updates-backups","Updates & Backups",[264,360,361],{},[343,362,364],{"href":363},"/docs/guide/reporting-issues","Reporting Issues",[264,366,367],{},[343,368,370],{"href":369},"/docs/guide/common-console-errors","Common Console Errors",[372,373,374],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":61,"searchDepth":68,"depth":74,"links":376},[377,378,379,380,381],{"id":16,"depth":74,"text":17},{"id":172,"depth":74,"text":173},{"id":258,"depth":74,"text":259},{"id":285,"depth":74,"text":286},{"id":336,"depth":74,"text":337},"A practical first-read guide for FiveM server owners using Sky-Systems resources.","md",null,{},{"icon":387},"i-lucide-sparkles","/docs/guide/first-steps",{"title":5,"description":382},{"loc":388},"1.docs/1.guide/1.first-steps","m0oAJ-_8KAWHjw8azNVfVbuHVvu0IXtVJZHz7VaDeSM",[394,400],{"title":395,"path":396,"stem":397,"description":398,"icon":399,"children":-1},"Changelog","/docs/jobs/mechanicjob/changelog","1.docs/0.jobs/2.mechanicjob/6.changelog","Full change history for Sky Mechanic Job.","i-lucide-history",{"title":346,"path":345,"stem":401,"description":402,"icon":403,"children":-1},"1.docs/1.guide/2.editing-configs","Learn how to safely edit Lua config files without breaking your FiveM server.","i-lucide-sliders-horizontal",1780249285995]