RPG Maker Unite 安装全流程：从 Epic 到 Unity Hub 完整指南

1. 为什么这套安装流程值得单独写一篇

RPG Maker Unite 这个工具从公布那天起就自带话题度——它是 RPG Maker 系列第一次真正意义上跟 Unity 生态深度绑定。以前做 RPG Maker 项目，你打开的是一个封闭的编辑器，素材、事件、数据库全在它自己的框架里转；而 Unite 把整个运行时搬到了 Unity 上，意味着你既可以用 RPG Maker 那套熟悉的数据库和事件系统快速搭出 RPG 骨架，又能在 Unity 里接 C# 脚本、接第三方插件、接自定义渲染管线。这个定位直接决定了它的安装方式跟历代 RPG Maker 都不一样：它不是下载一个 exe 双击就完事，而是要走 Epic 游戏商城拿资源包，再通过 Unity Hub 挂到具体 Unity 版本上。

我身边不少朋友第一次装的时候都卡在中间某一步，有人 Epic 账号登不上，有人 Unity Hub 里死活找不到 Unite 的模板，还有人装完了打开发现版本对不上直接报错。这些坑其实都不难，但没人把完整链路讲清楚的时候，你就是在黑暗里摸开关。这篇就把 Epic 端到 Unity Hub 端的完整流程拆开讲，顺带把每一步背后的原因说透，让你装完之后不仅知道怎么装，还知道为什么这么装。适合完全没碰过 Unity 的新手，也适合用过旧版 RPG Maker、第一次迁移到 Unite 的老用户。

2. 装之前先把这三件事想明白

2.1 Unite 的发行方式决定了它必须走 Epic

RPG Maker Unite 没有在 Steam 上架，也没有独立官网下载渠道，它的数字版是通过 Epic Games Store 发行的。这个选择背后有商业层面的考量，但对用户来说只有一个直接后果：你必须有一个 Epic 账号，并且要通过 Epic 的客户端或者网页端完成购买和入库。很多人习惯性地去搜“RPG Maker Unite 下载”，结果搜到一堆第三方站点，那些要么是过时信息，要么就是挂着广告的跳转页，真正靠谱的入口只有 Epic 官方商城。

这里有个细节值得注意：Epic 上架的 Unite 本质上是一个“资源包 + 授权”的组合，你买到的是一个可以导入 Unity 的项目模板和运行时库，而不是一个独立可执行程序。所以你在 Epic 客户端里点“安装”的时候，它并不会像装普通游戏那样给你一个启动图标，而是把文件放到一个你指定的目录里，等着 Unity Hub 去识别。理解这一点，后面很多步骤就顺了。

2.2 Unity Hub 是版本管理的枢纽，不是可选项

Unity 的安装体系跟一般软件不一样，它允许多个编辑器版本共存，而 Unity Hub 就是管理这些版本的中枢。RPG Maker Unite 对 Unity 版本有明确要求，官方文档里写的是基于 Unity 2022.3 LTS 构建，这意味着你不能随便拿一个 Unity 2021 或者 2023 的版本去挂它。Unity Hub 的作用就是让你精确地安装指定版本，并且在创建项目时选择正确的模板。

如果你之前电脑里已经装过 Unity，但没有通过 Hub 管理，那大概率会出现版本混乱的情况。我的建议是，不管你现在有没有 Unity，都先把 Unity Hub 装好，然后用 Hub 去统一管理所有版本。这样后面 Unite 需要哪个版本，你直接在 Hub 里点一下就能装，不用去官网翻历史版本页面。

2.3 账号体系要提前理清，别到中途卡住

整个流程涉及两个账号：Epic 账号和 Unity 账号。Epic 账号用来获取 Unite 资源包，Unity 账号用来激活 Unity 编辑器和 Hub 的许可证。这两个账号本身不冲突，但如果你之前从来没注册过，建议在开始安装之前就先把它们都注册好并完成邮箱验证。我遇到过有人在 Epic 客户端里买完了，结果 Unity Hub 登录时发现账号没验证，又回头去弄邮箱，中间隔了半小时，心态直接崩了。

另外，Epic 客户端在某些网络环境下登录会比较慢，这是正常现象，不用反复重试，等它转完就行。如果你实在登不上，可以先用网页版 Epic 商城把 Unite 入库，然后再打开客户端，这样能绕过一部分登录环节。

3. Epic 端：从购买到落盘的全过程

3.1 在 Epic 商城找到正确的 Unite 条目

打开 Epic Games Launcher 之后，在商城搜索框里输入“RPG Maker Unite”，注意看结果里是不是有“RPG Maker Unite”和“RPG Maker Unite Sample”之类的区分。正式版就是叫“RPG Maker Unite”，别点错到 DLC 或者素材包上。点进去之后，页面会显示它的价格和当前状态，如果你还没买，就正常走购买流程；如果已经买过了，按钮会显示“已在库中”。

这里有个小技巧：Epic 商城偶尔会有优惠券或者促销活动，Unite 本身价格不算低，如果你不急着用，可以等一等。但如果你现在就要开始学，那就直接买，别为了等折扣耽误时间。买完之后，它不会自动下载，你需要手动去库里找到它并点击安装。

3.2 安装路径的选择直接影响后续识别

点安装之后，Epic 会问你装到哪个目录。这个目录很关键，因为 Unity Hub 在添加项目模板时，需要你指向这个目录里的特定文件夹。默认路径一般在C:\Program Files\Epic Games\RPGMakerUnite这种位置，但我不建议用默认路径，原因有两个：一是 C 盘空间容易被占满，二是某些系统权限设置会导致 Unity Hub 读取失败。

我自己的做法是专门建一个目录，比如D:\GameDev\Epic\RPGMakerUnite，路径里不要有中文和空格。这一点非常重要，Unity 对中文路径的支持一直不太稳定，虽然新版本有所改善，但为了避免玄学问题，全程用英文路径是最稳妥的。安装过程本身很快，因为 Unite 的资源包体积不算特别大，几分钟就能完成。

3.3 装完之后先别急着关，确认文件结构

安装完成后，打开你刚才指定的目录，你应该能看到类似这样的结构：

RPGMakerUnite/ ├── RPGMakerUnite/ │ ├── Assets/ │ ├── Packages/ │ ├── ProjectSettings/ │ └── ... ├── UnityPackage/ └── ...

其中RPGMakerUnite这个子文件夹就是一个完整的 Unity 项目结构，里面有Assets、Packages、ProjectSettings这些标准目录。而UnityPackage文件夹里通常放的是需要额外导入的包文件。你要记住这个RPGMakerUnite子文件夹的完整路径，因为后面在 Unity Hub 里添加项目时，就是要指向它。

注意：如果你在 Epic 安装目录里看到的是一堆散乱的文件，没有明确的Assets文件夹，那可能是安装没完成或者下载出错了。这时候别硬着头皮往下走，先在 Epic 客户端里右键选择“验证”或者“修复”，让它重新检查一遍文件完整性。

4. Unity Hub 端：版本、许可证与项目挂载

4.1 安装 Unity Hub 并登录账号

Unity Hub 的下载入口在 Unity 官网，直接搜“Unity Hub download”就能找到。下载之后正常安装，装完打开，它会要求你登录 Unity 账号。如果你还没有账号，点注册，用邮箱注册一个就行。登录之后，Hub 会显示一个欢迎界面，左边是项目列表，右边是安装管理。

这里有个新手容易困惑的地方：Unity Hub 本身不包含 Unity 编辑器，它只是一个管理工具。所以你登录之后看到的界面是空的，没有任何版本，这是正常的。你需要手动去安装至少一个 Unity 编辑器版本，才能开始创建项目。

4.2 安装正确的 Unity 版本

RPG Maker Unite 官方要求的是 Unity 2022.3 LTS 系列。在 Unity Hub 左侧点击“安装”，然后点“安装编辑器”，会弹出一个版本列表。找到2022.3开头的 LTS 版本，选一个最新的小版本号，比如2022.3.20f1这种。不要选2023或者2021，版本不匹配会导致 Unite 项目打开时报错。

在安装选项中，Hub 会问你要不要附带安装一些模块，比如 Android Build Support、iOS Build Support、WebGL 等。如果你只是做 PC 端的 RPG，这些都不需要勾选，只保留默认的即可。但有一个模块建议勾上：Microsoft Visual Studio Community或者你已有的代码编辑器集成，因为 Unite 支持 C# 脚本，后面你可能会需要写代码。如果你已经有 VS Code 或者 Rider，那就不用勾，Hub 会自动识别。

