diff --git a/src/collision/collider/parry/mod.rs b/src/collision/collider/parry/mod.rs index 1ee020e10..ab6e0356f 100644 --- a/src/collision/collider/parry/mod.rs +++ b/src/collision/collider/parry/mod.rs @@ -1187,6 +1187,14 @@ impl Collider { /// The [`CollisionMargin`] component can be used to add thickness to the shape if needed. /// For thin shapes like triangle meshes, it can help improve collision stability and performance. /// + /// When encountering issues with + /// [Ghost Collisions](https://box2d.org/posts/2020/06/ghost-collisions/) where bodies collide + /// with the internal edges of the trimesh, try setting the flag + /// [`TrimeshFlags::FIX_INTERNAL_EDGES`] via [`Self::trimesh_from_mesh_with_config`], which + /// should fix the issue for edges where none of the adjacent triangles border their neighbor + /// triangles convexly (with an angle less than 180°). Note that this will also not fix the + /// issues with boundary edges between two different colliders. + /// /// # Example /// /// ``` @@ -1223,6 +1231,14 @@ impl Collider { /// The [`CollisionMargin`] component can be used to add thickness to the shape if needed. /// For thin shapes like triangle meshes, it can help improve collision stability and performance. /// + /// When encountering issues with + /// [Ghost Collisions](https://box2d.org/posts/2020/06/ghost-collisions/) where bodies collide + /// with the internal edges of the trimesh, try setting the flag + /// [`TrimeshFlags::FIX_INTERNAL_EDGES`], which should fix the issue for edges where none of + /// the adjacent triangles border their neighbor triangles convexly (with an angle less than + /// 180°). Note that this will also not fix the issues with boundary edges between two different + /// colliders. + /// /// # Example /// /// ```