Doty Runは、プレイヤーが勇敢な冒険者Dotyを操作し、氷点下の道を駆け抜けながら貴重なDotyコインを集める、興奮のエンドレスランニングゲームです。 目標は？ できるだけ長く生き残り、できるだけ遠くまで進み、できるだけ多くのコインを集めてハイスコアを更新しよう。 PCユーザーの場合、移動は矢印キーで操作します。 氷の道を navigation し、障害物を避け、道をたどって冒険を続けよう。 すべてのプレイで最高のスコアが保存されます—それぞれの冒険が、
でそのスコアを更新するチャンスです！ どこまで行けるでしょうか？

3D シーン

• GameManager： ゲームの状態とスコアを管理するゲームマネージャースクリプトを含みます。
  
  • Start：ui-startスクリプトを含みます。 メッシュと物理コライダーを含みます。
  • コーナー： パスの方向が変わるコーナータイルの3Dモデル。
• Environment： ゲームの環境用3Dモデルを含みます
。
• Fog： シーン内の霧効果を管理するfog-controllerスクリプトを含みます
。
• Sfx：背景音楽用のオーディオコンポーネントと、サウンド効果を管理するsfx-managerスクリプトを含みます
• PathRoot： 実行時に生成されるパス要素のルート親です。 メッシュと物理コライダーを含みます。
• コイン： コインの3Dモデル。 メッシュと物理コライダーを含む、イベント専用に設定されたコライダーセット

資産

3Dモデル

• 環境
  • env-1.glb： メイン環境の3Dモデル
• オブジェクト
  • coin_1.glb： 収集アイテムとして使用されるコインの3Dモデル
  • doty_coin_gold_v2.glb： コインモデルの代替バージョン。

スクリプト

これは、このプロジェクト内のスクリプトの簡単な概要です。 ここでは、グローバルなCSSスタイルとモジュール化されたCSSスタイル（utilities.css、start.css、gameplay.css、およびgame-over.css）をインポートし、ゲームUIのビジュアルデザインとレイアウトを定義しています。 さらに、UIで一貫したスタイリングを実現するために使用するフォントを注入します。

game-manager.ts： ゲームのコア状態（開始、ゲームプレイ、ゲームオーバー）を管理し、プレイヤーのスコア計算を処理し、
のハイスコアの保存と取得を管理します。

utilities.js：THREEライブラリへのアクセスが必要なコアメカニクスを実装します。例えば、ジャイロスコープへのアクセスを要求する関数などです。

game-manager.ts： ゲームのコア状態（開始、ゲームプレイ、ゲームオーバー）を管理し、プレイヤーのスコア計算を処理し、
のハイスコアの保存と取得を管理します。 例えば、ジャイロスコープへのアクセスを要求する関数などです。 これらのユーティリティは、Studio スクリプトから分離して管理されており、ECS ライブラリとの衝突を回避するためです。 カメラは現在の位置に配置され、プレイヤーに対してオフセットが生じます。 このアプローチでは、プレイヤーの位置に対してカメラの位置を動的に調整するために変換行列を計算する必要がなくなります。

このスクリプトは、プレイヤーをX軸に沿って追跡するように拡張することも可能です。

このメカニズムは、プレイヤーを追従する空のエンティティを作成し、そのエンティティの子としてカメラを設定することで実現されます。 カメラは現在の位置に配置され、プレイヤーに対してオフセットが生じます。 このアプローチでは、プレイヤーの位置に対してカメラの位置を動的に調整するために変換行列を計算する必要がなくなります。 スタート画面の背景とスタートボタンの外観を定義します。

utilities.css： UI要素用のユーティリティクラスを提供します。例えば、要素を非表示にするクラスやアニメーションを追加するクラスなど。

入力

gyro-controller.ts： このコンポーネントは、電話のジャイロスコープを使用してY軸（左右の傾き）の回転を検出する入力メカニズムを実装します。これは、設定可能なスキーマプロパティangleLimitに基づいて動作します。

CSS

game-over.css： ゲームオーバー画面のUIスタイルを処理します。 これには、ゲームオーバー画面の背景、スコア表、およびリスタートボタンが含まれます。 現在、Studioでは、入力がアクティブかどうかを確認する機能（input.getAction（））のみを提供しており、入力がトリガーされたタイミングや終了したタイミングに関する情報は提供されていません。

start.css： スタート画面のUIスタイルを管理します。 スタート画面の背景とスタートボタンの外観を定義します。 例えば、要素を非表示にするクラスやアニメーションを追加するクラスなど。 これは、設定可能なスキーマプロパティangleLimitに基づいて動作します。 一部のデバイスでは、ジャイロスコープにアクセスするには明示的なユーザー許可が必要であり、この許可はボタンを押すなどの直接的なユーザー操作を通じてリクエストする必要があります。 このコンポーネントは、Z軸（コンパス方向）やX軸（前後傾き）周りの回転など、他の種類の回転を検出するように簡単に変更可能です。 また、弧状の障害物との衝突を、シンプルで直感的な方法でチェックします：現在のアニメーションが「Roll」であるかどうかを確認するだけです。 このアプローチにより、プレイヤーが下ボタンを適切なタイミングで押したかどうかを確認しつつ、コードを過剰に複雑化することなく実現できます。

player-collision.ts： プレイヤーのすべての衝突を処理します。

touch-input-controller.ts： このコンポーネントは画面上のタッチ操作を管理し、指が画面上で上、下、左、または右にスワイプされた際にon-input-action-triggeredイベントをトリガーします。 各衝突に対応するイベントを送信し、他のスクリプトでアクションをトリガーします。

object-spawner.ts： このコンポーネントは、プロシージャルに生成された設定に基づいて、パスの新しいセクションのタイル上にオブジェクトを配置します。 設定により、各タイルに配置されるオブジェクト（コイン、障害物、パワーアップなど）が決定されます。 プレイヤー・アニメーター（player-animator.ts）経由で対応するアニメーションをトリガーし、 関数でゲームオーバー条件（落下や障害物との衝突など）をチェックし、必要に応じてon-player-lost-game イベントを ディスパッチします。

path-movement.ts： このコンポーネントは、パスセクション内の現在の
タイルを前方方向に移動させ、
ゲームシーン内でプレイヤーの移動の錯覚を生み出します。 また、リスタートボタンが押された際に発生するイベントを管理します。

ui-gameplay.ts： ゲームプレイUI画面の各要素を格納する個別のdiv要素を作成し、3つのゲームステータス（コイン、距離、ポイント）を表します。   このコンポーネントは、特定のアニメーションのタイミング処理も担当しています。 また、スタートボタンが押された際に発生するイベントを管理します。

エンドレスランニングゲームを開発する際、特に注意すべき点があります：プレイヤーキャラクターは動きません。

なぜ？

ゲームはプレイヤーがどこまで移動するかを予測できないため、グローバル原点から離れすぎると、浮動小数点数の精度制限により数学的な計算エラーが発生する可能性があります。 さらに、プレイヤーを位置 （0,0,0）に固定することで、衝突検出やカメラ移動などの特定のゲームプレイメカニクスの開発が簡素化されます。

では、それぞれ何をするのでしょうか？