add prone3d (#111)

addons/nodot/characters/FirstPerson/FirstPersonCharacter.gd

@@ -54,6 +54,7 @@ func _ready() -> void:
 	if has_node("HeadPosition"):
 		var head_position_node: Node = get_node("HeadPosition")
 		head.position = head_position_node.position
+		head_position = head.position
 		head_position_node.queue_free()
 	else:
 		head.position = head_position

addons/nodot/characters/Locomotion3D/CharacterCrouch3D.gd

@@ -52,6 +52,6 @@ func state_updated(old_state: int, new_state: int) -> void:
 func physics(delta: float) -> void:
 	if Input.is_action_pressed(crouch_action):
 		sm.set_state(state_ids["crouch"])
-	else:
+	elif Input.is_action_just_released(crouch_action):
 		sm.set_state(state_ids["stand"])
 

addons/nodot/characters/Locomotion3D/CharacterMover3D.gd

@@ -50,7 +50,7 @@ func ready():
 	InputManager.register_action(down_action, KEY_S)
 	InputManager.register_action(sprint_action, KEY_SHIFT)
 
-	register_handled_states(["idle", "walk", "sprint", "jump", "land", "crouch"])
+	register_handled_states(["idle", "walk", "sprint", "jump", "land", "crouch", "prone"])
 
 	sm.add_valid_transition("idle", ["walk", "sprint"])
 	sm.add_valid_transition("walk", ["idle", "walk", "sprint"])

addons/nodot/characters/Locomotion3D/CharacterProne3D.gd

@@ -0,0 +1,69 @@
+## A node to manage Prone movement of a NodotCharacter3D
+class_name CharacterProne3D extends CharacterExtensionBase3D
+
+## The collision shape to shrink when crouched
+@export var collision_shape: CollisionShape3D
+## The new height of the collision shape
+@export var prone_height: float = 0.1
+## The associated character mover
+@export var character_mover: CharacterMover3D
+## The new movement speed
+@export var movement_speed: float = 0.5
+
+@export_subgroup("Input Actions")
+## The input action name for proneing
+@export var prone_action: String = "prone"
+
+var initial_movement_speed: float = 5.0
+var initial_head_position: Vector3
+var target_head_position: Vector3
+var collider_height: float = 0.0
+
+func ready():
+	if !enabled:
+		return
+
+	InputManager.register_action(prone_action, KEY_X)
+
+	register_handled_states(["idle", "walk", "sprint", "prone", "crouch", "stand"])
+
+	sm.add_valid_transition("idle", ["prone"])
+	sm.add_valid_transition("walk", ["prone"])
+	sm.add_valid_transition("sprint", ["prone"])
+	sm.add_valid_transition("prone", ["stand"])
+	sm.add_valid_transition("crawl", ["prone"])
+	sm.add_valid_transition("stand", ["idle"])
+	sm.add_valid_transition("prone", ["prone"])
+
+	if collision_shape and collision_shape.shape and collision_shape.shape is CapsuleShape3D:
+		collider_height = collision_shape.shape.height
+
+	if character_mover:
+		initial_movement_speed = character_mover.movement_speed
+
+	initial_head_position = character.head_position
+
+func state_updated(old_state: int, new_state: int) -> void:
+	if new_state == state_ids["prone"]:
+		collision_shape.rotation.x = PI / 2
+		target_head_position = Vector3(character.head.position.x, 0.0, -(collider_height / 2))
+		character.velocity = Vector3.ZERO
+		if character_mover:
+			character_mover.movement_speed = movement_speed
+	elif new_state == state_ids["stand"]:
+		collision_shape.rotation.x = 0.0
+		if character_mover:
+			character_mover.movement_speed = initial_movement_speed
+		character.head.position = initial_head_position
+		sm.set_state(state_ids["idle"])
+
+func physics(delta: float) -> void:
+	if Input.is_action_pressed(prone_action):
+		sm.set_state(state_ids["prone"])
+	elif Input.is_action_just_released(prone_action):
+		sm.set_state(state_ids["stand"])
+
+	if sm.state == state_ids["prone"]:
+		character.head.position = lerp(character.head.position, target_head_position, 0.1)
+		character.move_and_slide()
+