Initial prototype of character motion.

audio/bus_layout.tres

@@ -0,0 +1,15 @@
+[gd_resource type="AudioBusLayout" format=3 uid="uid://csk12vyidwnew"]
+
+[resource]
+bus/1/name = &"Sound Effects"
+bus/1/solo = false
+bus/1/mute = false
+bus/1/bypass_fx = false
+bus/1/volume_db = 0.0
+bus/1/send = &"Master"
+bus/2/name = &"Music"
+bus/2/solo = false
+bus/2/mute = false
+bus/2/bypass_fx = false
+bus/2/volume_db = 0.0
+bus/2/send = &"Master"

characters/base/base_character.tscn

@@ -0,0 +1,74 @@
+[gd_scene load_steps=29 format=3 uid="uid://blpbgwklc21k5"]
+
+[ext_resource type="Script" uid="uid://jshmfmeoj28y" path="res://characters/base/character.gd" id="1_f78fl"]
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="2_cchsv"]
+[ext_resource type="AudioStream" uid="uid://hv8sb7mxhcnb" path="res://audio/land.ogg" id="2_ggkgm"]
+[ext_resource type="Script" uid="uid://dl5vblkrydr4q" path="res://util/property_save_restore_stack.gd" id="2_lii0y"]
+[ext_resource type="Resource" uid="uid://sqqxxbj4duf4" path="res://characters/base/template_csp_idle.tres" id="3_4vv4m"]
+[ext_resource type="Script" uid="uid://bafxukojlafvh" path="res://util/state_machine.gd" id="3_l7dgf"]
+[ext_resource type="Resource" uid="uid://5mv3ctktmsbm" path="res://characters/base/template_csp_walk.tres" id="4_0mnbh"]
+[ext_resource type="Resource" uid="uid://bjgfhx1i6g8pu" path="res://characters/base/template_csp_run.tres" id="5_lyvph"]
+[ext_resource type="Resource" uid="uid://bvruotly1ghl8" path="res://characters/base/template_csp_sprint.tres" id="6_aigsb"]
+[ext_resource type="Resource" uid="uid://da512s5hs7ly" path="res://characters/base/template_csp_jump.tres" id="7_q5w5h"]
+[ext_resource type="Resource" uid="uid://bhq36aidyidqr" path="res://characters/base/template_csp_fall.tres" id="8_wjwdx"]
+[ext_resource type="Resource" uid="uid://cmk3r1rli555v" path="res://characters/base/template_csp_skid.tres" id="9_e1qjb"]
+[ext_resource type="Resource" uid="uid://btu3efdwlpr7k" path="res://characters/base/template_csp_wall_slide.tres" id="10_5e0lb"]
+[ext_resource type="Resource" uid="uid://caskx8dmdd3h5" path="res://characters/base/template_csp_hang.tres" id="11_euyh3"]
+[ext_resource type="Resource" uid="uid://blflaoqntbe7w" path="res://characters/base/template_csp_pull_up.tres" id="12_5etud"]
+[ext_resource type="Resource" uid="uid://bhwoe6hvwy4ak" path="res://characters/base/template_csp_hit.tres" id="13_5d22g"]
+[ext_resource type="Resource" uid="uid://oi0fr0o3ieis" path="res://characters/base/template_csp_defeat.tres" id="14_j1rrh"]
+[ext_resource type="Resource" uid="uid://cjqc2nyywenfk" path="res://characters/base/template_csp_victory1.tres" id="15_hhowv"]
+[ext_resource type="Resource" uid="uid://bss0mt60m7lep" path="res://characters/base/template_csp_victory2.tres" id="16_0pfk6"]
+[ext_resource type="Resource" uid="uid://dlenj6oro0pfn" path="res://characters/base/template_csp_pick_up.tres" id="17_0mnbh"]
+[ext_resource type="Resource" uid="uid://c2x7tc3irusqo" path="res://characters/base/template_csp_put_down.tres" id="18_lyvph"]
+[ext_resource type="Resource" uid="uid://cwxqc1hw103ns" path="res://characters/base/template_csp_idle_while_holding.tres" id="19_euyh3"]
+[ext_resource type="Resource" uid="uid://dn6h1cdnxolmk" path="res://characters/base/template_csp_walk_while_holding.tres" id="20_5etud"]
+[ext_resource type="Resource" uid="uid://c4u68hfaaoeoe" path="res://characters/base/template_csp_run_while_holding.tres" id="21_5d22g"]
+[ext_resource type="Resource" uid="uid://b5sb0w2ex8hyn" path="res://characters/base/template_csp_fall_while_holding.tres" id="22_j1rrh"]
+[ext_resource type="Resource" uid="uid://cgx3p61bbw6sw" path="res://characters/base/template_csp_jump_while_holding.tres" id="23_hhowv"]
+[ext_resource type="Resource" uid="uid://dc346050qtltb" path="res://characters/base/template_csp_swim.tres" id="24_0pfk6"]
+[ext_resource type="Resource" uid="uid://mgefvwuayfk4" path="res://characters/base/template_csp_swim_while_holding.tres" id="25_hpxkk"]
+
+[node name="BaseCharacter" type="RigidBody3D" node_paths=PackedStringArray("_audio_player", "_property_save_restore_stack", "_state_machine")]
+mass = 60.0
+script = ExtResource("1_f78fl")
+_audio_player = NodePath("AudioStreamPlayer3D")
+_property_save_restore_stack = NodePath("PropertySaveRestoreStack")
+_state_machine = NodePath("StateMachine")
+_state_properties = Dictionary[StringName, ExtResource("2_cchsv")]({
+&"defeat": ExtResource("14_j1rrh"),
+&"fall": ExtResource("8_wjwdx"),
+&"fall-while-holding": ExtResource("22_j1rrh"),
+&"hang": ExtResource("11_euyh3"),
+&"hit": ExtResource("13_5d22g"),
+&"idle": ExtResource("3_4vv4m"),
+&"idle-while-holding": ExtResource("19_euyh3"),
+&"jump": ExtResource("7_q5w5h"),
+&"jump-while-holding": ExtResource("23_hhowv"),
+&"pick-up": ExtResource("17_0mnbh"),
+&"pull-up": ExtResource("12_5etud"),
+&"put-down": ExtResource("18_lyvph"),
+&"run": ExtResource("5_lyvph"),
+&"run-while-holding": ExtResource("21_5d22g"),
+&"skid": ExtResource("9_e1qjb"),
+&"sprint": ExtResource("6_aigsb"),
+&"swim": ExtResource("24_0pfk6"),
+&"swim-while-holding": ExtResource("25_hpxkk"),
+&"victory1": ExtResource("15_hhowv"),
+&"victory2": ExtResource("16_0pfk6"),
+&"walk": ExtResource("4_0mnbh"),
+&"walk-while-holding": ExtResource("20_5etud"),
+&"wall-slide": ExtResource("10_5e0lb")
+})
+_landing_sound = ExtResource("2_ggkgm")
+metadata/_custom_type_script = "uid://jshmfmeoj28y"
+
+[node name="AudioStreamPlayer3D" type="AudioStreamPlayer3D" parent="."]
+
+[node name="PropertySaveRestoreStack" type="Node" parent="."]
+script = ExtResource("2_lii0y")
+metadata/_custom_type_script = "uid://dl5vblkrydr4q"
+
+[node name="StateMachine" type="Node" parent="."]
+script = ExtResource("3_l7dgf")
+metadata/_custom_type_script = "uid://bafxukojlafvh"

