Antes de empezar#
Antes de instalar Fishing Job, asegúrate de que tu servidor cumple los requisitos mínimos. Tres recursos son obligatorios, además de tu framework; todo lo demás es opcional y se detecta solo.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos. Las tablas se crean solas en el primer inicio. |
| Obligatorio | Callbacks, utilidades compartidas y el cron que ejecuta los torneos programados. |
| Obligatorio | Viene en la misma descarga. Carga el flotador, las tres redes de arrastre, el arpón y su lanza, los pinchos y el barco parrilla. |
Framework | Obligatorio | ESX, QBCore o Qbox — detectado automáticamente. El dinero, los ítems, los trabajos y los nombres de personaje vienen de él. |
Inventario | Opcional |
|
Target | Opcional |
|
Llaves de vehículos | Opcional | Le da al jugador las llaves del barco que alquila. Se admiten once scripts de llaves. |
| Opcional | Proporciona la madera que enciende una fogata. En su lugar sirve cualquier ítem que indiques en la config. |
| Opcional | El disparo del arpón y el chisporroteo de la parrilla, que oyen los jugadores cercanos. |
| Opcional | Avisos 3D con estilo, y pagos de misiones ingresados en la cuenta de la empresa de pescadores. |
Todo lo específico del framework o de terceros está detrás de un pequeño archivo puente sin cifrar, y el recurso elige el adecuado viendo lo que ya está en marcha:
Capa | Orden de detección |
|---|---|
Framework |
|
Metadatos del inventario |
|
Llaves de vehículos |
|
Target | Se elige en la config: |
Cada integración opcional se desactiva en silencio. Si falta un recurso, esa función simplemente se retira — nada da error. Integraciones tiene los detalles y cómo conectar una que no está en la lista.
github.comReleases · overextended/oxmysqlMySQL resource for FXServer.github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.Descargar Fishing Job#
Después de comprar Fishing Job, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Fishing Job.
Tras extraer la descarga, deberías tener las siguientes carpetas:
[fishing]/
├── qs-fishingjob/ -- the job itself
│ ├── config/ -- config.lua, translations.lua (what you may edit)
│ ├── client/framework/ -- ESX and QBCore/Qbox bridges (editable)
│ ├── client/vehiclekeys/ -- one file per key script (editable)
│ ├── client/clothing.lua -- the fisher outfit (editable)
│ ├── server/framework/ -- money, items, jobs (editable)
│ ├── server/missions.lua -- the mission hooks (editable)
│ ├── items.lua -- items for qb-core
│ ├── items_ox.lua -- items for ox_inventory
│ ├── items_qs.lua -- items for qs-inventory
│ ├── items(ESX).sql -- items for ESX
│ └── web/ -- the interface and the item images
├── qs-fishing-props/ -- the streamed props
├── [items]/ -- a copy of the four item files
└── [sql]/ -- the optional SQL fileLa carpeta debe llamarse
qs-fishingjob. Los exports de ítems de ox_inventory (qs-fishingjob.toggleFishingRod), los eventos de red y todos los exports se llaman con ese nombre, así que una copia renombrada deja las cañas inutilizables.
Instalar el recurso#
Mueve las carpetas qs-fishingjob y qs-fishing-props al directorio de recursos de tu servidor. Pueden estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
├── qs-fishing-props/
└── qs-fishingjob/Una vez copiadas, abre tu server.cfg y asegúrate de que todas las dependencias — y todo lo que deba detectar — se inicien antes que Fishing Job:
ensure oxmysql
ensure ox_lib
# Framework
ensure qb-core
# ensure qbx_core
# ensure es_extended
# Target, inventory, keys, sound
ensure ox_target
ensure ox_inventory
ensure qs-vehiclekeys
ensure xsound
ensure qs-fishing-props
ensure qs-fishingjobEl orden de carga importa. La detección solo ve los recursos que ya se han iniciado, así que un inventario o script de llaves que se inicie después de Fishing Job no se encuentra y esa parte vuelve a su comportamiento básico.
Añadir los ítems#
Fishing Job usa 74 ítems: cinco cañas, el kit de pesca, nueve cebos, diez accesorios de caña, todos los peces y cangrejos, la trampa para cangrejos, tres redes, el arpón con sus lanzas y el tanque de buceo, tres pinchos, el barco parrilla y tres tipos de madera. Añádelos al inventario que uses — solo a uno de estos:
Copia las entradas de items_ox.lua en ox_inventory/data/items.lua, y las imágenes de qs-fishingjob/web/public/images/ en ox_inventory/web/images/. Reinicia ambos.
Conserva las líneas client.export: ox despacha los ítems usables por sí mismo, así que esas líneas son las que hacen usable una caña, el kit o una red. Cada pez conserva el peso con el que se pescó, y la tienda lista cada uno por separado y paga más por los pesados.
Copia las entradas de items_qs.lua en qs-inventory/shared/items.lua, y las imágenes de qs-fishingjob/web/public/images/ en qs-inventory/html/images/. Reinicia ambos. Igual que el archivo de ox, las entradas llevan líneas client.export — consérvalas. Cada pez lleva su peso en el ítem; la tienda paga el precio de la especie.
Copia las entradas de items.lua en qb-core/shared/items.lua, y las imágenes en qb-inventory/html/images/. Copia cada entrada completa — una entrada a la que le falte name, type, image, unique o shouldClose llega a la bolsa como un hueco vacío.
ESX lee sus ítems de la base de datos. Importa items(ESX).sql una vez — usa INSERT IGNORE, así que importarlo de nuevo es seguro, y los tres ítems de madera compartidos con qs-lumberjack se quedan como los creó ese script. Copia las imágenes en la carpeta de imágenes de tu inventario.
No hay nada más que registrar: el script hace usables por sí mismo las cañas, el kit, la trampa, las redes, el arpón, el tanque, la madera, los pinchos y el barco parrilla.
La base de datos#
No hay ningún archivo SQL que tengas que importar. Fishing Job crea sus propias tablas en el primer inicio, añade cualquier columna que le faltara a una versión anterior y ajusta sus columnas de identificador a la collation de tu framework, para que la clasificación nunca falle con Illegal mix of collations.
Tablas | Contienen |
|---|---|
| El nivel y la experiencia de cada jugador, más los contadores diarios, de temporada e históricos de la clasificación. |
| Premios de la clasificación pendientes de recoger, y los últimos ganadores de cada ranking. |
| Por jugador y por especie: cuántos se pescaron y se soltaron, el más pesado y los trofeos. |
| Logros desbloqueados y reclamados, y victorias en torneos. |
| Cada trampa para cangrejos en el agua, para que una trampa en remojo sobreviva a un reinicio. |
| Cada ajuste cambiado desde el panel de administración, quién lo cambió y cuándo. |
En ESX, el trabajo
fishery su primer rango se escriben automáticamente enjobsyjob_grades, para cada trabajo listado enConfig.FisherJob.qs-fisher.sqlhace lo mismo a mano, para un usuario de base de datos que no puede crear tablas.
Obtener acceso de administrador#
El panel de administración edita todos los ajustes y abre torneos y zonas doradas, así que está protegido por un permiso ACE, que se comprueba en el servidor cuando se abre el panel y de nuevo con cada botón dentro de él. El permiso es command.fishing a propósito: casi todos los server.cfg ya conceden a los administradores todo el espacio command, así que un administrador existente suele tener acceso sin añadir nada.
Si el tuyo no, añade esta línea:
add_ace group.admin command.fishing allowDespués abre el panel en el juego con /fisheradmin. Tanto el ACE como el nombre del comando se pueden cambiar en Config.AdminPanel.
Configurar el recurso#
Todos los ajustes están en config/config.lua, y todos ellos también se pueden cambiar desde el panel de administración en el juego. El archivo contiene los valores por defecto; todo lo que se guarda desde el panel se almacena en la base de datos y se aplica por encima.
Archivo | Contenido |
|---|---|
| El trabajo, el NPC, la tabla de peces, la profundidad, el cebo, los barcos, los torneos, las zonas doradas, las trampas, las redes, el arpón, la cocina, los niveles, las misiones, la tienda, el minijuego y la clasificación. |
| El idioma, y cada línea de texto en ocho idiomas. |
| El texto de ayuda que el panel de administración muestra junto a cada ajuste. No hace falta editarlo. |
| El uniforme de pescador que se pone cuando un jugador entra en servicio. |
| Cómo se leen el dinero, los ítems, los trabajos y los nombres desde tu framework. |
Los valores que conviene revisar primero:
Config.Language = 'en' -- en · it · es · fr · pt · de · ru · tr (config/translations.lua)
Config.RequireJob = false -- true: only jobs in Config.FisherJob may fish
Config.FisherJob = { ['fisher'] = true }
Config.Target = false -- true: third-eye on the NPC
Config.TargetScript = 'ox' -- 'ox' or 'qb'
Config.Clothing = true -- swap into the fisher outfit on duty
Config.WeightUnit = 'kg' -- 'kg' or 'lb', display only
Config.MissionPayout = 'members' -- 'members' or 'split'
Config.AdminPanel = { Enabled = true, Ace = 'command.fishing', ConfigCommand = 'fisheradmin' }Un ajuste guardado desde el panel prevalece sobre el archivo. Si editas
config.luay no cambia nada, ese ajuste se sobrescribió en el panel — restablécelo ahí (la flecha junto a él) y el valor del archivo vuelve en el siguiente reinicio.
Verificar la instalación#
Después de completar la instalación, reinicia tu servidor y lee la línea de arranque en la consola. Indica qué se detectó para cada capa:
[qs-fishingjob] framework qb · inventory ox · vehicle keys qs-vehiclekeysstandalone significa que no se encontró ningún framework, basic significa que el pescado se vende a precios fijos, y none significa que los barcos alquilados vienen sin llaves — si tienes ese recurso, muévelo por encima de ensure qs-fishingjob.
Después entra en tu servidor y recorre el primer ciclo:
Visita al pescador
Old Pete está en la costa cerca de Paleto, bajo el blip Fisher. Acércate y presiona
E: se abre el panel del trabajo con misiones, tu grupo, estadísticas y la tienda.Compra una caña y lanza
Compra una Wooden Rod y algunas lombrices en la tienda, usa la caña desde tu inventario y mira hacia el agua. Presiona
Ecuando se ilumine el aviso, mantén el botón izquierdo del mouse para cargar el lanzamiento y suelta. Cuando el flotador se hunda, presionaEpara clavar.Abre el panel de administración
/fisheradminse abre en la pestaña Events — inicia un torneo o una zona dorada para ver uno al instante. Desde ahí, Uso cubre todo lo que puede hacer un jugador.
Los ajustes guardados desde el panel se aplican en el siguiente reinicio de
qs-fishingjob, no al instante — el panel muestra un banner hasta que lo hagas. Cambiar la tabla de peces mientras alguien está recogiendo uno no es un cambio de ajustes, así que el script nunca lo hace en caliente.