Skip to content

BodyVelocity

Supported Class Animation & Avatar Deprecated in Roblox Deprecated PreferredDescriptorName ThreadSafety

Applies a force to maintain a constant velocity.

Description

The BodyVelocity object applies a force on an assembly such that it will maintain a constant velocity. The Velocity property, not to be confused with BasePart.AssemblyLinearVelocity, controls the goal velocity.

BodyVelocity is the linear counterpart to BodyAngularVelocity. If you need the assembly to move toward a goal position, use BodyPosition instead. If you need further control on a force applied to an object, consider using a BodyForce or BodyThrust instead.

The strength of the force applied by this object is controlled by several factors, namely the difference between the assembly's current velocity and the goal velocity. This is multiplied by P (power) to either amplify or diminish it. The resulting force is then capped by MaxForce.

Inheritance

Object → Instance → BodyMover → BodyVelocity

Nova inheritance: Instance → BodyMover → BodyVelocity

Properties

MaxForce Supported Property Determines the limit on how much force that may be applied to each axis.
MaxForce: Vector3

Determines the limit on how much force that may be applied to each axis.

This property determines the limit on the amount of force that may be applied on each axis in reaching the goal Velocity. If an assembly isn't moving, consider increasing this value and also check that it is not Anchored or attached to any anchored assemblies.

Roblox documentation

maxForce Supported Property Deprecated Use MaxForce instead
maxForce: Vector3

Use MaxForce instead

Nova behaviour: Nova keeps this legacy member for compatibility. Roblox's modern deprecation wording may describe later Roblox behaviour; verify it against Nova before relying on the copied text.

Roblox documentation

P Supported Property Determines how aggressive of a force is applied in reaching the goal velocity.
P: float

Determines how aggressive of a force is applied in reaching the goal velocity.

This property determines how much power is used while applying force in order to reach the goal Velocity. The higher this value, the more power will be used and the faster it will be used. The force the BodyVelocity exerts increases as the difference between the assembly's current velocity and the goal velocity increases. This property is multiplied to this force to either amplify or diminish it.

Roblox documentation

Velocity Supported Property Determines the goal velocity.
Velocity: Vector3

Determines the goal velocity.

This property (not to be confused with BasePart.Velocity) determines the target velocity towards which force will be exerted. It is specified relative to the world, not the assembly.

Roblox documentation

velocity Supported Property Deprecated Use Velocity instead
velocity: Vector3

Use Velocity instead

Nova behaviour: Nova keeps this legacy member for compatibility. Roblox's modern deprecation wording may describe later Roblox behaviour; verify it against Nova before relying on the copied text.

Roblox documentation

Methods

GetLastForce Supported Function Not implemented and will always return the 0 vector.
BodyVelocity:GetLastForce(): Vector3

Not implemented and will always return the 0 vector.

This method is not implemented and it will always return the 0 vector. You are advised to use AlignPosition instead.

Roblox documentation

lastForce Supported Function Returns the last force in the object.
BodyVelocity:lastForce(): Vector3

Returns the last force in the object.

Roblox documentation

Inherited members

Inherited from BodyMover: 8 properties, 36 methods, 7 events. They are documented on the base class page.

Roblox reference: BodyVelocity

Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.