https://github.com/appsinacup/godot-rapier-physics

Godot Rapier Physics – Rust GDExtension that integrates the Rapier physics engine as a drop in replacement for both 2d and 3d.
https://github.com/appsinacup/godot-rapier-physics

godot godot-engine godot4 godotengine rapier

Last synced: 8 days ago
JSON representation

Godot Rapier Physics – Rust GDExtension that integrates the Rapier physics engine as a drop in replacement for both 2d and 3d.

• Host: GitHub
• URL: https://github.com/appsinacup/godot-rapier-physics
• Owner: appsinacup
• License: mit
• Created: 2023-10-26T08:39:19.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-16T10:14:01.000Z (5 months ago)
• Last Synced: 2024-06-16T10:28:28.173Z (5 months ago)
• Topics: godot, godot-engine, godot4, godotengine, rapier
• Language: C++
• Homepage: https://appsinacup.com
• Size: 38.1 MB
• Stars: 154
• Watchers: 2
• Forks: 10
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-godot - godot-rapier-2d - A 2D [Rapier](https://github.com/dimforge/rapier) physics server for Godot (Godot 4.2). (Modules / 3D)

README

        






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](https://github.com/godotengine/godot) through [rapier](https://github.com/dimforge/rapier) physics engine [salva](https://github.com/dimforge/salva) fluids simulation library.

# Features

Stability|Ghost Collisions

-|-

![](docs/rapier-vid.gif)|![](docs/ghost_collisions.gif)

Fluids 2D| Fluids 3D

-|-

![](docs/fluid_shader.gif)|![](docs/water_3d.gif)

**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](https://godotengine.org/asset-library/asset/2267) using the `AssetLib` tab in Godot:

    - [Rapier Physics 2D - Fast Version with Parallel SIMD Solver](https://godotengine.org/asset-library/asset/2267)

    - [Rapier Physics 2D - Slower Version with Cross Platform Deterministic](https://godotengine.org/asset-library/asset/2815)

    - [Rapier Physics 3D - Fast Version with Parallel SIMD Solver](https://godotengine.org/asset-library/asset/3084)

    - [Rapier Physics 3D - Slower Version with Cross Platform Deterministic](https://godotengine.org/asset-library/asset/3085)

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

- Manual: Download the [latest github release](https://github.com/appsinacup/godot-rapier-physics/releases/latest) 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](https://godot.rapier.rs/docs/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`