physics-matter

Enable Matter physics by setting physics.default to 'matter' in the game config with a matter options object for gravity, bounds, and debug. Then create bodies in your scene using this.matter.add.sprite, image, or shape methods like rectangle and circle.

Use this.matter.add.constraint(bodyA, bodyB, length, stiffness, options) to create joints, springs, or pins between bodies. For pinning a body to a world point, use this.matter.add.worldConstraint with a pointA position.

Matter.js provides full rigid-body simulation with rotation, compound bodies, constraints, and realistic collision response, while Arcade physics is a lightweight AABB system. Matter positions bodies by center of mass rather than top-left origin.

Matter uses bitmask categories and masks: assign each body a category with setCollisionCategory and specify what it hits with setCollidesWith. Collision groups override category and mask, where matching negative groups never collide and matching positive groups always collide.

Matter.js force values are very small, typically between 0.01 and 0.1, unlike pixel-based velocities. Use applyForce with tiny vectors for gradual acceleration, or setVelocity with values between 1 and 15 for direct movement control.

Yes, call setCollisionByProperty on the tilemap layer first, then run this.matter.world.convertTilemapLayer to create a MatterTileBody per colliding tile. It uses Tiled collision shapes when defined, otherwise falls back to tile bounds.