Instalación

Antes de empezar#

Antes de instalar Miner Job, asegúrate de que tu servidor cumple los requisitos. Tres recursos son obligatorios y se necesita un framework para el dinero y los trabajos; todo lo demás es opcional y se detecta solo.

El recurso mira lo que ya está en ejecución y elige el puente correcto por sí solo:

Cada integración opcional se desactiva en silencio: un recurso que falta simplemente desactiva esa función. Integraciones tiene los detalles.

GitHubReleases · overextended/oxmysqlMySQL resource for FXServer.

GitHubReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.

Descargar Miner Job#

Después de comprar Miner 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 ambos paquetes: Miner Job [main] y Miner Job [props].

Después de extraerlos deberías tener:

qs-minerjob/
├── config/       -- config.lua, clothing.lua, translations.lua (what you may edit)
├── client/       -- client logic and framework bridges
├── server/       -- server logic, framework and inventory bridges
└── fxmanifest.lua
miner_props/      -- the streamed ore, furnace and pickaxe models
[items]/          -- item lists for ox_inventory, qs-inventory, QBCore and ESX
[sql]/            -- qs-minerjob.sql, optional (see The Database)

Instalar el recurso#

Mueve qs-minerjob y miner_props a tu directorio de recursos; una carpeta de categoría como [qs] sirve. Después abre server.cfg y asegúrate de que cada dependencia arranque antes que el trabajo:

ensure oxmysql
ensure ox_lib

# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core

# Inventory and target
ensure ox_inventory
# ensure qs-inventory
ensure ox_target

# Optional
# ensure qs-textui
# ensure qs-party
# ensure qs-job-management

ensure miner_props
ensure qs-minerjob

El orden importa. El framework, el inventario y los recursos opcionales se detectan a partir de lo que ya está iniciado, así que cualquier cosa que arranque después de qs-minerjob puede no encontrarse.

La base de datos#

No hay SQL que importar. Miner Job crea sus tablas en el primer arranque, todas con el prefijo qs_miner, añade cualquier columna que le falte a una instalación anterior y alinea sus columnas identifier con la collation de tu framework para que la clasificación pueda unirlas.

El archivo [sql]/qs-minerjob.sql solo sirve para preparar una base de datos a mano. Cada sentencia que contiene es IF NOT EXISTS o INSERT IGNORE, así que ejecutarlo no hace daño, y omitirlo no cambia nada. Evita XAMPP y servidores MySQL locales similares no optimizados; causan errores de conexión.

Registrar el trabajo#

Por defecto solo pueden minar los jugadores con un trabajo incluido en Config.MinerJob: miner de serie. El panel del trabajo, con su tienda y su clasificación, está abierto a todos.

[qs-minerjob] Registered the ESX job "miner"

['miner'] = {
    label = 'Miner',
    defaultDuty = true,
    offDutyPay = false,
    grades = {
        ['0'] = { name = 'Novice', payment = 10 },
    },
},

['miner'] = {
    label = 'Miner',
    defaultDuty = true,
    offDutyPay = false,
    grades = {
        [0] = { name = 'Novice', payment = 10 },
    },
},

Para que más de un trabajo pueda minar, añade cada uno a Config.MinerJob. Para que cualquiera pueda minar sin ningún trabajo, define Config.RequireJob = false.

Config.RequireJob = true

Config.MinerJob = {
    ['miner'] = true,
    -- ['quarry'] = true,
}

Añadir los ítems#

Cada mineral, cada pieza de joyería y, cuando Config.InventoryPickaxe es true, cada pico tienen que existir en la lista de ítems de tu inventario. Un ítem que el inventario no conoce se rechaza, y al minero se le indica que no existe. Copia el bloque de tu inventario desde Ítems de inventario.

Configurar el recurso#

Todos los archivos que editas están en config/:

Los valores que conviene revisar primero:

Config.RequireJob             = true     -- false lets anyone mine
Config.Target                 = false    -- true = third eye, false = press E
Config.TargetScript           = "ox"     -- "ox" or "qb"
Config.InventoryPickaxe       = true     -- pickaxe as a real inventory item
Config.InventoryPickaxeScript = "qs"     -- "ox" or "qs"
Config.Clothing               = true     -- miner outfit during missions
Config.InstantOreCollection   = false    -- true = no carrying to the conveyor
Config.MissionPayout          = 'members' -- or 'split'

-- config/translations.lua
Config.Language = "en"  -- en, es, fr, de, pt, it, ru, tr, nl, cn

config.lua contiene los valores por defecto. Un ajuste cambiado desde /mineradmin se guarda en la base de datos y prevalece sobre el archivo, así que editar ese ajuste en config.lua después no hace nada hasta que lo restableces en el panel. Consulta El panel de administración.

Actualizar una versión anterior#

Los niveles y la experiencia se conservan. La nueva versión lee la misma tabla qs_miner y completa lo que le falte a una instalación anterior.

1. Haz una copia de seguridad y detén el servidor

   Haz una copia de seguridad de la base de datos y detén el servidor. Guarda una copia de tu antigua carpeta config/ para copiar tus valores desde ella.

2. Sustituye ambas carpetas

   Elimina los antiguos qs-minerjob y miner_props y coloca los nuevos. Copia tus precios, coordenadas y recompensas en el nuevo config.lua en lugar de reutilizar el archivo antiguo: tiene secciones nuevas que el script espera.

3. Arranca y lee la consola

   El primer arranque crea las tablas nuevas y muestra una línea por cada columna que añade:

   [qs-minerjob] Added missing column qs_miner.total_experience
   [qs-minerjob] aligned 2 identifier column(s) to utf8mb4_uca1400_ai_ci, matching users.identifier.

4. Apunta tu gestor de NPC a los exports

   Los peds separados del vendedor y de la clasificación y la caja de picos ya no existen. Los picos se compran en la pestaña Shop del panel, y un gestor de NPC abre la tienda y la clasificación mediante openSellMenu y openLeaderboard — consulta Comandos y exports.

Verificar la instalación#

Reinicia el servidor y lee la consola. Un arranque limpio no muestra nada alarmante; en ESX verás el trabajo registrado y, una vez usado el panel de administración, cuántos ajustes guardados se aplicaron:

[qs-minerjob] Registered the ESX job "miner"
[qs-minerjob] 3 saved setting(s) applied over config.lua.

Después date el trabajo y completa el primer ciclo:

1. Habla con el encargado del trabajo

   Sigue el blip Mining Zone hasta la cantera. El encargado está bajo un marcador azul flotante; pulsa E (o usa tu target) y la cámara pasa a él con el panel del trabajo abierto.

2. Compra un pico y acepta una misión

   Compra el Rusty Pickaxe en la pestaña Shop, y luego inicia Beginner's Excavation desde Missions. Tu atuendo cambia y aparece el seguimiento de la misión.

3. Mina y entrega

   Pulsa Z para sacar el pico, E en una roca de carbón para golpear, y lleva la roca a la cinta transportadora. Tres de carbón completan la misión y te pagan. A partir de aquí, Uso cubre todo lo demás.