characters/base/character.gd.uid

@@ -0,0 +1 @@
+uid://jshmfmeoj28y

characters/base/character_state_properties.gd

@@ -0,0 +1,120 @@
+class_name CharacterStateProperties extends Resource
+## Descriptor of how a Character's properties should change in some given state.
+
+## How the character should self-orient in this state.
+enum OrientationMode {
+	## Do not self-orient in this state / other code will handle it.
+	MANUAL,
+	## Self-orient toward the direction we are actually moving in.
+	FOLLOW_VELOCITY,
+	## Self-orient toward the direction we are trying to move in.
+	FOLLOW_ACCELERATION,
+	## Self-orient according to the normal of the contact surface.
+	FOLLOW_NORMAL
+}
+
+## How the character should move in this state.
+enum PhysicsMode {
+	## Character responds to impetus projected onto ground plane.
+	NORMAL,
+	## Character responds to impetus unmodified.
+	FREE,
+	## Character does not respond to impetus.
+	NO_IMPETUS,
+	## Character is not subject to physics at all.
+	FREEZE
+}
+
+@export_group("Transitions")
+## Whether to use a timer to prevent stopping this state too quickly.
+@export var use_coyote_time := false
+## Value to assign to the timer on state start if use_coyote_time is true.
+@export var coyote_time: float = 0.0
+## Whether to disallow interrupting this state.
+## [br][br]
+## Even if true, can be overruled with force_change_state.
+## For example, the logic of the uninterruptible state itself
+## can use this strategy for sanctioned state transitions.
+@export var uninterruptible := false
+## Whether this state is to be used while carrying an object.
+## [br][br]
+## If true, it cannot be entered while not carrying an object.
+## If false, entering it will force any carried object to be dropped,
+## unless equivalent_carrying_state is specified,
+## in which case that state will be entered instead.
+@export var is_carrying_state := false
+## State to enter instead of this state if carrying an object.
+@export var equivalent_carrying_state := &''
+
+@export_group("Animation")
+## Animation to play in this state.
+@export var animation_name: StringName = &'idle'
+## If specified, 50% random chance to use this animation instead.
+@export var animation_alt_name: StringName = &''
+## Animation playback rate when not moving.
+@export var animation_base_speed: float = 1.0
+## Animation blend time in seconds.
+@export var animation_blend_time: float = 0.25
+## When moving, actual playback rate is base plus this times speed.
+@export var animation_speedup_with_velocity: float = 0.0
+
+@export_group("Audio")
+## Audio stream to play when entering this state.
+@export var audio: AudioStream = null
+## Volume to use for the audio stream played when entering this state.
+@export var audio_volume_db: float = 0.0
+
+@export_group("Collision")
+## Collider length in meters in this state.
+@export var collider_length: float = 1.0
+## Collider radius in meters in this state.
+@export var collider_radius: float = 0.5
+## Whether collider length axis should be local z rather than local y.
+@export var collider_horizontal := false
+
+@export_group("Orientation")
+## Self-orientation strategy for deciding yaw.
+@export var yaw_orientation := OrientationMode.MANUAL
+## Self-orientation strategy for deciding pitch.
+@export var pitch_orientation := OrientationMode.MANUAL
+## Multiplier for calculated angular velocity required to self-orient.
+@export var orientation_speed: float = 600.0
+
+@export_group("Physics")
+## Whether this state counts as being supported by solid ground.
+## [br][br]
+## The character node also separately tracks empirically
+## whether it is currently supported by solid ground in actuality,
+## but for some purposes, particularly self-righting,
+## it's better to go with whether the current state thinks we are grounded
+## than whether we actually are.
+@export var counts_as_grounded := false
+## How the character should move in this state.
+@export var physics_mode := PhysicsMode.NORMAL
+
+@export_group("Combat")
+## Whether this state is an attack.
+@export var is_attack := false
+## Base damage dealt by this attack.
+@export var attack_base_damage: float = 0.0
+## Base impact for knockback dealt by this attack.
+@export var attack_base_knockback: float = 0.0
+## Whether the character ignores attacks received while in this state.
+@export var invulnerable := false
+
+@export_group("Etc")
+## Properties to override while the character is in this state.
+## [br][br]
+## Each key should be a property path relative to the character node,
+## and the corresponding value should be the desired value
+## to be assigned to the named property.
+## [br][br]
+## The keys are typed as String instead of NodePath to avoid confusion,
+## because, at the time of writing, Godot offers a streamlined way
+## to point an exported NodePath to a Node, but no streamlined way
+## to point it to a property. The API user would have to manually type in
+## the property path anyway, and even then, only the node portion of the path
+## would show in the inspector. Exporting as String instead,
+## while less correct, eliminates potential confusion
+## caused by NodePath's Node-oriented inspector UI.
+@export var etc: Dictionary[String, Variant]

