Physics Logic

Collision vs Trigger

┌─────────────────────────────────────────────────────────────┐
│                    COLLISION                                │
│  OnCollisionEnter/Stay/Exit                                 │
│  • Both have Colliders                                      │
│  • At least one has Rigidbody                               │
│  • Neither is Trigger                                       │
│  • Physical response (push, bounce)                         │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    TRIGGER                                  │
│  OnTriggerEnter/Stay/Exit                                   │
│  • One has "Is Trigger" enabled                             │
│  • At least one has Rigidbody                               │
│  • No physical response                                     │
│  • Used for detection zones                                 │
└─────────────────────────────────────────────────────────────┘

Layer Best Practices

• ✅ Use layers to filter collisions
• ✅ Configure Layer Collision Matrix
• ✅ Use LayerMask for queries
• ✅ Cache LayerMask values
• ❌ NEVER use string layer names at runtime
• ❌ NEVER raycast on "Everything" layer

Few-Shot Examples

Example 1: Raycast Weapon

User: "Shoot raycast and deal damage."

Agent:

LayerMask enemyLayer = LayerMask.GetMask("Enemy");

if (Physics.Raycast(origin, direction, out RaycastHit hit, 100f, enemyLayer))
{
    if (hit.collider.TryGetComponent<IDamageable>(out var target))
        target.TakeDamage(new DamageInfo(25f));
}

Example 2: AOE Detection

User: "Find all enemies in 5m radius."

Agent:

Collider[] hits = Physics.OverlapSphere(center, 5f, enemyLayer);
foreach (var hit in hits)
{
    // Process each enemy
}

Example 3: Ground Check

User: "Check if character is grounded."

Agent:

bool isGrounded = Physics.SphereCast(
    transform.position + Vector3.up,
    0.3f,
    Vector3.down,
    out _,
    1.1f,
    groundLayer
);

Related Skills

• @damage-health-framework - Damage on collision
• @advanced-character-controller - Character physics
• @navmesh-pathfinding - AI movement

Template Files

Available in templates/ folder.