为何无法解除玩家封禁？Roblox管理员系统故障排查

核心问题分析 #

1. 解封逻辑依赖玩家在线状态：原代码中只有当目标玩家在线时才会执行解封操作，离线玩家的解封请求被直接跳过，导致Workspace中的封禁标记未被删除，玩家再次进入游戏时仍会被判定为封禁状态。
2. PlayerAdded事件存在空值风险：直接对FindFirstChild的返回值调用:IsA()，如果返回nil会触发运行时错误。
3. Unban遍历逻辑低效且冗余：遍历所有WedgePart来查找封禁标记的方式不仅效率低，还可能出现匹配错误。

修复后的完整代码 #

-- 玩家进入游戏时检查封禁状态
game.Players.PlayerAdded:Connect(function(plr)
    local banMarker = game.Workspace:FindFirstChild(plr.Name .. " / Banned")
    -- 先判断标记是否存在，再验证类型，避免空值错误
    if banMarker and banMarker:IsA("WedgePart") then
        plr:Kick("Banned")
        print(plr.Name .. " tried to join while banned")
    end
end)

-- 处理管理员指令事件
script.Parent["Kick/Ban"].OnServerEvent:Connect(function(plr, plrname, reason, kb)
    local target = game.Players:FindFirstChild(plrname)

    if kb == "Kick" then
        -- 踢人操作必须目标玩家在线
        if target then
            target:Kick(reason ~= "" and reason or nil)
        end
    elseif kb == "Ban" then
        if target then
            local banMarker = Instance.new("WedgePart")
            print(target.Name .. " has been banned")

            banMarker.Parent = game.Workspace
            banMarker.Name = target.Name .. " / Banned"
            banMarker.CanCollide = false
            banMarker.Transparency = 1
            banMarker.Anchored = true
            
            target:Kick("Banned")
        end
    elseif kb == "Unban" then
        local banMarkerName = plrname .. " / Banned"
        -- 直接通过名称查找封禁标记，无需遍历所有部件
        local banMarker = game.Workspace:FindFirstChild(banMarkerName)
        if banMarker and banMarker:IsA("WedgePart") then
            banMarker:Destroy()
            print(plrname .. " has been unbanned")
        else
            print(plrname .. " is not banned")
        end
    end
end)

关键修复说明 #

• 解除在线依赖：将原代码中包裹整个逻辑的玩家在线判断拆分，仅在Kick、Ban操作时检查玩家是否在线，Unban操作直接通过玩家名称查找并删除封禁标记，无论玩家是否在线都能执行。
• 修复空值错误：PlayerAdded事件中先判断封禁标记是否存在，再验证其类型，避免nil值触发错误。
• 优化查找效率：Unban时直接使用FindFirstChild按名称查找标记，替代原有的遍历逻辑，提升效率同时避免匹配错误。
• 简化代码逻辑：用三元表达式简化Kick操作中的reason判断，让代码更简洁易读。

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