Refine springboard model, springboard code, and launch state code.

characters/base/character.gd

@@ -891,11 +891,16 @@ func change_state(state_name: StringName) -> bool:
 ## Directly invokes state transition without the sanity checks of change_state.
 ## [br][br]
 ## Suggested use is to ensure availability of actions
-## that can safely be exempted from other states' coyote time restrictions
+## that can safely be exempted from other states' restrictions
 ## and need to be highly responsive, such as jumping.
 func force_change_state(state_name: StringName) -> void:
 	_state_machine.state = state_name
 
+## Immediately expires coyote time and then tries to change state.
+func soft_force_change_state(state_name: StringName) -> bool:
+	_state_coyote_time = 0.0
+	return change_state(state_name)
+
 ## Teleports the character during the next physics tick.
 func teleport(where: Vector3) -> void:
 	_teleport_requested = true
@@ -1078,7 +1083,7 @@ func _on_idle_state_tick(delta: float) -> void:
 	if !is_really_grounded():
 		state = &'fall'
 	elif jump_impetus:
-		force_change_state(&'jump')
+		soft_force_change_state(&'jump')
 	elif !impetus.is_zero_approx():
 		state = &'walk'
 
@@ -1090,7 +1095,7 @@ func _on_walk_state_tick(delta: float) -> void:
 	if !is_really_grounded():
 		state = &'fall'
 	elif jump_impetus:
-		force_change_state(&'jump')
+		soft_force_change_state(&'jump')
 	elif top_speed_proximity >= 0.125:
 		state = &'run'
 	elif impetus.is_zero_approx() && top_speed_proximity < 0.03125:
@@ -1104,7 +1109,7 @@ func _on_run_state_tick(delta: float) -> void:
 	if !is_really_grounded() && !air_coyote_time_active():
 		state = &'fall'
 	elif jump_impetus:
-		force_change_state(&'jump')
+		soft_force_change_state(&'jump')
 	elif top_speed_proximity >= 0.375:
 		state = &'sprint'
 	elif top_speed_proximity < 0.125:
@@ -1118,7 +1123,7 @@ func _on_sprint_state_tick(delta: float) -> void:
 	if !is_really_grounded() && !air_coyote_time_active():
 		state = &'fall'
 	elif jump_impetus:
-		force_change_state(&'jump')
+		soft_force_change_state(&'jump')
 	elif top_speed_proximity < 0.375:
 		state = &'run'
 	elif _get_effective_impetus().dot(linear_velocity) <= -0.75:
@@ -1188,7 +1193,7 @@ func _on_skid_state_tick(delta: float) -> void:
 func _on_wall_slide_state_tick(delta: float) -> void:
 	_do_standard_motion(delta)
 	if jump_impetus && _state_coyote_time <= 0.0:
-		force_change_state(&'jump')
+		soft_force_change_state(&'jump')
 		# in addition, not instead:
 		apply_central_impulse(mass*_get_jump_initial_velocity()*wall_normal)
 	elif is_really_grounded():
@@ -1254,7 +1259,7 @@ func _on_idle_while_holding_state_tick(delta: float) -> void:
 	if !is_really_grounded():
 		state = &'fall-while-holding'
 	elif jump_impetus:
-		force_change_state(&'jump-while-holding')
+		soft_force_change_state(&'jump-while-holding')
 	elif !impetus.is_zero_approx():
 		state = &'walk-while-holding'
 	elif action1_impetus || action2_impetus || interact_impetus:
@@ -1268,7 +1273,7 @@ func _on_walk_while_holding_state_tick(delta: float) -> void:
 	if !is_really_grounded():
 		state = &'fall-while-holding'
 	elif jump_impetus:
-		force_change_state(&'jump-while-holding')
+		soft_force_change_state(&'jump-while-holding')
 	elif top_speed_proximity >= 0.125:
 		state = &'run-while-holding'
 	elif impetus.is_zero_approx() && top_speed_proximity < 0.03125:
@@ -1284,7 +1289,7 @@ func _on_run_while_holding_state_tick(delta: float) -> void:
 	if !is_really_grounded() && !air_coyote_time_active():
 		state = &'fall-while-holding'
 	elif jump_impetus:
-		force_change_state(&'jump-while-holding')
+		soft_force_change_state(&'jump-while-holding')
 	elif top_speed_proximity < 0.125:
 		state = &'walk-while-holding'
 	elif action1_impetus || action2_impetus || interact_impetus:
@@ -1312,6 +1317,13 @@ func _on_launch_state_tick(delta: float) -> void:
 		state = &'run'
 	elif linear_velocity.dot(ground_normal) <= -0.25:
 		state = &'fall'
+	elif is_touching_wall():
+		var ledge_distance := _get_ledge()
+		if ledge_distance.is_zero_approx():
+			state = &'wall-slide'
+		else:
+			state = &'hang'
+			set_freeze_lerp(global_position + ledge_distance)
 
 func _on_launch_while_holding_state_tick(delta: float) -> void:
 	_do_standard_motion(delta)

props/springboard.gd

