安装
本指南将引导你将 MCE 导入 Unity 项目并完成首次设置。
前提条件
在开始之前,请确保你已准备好:
- Unity 6 LTS(版本
6000.3.x或更高)已通过 Unity Hub 安装。 - 通用渲染管线 (URP) -- MCE 的渲染系统需要 URP。
- 一个以 URP 为目标的全新或现有 Unity 项目。
Unity 版本
MCE 在 Unity 6 LTS(6000.3.8f1)上构建和测试。不支持较早的 Unity 版本(2022 LTS、2021 LTS)。使用不同的 Unity 6 补丁版本应当可以工作,但建议使用 LTS 通道以保持稳定性。
步骤 1:从 Asset Store 导入
- 在浏览器中打开 Unity Asset Store,或在编辑器中通过
Window > Asset Store打开。 - 搜索 "Monster Capture Engine" 或 "OpenMon MCE"。
- 购买适合你项目的版本(Lite、Basic、Pro、Online 或 Source)。
- 在 Unity 中,打开
Window > Package Manager。 - 从下拉菜单中选择 My Assets,找到 Monster Capture Engine,然后点击 Import。
- 出现提示时导入所有文件。包将安装到
Assets/OpenMon/目录下。
替代方案:Unity 资源包文件
如果你收到的 MCE 是 .unitypackage 文件,只需将其拖入项目窗口,或使用 Assets > Import Package > Custom Package 并选择该文件即可。
步骤 2:URP 设置
如果你的项目尚未使用 URP,你需要进行设置:
- 从 Package Manager 安装 URP:
Window > Package Manager > Unity Registry > Universal RP。 - 创建 URP Asset:
Assets > Create > Rendering > URP Asset (with Universal Renderer)。 - 在
Edit > Project Settings > Graphics > Scriptable Render Pipeline Settings中进行分配。 - 在
Edit > Project Settings > Quality > Rendering中为每个质量级别进行分配。
MCE 包含用于昼夜光照和天气效果的自定义 URP 着色器,这些着色器需要 URP 才能正常工作。
步骤 3:首次设置向导
在导入 MCE 后首次打开场景时,首次设置向导将自动出现。如果没有出现,请从菜单手动启动:
MCE > Tools > Setup Wizard
向导处理以下内容:
- 语言选择 -- 选择你的开发语言(影响编辑器 UI 和默认本地化)。
- 数据库初始化 -- 如果所需的 ScriptableObject 数据库不存在,则创建它们。
- 输入配置 -- 设置键盘和手柄的默认输入绑定。
- 场景配置 -- 验证场景设 置并创建任何缺失的必要 GameObject。
按照向导中的每个步骤操作。完成后,你将看到确认消息,随即可以开始工作。
项目结构
导入后,你的项目将包含以下结构:
Assets/
OpenMon/
Core/
Runtime/ # 核心引擎代码(战斗、怪兽、世界、存档、UI)
Actors/ # NPC 系统和 CommandGraph 脚本
Battle/ # 战斗系统,包含 15+ 个模块化组件
Characters/ # 玩家和 NPC 角色控制器
Configuration/ # 游戏配置 ScriptableObject
GameFlow/ # 游戏状态管理
Initialization/ # 引擎启动和首次设置
Monster/ # MonsterInstance、Roster、进化、繁殖
MonsterDatabase/ # 怪兽/招式/道具/特性 ScriptableObject 定义
MonsterDex/ # 怪兽图鉴追踪系统
Player/ # 玩家状态(GlobalGameData)
Quests/ # 任务系统(Pro 版本+)
Rendering/ # URP 着色器和渲染辅助工具
Saves/ # 存档/读档系统
SDK/ # 公共 API 接口
UI/ # 所有 UI 控制器和预制体
World/ # 网格系统、地块、遭遇、地图
Editor/ # 仅编辑器工具
ArtGenerator/ # AI 精灵图生成(Basic 版本+)
MonsterCreator/ # 怪兽创建向导
Tools/ # 数据库浏览器、属性表编辑器、验证器
Art/ # 内置美术资源
版本差异
并非每个版本都包含所有文件夹。例如,Editor/ArtGenerator/ 仅在 Basic 版本及以上可用。Runtime/SDK/ 文件夹包含所有版本(包括 Lite)均可使用的公共 API 接口。
步骤 4:验证安装
要验证一切正常工作:
- 打开演示场景
Assets/OpenMon/Scenes/DemoScene(如果你的版本包含此场景)。 - 在 Unity 编辑器中按下 Play。
- 你应该能看到 MCE 初始化流程,随后进入游戏世界。
如果在控制台中看到错误:
- 检查 URP 是否已正确配置(最常见的问题)。
- 确保你从包中导入了所有文件。
- 运行
MCE > Tools > Asset Validation检查数据库完整性。
下一步
你已准备好开始构建。前往下一篇指南创建你的第一只怪兽: