3D Controllers: First + Third Person (Character movement skill)

Player (CharacterBody3D)          # yaw (horizontal look) rotates THIS
  CollisionShape3D                # CapsuleShape3D, radius 0.35, height 1.8
  Head (Node3D)                   # y = 1.5; pitch (vertical look) rotates THIS
    Camera3D                      # fov 70-75
      WeaponHolder (Node3D)       # weapons/tools ride here

extends CharacterBody3D

@export var speed: float = 5.0
@export var sprint_speed: float = 8.0
@export var jump_velocity: float = 4.5
@export var mouse_sensitivity: float = 0.002

@onready var head: Node3D = $Head
var gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity")

func _ready() -> void:
	Input.mouse_mode = Input.MOUSE_MODE_CAPTURED

func _unhandled_input(event: InputEvent) -> void:
	if event is InputEventMouseMotion:
		rotate_y(-event.relative.x * mouse_sensitivity)
		head.rotate_x(-event.relative.y * mouse_sensitivity)
		head.rotation.x = clampf(head.rotation.x, -PI / 2.0, PI / 2.0)
	if event.is_action_pressed("ui_cancel"):
		Input.mouse_mode = Input.MOUSE_MODE_VISIBLE

func _physics_process(delta: float) -> void:
	if not is_on_floor():
		velocity.y -= gravity * delta
	if Input.is_action_just_pressed("jump") and is_on_floor():
		velocity.y = jump_velocity
	var cur_speed := sprint_speed if Input.is_action_pressed("sprint") else speed
	var input_dir := Input.get_vector("move_left", "move_right", "move_forward", "move_back")
	var direction := (transform.basis * Vector3(input_dir.x, 0.0, input_dir.y)).normalized()
	if direction:
		velocity.x = direction.x * cur_speed
		velocity.z = direction.z * cur_speed
	else:
		velocity.x = move_toward(velocity.x, 0.0, cur_speed)
		velocity.z = move_toward(velocity.z, 0.0, cur_speed)
	move_and_slide()

Player (CharacterBody3D)
  CharacterRotationRoot (Node3D)   # only this visual node yaws toward movement
    character.tscn                  # normalized role-neutral visual package
  CameraController (Node3D)
    SpringArm3D                     # extends behind the -Z-facing visual on local +Z
      Camera3D

func resolve_legacy_roles(player: AnimationPlayer) -> Dictionary:
	var result: Dictionary = {}
	var used_clips: Dictionary = {}
	for role in [&"jump", &"idle", &"walk", &"run"]: # Jump must precede Run.
		for clip in player.get_animation_list():
			if used_clips.has(clip):
				continue
			if String(clip).to_lower().contains(String(role)):
				result[role] = clip
				used_clips[clip] = true
				break
	return result