【Godot4.x】アクションゲームの基本ギミックの実装方法

## タイルからオブジェクトを作る.
func _create_obj_from_tile() -> void:

	for j in range(Map.height):
		for i in range(Map.width):
			var pos = Map.grid_to_world(Vector2(i, j))
			var type = Map.get_floor_type(pos)
			if type == Map.eType.NONE:
				continue # 床タイプが未設定なタイルは何もしない
			
			# 以下タイルマップの機能では対応できないタイルの処理.
			match type:
				Map.eType.LADDER:
					# Ladder(ハシゴ)オブジェクトを生成.
					var obj = LADDER_OBJ.instantiate()
					obj.position = pos
					_bg_layer.add_child(obj)
					Map.erase_cell_from_world(pos)
					
					# 上を調べてコリジョンがなければ一方通行床を置く.
					_check_put_oneway(i, j)

extends Area2D
# =========================================
# はしご
# =========================================
class_name Ladder

# -----------------------------------------
# signals.
# -----------------------------------------
## PhysicsBody2Dが接触.
func _on_body_entered(body: Node2D) -> void:
	if not body is Player:
		return # プレイヤー以外何もしない
	
	var player = body as Player
	# はしご接触数をカウントアップ.
	player.increase_ladder_count()

## PhysicsBody2Dが離れた.
func _on_body_exited(body: Node2D) -> void:
	if not body is Player:
		return # プレイヤー以外何もしない
	
	var player = body as Player
	# はしご接触数を減らす.
	player.decrease_ladder_count()

## はしご接触数.
var _ladder_count = 0

## はしご接触数のカウント
func increase_ladder_count() -> void:
	_ladder_count += 1
func decrease_ladder_count() -> void:
	_ladder_count -= 1
	
# はしごを掴めるかどうか.
func _can_grab_ladder() -> bool:
	return _ladder_count > 0

## 移動状態.
enum eMoveState {
	LANDING, # 地上.
	AIR, # 空中.
	GRABBING_LADDER, # はしごに掴まっている
	CLIMBING_WALL, # 壁登り中.
}

## 移動状態.
var _move_state = eMoveState.AIR

# 移動状態の更新.
func _update_move_state() -> void:

	...

	if _is_grabbing_ladder() == false:
		# はしごチェック.
		if _can_grab_ladder():
			if Input.get_axis("ui_up", "ui_down") != 0:
				# はしご開始.
				_move_state = eMoveState.GRABBING_LADDER
				# 着地 (着地アニメなし)
				_just_landing(false)

## 移動処理.
func _update_moving(delta:float) -> void:
	...

	if _is_grabbing_ladder():
		# 上下ではしご移動.
		var v = Input.get_axis("ui_up", "ui_down")
		velocity.y = 0
		if v != 0:
			velocity.x = 0 # X方向を止める.
			velocity.y = _config.ladder_move_speed * v
		
		if _check_jump():
			# ジャンプ開始.
			var is_wall_jump = _is_climbing_wall()
			_start_jump(is_wall_jump)
			_move_state = eMoveState.AIR

## 上を調べてコリジョンがなければ一方通行床を置く.
## @note ハシゴの後ろに隠れている一方通行床がチラチラ見える不具合がある.
func _check_put_oneway(i:int, j:int) -> void:
	var pos = Map.grid_to_world(Vector2i(i, j))
	var pos2 = Map.grid_to_world(Vector2(i, j-1))
	var col_cnt = Map.get_tile_collision_polygons_count(Vector2(i, j-1), Map.eTileLayer.GROUND)
	if col_cnt > 0:
		return # コリジョンがあるので何もしない.
	
	var type = Map.get_floor_type(pos2)
	if type == Map.eType.LADDER:
		return # 上がハシゴなので何もしない.
	
	# 重ねるのはハシゴの上 (一方通行床で置き換える).
	Map.replace_cell_from_world(pos, Vector2i(4, 0))

func _update_collision_post() -> void:
	# 衝突したコリジョンに対応するフラグを設定する.
	var dist = 99999 # 一番近いオブジェクトだけ処理する.
	_touch_tile = Map.eType.NONE # 処理するタイル.
	for i in range(get_slide_collision_count()):
		var col:KinematicCollision2D = get_slide_collision(i)
		# 衝突位置.
		var pos = col.get_position()
		var v = Map.get_floor_type(pos)
		if v == Map.eType.NONE:
			continue # 何もしない.
		if v == Map.eType.SPIKE:
			_is_damage = true # ダメージ処理は最優先.
			continue # 移動処理に直接の影響はない.
		
		var d = abs(pos.x - position.x)
		if d < dist:
			# より近い.
			dist = d
			_touch_tile = v

## 登り・降りるができるかどうか.
func _can_climb(up_down:float) -> bool:
	# マージン用に方向を決める.
	var dir = 0.0
	if up_down > 0:
		dir = 1.0
	elif up_down < 0:
		dir = -1.0
	
	if _is_climbing_wall():
		# 登り壁.
		var n = get_wall_normal() * -1 # 法線の逆.
		# 前方1マスを調べる.
		var center = center_position
		var pos = Vector2()
		pos.x = center.x + (n.x * Map.get_tile_size())
		pos.y = center.y + up_down + (dir * CLIMB_WALL_MARGIN)
		var grid_pos = Map.world_to_grid(pos)
		if Map.get_tile_collision_polygons_count(grid_pos, Map.eTileLayer.GROUND) > 0:
			# 壁がある.
			var type = Map.get_floor_type(pos)
			if type == Map.eType.CLIMBBING_WALL:
				# 登り壁なら上下移動可能.
				return true
			else:
				# それ以外は移動不可.
				return false
	return true

## 左右移動の更新.
func _update_horizontal_moving(can_move:bool=true, force_direction:int=0, force_direction_multipuly:float=0.0) -> void:

	...

	if _is_dash():
		# ダッシュ中.
		var DASH_ACC_RATIO = _config.ground_acc_ratio * DASH_SPEED_RATIO
		velocity = _dash_direction * MOVE_SPEED * DASH_ACC_RATIO
		return
	
	...

## 重力の影響を受ける移動状態かどうか.
func _is_add_gravity() -> bool:
	if _is_dash():
		return false # ダッシュ中は重力の影響を受けない.
	
	...

## 着地した瞬間.
func _just_landing(is_scale_anim:bool) -> void:
	if is_scale_anim:
		# 着地演出.
		_jump_scale = eJumpScale.LANDING
		_jump_scale_timer = JUMP_SCALE_TIME
	_jump_cnt = 0 # ジャンプ回数をリセット.
	_dash_cnt = 0 # ダッシュ回数をリセット.

## Body2Dと衝突.
func _on_body_entered(body: Node2D) -> void:
	if not body is Block:
		return # 念のため.
	
	var block = body as Block
	var deg = 360 - rotation_degrees + 180
	block.vanish(deg)
	block.queue_free()
	
	# ヒットストップ開始.
	Common.start_hit_stop()
	
	# 少し画面を揺らす.
	Common.start_camera_shake(0.1, 0.5)