Liam edited this page May 30, 2016 · 3 revisions

Examples of how to run a Matter.js engine

  1. Runner example
  2. Using Matter.Runner
    1. Documentation
    2. Usage
    3. Options

Runner example


A basic example for running a previously created Matter.Engine (see Getting started):

(function run() {
    Engine.update(engine, 1000 / 60);

See also the source of Matter.Runner that provides some more advanced features.


When using node you can use setInterval instead of window.requestAnimationFrame:

setInterval(function() {
    Engine.update(engine, 1000 / 60);
}, 1000 / 60);

Using Matter.Runner

There is an included runner called Matter.Runner. This module is an optional utility which provides a game loop, that handles continuously updating a Matter.Engine for you. It is intended for development and debugging purposes, but may also be suitable for simple games.


See the documentation for Matter.Runner.


The simplest way is to use the helper:

var engine = Engine.create();;

Alternatively you can create a runner directly:

var runner = Runner.create();, engine);


A number of options may be passed to Matter.Runner.create:

var runner = Runner.create({
    delta: 1000 / 60,
    isFixed: false,
    enabled: true
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.