characters/base/character_state_properties.gd.uid

@@ -0,0 +1 @@
+uid://vogde76hsl0j

characters/base/template_csp_defeat.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://oi0fr0o3ieis"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_qyetd"]
+
+[resource]
+script = ExtResource("1_qyetd")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"defeat"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 2
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_fall.tres

@@ -0,0 +1,31 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://bhq36aidyidqr"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_bhdor"]
+
+[resource]
+script = ExtResource("1_bhdor")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"fall-while-holding"
+animation_name = &"fall"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.0
+collider_radius = 0.5
+collider_horizontal = false
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_fall_while_holding.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://b5sb0w2ex8hyn"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_gs8hr"]
+
+[resource]
+script = ExtResource("1_gs8hr")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"fall-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_hang.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://caskx8dmdd3h5"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_f0l30"]
+
+[resource]
+script = ExtResource("1_f0l30")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"hang"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = false
+physics_mode = 3
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_hit.tres

@@ -0,0 +1,33 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=3 format=3 uid="uid://bhwoe6hvwy4ak"]
+
+[ext_resource type="AudioStream" uid="uid://gsdbpcl71gku" path="res://audio/knockback.ogg" id="1_7n6rg"]
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_b2h4o"]
+
+[resource]
+script = ExtResource("1_b2h4o")
+use_coyote_time = true
+coyote_time = 1.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"hit"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("1_7n6rg")
+audio_volume_db = 0.0
+collider_length = 1.0
+collider_radius = 0.5
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 2
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_idle.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://sqqxxbj4duf4"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_ylq5n"]
+
+[resource]
+script = ExtResource("1_ylq5n")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"idle-while-holding"
+animation_name = &"idle"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_width = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_idle_while_holding.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://cwxqc1hw103ns"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_esksn"]
+
+[resource]
+script = ExtResource("1_esksn")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"idle-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_jump.tres

@@ -0,0 +1,32 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=3 format=3 uid="uid://da512s5hs7ly"]
+
+[ext_resource type="AudioStream" uid="uid://b7c586tdidtlp" path="res://audio/jump.ogg" id="1_10il7"]
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_d107m"]
+
+[resource]
+script = ExtResource("1_d107m")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"jump-while-holding"
+animation_name = &"jump1"
+animation_alt_name = &"jump2"
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("1_10il7")
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_jump_while_holding.tres

@@ -0,0 +1,32 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=3 format=3 uid="uid://cgx3p61bbw6sw"]
+
+[ext_resource type="AudioStream" uid="uid://b7c586tdidtlp" path="res://audio/jump.ogg" id="1_eq8v0"]
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="2_2rxeo"]
+
+[resource]
+script = ExtResource("2_2rxeo")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"jump-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("1_eq8v0")
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_pick_up.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://dlenj6oro0pfn"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_462hs"]
+
+[resource]
+script = ExtResource("1_462hs")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"pick-up"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 2
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_pull_up.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://blflaoqntbe7w"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_fd2fj"]
+
+[resource]
+script = ExtResource("1_fd2fj")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"pull-up"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 3
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_put_down.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://c2x7tc3irusqo"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_setmo"]
+
+[resource]
+script = ExtResource("1_setmo")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"put-down"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 2
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_run.tres

@@ -0,0 +1,31 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://bjgfhx1i6g8pu"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_gwl8f"]
+
+[resource]
+script = ExtResource("1_gwl8f")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"run-while-holding"
+animation_name = &"run"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.0
+collider_radius = 0.5
+collider_horizontal = false
+yaw_orientation = 2
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_run_while_holding.tres

@@ -0,0 +1,31 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://c4u68hfaaoeoe"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_m3xgw"]
+
+[resource]
+script = ExtResource("1_m3xgw")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"run-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.0
+collider_radius = 0.5
+collider_horizontal = false
+yaw_orientation = 2
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_skid.tres

@@ -0,0 +1,32 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=3 format=3 uid="uid://cmk3r1rli555v"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_6x34n"]
+[ext_resource type="AudioStream" uid="uid://cxv0o73if41v1" path="res://audio/slide.ogg" id="1_brnuv"]
+
+[resource]
+script = ExtResource("1_6x34n")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"run-while-holding"
+animation_name = &"skid"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("1_brnuv")
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_sprint.tres

@@ -0,0 +1,31 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://bvruotly1ghl8"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_a6tcg"]
+
+[resource]
+script = ExtResource("1_a6tcg")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"run-while-holding"
+animation_name = &"sprint"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.0
+collider_radius = 0.5
+collider_horizontal = false
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_swim.tres

@@ -0,0 +1,31 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://dc346050qtltb"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_bw5dp"]
+
+[resource]
+script = ExtResource("1_bw5dp")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"swim-while-holding"
+animation_name = &"swim"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.0
+collider_radius = 0.5
+collider_horizontal = false
+yaw_orientation = 2
+pitch_orientation = 2
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 1
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_swim_while_holding.tres

@@ -0,0 +1,31 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://mgefvwuayfk4"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_3onor"]
+
+[resource]
+script = ExtResource("1_3onor")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"swim-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.0
+collider_radius = 0.5
+collider_horizontal = false
+yaw_orientation = 2
+pitch_orientation = 2
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 1
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_victory1.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://cjqc2nyywenfk"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_7e7w4"]
+
+[resource]
+script = ExtResource("1_7e7w4")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"victory1"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 3
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_victory2.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://bss0mt60m7lep"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_df5ac"]
+
+[resource]
+script = ExtResource("1_df5ac")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"victory2"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 3
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_walk.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://5mv3ctktmsbm"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_56rm8"]
+
+[resource]
+script = ExtResource("1_56rm8")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"walk-while-holding"
+animation_name = &"walk"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 2
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_walk_while_holding.tres

