Works on: Desktop, Mobile and Web

Documentation | Changelog | Discord | Contributing | Architecture

2D and 3D physics engine for the Godot game engine. with better stability, performance, liquids, determinism, state serialization and no ghost collisions.

Godot Rapier Physics is a 2D and 3D physics drop-in replacement for the Godot game engine through rapier physics engine salva fluids simulation library.

Features

Stability	No Vibrations

No Ghost Collisions	No CCD Issues

Fluids 2D	Fluids 3D
Serialization	Deserialization
Save Physics State	Load Physics State
Locally Deterministic	*Optionally Cross Platform Deterministic
Exact simulation every time (on same platform)	Exact simulation on multiple platforms

Installation

• Automatic (Recommended): Download the plugin from the official Godot Asset Store using the AssetLib tab in Godot:

  • Rapier Physics 2D - Fast Version with Parallel SIMD Solver
  • Rapier Physics 2D - Slower Version with Cross Platform Deterministic
  • Rapier Physics 3D - Fast Version with Parallel SIMD Solver
  • Rapier Physics 3D - Slower Version with Cross Platform Deterministic

  Note: For general use cases, use the Faster Version.

• Manual: Download the latest github release and move only the addons folder into your project addons folder.

After installing, go to Advanced Settings -> Physics -> 2D or 3D. Change Physics Engine to Rapier2D or Rapier3D.

Implementation Progress

This plugin is still being developed. See the Implementation Progress to get an idea of what status it is in and what features it has.

Limitations

• Pin Softness is not supported
• Double builds are disabled for now (until salva supports double builds)
• No support for asymmetric collisions (eg. object 1 hitting object 2 but object 2 not hitting object 1). This is the exact check rapier does: (A.layer & B.mask) != 0 || (B.layer & A.mask) != 0