player: Add teleport/blink action

If the player enters this action while also holding left or right, the
player-character teleports by a constant distance horizontally.

On keyboard, this is bound to "Enter" for player 1 (who moves with the
arrow keys), and "Shift" for player 2 (who moves with WASD).

On gamepad, this is bound to Xbox button B.

The function call for this ability is in the correct place in
_physics_process() but is commented out. A learner must find this
commented-out line and uncomment it to enable this ability.

The sound effect is https://freesound.org/people/D.S.G./sounds/244654/
(CC0-1.0).

Author: wjt

assets/sounds/244654__dsg__pop-2.ogg

@@ -0,0 +1,19 @@
+[remap]
+
+importer="oggvorbisstr"
+type="AudioStreamOggVorbis"
+uid="uid://dmx2rtf2vy1"
+path="res://.godot/imported/244654__dsg__pop-2.ogg-27b8aa37b813c338a8b122e748e26d18.oggvorbisstr"
+
+[deps]
+
+source_file="res://assets/sounds/244654__dsg__pop-2.ogg"
+dest_files=["res://.godot/imported/244654__dsg__pop-2.ogg-27b8aa37b813c338a8b122e748e26d18.oggvorbisstr"]
+
+[params]
+
+loop=false
+loop_offset=0
+bpm=0
+beat_count=0
+bar_beats=4

assets/sounds/244654__dsg__pop-2.ogg.import

@@ -2,6 +2,7 @@
 
 [ext_resource type="Script" uid="uid://umb21eb2y1oj" path="res://scripts/player.gd" id="1_w3ms2"]
 [ext_resource type="SpriteFrames" uid="uid://bo581k1esb50n" path="res://components/player/spriteframes-red.tres" id="2_msaml"]
+[ext_resource type="AudioStream" uid="uid://dmx2rtf2vy1" path="res://assets/sounds/244654__dsg__pop-2.ogg" id="3_ph1f6"]
 [ext_resource type="AudioStream" uid="uid://bx1joarpc14j5" path="res://assets/sounds/538066__stevielematt__boing.ogg" id="3_wa6cj"]
 [ext_resource type="AudioStream" uid="uid://p0b3e0t7h8j3" path="res://assets/sounds/596541__tothrec2__large-wings-flapping-foley.ogg" id="4_mpawu"]
 
@@ -14,6 +15,11 @@ random_pitch = 1.1
 streams_count = 1
 stream_0/stream = ExtResource("3_wa6cj")
 
+[sub_resource type="AudioStreamRandomizer" id="AudioStreamRandomizer_ph1f6"]
+random_pitch = 1.2
+streams_count = 1
+stream_0/stream = ExtResource("3_ph1f6")
+
 [node name="Player" type="CharacterBody2D" groups=["players"]]
 collision_layer = 3
 collision_mask = 5
@@ -56,3 +62,8 @@ stream = SubResource("AudioStreamRandomizer_mpawu")
 [node name="GlideSFX" type="AudioStreamPlayer" parent="SoundEffects"]
 unique_name_in_owner = true
 stream = ExtResource("4_mpawu")
+
+[node name="TeleportSFX" type="AudioStreamPlayer" parent="SoundEffects"]
+unique_name_in_owner = true
+stream = SubResource("AudioStreamRandomizer_ph1f6")
+volume_db = -10.0

components/player/player.tscn

@@ -59,6 +59,12 @@ player_2_right={
 , Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":1,"axis":0,"axis_value":1.0,"script":null)
 ]
 }
+player_2_teleport={
+"deadzone": 0.5,
+"events": [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":1,"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)
+]
+}
 player_1_jump={
 "deadzone": 0.5,
 "events": [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":4194320,"physical_keycode":0,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
@@ -80,6 +86,12 @@ player_1_right={
 , Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":0,"axis":0,"axis_value":1.0,"script":null)
 ]
 }
+player_1_teleport={
+"deadzone": 0.5,
+"events": [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":4194309,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
+, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":0,"button_index":1,"pressure":0.0,"pressed":true,"script":null)
+]
+}
 
 [layer_names]
 

project.godot

@@ -12,6 +12,7 @@ const ACTIONS = [
 	&"jump",
 	&"left",
 	&"right",
+	&"teleport",
 ]
 
 # Dictionary[Global.Player, Dictionary[StringName, StringName]]

scripts/actions.gd

@@ -9,6 +9,12 @@ extends CharacterBody2D
 ## Used by [method _glide].
 const GLIDE_TERMINAL_VELOCITY = 100
 
+## How many pixels the player-character should teleport horizontally when the
+## teleport special ability is used.
+## [br][br]
+## Used by [method _teleport].
+const TELEPORT_DISTANCE = 512
+
 ## Which player controls this character?
 @export var player: Global.Player = Global.Player.ONE
 
@@ -64,6 +70,7 @@ var original_position: Vector2
 
 @onready var _jump_sfx: AudioStreamPlayer = %JumpSFX
 @onready var _glide_sfx: AudioStreamPlayer = %GlideSFX
+@onready var _teleport_sfx: AudioStreamPlayer = %TeleportSFX
 
 
 func _set_sprite_frames(new_sprite_frames):
@@ -128,6 +135,19 @@ func _glide() -> void:
 		_glide_sfx.stop()
 
 
+## If the "teleport" action is pressed, and the player is moving the character horizontally,
+## teleport the character in that horizontal direction.
+func _teleport(input_direction: float) -> void:
+	if (
+		Input.is_action_just_pressed(Actions.lookup(player, "teleport"))
+		and not is_zero_approx(input_direction)
+	):
+		# TODO: Check if we are teleporting into a wall (in which case the player should lose a
+		# life) or an enemy (in which case maybe the enemy should be telefragged/defeated?)
+		global_position.x += TELEPORT_DISTANCE * input_direction
+		_teleport_sfx.play()
+
+
 func _physics_process(delta):
 	# Don't move if there are no lives left.
 	if Global.lives <= 0:
@@ -180,6 +200,8 @@ func _physics_process(delta):
 
 	move_and_slide()
 
+	# _teleport(direction)
+
 	coyote_timer -= delta
 	jump_buffer_timer -= delta