@@ -0,0 +1,30 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=2 format=3 uid="uid://dn6h1cdnxolmk"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_sffyy"]
+
+[resource]
+script = ExtResource("1_sffyy")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"walk-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_height = 1.0
+collider_radius = 0.5
+yaw_orientation = 2
+pitch_orientation = 3
+orientation_speed = 1.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/base/template_csp_wall_slide.tres

@@ -0,0 +1,33 @@
+[gd_resource type="Resource" script_class="CharacterStateProperties" load_steps=3 format=3 uid="uid://btu3efdwlpr7k"]
+
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="1_gklf8"]
+[ext_resource type="AudioStream" uid="uid://cxv0o73if41v1" path="res://audio/slide.ogg" id="1_vcia5"]
+
+[resource]
+script = ExtResource("1_gklf8")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"wall-slide"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("1_vcia5")
+audio_volume_db = 0.0
+collider_length = 1.0
+collider_radius = 0.5
+collider_horizontal = false
+yaw_orientation = 3
+pitch_orientation = 3
+orientation_speed = 1000.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"

characters/controllers/player_character_controller.gd

@@ -0,0 +1,57 @@
+class_name PlayerCharacterController extends Node
+
+@export var camera: Camera3D = null
+@export var character: Character = null
+@export var camera_sensitivity: float = 2.0
+@export var camera_lerp_speed: float = 4.0
+@export var camera_distance: float = 5.0
+@export var camera_min_distance: float = 2.0
+@export var camera_max_distance: float = 10.0
+@export var camera_pitch: float = -0.5
+@export var camera_min_pitch: float = -1.0
+@export var camera_max_pitch: float = -0.2
+
+@onready var camera_yaw: float = (
+	character.global_rotation.y if character else 0.0
+)
+
+func _physics_process(delta: float) -> void:
+	if camera && character:
+		var look_input := Vector3(
+			Input.get_axis(&'look_left', &'look_right'),
+			Input.get_axis(&'look_down', &'look_up'),
+			Input.get_axis(&'zoom_in', &'zoom_out')
+		)
+		camera_distance = clamp(
+			camera_distance + PI*look_input.z*camera_sensitivity*delta,
+			camera_min_distance, camera_max_distance
+		)
+		camera_yaw = fposmod(
+			camera_yaw - look_input.x*camera_sensitivity*delta,
+			2.0*PI
+		)
+		camera_pitch = clamp(
+			camera_pitch + look_input.y*camera_sensitivity*delta,
+			camera_min_pitch, camera_max_pitch
+		)
+		var bas := Basis.IDENTITY.rotated(
+			Vector3.RIGHT, camera_pitch
+		).rotated(
+			Vector3.UP, camera_yaw
+		)
+		bas = Basis.looking_at(-bas.z, character.ground_normal)
+		var posn := character.global_position + camera_distance*bas.z
+		var lerp_weight: float = 1.0 - 0.5**(camera_lerp_speed*delta)
+		camera.global_basis = camera.global_basis.slerp(bas, lerp_weight)
+		camera.global_position = lerp(camera.global_position, posn, lerp_weight)
+		var move_input := Vector2(
+			Input.get_axis(&'move_left', &'move_right'),
+			Input.get_axis(&'move_forward', &'move_backward')
+		)
+		character.global_impetus = (
+			move_input.x*camera.basis.x +
+			move_input.y*camera.basis.z
+		)
+		character.jump_impetus = Input.is_action_pressed(&'jump')
+		character.action1_impetus = Input.is_action_pressed(&'action1')
+		character.action2_impetus = Input.is_action_pressed(&'action2')

characters/controllers/player_character_controller.gd.uid

@@ -0,0 +1 @@
+uid://d26dyumvg37cp

characters/test_stick.tscn

@@ -0,0 +1,734 @@
+[gd_scene load_steps=31 format=3 uid="uid://gis0gxap8i8t"]
+
+[ext_resource type="PackedScene" uid="uid://blpbgwklc21k5" path="res://characters/base/base_character.tscn" id="1_xjtlb"]
+[ext_resource type="Script" uid="uid://vogde76hsl0j" path="res://characters/base/character_state_properties.gd" id="2_skd7h"]
+[ext_resource type="PackedScene" uid="uid://8nwke3wilk60" path="res://models/characters/stick.blend" id="2_vksnu"]
+[ext_resource type="AudioStream" uid="uid://gsdbpcl71gku" path="res://audio/knockback.ogg" id="3_pt5mk"]
+[ext_resource type="AudioStream" uid="uid://b7c586tdidtlp" path="res://audio/jump.ogg" id="4_slt4y"]
+[ext_resource type="AudioStream" uid="uid://cxv0o73if41v1" path="res://audio/slide.ogg" id="5_1n8td"]
+
+[sub_resource type="Resource" id="Resource_2hlgv"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"defeat"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.18
+collider_horizontal = true
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 2
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_f3575"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"fall-while-holding"
+animation_name = &"fall"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 0.6
+collider_radius = 0.3
+collider_horizontal = false
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_pgpxt"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"fall-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.3
+collider_horizontal = false
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_pt5mk"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"hang"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 0.1
+collider_radius = 0.05
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 3
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_skd7h"]
+script = ExtResource("2_skd7h")
+use_coyote_time = true
+coyote_time = 1.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"hit"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("3_pt5mk")
+audio_volume_db = 0.0
+collider_length = 0.9
+collider_radius = 0.4
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 2
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_u35sk"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"idle-while-holding"
+animation_name = &"idle"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.18
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_slt4y"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"idle-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.25
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_h0wc8"]
+script = ExtResource("2_skd7h")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"jump-while-holding"
+animation_name = &"jump1"
+animation_alt_name = &"jump2"
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("4_slt4y")
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.25
+collider_horizontal = false
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_op5jh"]
+script = ExtResource("2_skd7h")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"jump-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("4_slt4y")
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.35
+collider_horizontal = false
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_mofui"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"pick-up"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.35
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 2
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_chbfi"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"pull-up"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 0.1
+collider_radius = 0.05
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 3
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_a20lq"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"put-down"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.35
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 2
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_aipdl"]
+script = ExtResource("2_skd7h")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"run-while-holding"
+animation_name = &"run"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.35
+collider_horizontal = false
+yaw_orientation = 2
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_1n8td"]
+script = ExtResource("2_skd7h")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"run-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.35
+collider_horizontal = false
+yaw_orientation = 2
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_ul8hc"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"run-while-holding"
+animation_name = &"skid"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("5_1n8td")
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.35
+collider_horizontal = false
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_s4iwp"]
+script = ExtResource("2_skd7h")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"run-while-holding"
+animation_name = &"sprint"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.35
+collider_horizontal = false
+yaw_orientation = 1
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_o7tpm"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"swim-while-holding"
+animation_name = &"swim"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.18
+collider_horizontal = true
+yaw_orientation = 2
+pitch_orientation = 2
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 1
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_fqgwu"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"swim-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.1
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.18
+collider_horizontal = true
+yaw_orientation = 2
+pitch_orientation = 2
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 1
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_tp4uk"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"victory1"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.1
+collider_radius = 0.3
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 3
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_smtit"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = true
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"victory2"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.25
+collider_horizontal = false
+yaw_orientation = 0
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 3
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = true
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_5i55i"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &"walk-while-holding"
+animation_name = &"walk"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.18
+collider_horizontal = false
+yaw_orientation = 2
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_ruaq6"]
+script = ExtResource("2_skd7h")
+use_coyote_time = false
+coyote_time = 0.0
+uninterruptible = false
+is_carrying_state = true
+equivalent_carrying_state = &""
+animation_name = &"walk-while-holding"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.25
+collider_horizontal = false
+yaw_orientation = 2
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = true
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="Resource" id="Resource_1oy2a"]
+script = ExtResource("2_skd7h")
+use_coyote_time = true
+coyote_time = 0.25
+uninterruptible = false
+is_carrying_state = false
+equivalent_carrying_state = &""
+animation_name = &"wall-slide"
+animation_alt_name = &""
+animation_base_speed = 1.0
+animation_blend_time = 0.25
+animation_speedup_with_velocity = 0.0
+audio = ExtResource("5_1n8td")
+audio_volume_db = 0.0
+collider_length = 1.3
+collider_radius = 0.05
+collider_horizontal = false
+yaw_orientation = 3
+pitch_orientation = 3
+orientation_speed = 600.0
+counts_as_grounded = false
+physics_mode = 0
+is_attack = false
+attack_base_damage = 0.0
+attack_base_knockback = 0.0
+invulnerable = false
+etc = Dictionary[String, Variant]({})
+metadata/_custom_type_script = "uid://vogde76hsl0j"
+
+[sub_resource type="CapsuleShape3D" id="CapsuleShape3D_v6oe5"]
+radius = 0.18
+height = 1.3
+
+[node name="TestStick" node_paths=PackedStringArray("_anim_player", "_collider") instance=ExtResource("1_xjtlb")]
+mass = 35.0
+_anim_player = NodePath("stick/AnimationPlayer")
+_collider = NodePath("CollisionShape3D")
+_state_properties = Dictionary[StringName, ExtResource("2_skd7h")]({
+&"defeat": SubResource("Resource_2hlgv"),
+&"fall": SubResource("Resource_f3575"),
+&"fall-while-holding": SubResource("Resource_pgpxt"),
+&"hang": SubResource("Resource_pt5mk"),
+&"hit": SubResource("Resource_skd7h"),
+&"idle": SubResource("Resource_u35sk"),
+&"idle-while-holding": SubResource("Resource_slt4y"),
+&"jump": SubResource("Resource_h0wc8"),
+&"jump-while-holding": SubResource("Resource_op5jh"),
+&"pick-up": SubResource("Resource_mofui"),
+&"pull-up": SubResource("Resource_chbfi"),
+&"put-down": SubResource("Resource_a20lq"),
+&"run": SubResource("Resource_aipdl"),
+&"run-while-holding": SubResource("Resource_1n8td"),
+&"skid": SubResource("Resource_ul8hc"),
+&"sprint": SubResource("Resource_s4iwp"),
+&"swim": SubResource("Resource_o7tpm"),
+&"swim-while-holding": SubResource("Resource_fqgwu"),
+&"victory1": SubResource("Resource_tp4uk"),
+&"victory2": SubResource("Resource_smtit"),
+&"walk": SubResource("Resource_5i55i"),
+&"walk-while-holding": SubResource("Resource_ruaq6"),
+&"wall-slide": SubResource("Resource_1oy2a")
+})
+
+[node name="stick" parent="." index="3" instance=ExtResource("2_vksnu")]
+transform = Transform3D(-1, 0, -8.74228e-08, 0, 1, 0, 8.74228e-08, 0, -1, 0, 0, 0)
+
+[node name="Skeleton3D" parent="stick/Stick" index="0"]
+bones/0/position = Vector3(0, 0.646973, 0)
+bones/1/rotation = Quaternion(0.0003625, 1.19209e-07, -4.32134e-11, 1)
+bones/5/position = Vector3(-0.0532939, 0.230331, 0.0647434)
+bones/5/rotation = Quaternion(0.571188, -0.0632699, 0.044224, 0.817181)
+bones/5/scale = Vector3(1, 1, 1)
+bones/6/position = Vector3(0.0532939, 0.230331, 0.0647434)
+bones/6/rotation = Quaternion(0.571188, 0.0632699, -0.044224, 0.817181)
+bones/6/scale = Vector3(1, 1, 1)
+bones/7/scale = Vector3(1, 1, 1)
+bones/8/scale = Vector3(1, 1, 1)
+bones/9/rotation = Quaternion(0.696536, -0.121809, 0.696536, 0.121809)
+bones/10/rotation = Quaternion(0.137446, 0.693669, 0.136943, 0.69367)
+bones/11/rotation = Quaternion(-0.0559155, -0.704892, -0.0559155, 0.704893)
+bones/12/rotation = Quaternion(0.314587, -0.188327, -0.650011, 0.665623)
+bones/13/rotation = Quaternion(0.130504, 1.42832e-08, 1.18041e-08, 0.991448)
+bones/14/position = Vector3(0.000918027, 0.0538679, 0.0506858)
+bones/15/rotation = Quaternion(0.696536, 0.121809, -0.696536, 0.121809)
+bones/16/rotation = Quaternion(0.137446, -0.693669, -0.136943, 0.69367)
+bones/17/rotation = Quaternion(-0.0559155, 0.704892, 0.0559155, 0.704893)
+bones/18/rotation = Quaternion(0.314587, 0.188327, 0.650011, 0.665623)
+bones/19/rotation = Quaternion(0.130504, -1.42851e-08, -1.18268e-08, 0.991448)
+bones/20/position = Vector3(1.01205e-08, 0.0390958, -0.0424486)
+bones/20/rotation = Quaternion(1.0863e-07, 0.745269, -0.666764, 5.62662e-08)
+bones/21/rotation = Quaternion(1, 1.58454e-11, -4.37114e-08, 0.0003625)
+bones/22/rotation = Quaternion(0.000725, 4.37114e-08, -3.16907e-11, 1)
+bones/23/rotation = Quaternion(-0.526096, 2.5005e-07, -1.54437e-07, 0.850425)
+bones/24/rotation = Quaternion(1, 1.58454e-11, -4.37114e-08, 0.0003625)
+bones/25/rotation = Quaternion(0.000725, 4.37114e-08, -3.16907e-11, 1)
+bones/26/rotation = Quaternion(-0.526096, 2.5005e-07, -1.54437e-07, 0.850425)
+bones/27/rotation = Quaternion(-3.71988e-08, -0.130247, 0.991482, 6.56977e-08)
+bones/28/rotation = Quaternion(-0.281594, -3.06002e-08, -8.61524e-09, 0.959534)
+bones/29/rotation = Quaternion(-0.458315, 4.53554e-10, -9.05138e-10, 0.88879)
+
+[node name="CollisionShape3D" type="CollisionShape3D" parent="." index="4"]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.65, 0)
+shape = SubResource("CapsuleShape3D_v6oe5")
+
+[editable path="stick"]

project.godot

@@ -14,6 +14,177 @@ config/name="Stick the Quick"
 config/features=PackedStringArray("4.4", "GL Compatibility")
 config/icon="res://icon.svg"
 
+[audio]
+
+buses/default_bus_layout="res://audio/bus_layout.tres"
+
+[input]
+
+ui_accept={
+"deadzone": 0.5,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194309,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194310,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":32,"physical_keycode":0,"key_label":0,"unicode":32,"location":0,"echo":false,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":0,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":6,"pressure":0.0,"pressed":true,"script":null)
+]
+}
+ui_select={
+"deadzone": 0.5,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":32,"physical_keycode":0,"key_label":0,"unicode":32,"location":0,"echo":false,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":0,"pressure":0.0,"pressed":true,"script":null)
+]
+}
+ui_cancel={
+"deadzone": 0.5,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194305,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":1,"pressure":0.0,"pressed":true,"script":null)
+]
+}
+ui_focus_next={
+"deadzone": 0.5,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194306,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":10,"pressure":0.0,"pressed":true,"script":null)
+]
+}
+ui_focus_prev={
+"deadzone": 0.5,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":true,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194306,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":9,"pressure":0.0,"pressed":true,"script":null)
+]
+}
+ui_page_up={
+"deadzone": 0.5,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194323,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":4,"axis_value":1.0,"script":null)
+]
+}
+ui_page_down={
+"deadzone": 0.5,
+"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":0,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":4194324,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":5,"axis_value":1.0,"script":null)
+]
+}
+look_up={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":3,"axis_value":1.0,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194322,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194440,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+look_down={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":3,"axis_value":-1.0,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194320,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194446,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+look_left={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":2,"axis_value":-1.0,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194319,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194442,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+look_right={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":2,"axis_value":1.0,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194321,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194444,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+look_auto={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":9,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194325,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194443,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+zoom_in={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":5,"axis_value":1.0,"script":null)
+, Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":0,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":4,"canceled":false,"pressed":false,"double_click":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":61,"key_label":0,"unicode":61,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194437,"key_label":0,"unicode":43,"location":0,"echo":false,"script":null)
+]
+}
+zoom_out={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":4,"axis_value":1.0,"script":null)
+, Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":0,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":5,"canceled":false,"pressed":false,"double_click":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":45,"key_label":0,"unicode":45,"location":0,"echo":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194435,"key_label":0,"unicode":45,"location":0,"echo":false,"script":null)
+]
+}
+target={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":7,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":8,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":10,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":0,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":3,"canceled":false,"pressed":false,"double_click":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194306,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+]
+}
+move_forward={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":1,"axis_value":-1.0,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":11,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":87,"key_label":0,"unicode":119,"location":0,"echo":false,"script":null)
+]
+}
+move_backward={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":1,"axis_value":1.0,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":12,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":83,"key_label":0,"unicode":115,"location":0,"echo":false,"script":null)
+]
+}
+move_left={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":0,"axis_value":-1.0,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":13,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":65,"key_label":0,"unicode":97,"location":0,"echo":false,"script":null)
+]
+}
+move_right={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":0,"axis_value":1.0,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":14,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":68,"key_label":0,"unicode":100,"location":0,"echo":false,"script":null)
+]
+}
+jump={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":0,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":32,"key_label":0,"unicode":32,"location":0,"echo":false,"script":null)
+]
+}
+interact={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":3,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":69,"key_label":0,"unicode":101,"location":0,"echo":false,"script":null)
+]
+}
+action1={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":1,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":0,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":1,"canceled":false,"pressed":false,"double_click":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":81,"key_label":0,"unicode":113,"location":0,"echo":false,"script":null)
+]
+}
+action2={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":2,"pressure":0.0,"pressed":true,"script":null)
+, Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":0,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":2,"canceled":false,"pressed":false,"double_click":false,"script":null)
+, Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":70,"key_label":0,"unicode":102,"location":0,"echo":false,"script":null)
+]
+}
+pause={
+"deadzone": 0.2,
+"events": [Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":6,"pressure":0.0,"pressed":true,"script":null)
+]
+}
+
 [rendering]
 
 renderer/rendering_method="gl_compatibility"

