physics-matter

Set physics.default to 'matter' in the game config and pass a matter object with gravity, setBounds, enableSleeping, and debug options. Then create bodies in your scene with this.matter.add.sprite, image, or shape factory methods.

Use this.matter.add.constraint(bodyA, bodyB, length, stiffness, options) to create joints, springs, or pins. High stiffness near 1 gives a rigid joint, while low values like 0.02 with damping create springy behavior.

Arcade Physics is a lightweight AABB system for simple collisions, while Matter.js provides full rigid-body simulation with rotation, compound bodies, constraints, and realistic friction and restitution. Choose Matter when you need true physics behavior.

Set isSensor: true in the body config or call sprite.setSensor(true). Sensors detect collisions through normal collisionstart and collisionend events but produce no physical response, making them ideal for pickups and trigger areas.

Calling setBody, setRectangle, or similar methods resets all body properties including mass, friction, collision filters, and callbacks. Re-apply collision categories, filters, and event callbacks after changing the body shape.

Matter.js supports a maximum of 32 collision categories because each category occupies one bit in a bitmask. Use this.matter.world.nextCategory() to allocate them, or use collision groups for simpler always-collide or never-collide rules.