Uso

El panel del capataz#

Todo empieza con Big Ray, el capataz del aserradero sobre Paleto Bay, marcado en el mapa como Lumberjack Zone y en el mundo con un marcador azul flotante. Pulsa E a su lado (o elige Start Working con tu recurso de target) y la cámara pasa a él mientras su panel se abre en la mitad derecha de la pantalla.

La cabecera muestra el nivel del jugador, la barra de experiencia y su bonificación actual de probabilidad de botín. Cualquiera puede abrir el panel para ver la tienda y las clasificaciones; aceptar una misión es lo que requiere el trabajo.

El nombre y el saludo de la tarjeta del capataz son Config.PedName y Config.PedGreeting; deja cualquiera vacío para ocultarlo. Su modelo y posición son Config.Locations.pedManager, y el marcador sobre él es Config.PedMarker.

El ciclo de trabajo#

1. Compra un hacha

   Tienda → Buy axes. La Rusty Axe está disponible para todos; las mejores hachas se desbloquean con el nivel.

2. Sácala

   Usa el hacha desde el inventario y aparecerá en tu mano. Úsala de nuevo para guardarla.

3. Acepta un contrato

   Opcional, pero ahí está el dinero. Elige una misión, trae una cuadrilla si quieres y pulsa Start mission. Te cambias al uniforme de trabajo, cada árbol en pie recibe un blip y un seguimiento muestra lo que queda pendiente.

4. Tala árboles

   Colócate junto a un tronco, míralo y pulsa el botón izquierdo del ratón para golpear. Cada golpe sacude el árbol; cuando se agota su salud cae en una lluvia de astillas.

5. Recoge la madera

   De un árbol talado salen volando tres piezas de madera. Acércate a menos de dos metros y se atraen hacia ti; el botín se sortea en el momento en que se recoge una.

6. Corta y vende

   Convierte los troncos en tablones en el bloque de corte por aproximadamente el doble de precio y luego véndelos desde la Tienda.

El bosque#

El bosque son tres zonas, cada una un nivel en Config.Trees con su propio requisito de nivel, sus propias posiciones de árboles y las probabilidades de lo que crece allí.

Los árboles aparecen para un jugador cuando se acerca a menos de 500 metros del aserradero, y el servidor guarda el tipo y la salud de cada árbol, así todos ven el mismo bosque. Un árbol talado vuelve a crecer tras Config.RespawnTime (15 segundos), y en un nivel con varios tipos puede volver a crecer como otro distinto. Los blips de árboles (Config.TreeBlips) solo se muestran mientras un jugador está en una misión.

Config.Trees = {
    [2] = {
        levelRequired = 3,          -- the level needed to fell here
        chances = { tree2 = 100 },  -- what grows back, as weights
        coords = {
            vec3(-669.876892, 5333.393555, 64.833008),
            vec3(-678.145081, 5329.213379, 67.175049),
            -- one line per tree
        }
    },
}

Por estos bosques rondan pumas, y un trabajador quieto junto a un árbol es una presa fácil. Config.RemoveMountainLions elimina a los que se acercan a menos de 100 metros del aserradero, y no toca a ningún otro animal.

Madera y botín#

Cada tipo de madera en Config.WoodTypes define el modelo del árbol, cuánto daño hace falta para talarlo, la experiencia que da y lo que suelta.

Cada botín es una fila de cinco valores. El último es el precio de venta de una unidad, y es el único lugar donde se establece ese precio:

--  item name       label          chance  max  price
{ "pine_wood",    "Pine wood",     100,    1,     5 },
{ "pine_resin",   "Pine resin",     20,    3,     7 },
{ "wood_shavings", "Wood Shavings",  10,    2,     9 },

Cómo se sortea el botín#

Cada fila se sortea una vez por árbol talado, en el servidor. Su probabilidad aumenta con el hacha, el nivel y una arboleda rica, con un límite de 100:

chance = chance × (1 + axe bonus / 100) + level × 0.5 + rich grove bonus

-- Pine resin, level 10, Iron-Edged Axe:  20 × 1.10 + 5 = 27%

