跳到主要内容

开始使用

体验可执行的Demo​

TODO

选择你想要安装的引擎版本​

MooaToon本质上是需要修改引擎代码的插件, 且目前未支持移动平台, 所以你无法将游戏打包到移动平台.

安装预编译版引擎​

如果你是美术师, 只是想要试用MooaToon, 预编译版本是一个不错的选择.

预编译版本的优点是开箱即用, 无需等待引擎编译, 并且下载的内容最少, 运行的性能也最佳.

预编译版本的缺点是无法打包C++游戏, 不含调试信息, 并且每次微小的更新都需要重新下载整个包体.

依次执行以下步骤使用预编译版本:

  1. 下载安装工具并解压
  2. 双击运行: _0_0_Install_Latest_MooaToon_Precompiled_And_Override_All_Modified_Files.bat自动下载并解压
  3. 双击运行: _0_1_Run_MooaToon_Precompiled_Project.bat打开项目
警告
  1. 下载问题

由于服务基于Github, 对于中国大陆用户, 强烈推荐开启全局代理, 否则无法保证下载速度和稳定性.

如果无法用代理, 建议先运行脚本_2_4_Fetch_Fastest_Github_IPs.bat以在一定程度上提高下载速度.

  1. 运行问题

若启动项目时报错, 首先再次运行_0_0_Install_Latest_MooaToon_Precompiled_And_Override_All_Modified_Files.bat确保下载内容的完整性, 然后打开项目.

若问题没有解决, 请下载并运行修复工具, 重启电脑后再次打开项目.

你也可以使用脚本_0_0_Install_Latest_MooaToon_Precompiled_And_Override_All_Modified_Files.bat更新MooaToon, 所有已修改的文件都会被覆盖, 新增的文件如果不和MooaToon文件重名就不会被覆盖.

从源码编译引擎​

如果你想获得完整的引擎功能, 以及更快的更新速度, 请参考:

从源码编译引擎

选择UE版本​

你可以编辑_2_5_Settings.bat选择想要安装的UE版本:

  1. 右键_2_5_Settings.bat, 选择编辑

  2. 将engineBranchName和projectBranchName字段中的UE版本改为你想安装的版本, 比如5.1:

    set engineBranchName=5.1
    set projectBranchName=5.1_MooaToonProject

  3. 保存并再次执行安装流程

警告

你可以选择使用旧版本, 但旧版本可能不会包含最新的功能或修复.

(可选) 安装Ultra Dynamic Sky​

类似L_TimeOfDay_Require_UltraDynamicSky的关卡需要您自行购买并安装Ultra Dynamic Sky插件以获得对动态天气系统的支持:

文件目录结构​

  • 预编译版
MooaToon ----------------------------------- 根目录
 ├-MooaToon-Engine-Precompiled ------------- 引擎安装目录
 │  ├-Windows\Engine\Plugins\MooaToon ------ MooaToon引擎插件目录
 │  └-Windows\Engine\Binaries\Win64 -------- 引擎可执行文件目录
 │    └-UnrealEditor.exe ------------------- 引擎可执行文件
 ├-MooaToon-Project-Precompiled ------------ 项目安装目录
 │  ├-Art ---------------------------------- 美术资源文件目录
 │  ├-Config ------------------------------- 项目设置目录
 │  ├-Content ------------------------------ 项目内容目录
 │  │  ├-Global ---------------------------- MooaToonSamples依赖的资源
 │  │  └-MooaToonSamples ------------------- MooaToon的所有示例, 可以删除
 │  └-MooaToon_Project.uproject ------------ 项目文件
 │
 ...
  • 源码版本
MooaToon ----------------------------------- 根目录
 ├-MooaToon-Engine ------------------------- 引擎安装目录
 │  ├-Engine\Plugins\MooaToon -------------- MooaToon引擎插件目录
 │  └-Engine\Binaries\Win64 ---------------- 引擎可执行文件目录
 │    └-UnrealEditor.exe ------------------- 引擎可执行文件
 ├-MooaToon-Project ------------------------ 项目安装目录
 │  ├-Art ---------------------------------- 美术资源文件目录
 │  ├-Config ------------------------------- 项目设置目录
 │  ├-Content ------------------------------ 项目内容目录
 │  │  ├-Global ---------------------------- MooaToonSamples依赖的资源
 │  │  └-MooaToonSamples ------------------- MooaToon的所有示例, 可以删除
 │  └-MooaToon_Project.uproject ------------ 项目文件
 │
 ...

在现有项目中使用MooaToon​

你可以使用MooaToon引擎打开你自己的项目.

确认现有项目版本和MooaToon引擎版本​

你可以通过MooaToon的Github仓库分支名称和Release名称判断MooaToon的引擎版本.

如果你的项目使用的引擎版本低于MooaToon引擎版本, 则会被要求升级到MooaToon引擎版本.

如果你的项目使用的引擎版本高于MooaToon引擎版本, 则无法打开.

复制MooaToon示例文件到现有项目​

复制以下示例文件夹到你的项目的Content目录内:

  • 预编译版本

    • MooaToon\MooaToon-Project-Precompiled\Content\Global
    • MooaToon\MooaToon-Project-Precompiled\Content\MooaToonSamples

  • 源码版本

    • MooaToon\MooaToon-Project\Content\Global
    • MooaToon\MooaToon-Project\Content\MooaToonSamples

使用MooaToon引擎打开现有项目​

找到并执行引擎可执行文件:

  • 预编译版本

    • MooaToon\MooaToon-Engine-Precompiled\Windows\Engine\Binaries\Win64\UnrealEditor.exe

  • 源码版本

    • MooaToon\MooaToon-Engine\Engine\Binaries\Win64\UnrealEditor.exe
提示

你可以右键引擎可执行文件并固定到开始菜单, 或创建桌面快捷方式, 这样就不用每次手动查找了.

随后在项目浏览器中打开你自己的项目.

警告

如果你的项目依赖了其他引擎插件, 这里需要手动复制这些插件到MooaToon引擎的插件目录:

  • 预编译版本

    • MooaToon\MooaToon-Engine-Precompiled\Windows\Engine\Plugins

  • 源码版本

    • MooaToon\MooaToon-Engine\Engine\Plugins

检查项目设置​

如果要使用完整的MooaToon的功能, 以下项目设置必须打开:

  • Renderding > Dynamic Global Illumination Method: Lumen
  • Renderding > Ray Traced Shadows

另外以下命令修复了一些UE的渲染问题, 推荐添加到你的项目的Config\DefaultEngine.ini中:

  • r.RayTracing.Shadows.AvoidSelfIntersectionTraceDistance=0.5

现在你可以检查MooaToon的示例, 并在自己的项目中使用Toon材质了.