genre-pack-3d-action

Genre Pack: 3D Action

3rd-person 3D action pack. Camera rig + character controller + lock-on system.

Camera rig (SpringArm3D)

The standard 3rd-person rig:

CameraPivot (Node3D)              -> rotated by input
└── SpringArm3D                    -> collision-aware arm length
    └── Camera3D                    -> child of arm, faces back at the pivot

Configure SpringArm3D:

• spring_length: e.g. 4.0 (max distance back)
• collision_mask: bit 1 (World) so it shrinks when blocked
• shape: SphereShape3D with radius 0.3 (smoother than raycast)
• margin: 0.05

scripts/components/camera_rig.gd:

class_name CameraRig3D
extends Node3D

@export var target: Node3D
@export var follow_speed: float = 8.0
@export var height_offset: float = 1.5

@export var mouse_sensitivity: float = 0.003
@export var stick_sensitivity: float = 3.0
@export var pitch_min_deg: float = -60.0
@export var pitch_max_deg: float = 70.0
@export var invert_y: bool = false

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

func _physics_process(delta: float) -> void:
    if target:
        global_position = global_position.lerp(target.global_position + Vector3.UP * height_offset, follow_speed * delta)
    var stick := Input.get_vector("look_left", "look_right", "look_up", "look_down")
    if stick.length_squared() > 0.04:
        rotation.y -= stick.x * stick_sensitivity * delta
        rotation.x += stick.y * stick_sensitivity * delta * (1.0 if invert_y else -1.0)
        rotation.x = clampf(rotation.x, deg_to_rad(pitch_min_deg), deg_to_rad(pitch_max_deg))

func _unhandled_input(event: InputEvent) -> void:
    if event is InputEventMouseMotion and Input.mouse_mode == Input.MOUSE_MODE_CAPTURED:
        rotation.y -= event.relative.x * mouse_sensitivity
        rotation.x += event.relative.y * mouse_sensitivity * (1.0 if invert_y else -1.0)
        rotation.x = clampf(rotation.x, deg_to_rad(pitch_min_deg), deg_to_rad(pitch_max_deg))
    elif event.is_action_pressed("ui_cancel"):
        Input.mouse_mode = Input.MOUSE_MODE_VISIBLE if Input.mouse_mode == Input.MOUSE_MODE_CAPTURED else Input.MOUSE_MODE_CAPTURED