Система крафтинга FiveM: верстаки ox_inventory и пользовательский крафтинг

Крафтинг означает, что игрок превращает некоторые предметы в другой предмет. Вы можете использовать верстаки крафтинга, встроенные в ox_inventory, или написать свой собственный рецепт в скрипте. Эта статья показывает обе, а затем проверки, которые держат игроков от дублирования предметов.

#Верстаки крафтинга ox_inventory

Откройте ox_inventory/data/crafting.lua. Он возвращает список верстаков. Каждый верстак имеет список предметов для крафтинга и место в мире:

return {
    {
        items = {
            {
                name = 'lockpick',
                ingredients = {
                    scrap_metal = 5,
                    plastic = 2,
                },
                duration = 5000,
                count = 1,
            },
            {
                name = 'bandage',
                ingredients = {
                    cloth = 2,
                },
                duration = 3000,
            },
        },
        points = {
            vec3(1087.3, -3099.4, -39.0),
        },
    },
}

Что делает каждое поле:

Все названное в name или ingredients должно существовать в data/items.lua. Смотрите adding items to ox_inventory. Перезагрузите ox_inventory после редактирования файла.

Совет: значение ингредиента ниже 1 не потребляет предмет, он использует эту часть его прочности. Значение 0.1 на инструменте с прочностью использует десять процентов этого.

#Зоны вместо точек

Зона — это коробка, которую игрок может целевить:

zones = {
    {
        coords = vec3(1087.3, -3099.4, -39.0),
        size = vec3(1.5, 1.0, 1.0),
        distance = 1.5,
        rotation = 45.0,
    },
},

Зонам нужен ox_target для работы. Посмотрите примеры в вашей копии data/crafting.lua для точных полей вашей версии, так как формат меняется между выпусками. Для ограничения верстака работой, ox_inventory также читает groups на верстаке, такая же идея как в ox_inventory stashes.

#Пользовательский рецепт с проверками сервера

Если вы хотите свои собственные правила, такие как уровень мастерства, стоимость или полоса прогресса вашей собственной, напишите рецепт в вашем скрипте и позвольте ox_inventory только обрабатывать предметы. Важная часть в том, что сервер делает все:

-- server.lua
local crafting = {}

local recipe = {
    result = 'lockpick',
    ingredients = { scrap_metal = 5, plastic = 2 },
}

lib.callback.register('my_script:craft', function(source)
    if crafting[source] then return false end
    crafting[source] = true

    local ok = false

    -- 1. check every ingredient
    local hasAll = true
    for item, count in pairs(recipe.ingredients) do
        if exports.ox_inventory:Search(source, 'count', item) < count then
            hasAll = false
            break
        end
    end

    -- 2. check the player can carry the result
    if hasAll and exports.ox_inventory:CanCarryItem(source, recipe.result, 1) then
        -- 3. remove, then add
        local removed = {}
        local allRemoved = true
        for item, count in pairs(recipe.ingredients) do
            if exports.ox_inventory:RemoveItem(source, item, count) then
                removed[item] = count
            else
                allRemoved = false
                break
            end
        end

        if allRemoved and exports.ox_inventory:AddItem(source, recipe.result, 1) then
            ok = true
        else
            -- give back what was removed
            for item, count in pairs(removed) do
                exports.ox_inventory:AddItem(source, item, count)
            end
        end
    end

    crafting[source] = nil
    return ok
end)

Клиент спрашивает, воспроизводит полоску прогресса и только читает ответ:

-- client.lua
if lib.progressBar({ duration = 5000, label = 'Crafting' }) then
    local ok = lib.callback.await('my_script:craft', false)
    lib.notify({ description = ok and 'Crafted' or 'Missing items', type = ok and 'success' or 'error' })
end

Для функций обратного вызова и уведомлений смотрите server callbacks on ESX, QBCore and ox_lib.

#Советы против дублирования

Крафтинг — это классическое место для дублирования предметов, потому что предметы удаляются и добавляются в два шага. Держите эти правила:

• Только сервер. Сервер проверяет ингредиенты и дает результат. Клиент отправляет "Я хочу создать рецепт X", никогда количества или имена предметов, которые он составил.
• Проверь, затем удали, затем добавь. Никогда не добавляйте результат перед тем как удаление удалось. Если добавление не сработает, дайте ингредиенты обратно.
• Один крафт за раз. Флаг за игрока, как crafting[source] выше, останавливает заспамированное событие от запуска рецепта несколько раз параллельно.
• Проверьте CanCarryItem первым. Полный инвентарь — обычная причина, почему AddItem не сработает, и игрок потеряет ингредиенты.
• Проверьте расстояние. Если рецепт принадлежит верстаку, сравните координаты игрока с верстаком на сервере.
• Очистите состояние на падение. Сбросьте флаг, когда игрок уходит, так что отключение в середине не заблокирует рецепт.

AddEventHandler('playerDropped', function()
    crafting[source] = nil
end)

Для большего на защиту событий смотрите securing server events.

#Контрольный список