　ゲームエンジンGodot4.0で3Dスマホゲームを作りたいと思いますが、その前にお勉強しています。
　2023/3/1にstable版がリリースされました。
Godot_v4.0-stable_win64.exe.zipを使用しています。

目的

　ゲームシステムをつくっていきます。
　ステージのクリア/失敗を判定して、GameSystemが知るところまで実装します。

ベースプロジェクト

下記で作成したプロジェクトをベースに機能追加をします。
　【Godot 4.0】スマホ３Dゲームを作るための勉強　その１６　ゲームシステムを作る　その１
　https://qiita.com/FootInGlow/items/887c1765058ffde646fa
　
　github(Godotのプロジェクトマネージャーからインポートして利用できます）
　https://github.com/footinglow/Godot4/tree/main/02_study/S16_GameSystem_001

ステージクリアを判定する

　ステージ内にある敵の砦をすべて破壊することをステージクリアの条件にします。

　一番簡単そうなのはGodotのグループ機能を使う方法だと思います。
　今回はStageに共通のGDScriptのAPIを持たせて、GameSystemのGDScriptでチェックするようにしましょう。

ステージクリア条件対象のEnemyシーンに「TargetEnemy」グループを設定する

　res://Characters/enemy.tscnを開きます。
　ルートノードのEnemyノードを選択して、インスペクタの横の「ノード/グループ」を選択します。
　Bullet(DesignMySoldier)との衝突判定に使用するEnemyGroupグループがすでに追加されています。

　「TargetEnemy」と入力して「追加」ボタンを押下します。

　Enemyシーンに「TargetEnemy」グループが追加されました。

Stage001のスクリプトでEnemyノードの数を判定する

　res://Stages/stage001.tscnを開きます。
　ルートノードのStageを右クリックして、「スクリプトをアタッチ」を実行します。

　res://Stages/stage_normal.gdとして、Stagesフォルダの下に保存します。

　Stagesフォルダに追加しました。

　現在アクティブなシーンの中から「TargetEnemy」グループを持つノードを検索するのは「get_tree().get_nodes_in_group("TargetEnemy")」を使用します。
　get_tree()がSceneTreeという現在アクティブなシーンツリーを取得します。
　GameSystemノード配下のすべてのシーンが対象になります。
　（本スクリプトがアタッチされているStageノードは、/GameSystem/CurrectStage/Stageの位置にあります）

GODOT DOC Scripting Groupsを参考にしました。
https://docs.godotengine.org/en/latest/tutorials/scripting/groups.html

　確認のためにprintしてみます。

extends Node3D

func _physics_process(delta):
	print(get_tree().get_nodes_in_group("TargetEnemy"))

　get_nodes_in_groupはArray[Node]で現在アクティブなノードのうち”TargetEnemy”グループを持つNodeリストを返します。

　実行すると最初はEnemyとEnemy2の２つのEnemyを検出しています。

[Enemy:<CharacterBody3D#29494346964>, Enemy2:<CharacterBody3D#29729228002>]

　Enemy2を倒すと、１個だけになります。

[Enemy:<CharacterBody3D#29494346964>]

　２つもと倒すと空のArrayが返ってきます。

[]

　Nodeリスト（Array[Node]）のサイズが０個になれば、ステージクリアと判断できそうです。

　ステージクリアの判定はStage内（のスクリプト）で実装します。
　res://Stages/stage_normal.gdを開いて下記のように修正します。

extends Node3D

func is_stage_clear():
	return get_tree().get_nodes_in_group("TargetEnemy").size() == 0

get_tree().get_nodes_in_group("TargetEnemy").size()
　size()関数はNodeリスト（Array[Node]）内の要素数を取得するので、Enemyがすべて残っている場合は２，すべて倒した場合は０になります。
get_tree().get_nodes_in_group("TargetEnemy").size() == 0
　すべて倒した場合は0==0でtrueをreturnします。
　敵砦が２つ残っている場合は、２なので、2==0はfalseとなります。

GameSystemで現在のステージのステージクリアを判定する

　今ステージに追加したis_stage_clear()メソッドをGameSystemから参照しましょう。
　res://game_system.tscnを開きます。
　ルートノードのGameSystemを右クリックして「スクリプトをアタッチ」します。

　追加されました。

　以下のようにしましょう。

extends Node3D

func _physics_process(delta):
	if $CurrentStage/Stage.is_stage_clear():
		print("Stage Clear")

「 $CurrentStage/Stage」はシーン内の「Stage」をスクリプト内にドラッグアンドドロップすると挿入されます。

　実行しましょう。
　敵の砦（Enemy、Enemy2）を2つとも倒すと「Stage Clear」がprint出力されました。

ステージクリア失敗を判定する

　EnemyBullet(DesignEnemySoldier)がPlayerの陣地までたどり着いた場合、Playerの負けとします。
　Area3DをPlayerの陣地に設定して、EnemyBullet(DesignEnemySoldier)の侵入を判定しましょう。

EnemyBullet(EnemySoldier)の侵入検知用にArea3Dを追加する

　res://Stages/stage001.tscnを開きます。
　ルートノードのStageを右クリックして、子ノードを追加から「Area3D」を追加します。名称を「EnemyBulletSensor」に変更します。
　EnemyBulletSensorを右クリックして、子ノードを追加から「CollisionShape3D」を追加します。

　「CollisionShape3D」を選択した状態で、インスペクタのCollisionShape3D/Shapeに新規BoxShapeを設定します。
　今設定した「BoxShape3D」をクリックし詳細設定を開いて、Sizeのxに5m、yは2mに設定します。

EnemyBullet(DesignEnemySoldier)の侵入を検知したsignalを受信する

　先ほど追加したArea3DにEnemyBullet(DesignEnemySoldier)が侵入した場合、signalを受信するようにします。

　Area3Dが検知する対象を設定します。
　EnemyBulletSensorを選択した状態で、インスペクタのCollisionObject3D/Collisionを設定します。

　Layerは検知されたい場合に設定するため、不要です。チェックをすべて外します。
　Maskは検知対象を設定します。Enemyを設定します。

　つぎに、インスペクタの横のノード/シグナルを選択します。
　検知したい対象はCharacterBody3Dという「body」なので、「body_entered(body:Node3D)」を右クリックして「接続」を実行します。

　ステージのクリア/失敗はStageのスクリプトで判定するので、「Stage」を選択します。

「func _on_enemy_bullet_sensor_body_entered(body):」メソッドが追加されました。

　signalを受信したことを覚えておくためにメンバ変数を追加します。
　またGameSystemのスクリプトからアクセスできるように、APIも追加します。

extends Node3D

var m_f_is_entered_enemy_bullet = false

func is_stage_clear():
	return get_tree().get_nodes_in_group("TargetEnemy").size() == 0

func is_stage_failed():
	return m_f_is_entered_enemy_bullet
	
func _on_enemy_bullet_sensor_body_entered(body):
	m_f_is_entered_enemy_bullet = true

var m_f_is_entered_enemy_bullet = false
　EnemyBulletの侵入を検知したことを記憶するためのフラグを追加しました。
　一度侵入を検知するとtrueにするフラグです。
func is_stage_failed():
　GameSystemがステージクリア失敗を知るためのAPIを追加します。
　「return m_f_is_entered_enemy_bullet」でtrue/falseのフラグを返却するだけです。
func _on_enemy_bullet_sensor_body_entered(body):
　EnemyBulletの侵入を検知した場合、m_f_is_entered_enemy_bulletにtrueを設定します。

GameSystemがステージクリア失敗を知る

　GameSystemは_physics_process()関数の中で周期的にステージクリア/失敗をチェックするようにします。
　とりあえずprintで表示するようにします。

　res://game_system.gdを開きます。

extends Node3D

func _physics_process(delta):
	if $CurrentStage/Stage.is_stage_clear():
		print("Stage Clear")

	if $CurrentStage/Stage.is_stage_failed():
		print("Stage Failed")

if $CurrentStage/Stage.is_stage_failed():
　stageのスクリプトに先ほど追加したis_stage_failed()がtrueの場合、printします。

　実行します。EnemyBullet(EnemySoldier)がPlayerの陣地に侵入すると「Stage Failed」のprint文が大量に表示されます。

以上です