fantasy — 翠の砦

fantasy — 翠の砦

English | 日本語

翠の砦

概要

高低差のある9×9マップで、剣士・魔術師・弓使いの3人を動かして敵3体を倒すターン制ゲームです。PBR(物理ベースレンダリング)のシーンに、動くNode、クリック選択、DOMの操作パネル、GPU粒子、勝敗と再開始を足す小さな統合例です。

形状と操作画面は、同梱のコードから構築します。形状はPrimitiveで生成し、手足と装備をNodeの親子構造で接続します。戦闘ルールはGPUとDOMから独立しており、マスの経路と表示アニメーションを段階的に追えます。

戦場は水に沈んだ砦です。地形・装飾・部隊へコアのコースティクスを適用し、青緑の照明、距離フォグ、上へ漂う粒子で水中を表現します。「水中のコースティクス」を切り替えると、地面を流れる集光を比較できます。OFFでも水中の色とフォグは残ります。

実行と操作

WebGPU対応ブラウザでfantasy.htmlを開きます。リポジトリ全体をHTTPで配信し、localhostまたはHTTPSを使ってください。初回はPBRとGPU粒子を準備します。

  1. 3Dの味方、または部隊一覧から操作するユニットを選びます。
  2. 青いマスをクリックして移動します。
  3. 射程内の敵をクリックして攻撃します。
  4. 他の味方を操作し、最後に「味方ターンを終了」で敵の行動へ進みます。

各ユニットは移動1回・攻撃1回です。攻撃だけの行動も可能です。移動は攻撃前に行い、攻撃後は「待機」で行動を終了します。「待機」で個別に行動を終了します。敵は移動して射程に入り、攻撃可能な味方のうちHPが低い相手を狙います。

移動は上下左右、段差は1段までです。上りは移動力2、平地・下りは1を消費します。移動経路は生存ユニットと障害物を避けて探索します。高所からの攻撃はダメージ+3。射程はマス距離で、遠隔攻撃は障害物を越えます。命中は確定です。

全敵撃破で勝利、味方全滅で敗北。「最初から」「もう一度戦う」で再開始します。「マスをボタンで操作」を開くと、TabとEnterでも同じ選択・移動・攻撃を行えます。

ドラッグで視点を回し、ホイールで拡大します。初期視点は斜めから見下ろす透視投影です。大きい画面ではCanvasを960×720とし、狭い画面では幅に合わせ、操作パネルを下へ配置します。

使用しているwebgの機能

physics:falseにして、経路探索と高低差を作品側のマス規則で扱います。形状はShapeで作り、移動と攻撃の動作はNodeの位置・姿勢を更新して表現します。

確認ポイント

コードを読む順序

  1. `main.js`の`start()`: 一つの入口からシーンを起動し、動くNodeと入力を追加してからstart()します。描画ループと粒子のstepはWebgAppが進めます。
  2. `scene.js`の`createManifest()`: 配置・共通材質・PBR・粒子を初期データとして読みます。地形のマスと描画高度はrules.mjsから生成します。
  3. `visuals.js`の`part()`と`character()`: 直接Shapeへ指定するRGBAとPBR材質、Nodeの親子関係、手動Shapeの所有者を確認します。
  4. `main.js`の`choose()`→`move()`→`updateMotion()`: マスを選び、表示を待ち、論理座標を確定する順序を追います。rules.mjsのpaths()は上りのコストを含む経路探索です。
  5. `main.js`の`makePointerRay()`・`pickTile()`・`updateLabels()`: 3Dの選択とDOMの表示へ同じカメラを使う箇所を読みます。
  6. `FantasyApp.js`と終了処理: CSS寸法、Canvas、PBRの描画先を同期し、Observer・手動Shape・標準入口をそれぞれ解放します。

main.jsのreset()はこのゲームの再開始で、コアのWebgSceneApp.reset()とは別の関数です。HPや行動権の復元はゲーム側の責任です。

水中の照明を接続する

main.jsのconnectWater()で、全体を覆う幅・奥行き18m、平均水面高さ6mのWaterBodyを作ります。地形と部隊の親NodeをaddReceiver()へ渡すと、手足・装備を含む子Shapeへ登録が引き継がれます。移動マーカーと選択リングは対象から外します。描画ループのupdate()ではsetTime()で秒単位の時刻だけを更新します。

await sceneApp.renderer.setWater(water, {
  causticsEnabled: true,
  surfaceEnabled: false,
  quality: "high"
});

ON/OFF時はsceneApp.stop()で新しいframeを止め、setWater()の準備を待ってから再開します。OFFで専用GPU資源を解放し、再ONでも戦闘状態と登録済みNodeを引き継ぎます。再開始では水域を再利用します。

これは水中の雰囲気を作る照明演出です。RGB吸収の設定は集光の減衰に使い、カメラまでの濁りは標準Fogで近似します。水中カメラからの屈折・全反射・水面の裏側を計算する用途には、専用の水中表示処理を組み合わせる構成が必要です。任意物体への集光は水平照度画像の投影近似で、影とPBRの鏡面反射は標準パイプラインが処理します。詳細はwaterの使い方を参照してください。

一つずつ変更して学ぶ

一つ変更するごとに上の確認ポイントを試します。材質、ルール、表示速度、効果を一つずつ変えると、結果の原因を判断しやすくなります。

自動確認

camera_reference.jsonには初期視点の参照値を保存しています。bookの「PBRシーンから小さなゲームへ」と併せると、単機能の例からこの構成へ進む境界を確認できます。

リポジトリのルートから次を実行すると、Node.js上で地形・経路・占有・射程・敵の計画・勝敗を確認できます。描画と操作はブラウザで別に確認します。

node --test samples/fantasy/rules.test.mjs