How appsinacup/godot-rapier-physics works
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: rapier_physics_singleton.rs Physics state · rapier_physics_server_impl.rs Server operations · state_manager.rs State serialization · rapier_physics_server_2d.rs Physics server API
Components 18
Godot integration
- Server registration
src/servers/mod.rs - Physics server API
src/servers/rapier_physics_server_2d.rs - Server operations
src/servers/rapier_physics_server_impl.rs - Extra server API
src/servers/rapier_physics_server_extra.rs - Project settings
src/servers/rapier_project_settings.rs - Profiler monitors
src/servers/rapier_profiler.rs
Physics objects
- Bodies and areas
src/bodies/rapier_body.rs - Collision objects
src/bodies/rapier_collision_object.rs - Collision shapes
src/shapes/rapier_shape.rs - Joint types
src/joints/rapier_joint.rs - Fluid simulation
src/fluids/rapier_fluid.rs
Simulation runtime
- Physics state
src/servers/rapier_physics_singleton.rs - Physics spaces
src/spaces/rapier_space.rs - Rapier world
src/rapier_wrapper/physics_world.rs
Queries and state
- Space queries
src/rapier_wrapper/query.rs - State serialization
src/nodes/state_manager.rs - Object export data
src/bodies/exportable_object.rs
Other components
- Godot engine
Connections 24
- Godot engine → Server registration: registers server
src/servers/mod.rs - Server registration → Physics server API: creates server
src/servers/mod.rs - Godot engine → Physics server API: selects physics
README.md - Physics server API → Server operations: dispatches operations
src/servers/rapier_physics_server_impl.rs - Server operations → Physics state: accesses state
src/servers/rapier_physics_server_impl.rs - Server operations → Bodies and areas: operates bodies
src/servers/rapier_physics_server_impl.rs - Server operations → Collision shapes: operates shapes
src/servers/rapier_physics_server_impl.rs - Server operations → Joint types: operates joints
src/servers/rapier_physics_server_impl.rs - Extra server API → Fluid simulation: operates fluids
src/servers/rapier_physics_server_extra.rs - Physics state → Bodies and areas: stores objects
src/servers/rapier_physics_singleton.rs - Physics state → Collision shapes: stores shapes
src/servers/rapier_physics_singleton.rs - Physics state → Joint types: stores joints
src/servers/rapier_physics_singleton.rs - Physics state → Fluid simulation: stores fluids
src/servers/rapier_physics_singleton.rs - Physics state → Physics spaces: stores spaces
src/servers/rapier_physics_singleton.rs - Physics spaces → Rapier world: imports world state
src/spaces/rapier_space.rs - Rapier world → Profiler monitors: reports profiling
src/rapier_wrapper/physics_world.rs - Space queries → Rapier world: queries physics
src/rapier_wrapper/query.rs - Server operations → Project settings: reads settings
src/servers/rapier_physics_server_impl.rs - Project settings → Profiler monitors: configures monitors
src/servers/rapier_profiler.rs - State serialization → Physics state: exports state
src/nodes/state_manager.rs - State serialization → Object export data: uses export states
src/nodes/state_manager.rs - Bodies and areas → Object export data: implements export
src/bodies/exportable_object.rs - Godot engine → State serialization: saves and loads state
README.md - Godot engine → Fluid simulation: uses 2D/3D fluids
README.md