Lo que falla con más frecuencia, lo que significa en realidad y qué hacer al respecto. La mayoría son de configuración, no fallos, y el script indica la causa en la consola o en una notificación. Si algo no está claro, activa Config.Debug, reprodúcelo y lee la consola del servidor y F8 antes de abrir un ticket.
Instalación y arranque#
"You have renamed the script!" y la consola se congela
La carpeta no se llama qs-treasure-hunter. Es intencionado. Vuelve a ponerle su nombre, corrige la línea ensure en server.cfg y reinicia el servidor.
Usar el detector no hace nada, o F8 indica que falta el modelo 'skv_metaldetector'
qs-treasure-hunter-props no está iniciado. Añade ensure qs-treasure-hunter-props antes de ensure qs-treasure-hunter. Si el ítem no hace nada en absoluto, a la entrada del inventario le falta su client.export — consulta Instalación — o, en un inventario básico de ESX o QB, Config.RegisterUsableItemsManually está desactivado.
"This item does not exist", o la consola indica que hay un ítem configurado pero tu inventario no lo tiene
Un ítem de la configuración no está registrado en tu inventario. La línea de la consola los nombra todos, una vez. Regístralos desde items.lua, o quítalos de la configuración. El jugador conserva su progreso y su experiencia y nunca se le cobra por un ítem que no ha llegado; una caja no gasta su llave por ello.
La clasificación falla con "Illegal mix of collations"
Tu base de datos usa una collation distinta de aquella con la que se crearon las tablas: MariaDB 11.4 cambió la predeterminada. El primer arranque lo corrige por sí solo. Si el usuario de la base de datos no tiene permiso para modificar tablas, la consola muestra la sentencia ALTER TABLE exacta para ejecutarla a mano.
"Config.Vehiclekeys is set to … which no file in client/vehiclekeys/ handles"
El sistema de llaves detectado no tiene un archivo propio. Las barcas siguen apareciendo, solo que sin llaves. Añade un archivo para tu sistema como se muestra en Integraciones.
Falta el NPC
F8 muestra "Ped model … never loaded" cuando Config.StartJob.ped.model no es un ped válido. Usa el nombre de un modelo del juego base. El NPC solo aparece una vez que el framework ha cargado el personaje.
El panel y los grupos#
"You are not a treasure hunter"
Config.RequireJob está activado y el trabajo del jugador no está en Config.TreasureHunterJob. El panel sigue abriéndose para comprar y vender; solo iniciar una búsqueda y cobrarla requieren el trabajo. Cambiar de trabajo en mitad de una búsqueda la abandona con este mismo mensaje.
"Only the crew leader can do that"
El jugador sigue en el grupo de otra persona. Escribe /leavecrew y vuelve a estar solo.
"The player is too far away", o la invitación nunca llega
El jugador invitado debe estar a menos de Config.InviteDistance (20 m), debes usar su id de servidor y no puede estar ya en un grupo de dos o más. Volver a pulsar Invite sobre alguien que aún no ha respondido no hace nada; la invitación caduca a los 60 segundos.
"One of your crew is not high enough level for this hunt"
Comportamiento correcto: cada miembro, no solo el líder, necesita el levelRequired de la búsqueda. Pasa el cursor sobre la tarjeta de nivel de cada miembro para comparar.
Las fichas del grupo muestran iniciales en lugar de caras
Solo se puede fotografiar la cara de un jugador cuyo ped se esté transmitiendo a ti. Los miembros que están lejos recurren a sus iniciales. Vuelve a abrir el panel junto a ellos.
El panel o una pantalla de puzle no se cierra
Pulsa Escape: retrocede fuera de una vista y luego cierra. Un diálogo de invitación tiene su propio Decline. Si otro recurso se dibuja sobre el panel y le roba el foco, reinicia ese recurso o el nuestro, y revisa F8 en busca de un error de NUI.
Búsquedas#
El HUD del detector no detecta nada
Solo detecta mientras mantienes pulsado el clic derecho para barrer, en una búsqueda con detector de metales y a pie. Los cofres se registran desde 15 m. No se puede usar desde un vehículo ni con el equipo de buceo puesto.
"You need a metal detector for this hunt" incluso con Config.GiveMissingTools activado
La herramienta gratuita se entrega una vez cada 15 minutos por personaje, así que no se puede farmear. Un buscador que ya no tiene la que se le dio tiene que comprar otra. La herramienta se vuelve a comprobar en cada excavación, no solo al principio.
"You need a treasure key" / "You need an ancient key"
Cada caja cuesta una treasure_key y el cofre antiguo una ancient_key a quien introduce el código. Se venden en la tienda. Para eliminar el requisito, establece Config.RequireTreasureKey o Config.RequireAncientKey en false.
"Your inventory is full"
El hallazgo no cabía. El cofre se vuelve a colocar, la llave no se gasta y nadie más lo pierde. Haz espacio y ábrelo de nuevo.
"You are too far away"
El servidor mide dónde ve tu ped, no dónde dice tu pantalla que estás. Los cofres y el código del cofre se aceptan a menos de 8 m, medidos en horizontal; un buceador que flota sobre una caja cuenta.
No se encuentran las cajas submarinas
Aparecen cuando estás a menos de 80 m de cada una y brillan desde 30 m, en el fondo marino y no en la superficie. Nada más abajo. Si el fondo marino está fuera de alcance, la zona de Config.UnderwaterTreasureChestLocations está sobre agua demasiado profunda; muévela.
Las lecturas de los tótems se desvanecen, o un tótem no abre nada
El desvanecimiento es el puzle: mantén el tercer tótem y ambas lecturas se mantienen estables para todos los que estén a menos de 25 m. Los tótems y la baliza solo responden a los miembros del grupo que están en el lugar, así que un miembro que se quedó atrás no obtiene nada.
"Too many wrong tries — the chest scrambled itself"
Tras Config.Puzzle.MaxAttempts respuestas incorrectas, el cifrado se regenera, así que la clave anterior ya no sirve. Vuelve a leer ambos tótems. Los espacios nunca cuentan en contra de una respuesta.
El equipo de buceo deja de funcionar al azar
Otro recurso de buceo está escribiendo los mismos flags de buceo. Establece Config.ManageDivingGear = false y deja que ese recurso controle el aire.
"This map is for a different kind of hunt"
Un clue_map solo funciona en una búsqueda con detector de metales y un treasure_map en una submarina, y ambos solo durante una búsqueda. El mapa no se gasta cuando se rechaza.
Barcas#
No aparece la pestaña Boats
La pestaña forma parte de la tienda, así que necesita tanto Config.EnableShop como Config.BoatRental.Enabled.
"That boat would not load", y luego un reembolso
El model del nivel es incorrecto o no se transmite. Si no aparece ninguna barca en 20 segundos, el servidor anula el alquiler y lo reembolsa íntegramente. Corrige el nombre del modelo.
"Bring it back to the slipway"
Una devolución solo se acepta a menos de Config.BoatRental.ReturnRadius (45 m) del punto de aparición. El mensaje indica a qué distancia estás.
La barca ha desaparecido
Comportamiento correcto: el alquiler expiró (con un aviso dos minutos antes), el jugador alquiló otra o se desconectó. Terminar o abandonar una búsqueda nunca retira la barca.
Clasificación y recompensas#
La clasificación está vacía o desactualizada
Solo aparecen los buscadores con experiencia en ese periodo, y las clasificaciones se actualizan cada Config.UpdateLeaderboard minutos. Con Config.EnableLeaderboard desactivado, no se clasifica ni se reinicia nada.
Un ganador no ha cobrado
Los reinicios se ejecutan a las 00:00 hora del servidor. Un ganador que estaba desconectado cobra la próxima vez que entra, desde qs_treasure_hunter_rewards. Un servidor que estaba caído a medianoche recupera el reinicio en su siguiente arranque, y nunca paga el mismo día dos veces.
¿Sigues atascado? Abre un ticket e incluye tu framework y tu inventario con sus versiones, la consola del servidor desde el inicio del recurso y la consola F8 con
Config.Debugactivado mientras reproduces el problema.