Collider Isolation

By default, BeforeCollide and AfterCollide receive collision events for every collider on the entity. Sometimes you may want to create an isolated collider that should not trigger normal collision handling.

For example, you might want to detect when a hero gets close to an obstacle. For this, you could create a new proximity sensor collider with the isolate parameter of PolygonCollider set to true. Being close to an obstacle should not be treated the same as touching an obstacle, and so isolate=true is used to keep the collision handling separate.

Once a collider has been isolated, you must use BeforeCollide<Id> and AfterCollide<Id> to listen for its events, as its collision events will no longer be sent to the usual BeforeCollide and AfterCollide handlers anymore. This allows you to separate the handling of normal collisions from the handling of isolated collisions.

PolygonCollider<proximitySensor>(shape=Circle(10), category=Category:Proximity, isolate=true, isSensor=true)
on BeforeCollide<proximitySensor> that {
    // Do something we sense something within 10 units of this entity
}