diff --git a/site/docs/10-physics/08-a-physics.mdx b/site/docs/10-physics/08-a-physics.mdx index 888842651..d3f435a25 100644 --- a/site/docs/10-physics/08-a-physics.mdx +++ b/site/docs/10-physics/08-a-physics.mdx @@ -6,13 +6,17 @@ section: Physics import PhysicsExample from '!!raw-loader!./examples/physics.ts'; -Excalibur comes built in with two physics simulations. +Excalibur comes built in with two physics simulations. - "Arcade" style physics which is good for basic collision detection for non-rotated rectangular areas. - Example: platformers, tile based games, top down, etc - "Realistic" style physics which is good for rigid body games where realistic collisions are desired - Example: block stacking, angry bird's style games, etc +**Limitations** + +> **_Note:_** The `SolverStrategy.Arcade` does not support `body.friction`. + ## Arcade Arcade physics simulation is on by default, but can be enabled explicitly in the `Engine` constructor. diff --git a/src/engine/Collision/BodyComponent.ts b/src/engine/Collision/BodyComponent.ts index 864b8b489..144276b20 100644 --- a/src/engine/Collision/BodyComponent.ts +++ b/src/engine/Collision/BodyComponent.ts @@ -226,7 +226,10 @@ export class BodyComponent extends Component implements Clonable public bounciness: number = 0.2; /** - * The coefficient of friction on this actor + * The coefficient of friction on this actor. + * + * The {@apilink SolverStrategy.Arcade} does not support this property. + * */ public friction: number = 0.99;