欢迎使用 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 上。请使用符合以下规则的文件夹路径：

避免放在 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 将创建游戏所需的工具和运行导出游戏的运行时分开。

编辑器可执行文件是用来创建和编辑项目的应用程序。
游戏/玩家可执行文件用于导出项目，它可以运行最终游戏供玩家游玩。
Editor 文件夹包含编辑器所需的数据，如图标、默认资源、字体、界面文件和其他资源。
Lib 文件夹包含必要的运行时库，包括 Cave 脚本系统使用的 Python 相关文件。

目前你无需全部了解文件夹里的每个文件，只需记住这条规则：

> 从解压后的 Cave 文件夹内打开编辑器，并保持文件夹内容完整。

常见首次启动问题排查

如果项目管理器未出现，或编辑器打开后立刻关闭，请先检查以下情况：

1. 引擎未完全解压

若 Cave 找不到必须文件，如 Editor/imgui.ini，说明引擎可能未正确解压，或者可执行文件与其他文件分离。

修复方法是重新将完整包解压到干净文件夹内，然后从该文件夹启动编辑器。

2. 引擎位于问题文件夹

若编辑器提示安装路径问题，请将 Cave 移至更简单的本地文件夹，避免云同步文件夹、非ASCII字符路径及过长路径。

3. 杀毒软件移除或阻止文件

部分杀毒软件可能会隔离新下载软件的文件。解压后文件丢失，请从杀毒软件隔离区恢复文件，或重新下载并解压。

不确定时，请将 Cave 解压到干净文件夹，确保包内所有文件完整。

4. 显卡驱动过时

Cave 使用桌面3D渲染，显卡驱动十分重要。若编辑器启动时崩溃、空白窗口或渲染错误，请从显卡厂商官网更新 GPU 驱动。

这对笔记本、老旧电脑或刚装Windows的设备尤为重要。

5. 运行了错误的文件

请使用编辑器可执行文件创建项目。游戏/玩家可执行文件用于运行导出后的游戏，不用于编辑项目。制作游戏时，请打开 Cave Editor。

接下来做什么

一旦项目管理器打开，Cave 就准备好让你开始第一个项目了。

下一课，你将学习创建新项目、选择入门模板、调整编辑器缩放（如有需要）并理解 Cave 为你生成了什么内容。

Cave：入门指南