前章では、プレイヤーが弾を発射して敵を倒せるようにすることで、ゲームプレイの基礎を完成させました。
今章では、さらに進めて、実際にゲームとして遊べるプロジェクトに仕上げていきます。
現在のバージョンでは、プレイヤーは移動でき、敵も存在しますが、いくつかの要素がまだ不足しています。
まず、より多くのタイルを描画してステージを拡張しましょう。ステージが大きくなるため、プレイヤーが最終的にカメラの現在の範囲外に出てしまう可能性があります。そのため、カメラがプレイヤーを追跡するようにもする必要があります。
タイルはBase (TileMapLayer) ノードを使用して作成されたため、このノードを使用してステージを拡張します。
stage1 シーンタブに切り替えます。
シーンウィンドウでBase (TileMapLayer) ノードを選択します。
下部のウィンドウでTileMap タブを開き、タイルを選択します。
右側のスペースに自由にタイルを配置します。ステージのバランスを保つために：
空中のプラットフォームや壁は4タイルより高くならないようにします。
隙間や穴は、簡単に飛び越えられるように4タイル幅以下にします。
十分なタイルを配置したら、次のステップに進みます。
ACTION GAME MAKERにおけるカメラの追従は、Target IDと呼ばれるシステムによって制御されます。プレイヤーを作成し、CameraTargetSettingsノードを追加した際を覚えていますか？そのノードにはTarget IDというプロパティがあります。
カメラノードのZoomCamera2DにもTarget IDプロパティがあります。カメラとゲームオブジェクトの両方が同じTarget IDを共有している場合、カメラは自動的にそのオブジェクトを追従するように設計されています。
ZoomCamera2DとプレイヤーのCameraTargetSettingsの両方のTarget IDを設定しましょう。
Stage1シーンタブで、**InitialCamera (ZoomCamera2D)**ノードを選択します。
Inspectorで**Target ID (Array…)**プロパティを展開します。
+ Add Elementボタンをクリックします。
テキストフィールドが表示されます。プレースホルダーテキストの<null>を削除し、playerと入力します。
playerシーンタブに切り替えます。
CameraTargetSettingsノードを選択します。
InspectorでTarget IDフィールドにplayerと入力します。
これで拡張されたステージのプレイテストを行い、すべてが正しく機能しているか確認しましょう。プレイヤーをステージの右端まで動かしてみてください。
すべてが適切に設定されていれば、カメラはスムーズにプレイヤーを追従するはずです。
カメラが追従しない: Stage1のInitialCameraとプレイヤーのCameraTargetSettingsの両方でTarget ID設定を再確認してください。
ステージの最右端に到達できない: **Base (TileMapLayer)**の穴のサイズや壁の高さを調整してください。
敵と同様に、プレイヤーの HP が 0 になったときも敗北させる必要があります。死亡アニメーションに適したフレームがないため、パーティクルを使用して視覚的なエフェクトを作成しましょう。
パーティクルは、本質的に大量に散らばった小さな画像で、エフェクトを表現するものです。例えば、紙吹雪を想像するとわかりやすいでしょう。パーティクルを使えば、各「破片」の外観や動きを自由に調整できます。
Godot Engineでは、通常GPUParticle2DやCPUParticle2Dなどのノードを使用します。
ACTION GAME MAKERでは、ParticleObjectノードを使用してパーティクルを処理します。
ParticleObjectには、すぐに使用できる20 種類以上のパーティクルテンプレートが用意されています。
パーティクルオブジェクトの作成は、ゲームオブジェクトを作成するのと全く同じです。
新しいシーンタブを作成します。
ルートノードとしてGameObjectを選択します。
オブジェクト名を DeathParticle に設定し、テンプレートをparticlesに選択して、作成をクリックします。
シーンウィンドウで、新しく作成されたDeathParticleノードを選択します。
インスペクターで、パーティクルテンプレートをNoneからFireworksに変更します。
GPUParticles2Dノードが自動的に追加されます。
GPUParticles2D のインスペクターで、Emittingプロパティにチェックを入れます。これによりパーティクルの放出が有効になります。
これでシーンビューにパーティクルが放出され、花火のようなエフェクトが表示されるはずです。
最後に、[未保存](*) タブを右クリックして、シーンをdeathparticle.tscnとして保存します。
プレイヤーの HP が 0 になると、移動を停止し、「Death Particle」エフェクトを発生させる必要があります。
この状態はAnyStateから接続するのが妥当ですが、一つ問題があります。
現在、以下に示すように、プレイヤーは状態に関係なく敵の攻撃に衝突すると、常にTake Damage状態に遷移してしまいます。
HP = 0 はプレイヤーがすでに攻撃を受けたことを意味するため、「Death」状態にある間にもTake Damage状態に遷移してしまう可能性があります。
これを修正するため、ダメージ遷移に「HP が 0 ではない」という条件を追加し、プレイヤーがすでに死亡している場合に発動しないようにします。
完全に一致するアニメーションがないため、Damageアニメーションを再利用します。ただし、視覚的に区別しやすくするため、プレイヤーが倒されたことが明確になるようにFilterエフェクトも使用します。
Playerシーンを開きます。
エディタを2DからScriptに切り替えます。
Take Damage状態の上部領域で右クリックし、Add Stateを選択します。
新しい状態の名前をDeathに変更します。
AnimationをDamageTakenに設定します。
Action Settingsセクションを展開します。
Ignore Movement Inputを有効にします。
＋ Add Executable Actionをクリックします。
DisplayParticleを選択します。
Particle Object path フィールドで
アイコンをクリックし、以前作成したDeathParticle.tscnを選択します。
Addをクリックします。
再度、＋ Add Executable Actionをクリックします。
ApplyObjectFilterを選択します。
Filter TypeをTransparentに、Finish Timeを3.0 秒に設定します。これにより、プレイヤーは 3 秒かけて徐々にフェードアウトします。
Addをクリックします。
Actions リストが正しい場合、「Death」状態の準備は完了です。
AnyStateを右クリック → Add Link → Deathに接続します。
＋ Add Other Conditionをクリックします。
HPIsZeroを選択し、Addをクリックします。
最後に、HP がすでに 0 の場合にTake Damage遷移が発動しないようにする必要があります。これにはIs Reversedオプションを有効にします。
AnyState → Take Damageのリンクを選択します。
＋ Add Conditionをクリックします。
HPIsZeroを選択します。
Is Reversedを有効にします。これにより条件が「HP が 0 ではない」に変更されます。
Other Conditions パネルに逆転条件（≠ アイコンがハイライト）が表示されていれば、設定は正しいです。
実際にテストしてみましょう。プレイヤーの初期 HP は 1 に設定されているため、敵の攻撃を 1 回受けるだけで Death 状態に入ります。
設定が正しければ以下のようになります。
攻撃を受けるとDeath Particleエフェクトが表示されます。
プレイヤーは徐々にフェードアウトします。
倒れた後、F5を押してゲームをリセットします。
パーティクルが表示されない: DeathParticle.tscnとDisplayParticleアクションを確認してください。
プレイヤーがフェードアウトしない: ApplyObjectFilterアクションの設定を確認してください。
死亡後もダメージ反応が発動する: リンク条件とTakeDamage遷移の逆転条件を再確認してください。
現在、1 回の攻撃で倒されてしまうのは厳しすぎるため、プレイヤーの HP を増加させましょう。
ただし、プレイヤーの HP が増えるということは、残量を表示する仕組みも必要になります。そのために、HP バーを作成します。
ACTION GAME MAKERでは、SimpleGaugeまたはImageGaugeノードを使用してゲージを表示できます。このチュートリアルではSimpleGaugeを使用します。
カメラがプレイヤーに追従するようになったため、HP バーをプレイヤーと同じレイヤーに配置すると、画面外に移動して見えなくなってしまう可能性があります。HP バーのように常に表示しておく必要がある要素には、UI レイヤーを使用してください。
以前にも触れた通り、ACTION GAME MAKER のレイヤーは以下のようになっています。UI レイヤーとスクリーンエフェクトレイヤーは、カメラの影響を受けない特別なレイヤーです。
つまり、UI レイヤーに配置されたものは常に表示され続けるため、HP バーには最適です。一方、スクリーンエフェクトレイヤーはアクションによってトリガーされる特殊効果用に予約されているため、ここでは UI レイヤーを使用します。
プレイヤーのBaseSettingsノードを選択します。
インスペクターで、HPとMax HPの両方の値を 1 から10に変更します。
stage1シーンタブに切り替え、エディタ表示をScriptから2Dに戻します。
UIノードを選択します。
シーンウィンドウの左上にある**＋（子ノードを追加）**ボタンをクリックします。
SimpleGaugeを選択し、作成をクリックします。
サイズを調整します。最初は潰れたように表示されます。
橙色のハンドルをドラッグして、適切なサイズに拡大します（チュートリアルの参考画像を参照）。
UI レイヤーの表示範囲は細い青い線でマークされています。ゲージをこの境界内の左上に移動させます。
次に、ゲージをプレイヤーの HP にリンクします。インスペクターで変数タイプをオブジェクトに設定します。
新しいプロパティターゲットオブジェクトパスを指定が表示されます。 アイコンをクリックします。
player.tscnを選択し、開くをクリックします。
変数名フィールドに自動的にhpが表示されるはずです。これは現在の値として使用する変数を指定するもので、そのままにしておきます。
変数を最大値として使用チェックボックスを有効にします。
手順 9〜10 を繰り返して、再度player.tscnを指定します。
最大値変数フィールドでは、デフォルトでobject_idになっている場合があります。これをmax_hpに変更します。これにより、ゲージはプレイヤーの最大 HP を最大値として使用することが指定されます。
テストプレイボタンをクリックしてゲームを実行します。設定が正しければ：
HP バーが画面の左上に表示されます。
プレイヤーがダメージを受けると、HP バーがそれに応じて減少します。
ゲージが表示されない: SimpleGauge がUI レイヤーの子ノードであり、青い境界線内に配置されていることを確認してください。
HP が低い値から始まる: BaseSettings でプレイヤーのHPが 10 に設定されているか再確認してください。
最大 HP があるのに HP が即座に 0 になる: BaseSettings でMax HPが 10 に設定されていること、および SimpleGauge の最大値変数が正しくmax_hp に設定されていることを確認してください。
テストプレイ中に、プレイヤーが穴に落ちると無限に落下し続けることに気づかれたかもしれません。これを修正し、プレイヤーが穴に落ちた際に「敗北」状態になるように設定しましょう。
解決策は、カメラが無限に下へ追いかけるのを防ぐためにカメラの移動範囲を制限し、プレイヤーがカメラの範囲外に出た際に**「Death（死亡）」**状態に移行させることです。
InitialCamera ノードを選択します。
インスペクターで、Limits（制限） セクションを展開します。
Bottom（下限） の値を 10000000 から 500 に変更します。
テストプレイを実行します。
1000 や 2000 などに調整し、適切に揃うまで試してください。すでに**「Death」状態が存在するため、既存のリンクに新しい条件「OffScreen（画面外）」**を追加するだけです。
Player シーンに切り替え、エディタの表示を**Script（スクリプト）**に変更します。
AnyState → Death のリンクを選択します。
＋ Add Condition（条件を追加） をクリックします。
条件として OffScreen を選択します。
Data Type（データ型） を Unset（未設定） から This Node（このノード） に変更します。
Connection With Previous Condition（前の条件との接続） を OR に設定し、追加します。
条件リストが正しく以下のように表示されていることを確認します。
HPIsZero
OR
OffScreen
テストプレイを実行し、穴に落ちます。
正しく設定されていれば、プレイヤーがカメラの範囲外に出た際に花火のパーティクルエフェクトが再生され、敗北を示します。
5という数値からカウントダウンする方法が必要です。敵が倒されるたびにこの数値は減少し、0になった時点でゲームクリアイベントが発動するようにします。これを実現するために、変数と呼ばれるものを使用します。
変数とは、値を格納するコンテナのようなものです。例えば、以前扱ったプレイヤーの HP（体力）も実際には変数です。プレイヤーが敵の攻撃を受けると、HP コンテナ内の値が 1 減少します。
ACTION GAME MAKERでは、変数を定義する主な方法が 2 つあります。
以前使用した HP は、前者のタイプの例です。
実際の使い分けは以下の通りです。
技術的にはどちらの変数タイプでも機能しますが、複数のオブジェクト（敵たち）がこの数値と相互作用するため、プロジェクト変数を使用します。
したがって、処理の流れは以下のようになります。
キル数を管理するための専用のゲームオブジェクトを作成します。このオブジェクトは常に表示されるようにUI レイヤーに配置します。HP バーと同様に、倒された敵の数を表示し、プレイヤーにクリアまであと何体残っているか知らせます。
手順は以下の通りです。
プロジェクト変数はデータベース内にあります。今すぐ追加しましょう。
左上のメニューにあるデータベースボタンをクリックします。
データ管理という新しいウィンドウが開きます。
ユーザーデータベースタブからプロジェクト変数タブに切り替えます。
ウィンドウの左上にある＋ボタンをクリックします。
下部にvariables1という名前の新しい行が表示されます。これをRemaining Enemiesに名前変更します。
値を5.0に設定します。プレイヤーに5体の敵を倒してもらうためです。
OKをクリックしてウィンドウを閉じます。設定は完了です。
ACTION GAME MAKERでは、プロパティの変更アクションを使用して変数を修正します。
基本的な四則演算（加算、減算、乗算、除算）を実行できるため、ロジックは**「残りの敵数 -= 1」**として実装できます。
敵シーンタブを開き、エディタビューをスクリプトに切り替えます。
消滅状態を選択し、実行可能アクションを追加をクリックします。
ChangeObjectPropertyを選択します。
以下の通りフィールドを設定します。
対象オブジェクトタイプ: プロジェクトデータベース
データベースタイプ: プロジェクト変数
レコード名: 残りの敵数
式: -=
定数値: 1
設定すべきフィールドは5つあります。それぞれを再確認してください。
このアクションにより、プロジェクト変数残りの敵数が1減ります。
最後に、実行順序を並べ替えます。アクションは上から下へ実行されるため、消滅がプロパティの変更より先に実行されると、変数は更新されません。
Change Propertyの横にあるハンバーガー（3本線の）アイコンをドラッグして上に移動させ、Change Propertyが最初に実行されるようにします。
-= を使うのか、単に - ではダメなのか？プログラミングにおいて、-= は以下の意味を持つ短縮演算子です。
new_value = previous_value - 1
これは、減算と結果を変数に代入するという2つの処理を1ステップで行います。
もし = がない単なる -（マイナス）だけを使用すると、結果をどこに保存するかが指定されないため、実際には変数は変更されません。
残りの敵変数を管理するための UI オブジェクトを作成します。
このオブジェクトは、「残りの敵」の現在の値を表示し、値が 0 に達したときにクリアシーケンスをトリガーします。明確にするために、敵のアイコン（Sprite2D経由）を表示し、アクションを使用してその隣に残りの敵変数を表示します。敵のアイコンには、既存の敵スプライト画像をそのまま再利用できます。
エディタビューを2Dに切り替えます。
新しいシーンタブを開き、ルートノードとしてGameObjectを選択します。
オブジェクト名を RemainingEnemiesManager に設定し、テンプレートを UI、タイプを Empty に選択してから、作成をクリックします。
新しく作成したシーンを保存します。
ファイルシステムから、敵で使用されているスプライトである enemy.png を、エディタビュー内の原点の左側（赤と緑の軸が交差する場所）の空のスペースにドラッグします。
Enemy という名前の Sprite2D が自動的に追加されます。Godot では、画像ファイルをエディタビューポートに直接ドロップすると、Sprite2D ノードが自動的に作成され、テクスチャが割り当てられます。
まず、変数の表示に焦点を当てます。単一の状態**「Count」だけで、「残存敵」**変数の値を表示すれば十分です。
変数を表示するには、DisplayTextアクションを使用します。
Sceneウィンドウで**RemainingEnemiesManager (Game Object)**ノードを選択し、**+ (スクリプトの添付)**をクリックします。
RemainingEnemiesManager.vsを作成します。
デフォルトのState001をCountにリネームします。
DisplayText実行アクションを追加し、Basic Settingsを以下のように設定します。
Text Type: Variable
Variable Source: Data Management
Database Type: Project Variables
Record Name: Remaining Enemies
Layout & Actionセクションを以下のように設定します。
Unlimited Duration: On
Font: New SystemFont
Font Size: 64
Display Size: x = 80, y = 80
Margins (Top/Left/Right/Bottom): すべて 0
Horizontal Alignment: Center
Vertical Alignment: Center
注：DisplayTextアクションにおける配置について
このアクションは、指定されたサイズのテキストボックスを基準点を中心に作成し、選択した期間、その中に指定されたテキスト（変数）を表示します。
基準点が**「このオブジェクトの中心」の場合、それは原点**（赤と緑の軸が交差する点）を意味します。
今回の設定では、原点を中心に80×80 pxのテキストボックスを作成し、テキストを中央に配置し、表示期間を無制限に設定しています。
シーンに配置してテストしましょう。常に表示されるようにするため、UIレイヤーに配置します。
stage1シーンタブに切り替え、エディタを2Dに変更します。
UI (CanvasLayer)下のSimpleGaugeノードを選択します。
FileSystemでRemainingEnemiesManager.tscnを選択し、UIレイヤーの青い枠内の右上エリアにドラッグ＆ドロップします。
テストプレイを実行し、以下を確認します。
開始時にRemaining Enemies = 5が正しく表示される。
敵を倒した後、数が4に減少する。
アイコンも数値も表示されない:
オブジェクトがUIレイヤーの子であり、青い枠（UI表示領域）内に配置されていることを確認してください。
アイコンは表示されるが数値が表示されない:
残存敵マネージャーオブジェクト内で、アイコンが原点の近くに配置されていることを確認し、Count状態のDisplayTextアクション設定を再確認してください。
敵を倒しても数値が変化しない:
敵オブジェクトのVanish状態で、実行順序がまずプロパティの変更、次に自身を削除になっていることを確認してください。
次に、クリアシーケンスを作成します。これにもDisplayTextアクションを使用します。
画面の中央に**「STAGE CLEAR」を大きく表示し、正式なクリアの雰囲気を出します。
遷移条件は、残り敵数変数が0**に達したときとします。
RemainingEnemiesManagerシーンタブに切り替え、エディタビューをScriptに変更します。
Countステートの近くで、Add State（ステート追加）をクリックします。
新規ステートをStage Clearにリネームします。
＋ Add Executable Action（実行可能アクションの追加）をクリックします。
DisplayTextを選択します。
以下のように設定します（項目が多いので、一つずつ確認してください）：
Text Body（テキスト本文）: STAGE CLEAR
Unlimited Duration（無制限の継続時間）: On（有効）
Font（フォント）: New SystemFont
Font Size（フォントサイズ）: 96
Display Area（表示領域）: x = 1200, y = 120
Horizontal Alignment（水平配置）: Center（中央揃え）
Vertical Alignment（垂直配置）: Center（中央揃え）
Reference Point（基準点）: Use Scene as Base（シーンを基準として使用）
Anchor（アンカー）: Center（中央）
\u003e 「Use Scene as Base（シーンを基準として使用）」とは何ですか？
\u003e このオブジェクトの位置ではなく、表示はゲームシーン全体（つまり、カメラで表示されている領域）にアンカーされます。この設定では、テキストボックス（1200×120）がシーンの中央に配置され、STAGE CLEARがそのボックス内で中央揃えされます。
Countステートを右クリック → Add Link（リンク追加）を選択し、Stage Clearに接続します。
＋ Add Condition（条件追加）をクリックします。
SwitchVariableChanged（変数切り替え）を選択します。
条件を設定します：
Variable Type（変数タイプ）: Variable（変数）
Target Type（ターゲットタイプ）: Project Variable（プロジェクト変数）
Database Record Name（データベースレコード名）: Remaining Enemies（残り敵数）
Variable Condition（変数条件）: =
（これにより、Remaining Enemies == 0のときに遷移が発生します。）
まず、敵を十分に配置します（合計5体）し、クリアシーケンスが正しくトリガーされるかテストします。
stage1シーンタブに切り替え、エディタビューを2Dに設定します。
BaseLayerの下で、配置の準備としてenemyやplayerなどの子ノードを選択します。
FileSystemからenemy.tscnをステージにドラッグして、敵をもう1体配置します。
enemy5が配置されるまで、手順1–3を繰り返します。
テストプレイを開始します。
すべて正しく設定されていれば、すべての敵を倒した際にSTAGE CLEARが表示されます。
「配置した5体の敵が表示されない」:
画面外に落ちてしまっている可能性があります。各敵が固形地面の上に配置されていることを確認し、Template MoveでDon’t fall off ledges（崖から落ちない）が有効になっているか確認してください。
「カウントが0になっても何も起こらない」:
Stage ClearステートのDisplayText設定を確認し、リンクの遷移条件（プロジェクト変数Remaining Enemiesが0に等しい）が正しいか確認してください。
