はじめに

普段はCosense(Scrapbox)で技術記事を書いていますが、今回、Godotのアドベントカレンダーを見つけたのをきっかけに、Qiitaに記事を投稿してみることにしました。

概要

この記事では、以下のGIF画像のように、プレイヤーが特定の領域に侵入すると動き出す「トリガー針」の作り方を紹介します。

以下のGIFは完成イメージです。

環境

Microsoft Windows 11 Home
Godot Engine 4.3

トリガー針の作り方

作成するシーンの基本構成

今回作成する「トリガー針」は、以下の2つのシーンを中心に構築します。

針（thorn）
- 針そのものを表すシーン
- トリガーがオンになると動作する
針トリガーエリア（thorn_trigger_area）
- プレイヤーが領域に侵入すると、子ノードである「針」のトリガーをオンにする
- 領域は呼び出し側で定義する

針のシーンを作成

まず、針のシーンとなるthorn.tscnを作成し、以下のようにノードを作成します。

Thorn（Sprite2D型）
- Area2D
  - CollisionPolygon2D

次に、Thornノードにスクリプトをアタッチし、thorn.gdとして保存します。

Area2Dノードのシグナルからbody_enteredを選択し、thorn.gdスクリプトに接続します。

接続後に、thorn.gdスクリプトを以下のように編集します。

thorn.gd

extends Sprite2D


@export var is_move : bool = false # trueの場合、針が動く
@export var speed : float =  1.0 # 秒間１マス


# Called when the node enters the scene tree for the first time.
func _ready() -> void:
	add_to_group("thorn") # thornグループに設定


# Called every frame. 'delta' is the elapsed time since the previous frame.
func _process(delta: float) -> void:
	if is_move:
		# ~~~ 針の移動処理 ~~~


func _on_area_2d_body_entered(body: Node2D) -> void:
	if body.name == "PlayerCharacter":
		body.damaged() # プレイヤーが針に被弾した際の処理

実装のポイント

is_move
- 針トリガーエリアでオンにするためのフラグ
speed
- 各針の移動速度を個別に設定できるよう、エクスポートする
add_to_group("thorn")
- _ready関数で針をthornグループに登録する
- 後述する針トリガーエリアが複数の針を認識しやすくするための設定です

針トリガーエリアのシーンを作成

針トリガーエリアのシーンとなるthorn_trigger_area.tscnを作成し、以下のようにノードを作成します。

ThornTriggerArea（Area2D型）

ノードにシェイプが設定されていないため警告が表示されますが、これは呼び出し元で設定するため、無視して問題ありません。

次に、ThornTriggerAreaノードにスクリプトをアタッチし、thorn_trigger_area.gdとして保存します。

ThornTriggerAreaノードのシグナルからbody_enteredを選択し、thorn_trigger_area.gdスクリプトに接続します。

接続後に、thorn_trigger_area.gdスクリプトを以下のように編集します。

thorn_trigger_area.gd

extends Area2D


# ~~~ _readyと_processはpassのみのため、記述を省略 ~~~


func _on_body_entered(body: Node2D) -> void:
	if body.name == "PlayerCharacter":
		for children in get_children():
			if children.is_in_group("thorn"):
				children.is_move = true

実装のポイント

for children in get_children():
- トリガーエリア内のすべての子ノードを順に処理する
if children.is_in_group("thorn"):
- 子ノードがthornグループに属している場合にのみ、針を動作させる処理を実行する

トリガー針をステージに配置

これまでに作成したトリガー針を、ステージに配置して動作させてみましょう。
ステージとなるシーンにThornTriggerAreaシーンを追加し、以下のようにノードを作成します。

ThornTriggerArea
- CollisionShape2D
- Thorn1
- Thorn2
- Thorn3
- …（必要に応じて追加）

CollisionShape2Dノードは、針トリガーエリアのシェイプとして機能します。
このシェイプがプレイヤーの侵入を検知する領域を定義します。

配置イメージ

以下は、トリガー針を配置した例です。

動作の確認

CollisionShape2Dノードで設定した領域にプレイヤーが侵入すると、針が動き出します。
以下のGIFは完成イメージです。

あとがき

私が調べた限りでは、Godotでトリガー針を作る方法を解説した記事は見当たりませんでした。
なので、この記事が少しでも皆さんの参考になれば嬉しいです！

記事のタイトルは「アイワナ風トリガー針」としましたが、個人的には『ノロイノゲエム』の飛んでくるギロチンのイメージが強いです。

技術的な疑問や改善点や、記事の記述の改善点があれば、ぜひコメントで教えてください！
ここまでお読みいただき、ありがとうございます。