Choosing The Physics System Suitable For Your Project

In the panel Project -> Project Settings -> Module Options of the Editor, you can choose a physics engine suitable for the needs of the project for development.

Physics Engine Options

Note: The default is cannon.js physics engine。

Note: The physics engine can be switched at will during development。

Collision Detection:builtin

builtin only has the function of collision detection. Compared with other physics engines, it has no complicated physical simulation calculations. If your project does not require the physical simulation of this part, you can consider using builtin, which will make the size of game's package smaller.

If you use builtin for development, please note the following:

  • builtin only has events of type trigger.
  • RigidBody is invalid.
  • isTrigger in ColliderComponent is a trigger regardless of whether the value is true or false.

Physics Engine: cannon.js

cannon.js is an open source physics engine, which uses js language to develop and implement more comprehensive physics functions, if your project needs more complex physical functions, then you can consider using cannon.js. The size of the cannon.js module is 141KB.

Physics Engine: ammo.js

ammo.js is the asm.js/wasmVersion (currently only asm.js version) of the bullet physics engine, it is compiled by emscripten tool. Bullet has perfect physical functions, and we will put more work here in the future.

It should be noted that currently the ammo.js module has a size of about 1MB.

Do Not Use Physics

If you don't need to use any physics related components and interfaces, you can uncheck the yellow box, so that you can get a smaller package when publishing.

Note: If it is unchecked, the project will not be able to use physics related components and interfaces, otherwise an error will be reported during runtime.


Continue to the physics system documentation.

results matching ""

    No results matching ""