test/blender_test_map.tscn

@@ -1,6 +1,8 @@
-[gd_scene load_steps=14 format=3 uid="uid://6wjqqijnie4p"]
+[gd_scene load_steps=16 format=3 uid="uid://6wjqqijnie4p"]
 
 [ext_resource type="PackedScene" uid="uid://cp3qagrsuarl5" path="res://models/test/blender_test_map.blend" id="1_jy2qr"]
+[ext_resource type="PackedScene" uid="uid://gis0gxap8i8t" path="res://characters/test_stick.tscn" id="2_hmvb4"]
+[ext_resource type="Script" uid="uid://d26dyumvg37cp" path="res://characters/controllers/player_character_controller.gd" id="3_0cecx"]
 
 [sub_resource type="Gradient" id="Gradient_hmvb4"]
 offsets = PackedFloat32Array(0, 0.327869, 0.663934, 1)
@@ -61,6 +63,9 @@ data = PackedVector3Array(10.1543, 0, -43.3539, 50, 0, -50, 14.3313, 0, -39.177,
 
 [node name="Node3D" type="Node3D"]
 
+[node name="Camera3D" type="Camera3D" parent="."]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, -10.4229, 13.1742, -7.10402)
+
 [node name="WorldEnvironment" type="WorldEnvironment" parent="."]
 environment = SubResource("Environment_5t8ro")
 
@@ -77,4 +82,13 @@ surface_material_override/0 = SubResource("StandardMaterial3D_fdbvi")
 [node name="CollisionShape3D" type="CollisionShape3D" parent="StaticBody3D"]
 shape = SubResource("ConcavePolygonShape3D_jy2qr")
 
+[node name="TestStick" parent="." instance=ExtResource("2_hmvb4")]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, -9.54375, 17.2871, -13.5584)
+
+[node name="PlayerCharacterController" type="Node" parent="TestStick" node_paths=PackedStringArray("camera", "character")]
+script = ExtResource("3_0cecx")
+camera = NodePath("../../Camera3D")
+character = NodePath("..")
+metadata/_custom_type_script = "uid://d26dyumvg37cp"
+
 [editable path="StaticBody3D/blender_test_map"]

test/script_test_environment.gd

@@ -0,0 +1,17 @@
+@tool extends EditorScript
+## Test environment for resolving uncertainties about GDScript semantics.
+
+func _test1() -> void:
+	var foo: Dictionary[String, int] = {&'bar': 1, &'baz/qux:quux': 2}
+	var bar := func (baz: Dictionary) -> Dictionary[NodePath, float]:
+		@warning_ignore("confusable_local_declaration")
+		var qux: Dictionary[NodePath, float] = {}
+		for key in baz:
+			qux[key as NodePath] = baz[key]
+		return qux
+	var qux: Dictionary[NodePath, float] = bar.call(foo)
+	for key in qux:
+		print("%s: %s" % [key, qux[key]])
+
+func _run() -> void:
+	_test1()

test/script_test_environment.gd.uid

@@ -0,0 +1 @@
+uid://clwrfawdo8134

util/property_save_restore_stack.gd

@@ -0,0 +1,46 @@
+class_name PropertySaveRestoreStack extends Node
+## Allows saving and restoring sets of properties on a target Node.
+
+## Stores a batch of saved properties to be restored all at once on pop.
+class Frame:
+	## The saved properties to be restored when this frame is popped.
+	var saved_properties: Dictionary[NodePath, Variant]
+	## Saves properties to this frame and then overwrites them on the target.
+	func save_and_modify(target: Node, properties: Dictionary) -> void:
+		for key in properties:
+			var property_path := key as NodePath
+			saved_properties[property_path] = target.get_indexed(property_path)
+			target.set_indexed(property_path, properties[property_path])
+	## Restores saved properties. Called when the frame is popped.
+	func restore(target: Node) -> void:
+		for property_path in saved_properties:
+			target.set_indexed(property_path, saved_properties[property_path])
+
+## All property paths are understood as relative to this Node.
+## [br][br]
+## Altering this property at runtime will immediately empty the stack,
+## restoring all saved properties to the previous target in the process.
+@export var target: Node:
+	set(value):
+		if value != target:
+			while !is_empty():
+				pop()
+			target = value
+
+var _stack: Array[Frame]
+
+## Saves properties to a new stack frame and then overwrites them on the target.
+func push(properties: Dictionary) -> void:
+	var frame := Frame.new()
+	_stack.push_back(frame)
+	frame.save_and_modify(target, properties)
+
+## Pops the top stack frame and restores saved properties from it.
+func pop() -> void:
+	var frame: Frame = _stack.pop_back()
+	if frame:
+		frame.restore(target)
+
+## Whether the stack is empty.
+func is_empty() -> bool:
+	return _stack.is_empty()

util/property_save_restore_stack.gd.uid

@@ -0,0 +1 @@
+uid://dl5vblkrydr4q

util/state_machine.gd