安装过程视网速而定，通常要十几分钟到半小时。装完之后，在 Hub 的“安装”列表里就能看到这个版本了。

4.3 添加 Unite 项目到 Hub

版本装好之后，回到 Hub 的“项目”页面，点击“添加”按钮，然后浏览到你刚才 Epic 安装目录下的RPGMakerUnite子文件夹。选中它，Hub 会识别出这是一个 Unity 项目，并把它加到项目列表里。这时候你会在项目卡片上看到它关联的 Unity 版本号，如果显示的是你刚装的2022.3.x，那就对了。

如果 Hub 提示“项目版本不匹配”或者“无法识别”，大概率是两个原因：一是你指向的目录不对，应该指向包含Assets和ProjectSettings的那一层；二是你装的 Unity 版本跟项目要求的版本差距太大。这时候你可以右键项目卡片，选择“在编辑器中打开”，Hub 会尝试用你已安装的版本去打开，如果版本兼容，它会自动升级项目文件；如果不兼容，它会明确告诉你需要哪个版本。

提示：在添加项目之前，建议先关闭 Epic 客户端，避免文件被占用导致 Hub 读取失败。这个坑我踩过，当时折腾了二十分钟才发现是 Epic 在后台锁着文件。

4.4 首次打开项目的等待与验证

双击项目卡片，Unity 编辑器会启动并加载 Unite 项目。第一次打开会比较慢，因为 Unity 需要导入所有资源、编译脚本、生成库文件。这个过程可能持续五到十分钟，取决于你的电脑配置。期间你会看到进度条和一堆日志输出，只要没有红色报错，就耐心等。

加载完成后，你应该能看到 Unity 的标准界面，并且在 Project 窗口里看到 RPG Maker Unite 相关的文件夹结构。如果这时候弹出一个“API Update Required”的窗口，选择“I Made a Backup, Go Ahead”让它自动升级即可。这是 Unity 版本差异导致的正常现象，不是错误。

5. 装完之后怎么验证真的能用了

5.1 检查模板和示例场景是否完整

项目打开后，在 Project 窗口里找到Assets目录，里面应该有一个RPGMakerUnite或者类似的文件夹。点进去，看看有没有Scenes、Prefabs、Scripts这些子目录。如果能看到一个示例场景文件，双击打开它，Unity 的 Scene 视图里应该会显示一个基础的 RPG 地图或者角色。这就说明 Unite 的运行时和资源都正确导入了。

如果 Project 窗口里空空如也，或者只有几个不相关的文件夹，那可能是 Epic 安装时文件没下全。回到 Epic 客户端，找到 Unite，右键选择“管理”或者“验证”，让它重新校验一遍文件。校验完成后，再回到 Unity Hub 里重新打开项目。

5.2 跑一次播放模式看有没有报错

在 Unity 编辑器顶部工具栏找到播放按钮（三角形图标），点一下，让项目进入运行模式。如果一切正常，Game 视图里应该会出现 Unite 的默认启动画面或者示例场景。如果 Console 窗口里刷出一堆红色报错，先别慌，看看报错内容是什么。常见的报错有两类：一类是缺少某个包，比如com.unity.inputsystem没装；另一类是脚本编译错误，通常是因为 Unity 版本跟 Unite 要求的版本有细微差异。

对于缺少包的情况，打开Window > Package Manager，在列表里找到对应的包，点安装就行。对于脚本编译错误，先检查你的 Unity 版本是不是严格符合官方要求，如果版本对了还报错，可以去 Unite 的官方论坛或者社区搜一下报错关键词，大概率有人遇到过同样的问题。

5.3 确认授权状态和可发布性

RPG Maker Unite 的授权是跟 Epic 账号绑定的，你在 Unity 里打开项目时，它会在后台验证你的授权状态。如果你在 Editor 里看到某个角落显示“License: Valid”或者类似的字样，那就说明授权没问题。如果显示“Trial”或者“Unlicensed”，那可能是 Epic 账号和 Unity 账号没有正确关联，或者你用的 Unite 版本跟账号不匹配。

这一步对于只是想学习的人来说不是必须的，但如果你打算把做出来的东西发布出去，那就必须确保授权状态正常。发布之前，建议在 Unity 的File > Build Settings里切换到你目标平台，然后跑一次构建，看看能不能成功生成可执行文件。构建成功且运行正常，才算真正把整套流程跑通了。

