Browse Source

Add Important note about Character component gravity override behavior (#422)

* Initial plan

* Add Important note about Character component gravity override behavior

Co-authored-by: VaclavElias <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: VaclavElias <[email protected]>
Copilot 3 months ago
parent
commit
4f110654e5
1 changed files with 3 additions and 0 deletions
  1. 3 0
      en/manual/physics/characters.md

+ 3 - 0
en/manual/physics/characters.md

@@ -23,6 +23,9 @@ Have a look at the [API](xref:Stride.BepuPhysics.CharacterComponent) for more de
 
 
 ## Custom Character Controllers
 ## Custom Character Controllers
 
 
+> [!IMPORTANT]
+> The `CharacterComponent`'s default `IsGrounded` handling temporarily overrides the `Gravity` flag: when the character is grounded and idle, `Gravity` is set to `false` to prevent sliding down slopes. If you need to disable or customize gravity (for flying characters or special movement modes), derive from `CharacterComponent` and adjust the update logic.
+
 When creating a controller, it is recommended to create a new class inheriting from this component instead of using it as is, you can access its internal state and override it with your own logic to better fit your game.
 When creating a controller, it is recommended to create a new class inheriting from this component instead of using it as is, you can access its internal state and override it with your own logic to better fit your game.
 
 
 ```cs
 ```cs