Lo que falla con más frecuencia en Crutches, qué significa realmente y qué hacer. Varios de estos casos no son errores, sino el script haciendo exactamente aquello para lo que se creó.
Instalación#
Usar el ítem de muleta no hace nada
El ítem no está en la lista de ítems de tu inventario, o no se llama exactamente
crutch. Consulta Añadir el ítem de la muleta.Tu framework se inicia después de
qs-crutchesenserver.cfg. Solo se detecta si ya está en marcha, así que mueveensure qs-crutchesdebajo de él.En qb-inventory, el ítem debe tener
useable = true.
Unknown column 'crutch_forced_until' o 'crutch_manual'
El SQL no se importó, o se importó el equivocado. ESX añade las columnas a users; QBCore y Qbox las añaden a players. Importa el archivo de tu framework desde [sql]/ y reinicia. Sin estas columnas no se guarda nada, así que las muletas se pierden en cada reconexión.
La consola está llena de líneas [DEBUG 1.0.8]
Config.Debug viene en true. Ponlo en false en config.lua y reinicia el recurso.
"API is not available. Unable to check the version."
Es inofensivo. La comprobación de actualizaciones no pudo conectar con GitHub al iniciar el servidor. El script funciona igual en cualquier caso.
La muleta y el movimiento#
El jugador cojea pero no tiene muleta en la mano
El modelo de la muleta no se carga. Comprueba que:
El recurso
crutchesestá en tu carpeta de recursos yensure crutchesva antes deensure qs-crutches.Se descargó con la cuenta de Cfx.re propietaria del recurso, en una clave de servidor vinculada a esa cuenta. Si no, está cifrado para otra persona y no se carga.
Config.CrutchModelsigue apuntando av_med_crutch01, o a un modelo que cargues tú mismo.
La muleta flota o está en el sitio equivocado
Normalmente es un ped addon con un esqueleto distinto, o un modelo de reemplazo. Ajusta pos y rot en Config.Attach poco a poco y reinicia el recurso para ver cada cambio. Consulta El prop de la muleta.
El jugador se arrastra y no puede levantarse
Es el comportamiento correcto. Un jugador con prescripción que ha perdido la muleta —por un golpe, una caída o /dropcrutch— se arrastra hasta recuperarla. La muleta está en el suelo cerca de donde cayó: arrástrate hasta ella y pulsa E. Si un script de limpieza de entidades la borró, se pone una nueva en su mano automáticamente.
No se puede recoger la muleta
Tras un golpe, la muleta no se puede recoger durante 2 segundos.
El aviso solo aparece a unos 2 metros, y no mientras el jugador sigue cayendo o en ragdoll.
Cada jugador solo puede recoger su propia muleta.
El jugador no puede correr, saltar, disparar ni abrir la rueda de armas
Es el comportamiento correcto con muletas. Todo vuelve cuando termina la prescripción. Para terminarla antes, un paramédico usa /crutchmenu → Remove crutches from player, o un script de admin llama a RemoveCrutch.
Guardado y reconexión#
Las muletas volvieron después de que el jugador se reconectara
Es el comportamiento correcto. Una prescripción se guarda en el personaje y sobrevive a desconexiones y reinicios hasta que se acaba su tiempo. Quítala con el menú de EMS o RemoveCrutch si no debería estar ahí.
Las muletas no volvieron tras reconectarse
El tiempo se acabó mientras el jugador estaba desconectado. El reloj nunca se pausa.
Faltan las columnas SQL: consulta arriba.
Tu multipersonaje carga el personaje después de que el script ya lo haya pedido. Añade una llamada de sincronización a su evento de carga — consulta Carga del personaje.
El menú de EMS#
"No permission." en /crutchmenu
El trabajo del jugador no está en Config.AllowedJobs. La lista usa el nombre interno del trabajo — ambulance, no "EMS" ni "Paramedic". Añade el tuyo y reinicia el recurso.
El menú no se abre
Si la consola F8 muestra [qs-crutches] ox_lib not loaded..., falta ox_lib o se inicia después de Crutches. Pon ensure ox_lib cerca del principio de server.cfg.
"No nearby player found"
Nearby player solo llega a 3 metros. Acércate o usa By ID con el ID de servidor del paciente.
"Invalid player." o "Invalid minutes."
El ID escrito no está conectado, o los minutos eran 0 o estaban vacíos. No se aplicó nada.
Logs e idiomas#
No se publica nada en Discord
Webhook.URL en server/webhook.lua está vacío, o el webhook se borró en Discord. Las caducidades y las muletas manuales nunca se registran: solo las aplicaciones y retiradas.
Un mensaje muestra una clave como menu_title en lugar del texto
Esa clave falta en el archivo de idioma en uso, normalmente una traducción antigua o hecha a mano. Copia la línea que falta de locales/en.lua y tradúcela.
El idioma no cambia
Config.Language debe coincidir exactamente con un nombre de archivo en locales/: jp para japonés, zh-CN para chino. Cualquier código sin archivo usa el inglés.
¿Sigues atascado? Abre un ticket e incluye tu framework e inventario, las líneas
server.cfgde Crutches y sus dependencias, y la salida de la consola del servidor conConfig.Debug = true.