[{"data":1,"prerenderedAt":317},["ShallowReactive",2],{"/docs/scripts/pets/reference/troubleshooting":3,"/docs/scripts/pets/reference/troubleshooting-surround":306,"/docs/scripts/pets/reference/troubleshooting-implemented-suggestions":316},{"id":4,"title":5,"body":6,"description":296,"extension":297,"head":298,"implementedSuggestions":298,"meta":299,"navigation":300,"path":301,"schemaOrg":298,"seo":302,"sitemap":303,"stem":304,"__hash__":305},"docs/1.docs/scripts/5.pets/4.reference/5.troubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":289},"minimark",[9,14,223,227,250,254,269,273,276,285],[10,11,13],"h2",{"id":12},"common-problems","Common problems",[15,16,17,39,119,136,158,164,170,188,205,211,217],"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,49,110],{"label":41},"FiveM crashes with TxdStore Pool Full",[22,43,44,45,48],{},"A crash such as ",[26,46,47],{},"TxdStore Pool Full, Size == 105500"," means the game's texture dictionary pool has run out of entries. The reported size can vary. Streamed assets from all resources share this pool.",[50,51,52,92,95],"ol",{},[53,54,55,56,59,60,63,64,80,83,84,87,88,91],"li",{},"Open the ",[26,57,58],{},"server.cfg"," executed when FXServer starts and add this line near the top, before your resource ",[26,61,62],{},"ensure"," lines:",[65,66,71],"pre",{"className":67,"code":68,"filename":58,"language":69,"meta":70,"style":70},"language-cfg shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","increase_pool_size \"TxdStore\" 6000\n","cfg","",[26,72,73],{"__ignoreMap":70},[74,75,78],"span",{"class":76,"line":77},"line",1,[74,79,68],{},[81,82],"br",{},"This adds ",[35,85,86],{},"6,000 entries"," to the pool; it does not set the total size to 6,000. If a ",[26,89,90],{},"TxdStore"," setting already exists in your startup configuration, edit that line. Multiple lines for the same pool do not add together.",[53,93,94],{},"Fully restart FXServer. Have players restart FiveM before reconnecting so their game loads the changed pool size. A resource restart alone does not apply this startup setting.",[53,96,97,98,101,102,109],{},"Check the server startup logs for ",[26,99,100],{},"increase_pool_size"," warnings. An unsupported pool name or an increase above the allowed limit is rejected. If the pool still fills, raise the existing value within the ",[103,104,108],"a",{"href":105,"rel":106},"https://gss.cfx-services.net/v1/public/pool-size-limits/fivem",[107],"nofollow","current Cfx.re limits"," and retest.",[22,111,112,113,118],{},"See the official ",[103,114,117],{"href":115,"rel":116},"https://docs.fivem.net/docs/server-manual/server-commands/#increase_pool_size-poolname-increase",[107],"FiveM command reference"," for startup and client restart requirements.",[18,120,122],{"label":121},"SQL migration or pet ownership fails",[22,123,124,125,127,128,131,132,135],{},"Check the database provider configured in ",[26,126,28],{},", SQL user privileges, and ",[26,129,130],{},"Config.AutoExecuteQuery",". When automatic pet-data migration is disabled, import the current ",[26,133,134],{},"import.sql",". Preserve existing owned-pet tables during updates.",[18,137,139],{"label":138},"The shop NPC is missing or the shop does not open",[22,140,141,142,145,146,149,150,153,154,157],{},"The shipped cashier is inside the Vinewood MLO at ",[26,143,144],{},"vector3(-169.0462, 226.0295, 92.27)",", with a 2.5 m interaction range. Confirm ",[26,147,148],{},"stream/Petshop"," is installed, check the NPC and interaction in FiveM, and inspect client F8 output. Saved ",[26,151,152],{},"/petsconfig"," shop and supplies locations override the Lua defaults; update both entries or restart and run ",[26,155,156],{},"/petsconfig import"," after reviewing other managed settings.",[18,159,161],{"label":160},"A preview dog is invisible or times out",[22,162,163],{},"Read the exact model or animation error in F8. Check that the selected breed's model loads, its streamed files are installed, and the configured preview and camera points are inside the MLO.",[18,165,167],{"label":166},"A pet purchase fails",[22,168,169],{},"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,171,173],{"label":172},"A pet item does nothing",[22,174,175,176,179,180,183,184,187],{},"Confirm its inventory ID and ",[26,177,178],{},"client.event",", the selected awake pet is nearby, and the inventory contains the required item. For ",[26,181,182],{},"ox_inventory",", the item definition must use ",[26,185,186],{},"consume = 0"," because Sky Pets removes the item after validating the action.",[18,189,191],{"label":190},"/petsconfig says there is no permission",[22,192,193,194,197,198,201,202,204],{},"Enable ",[26,195,196],{},"Config.UseIngameConfigurator"," and check the ",[26,199,200],{},"sky_pets.petsconfig"," permission through your ",[26,203,28],{}," groups. Restart after changing file-based permission settings.",[18,206,208],{"label":207},"A service-dog action is unavailable",[22,209,210],{},"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,212,214],{"label":213},"The animal form does not open",[22,215,216],{},"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,218,220],{"label":219},"A puppy is ready but still looks young",[22,221,222],{},"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,224,226],{"id":225},"diagnostic-commands","Diagnostic commands",[22,228,229,230,233,234,237,238,241,242,245,246,249],{},"Authorized staff can run ",[26,231,232],{},"/sky_pets_peddebug on",", reproduce a model or animation problem, inspect F8, then run ",[26,235,236],{},"/sky_pets_peddebug off",". ",[26,239,240],{},"/sky_pets_peddiag"," prints nearby and companion state. For a visual duel issue, use a clear level area and two clients; ",[26,243,244],{},"/petfighttest"," uses a separate NPC path and ",[26,247,248],{},"/petfightdebug"," is a local animation studio.",[10,251,253],{"id":252},"update-checklist","Update checklist",[255,256,257,260,263,266],"ul",{},[53,258,259],{},"Back up customized config files and the pet database before updating.",[53,261,262],{},"Keep the included stream/Petshop files and recheck saved shop and supplies locations.",[53,264,265],{},"Confirm inventory IDs and consume = 0 still match your provider.",[53,267,268],{},"Re-test a purchase, one consumable, pet persistence after reconnect, and a duel with two clients.",[10,270,272],{"id":271},"support","Support",[22,274,275],{},"Include the resource revision, breed, reproduction steps, and relevant server and F8 errors in a support report. Omit passwords and database credentials.",[277,278],"u-button",{"color":279,"icon":280,"label":281,"target":282,"to":283,"variant":284},"neutral","i-simple-icons-discord","Join Discord","_blank","https://discord.gg/sky-systems","subtle",[286,287,288],"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":70,"searchDepth":77,"depth":290,"links":291},2,[292,293,294,295],{"id":12,"depth":290,"text":13},{"id":225,"depth":290,"text":226},{"id":252,"depth":290,"text":253},{"id":271,"depth":290,"text":272},"Diagnose Sky Pets startup, TxdStore pool crashes, shop previews, inventory use, permissions, appearance and model issues.","md",null,{},true,"/docs/scripts/pets/reference/troubleshooting",{"title":5,"description":296},{"loc":301},"1.docs/scripts/5.pets/4.reference/5.troubleshooting","9ZT82idU632SRdMxu_NzK6OXRwuvkvVNRihMeLz1YZ0",[307,312],{"title":308,"path":309,"stem":310,"description":311,"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":313,"path":314,"stem":315,"description":70,"children":-1},"Banking","/docs/scripts/banking/banking","1.docs/scripts/banking/banking",[],1791330909767]