Risoluzione dei problemi

Lo strumento non si apre

L'apertura avvia una pipeline di controllo completa. Se un controllo fallisce, riceverai una notifica che ne spiega il motivo. Risolvi procedendo in questo modo:

• Permesso — se Config.Permission.Enabled = true, verifica che il giocatore lo superi. Per Type = 'ace', assicurati che l'ACE (animpos.use) sia assegnato con add_ace. Per Type = 'job', assicurati che il lavoro del giocatore sia presente in Config.Permission.Jobs.
• Restrizione di stato — sei bloccato se ti trovi in un veicolo, stai cadendo/paracadutandoti, stai nuotando (se abilitato), sei morto, in fin di vita o ammanettato. La notifica ti indicherà lo stato specifico. Regola il flag Config.Restrictions corrispondente se il blocco non è desiderato.
• Cooldown — dopo ogni utilizzo è prevista un'attesa Config.Cooldown (predefinita di 15 s). "Troppo veloce! Attendi un momento." significa che il cooldown è ancora attivo.
• Hook CanUse — un Config.CanUse personalizzato che restituisce false impedirà l'apertura. Controlla la logica personalizzata al suo interno.

Non compaiono notifiche

Questo è quasi sempre dovuto a una mancata corrispondenza del backend. Config.Notify deve corrispondere a un sistema di notifiche effettivamente in esecuzione:

• ox_lib — richiede che ox_lib sia avviato (la console avviserà se è impostato su ox_lib ma ox_lib non è in esecuzione).
• qbcore — richiede QB-Core e il suo evento QBCore:Notify.
• esx — richiede ESX e il suo evento esx:showNotification.
• custom — richiede un handler funzionante in Config.CustomNotify.

Un valore non valido ripiegherà su ox_lib e registrerà un avviso nella console.

Il tasto associato non fa nulla

• Conferma che Config.Keybind.Enabled = true e che Config.Keybind.Default non sia vuoto: la mappatura dei tasti viene registrata solo quando entrambi sono impostati.
• La mappatura dei tasti viene registrata all'avvio della risorsa; se hai modificato la configurazione, riavvia la risorsa.
• Controlla che il giocatore non abbia riassociato (o cancellato) il tasto in Impostazioni → Associazioni tasti → FiveM. Il comando /animpos funziona sempre indipendentemente dal tasto associato.

Il testo è nella lingua sbagliata / in inglese

• Imposta setr ox:locale "<code>" nel server.cfg (usa setr in modo che venga replicato sui client).
• Usa un codice supportato: en, tr, de, fr, es, pt, ru.
• Una chiave di traduzione mancante ripiegherà sull'inglese: verifica che il tuo file di localizzazione contenga quella chiave con esattamente lo stesso nome presente in en.json.

Funzioni del framework non funzionanti / non rilevate

• Imposta Config.Framework in modo che corrisponda esattamente al tuo server (qbox, qbcore, esx o standalone). Un valore non valido registrerà un avviso nella console.
• Le restrizioni per morto / in fin di vita / ammanettato funzionano solo su qbox e qbcore. Su esx e standalone quei controlli dei metadati vengono saltati per scelta progettuale: si applicano solo veicolo / caduta / nuoto.
• Se le restrizioni dei metadati continuano a non attivarsi su QBox/QB-Core, il tuo framework potrebbe memorizzare quei campi sotto chiavi diverse: regola Config.Restrictions.MetaKeys.

Personaggio bloccato immobile o trasparente

Lo script ripristina l'alfa, sblocca il ped e riattiva il ragdoll allo stop della risorsa, quindi riavviare bupa-animpos risolve uno stato di blocco. Se un'integrazione ha lasciato in pausa il ridimensionamento del ped, l'export di ripresa viene chiamato anche durante la pulizia.