Skip to main content

Unity & Warudo SDK 安装

该页面将引导您逐步安装 Unity Editor 和 Warudo SDK。

信息

目前仅支持 64 位 Windows 系统。

Step 1 - 安装 Unity Hub​

首先，你需要下载 Unity Hub（一般最新版本即可）。
Unity Hub 是用于管理不同版本的 Unity Editor 和不同版本的项目的软件。

打开 Unity 官网 可在下图中两个红框处选一点击，下载可能需要注册 Unity 帐号。

运行下载好的 UnityHubSteup.exe，安装到你习惯的路径。
安装完毕后，确认可以正确打开。

登录后会自动建议你下载最新的长期支持版本 (Long-Term Support, LTS) Unity Editor，
Warudo 不使用该版本，建议点击 Skip installation。

但是如果你确实想要安装该版本，也强烈建议将安装路径更改为 ...\<版本号> （例如 D:\Softwares\Unity\2021.3.18f1），
更方面后续管理多版本的 Unity Editor，
而不要使用默认的安装路径 C:\Program Files\Unity\Hub\Editor 。

如果你满足 Unity 的 Person Edition 条款，可以在此处选择激活并获取个人版许可证。

如果你在上一步跳过了激活或者激活失败，也可以后续在 Unity Hub 中手动激活许可证。

你可以在【偏好设置 (Preferences)】-【外观 (Appearance)】中更改 Unity Hub 的语言。

Step 2 - 安装 Unity Editor​

接下来，你需要下载 Unity Editor 的安装包，且版本必须严格为 2021.3.45f2 。

此特定补丁版本是与 Warudo SDK 兼容所必需的，不可替代。安装方法如下：

  1. 前往 Unity Download Archive ；
  2. 在 【2021】 选项卡 下，找到版本【2021.3.45f2 (2025年10月3日)】 ；
  3. 点击 【INSTALL】；
  4. 浏览器会尝试打开 Unity Hub，选择“打开Unity Hub”；
  5. 在打开的 Unity Hub 窗口中，点击“继续”，然后点击“安装”；
  6. 安装过程可能需要较长时间，请耐心等待。

如果步骤 4 失败或您想手动安装，请返回步骤 2，然后：

  1. 点击“See all”；
  2. 点击“Windows”下载安装程序（文件名类似于 UnitySetup64-2021.3.45f2.exe，大小约为 3-4 GiB）；
  3. 运行下载的安装程序开始安装。 默认安装位置可能是 C:\Program Files\Unity 2021.3.45f2；您可以更改安装位置，但我们建议在路径中包含版本号（例如 D:\Softwares\Unity\2021.3.45f2），以便在管理多个 Unity 版本时避免混淆。 安装过程可能需要较长时间，请耐心等待。
  4. 安装完成后：打开 Unity Hub；
  5. 点击【安装 (Installs)】-【选择位置 (Locate)】；
  6. 找到刚才选择的安装路径，然后进入【Editor】子文件夹，找到【Unity.exe】；
  7. 选择后点击【选择编辑器 (Select Editor)】。

完成以上步骤后，所需的 Unity 版本（2021.3.45f2）应该会出现在 Unity Hub 中。

如果你发现安装到的版本带有 c1 后缀，代表你下载到了地区版本，但该区别通常不会影响使用。
你可以尝试使用上文的 exe 安装方法进行安装避免该版本。

Step 3 - 下载并导入 Warudo SDK​

在 Unity 中设置 Warudo SDK 有两种方法：

  • 使用 Unity Package Manager 导入
  • 下载我们的模组项目模板

我们推荐第一个选项，因为它可以轻易保持您的工程与 Warudo Mod SDK 的最新版本同步。
如果您与 Github 之间连接不佳，可以尝试使用第二个选项。

方法一 使用 Unity Package Manager 导入（推荐）​

提示

使用该方法可以保持您的工程与 Warudo Mod SDK 的最新版本同步。

首先，需要确认 File → Build Settings... → Player Settings... → Other Settings 中的 Api Compatibility Level 被设置为 .NET Framework，并将 Assembly Version Validation 取消选中。 (该设置也可以通过 Edit → Project Settings → Player → Other Settings 到达)

打开 Unity 项目后，点击菜单栏上的 Window → Package Manager 。在 Package Manager 窗口中，点击左上角的 + 按钮，选择 Add package from git URL... 。 在弹出的对话框中，输入以下 URL：

https://github.com/HakuyaLabs/Warudo-Mod-Tool.git#0.14.3.10

如果您与 Github 之间的网络连接不佳，也可以下载该仓库的 tarball 文件：

Warudo-Mod-Tool-0.14.3.10.tgz

并在 Package Manager 中选择 Add package from tarball... 进行导入。

点击 Add 按钮，Unity 将开始从 GitHub 下载并安装 Warudo SDK 包。如果弹出询问 Prebuilt packages 的对话框或转换文件，选择 Yes 。返回 Unity 等待加载完成。

注意

如果您遇到消息错误 An error occurred while resolving packages / Error adding package， 单击它会显示类似以下内容的消息： No 'git' executable was found. Please install Git on your system then restart Unity and Unity Hub， 这意味着您的系统上尚未安装 Git。 要解决此问题，您需要从 https://git-scm.com/download 下载 Git，然后重新启动 Unity 和 Unity Hub。

方法二 直接导入模板项目​

Warudo SDK 0.14.3.10 Modding Project.zip

  1. 下载 以上项目压缩包并将内容 解压 到自定义位置，例如 D:\Softwares\Unity\2021.3.45f2\Projects\WarudoModding ；
  2. 打开 【Unity Hub】，在【Projects】中选择【Open】；
  3. 找到刚才解压出来的文件夹并且打开，点击【Open】；
  4. 此时，【Warudo SDK 0.14.3.10 Modding Project】就会出现在 Projects 列表中，并且分配正确的版本号；
    （如果此时在版本号右侧出现了黄色感叹号，说明项目存在问题，建议重新检查第二步是否安装了完全一致的版本号。）
  5. Unity 此时可能会自动开始打开该项目，第一次打开可能会进行 Importing，会消耗一段时间，请耐心等待。

成功打开之后，顶部会出现【Warudo】选项卡，Assets 文件夹中会出现【Warudo】和【Warudo SDK】文件夹。

点击打开下方通知栏，可能会出现少数【warning】，是正常现象。但是请检查是否存在【Error】。

如果没有 Error，那么一切都准备好了！你可以开始 创建你的第一个模组 了！

提示

如果您在控制台中看到 Error，请尝试单击 “Clear” 以查看是否可以删除这些错误。
如果仍然存在问题，请通过 Discord 或者 QQ 频道 与我们联系。

注意

如果您要导入到已经存在的项目安装了以下任一项：

请取消选中导入的相应文件夹，否则您的组件将被 stub files 替换：

  • Packages/DynamicBone
  • Plugins/RootMotion/FinalIK
  • Plugins/RootMotion/PuppetMaster

点击打开下方通知栏，检查是否存在【Error】。

如果没有，那么一切都准备好了！你可以开始 创建你的第一个模组 了！

提示

如果您在控制台中看到 Error，请尝试单击 “Clear” 以查看是否可以删除这些错误。
如果仍然存在问题，请通过 Discord 或者 QQ 频道 与我们联系。

版本历史​

Warudo SDK 0.14.3.10 (Latest)​

Warudo SDK 0.12.0​

贡献者

Edit on Github

作者

HakuyaTira
Hane

翻译者

Hane
上次更新于 2026.02.28