Cuando una fila cae, la primera unidad es segura y cada una adicional es menos probable que la anterior, así que el máximo es un techo y no una cantidad: un 3 suele dar 1 o 2. La primera fila de cada árbol es la propia madera, al 100 %.

La madera queda reservada para el jugador que taló el árbol durante Config.DropProtectionTime (10 segundos); después cualquiera puede recogerla, y la madera sin recoger desaparece a los cinco minutos. La madera que no cabe en el inventario se pierde y al jugador se le avisa de que su inventario está lleno; la experiencia y el progreso de la misión solo se pagan por la madera que realmente llegó.

Hachas#

El daño se resta de la salud del árbol en cada golpe. La durabilidad es cuántos golpes aguanta el hacha: cada golpe cuesta el durabilitypenalty del árbol, y un golpe que rompe el hacha no daña el árbol. La bonificación de botín multiplica cada probabilidad de botín. Con varias hachas en la mochila, cuenta la mejor.

Config.AxeLevel = {
    ["axe_iron"] = {
        prop = "prop_dynasty_axe_lvl_2",  -- the model in hand
        label = 'Iron-Edged Axe',
        durability = 300,
        price = 300,
        levelRequired = 3,
        itemAcquisitionBonus = 10,          -- percent, on every drop chance
        damage = 35
    },
}

El golpe es el botón izquierdo del ratón, una asignación de tecla de FiveM que cada jugador puede cambiar. Un golpe solo cuenta frente a un tronco al alcance; cualquier otra cosa es un fallo. Config.AxeAttachment define dónde se coloca el hacha en la mano, y Config.AxeWithdrawAnimation reproduce una animación corta al sacarla.

El bloque de corte#

Junto al aserradero hay tres tocones. Cortar un tronco allí lo convierte en un tablón que vale aproximadamente el doble.

1. Acércate con el hacha en la mano

   Pulsa E, o elige Use chopping block con tu target. La cámara encuadra el tocón y se coloca un tronco encima.

2. Golpea

   Cada pulsación de E es un golpe y un tablón, alrededor de un segundo y medio cada uno. Siempre se corta primero el tronco más valioso que llevas, y el panel muestra los tablones hechos, el siguiente tronco y la cola.

3. Sal

   ESC entre golpes, o sigue hasta que todos los troncos estén cortados y la sesión se cierre sola.

Config.ChopWood = {
    Locations = {
        { coords = vector3(-573.6, 5378.9, 68.5), heading = 0.0 },
        -- one line per stump
    },
    Drops = {
        ['pine_wood'] = { item = 'pinewood_plank', price = 10 },
    }
}

Si el tablón no cabe en el inventario, se devuelve el tronco. Los tablones solo cuentan para el dinero: cortar no puede fallar, así que se deja fuera de los logros a propósito.

Misiones y cuadrillas#

Las misiones son pedidos de madera que se aceptan desde el panel del capataz. Estas vienen incluidas en Config.Tasks:

{
    taskOrder = 3,                         -- unique, do not reuse
    name = "Apprentice Woodcutter",
    img = "lumberjack_img3.png",           -- lumberjack_img1, 2 or 3
    description = "Venture deeper into the woods...",
    recommendedPlayers = { 1, 4 },
    levelRequired = 3,
    woodAmount   = { 100, 75 },            -- read in pairs with woodRequired
    woodRequired = { "pine_wood", "oak_wood" },
    experience = 800,
    money = 1000
},

Solo los troncos cuentan para un pedido (pine_wood, oak_wood, maple_wood), y la madera de cada miembro de la cuadrilla cuenta para el mismo pedido. Cuando se completa, se paga a todos los que siguen en la cuadrilla, vuelven a su propia ropa y los blips de los árboles desaparecen.

Formar una cuadrilla#

• Una cuadrilla admite hasta Config.MaxPartyMembers jugadores, líder incluido: cuatro por defecto.

• Invita por ID de servidor desde un hueco vacío. El jugador debe estar a menos de Config.InviteDistance metros (20; 0 permite cualquier distancia) y tiene 60 segundos para aceptar. No se puede volver a invitar al mismo jugador durante 20 segundos.

