Roblox自定义背包开发报错：Attempt to index nil with 'EquipTool'

错误原因分析 #

出现Attempt to index nil with "EquipTool"错误，核心问题是调用humanoid:EquipTool()时humanoid为nil，或传入的工具实例不存在，同时代码存在多处潜在问题：

• Humanoid初始化时机错误：脚本启动时玩家Character可能未加载完成，导致player.Character:FindFirstChildOfClass("Humanoid")返回nil。
• 工具名称获取逻辑错误：使用tostring(Instance)无法正确获取工具名称，Roblox中需通过Instance.Name属性获取。
• 未处理无效按键：按下不在keyConversions中的按键时，convertedSlot为nil，访问hotbar[convertedSlot]会触发报错。
• 装备逻辑冗余不安全：通过名称查找工具易出现重名冲突，且未验证工具是否成功移动到背包。

修复后的完整代码 #

local uis = game.UserInputService
local player = game.Players.LocalPlayer
local playerGui = player.PlayerGui

-- 等待Character加载完成并获取Humanoid
local character = player.Character or player.CharacterAdded:Wait()
local humanoid = character:WaitForChild("Humanoid")

local hotbar = playerGui.Inventory.Hotbar
local inventoryFolder = player.InventoryFolder

local keyConversions = {
    [Enum.KeyCode.One] = 1,
    [Enum.KeyCode.Two] = 2,
    [Enum.KeyCode.Three] = 3,
    [Enum.KeyCode.Four] = 4,
    [Enum.KeyCode.Five] = 5,
    [Enum.KeyCode.Six] = 6,
    [Enum.KeyCode.Seven] = 7,
    [Enum.KeyCode.Eight] = 8,
    [Enum.KeyCode.Nine] = 9,
    [Enum.KeyCode.Zero] = 10,
}

local function fillInventoryFolder()
    for _, tool in pairs(player.Backpack:GetChildren()) do
        if tool:IsA("Tool") then -- 仅移动工具类对象
            tool.Parent = inventoryFolder
        end
    end
end

local function updateHotbar()
    local maxSlots = 10 -- 对应10个按键，原11为错误值
    local slotIndex = 1
    
    -- 清理无效插槽引用
    for i = 1, maxSlots do
        local slot = hotbar[i]
        if slot and slot.SlotItem.Value and slot.SlotItem.Value.Parent ~= inventoryFolder then
            slot.SlotItem.Value = nil
            slot.Image = ""
        end
    end
    
    -- 填充有效工具到插槽
    for _, tool in pairs(inventoryFolder:GetChildren()) do
        if tool:IsA("Tool") and slotIndex <= maxSlots then
            local slot = hotbar[slotIndex]
            if slot and slot.SlotItem.Value == nil then
                slot.SlotItem.Value = tool
                -- 验证图片资源存在后赋值
                local imageAsset = game.ReplicatedStorage.HotbarImages:FindFirstChild(tool.Name)
                if imageAsset then
                    slot.Image = imageAsset.Texture
                end
                slotIndex += 1
            end
        end
    end
end

local function equip(keyCode)
    local convertedSlot = keyConversions[keyCode]
    if not convertedSlot then return end -- 忽略无效按键
    
    local slot = hotbar[convertedSlot]
    if not slot then return end
    
    local tool = slot.SlotItem.Value
    if not tool or tool.Parent ~= inventoryFolder then return end -- 验证工具存在且在背包文件夹中
    
    -- 直接移动并装备工具实例
    tool.Parent = player.Backpack
    humanoid:EquipTool(tool)
end

fillInventoryFolder()

-- 监听Character刷新，重新绑定Humanoid
player.CharacterAdded:Connect(function(newCharacter)
    character = newCharacter
    humanoid = newCharacter:WaitForChild("Humanoid")
end)

uis.InputBegan:Connect(function(input, processed)
    if processed then return end -- 忽略已处理的输入（如聊天框输入）
    if input.UserInputType == Enum.UserInputType.Keyboard then
        equip(input.KeyCode)
    end
end)

-- 用Heartbeat替代循环wait，提升性能
game.RunService.Heartbeat:Connect(updateHotbar)

关键修复点说明 #

• 确保Character加载完成：通过player.Character or player.CharacterAdded:Wait()等待角色加载，用WaitForChild安全获取Humanoid，避免nil错误。
• 直接操作工具实例：装备时直接传入工具对象，无需通过名称查找，消除重名和移动失败的风险。
• 过滤无效输入：在equip函数开头校验按键有效性，避免访问不存在的插槽。
• 优化Hotbar更新逻辑：清理无效引用、验证图片资源、限制插槽数量，提升稳定性。
• 性能优化：用Heartbeat替代while wait() do循环，减少性能消耗。
• 类型过滤：仅处理Tool类型对象，避免非工具物品进入背包系统。

内容的提问来源于stack exchange，提问作者TrulyBlue2