fix link, add more info |
Added a small description for the component and a suggestion when trying to get the user from a character controller. |
||
Line 5: | Line 5: | ||
|Name=Character Controller | |Name=Character Controller | ||
}} | }} | ||
== Description == | |||
The Character Controller component is used for user movement and simulating physics, and has many settings and values that can alter the way on how a user can control either their self or another slot (For example: Vehicles). These Settings allow you to control the mass, speed, force, etc. | |||
{{Note|When getting the character controller of a user, avoid using the user root. Instead use the locomotion modules within the user root as they can provide the character controller that references the user.|suggestion}} | |||
<!--T:2--> | <!--T:2--> |
Revision as of 20:02, 12 April 2024
This article or section is a Stub. You can help the Resonite Wiki by expanding it.
Description
The Character Controller component is used for user movement and simulating physics, and has many settings and values that can alter the way on how a user can control either their self or another slot (For example: Vehicles). These Settings allow you to control the mass, speed, force, etc.
Fields
Name | Type | Description |
---|---|---|
persistent
|
Bool | Determines whether or not this item will be saved to the server. |
UpdateOrder
|
Int | Controls the order in which this component is updated. |
Enabled
|
Bool | Controls whether or not this component is enabled. |
SimulatingUser
|
User | The user who is currently simulating and networking this Character Controller. |
CharacterRoot
|
Slot | The slot to simulate |
HeadReference
|
Slot | What the Simulation uses for the capsule height |
SimulateRotation
|
Bool | Allow the object simulated by this object to rotate, essentially making it a rigid body. See warning. |
MassScaling
|
PhysicsScalingMode | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
ForceScaling
|
PhysicsScalingMode | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
SpeedScaling
|
PhysicsScalingMode | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
JumpScaling
|
PhysicsScalingMode | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
GravityScaling
|
PhysicsScalingMode | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
LinearDamping
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
AngularDamping
|
Float | |
Margin
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
StepUpHeight
|
Float | |
StepUpCheckDistance
|
Float | |
KillVerticalVelocityAfterStepUp
|
Bool | |
EdgeDetectionDepth
|
Float | |
Speed
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
SlidingSpeed
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
AirSpeed
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
TractionForce
|
Float | How much force is needed to overcome standing friction. |
SlidingForce
|
Float | How much friction force is applied while the CharacterController is moving. |
AirForce
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
MaximumGlueForce
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
MaximumTractionSlope
|
Float | Maximum Traction value before user slides down a slope.
This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
MaximumSupportSlope
|
Float | Maximum Support value before user slides down a slope.
This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
JumpSpeed
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
SlidingJumpSpeed
|
Float | This article or section is a Stub. You can help the Resonite Wiki by expanding it. |
Gravity
|
Float3 | Force of Gravity for this character controller |
GravitySpace
|
direct RootSpace | |
DebugVisualDuration
|
Nullable`1<Float> | Allows for the component to visualize the force vectors acting on the character simulator if set above 0. |
__height
|
Float | Height of the driven CapsuleCollider (Component) Currently does nothing. |
__radius
|
Float | Radius of the driven CapsuleCollider (Component) Currently does nothing. |
__mass
|
Float | Mass of the of the driven CapsuleCollider (Component) Currently does nothing. |
__collideWithOtherCharacters
|
Bool | Currently does nothing. |
__ignoreRaycasts
|
Bool | Currently does nothing. |
__rootAtBottom
|
Bool | Currently does nothing. |
Usage
This component is usually used internally by Resonite to simulate user movement physics like walking and climbing.
But the node can also be manipulated to create "Fake Players" commonly known by Resonite users as "NPC's". Before doing this, know that the physics simulation is always inconsistent when viewed by different players in the same session. It also causes high amounts of networking and FPS lag. Use too many and you may start rising in Queued Packets. The character controller can also be used as a ball, but for things that fly or bounce, using a Trajectory Position ProtoFlux node is vastly superior.
This article or section is a Stub. You can help the Resonite Wiki by expanding it.
Examples
A Shrike NPC running around the cloud home: