# appsinacup/godot-rapier-physics architecture

> Architecture diagram of the GitHub repository appsinacup/godot-rapier-physics, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/appsinacup/godot-rapier-physics
- Repository: https://github.com/appsinacup/godot-rapier-physics

## Overview

Godot Rapier Physics replaces Godot’s 2D/3D physics server, using Rapier for rigid-body physics and Salva for fluids. The principal workflow is Godot’s physics-server interface dispatching operations into server implementation, shared physics state and spaces, then Rapier worlds; results and callbacks return through the server integration. Separate components handle bodies, shapes, joints, queries and fluids. Serialization, deterministic behavior, profiler monitors and project settings are also documented capabilities. Links reflect the README or shown source-index references; some subsystem internals were not sampled.

Main entry points: [`src/servers/rapier_physics_singleton.rs`](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_singleton.rs) (Physics state), [`src/servers/rapier_physics_server_impl.rs`](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_server_impl.rs) (Server operations), [`src/nodes/state_manager.rs`](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/nodes/state_manager.rs) (State serialization), [`src/servers/rapier_physics_server_2d.rs`](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_server_2d.rs) (Physics server API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Godot integration"]
  node_servers["Server registration<br/>[mod.rs]"]
  node_server_api["Physics server API"]
  node_server_impl["Server operations"]
  node_extra_api["Extra server API"]
  node_settings["Project settings"]
  node_profiler["Profiler monitors<br/>[rapier_profiler.rs]"]
end

subgraph group_model["Physics objects"]
  node_objects["Bodies and areas<br/>[rapier_body.rs]"]
  node_collision["Collision objects"]
  node_shapes["Collision shapes<br/>[rapier_shape.rs]"]
  node_joints["Joint types<br/>[rapier_joint.rs]"]
  node_fluids["Fluid simulation<br/>[rapier_fluid.rs]"]
end

subgraph group_runtime["Simulation runtime"]
  node_singleton[("Physics state")]
  node_space["Physics spaces<br/>[rapier_space.rs]"]
  node_world["Rapier world<br/>[physics_world.rs]"]
end

subgraph group_capabilities["Queries and state"]
  node_query["Space queries<br/>[query.rs]"]
  node_serialization["State serialization<br/>[state_manager.rs]"]
  node_export["Object export data"]
end

node_godot(("Godot engine"))

node_godot -->|"registers server"| node_servers
node_servers -->|"creates server"| node_server_api
node_godot -.->|"selects physics"| node_server_api
node_server_api -.->|"dispatches operations"| node_server_impl
node_server_impl -->|"accesses state"| node_singleton
node_server_impl -->|"operates bodies"| node_objects
node_server_impl -->|"operates shapes"| node_shapes
node_server_impl -->|"operates joints"| node_joints
node_extra_api -->|"operates fluids"| node_fluids
node_singleton -->|"stores objects"| node_objects
node_singleton -->|"stores shapes"| node_shapes
node_singleton -->|"stores joints"| node_joints
node_singleton -->|"stores fluids"| node_fluids
node_singleton -->|"stores spaces"| node_space
node_space -->|"imports world state"| node_world
node_world -->|"reports profiling"| node_profiler
node_query -->|"queries physics"| node_world
node_server_impl -->|"reads settings"| node_settings
node_settings -->|"configures monitors"| node_profiler
node_serialization -->|"exports state"| node_singleton
node_serialization -->|"uses export states"| node_export
node_objects -->|"implements export"| node_export
node_godot -.->|"saves and loads state"| node_serialization
node_godot -.->|"uses 2D/3D fluids"| node_fluids

click node_servers "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/mod.rs"
click node_server_api "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_server_2d.rs"
click node_server_impl "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_server_impl.rs"
click node_extra_api "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_server_extra.rs"
click node_settings "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_project_settings.rs"
click node_profiler "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_profiler.rs"
click node_objects "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/bodies/rapier_body.rs"
click node_collision "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/bodies/rapier_collision_object.rs"
click node_shapes "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/shapes/rapier_shape.rs"
click node_joints "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/joints/rapier_joint.rs"
click node_fluids "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/fluids/rapier_fluid.rs"
click node_singleton "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_singleton.rs"
click node_space "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/spaces/rapier_space.rs"
click node_world "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/rapier_wrapper/physics_world.rs"
click node_query "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/rapier_wrapper/query.rs"
click node_serialization "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/nodes/state_manager.rs"
click node_export "https://github.com/appsinacup/godot-rapier-physics/blob/main/src/bodies/exportable_object.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_servers,node_server_api,node_server_impl,node_extra_api,node_settings,node_profiler toneBlue
class node_objects,node_collision,node_shapes,node_joints,node_fluids toneAmber
class node_singleton,node_space,node_world toneMint
class node_query,node_serialization,node_export toneRose
class node_godot toneIndigo
```

## Components

### Godot integration

- [Server registration](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/mod.rs): `src/servers/mod.rs`
- [Physics server API](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_server_2d.rs): `src/servers/rapier_physics_server_2d.rs`
- [Server operations](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_server_impl.rs): `src/servers/rapier_physics_server_impl.rs`
- [Extra server API](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_server_extra.rs): `src/servers/rapier_physics_server_extra.rs`
- [Project settings](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_project_settings.rs): `src/servers/rapier_project_settings.rs`
- [Profiler monitors](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_profiler.rs): `src/servers/rapier_profiler.rs`

### Physics objects

- [Bodies and areas](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/bodies/rapier_body.rs): `src/bodies/rapier_body.rs`
- [Collision objects](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/bodies/rapier_collision_object.rs): `src/bodies/rapier_collision_object.rs`
- [Collision shapes](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/shapes/rapier_shape.rs): `src/shapes/rapier_shape.rs`
- [Joint types](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/joints/rapier_joint.rs): `src/joints/rapier_joint.rs`
- [Fluid simulation](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/fluids/rapier_fluid.rs): `src/fluids/rapier_fluid.rs`

### Simulation runtime

- [Physics state](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/servers/rapier_physics_singleton.rs): `src/servers/rapier_physics_singleton.rs`
- [Physics spaces](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/spaces/rapier_space.rs): `src/spaces/rapier_space.rs`
- [Rapier world](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/rapier_wrapper/physics_world.rs): `src/rapier_wrapper/physics_world.rs`

### Queries and state

- [Space queries](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/rapier_wrapper/query.rs): `src/rapier_wrapper/query.rs`
- [State serialization](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/nodes/state_manager.rs): `src/nodes/state_manager.rs`
- [Object export data](https://github.com/appsinacup/godot-rapier-physics/blob/main/src/bodies/exportable_object.rs): `src/bodies/exportable_object.rs`

### Other components

- **Godot engine**

## Connections

- Godot engine → Server registration: registers server (evidence: `src/servers/mod.rs`)
- Server registration → Physics server API: creates server (evidence: `src/servers/mod.rs`)
- Godot engine → Physics server API: selects physics (evidence: `README.md`)
- Physics server API → Server operations: dispatches operations (evidence: `src/servers/rapier_physics_server_impl.rs`)
- Server operations → Physics state: accesses state (evidence: `src/servers/rapier_physics_server_impl.rs`)
- Server operations → Bodies and areas: operates bodies (evidence: `src/servers/rapier_physics_server_impl.rs`)
- Server operations → Collision shapes: operates shapes (evidence: `src/servers/rapier_physics_server_impl.rs`)
- Server operations → Joint types: operates joints (evidence: `src/servers/rapier_physics_server_impl.rs`)
- Extra server API → Fluid simulation: operates fluids (evidence: `src/servers/rapier_physics_server_extra.rs`)
- Physics state → Bodies and areas: stores objects (evidence: `src/servers/rapier_physics_singleton.rs`)
- Physics state → Collision shapes: stores shapes (evidence: `src/servers/rapier_physics_singleton.rs`)
- Physics state → Joint types: stores joints (evidence: `src/servers/rapier_physics_singleton.rs`)
- Physics state → Fluid simulation: stores fluids (evidence: `src/servers/rapier_physics_singleton.rs`)
- Physics state → Physics spaces: stores spaces (evidence: `src/servers/rapier_physics_singleton.rs`)
- Physics spaces → Rapier world: imports world state (evidence: `src/spaces/rapier_space.rs`)
- Rapier world → Profiler monitors: reports profiling (evidence: `src/rapier_wrapper/physics_world.rs`)
- Space queries → Rapier world: queries physics (evidence: `src/rapier_wrapper/query.rs`)
- Server operations → Project settings: reads settings (evidence: `src/servers/rapier_physics_server_impl.rs`)
- Project settings → Profiler monitors: configures monitors (evidence: `src/servers/rapier_profiler.rs`)
- State serialization → Physics state: exports state (evidence: `src/nodes/state_manager.rs`)
- State serialization → Object export data: uses export states (evidence: `src/nodes/state_manager.rs`)
- Bodies and areas → Object export data: implements export (evidence: `src/bodies/exportable_object.rs`)
- Godot engine → State serialization: saves and loads state (evidence: `README.md`)
- Godot engine → Fluid simulation: uses 2D/3D fluids (evidence: `README.md`)
