Felsökning

Verktyget öppnas inte

Öppnandet kör en komplett kontrollpipeline. Om någon kontroll misslyckas får du en avisering som förklarar varför. Gå igenom följande:

• Behörighet — om Config.Permission.Enabled = true, bekräfta att spelaren uppfyller kraven. För Type = 'ace', se till att ACE-behörigheten (animpos.use) har tilldelats med add_ace. För Type = 'job', se till att spelarens jobb finns med i Config.Permission.Jobs.
• Tillståndsbegränsning — du blockeras om du befinner dig i ett fordon, faller/hoppar fallskärm, simmar (om det är aktiverat), är död, i sista andetaget eller belagd med handfängsel. Aviseringen talar om vilket tillstånd det gäller. Justera den relevanta Config.Restrictions-flaggningen om blockeringen inte är önskad.
• Nedkylning — efter varje användning finns en väntetid på Config.Cooldown (standard 15 s). "Too fast! Please wait a moment." betyder att nedkylningen fortfarande är aktiv.
• CanUse-hook — en anpassad Config.CanUse som returnerar false blockerar öppnandet. Kontrollera om det finns anpassad logik där.

Inga aviseringar visas

Det beror nästan alltid på en backend-felmatchning. Config.Notify måste matcha ett aviseringssystem som faktiskt körs:

• ox_lib — kräver att ox_lib har startats (konsolen varnar om den är inställd på ox_lib men ox_lib inte körs).
• qbcore — kräver QB-Core och dess QBCore:Notify-event.
• esx — kräver ESX och dess esx:showNotification-event.
• custom — kräver en fungerande hanterare i Config.CustomNotify.

Ett ogiltigt värde faller tillbaka på ox_lib och loggar en varning i konsolen.

Kortkommandot gör ingenting

• Bekräfta att Config.Keybind.Enabled = true och att Config.Keybind.Default inte är tom – keymappingen registreras endast när båda är inställda.
• Keymappingen registreras när resursen startar; om du har ändrat konfigurationen, starta om resursen.
• Kontrollera att spelaren inte har binda om (eller rensat) tangenten under Inställningar → Tangentbindningar → FiveM. Kommandot /animpos fungerar alltid oavsett kortkommando.

Texten är på fel språk / engelska

• Ställ in setr ox:locale "<code>" i server.cfg (använd setr så att det replikeras till klienter).
• Använd en kod som stöds: en, tr, de, fr, es, pt, ru.
• En saknad översättningsnyckel faller tillbaka på engelska – verifiera att din lokaliseringsfil har den nyckeln med exakt samma namn som i en.json.

Framework-funktioner fungerar inte / detekteras inte

• Ställ in Config.Framework så att det matchar din server exakt (qbox, qbcore, esx eller standalone). Ett ogiltigt värde loggar en varning i konsolen.
• Begränsningarna för död / sista andetaget / handfängsel fungerar endast på qbox och qbcore. På esx och standalone hoppas dessa metadatakontroller över av design – endast fordon / fall / simning tillämpas.
• Om metadatakontrollerna fortfarande inte triggas på QBox/QB-Core kan ditt framework lagra dessa fält under andra nycklar – justera Config.Restrictions.MetaKeys.

Karaktären sitter fast i fryst läge eller är transparent

Skriptet nollställer alpha, avfryser peden och återställer ragdoll när resursen stoppas, så en omstart av bupa-animpos löser ett fastnat tillstånd. Om en integration lämnade ped-skalningen pausad anropas även återuppta-exporten vid rensning.