• Con qs-party en ejecución, los miembros de tu grupo llenan la cuadrilla solos.

• Cada miembro debe cumplir el nivel de la misión, y nadie puede estar en dos cuadrillas a la vez. El servidor comprueba ambas cosas cuando empieza la misión.

• Las fichas de la cuadrilla muestran la cara real de cada miembro cuando está cerca, y sus iniciales en caso contrario.

Cómo se paga a una cuadrilla#

Lo que pide una misión no crece con la cuadrilla, así que cuatro jugadores traen la misma carga que uno. Salir (Abandon mission en el panel, desconectarse o perder el trabajo) saca a ese jugador de la cuadrilla y de su pago; la misión continúa para los que quedan.

Niveles y experiencia#

La experiencia viene de cada árbol que te llevas, de las misiones, de los logros reclamados y de los premios de los torneos. No hay límite de nivel: cada nivel necesita un poco más que el anterior.

Config.LevelExperience = {
    LevelBonusMultiplier = 0.5,  -- drop-chance points added per level
    BaseExperience = 3500,       -- experience from level 1 to 2
    GrowthFactor = 1.1,          -- each level needs 10% more than the last
}

Cada nivel también añade LevelBonusMultiplier puntos a cada probabilidad de botín (+5 en el nivel 10), que el panel muestra como la bonificación de probabilidad de botín.

La tienda#

Buy axes lista cada hacha con su nivel, precio, durabilidad, daño y bonificación de botín, y cuántas tienes ya. Sell wood lista todo lo vendible de tu inventario (troncos, subproductos y tablones) con su precio y lo que vale todo tu montón. Elige ítems y cantidades, o Sell all.

Los precios nunca se mueven con un mercado: lo que lista la tienda es lo que paga el servidor, leído de la configuración. El dinero se paga en efectivo: la cuenta money en ESX, cash en QBCore. El símbolo de moneda es la línea CURRENCY_TYPE de las traducciones, y Config.CurrencyPosition lo pone antes o después de la cantidad.

Clasificaciones#

Statistics en el panel contiene cuatro clasificaciones. Los jugadores se ordenan por experiencia, con sus ganancias al lado, y tu propia fila aparece resaltada.

Cuando se reinicia la clasificación diaria o de temporada, se paga a los tres primeros desde Config.LeaderBoardRewards, el panel los muestra como los últimos ganadores y hace una cuenta atrás hasta el siguiente reinicio. A un ganador desconectado se le guarda el premio y se le paga en su próximo inicio de sesión.

Config.EnableLeaderboard = true      -- false hides Statistics entirely
Config.UpdateLeaderboard = 1         -- minutes between refreshes
Config.MaxLeaderboardPlayers = 100   -- rows per tab

Config.LeaderBoardRewards = {
    Daily  = { [1] = 5215, [2] = 350,  [3] = 200 },
    Season = { [1] = 5000, [2] = 3500, [3] = 2000 },
}

Las ganancias de la clasificación son el pago de misiones, el dinero de logros reclamados y los premios de torneos. La madera vendida en la tienda no cuenta, así la clasificación mide el trabajo y no el mercado.

Logros#

Los logros son un registro de lo que un leñador ha hecho realmente, contado en el servidor. Completar uno no paga en el acto: una notificación indica que se ha obtenido, y la recompensa espera en el capataz hasta que el jugador abre Achievements y pulsa Claim. La pantalla tiene dos pestañas (Wood y Milestones) y una insignia para lo que esté pendiente.

Los logros de madera se generan, uno por entrada en Config.WoodTypes, con sus objetivos en WoodGoal y sus recompensas en WoodReward: un tipo de madera nuevo obtiene su propio logro sin tocar la lista. Una misión completada por una cuadrilla cuenta para cada miembro.

Añadir los tuyos#

