Предметы в руках: Tool, рюкзак и почему всё пропадает после смерти

Инвентарь в Roblox уже написан за тебя. Панель внизу экрана, выбор цифрами, перетаскивание — всё это работает из коробки, как только в рюкзаке игрока появляется объект Tool. Проблема новичков не в том, чтобы это включить, а в том, что предметы ведут себя не так, как ожидалось: пропадают, не берутся в руки или срабатывают у всех сразу.

Tool и обязательный Handle#

Tool — это контейнер. Сам по себе он невидим; видно то, что внутри. Одна деталь внутри должна называться ровно Handle — за неё персонаж и берётся. Имя чувствительно к регистру: handle не подойдёт.

Где предмет лежит#

Три места, и путать их не стоит:

• Workspace — предмет лежит в мире, его можно подобрать, подойдя вплотную
• StarterPack — выдаётся каждому игроку при появлении, всегда и всем
• Player.Backpack — текущий рюкзак конкретного игрока в этой жизни
• Player.StarterGear — что вернуть игроку после смерти

Почему предмет пропадает после смерти#

Это не баг и не потеря данных. При возрождении Roblox очищает Backpack и заново наполняет его из двух мест: StarterPack (общий для всех) и StarterGear (личный). Если ты положил меч только в рюкзак, после смерти его там не будет — рюкзака больше нет.

local serverStorage = game:GetService("ServerStorage")

local function giveTool(player, toolName)
    local template = serverStorage:FindFirstChild(toolName)

    if not template then
        warn("Нет предмета " .. toolName .. " в ServerStorage")
        return
    end

    -- В рюкзак — чтобы предмет появился прямо сейчас.
    template:Clone().Parent = player.Backpack
    -- В StarterGear — чтобы он вернулся после следующей смерти.
    template:Clone().Parent = player.StarterGear
end

Действия предмета#

У Tool три события, которые нужны почти всегда:

local tool = script.Parent
local handle = tool:WaitForChild("Handle")
local light = handle:WaitForChild("SpotLight")

light.Enabled = false

tool.Activated:Connect(function()
    light.Enabled = not light.Enabled
end)

tool.Unequipped:Connect(function()
    light.Enabled = false -- убрал фонарь — свет гаснет
end)

Клиент или сервер#

Скрипт внутри Tool может быть и обычным, и локальным, и выбор здесь не вкусовой.

• Script (сервер) — всё, что меняет мир и влияет на других: урон, выдача монет, открытие двери, поломка ящика
• LocalScript (клиент) — всё, что видит и слышит только владелец: анимация замаха, прицел, звук в наушниках, подсветка цели
• если действие нужно и там, и там — клиент показывает, сервер решает

Подобрать предмет с земли#

Лежащий в Workspace Tool подбирается сам, когда персонаж его касается, — отдельный код не нужен. Проблема в том, что случайное касание при пробежке мимо тоже считается. Если предметы должны подбираться намеренно, положи их в ServerStorage, а в мире оставь деталь с ProximityPrompt: нажал — сервер выдал копию.

Что обычно ломается#

Когда предмет лежит в руке правильно, следующий шаг — замах, удар или бросок: как это делается, разобрано в гайде про анимации персонажа.