欢迎使用 Cave Engine!

Cave 是一个简单、快速的 3D 桌面游戏引擎，旨在帮助开发者构建游戏，而无需先与工具作斗争。编辑器提供了商业游戏引擎的常用构建模块，例如场景、实体、组件、资产、物理、动画、用户界面、音频、时间线、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\带重音的桌面\Cave Engine\
C:\非常\长\文件夹\路径\包含\许多\嵌套\文件夹\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。

如有疑问，将 Cave 解压到干净的文件夹中，确保包中的所有文件仍在。

4. 图形驱动程序过时

Cave 使用桌面 3D 渲染器，因此您的图形驱动程序很重要。如果编辑器在启动时崩溃、打开空白窗口或显示渲染错误，请从 GPU 制造商网站更新您的 GPU 驱动程序。

这在笔记本电脑、旧计算机或全新 Windows 安装上尤其重要。

5. 您正在运行错误的文件

使用编辑器可执行文件创建项目。游戏/玩家可执行文件用于运行导出的游戏，而不是编辑源项目。如果您想制作游戏，请打开 Cave Editor。

接下来会发生什么

一旦项目管理器打开，Cave 就为您的第一个项目准备好了。

在下一课中，您将创建一个新项目，选择一个起始模板，如果需要，调整编辑器缩放，并了解 Cave 为您生成的内容。