Cave Engineへようこそ！

Caveは、ツールにまず格闘することなくゲームを構築するために作られたシンプルで迅速な3Dデスクトップゲームエンジンです。エディターは、シーン、エンティティ、コンポーネント、アセット、物理、アニメーション、UI、オーディオ、タイムライン、Pythonスクリプトなど、商業ゲームエンジンの通常のビルディングブロックを提供しますが、ワークフローは直接的であるように設計されています。実験を開始するためにゲームコードをコンパイルしたり、シェーダーのコンパイルを待ったりする必要はありません。

この「はじめに」クエストでは、Caveを初めて開くところから、基本的なゲームプロジェクトの作成、テスト、エクスポートまでの手順を踏みます。この最初のレッスンは、エディターを正しくインストールし、安全に起動することに関するものです。

必要なもの

始める前に、次のものを準備してください：

• 有効なCave Engineライセンス。
• 更新されたグラフィックスドライバーを持つコンピュータ：Caveは、動作するためにOpenGL 4.3以上のドライバを必要とします。このグラフィックスAPIは2012年にリリースされているため、お使いのマシンはすでに対応している可能性が高いです。
• エンジンを抽出できる通常のローカルフォルダ：Windowsの場合、C:\Cave Engine\のようなシンプルな場所が良い選択です。正確なフォルダ名は任意ですが、短く、見つけやすく、同期されたクラウドフォルダ内ではない必要があります。

Cave Engineのインストール

Cave Engineは圧縮フォルダ（ZIP）として配布されます。ユニークなエンジンのビルドが、こちらのサーバーによってコンパイルされ、利用可能になります。それはあなた専用で、共有または再配布することは当社のエンドユーザーライセンス契約に違反するため禁止です。

インストールするには、全体のエンジンパッケージを一つの専用フォルダに抽出してください。

重要：

• .zipファイルから直接Caveを実行しないでください。
• 関連のないファイルが既に存在するフォルダにCaveを抽出しないでください。
• エンジンファイルを異なる場所に分割しないでください。

抽出後、エンジンフォルダにはエディタの実行ファイル、ゲーム/プレイヤーの実行ファイル、およびEditorやLibなどの重要なサポートフォルダが含まれているはずです。正確なファイル名は、オペレーティングシステムやエンジンビルドに応じて多少異なる場合がありますが、重要なルールはシンプルです：抽出されたフォルダを一緒に保ってください。

> Caveはファイルが同じフォルダ構造にあることを必要とします。エンジンフォルダからランダムなファイルを移動、名前変更、または削除すると、エディターが開かなくなる場合があります。

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

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

• Caveを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が「無効なインストールパス」の警告を表示した場合は、全体の抽出されたエンジンフォルダをクリーンなローカルパスに移動し、再度開いてください。

エディターの起動

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

Caveが正しく開くと、プロジェクトマネージャウィンドウが表示されるはずです。これがエディターの最初の画面です。そこから、新しいプロジェクトを作成したり、最近のプロジェクトを開いたり、既存のプロジェクトを参照したりできます：

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

エンジンスペシフィックに移る前に、エンジンファイルをもう少し理解しましょう。エンジンフォルダには、Caveがゲームを作成するために必要なツールとエクスポートされたゲームをプレイするために必要なランタイムの、1種類以上のファイルが含まれています。

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

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

> 抽出されたCaveフォルダ内からエディタを開き、フォルダの内容を一緒に保つこと。

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

プロジェクトマネージャが表示されない場合、またはエディターが表示されてすぐに閉じる場合、まず次の点を確認してください：

1. エンジンが完全に抽出されていない

Caveが必要なファイル（例：Editor/imgui.ini）を見つけられない場合、エンジンは正しく抽出されていなかったか、実行可能ファイルが他のファイルから移動された可能性があります。

クリーンフォルダに再度完全なパッケージを抽出して修正します。そのフォルダからエディタを起動してください。

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

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

3. アンチウイルスがファイルを削除またはブロックした

いくつかのアンチウイルスツールが新たにダウンロードしたソフトウェアからファイルを隔離する場合があります。抽出後にファイルが欠落している場合は、アンチウイルスの隔離から復元するか、再度Caveをダウンロードして抽出してください。

疑わしい場合は、Caveをクリーンなフォルダに抽出し、パッケージからすべてのファイルがまだ存在することを確認してください。

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

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

これは特にノートPC、古いコンピュータ、新しいWindowsインストールで重要です。

5. 間違ったファイルを実行している

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

次に来ること

プロジェクトマネージャが開くと、Caveはあなたの最初のプロジェクトのための準備が整いました。

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