classes/class_rigidbody3d

[giscus[bot]]

classes/class_rigidbody3d

Inherits: PhysicsBody3D< CollisionObject3D< Node3D< Node< Object Inherited By: VehicleBody3D A 3D physics body that is moved by a physics simulation. Description: RigidBody3D implements full 3D phy...

https://docs.godotengine.org/en/latest/classes/class_rigidbody3d.html

[rohanrichards]

The comment on apply_force for the position property is really misleading, to me it reads as "provide a vector in global space." But after many headaches I have finally realized that it's meant to be a local space coordinate, relative to the bodies origin.

[EdwardChanCH]

It's not in local space coordinate either. The function parameter position is a global offset relative to the body's global_position (aka global_transform.origin, or poorly worded as "the body origin in global coordinates").

i.e. position = self.to_global(my_local_offset) - self.global_position

https://github.com/godotengine/godot/blob/e531f3eb7b13a9adaaf5b15ac9b3aebc4c2030cd/modules/godot_physics_3d/godot_body_3d.h#L255-L258

https://github.com/godotengine/godot/blob/e531f3eb7b13a9adaaf5b15ac9b3aebc4c2030cd/modules/godot_physics_3d/godot_body_3d.cpp#L44-L46

[tnlen]

This took me some time to figure out, maybe it helps somebody else:

FREEZE_MODE_STATIC and FREEZE_MODE_KINEMATIC do of course not behave similarly: when using FREEZE_MODE_KINEMATIC you need to move the body in the _physics_process and call reset_physics_interpolation() to successfully move the frozen body, while in FREEZE_MODE_STATIC you can move the body wherever you want.

In hindsight this seems very obvious, because how could it collide with other physics objects if it wasn't moved in _physics_process, but to me the docs weren't quite clear in this regard and I am still not sure, why I need to call reset_physics_interpolation.

[Calinou]

Issue opened:

• Clarify usage of FREEZE_MODE in RigidBodies godot-docs#11208

[pewcworrell]

Stolen from the RigidBody2D docs, but incase anybody else needs it for 3D too:

func teleport_rigidbody(rigidbody: RigidBody3D, target_transform: Transform3D) -> void:
	rigidbody.linear_velocity = Vector3.ZERO
	rigidbody.angular_velocity = Vector3.ZERO
	rigidbody.global_transform = target_transform
	PhysicsServer3D.body_set_state(rigidbody.get_rid(), PhysicsServer3D.BODY_STATE_TRANSFORM, target_transform)
	rigidbody.reset_physics_interpolation()