跳到主要内容

安装

本指南将引导你将 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 导入

  1. 在浏览器中打开 Unity Asset Store,或在编辑器中通过 Window > Asset Store 打开。
  2. 搜索 "Monster Capture Engine""OpenMon MCE"
  3. 购买适合你项目的版本(Lite、Basic、Pro、Online 或 Source)。
  4. 在 Unity 中,打开 Window > Package Manager
  5. 从下拉菜单中选择 My Assets,找到 Monster Capture Engine,然后点击 Import
  6. 出现提示时导入所有文件。包将安装到 Assets/OpenMon/ 目录下。
替代方案:Unity 资源包文件

如果你收到的 MCE 是 .unitypackage 文件,只需将其拖入项目窗口,或使用 Assets > Import Package > Custom Package 并选择该文件即可。

步骤 2:URP 设置

如果你的项目尚未使用 URP,你需要进行设置:

  1. 从 Package Manager 安装 URP:Window > Package Manager > Unity Registry > Universal RP
  2. 创建 URP Asset:Assets > Create > Rendering > URP Asset (with Universal Renderer)
  3. Edit > Project Settings > Graphics > Scriptable Render Pipeline Settings 中进行分配。
  4. 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:验证安装

要验证一切正常工作:

  1. 打开演示场景 Assets/OpenMon/Scenes/DemoScene(如果你的版本包含此场景)。
  2. 在 Unity 编辑器中按下 Play
  3. 你应该能看到 MCE 初始化流程,随后进入游戏世界。

如果在控制台中看到错误:

  • 检查 URP 是否已正确配置(最常见的问题)。
  • 确保你从包中导入了所有文件。
  • 运行 MCE > Tools > Asset Validation 检查数据库完整性。

下一步

你已准备好开始构建。前往下一篇指南创建你的第一只怪兽: