游戏客户端架构 / 系统课时
碰撞层和 Mask 怎么设计
碰撞层和 Mask 怎么设计
当玩家、敌人、子弹、环境与交互区域同时存在时,如果让所有对象互相检测,就会产生无效接触和错误事件。本课从五类对象建立一张可执行的过滤矩阵,说明 Layer、Mask 和物理碰撞规则的职责,并使用 Unity 3D 验证配置结果。
学习目标
- 根据对象职责划分碰撞层,并明确 Layer 与 Mask 的区别。
- 为五类游戏对象设计允许接触的过滤矩阵。
- 在 Unity 3D 中配置、验证和排查物理层过滤规则。
Layer 和 Mask 分别负责什么
Layer 表示对象属于哪一类,例如 Player、Enemy 或 Environment。这样物理系统可以按类别选择检测对象,而不必为每一对具体游戏对象手动设置规则。
Mask 表示一次检测关心哪些层。例如玩家发射的子弹只需要检测敌人和环境,就可以把 Enemy、Environment 放入查询 Mask,排除玩家、其他子弹和无关的交互区域。
但不同引擎对 Mask 的使用范围并不完全一样。Godot 的物理对象具有独立的 collision_layer 与 collision_mask 属性;Unity 3D 则通常通过对象的 Layer、全局 Layer Collision Matrix 以及物理查询使用的 LayerMask 分别处理这些需求。
需要区分两项决策:
- 被动接触过滤:两个物理对象之间是否允许发生实体接触或触发检测。
- 主动空间查询:一次 Raycast、Sphere Cast 等操作应该检测哪些层。
过滤规则决定哪些对象有资格参与检测,不决定接触后一定产生物理阻挡。允许接触的 Trigger 仍然是非阻挡区域。
为五类对象建立过滤矩阵
考虑一款单人动作游戏:玩家需要与敌人和地形接触,玩家子弹命中敌人或环境,交互区域只检测玩家。为控制不必要的接触,暂时禁止敌人互撞和子弹互撞。
下表中的行与列表示对象所属的 Layer,勾选表示允许该组合在物理系统中交互。
| Layer | Player | Enemy | Bullet | Environment | Interactable |
|---|---|---|---|---|---|
| Player | × | ✓ | × | ✓ | ✓ |
| Enemy | ✓ | × | ✓ | ✓ | × |
| Bullet | × | ✓ | × | ✓ | × |
| Environment | ✓ | ✓ | ✓ | × | × |
| Interactable | ✓ | × | × | × | × |
这张矩阵包含以下设计选择:
- Player 与 Environment 允许接触,角色才能被地形阻挡。
- Player 与 Interactable 允许交互,但 Interactable 的碰撞体配置为 Trigger,因此只通知进入和离开,不阻挡移动。
- Bullet 与 Enemy、Environment 允许接触,子弹可以命中目标或障碍物。
- Bullet 与 Player 被过滤,表示本示例中的 Bullet 专用于玩家侧攻击,默认不伤害玩家。
- Enemy 与 Enemy 暂时禁止接触,适合不需要敌人之间实体挤压的玩法;需要群体避让或推动时应重新评估。
Unity 的全局物理层碰撞矩阵是按层组合配置的,因此这张矩阵保持对称。对于具有方向性检测 Mask 的引擎或查询接口,还需要单独确定检测发起方关心哪些层。

在 Unity 中配置并验证矩阵
在 Unity 3D 中,可以通过 Project Settings 的 Physics 页面配置 Layer Collision Matrix,也可以在启动时使用 Physics.IgnoreLayerCollision 设置规则。下面采用脚本,使五类对象的过滤关系可以集中管理和复核。
先在 Inspector 的 Layer 下拉菜单中选择 Add Layer,创建 Player、Enemy、Bullet、Environment、Interactable 五个 Layer,并将相应游戏对象分配到正确的层。项目需要使用 Unity 内置 3D 物理系统,不是 Physics 2D。
创建 CollisionRulesBootstrap.cs,将脚本挂载到初始场景的一个启用状态的空 GameObject 上。
using UnityEngine;
public class CollisionRulesBootstrap : MonoBehaviour
{
private static readonly string[] Names = {
"Player", "Enemy", "Bullet", "Environment", "Interactable"
};
// 与正文矩阵一致,行列顺序均对应 Names
private static readonly bool[,] Allowed = {
{ false, true, false, true, true },
{ true, false, true, true, false },
{ false, true, false, true, false },
{ true, true, true, false, false },
{ true, false, false, false, false }
};
private void Awake()
{
int[] layers = new int[Names.Length];
for (int i = 0; i < layers.Length; i++)
{
layers[i] = LayerMask.NameToLayer(Names[i]);
if (layers[i] < 0)
{
Debug.LogError($"Missing layer: {Names[i]}");
return;
}
}
// 对称矩阵只需处理上三角及对角线
for (int i = 0; i < layers.Length; i++)
{
for (int j = i; j < layers.Length; j++)
{
Physics.IgnoreLayerCollision(
layers[i], layers[j], !Allowed[i, j]);
}
}
// 查询 Mask 与实体接触矩阵分别验证
int bulletMask = LayerMask.GetMask("Enemy", "Environment");
bool pairEnabled = !Physics.GetIgnoreLayerCollision(
layers[2], layers[0]);
bool maskIncludesEnemy = (bulletMask & (1 << layers[1])) != 0;
Debug.Log($"Bullet-Player pair enabled: {pairEnabled}");
Debug.Log($"Bullet mask includes Enemy: {maskIncludesEnemy}");
}
}预期输出:五个 Layer 名称均存在时,运行场景后 Console 显示:
Bullet-Player pair enabled: False
Bullet mask includes Enemy: True第一条说明 Bullet 与 Player 的实体接触组合已被禁止。第二条说明构建出的子弹查询 Mask 包含 Enemy 层,并不意味着执行了射线检测或已经命中敌人。
Physics.IgnoreLayerCollision 负责设置层之间是否忽略碰撞,Physics.GetIgnoreLayerCollision 用于读取当前状态。代码中的 Allowed 是正向允许矩阵,因此调用时需要取反作为忽略参数。
该配置在运行时生效,并不会自动把规则写回项目设置。应在实际物理交互开始前完成初始化,避免运行中切换层规则导致已有接触或 Trigger 状态发生变化。
主动查询的 Mask 需要单独传入
全局碰撞矩阵解决刚体之间的接触过滤,而主动查询还应根据查询目标进一步收窄范围。
例如执行 Physics.Raycast 时,可以将 LayerMask.GetMask("Enemy", "Environment") 生成的掩码传给该接口的 layerMask 参数。这样射线只考虑指定层中的对象,而不是对场景内所有碰撞体进行命中筛选。
LayerMask 本质上是位掩码。每个 Unity Layer 对应一个位,多个层可以通过位运算组合。使用 LayerMask.GetMask 根据层名称构建掩码,通常比在业务代码里散布数字位值更容易维护。
注意,查询 Mask 不会自动修改 Bullet 刚体与其他对象的实体碰撞关系。主动射线命中、实体碰撞和 Trigger 检测应分别明确规则,不能把一种过滤配置当作另一种已经生效。
验证过滤规则是否符合玩法
仅检查日志还不够,应该在实际场景中验证允许与禁止的组合。
- 让 Player 接触 Environment,确认实体墙壁正常阻挡角色。
- 让 Player 穿越配置为 Trigger 的 Interactable,确认能收到进入事件且不会被该区域阻挡。
- 让玩家侧 Bullet 接触 Enemy 和 Environment,确认允许的目标能够产生预期命中行为。
- 检查 Bullet 与 Player、Interactable 的组合,确认不会产生不需要的实体接触或触发通知。
- 如果结果不符,依次检查 GameObject 实际 Layer、全局碰撞矩阵、Collider 的 Is Trigger 设置,以及是否使用了正确的 3D 物理查询接口。
碰撞层应优先依据稳定的物理交互职责划分,而不是随着每一个临时玩法状态反复增加新层。先用少量层建立清晰矩阵,再通过对象属性处理生命值、阵营和任务条件,通常更容易调试和扩展。