Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. Casi todos los rechazos de Hunter Job le dicen al jugador el motivo con palabras claras, y los errores del propietario — un ítem que falta, un modelo que nunca carga, un animal que una misión nombra pero que la configuración no tiene — se muestran en la consola del servidor o en F8. Léelos primero; activa Config.Debug si necesitas ver más.
Instalación e inicio#
"You have renamed the script!" y la consola se congela
La carpeta del recurso no se llama qs-hunter. Debe llamarse así — una copia renombrada detiene el servidor a propósito. Devuelve a la carpeta su nombre, corrige la línea ensure en server.cfg y reinicia.
El empleador no aparece
El NPC lo genera el puente del framework, así que la causa habitual es un framework que se inicia después de qs-hunter y que nunca se detectó. Mueve ensure qs-hunter debajo de tu core.
Si F8 muestra Ped model '…' never loaded., Config.StartJob.ped.model tiene un error tipográfico o nombra un ped add-on que no se transmite.
No hay blip en el mapa
Es el comportamiento correcto para un jugador sin el trabajo: el blip solo se muestra a los jugadores que tienen un trabajo de Config.HunterJob, y aparece en el momento en que lo obtienen. Con Config.RequireJob = false todo el mundo lo ve. Revisa Config.EnableBlip también.
"Illegal mix of collations" y una clasificación vacía
La collation predeterminada de tu base de datos difiere de aquella con la que se crearon las tablas del cazador — algo típico en MariaDB 11.4 y posteriores. El script alinea sus columnas identifier en cada inicio y muestra aligned N identifier column(s) cuando lo hace. Si el usuario de la base de datos no tiene permiso para modificar tablas, muestra en su lugar la sentencia ALTER TABLE exacta — ejecútala a mano y reinicia.
"Could not verify the database schema" o "Could not register the ESX job rows"
El primero significa que las tablas no se pudieron crear ni comprobar: oxmysql no está conectado, o el usuario de la base de datos no tiene permisos de CREATE y ALTER. Corrige la conexión, o importa [sql]/qs-hunter.sql a mano.
El segundo solo importa en ESX: no existe la tabla jobs en la que pueda escribir. Las tablas del cazador siguen bien — añade el trabajo con los dos inserts del principio del mismo archivo SQL.
Misiones y grupos#
"You don't have the hunter job"
El nombre del trabajo del jugador no es una clave de Config.HunterJob. La coincidencia es exacta — hunter, no Hunter. En QBCore y Qbox, el trabajo también debe existir en shared/jobs.lua antes de que /setjob lo entregue — consulta Instalación.
La misión no se inicia
El servidor comprueba a cada miembro antes de iniciarla y nombra la regla que falló:
One of the members does not have the level required — alguien está por debajo del
levelRequiredde la misión.One of the members does not have the hunter job — alguien cambió de trabajo después de unirse.
One of the members is already on a mission — primero debe terminarla o abandonarla.
Only the group leader can do that — un miembro pulsó Start Mission; solo el líder puede hacerlo.
Se rechaza una invitación
Mensaje | Significado |
|---|---|
The player is too far away | A más de |
That player has just been invited, give them a moment | Tiene una invitación sin responder, o alguien lo invitó en los últimos 10 segundos. |
Slow down, you have just sent an invitation | Han pasado menos de 1.5 segundos desde la última invitación del líder. |
Player is already in the party | Pertenece a otro grupo. Primero debe salir de él. |
Your group is already full | El grupo tiene |
That player is not online | Ningún jugador tiene ese ID de servidor. |
Los recuadros del grupo muestran iniciales en lugar de caras
Solo se puede fotografiar una cara cuando ese jugador está lo bastante cerca para que tu juego lo dibuje. Quien esté fuera de alcance recibe sus iniciales, y F8 explica el motivo con no mugshot for …. No hay nada roto — acércate y vuelve a abrir el panel.
Los animales nunca aparecen
Aparecen en su zona de caza, no cerca del empleador — sigue el círculo del mapa. Si el círculo también falta, F8 lo explica:
Task 7 wants animal 'pig', which is not in Config.Animals.— una misión nombra un animal que la configuración no define. Corrige la ortografía o añade el animal.Animal model '…' never loaded.— el modelo de ped enConfig.Animalses incorrecto.
Recolección#
"The animal was not taken down with the appropriate weapon"
Lo mató algo distinto de Config.HunterWeapon — otra arma, un golpe cuerpo a cuerpo, un coche, una caída — y el cadáver se eliminó. Usa el rifle, o configura Config.HunterWeaponNeeded = false para aceptar cualquier muerte.
"You need a hunting tool" o "You don't have enough level to use hatchet"
Config.RequireToolToHarvestAnimal está activado y el jugador no lleva ninguna de las dos herramientas — o solo el hacha, por debajo de Config.AxeRequiredLevel. Un cuchillo de la tienda resuelve ambos casos.
"You are too far from the hunting ground"
El servidor mide desde el coords del animal en Config.Animals, permitiendo Config.SpawnRadius + Config.HarvestZoneMargin (520 m). Un animal que huyó más lejos no se puede reclamar — aumenta el margen si tus zonas son amplias.
"Your mission does not ask for this animal" o "You have already harvested your share"
Cada miembro solo puede despellejar los animales que nombra su misión, y solo tantos de cada uno como pide. El resto del contador del grupo sigue necesitando sus propios animales — el cadáver extra no vale nada.
"This item does not exist: rat_meat"
El botín está configurado pero tu inventario no tiene ese ítem. La consola del servidor lo nombra cada vez que ocurre:
[qs-hunter] rat_meat is configured as a drop but no such item exists in the inventory.El jugador conserva la experiencia y el progreso de la misión; solo se pierde el ítem. Añade los ítems como se muestra en Instalación y reinicia el inventario.
"Your inventory is full"
No cabía nada, así que no se entregó nada y el animal no contó para la misión. Vende o tira algo y despelleja el siguiente.
Pulsar E sobre un cadáver no hace nada
El targeting está activado — usa el third eye; los avisos de tecla no se dibujan con
Config.Target = true.El jugador no está en una misión, o el cadáver pertenece a un compañero de grupo — cada miembro solo puede despellejar los animales que generó su propio juego.
Volvió a pulsar demasiado pronto. Se permite una recolección por animal en cada tiempo de recolección.
Está a más de 3 m del cuerpo.
Tienda y dinero#
"This item does not exist: snp_ammo" al comprar
La tienda vende un nombre de ítem que tu inventario no usa. No se cobró nada por esa línea, y la consola dice cuál es:
[qs-hunter] snp_ammo is on sale in the shop but no such item exists in the inventory.Casi siempre es la munición: en ox_inventory cambia la entrada Ammo de Config.BuyItems a ammo-sniper.
"You don't have enough money" con dinero en el banco
La tienda cobra en efectivo. Para usar el banco en su lugar, cambia la cuenta en el puente del servidor — Pagar en el banco en Integraciones muestra las tres líneas.
El rifle no tiene munición
Solo ox_inventory carga el rifle al comprarlo. En los demás casos, compra el pack Ammo que está a su lado.
El pago de la misión nunca llega al efectivo del jugador
qs-job-management está en ejecución, así que el pago se le entregó a él — ahí es donde hay que mirar. Las ventas y los premios de la clasificación siguen pagándose en efectivo.
Los ítems del puma no tienen imagen
Los iconos de la descarga son meat_mtlion.png y hide_mtlion.png. Apunta lion_meat y lion_hide a esos nombres en tu lista de ítems.
Clasificación#
La clasificación está vacía
Solo aparecen los cazadores con experiencia en ese periodo, así que un día o mes nuevo empieza vacío. Las clasificaciones se actualizan cada Config.UpdateLeaderboard minutos — una primera recolección aparece en menos de uno. Si sigue vacía después, busca el error de collation de arriba.
Un ganador dice que no se le pagó
Estaba desconectado en el reinicio. Su premio queda guardado en qs_hunter_rewards y se paga en efectivo la próxima vez que cargue su personaje.
Los nombres aparecen como "Unknown"
El cazador no tiene una fila de personaje correspondiente — users con un nombre en ESX, players con charinfo en QBCore. Normalmente es un personaje eliminado.
La clasificación diaria se reinicia a una hora incorrecta
Los reinicios se ejecutan a medianoche en la zona horaria de la máquina del servidor, no en la de los jugadores. Cambia la zona horaria del host para moverlo.
Claves de mensajes#
Cada rechazo es una clave en config/translations.lua, así que se lee en el propio idioma de cada servidor. Busca la clave para cambiar su redacción.
Clave | Significado |
|---|---|
| Sin trabajo de cazador — o, al recolectar, sin estar en una misión. |
| El jugador, o un miembro del grupo, ya tiene una caza en curso. |
| Un miembro del grupo está por debajo del nivel o no tiene el trabajo. |
| Solo el líder puede hacerlo · el grupo está lleno. |
| Invitación rechazada: desconectado, en otro grupo o invitado hace un momento. |
| El líder invita demasiado rápido · el jugador está fuera del alcance de invitación. |
| Muerto con el arma equivocada; el cadáver ha desaparecido. |
| Se requiere una herramienta y el jugador no tiene ninguna que pueda usar. |
| Fuera de la zona de caza del animal más el margen. |
| La misión no quiere ese animal · la parte del jugador está completa. |
| No hay espacio para el ítem · el inventario no lo conoce. |
| La cesta cuesta más que el efectivo del jugador. |
¿Sigues atascado? Abre un ticket e incluye la consola del servidor desde el inicio de
qs-hunter, la salida de F8 conConfig.Debug = true, tu framework e inventario, y el mensaje exacto que vio el jugador.