Depanare

Instrumentul nu se deschide

Deschiderea rulează un flux complet de verificare. Dacă vreo verificare eșuează, vei primi o notificare care explică motivul. Parcurge următoarele puncte:

• Permisiune — dacă Config.Permission.Enabled = true, asigură-te că jucătorul îndeplinește condițiile. Pentru Type = 'ace', asigură-te că permisiunea ACE (animpos.use) este acordată folosind add_ace. Pentru Type = 'job', asigură-te că jobul jucătorului se află în Config.Permission.Jobs.
• Restricție de stare — ești blocat în timp ce ești într-un vehicul, cazi/cu o parașută, înoți (dacă este activat), ești mort, în ultimul moment sau cătușat. Notificarea îți va spune exact care este starea. Ajustează fanionul Config.Restrictions relevant dacă blocarea nu este dorită.
• Timp de așteptare (Cooldown) — după fiecare utilizare există un timp de așteptare Config.Cooldown (implicit 15 s). „Too fast! Please wait a moment.” înseamnă că timpul de așteptare este încă activ.
• Hook-ul CanUse — un Config.CanUse personalizat care returnează false va bloca deschiderea. Verifică logica personalizată de acolo.

Nu apare nicio notificare

Aceasta este aproape întotdeauna o neconcordanță de backend. Config.Notify trebuie să corespundă unui sistem de notificări care rulează efectiv:

• ox_lib — necesită ca ox_lib să fie pornit (consola va avertiza dacă este setat pe ox_lib, dar ox_lib nu rulează).
• qbcore — necesită QB-Core și evenimentul său QBCore:Notify.
• esx — necesită ESX și evenimentul său esx:showNotification.
• custom — necesită un handler funcțional în Config.CustomNotify.

O valoare invalidă va reveni automat la ox_lib și va înregistra un avertisment în consolă.

Scurtătura de taste (keybind) nu face nimic

• Confirmă că Config.Keybind.Enabled = true și Config.Keybind.Default nu este gol — maparea tastelor este înregistrată doar când ambele sunt setate.
• Maparea tastelor este înregistrată la pornirea resursei; dacă ai modificat configurația, repornește resursa.
• Verifică dacă jucătorul nu a reatribuit (sau șters) tasta din Settings → Key Bindings → FiveM. Comanda /animpos funcționează întotdeauna, indiferent de scurtătura de taste.

Textul este în limba greșită / engleză

• Setează setr ox:locale "<code>" în server.cfg (folosește setr pentru a se replica pe clienți).
• Folosește un cod acceptat: en, tr, de, fr, es, pt, ru.
• O cheie de traducere lipsă va reveni la limba engleză — verifică dacă fișierul tău de localizare are acea cheie cu exact același nume ca în en.json.

Funcțiile framework-ului nu funcționează / nu sunt detectate

• Setează Config.Framework pentru a se potrivi exact cu serverul tău (qbox, qbcore, esx sau standalone). O valoare invalidă va înregistra un avertisment în consolă.
• Restricțiile pentru mort / ultimul moment / cătușat funcționează doar pe qbox și qbcore. Pe esx și standalone, acele verificări de metadate sunt ignorate în mod intenționat — se aplică doar cele pentru vehicul / cădere / înot.
• Dacă restricțiile de metadate tot nu se declanșează pe QBox/QB-Core, este posibil ca framework-ul tău să stocheze acele câmpuri sub alte chei — ajustează Config.Restrictions.MetaKeys.

Personajul rămâne blocat înghețat sau transparent

Scriptul resetează valoarea alpha, dezgheață ped-ul și restaurează ragdoll-ul la oprirea resursei, așa că repornirea bupa-animpos va rezolva o stare de blocaj. Dacă o integrare a lăsat scalarea ped-ului pusă pe pauză, exportul de reluare este de asemenea apelat la curățare.