diff --git a/changelog/3.85/MatterCollisionEvents.md b/changelog/3.85/MatterCollisionEvents.md new file mode 100644 index 000000000..abbe1405b --- /dev/null +++ b/changelog/3.85/MatterCollisionEvents.md @@ -0,0 +1,23 @@ +# Phaser 3.85.0 Change Log + +Return to the [Change Log index](CHANGELOG-v3.85.md). + +# `MatterCollisionEvents` integration + +Integrated `MatterCollisionEvents` plugin functionality directly into the `Matter.World` class to handle collision events (`collisionStart`, `collisionActive`, and `collisionEnd`) more effectively. + +Three new events are available on `Matter.Body`: +1. `onCollide` +2. `onCollideEnd` +3. `onCollideActive` + +These events correspond to the Matter events `collisionStart`, `collisionActive` and `collisionEnd`, respectively. + +You can listen to these events via `Matter.Events` or they will also be emitted from the Matter World. + +Also added to `Matter.Body` are three convenience functions: +- `Matter.Body.setOnCollide(callback)` +- `Matter.Body.setOnCollideEnd(callback)` +- `Matter.Body.setOnCollideActive(callback)` + +To register an event callback, provide a function of type `(pair: Matter.Pair) => void`. \ No newline at end of file