Config.Achievements.List = {
    { id = 'felled_100', icon = 'tree', type = 'totalFelled', value = 100, reward = 700, experience = 900 },
    { id = 'maple_100', icon = 'leaf', type = 'wood', wood = 'tree3', value = 100, reward = 6000, experience = 7000 },
    { id = 'quests_10', icon = 'clipboardCheck', type = 'counter', counter = 'quests', value = 10, reward = 2000, experience = 2500 },
}

Iconos: tree, treeCity, leaf, crown, medal, star, trophy, layerGroup, clipboardCheck y chartLine; cualquier otro nombre muestra un trofeo. El nombre y la descripción vienen de ACHIEVEMENT_<ID> y ACHIEVEMENT_<ID>_DESC en las traducciones.

Arboledas ricas#

De vez en cuando un tipo de madera se vuelve rico en todo el bosque. No es un lugar sino una especie: mientras el arce es rico, el arce vuelve a crecer más a menudo, suelta más y da más experiencia, y todo lo demás sigue igual. Los leñadores reciben una notificación y un reloj en pantalla mientras dura.

Config.RichGroves = {
    Enabled = true,
    Duration = 20,              -- minutes one lasts
    LumberjacksOnly = true,     -- false: anyone who chops benefits
    Boost = { Spawn = 3.0, DropChance = 25, Quantity = 1.6, Experience = 1.5 },
    Woods = { tree1 = 40, tree2 = 30, tree3 = 12, default = 20 },  -- weights, 0 = never
    Random = { Enabled = true, MinInterval = 30, MaxInterval = 75 },
}

Una arboleda se abre sola entre 30 y 75 minutos al azar después de que se cerrara la anterior. El arce tiene poco peso a propósito: una arboleda rica de arce debería ser lo que hace que la gente se conecte. Los administradores pueden abrir o cerrar una en cualquier momento desde la pestaña Events del panel de administración.

Torneos#

Un torneo es una competición con tiempo en todo el bosque: no hay ninguna zona en la que estar. Los leñadores reciben un aviso cinco minutos antes, un marcador en vivo muestra ambas clasificaciones mientras dura, y todos los que talaron un árbol ven el marcador final.

Un jugador puede ganar ambas y cobra por cada una. El dinero va a los ganadores que estén conectados cuando termina. Cada victoria se registra para la clasificación Tournament wins.

Config.Tournaments = {
    Enabled = true,
    Duration = 20,               -- minutes
    AnnounceBefore = 5,          -- minutes of warning, 0 for none
    LumberjacksOnly = true,
    ShowResults = true,          -- the scoreboard for entrants
    Schedule = { { at = '14:00' }, { at = '19:00' }, { at = '22:30' } },  -- server time
    Random = { Enabled = true, CheckEvery = 60, Chance = 25 },
    Points = { tree1 = 1, tree2 = 3, tree3 = 8, default = 3 },
    MinimumEntries = 1,          -- entrants needed before anything is paid
}

Además del calendario, cada CheckEvery minutos hay una tirada del Chance % para uno no programado. Iguala los puntos y las dos clasificaciones se convierten en la misma carrera. Prizes contiene ambas escalas; elimina una fila y ese puesto no paga nada.

El panel de administración#

/lumberjackadmin abre un editor en el juego para cada ajuste de config.lua, agrupados en secciones, cada ajuste con su línea de ayuda. Un cuadro de búsqueda encuentra cualquier ajuste en todas ellas, y todo lo que se haya cambiado respecto al archivo queda marcado.

Las coordenadas nunca se escriben: Use my position rellena el lugar donde estás (con tu orientación cuando hace falta), Go there te teletransporta para comprobar un punto, y Waypoint lo marca en el mapa. Las listas (árboles, tareas, logros) tienen botones para añadir y quitar, y los ajustes con un conjunto fijo de respuestas ofrecen una selección en lugar de un cuadro de texto.

Los guardados van a la base de datos, nunca a config.lua, y se aplican sobre el archivo al arrancar. Back to the file's value borra un ajuste guardado y Reset everything los borra todos. El framework detectado, los textos de traducción y el uniforme de clothing.lua no se editan desde el panel. Cada guardado puede registrarse en Discord con quién lo hizo; consulta Integraciones.

Ajustes generales#

El resto de config.lua, como referencia: