Quick Comparison

[SerializeField] private LayerMask interactableMask;

bool found = Physics.Raycast(
    origin,
    direction,
    out RaycastHit hit,
    interactDistance,
    interactableMask,
    QueryTriggerInteraction.Ignore
);

설정과 코드의 역할

Collision Matrix는 layer A와 B가 접촉할 때 collision/trigger 처리를 할지 정하는 전역 pair 규칙입니다. 투사체와 발사자, AI와 감지 전용 trigger처럼 서로 부딪히지 말아야 하는 물리 pair를 여기서 끕니다. 반면 Raycast는 호출의 layerMask와 QueryTriggerInteraction으로 무엇을 볼지 정합니다. Matrix에서 충돌을 껐다고 raycast가 해당 layer를 자동으로 무시하는 것은 아닙니다.

LayerMask 필드는 Inspector에서 체크박스로 보여 안전합니다. 코드로 만들 때는 layer index를 bit로 바꿉니다. LayerMask.NameToLayer("Enemy")가 돌려주는 것은 index이므로 그대로 query에 넘기면 잘못된 mask가 됩니다.

int enemyLayer = LayerMask.NameToLayer("Enemy");
if (enemyLayer < 0)
{
    Debug.LogError("Enemy layer is missing.");
}
else
{
    int enemyMask = 1 << enemyLayer;
    bool hitEnemy = Physics.Raycast(origin, direction, out RaycastHit hit, range, enemyMask);
}

QueryTriggerInteraction.UseGlobal은 Physics.queriesHitTriggers 전역 설정을 따릅니다. 상호작용 ray는 trigger를 무시하고, 감지 ray는 trigger를 포함하는 것처럼 호출 목적이 다르면 Ignore 또는 Collide를 명시해 프로젝트 전역 설정 변경에 덜 흔들리게 합니다.

Layer는 여러 시스템에 쓰이지만 규칙은 별개입니다

Layer는 Camera Culling Mask와 물리 query에도 사용될 수 있지만, 렌더링 제외와 충돌 제외는 별도 설정입니다. "Invisible" layer라는 이름만으로 물리·query까지 제외되는 것은 아닙니다. 팀 규칙에는 layer 이름, collision pair, query에서 허용할 layer, trigger 정책을 함께 기록합니다.

실패를 찾는 순서