@@ -0,0 +1,25 @@
+class_name Springboard extends Area3D
+
+@export var launch_speed: float = 10.0
+@export var audio_player: AudioStreamPlayer3D
+
+func _ready() -> void:
+	body_entered.connect(_on_body_entered)
+
+func _on_body_entered(body: PhysicsBody3D) -> void:
+	var rbody := body as RigidBody3D
+	var ch := body as Character
+	if rbody:
+		scale.y = 2.0
+		rbody.apply_central_impulse(rbody.mass*(
+			launch_speed*global_basis.y -
+			rbody.linear_velocity.project(global_basis.y)
+		))
+		if ch:
+			ch.ground_normal = global_basis.y
+			ch.soft_force_change_state(&'launch')
+		else:
+			audio_player.play()
+
+func _physics_process(delta: float) -> void:
+	scale.y = lerp(scale.y, 1.0, 1.0 - 0.75**delta)

props/springboard.gd.uid

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

props/springboard.tscn

@@ -0,0 +1,22 @@
+[gd_scene load_steps=5 format=3 uid="uid://b7mqd4ps8e3uj"]
+
+[ext_resource type="Script" uid="uid://dnjxujqbouc5j" path="res://props/springboard.gd" id="1_67v3t"]
+[ext_resource type="PackedScene" uid="uid://cgy5hielkuss7" path="res://models/props/springboard.blend" id="2_jhsy2"]
+[ext_resource type="AudioStream" uid="uid://dujgina4at6ef" path="res://audio/springboard.ogg" id="3_jhsy2"]
+
+[sub_resource type="BoxShape3D" id="BoxShape3D_i42dn"]
+size = Vector3(0.5, 0.4, 0.5)
+
+[node name="Springboard" type="Area3D" node_paths=PackedStringArray("audio_player")]
+script = ExtResource("1_67v3t")
+audio_player = NodePath("AudioStreamPlayer3D")
+
+[node name="springboard" parent="." instance=ExtResource("2_jhsy2")]
+
+[node name="CollisionShape3D" type="CollisionShape3D" parent="."]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.2, 0)
+shape = SubResource("BoxShape3D_i42dn")
+
+[node name="AudioStreamPlayer3D" type="AudioStreamPlayer3D" parent="."]
+stream = ExtResource("3_jhsy2")
+bus = &"Sound Effects"

test/blender_test_map.tscn

@@ -1,10 +1,11 @@
-[gd_scene load_steps=14 format=3 uid="uid://6wjqqijnie4p"]
+[gd_scene load_steps=15 format=3 uid="uid://6wjqqijnie4p"]
 
 [ext_resource type="Script" uid="uid://cmoaplk7fly6y" path="res://vfx/gameplay_camera.gd" id="1_qjty2"]
 [ext_resource type="Texture2D" uid="uid://dnhbrrbtx13vi" path="res://vfx/textures/skybox2.png" id="2_sj3fr"]
 [ext_resource type="PackedScene" uid="uid://cp3qagrsuarl5" path="res://test/blender_test_map.blend" id="2_vhybo"]
 [ext_resource type="PackedScene" uid="uid://gis0gxap8i8t" path="res://test/test_stick.tscn" id="3_sj3fr"]
-[ext_resource type="Material" uid="uid://cubxaj8myoa7" path="res://maps/textures/wood2.tres" id="4_sj3fr"]
+[ext_resource type="Material" uid="uid://m4x75hyx6hih" path="res://maps/textures/brick1.tres" id="3_vhybo"]
+[ext_resource type="PackedScene" uid="uid://b7mqd4ps8e3uj" path="res://props/springboard.tscn" id="8_p5rwy"]
 [ext_resource type="Script" uid="uid://16os114krms3" path="res://characters/controllers/player_character_controller.gd" id="9_j70wf"]
 [ext_resource type="Script" uid="uid://dotkfe7cs5010" path="res://test/pick_up_item.gd" id="10_ld4ib"]
 
@@ -47,7 +48,7 @@ transform = Transform3D(1, 0, 0, 0, 0.5, 0.866025, 0, -0.866025, 0.5, 0, 100, 0)
 [node name="blender_test_map" parent="StaticBody3D" instance=ExtResource("2_vhybo")]
 
 [node name="Plane" parent="StaticBody3D/blender_test_map" index="0"]
-surface_material_override/0 = ExtResource("4_sj3fr")
+surface_material_override/0 = ExtResource("3_vhybo")
 
 [node name="CollisionShape3D" type="CollisionShape3D" parent="StaticBody3D"]
 shape = SubResource("ConcavePolygonShape3D_jy2qr")
@@ -74,4 +75,13 @@ character = NodePath("..")
 camera = NodePath("../../Camera3D")
 metadata/_custom_type_script = "uid://16os114krms3"
 
+[node name="Springboard" parent="." instance=ExtResource("8_p5rwy")]
+transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 32.9914, 0.0113316, 20.8191)
+
+[node name="Springboard2" parent="." instance=ExtResource("8_p5rwy")]
+transform = Transform3D(0.641798, 0.25518, -0.723173, 1.86265e-09, 0.943014, 0.332754, 0.766874, -0.213561, 0.605224, -37.1376, 16.3488, 1.40747)
+
+[node name="Springboard3" parent="." instance=ExtResource("8_p5rwy")]
+transform = Transform3D(0.555329, -0.584704, 0.59138, 0.725086, 0.688658, 0, -0.407259, 0.428801, 0.806393, -29.0464, 2.47059, -35.0708)
+
 [editable path="StaticBody3D/blender_test_map"]