Comandos yexports

Comandos#

Crafting Creator registra un comando para el staff. Los jugadores no necesitan ninguno: los bancos se abren acercándose a ellos.

La tecla es un key mapping de FiveM, así que cada jugador puede reasignarla en Settings → Key Bindings → FiveM. Cambiar Config.OpenCreatorKey solo cambia la tecla por defecto para los jugadores que nunca han tenido el mapping.

Comandos de depuración#

Con Config.Debug = true, existen algunos comandos de cliente más para ajustar cómo se ve un banco. Ninguno guarda nada — copia los valores que te gusten en config/main.lua.

El modo de depuración también registra comandos de prueba para desarrolladores en el servidor que escriben directamente en crafting_queue, e imprime cada acción en la consola. Úsalo en un servidor de pruebas y mantén Config.Debug = false en producción.

Hooks del servidor#

Crafting Creator no tiene exports de jugabilidad; los scripts se conectan a él desde el servidor, mediante cuatro hooks en server/custom/hooks.lua y los eventos más abajo. Los hooks son donde un script de habilidades o ventajas cambia un crafteo — un crafteo más rápido para un jugador hábil, un material ahorrado, un ítem extra — y el lugar seguro para otorgar su propia XP. Un error dentro de un hook se captura y se imprime; nunca rompe el crafteo.

function CraftingHooks.ModifyCraft(source, data)
    -- data.tableId, data.itemName, data.amount   requested amount
    -- data.duration     seconds per item
    -- data.ingredients  TOTAL materials for this craft { iron = 20, ... }
    -- data.earn, data.price, data.level
    -- data.preview      true while the list is shown, nothing taken yet
    -- data.mode         'queue' | 'proximity'

    -- your skill script's own export
    local perk = exports['my-skills']:GetLevel(source, 'crafting') or 0
    if perk < 5 then return end

    return {
        duration = math.floor(data.duration * 0.8),      -- 20% faster
        ingredients = {                                  -- one iron saved
            iron = math.max(0, (data.ingredients.iron or 0) - 1),
        },
        outputAmount = not data.preview and data.amount + 1 or nil,  -- one extra
    }
end

function CraftingHooks.OnCraftStarted(source, payload)
    -- payload.queueId, payload.tableId, payload.item, payload.amount,
    -- payload.outputAmount, payload.duration, payload.ingredients, payload.mode
end

function CraftingHooks.OnCraftCollected(source, payload)
    -- payload.amount           items delivered (with any bonus)
    -- payload.requestedAmount  items the player asked for
    -- payload.earn             crafting XP awarded
    exports['pn-skills']:AddXp(source, 'crafting', payload.amount)
end

function CraftingHooks.OnCraftCancelled(source, payload)
    -- payload.item, payload.amount, payload.reason, payload.mode
end

Eventos del servidor#

Los mismos momentos también se disparan como eventos de servidor, para que otro recurso pueda escucharlos sin tocar los archivos de Crafting Creator:

-- server side of any resource
AddEventHandler('qs-crafting:server:craftCollected', function(source, payload)
    if payload.item == 'weapon_pistol' then
        print(('%s crafted %d pistol(s) at bench %s'):format(
            GetPlayerName(source), payload.amount, payload.tableId))
    end
end)

Los argumentos que se pasan a otro recurso son copias. Escuchar modifyCraft desde fuera te dice cómo será un crafteo, pero cambiar mods ahí no tiene efecto — para cambiar un crafteo, usa CraftingHooks.ModifyCraft.

El payload#

Leer el nivel de crafteo de un jugador#

El nivel de cada jugador se guarda en un state bag replicado, crafting_skill, legible desde cualquier recurso en ambos lados — útil para un trabajo que solo contrata a crafteadores hábiles, o una tienda que muestra el nivel:

-- server
local skill = Player(source).state.crafting_skill
-- { level = 7, xp = 120, xpToNextLevel = 1139 }
if skill and skill.level >= 10 then
    -- ...
end

-- client
local skill = LocalPlayer.state.crafting_skill

Se establece cuando el jugador carga y se actualiza cada vez que gana XP. Trátalo como de solo lectura: el nivel se guarda a partir de la propia XP de Crafting Creator, así que escribir en el state bag desde otro script no se almacena.

Motivos de cancelación#

payload.reason en craftCancelled indica por qué un crafteo por proximidad no entregó. En todos los casos, el reembolso de Config.CraftingProgression.CancelRefund ya se ha entregado.