[{"data":1,"prerenderedAt":236},["ShallowReactive",2],{"/docs/scripts/pets/reference/troubleshooting":3,"/docs/scripts/pets/reference/troubleshooting-surround":225,"/docs/scripts/pets/reference/troubleshooting-implemented-suggestions":235},{"id":4,"title":5,"body":6,"description":215,"extension":216,"head":217,"implementedSuggestions":217,"meta":218,"navigation":219,"path":220,"schemaOrg":217,"seo":221,"sitemap":222,"stem":223,"__hash__":224},"docs/1.docs/scripts/5.pets/4.reference/5.troubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":206},"minimark",[9,14,143,147,170,174,190,194,197],[10,11,13],"h2",{"id":12},"common-problems","Common problems",[15,16,17,39,56,78,84,90,108,125,131,137],"accordion",{},[18,19,21],"accordion-item",{"label":20},"Sky Pets does not start",[22,23,24,25,29,30,33,34,38],"p",{},"Start ",[26,27,28],"code",{},"sky_base"," first, enable OneSync, and confirm the deployed resource folder is named ",[26,31,32],{},"sky_pets",". Read the ",[35,36,37],"strong",{},"first"," server error before investigating follow-up errors.",[18,40,42],{"label":41},"SQL migration or pet ownership fails",[22,43,44,45,47,48,51,52,55],{},"Check the database provider configured in ",[26,46,28],{},", SQL user privileges, and ",[26,49,50],{},"Config.AutoExecuteQuery",". When automatic pet-data migration is disabled, import the current ",[26,53,54],{},"import.sql",". Preserve existing owned-pet tables during updates.",[18,57,59],{"label":58},"The shop NPC is missing or the shop does not open",[22,60,61,62,65,66,69,70,73,74,77],{},"The shipped cashier is inside the Vinewood MLO at ",[26,63,64],{},"vector3(-169.0462, 226.0295, 92.27)",", with a 2.5 m interaction range. Confirm ",[26,67,68],{},"stream/Petshop"," is installed, check the NPC and interaction in FiveM, and inspect client F8 output. Saved ",[26,71,72],{},"/petsconfig"," shop and supplies locations override the Lua defaults; update both entries or restart and run ",[26,75,76],{},"/petsconfig import"," after reviewing other managed settings.",[18,79,81],{"label":80},"A preview dog is invisible or times out",[22,82,83],{},"Read the exact model or animation error in F8. Verify the selected breed's model loads and renders in FiveM, the client has streamed the files, and the configured preview and camera points are inside the MLO. An asset or browser preview does not verify a streamed PED.",[18,85,87],{"label":86},"A pet purchase fails",[22,88,89],{},"Check player distance from the cashier, available breed, valid coat and collar, name length, configured payment account, and server SQL log. The server determines and validates the price; client input cannot set it.",[18,91,93],{"label":92},"A pet item does nothing",[22,94,95,96,99,100,103,104,107],{},"Confirm its inventory ID and ",[26,97,98],{},"client.event",", the selected awake pet is nearby, and the inventory contains the required item. For ",[26,101,102],{},"ox_inventory",", the item definition must use ",[26,105,106],{},"consume = 0"," because Sky Pets removes the item after validating the action.",[18,109,111],{"label":110},"/petsconfig says there is no permission",[22,112,113,114,117,118,121,122,124],{},"Enable ",[26,115,116],{},"Config.UseIngameConfigurator"," and check the ",[26,119,120],{},"sky_pets.petsconfig"," permission through your ",[26,123,28],{}," groups. Restart after changing file-based permission settings.",[18,126,128],{"label":127},"A service-dog action is unavailable",[22,129,130],{},"Check the configured framework job key, duty state, the dog's qualification, and the relevant item or scent provider. Medical actions may also require an optional medical provider.",[18,132,134],{"label":133},"The animal form does not open",[22,135,136],{},"Check the saved access grant or command permission. The player must be alive and on foot, with no other player inside the configured safety radius.",[18,138,140],{"label":139},"A puppy is ready but still looks young",[22,141,142],{},"The server settles growth every five minutes; an active ready puppy also converts on its next call. If the adult target model is missing, conversion is deferred.",[10,144,146],{"id":145},"diagnostic-commands","Diagnostic commands",[22,148,149,150,153,154,157,158,161,162,165,166,169],{},"Authorized staff can run ",[26,151,152],{},"/sky_pets_peddebug on",", reproduce a model or animation problem, inspect F8, then run ",[26,155,156],{},"/sky_pets_peddebug off",". ",[26,159,160],{},"/sky_pets_peddiag"," prints nearby and companion state. For a visual duel issue, use a clear level area and two clients; ",[26,163,164],{},"/petfighttest"," uses a separate NPC path and ",[26,167,168],{},"/petfightdebug"," is a local animation studio.",[10,171,173],{"id":172},"update-checklist","Update checklist",[175,176,177,181,184,187],"ul",{},[178,179,180],"li",{},"Back up customized config files and the pet database before updating.",[178,182,183],{},"Keep the included stream/Petshop files and recheck saved shop and supplies locations.",[178,185,186],{},"Confirm inventory IDs and consume = 0 still match your provider.",[178,188,189],{},"Re-test a purchase, one consumable, pet persistence after reconnect, and a duel with two clients.",[10,191,193],{"id":192},"support","Support",[22,195,196],{},"Include the resource revision, breed, reproduction steps, and relevant server and F8 errors in a support report. Omit passwords and database credentials.",[198,199],"u-button",{"color":200,"icon":201,"label":202,"target":203,"to":204,"variant":205},"neutral","i-simple-icons-discord","Join Discord","_blank","https://discord.gg/sky-systems","subtle",{"title":207,"searchDepth":208,"depth":209,"links":210},"",1,2,[211,212,213,214],{"id":12,"depth":209,"text":13},{"id":145,"depth":209,"text":146},{"id":172,"depth":209,"text":173},{"id":192,"depth":209,"text":193},"Diagnose Sky Pets startup, shop previews, inventory use, permissions, appearance and model issues.","md",null,{},true,"/docs/scripts/pets/reference/troubleshooting",{"title":5,"description":215},{"loc":220},"1.docs/scripts/5.pets/4.reference/5.troubleshooting","dnSNA86zN6UCtFgnw0GwiFPioiGyijHxWRUcoKpyd3M",[226,231],{"title":227,"path":228,"stem":229,"description":230,"children":-1},"Events","/docs/scripts/pets/reference/events","1.docs/scripts/5.pets/4.reference/4.events","Sky Pets local integration events, observer payloads, item-use entry points, and internal network-event boundaries.",{"title":232,"path":233,"stem":234,"description":207,"children":-1},"Banking","/docs/scripts/banking/banking","1.docs/scripts/banking/banking",[],1790206635540]