Antes de empezar#
Antes de instalar Lumberjack Job, asegúrate de que tu servidor cumple los requisitos. La base de datos, el framework y el inventario se detectan solos; todo lo marcado como opcional simplemente se desactiva cuando falta.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos. Las tablas se crean solas. |
| Obligatorio | Callbacks, puntos de interacción, asignación de teclas y las programaciones detrás de las clasificaciones y los torneos. |
Framework | Obligatorio |
|
| Obligatorio | Incluido en la descarga: los árboles, las tres hachas, la madera que cae y las modificaciones del mapa del bosque. |
Inventario | Obligatorio |
|
Target | Opcional |
|
Ropa | Opcional |
|
Complementos de Quasar | Opcional |
|
El framework y el inventario se eligen mirando lo que ya está en ejecución:
Capa | Cómo se elige |
|---|---|
Framework |
|
Inventario |
|
Target | Se establece a mano: |
Integraciones tiene los detalles de cada capa.
github.comReleases · overextended/oxmysqlMySQL resource for FXServer.github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.Descargar Lumberjack Job#
Tras comprar Lumberjack Job, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Inicia sesión en CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Lumberjack Job. Con otra cuenta el recurso no aparece.
Tras extraer la descarga, deberías tener las siguientes carpetas:
[lumberjack]/
├── qs-lumberjack/ -- the script
│ ├── config/ -- what you may edit
│ ├── client/framework/ -- framework bridge (editable)
│ ├── server/framework/ -- framework and inventory bridge (editable)
│ ├── web/ -- the interface (leave as it is)
│ └── qs-Lumberjack-ESX.sql -- optional, the tables by hand
├── qs-lumberjack-props/ -- trees, axes, wood drops and the forest map
├── marker_props/ -- marker models
└── [qs-lumberjack-installation]/ -- item lists, item images and the optional SQLInstalar el recurso#
Mueve la carpeta [lumberjack] al directorio de recursos de tu servidor. Puede estar dentro de cualquier carpeta de categoría. La carpeta [qs-lumberjack-installation] no contiene ningún recurso y puede quedarse fuera.
resources/
└── [qs]/
├── qs-lumberjack/
├── qs-lumberjack-props/
└── marker_props/Después abre tu server.cfg y asegúrate de que las dependencias se inician antes que Lumberjack Job:
ensure oxmysql
ensure ox_lib
# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core
# Inventory and target
ensure ox_inventory
ensure ox_target
# Lumberjack Job
ensure qs-lumberjack-props
ensure marker_props
ensure qs-lumberjackEl orden importa. El framework se detecta en el momento en que se carga el recurso, así que un framework que se inicia después no se encuentra. Mantén el recurso de props por encima del script, o los árboles y las hachas no tendrán modelo que crear.
La base de datos#
No hay ningún archivo SQL que importar. Lumberjack Job crea sus propias tablas en el primer arranque, todas con el prefijo qs_lumberjack, y añade cualquier columna que le falte a una instalación anterior.
Tabla | Contiene |
|---|---|
| El nivel y la experiencia de cada jugador, más la experiencia y las ganancias históricas, de temporada y diarias que ordenan las clasificaciones. |
| Cuándo se reiniciaron por última vez las clasificaciones diaria y de temporada, los premios guardados para ganadores que estaban desconectados y el último podio de cada una. |
| Árboles talados por tipo de madera y misiones terminadas: lo que miden los logros. |
| Logros obtenidos y reclamados, y victorias en torneos por jugador. |
| Cada ajuste guardado desde el panel de administración. |
En MariaDB 11.4 y posteriores las tablas del framework pueden usar una collation distinta de estas. El recurso lo detecta y alinea sus columnas
identifiercon las del framework al arrancar, así las uniones de la clasificación nunca fallan. Ejecutarqs-lumberjack.sqldesde la carpeta de instalación a mano es opcional y seguro de repetir: cada sentencia esIF NOT EXISTSoINSERT IGNORE.
El trabajo de leñador#
Cualquiera puede abrir el panel del capataz para ver la tienda y la clasificación. Aceptar una misión, invitar a una cuadrilla y unirse a arboledas ricas y torneos requiere uno de los trabajos de Config.LumberJackJob (lumberjack por defecto). Establece Config.RequireJob = false para abrir todo el trabajo a todos.
No hay que hacer nada. En cada arranque el recurso registra cada trabajo de Config.LumberJackJob que falte en jobs, con un grado 0 llamado Novice en job_grades. La consola lo indica la primera vez:
[qs-lumberjack] Registered the ESX job "lumberjack"QBCore guarda sus trabajos en un archivo en lugar de en la base de datos. Añade esto a qb-core/shared/jobs.lua:
['lumberjack'] = {
label = 'Lumberjack',
defaultDuty = true,
offDutyPay = false,
grades = {
['0'] = { name = 'Novice', payment = 10 },
},
},Añade el trabajo a qbx_core/shared/jobs.lua:
lumberjack = {
label = 'Lumberjack',
defaultDuty = true,
offDutyPay = false,
grades = {
[0] = { name = 'Novice', payment = 10 },
},
},Varios trabajos pueden compartir el bosque: añade una línea por nombre de trabajo a Config.LumberJackJob.
Añadir los ítems#
Cada tronco, subproducto, tablón y hacha es un ítem real del inventario, y un ítem que el inventario no conoce no se puede entregar. Añádelos antes de que el primer jugador coja un hacha: Ítems del inventario tiene la lista para cada inventario, y las imágenes están en [qs-lumberjack-installation]/images.
Obtener acceso de administrador#
El panel de administración (/lumberjackadmin) edita cada ajuste e inicia eventos, así que está protegido por un ace. El ace por defecto es command.lumberjack, y group.admin también se acepta siempre.
Normalmente no hay que hacer nada. El server.cfg por defecto de ESX ya concede a los administradores todos los aces command.*, lo que incluye este:
add_ace group.admin command allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.adminConcede solo el ace de leñador a un grupo propio:
add_ace group.lumberjack command.lumberjack allow
add_principal identifier.fivem:1234567 group.lumberjackCambia el ace, o el comando, en config/config.lua. Establecer Ace = false elimina la comprobación por completo; hazlo solo en un servidor de pruebas.
Config.AdminPanel = {
Enabled = true,
Ace = 'command.lumberjack', -- false = anyone, nil = this default
ConfigCommand = 'lumberjackadmin', -- '' registers no command
}Las líneas de ace en
server.cfgsolo se leen cuando arranca el servidor. Reiniciar el recurso no detecta una nueva: escribe la misma línea en la consola del servidor, donde surte efecto de inmediato.
Configurar el recurso#
Todo se configura en la carpeta config, y cada valor de config.lua también se puede cambiar desde el panel de administración en el juego.
Archivo | Contenido |
|---|---|
| El trabajo, el mundo, los árboles y la madera, los niveles y las misiones, las hachas, el bloque de corte, la clasificación, los logros, las arboledas ricas, los torneos, el panel de administración, el marcador, la depuración y los webhooks de Discord. |
| El uniforme de trabajo, uno para personajes masculinos y otro para femeninos. |
| El idioma en uso y cada texto en once idiomas. |
| La línea de ayuda que muestra el panel de administración bajo cada ajuste. |
Los valores que conviene revisar primero:
Config.RequireJob = true -- false: anyone may take missions
Config.Target = false -- true: third-eye on the foreman and the stumps
Config.TargetScript = "ox" -- "ox" or "qb"
Config.InventoryAxe = true -- axes are inventory items
Config.Clothing = true -- the work outfit while on a mission
Config.MissionPayout = 'members' -- 'members' (full pay each) or 'split'
Config.Language = "en" -- in config/translations.lua
Config.Debug = false -- extra console outputUn ajuste guardado desde el panel de administración se almacena en la base de datos y se aplica sobre
config.luaen cada arranque. Por eso, editar el archivo para un ajuste que se guardó en el juego no cambia nada: usa primero Back to the file's value en el panel. Uso explica cada sección.
Verificar la instalación#
Reinicia el servidor y lee la consola. Nada de [qs-lumberjack] debería salir en rojo. En ESX el primer arranque registra el trabajo, y en MariaDB recientes puede que veas la línea de collation:
[qs-lumberjack] Registered the ESX job "lumberjack"
[qs-lumberjack] aligned 6 identifier column(s) to utf8mb4_uca1400_ai_ci, matching users.identifier.Luego entra y completa el primer ciclo:
Visita al capataz
Sigue el blip Lumberjack Zone hasta el aserradero sobre Paleto Bay. Big Ray está bajo un marcador azul flotante; pulsa
Ea su lado y se abre su panel.Compra y equipa un hacha
Shop → compra la Rusty Axe. Úsala desde tu inventario y aparecerá en tu mano.
Tala un árbol
Camina hasta los pinos, ponte frente a un tronco y pulsa el botón izquierdo del ratón cuatro veces. Pasa por encima de la madera que salta para recogerla y luego véndela desde la Shop.
Abre el panel de administración
/lumberjackadminabre todos los ajustes. A partir de ahí, Uso cubre todo el trabajo.