Cave Engineへようこそ！

Caveは、ツールに苦労することなくゲームを作るためのシンプルで高速な3Dデスクトップゲームエンジンです。エディターはシーン、エンティティ、コンポーネント、アセット、物理演算、アニメーション、UI、オーディオ、タイムライン、Pythonスクリプトなど、商用ゲームエンジンに一般的な構成要素を提供しますが、ワークフローは直接的で使いやすく設計されています。ゲームコードのコンパイルやシェーダーのコンパイル待ちなどをせず、すぐに実験を始められます。

このGetting Startedクエストでは、Caveを初めて開くところから基本的なゲームプロジェクトの作成、テスト、エクスポートまでを学びます。最初のレッスンでは、エディターを正しくインストールし、安全に起動するところまでを扱います。

必要なもの

始める前に以下を用意してください：

• 有効なCave Engineライセンス。
• 更新されたグラフィックスドライバーを搭載したコンピューター：CaveはOpenGL 4.3以上のドライバーを必要とします。このGraphics APIは2012年にリリースされたため、多くのマシンはすでに対応しています。
• エンジンを解凍するための通常のローカルフォルダー：Windowsの場合、C:\Cave Engine\のようなシンプルな場所がおすすめです。フォルダー名は自由ですが、短くて見つけやすく、クラウド同期フォルダーの中でない場所が望ましいです。

Cave Engineのインストール

Cave Engineは圧縮フォルダ（ZIP）として配布されています。エンジンのビルドはサーバーよりユニークにコンパイルされ、こちらから提供されます。これはあなた専用のもので、共有・再配布は禁止されています。

インストール方法は、エンジンパッケージ全体を専用フォルダーに解凍してください。

重要事項：

• .zipファイルから直接Caveを実行しないでください。
• 関連のないファイルがすでにあるフォルダーには解凍しないでください。
• エンジンのファイルを別々の場所に分けないでください。

解凍後のエンジンフォルダーには、エディター実行ファイル、ゲーム/プレイヤー実行ファイル、EditorやLibなどの重要なサポートフォルダーが含まれています。ファイル名はOSやビルドによって多少異なることがありますが、重要なのはフォルダーの構成を保つことです。

> Caveはファイルを同じフォルダー構成のまま必要とします。エンジンフォルダーのファイルを移動、名前変更、削除すると、エディターが起動しなくなる可能性があります。

インストールパスのトラブルシューティング

Caveは起動時に一般的なインストールパスの問題をチェックします。これらの問題は特にWindowsでクラッシュ、ファイルの欠落、異常動作を引き起こすことがあります。以下のルールに従ったフォルダーパスを使用してください：

• OneDrive、Dropbox、Google Driveなどの同期フォルダー外に置く。
• 特にデスクトップがOneDrive同期されている場合、デスクトップへの解凍は避ける。
• フォルダー名にアクセント文字や特殊言語文字などの非ASCII文字を含めない。
• パスは適度に短く保つ。
• オフライン、仮想、クラウド専用などにマークされたフォルダーは避ける。

良い例：

C:\Cave Engine\

リスクのある例：

C:\Users\YourName\OneDrive\Desktop\Cave Engine\
C:\Users\YourName\Desktop With Accents\Cave Engine\
C:\Very\Long\Folder\Path\With\Many\Many\Nested\Folders\Cave Engine\

Caveが「Invalid Install Path」（無効なインストールパス）警告を表示した場合は、エンジンフォルダーをよりシンプルなローカルパスに移動して再度開いてください。

エディターの起動

Caveを起動するには、エンジンフォルダー内のCave Editor実行ファイルを開きます。Windowsでは通常.exeファイルとして見えます。デスクトップショートカットを作成したりタスクバーにピン留めしたりできますが、実行ファイルからショートカットを作成し、実行ファイルをフォルダー外に移動しないでください。

正常に起動すると、Project Managerウィンドウが表示されます。これがエディターの最初の画面です。ここから新しいプロジェクトを作成したり、最近のプロジェクトを開いたり、既存のプロジェクトを参照できます：

基本的なエンジンファイルの理解

Engine Specificに進む前に、エンジンファイル構成について少し理解を深めましょう。エンジンフォルダーには複数の種類のファイルがあります。これはCaveがゲームを作るためのツールと、エクスポートされたゲームを実行するためのランタイムに分かれているためです。

• エディター実行ファイルは、プロジェクトの作成と編集に使います。
• ゲーム/プレイヤー実行ファイルは、エクスポートされたプロジェクトで使われます。最終的なゲームをプレイヤーが実行するときに動きます。
• Editorフォルダーは、アイコン、デフォルトアセット、フォント、インターフェースファイルなど、エディターが必要とするデータを含みます。
• Libフォルダーは、Python関連ファイルを含む、Caveのスクリプトシステム用の必要なランタイムライブラリを含みます。

今のところ、フォルダー内のすべてのファイルを理解する必要はありません。次のルールだけ覚えてください：

> 解凍したCaveフォルダー内からエディターを起動し、フォルダーの内容をまとめて保つこと。

トラブルシューティング：初回起動の一般的な問題

Project Managerが表示されない、またはエディターが起動してすぐに閉じる場合は、まず以下を確認してください：

1. エンジンの完全な解凍がされていない

Editor/imgui.iniのような必須ファイルが見つからない場合、エンジンが正しく解凍されていないか、実行ファイルが他のファイルから離されている可能性があります。

きれいなフォルダーに再度パッケージ全体を解凍し、そこからエディターを起動してください。

2. エンジンが問題のあるフォルダー内にある

インストールパスの警告が出るなら、Caveをよりシンプルなローカルフォルダーに移動してください。クラウドフォルダーや同期されたデスクトップフォルダー、非ASCII文字、非常に長いパスは避けてください。

3. ウイルス対策ソフトがファイルを削除またはブロックしている

一部のウイルス対策ソフトは新しくダウンロードしたソフトウェアのファイルを隔離することがあります。解凍後にファイルが欠けている場合は、隔離フォルダーから復元するか、再度Caveをダウンロードして解凍してください。

疑わしい場合は、クリーンなフォルダーにCaveを解凍し、パッケージのすべてのファイルが揃っていることを確認してください。

4. グラフィックスドライバーが古い

Caveはデスクトップの3Dレンダラーを使っているため、グラフィックスドライバーが重要です。起動時にクラッシュしたり、真っ白なウィンドウが開いたり、レンダリングエラーが出る場合は、GPUメーカーのウェブサイトからドライバーを更新してください。

これは特にノートパソコン、古いPC、新規インストールのWindowsで重要です。

5. 誤ったファイルを起動している

プロジェクト作成にはエディター実行ファイルを使ってください。ゲーム/プレイヤー実行ファイルはエクスポート後のゲームを実行するためのもので、ソースプロジェクトの編集には使いません。ゲームを作りたい場合は必ずCave Editorを開いてください。

次のステップ

Project Managerが表示されたら、Caveは最初のプロジェクトの準備ができています。

次のレッスンでは、新しいプロジェクトを作成し、スターターテンプレートを選択し、必要に応じてエディターのズームを調整し、Caveが何を生成するのかを理解します。