Lo que falla con más frecuencia, lo que significa realmente y qué hacer al respecto. La mayoría son problemas de configuración, no fallos, y el script indica exactamente qué rechazó, al jugador y en la consola del servidor. Cuando algo no esté claro, activa Config.Debug = true y la consola y F8 explicarán cada paso a medida que ocurre.
Instalación y acceso#
La consola del servidor se congela después de iniciar el recurso
Se renombró la carpeta. La consola muestra You have renamed the script! y luego se detiene a propósito. Detén el servidor, devuelve a la carpeta el nombre qs-lumberjack y vuelve a iniciarlo.
No hay capataz, ni blip, ni árboles
qs-lumberjack-propsno está iniciado, o se inicia después del script: los árboles y las hachas no tienen modelo. La consola muestra Drop prop … never loaded cuando ocurre esto.El framework se inicia después de
qs-lumberjacky no se detectó. Mueve suensuremás arriba.Los árboles solo existen a menos de 500 metros del aserradero. Es así por diseño.
El blip se oculta a quienes no son leñadores cuando
Config.Locations.lumberjackZoneBlip.publices false, y los blips de los árboles solo se muestran durante una misión.
"You are not allowed to open that." en /lumberjackadmin
El jugador no tiene command.lumberjack ni group.admin. Las líneas de ace en server.cfg solo se leen cuando arranca el servidor; reiniciar el recurso no basta. Escribe la línea en la consola del servidor para aplicarla ya. Comprueba también que Config.AdminPanel.Enabled sea true. Consulta Instalación.
"You are not a lumberjack"
Aceptar una misión, invitar a una cuadrilla o aceptar una invitación requiere un trabajo de Config.LumberJackJob. Dale el trabajo al jugador (en ESX se registra por ti; en QBCore y Qbox debe estar en shared/jobs.lua) o pon Config.RequireJob = false para abrir el trabajo a todos.
He editado config.lua y no ha cambiado nada
O bien el recurso no se ha reiniciado, o ese ajuste se guardó desde el panel de administración: un ajuste guardado se almacena en la base de datos y tiene prioridad sobre el archivo. Abre el panel, busca el ajuste (aparece marcado como cambiado) y pulsa Back to the file's value, y luego reinicia.
He guardado un ajuste en el panel de administración y no ha cambiado nada
Es el comportamiento correcto: los cambios guardados se aplican en el siguiente reinicio del recurso, y el panel muestra un aviso hasta entonces. Solo la pestaña Events actúa de inmediato.
Ítems y hachas#
"This item does not exist: …"
El ítem nombrado en el mensaje no está en la lista de ítems de tu inventario. La consola del servidor también lo nombra, junto con la entrada de la configuración que lo usa. Añádelo desde Ítems del inventario y reinicia el inventario. No se le quitó nada al jugador: no se cobra el hacha ni se consume el tronco.
Al comprar un hacha dice que el inventario está lleno
La mochila no tiene espacio o supera su límite de peso. El hacha se entrega antes de cobrar el dinero, así que la compra se rechazó y no se le cobró al jugador.
Usar el hacha no hace nada
ox_inventory: el ítem necesita
client = { export = 'qs-lumberjack.toggleAxe' }.qs-inventory:
['useable'] = trueyclient = { export = 'qs-lumberjack.toggleAxeQuasar' }.QBCore y ESX: el hacha debe existir como ítem cuando se inicia
qs-lumberjack, porque es entonces cuando registra los ítems usables. En QBCore también necesitauseable = true.El nombre del hacha debe coincidir exactamente con una clave de
Config.AxeLevel.
Golpear un árbol no hace nada
Colócate justo junto al tronco y mira hacia él; un golpe a cualquier otra cosa es un fallo.
Cada tipo de árbol requiere un nivel: el roble el 3 y el arce el 10; al jugador se le indica el nivel necesario.
El hacha debe estar en la mano y en el inventario; el servidor solo acepta golpes de un hacha que ve que el jugador posee.
El golpe es una asignación de teclas de FiveM en el botón izquierdo del ratón. Si el jugador la cambió, u otro recurso ocupó el botón, revisa Configuración → Asignación de teclas → FiveM.
La durabilidad del hacha se restablece al reconectar
En inventarios sin metadatos por ítem, la durabilidad se conserva durante la sesión del jugador. ox_inventory la guarda en el propio ítem, así que sobrevive a las reconexiones y es independiente para cada hacha.
La madera desapareció al pasar por encima
El inventario no tenía espacio, y se le avisó al jugador: la madera que no cabe se pierde y no da experiencia. Además, la madera pertenece al jugador que taló el árbol durante sus primeros diez segundos, y la madera no recogida desaparece a los cinco minutos.
El tajo#
"You need to have a axe in your hand"
Saca primero el hacha usándola desde el inventario y luego pulsa E en el tocón.
"You don't have any logs to chop"
Solo se pueden partir los troncos de Config.ChopWood.Drops: pine_wood, oak_wood y maple_wood. La resina, la corteza y el resto van directamente a la tienda.
Un golpe no da ningún tablón
El tablón no cabía y se devolvió el tronco, o el ítem del tablón no existe (el mensaje lo nombra). Se ignoran los golpes más rápidos que uno por segundo o a más de unos metros del tocón.
Misiones y cuadrillas#
La misión no empieza por el nivel de un miembro
Cada miembro de la cuadrilla debe cumplir el levelRequired de la misión, incluido el líder. Elige una misión más fácil o quita al miembro. El mensaje es NOT_ENOUGH_LEVEL_MEMBERS en las traducciones.
Se rechaza una invitación
Mensaje | Significa |
|---|---|
The player is too far away | A más de |
You have already invited this player | Se puede invitar al mismo jugador una vez cada 20 segundos. |
Wait a moment before sending another invitation | Una invitación por segundo. |
You are not a lumberjack | Ambas partes necesitan el trabajo. |
Una invitación aceptada dura hasta que se cierra el panel o empieza la misión. No se puede añadir a un jugador que ya está fuera con otra cuadrilla.
La misión nunca se puede terminar
Pide una madera que nadie de la cuadrilla puede talar todavía: tal como viene, Journeyman Lumberjack (nivel 4) pide arce, que requiere el nivel 10. Solo cuentan los troncos, no los tablones ni los subproductos, y tampoco cuenta la madera que no cupo en el inventario. Ajusta levelRequired o woodRequired en Config.Tasks.
Un miembro de la cuadrilla no cobró
El pago va a quien siga en la cuadrilla cuando se completa el encargo. Un miembro que abandonó, se desconectó o perdió el trabajo antes de eso ya había dejado la cuadrilla.
Las fichas de la cuadrilla muestran iniciales en lugar de caras
Solo se puede capturar la cara de un jugador lo bastante cercano para estar cargado. Los miembros más lejanos muestran sus iniciales. Es inofensivo.
Clasificaciones y eventos#
"Illegal mix of collations" en la consola
Las tablas del trabajo y las del framework usan colaciones distintas, algo habitual en MariaDB 11.4 y posteriores. El recurso las alinea al iniciarse; si no pudo, muestra la sentencia ALTER TABLE exacta para ejecutarla a mano. Ejecútala una vez y reinicia.
No se recibió un premio de la clasificación
Los premios se pagan cuando se reinicia la clasificación, a las 00:00 hora del servidor. Si el ganador está desconectado en ese momento, el premio se guarda y se paga en su siguiente inicio de sesión. Revisa la zona horaria del servidor si los reinicios ocurren a una hora inesperada.
Los torneos programados nunca empiezan
Comprueba Config.Tournaments.Enabled y que cada entrada de Schedule sea HH:MM en hora del servidor; la consola avisa de las que no lo sean. Si la consola dice que el cron de ox_lib no está disponible, actualiza ox_lib. La pestaña Events del panel de administración inicia uno de inmediato en cualquier caso.
Un torneo terminó sin pagar a nadie
Participaron menos jugadores que MinimumEntries, o nadie se llevó un árbol durante el torneo. Los premios en dinero solo van a los ganadores que estén conectados cuando termina.
Un jugador no ve las arboledas ricas ni los torneos
Con LumberjacksOnly activado, ambos solo se muestran a los jugadores que tienen un trabajo de leñador, y tampoco se benefician de ellos los demás.
Mensajes de la consola#
Las líneas que es más probable que veas de [qs-lumberjack], y qué hacer con cada una:
Mensaje | Significa |
|---|---|
| Devuelve a la carpeta el nombre |
| Añade ese ítem a tu inventario. |
| Ejecuta la sentencia ALTER que se muestra debajo. |
| Ajustes guardados por una versión anterior. Se conservan intactos; restablécelos en el panel de administración si ya no los quieres. |
| No se encontró ninguna tabla |
| oxmysql no pudo crear ni leer las tablas: revisa la conexión y los permisos del usuario de la base de datos. |
|
|
| Corrige esa hora en |
| Actualiza ox_lib. |
| Inofensivo: ese miembro de la cuadrilla está fuera de alcance, así que se muestran sus iniciales. |
¿Sigues atascado? Abre un ticket e incluye la consola del servidor desde el arranque con
Config.Debug = true, tu framework e inventario con sus versiones, y una captura de la consola F8 para cualquier cosa relacionada con la interfaz.