饥荒传送mod如何避免角色卡地形？

Question

在使用《饥荒》传送类Mod（如Teleport Mod或Custom Gateway）时，玩家常遇到角色传送到目标位置后卡入地形内部或障碍物中，导致无法移动甚至游戏崩溃。该问题通常源于目标坐标未进行有效碰撞检测，或Mod未调用原版安全位置校验函数。如何通过代码判断传送落点是否为空地，并自动寻找最近的安全立足点，成为开发与使用此类Mod时的关键技术难点。

Answer 1

一、问题背景与现象分析

在《饥荒》（Don't Starve）的Mod开发中，传送类功能（如Teleport Mod或Custom Gateway）广受玩家欢迎。然而，一个长期存在的技术痛点是：角色在执行传送后，常出现“卡入地形”、“陷入障碍物”甚至“游戏崩溃”的异常行为。这类问题的核心原因在于目标坐标未经过有效的碰撞检测，或Mod开发者未调用原版引擎提供的安全位置校验机制。

此类现象不仅影响用户体验，还可能导致存档损坏或服务器异常退出。尤其在多人联机版（Don't Starve Together）中，该问题的严重性被进一步放大。

二、技术成因深度剖析

1. 坐标直接赋值：多数简易Mod通过直接设置玩家坐标（如inst.Transform:SetPosition(x, 0, z)）实现传送，跳过了原版的安全检查流程。
2. 忽略地形层级：《饥荒》地图包含多个地形层（如地面、洞穴、岩石区），部分区域虽坐标合法但不可行走。
3. 未调用IsPassableTile或CanDeploy：这些原生函数用于判断某坐标是否为可通行地块，缺失调用将导致落点无效。
4. 缺乏Fallback机制：当目标点不可用时，未设计自动寻路至最近安全点的备用逻辑。
5. 多实体叠加判定缺失：未检测落点是否已被其他实体（如树、岩石、建筑）占据。

三、核心解决方案框架

步骤	技术手段	对应API/函数
1. 坐标合法性初筛	检查是否位于地图边界内	Map:IsPointInMapBounds(x, z)
2. 地形可通行性检测	判断是否为可行走地表	Map:IsPassableAtPoint(x, y, z)
3. 实体冲突检测	检测是否有静态障碍物	GetEntityUnderMouse() 或 TheWorld:QuerySceneGraph(x, z)
4. 安全高度校正	调整Y轴避免悬空或嵌入	TerrainUtil.FindValidGroundPosition(x, z)
5. 邻域搜索算法	若原点无效，搜索周边8方向	八邻域螺旋扫描

四、关键代码实现示例

local function FindSafeTeleportSpot(x, z, radius)
    local map = TheWorld.Map
    local max_checks = (radius * 2 + 1)^2
    local dx, dz = 0, 0
    local step = 1

    -- 螺旋搜索最近安全点
    for i = 0, max_checks - 1 do
        for j = 0, step - 1 do
            if map:IsPassableAtPoint(x + dx, 0, z + dz) and 
               not map:IsOceanAtPoint(x + dx, 0, z + dz) then
                local ground_y = TerrainUtil.FindValidGroundPosition(x + dx, z + dz)
                if ground_y then
                    return x + dx, ground_y, z + dz
                end
            end
            dx = dx - 1
        end
        dx = dx + 1; dz = dz + 1

        for j = 0, step - 1 do
            if map:IsPassableAtPoint(x + dx, 0, z + dz) and 
               not map:IsOceanAtPoint(x + dx, 0, z + dz) then
                local ground_y = TerrainUtil.FindValidGroundPosition(x + dx, z + dz)
                if ground_y then
                    return x + dx, ground_y, z + dz
                end
            end
            dz = dz - 1
        end
        dz = dz + 1; step = step + 1
    end
    return nil
end

五、流程图：安全传送决策逻辑

graph TD A[接收目标坐标(x,z)] --> B{坐标在地图范围内?} B -- 否 --> C[返回失败] B -- 是 --> D{IsPassableAtPoint(x,z)?} D -- 否 --> E[启动螺旋搜索(radius=5)] D -- 是 --> F{存在实体阻挡?} F -- 是 --> E F -- 否 --> G[计算地面高度Y] E --> H[找到最近有效点?] H -- 否 --> C H -- 是 --> I[执行传送:SetPosition()] I --> J[播放视觉反馈特效]

六、高级优化策略

• 缓存地形数据：使用TheWorld.topology预加载区域信息，减少实时查询开销。
• 异步校验：对远距离传送采用协程分帧处理，避免卡顿。
• 生物群系过滤：支持配置“禁止传送到蜘蛛巢附近”等规则。
• 日志调试接口：记录每次传送的校验路径，便于问题追溯。
• 兼容DST集群模式：确保在Caves和Surface之间传送时正确切换场景。
• 网络同步处理：在多人游戏中，需通过RPC通知所有客户端更新位置。
• 防滥用机制：加入冷却时间或资源消耗，防止利用传送Bug刷怪。
• 可视化调试工具：开发GM命令显示安全区域热力图。