@@ -0,0 +1,195 @@
+class_name StateMachine extends Node
+## Can be in one of a set of states. Dispatches signals on tick or transition.
+
+## Stores signals for subscribers interested in specific states.
+class State:
+	## Emitted when entering this state.
+	signal started
+	## Emitted when the StateMachine is ticked while in this state.
+	signal ticked(delta: float)
+	## Emitted when exiting this state.
+	signal stopped
+
+## Stores subscriber connection information for all signals of one state.
+class Handler:
+	## Subscribes to State.started.
+	var on_state_started: Callable = func () -> void: pass
+	## Subscribes to State.ticked.
+	var on_state_ticked: Callable = func (_delta: float) -> void: pass
+	## Subscribes to State.stopped.
+	var on_state_stopped: Callable = func () -> void: pass
+	## How to connect to State.started.
+	var state_started_flags: int
+	## How to connect to State.ticked.
+	var state_ticked_flags: int
+	## How to connect to State.stopped.
+	var state_stopped_flags: int
+	func linkup(
+		param: Variant,
+		param2: Variant = null,
+		param3: Variant = null
+	) -> void:
+		if param is Callable:
+			param3 = param2
+			param2 = param
+			param = &'ticked'
+		if param is StringName:
+			if param == &'started':
+				on_state_started = param2
+				if param3 is int:
+					state_started_flags = param3
+			elif param == &'ticked':
+				on_state_ticked = param2
+				if param3 is int:
+					state_ticked_flags = param3
+			elif param == &'stopped':
+				on_state_stopped = param2
+				if param3 is int:
+					state_stopped_flags = param3
+		elif param is Array:
+			callv(&'linkup', param)
+		elif param is Dictionary:
+			for sig in param:
+				var rest = param[sig]
+				if rest is Callable:
+					linkup(sig, rest)
+				elif rest is Array:
+					rest = rest.duplicate()
+					rest.push_front(sig)
+					callv(&'linkup', rest)
+				else:
+					push_error("StateMachine.Handler invalid param %s" % param)
+		elif param is Handler:
+			on_state_started = param.on_state_started
+			on_state_ticked = param.on_state_ticked
+			on_state_stopped = param.on_state_stopped
+			state_started_flags = param.state_started_flags
+			state_ticked_flags = param.state_ticked_flags
+			state_stopped_flags = param.state_stopped_flags
+		else:
+			push_error("StateMachine.Handler invalid param %s" % param)
+	func _init(
+		param: Variant,
+		param2: Variant = null,
+		param3: Variant = null
+	) -> void:
+		linkup(param, param2, param3)
+
+static func _make_handler_dict(
+	descriptors: Dictionary[StringName, Variant]
+) -> Dictionary[StringName, Handler]:
+	var result: Dictionary[StringName, Handler] = {}
+	for state_name in descriptors:
+		result[state_name] = Handler.new(descriptors[state_name])
+	return result
+
+## Emitted when starting any state (in addition to State.started).
+## [br][br]
+## The state argument is the name of the state that is starting.
+signal state_changed(state: StringName)
+
+var _states: Dictionary[StringName, State] = {}
+var _state: StringName = &''
+
+## Current state. Setting will emit all relevant signals.
+var state: StringName:
+	get():
+		return _state
+	set(state):
+		if _state != state:
+			if _state:
+				_ensure_state_exists(_state)
+				_states[_state].stopped.emit()
+			_state = state
+			state_changed.emit(_state)
+			if _state:
+				_ensure_state_exists(_state)
+				_states[_state].started.emit()
+
+func _ensure_state_exists(state_name: StringName) -> void:
+	if !(state_name in _states):
+		_states[state_name] = State.new()
+
+## Creates described handlers and subscribes them to corresponding states.
+## [br][br]
+## A handler descriptor is a key-value pair in the passed Dictionary.
+## The key part is a StringName referring to any state,
+## and the value part is either a Callable, an Array, or a further Dictionary.
+## The value specifies what Callable(s) to connect to the state's signals,
+## what signal(s) to connect them to, and what connection flags to use.
+## [br][br]
+## If the value part of the key-value pair is a Callable, it is connected
+## to the signal State.ticked, and no connection flags are used.
+## [br][br]
+## If the value part of the key-value pair is an Array, it must contain
+## optionally a StringName which defaults to &'ticked' if not provided,
+## mandatorily a Callable, and optionally an int which defaults to 0
+## if not provided, in that order; these, respectively, are the signal name
+## to connect to, the Callable to connect to it, and the connection flags
+## to use.
+## [br][br]
+## If the value part of the key-value pair is an additional Dictionary,
+## then for each key-value pair of that subordinate Dictionary,
+## the key part is a StringName referring to a signal member of State
+## (either &'started', &'ticked', or &'stopped') and specifies which signal
+## to connect the value part to, and the value part is either a Callable
+## or an array containing a Callable and an int indicating connection flags
+## to use.
+## [br][br]
+## Any Callable which is ultimately to be connected to Signal.started
+## or Signal.stopped should take no arguments and return nothing.
+## Any Callable which is ultimately to be connected to Signal.ticked
+## should take one float and return nothing. The float will be the time delta
+## of the physics step.
+## [br][br]
+## If you are interested in performing some uniform action
+## whenever any state starts, no matter which it is,
+## prefer to subscribe to StateMachine.state_changed.
+func connect_handlers(
+	handler_descriptors: Dictionary[StringName, Variant]
+) -> void:
+	var handlers := _make_handler_dict(handler_descriptors)
+	for state_name in handlers:
+		_ensure_state_exists(state_name)
+		var state_obj := _states[state_name]
+		var handler := handlers[state_name]
+		state_obj.started.connect(
+			handler.on_state_started,
+			handler.state_started_flags
+		)
+		state_obj.ticked.connect(
+			handler.on_state_ticked,
+			handler.state_ticked_flags
+		)
+		state_obj.stopped.connect(
+			handler.on_state_stopped,
+			handler.state_stopped_flags
+		)
+
+## Unsubscribes described handlers from corresponding states.
+## [br][br]
+## For information on the expected format of the handler_descriptors parameter,
+## see documentation for connect_handlers.
+## [br][br]
+## It is recommended you build the handler_descriptors parameter only once,
+## and use the same Dictionary instance to disconnect as you did to connect,
+## in order to ensure the contained Callable instances being disconnected
+## are the same instances that were initially connected --
+## thus ensuring they are actually disconnected, and not left dangling
+## due to failure to find them among the current connections.
+func disconnect_handlers(
+	handler_descriptors: Dictionary[StringName, Variant]
+) -> void:
+	var handlers := _make_handler_dict(handler_descriptors)
+	for state_name in handlers:
+		_ensure_state_exists(state_name)
+		var state_obj := _states[state_name]
+		var handler := handlers[state_name]
+		state_obj.started.disconnect(handler.on_state_started)
+		state_obj.ticked.disconnect(handler.on_state_ticked)
+		state_obj.stopped.disconnect(handler.on_state_stopped)
+
+func _physics_process(delta: float) -> void:
+	if _state:
+		_ensure_state_exists(_state)
+		_states[_state].ticked.emit(delta)

util/state_machine.gd.uid

@@ -0,0 +1 @@
+uid://bafxukojlafvh