6. 常见问题速查与避坑经验

6.1 Epic 登录转圈、下载卡住怎么办

Epic 客户端在国内网络环境下登录慢是常态，不用反复重启客户端。我的经验是，先打开网页版 Epic 商城，登录账号，把 Unite 入库，然后再打开客户端。客户端启动后如果还在转圈，等它转，一般两三分钟会好。如果超过五分钟还没动静，可以尝试切换网络环境，比如从 WiFi 切到有线，或者用手机热点试一下。下载卡住的话，在 Epic 设置里把下载限速关掉，有时候限速设置会误触发。

6.2 Unity Hub 找不到项目或者版本不匹配

这个问题九成是因为路径指错了。Unity Hub 添加项目时，必须指向包含ProjectSettings文件夹的那一层。如果你指向了它的上一级或者下一级，Hub 就识别不出来。另外，如果你装了多个 Unity 版本，Hub 可能会默认用最新版打开，这时候需要手动在项目卡片上右键，选择“Open with”，然后指定2022.3那个版本。

6.3 打开项目后 Console 报一堆红字

先看报错的第一条，往往第一条才是根因，后面的都是连锁反应。常见的根因包括：Unity 版本不对、缺少 Input System 包、脚本编译顺序问题。如果是 Input System 的问题，去 Package Manager 里装上Input System，然后重启 Unity。如果是版本问题，老老实实去 Hub 里装官方要求的那个版本，别想着用相近版本糊弄过去。

6.4 项目能打开但播放模式没反应

这种情况通常是场景没有正确加载。检查一下 Hierarchy 窗口里有没有摄像机、有没有 Unite 的启动脚本挂载。如果 Hierarchy 是空的，说明你打开的场景不对，去 Project 窗口里找Scenes文件夹，双击里面的场景文件。如果场景里有东西但播放没反应，检查一下脚本组件是不是被禁用了，或者 Console 里有没有运行时异常。

6.5 磁盘空间和路径命名的坑

Unity 项目加上 Unite 的资源包，整体占用大概在 5 到 10 GB 左右，如果你还要装多个 Unity 版本，C 盘很容易爆。建议从一开始就把 Epic 安装目录和 Unity 项目目录都放在非系统盘。路径命名全程用英文，不要有空格和特殊符号。我见过有人把项目放在“我的文档/游戏开发/”下面，结果 Unity 各种诡异报错，换成纯英文路径之后全部消失。

问题现象	最可能原因	解决动作
Epic 登录一直转圈	网络环境导致	先用网页版入库，再开客户端
Hub 添加项目失败	路径指向错误	指向含 ProjectSettings 的文件夹
打开项目报版本错误	Unity 版本不匹配	安装 2022.3 LTS 系列
Console 刷红字	缺包或版本差异	装 Input System，核对版本
播放模式无反应	场景未加载	手动打开 Scenes 下的场景文件
构建失败	授权或平台模块缺失	检查授权状态，装对应平台模块

7. 我自己的安装习惯和后续建议

我现在装任何 Unity 相关的工具，都会先做一件事：建一个专门的GameDev目录，里面再按引擎和项目分文件夹。Epic 的安装目录、Unity Hub 的默认项目目录、以及各种资源包的存放目录，全部在这个根目录下面。这样做的好处是，以后不管装多少版本、多少工具，都不会乱，备份和迁移也方便。RPG Maker Unite 的安装过程本身不复杂，但它涉及两个平台、两个账号、多个版本，任何一个环节出问题都会让你卡住。把目录结构先规划好，能省掉后面很多麻烦。

另外，如果你打算长期用 Unite 做项目，建议在第一次成功打开项目之后，立刻做一个完整的项目备份，把整个RPGMakerUnite文件夹复制一份到别的盘。因为后面你可能会升级 Unity 版本、装各种插件，万一搞崩了，有一个干净的初始状态可以回退。这个习惯我在做任何引擎的项目时都会保持，实测下来能救命。

最后说一个我踩过的坑：Unity Hub 有时候会提示你升级项目版本，如果你点了升级，而 Unite 的运行时还没有适配新版本，就会导致一堆兼容性问题。所以除非官方明确说支持某个新版本，否则不要主动升级项目版本。保持跟官方要求一致的版本，是最稳的做法。