Solución de problemas

La herramienta no se abre

Al abrir se ejecuta una línea de comprobación completa. Si alguna comprobación falla, recibirás una notificación explicando el motivo. Revisa lo siguiente:

• Permisos — si Config.Permission.Enabled = true, confirma que el jugador los cumple. Para Type = 'ace', asegúrate de que el ACE (animpos.use) esté concedido con add_ace. Para Type = 'job', asegúrate de que el trabajo del jugador esté en Config.Permission.Jobs.
• Restricción de estado — estás bloqueado mientras estás en un vehículo, cayendo/en paracaídas, nadando (si está habilitado), muerto, en último estado (last stand) o esposado. La notificación te indica qué estado es. Ajusta el parámetro Config.Restrictions correspondiente si el bloqueo no es deseado.
• Tiempo de espera (Cooldown) — después de cada uso hay una espera de Config.Cooldown (por defecto 15 s). "Too fast! Please wait a moment." significa que el tiempo de espera sigue activo.
• Hook CanUse — un Config.CanUse personalizado que devuelva false bloqueará la apertura. Revisa si hay lógica personalizada ahí.

No aparecen notificaciones

Esto se debe casi siempre a un desajuste en el backend. Config.Notify debe coincidir con un sistema de notificaciones que esté ejecutándose realmente:

• ox_lib — requiere que ox_lib esté iniciado (la consola advierte si está configurado en ox_lib pero ox_lib no se está ejecutando).
• qbcore — requiere QB-Core y su evento QBCore:Notify.
• esx — requiere ESX y su evento esx:showNotification.
• custom — requiere un controlador funcional en Config.CustomNotify.

Un valor no válido recurrirá por defecto a ox_lib y registrará una advertencia en la consola.

El atajo de teclado (keybind) no hace nada

• Confirma que Config.Keybind.Enabled = true y que Config.Keybind.Default no esté vacío; el mapeo de teclas solo se registra cuando ambos están configurados.
• El mapeo de teclas se registra al iniciar el recurso; si cambiaste la configuración, reinicia el recurso.
• Comprueba que el jugador no haya cambiado la asignación (o borrado la tecla) en Ajustes → Asignación de teclas → FiveM. El comando /animpos siempre funciona independientemente del atajo de teclado.

El texto está en el idioma incorrecto / en inglés

• Configura setr ox:locale "<code>" en server.cfg (usa setr para que se replique en los clientes).
• Utiliza un código compatible: en, tr, de, fr, es, pt, ru.
• Una clave de traducción faltante recurrirá al inglés por defecto; verifica que tu archivo de idioma tenga esa clave con exactamente el mismo nombre que en en.json.

Las funciones del framework no funcionan / no se detectan

• Configura Config.Framework para que coincida exactamente con tu servidor (qbox, qbcore, esx o standalone). Un valor no válido registrará una advertencia en la consola.
• Las restricciones de muerte / último estado / esposado solo funcionan en qbox y qbcore. En esx y standalone, esas comprobaciones de metadatos se omiten por diseño; solo se aplican las de vehículo / caída / natación.
• Si las restricciones de metadatos siguen sin activarse en QBox/QB-Core, es posible que tu framework almacene esos campos bajo claves diferentes; ajusta Config.Restrictions.MetaKeys.

El personaje se queda congelado o transparente

El script restablece la opacidad (alfa), descongela al ped y restaura el ragdoll al detener el recurso, por lo que reiniciar bupa-animpos soluciona un estado de bloqueo. Si alguna integración dejó pausado el escalado del ped, la exportación de reanudación también se ejecuta en la limpieza.