Async colliders

crates/bevy_xpbd_2d/Cargo.toml

@@ -12,7 +12,7 @@ keywords = ["gamedev", "physics", "simulation", "xpbd", "bevy"]
 categories = ["game-development", "science", "simulation"]
 
 [features]
-default = ["2d", "f32", "collider-from-mesh", "parallel"]
+default = ["2d", "f32", "parallel"]
 2d = []
 f32 = ["dep:parry2d"]
 f64 = ["dep:parry2d-f64"]
@@ -24,7 +24,6 @@ enhanced-determinism = [
     "parry2d-f64?/enhanced-determinism",
     "glam/libm",
 ]
-collider-from-mesh = ["bevy/bevy_render"]
 
 [lib]
 name = "bevy_xpbd_2d"

crates/bevy_xpbd_3d/Cargo.toml

@@ -12,7 +12,7 @@ keywords = ["gamedev", "physics", "simulation", "xpbd", "bevy"]
 categories = ["game-development", "science", "simulation"]
 
 [features]
-default = ["3d", "f32", "collider-from-mesh", "parallel"]
+default = ["3d", "f32", "async-collider", "parallel"]
 3d = []
 f32 = ["dep:parry3d"]
 f64 = ["dep:parry3d-f64"]
@@ -25,6 +25,7 @@ enhanced-determinism = [
     "glam/libm",
 ]
 collider-from-mesh = ["bevy/bevy_render"]
+async-collider = ["bevy/bevy_scene", "bevy/bevy_gltf", "collider-from-mesh"]
 
 [lib]
 name = "bevy_xpbd_3d"
@@ -90,6 +91,10 @@ required-features = ["3d"]
 name = "trimesh_shapes_3d"
 required-features = ["3d"]
 
+[[example]]
+name = "async_colliders"
+required-features = ["3d", "async-collider"]
+
 [[bench]]
 name = "cubes"
 harness = false

crates/bevy_xpbd_3d/examples/async_colliders.rs

@@ -0,0 +1,69 @@
+//! An example showcasing how to create colliders for meshes and scenes
+//! using `AsyncCollider` and `AsyncSceneCollider` respectively.
+
+use bevy::prelude::*;
+use bevy_xpbd_3d::prelude::*;
+use examples_common_3d::XpbdExamplePlugin;
+
+fn main() {
+    App::new()
+        .add_plugins((DefaultPlugins, XpbdExamplePlugin))
+        .add_systems(Startup, setup)
+        .run();
+}
+
+fn setup(
+    mut commands: Commands,
+    mut materials: ResMut<Assets<StandardMaterial>>,
+    mut meshes: ResMut<Assets<Mesh>>,
+    assets: ResMut<AssetServer>,
+) {
+    // Spawn ground and generate a collider for the mesh using AsyncCollider
+    commands.spawn((
+        PbrBundle {
+            mesh: meshes.add(Mesh::from(shape::Plane::from_size(8.0))),
+            material: materials.add(Color::rgb(0.3, 0.5, 0.3).into()),
+            ..default()
+        },
+        AsyncCollider(ComputedCollider::TriMesh),
+        RigidBody::Static,
+    ));
+
+    // Spawn Ferris the crab and generate colliders for the scene using AsyncSceneCollider
+    commands.spawn((
+        SceneBundle {
+            // The model was made by RayMarch, licenced under CC0-1.0, and can be found here:
+            // https://github.com/RayMarch/ferris3d
+            scene: assets.load("ferris.glb#Scene0"),
+            transform: Transform::from_xyz(0.0, 2.0, 0.0).with_scale(Vec3::splat(2.0)),
+            ..default()
+        },
+        // Create colliders using convex decomposition.
+        // This takes longer than creating a trimesh or convex hull collider,
+        // but is more performant for collision detection.
+        AsyncSceneCollider::new(Some(ComputedCollider::ConvexDecomposition(
+            VHACDParameters::default(),
+        )))
+        // Make the arms heavier to make it easier to stand upright
+        .with_density_for_name("armL_mesh", 5.0)
+        .with_density_for_name("armR_mesh", 5.0),
+        RigidBody::Dynamic,
+    ));
+
+    // Light
+    commands.spawn(PointLightBundle {
+        point_light: PointLight {
+            intensity: 3000.0,
+            shadows_enabled: true,
+            ..default()
+        },
+        transform: Transform::from_xyz(2.0, 8.0, 2.0),
+        ..default()
+    });
+
+    // Camera
+    commands.spawn(Camera3dBundle {
+        transform: Transform::from_xyz(-5.0, 3.5, 5.5).looking_at(Vec3::ZERO, Vec3::Y),
+        ..default()
+    });
+}

crates/bevy_xpbd_3d/examples/trimesh_shapes_3d.rs

@@ -48,7 +48,7 @@ fn setup(
     for (i, shape) in shapes.into_iter().enumerate() {
         commands.spawn((
             RigidBody::Dynamic,
-            Collider::trimesh_from_bevy_mesh(&shape).unwrap(),
+            Collider::trimesh_from_mesh(&shape).unwrap(),
             Position(Vector::new(
                 -14.5 / 2.0 + i as Scalar / (num_shapes - 1) as Scalar * 14.5,
                 2.0,