Cave：入门指南

启动 Cave Engine 后，首先看到的是 Project Manager。这里是你创建新项目、重新打开最近项目以及定位电脑上已有项目的地方。

本课中，你将创建第一个项目，并了解项目设置选项的实际作用。

Project Manager

主 Project Manager 标签页名为 Your Projects。

在列表顶部，你总能看到两个重要的缩略图：

• New Project：开始新项目设置。
• Browse Project...：从磁盘选择已存在的 Cave 项目文件夹。

下方显示 Cave 已知的项目，项目缩略图按最后写入时间排序，最近编辑的项目更易查找。

鼠标悬停项目缩略图可查看有用信息，比如：

• 项目使用的 Cave Engine 版本。
• 最后写入时间。
• 磁盘上的项目路径。
• 兼容性警告，若当前引擎版本无法安全打开该项目。

右键点击项目缩略图可见项目操作：

• Open Project：若项目有效且兼容，则打开。
• Reveal Project in Explorer：打开磁盘上的项目文件夹。
• Remove from Project Manager：从列表中移除项目，但不删除文件夹。
• Delete Project：永久删除项目文件夹。

请谨慎使用 Delete Project，它会从磁盘删除文件，Cave 不支持撤销。

旧项目和无效项目

Cave 会将项目分为几类。

当前项目是指用当前引擎版本制作的项目。

旧项目是用较旧 Cave 版本制作的兼容项目，Cave 可打开，但会先警告，因为用新版保存时可能迁移数据。打开重要旧项目前请先备份。

无效项目指无效的 Cave 项目文件夹或不兼容当前引擎版本的项目。

正常的 Cave 项目文件夹包含 Source 文件夹及其子文件夹 Source/Content。使用 Browse Project... 时，请选择项目根文件夹，而非其内部随机文件夹。

调整编辑器缩放

若界面看起来过小或过大，按住 Ctrl，滚动鼠标滚轮即可调整。

你也可以打开 Project Manager 中的 Font Settings 标签，调整 Editor Interface Scale，适用于高 DPI 显示器、笔记本、大屏幕或屏幕录制。

Cave 会保存你的编辑器缩放设置，无需每次手动调节。

打开已有项目

点击 Your Projects 中项目的缩略图可打开最近项目。

若项目未在列表中，点击 Browse Project...，选择项目主文件夹。若所选文件夹不是 Cave 项目，Cave 会提示路径无效。

若只想从 Project Manager 列表中移除项目，右键选择 Remove from Project Manager，不会删除磁盘上的项目。

创建新项目

点击 New Project 打开项目创建界面。

首先选择：

• Name：项目名称。
• Directory：项目文件夹创建位置。
• Game Mode：项目初始模板。

Cave 会用项目名称创建新文件夹。若目录使用默认位置，Cave 会在其编辑器数据文件夹创建项目：

Windows: %AppData%\Cave Engine\My Projects\
Linux:   ~/Cave Engine/My Projects/

首次创建项目时，使用简单名称并保持默认目录即可，除非你有特定项目文件夹结构需求。

设置选项

首次设置页面还包含 Setup Options 部分。

• Create .gitignore：创建推荐的 .gitignore 文件，方便版本控制。如果计划使用 Git，保持启用。
• Create AGENTS.md：为 AI 编程工具创建项目指导文件及 Cave 的辅助 CLI 文件。如果打算让 AI 助手帮助编写 Cave Python 脚本或检查项目结构，启用此项非常有用。

正常项目可同时启用这两个选项。

选择项目模板

Cave 目前提供四种起始游戏模式。

如果是新手且想快速体验 Cave，选择 Third Person Game 或 First Person Game。

若你对引擎已有扎实理解，想手动创建所有内容，选择 Empty Game。注意此模板不包含 Cave 的便利起始资产。

如果游戏设计需要俯视摄像机，选择 Top Down Game。

项目选项

点击 Options... 可在创建前自定义初始内容。

非空模板的 Base Game 部分包括：

• Health Bar Color：更改生成的玩家生命值条颜色。
• Procedural Sky：为起始关卡创建程序化天空纹理。
• Default Skybox：禁用程序化天空时使用的天空盒。
• Num Levels：创建多个起始场景，命名如 Level 1、Level 2 等。

Top Down Game 还提供 Point and Click 选项，启用后玩家可通过点击世界中的位置移动。

额外起始内容

Extras 部分控制可选玩法元素。

• Add Terrain (in the Levels)：创建带地形的关卡。禁用时，Cave 使用简单平面作为地面。
• Portal Template：创建可复用的传送门，当玩家触碰时传送到另一个关卡。生成的关卡会在关卡间自动放置传送门，且填充传送门的 scene 属性为下一个关卡名。
• Damage Template：创建简单的红色占位物体，碰触时造成玩家伤害。
• Vehicle Template：导入默认车辆资产，创建带物理的车辆模板。
• Add Enemies：创建起始敌人模板，并在每个生成关卡放置一些敌人实例。

这些选项是为节省时间，之后可删除、替换或扩展生成内容。

起始敌人

启用 Add Enemies 后，Cave 会创建一个名为 Enemy 的实体模板、一个 Enemy Python 脚本和一个名为 Enemy HSM 的状态机资产。

默认敌人设计得很简单：

• 具备 health 属性。
• 具备 wanderRadius 属性。
• 使用红色调的 Proto 角色网格。
• 使用角色组件处理移动和碰撞。
• 使用简易状态机实现行为。

起始状态机包含 Wander 状态，含子状态，随机选择等待或移动到随机可达位置；还有一个简单的 Flee 状态，当敌人失去生命时会启动。

这不是最终敌人 AI，而是可查看、测试并随游戏成长替换的示例。

菜单和界面设置

Menus 部分可生成常见游戏 UI 元素。

• Main Menu (Scene)：生成一个 Main Menu 场景，并设为游戏启动初始场景。包含开始游戏、查看制作名单和退出按钮。
• Pause Menu (Template)：创建可复用暂停系统实体模板，添加到每个生成关卡。默认支持玩家按 Escape 暂停、继续、重启、返回主菜单（如果存在）或退出游戏。

非空游戏模板还创建附着于玩家的游戏内 UI，包括生命值条、游戏结束菜单和关卡完成菜单。

Interface 部分控制生成 UI 的外观：

• 按钮样式：Flat Shaded 或 Gradient。
• 文字颜色。
• 基础按钮颜色。
• 悬停按钮颜色。
• 按下按钮颜色。

Initial Fonts 部分选择生成 UI 的常规和粗体字体。保持默认时，Cave 使用 Public Sans 默认字体。

Credits 部分允许你编辑生成制作名单界面中显示的文字。

创建项目

准备好后，点击 Create Project。

Cave 会创建项目文件夹、生成选中资产、保存项目并打开编辑器。

根据你的配置，新项目可能包含：

• 一个 Defaults 文件夹，含默认材质、网格、纹理、字体、UI 样式、天空盒和后期处理。
• 一个 Gameplay 文件夹，含模板和脚本如 Player、Pause Menu、Portal、Damage、Vehicle、Enemy 和 Enemy HSM。
• 一个或多个关卡场景。
• 如启用，则含有 Main Menu 场景。
• 一个 READ ME 文档资产，说明生成内容。

初看内容可能较多，但起始内容让你打开项目后立刻能看到实际内容，方便检视和试玩。

接下来做什么

项目打开后，你将进入主 Cave Editor 界面。

在下一课中，您将学习编辑器的布局：3D 视图、Scene Graph、Properties 标签页、Asset Browser、Console、Settings 标签页、Timeline 以及构建游戏时会用到的其他标签页。