Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría son de configuración, no fallos — y el script indica qué filtro se cerró, ya sea en la notificación del jugador o en la consola del servidor. Lee ambos antes de abrir un ticket.
Instalación y acceso#
La consola dice "You have renamed the script!" y se congela
La carpeta no se llama qs-fishingjob. Vuelve a ponerle ese nombre — los exports de ítems, los eventos y los datos guardados usan ese nombre — y reinicia.
Usar una caña, el kit o una red no hace nada
En ox_inventory o qs-inventory las entradas de los ítems deben conservar sus líneas client = { export = 'qs-fishingjob....' } — cópialas completas de items_ox.lua o items_qs.lua. En ESX, QBCore y Qbox el script registra los ítems por sí mismo, así que comprueba que el ítem exista en tu inventario. Un ítem que no hace nada en otro inventario necesita Config.RegisterUsableItemsManually = true.
Al usar la caña, se saca y se guarda al instante
Se disparan dos handlers con un solo clic: el export propio del inventario y el registro del script. Desactiva Config.RegisterUsableItemsManually, y asegúrate de que ningún otro script de pesca registre las mismas cañas.
"This item does not exist" al comprar, pescar o recoger
El ítem nombrado en el mensaje falta en la lista de ítems de tu inventario. La consola del servidor imprime no such item in the inventory: <item> con el lugar donde se pidió. Añádelo desde el archivo de ítems correspondiente, o en ESX importa items(ESX).sql.
"You are not allowed to do that" en /fisheradmin
El jugador no tiene el ACE command.fishing (o lo que indique Config.AdminPanel.Ace). Añade add_ace group.admin command.fishing allow a server.cfg y asegúrate de que el jugador esté en group.admin.
Edité config.lua y no cambió nada
O el recurso no se reinició, o ese ajuste se cambió en el panel de administración — un ajuste guardado tiene prioridad sobre el archivo. Abre /fisheradmin, busca el ajuste (aparece marcado como cambiado) y pulsa la flecha que tiene al lado para volver al valor del archivo; luego reinicia.
Guardé un ajuste en el panel y no cambió nada
Es el comportamiento correcto. Los ajustes guardados se aplican en el siguiente reinicio de qs-fishingjob, y el panel muestra un aviso hasta entonces. Iniciar o detener un evento es lo único inmediato.
Falta el pescador o el blip
Con Config.RequireJob = true, solo los jugadores con un trabajo de Config.FisherJob ven el blip. Si nadie ve al NPC, la consola del cliente indica el modelo que no se pudo cargar — revisa Config.StartJob.ped.model. En QBCore o Qbox, "no qb core answered in twenty seconds" significa que el core se inició después de Fishing Job o se le cambió el nombre.
Pesca con caña#
La opción de lanzar aparece en gris
El motivo está escrito en el aviso. Los habituales: estar a menos de cinco metros del pescador, ir al volante de un barco (pasa a un asiento de pasajero o colócate en la cubierta), tener todavía una red fuera, o un agua demasiado profunda para ti — la profundidad alcanzable crece con el nivel y con los carretes y sedales que dan puntos de profundidad.
"You need a fishing rod" o "You need level X to fish with that rod"
Las cañas se comprueban en el servidor en el momento del lanzamiento. El jugador no tiene ninguno de los ítems de Config.RodTiers, o solo tiene cañas por encima de su nivel. La Wooden Rod funciona desde el nivel 1 y cuesta $20 en la tienda.
Desde la orilla siempre pesco los mismos peces
Es el comportamiento correcto. Desde la orilla el agua siempre cuenta como 6 m, a media agua, estés donde estés. Las especies profundas y abisales — y el mejor dinero — necesitan un barco. La Guide del panel del trabajo marca qué peces se pueden pescar desde la orilla.
Todas las capturas se venden al mismo precio
El precio por peso necesita ox_inventory: es el único inventario del que la tienda puede leer el peso de un pez concreto. En cualquier otro inventario, cada especie se vende a su precio base en Config.Fish, y el peso sigue contando para los récords y los torneos.
El sedal se rompe una y otra vez
La cámara se desvía demasiado del centro. Tira en la dirección que indican las flechas, pero afloja cuando la barra de tensión se pone ámbar. Los peces profundos y abisales son difíciles a propósito; un anzuelo facilita la pelea y un sedal añade resistencia.
Barcos, trampas y redes#
El barco alquilado no tiene llaves
Revisa la línea de arranque: vehicle keys none significa que no había ningún script de llaves compatible en marcha cuando se inició Fishing Job — muévelo por encima de ensure qs-fishingjob. glfp10_carkeys y mono_carkeys entregan las llaves como un ítem, que un alquiler no crea.
Se rechazó el reembolso del barco
El barco debe devolverse dentro de Config.BoatRental.ReturnRadius (45 m) del muelle; el mensaje indica a qué distancia está. Un alquiler que se agota simplemente desaparece sin reembolso.
No se puede colocar una trampa para cangrejos
El agua dos metros por delante debe tener al menos 10 m de profundidad, no puedes soltarla estando sobre un muelle o un puente, no puede haber otra trampa a menos de 20 m, y el jugador debe estar por debajo de su límite de trampas (una, dos desde el nivel 16, tres desde el nivel 31). El propio ítem de trampa requiere el nivel 5.
Mi trampa para cangrejos desapareció
Se pudrió. Una trampa llena se rompe Config.CrabTraps.Decay.BreaksAfter minutos después (tres horas por defecto), aunque su dueño esté desconectado; a los dueños conectados se les avisa antes. Las trampas también sobreviven a los reinicios, así que si falta una después de un reinicio, ya había desaparecido.
"You need a boat rented from the fishing job" al usar una red
Las redes solo funcionan desde un barco alquilado en el panel del trabajo, por el jugador que lo alquiló y mientras está sentado en él. Un barco personal o el alquiler de un compañero no cuentan.
La red no se llena, o se rompió
Se llena según la distancia a la velocidad adecuada: nada por debajo de 3 m/s, lo mejor alrededor de 7.5. Por encima de 12 m/s, o arrastrada sobre agua de menos de 4 m, pierde integridad hasta que se rompe y se pierde la captura. Vigila el indicador de velocidad.
Pesca submarina y cocina#
No hay tiburones en ningún sitio
Es el comportamiento correcto. Los tiburones solo existen durante una misión Shark Hunt, y solo dentro de su zona marcada. Acepta la misión en el nivel 20; soltar un tiburón sin ella muestra "You are not on a shark hunt". En un mapa reemplazado, comprueba que las zonas de Config.Speargun.Hunt.Zones sigan siendo aguas abiertas.
El fusil submarino no dispara
Solo dispara mientras nadas bajo el agua, necesita ítems spear como munición y requiere el nivel 20. "The speargun model is missing" significa que qs-fishing-props no está en marcha.
Los props son invisibles: sin flotador, redes, brochetas ni barco parrilla
La consola del cliente indica cuántos props faltan. Inicia qs-fishing-props antes de qs-fishingjob y asegúrate de que la carpeta se copió completa.
No se puede hacer una fogata
Necesita tres de una misma madera de Config.Campfire.Fuel.Items, suelo natural (arena, hierba, tierra — no carreteras, hormigón ni suelos), sin agua, al menos a 8 m de otra fogata, y fuera de los círculos sin construcción alrededor del pescador y del muelle. Un jugador puede tener dos fogatas encendidas. Si los ítems de madera no existen en tu inventario, nadie puede encender una.
"You have no raw skewers to grill" con el barco espeto
El barco parrilla cocina el pescado crudo de tu bolsa. Lleva cualquier pez excepto tiburón, y coloca el barco en tierra firme, no en el agua ni en un vehículo.
Tienda, misiones y eventos#
"The shop is not answering"
La consola del servidor imprime the shop could not be built: seguido del motivo — casi siempre un ítem de la configuración que no existe en el inventario, o un error de escritura en una tabla editada.
"Your inventory did not answer" o "Your inventory is full"
Son dos cosas distintas. "Did not answer" significa que no se pudo llegar al inventario — normalmente porque aún está cargando después de entrar; inténtalo de nuevo. "Full" es una bolsa sin espacio ni peso libre. No se cobra nada por un ítem que no se pudo entregar.
No se puede iniciar una misión
Solo el líder de la tripulación puede iniciarla, todos los miembros deben cumplir su nivel, y un jugador que ya está en una misión debe abandonarla primero. Con Config.RequireJob activado, el jugador debe tener un trabajo de pescador.
Un pez liberado no contó para la misión
Es lo correcto por defecto. Pon Config.CatchDecision.ReleaseCountsForQuests = true si los peces liberados deben contar.
Los torneos programados nunca empiezan
Funcionan con el cron de ox_lib. "ox_lib cron is unavailable" en la consola significa que tu ox_lib es demasiado antiguo; actualízalo. Una entrada de Config.Tournaments.Schedule que no sea HH:MM se omite con su propio mensaje. Las horas son las del reloj del servidor, y con FishersOnly activado, solo se avisa a los pescadores.
La clasificación falla con "Illegal mix of collations"
El script ajusta sus tablas a la intercalación de tu framework al iniciarse. Si el usuario de la base de datos no puede modificar tablas, la consola imprime la sentencia ALTER TABLE exacta para ejecutarla a mano.
Mensajes de la consola#
Cada mensaje empieza por [qs-fishingjob]. Los rojos detienen una función; los amarillos son advertencias.
Mensaje | Significa |
|---|---|
| La línea de arranque: lo que se detectó. No es un error. |
| Un ítem que nombra la configuración no está registrado en tu inventario. |
|
|
| Se están usando ajustes del panel de administración. No es un error. |
| Un ajuste guardado con una versión anterior no tiene lugar en esta. Se conserva en la base de datos y se ignora. |
| No se pudieron crear las tablas — revisa oxmysql y los permisos del usuario de la base de datos. |
| No se pudo insertar el trabajo de pescador; importa |
| Los torneos programados están desactivados hasta que se actualice ox_lib. |
|
|
Activa Config.Debug mientras configuras y el script explica cada paso en la consola del servidor y en F8 — incluido qué salió en cada captura y por qué. Déjalo desactivado en un servidor en producción: imprime mucho.
¿Sigues atascado? Abre un ticket e incluye la línea de arranque (
[qs-fishingjob] framework … · inventory …), cualquier línea roja o amarilla de[qs-fishingjob]de la consola del servidor, tu framework y tu inventario con sus versiones, y una captura de la consola F8 para cualquier cosa relacionada con la interfaz.