【Mod开发每日一课】第1期：通过坐标判断玩家是否在指定区域内

废话不多说，直接上代码哈  

public static class WorldUtils {
    public static bool IsPlayerInArea(this World world, int id, Vector3 minBounds, Vector3 maxBounds) {
        if (world is null) {
            return false;
        }
        
        EntityPlayer player;
        if (!world.Players.dict.TryGetValue(id, out player)) {
            return false;
        }
        
        Vector3 playerPos = player.GetPosition();
        bool bInXRange = playerPos.x >= minBounds.x && playerPos.x <= maxBounds.x;
        bool bInZRange = playerPos.z >= minBounds.z && playerPos.z <= maxBounds.z;
        
        return bInXRange && bInZRange;
    }
}

1. 方法的签名与特性

• 首先这是一个扩展方法（通过 this World world 实现），用于给 World 类增加自定义功能。

• 方法名 IsPlayerInRange 表示 “判断玩家是否在范围内”。

• 参数说明：

• world：当前游戏世界的实例（扩展方法的目标对象）。

• id：要检测的玩家实体 ID。

• from：区域的起始坐标（Vector3 类型，包含 x、y、z 分量）。

• to：区域的结束坐标（Vector3 类型，包含 x、y、z 分量）。

• 返回值：bool 类型，true 表示玩家在区域内，false 表示不在。

2. 空值校验

• 第 1 步：检查 world 是否为 null（若游戏世界未加载，直接返回 false）。

• 第 2 步：通过 world.Players.dict.TryGetValue(id, out player) 尝试根据 id 获取玩家实体 player。若找不到该 ID 对应的玩家，返回 false。

3. 区域范围判断逻辑

• 第 1 步：通过 player.GetPosition() 获取玩家的当前坐标 playerPos。

• 第 2 步：定义两个布尔变量，分别判断玩家是否在X 轴范围和Z 轴范围内：

• bInXRange：玩家的 X 坐标是否在 from.x 到 to.x 之间。

• bInZRange：玩家的 Z 坐标是否在 from.z 到 to.z 之间。

• 第 3 步：返回最终结果（只有 X 和 Z 轴都在范围内时，才返回 true）。

好啦，每日教程一分享到此结束……