|
1 | 1 | # Changelog |
2 | 2 |
|
3 | | -## Unreleased |
| 3 | +## v0.37.0 (10 October 2026) |
| 4 | + |
| 5 | +bevy_rapier now lives in the [rapier repository](https://github.com/dimforge/rapier) and is built |
| 6 | +against the rapier crates of that repository ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 7 | + |
| 8 | +### Added |
| 9 | + |
| 10 | +- Soft bodies (2D and 3D): deformable bodies made of particles, simulated together with rigid |
| 11 | + bodies, contacts and joints ([#1010](https://github.com/dimforge/rapier/pull/1010), |
| 12 | + [#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 13 | + - `SoftBody`: the soft body of an entity, built as a rope, trimesh or volume (`rope`, `trimesh`, |
| 14 | + `volumetric`), as a cloth, box or sphere in 3D (`cloth`, `cuboid`, `sphere`), or as a polygon, |
| 15 | + disk or grid in 2D (`polygon`, `disk`, `grid`). |
| 16 | + - `SoftBodyMaterial`: the stiffness, damping, plasticity and tearing behaviour of a soft body. |
| 17 | + - `SoftBodyPinnedParticles` and `SoftBodyKinematicTargets`: particles held in place, or moved |
| 18 | + along user-defined targets. |
| 19 | + - `SoftBodyAttachments`: two-way attachments between particles and rigid bodies. |
| 20 | + - `SoftBodyExternalForce` and `SoftBodyExternalImpulse`: forces and impulses applied to particles. |
| 21 | + - `SoftBodyDisabled`: leaves the soft body where it is, without colliders or constraints. |
| 22 | + - `SoftBodyState`: read-only center of mass, sleep state and particle count, updated each step. |
| 23 | + - `SoftBodyCluster`: a rigid proxy for a region of particles, that joints and colliders can |
| 24 | + attach to. It can be pinned, moved, shape-matched or given its own material |
| 25 | + (`SoftBodyClusterPinned`, `SoftBodyClusterKinematicTarget`, `SoftBodyClusterShapeMatching`, |
| 26 | + `SoftBodyClusterMaterial`). |
| 27 | + - `DeformableCollider`: binds a deformable polyline (2D) or trimesh (3D) collider to the particles |
| 28 | + of a soft body. |
| 29 | + - Tearing and cutting with `tear_soft_body` and `cut_soft_body`. Each tear sends a |
| 30 | + `SoftBodyTearEvent`, and torn-off pieces become new entities. |
| 31 | + - `SoftBodyMeshSync` (`to-bevy-mesh` feature): renders a soft body with a mesh kept in sync with |
| 32 | + its particles. |
| 33 | + - `SoftBodyElasticitySolver` (`fem` feature): selects the experimental FEM elasticity solver. |
| 34 | +- Controllers ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 35 | + - `PidController` and `PdController`: drive a rigid body toward a `PidTarget` pose and velocity, |
| 36 | + on the axes selected by an `AxesMask`. |
| 37 | + - `RayCastVehicleController` (3D): a car-like vehicle whose `VehicleWheel`s are simulated with |
| 38 | + ray-casts. Each wheel reports its contact and suspension state in `VehicleWheelState`. |
| 39 | + - Character and vehicle controllers can ignore given colliders and bodies (`exclude_colliders`, |
| 40 | + `exclude_rigid_bodies`, `filter_predicate`). The `ControllerIgnored` marker hides an entity |
| 41 | + from all of them. |
| 42 | +- 3D loaders ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 43 | + - `urdf` feature: `spawn_urdf_robot` spawns a URDF robot as entities. |
| 44 | + - `mjcf` feature: `spawn_mjcf_model` spawns a MuJoCo model, and `MjcfPlugin` drives its actuators. |
| 45 | + - `meshloader` feature: `Collider::from_mesh_file` and `load_mesh_file_colliders` build colliders |
| 46 | + from STL, Collada and OBJ files. |
| 47 | +- Joints ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 48 | + - `PinSlotJoint` (2D): allows a rotation and a translation along one axis, also known as a groove |
| 49 | + joint. |
| 50 | + - `ImpulseJointDisabled`, and `GenericJoint::set_enabled`: keep a joint attached but stop solving it. |
| 51 | + - `ImpulseJointImpulses`: the impulses a joint applied during the last step, for example to detect |
| 52 | + joints under heavy load. |
| 53 | + - `softness`/`set_softness` and `contacts_enabled` on every joint and builder: per-joint |
| 54 | + softness, and whether the two jointed bodies collide. |
| 55 | + - `GenericJoint::local_frame1/2` and `flip`, and `From<GenericJoint>` for `TypedJoint`. |
| 56 | +- Multibodies ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 57 | + - `KinematicMultibodyJoint`: a joint whose degrees of freedom only move at user-set velocities. |
| 58 | + - `MultibodySelfContactsDisabled`: disables contacts between the links of a multibody. |
| 59 | + - Per-DoF `MultibodyJointDamping`, `MultibodyJointArmature` (rotor inertia) and |
| 60 | + `MultibodyJointSprings` (implicit passive springs). |
| 61 | + - `MultibodyJointFriction`: per-DoF dry friction |
| 62 | + ([#1001](https://github.com/dimforge/rapier/pull/1001)). |
| 63 | + - `MultibodyJointCouplings`: links the motion of degrees of freedom across joints of a multibody. |
| 64 | + - `MultibodyJointState`: read-only joint coordinates and velocities, updated each step. |
| 65 | + - Context helpers for links, generalized velocities, jacobians, and forward and inverse kinematics. |
| 66 | +- Rigid bodies ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 67 | + - `AdditionalPgsIterations`: extra solver iterations per substep for a body's island |
| 68 | + ([#1010](https://github.com/dimforge/rapier/pull/1010)). |
| 69 | + - `AllowFastRotation`: lifts the per-substep angular velocity cap, e.g. for wheels. |
| 70 | + - `GyroscopicForces` (3D): enables or disables gyroscopic forces. |
| 71 | + - `Sleeping::time_until_sleep`: how long a body must stay still before falling asleep. |
| 72 | + - `ReadWorldMassProperties`: opt-in world-space mass properties, updated each step. |
| 73 | + - `CoefficientCombineRule::{ClampedSum, GeometricMean}` and `CoefficientCombineRule::combine` |
| 74 | + ([#1007](https://github.com/dimforge/rapier/pull/1007)). |
| 75 | + - `RapierRigidBodySet` queries, such as `velocity_at_point`, `is_moving`, `next_position`, |
| 76 | + `kinetic_energy` and `center_of_mass`. |
| 77 | +- Colliders ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 78 | + - Constructors `compound_with_flags`, `polyline_with_flags`, `converted_trimesh`, |
| 79 | + `heightfield_with_flags` (3D), `oriented_polyline` (one-sided, 2D) and |
| 80 | + `convex_polyline_unmodified` (2D). |
| 81 | + - Shape queries on `Collider`, such as `aabb`, `bounding_sphere`, `mass_properties`, `contact`, |
| 82 | + `distance`, `closest_points`, `cast_shape` and `cast_shape_nonlinear`. |
| 83 | + - `ReadColliderMassProperties`: the volume, density and mass computed by rapier, inserted |
| 84 | + automatically. |
| 85 | + - `InteractionTestMode` on `CollisionGroups` and `SolverGroups`: whether both groups must |
| 86 | + accept each other (`And`) or only one of them (`Or`). |
| 87 | + - `ComputedColliderShape::{Voxels, Converted}`: build colliders from Bevy meshes as voxels or |
| 88 | + with a `MeshConverter`. |
| 89 | + - New accessors and mutators on the shape views, and `ColliderView::Custom` for custom shapes. |
| 90 | +- Scene queries ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 91 | + - `cast_shape_nonlinear`, `distance_to_shape`, `closest_points_to_shape`, `contact_with_shape` |
| 92 | + and `bvh`. |
| 93 | + - The new `AsShape` trait: shape arguments accept a `Collider`, a `&dyn Shape` or any rapier |
| 94 | + shape. |
| 95 | +- Simulation ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 96 | + - `RapierConfiguration::simulation_mode`: `SimulationMode::CollisionOnly` runs collision |
| 97 | + detection without simulating the dynamics. |
| 98 | + - `RapierConfiguration::num_threads`: a thread pool per context. |
| 99 | + - `BroadPhaseOptimizationStrategy`: how the broad-phase BVH is optimized over time. |
| 100 | + - `set_query_dispatcher` and `set_event_handler`: a custom narrow-phase dispatcher and event |
| 101 | + handler per context. |
| 102 | + - `step_stats()`: timings and counts of the last steps, shown by the new |
| 103 | + `RapierDiagnosticsPlugin`. |
| 104 | +- NaN quarantine: `PhysicsQuarantineEvent` reports bodies and colliders with non-finite values. |
| 105 | + They get `RigidBodyDisabled`/`ColliderDisabled`/`SoftBodyDisabled` until fixed |
| 106 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 107 | +- Contacts ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 108 | + - `ContactForceEvent::started`: set on the step the force first crosses the threshold. |
| 109 | + - `contact_graph` and `intersection_graph`, and impulse and warmstart accessors on the contact |
| 110 | + views. |
| 111 | + - Setters on `ContactModificationContextView`, such as `set_normal`, `set_friction` and |
| 112 | + `update_as_oneway_platform`. |
| 113 | +- Debug render ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 114 | + - `DebugRenderColor` and `DebugRenderVisibility`: the color and visibility of everything |
| 115 | + attached to an entity. |
| 116 | + - `DebugRenderContext::{style, mode}` can be edited at runtime. |
| 117 | + - Soft bodies are rendered. |
| 118 | +- `to-bevy-mesh`: segments, polylines, half-spaces, 2D heightfields, 2D voxels and round shapes |
| 119 | + now convert to meshes ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 120 | +- Cargo features `block-solver`, `profiler`, `unsync-callbacks`, `solver-bounds-checks` and `fem` |
| 121 | + (forwarded to rapier), and a `debug-render` alias for 2D |
| 122 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 123 | +- New examples: soft bodies, multibodies, URDF/MJCF, vehicle, PID, diagnostics, and more |
| 124 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 125 | + |
| 126 | +### Modified |
| 127 | + |
| 128 | +- Update to bevy 0.20 ([#1034](https://github.com/dimforge/rapier/pull/1034)) and rapier 0.36.1 |
| 129 | + (nalgebra 0.35, glam 0.33) ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 130 | + See [rapier's changelog](https://github.com/dimforge/rapier/blob/master/CHANGELOG.md) for details. |
| 131 | +- **Breaking:** `QueryFilter::predicate` takes `Fn(Entity, &RapierCollider) -> bool`, and the |
| 132 | + `intersect_*` callbacks also receive the `&RapierCollider` |
| 133 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 134 | +- **Breaking:** these methods take a new argument |
| 135 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)): |
| 136 | + - `project_point_and_get_feature` takes `max_dist`. |
| 137 | + - `step_simulation` takes a `SimulationMode`. |
| 138 | + - `move_shape` takes a `QueryFilter` instead of a `RapierQueryPipelineMut`. |
| 139 | +- **Breaking:** by default, `BevyPhysicsHooks::filter_contact_pair`/`filter_intersection_pair` |
| 140 | + now keep the pair. They used to drop it |
| 141 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 142 | +- **Breaking:** debug-render style lengths are in meters and scaled by each context's |
| 143 | + `length_unit`; disable this with `DebugRenderContext::scale_lengths_by_length_unit`. The 2D |
| 144 | + axis-length default of `20.0` was removed ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 145 | +- **Breaking:** the rapier `user_data` of joints is overwritten with the owning entity |
| 146 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 147 | +- **Breaking:** new public fields or variants on `RapierConfiguration`, `CollisionGroups`, |
| 148 | + `SolverGroups`, `Sleeping`, `ContactForceEvent`, `KinematicCharacterController`, |
| 149 | + `PointProjection`, `RayIntersection`, `ShapeCastHit`, `CoefficientCombineRule`, `TypedJoint`, |
| 150 | + `ColliderView` and `ComputedColliderShape` ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 151 | +- `MultibodyJoint::new` takes `impl Into<TypedJoint>` |
| 152 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 153 | +- An entity without a `RapierContextEntityLink` joins the context of its closest linked ancestor |
| 154 | + instead of the default context ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 155 | +- Scene queries, character controllers and picking use the context's query dispatcher |
| 156 | + ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 157 | +- Steps with a zero timestep are skipped ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 158 | +- `RigidBody` requires `ReadMassProperties` ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 159 | + |
| 160 | +### Fixed |
| 161 | + |
| 162 | +All these fixes come from [#1016](https://github.com/dimforge/rapier/pull/1016). |
| 163 | + |
| 164 | +- Removing a rigid-body or collider component (`Damping`, `GravityScale`, `Friction`, |
| 165 | + `CollisionGroups`, …) now resets the rapier property instead of keeping its last value. |
| 166 | +- Changing the parent of an `ImpulseJoint` or `MultibodyJoint`, or reparenting its entity, |
| 167 | + re-attaches the joint. |
| 168 | +- Modifying an `ImpulseJoint` wakes its bodies and keeps the warmstart impulses. |
| 169 | +- Setting `Sleeping::sleeping = false` wakes the whole island. |
| 170 | +- Events for colliders whose entity can't be resolved are dropped instead of panicking. |
| 171 | +- Deserialized context resources rebuild their entity maps. |
| 172 | +- `typed_shape_to_mesh`: |
| 173 | + - Compound part poses are applied. |
| 174 | + - 3D convex polyhedra and voxels are triangulated correctly. |
| 175 | +- Converting a collider with a custom shape into a `ColliderView` no longer panics. |
| 176 | +- The `enhanced-determinism` feature compiles again. |
| 177 | + |
| 178 | +### Removed |
| 179 | + |
| 180 | +- The unused `headless` feature ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 181 | +- The `debugdump2`/`debugdump3` examples ([#1016](https://github.com/dimforge/rapier/pull/1016)). |
| 182 | + |
| 183 | +## v0.36.0 (8 August 2026) |
4 | 184 |
|
5 | 185 | ### Modified |
6 | 186 |
|
7 | | -- Update to bevy 0.20. |
8 | | -- Update from rapier `0.33.0-alpha` to rapier `0.35.0-glamx0.2`. |
| 187 | +- Update from rapier `0.33.0-alpha` to rapier `0.35.0-glamx0.2` |
| 188 | + ([#699](https://github.com/dimforge/bevy_rapier/pull/699)). |
9 | 189 | See [rapier's changelog](https://github.com/dimforge/rapier/blob/master/CHANGELOG.md) for details. |
10 | 190 | - Removed the `simd-stable` and `simd-nightly` features: SIMD is now always enabled in rapier. |
11 | 191 | The new `simd8` feature widens the solver’s SIMD from 4 to 8 lanes (f32 only, incompatible |
12 | 192 | with `enhanced-determinism`). |
| 193 | + - `AdditionalSolverIterations` now adds substeps to the whole island. |
| 194 | + - Fast dynamic bodies get CCD against fixed colliders without `Ccd`. `Ccd` now enables full |
| 195 | + CCD against dynamic and kinematic bodies. |
13 | 196 | - `SolverContactView::{friction, restitution}` now read from the contact manifold data (rapier |
14 | 197 | stores them per-manifold), and `SolverContactView::point` is reconstructed from the body-local |
15 | | - contact anchors; the public API is preserved. |
| 198 | + contact anchors. The new `SolverContactView::manifold_data` field exposes that data. |
| 199 | + - `IntegrationParametersWrapper` mirrors the new integration parameters |
| 200 | + (`static_contact_softness`, `normalized_max_linear_velocity`, `contact_clustering`, |
| 201 | + `contact_recycling`, …), and `min_island_size` was removed. |
16 | 202 | - Custom event handlers assigned to `RapierContextSimulation` must now be `Send + Sync`. |
17 | 203 | - Known issue: the `enhanced-determinism` feature currently fails to compile with bevy, because |
18 | 204 | parry enables `glam/scalar-math` which removes the serde impls of `glam::BVec3A`/`BVec4A` that |
|
0 commit comments