Roblox Studio Lua放置系统网格吸附异常问题求助

问题现象 #

编写Roblox Studio Lua放置系统实现网格吸附功能时，仅能在-X和+Z方向依托已存在的方块进行搭建，其他方向会直接吸附到目标方块本身，但在地面上可正常搭建。后续计划将脚本改为服务器端。

原代码如下：

local player = game.Players.LocalPlayer
local mouse = player:GetMouse()
local mousePosition = mouse.Hit

local function Snap(gridSize)
    local posX = math.floor(mouse.Hit.X / gridSize + 0.5) * gridSize 
    local posY = math.floor(mouse.Hit.Y / gridSize + 0.5) * gridSize
    local posZ = math.floor(mouse.Hit.Z / gridSize + 0.5) * gridSize
    print("Input:")
    print(mouse.Hit.X)
    print(mouse.Hit.Y)
    print(mouse.Hit.Z)
    print("Result:")
    print(posX)
    print(posY)
    print(posZ)
    return Vector3.new(posX,posY,posZ)
end

mouse.Button1Down:Connect(function()
    
    local part = game.ReplicatedStorage.part:Clone()
    part.Position = Snap(4)
    part.Parent = game.Workspace
    
end)

问题原因 #

当前代码直接对mouse.Hit返回的碰撞点位置做网格对齐，但mouse.Hit的碰撞点位于已有方块的表面。直接对齐后，新方块的位置会和目标方块重叠，只有当碰撞点的位置刚好处于相邻网格的临界位置时（如-X、+Z方向），才会正确放置到旁边。地面作为平面，碰撞点在地面上，对齐后不会有重叠问题。

解决方案 #

需要根据碰撞表面的法线方向，将吸附位置偏移半个网格尺寸（假设方块大小与网格尺寸一致，均为4，半尺寸为2），确保新方块贴在目标方块的相邻网格位置：

• 获取mouse.Hit的Normal属性，即碰撞表面的法线方向
• 用法线方向乘以网格大小的一半，得到偏移量
• 将碰撞点位置加上偏移量后再进行网格对齐

修改后代码 #

local player = game.Players.LocalPlayer
local mouse = player:GetMouse()
local gridSize = 4
local halfGrid = gridSize / 2 -- 半网格尺寸，对应方块半边长

local function Snap()
    local hit = mouse.Hit
    local basePos = hit.Position
    -- 根据碰撞法线计算偏移量，确保新方块贴在目标方块外侧
    local offset = hit.Normal * halfGrid
    local targetPos = basePos + offset
    
    -- 对偏移后的位置进行网格对齐
    local posX = math.floor(targetPos.X / gridSize + 0.5) * gridSize 
    local posY = math.floor(targetPos.Y / gridSize + 0.5) * gridSize
    local posZ = math.floor(targetPos.Z / gridSize + 0.5) * gridSize
    
    print("Hit Position:", basePos)
    print("Offset:", offset)
    print("Snapped Position:", Vector3.new(posX, posY, posZ))
    return Vector3.new(posX, posY, posZ)
end

mouse.Button1Down:Connect(function()
    local part = game.ReplicatedStorage.part:Clone()
    part.Position = Snap()
    part.Parent = game.Workspace
end)

关键说明 #

• hit.Normal返回碰撞表面的单位法线向量，指向远离碰撞物体的方向，乘以半网格尺寸后，能让新方块刚好贴在目标方块的相邻位置
• 先偏移再做网格对齐，确保最终位置落在正确的网格节点上
• 若方块尺寸与网格尺寸不一致，需要调整halfGrid的值为方块半边长，保证贴合效果

内容的提问来源于stack exchange，提问作者СЯΑFТЕЯВΟУ27