跳到主要内容

从源码编译引擎

取决于你的网络带宽和CPU性能, 整个安装过程需要数小时, 请稍安勿躁. 如果过程中有无法解决的问题可以提交Issues.

请根据你的经验选择对应教程:

- 普通用户​

关联账号​

在开始之前, 你需要Epic账号和Github账号, 如果没有请前往注册. 然后:

  1. 然后前往该链接, 按照文中指示将Github账号关联到Epic账号.

  2. 返回Github, 前往Your Organizations, 接受Epic的邀请加入组织:

    image-20230211012706604image-20230211012747318
警告
  • 如果接受邀请后无法在组织中找到EpicGames, 请尝试重新登录GitHub账号.
  • Epic近期调整过Github组织架构, 如果发现Github项目链接无法访问, 请检查Github账号是否成功加入EpicGames组织, 并尝试重新关联账号.

下载MooaToon安装工具​

下载安装工具的Zip, 解压到硬盘根目录, 如D:\MooaToon(目的是避免路径过长引起编译错误), 强烈建议至少保留200GB的SSD硬盘空间.

然后可以开始安装过程.

使用工具自动安装​

依次执行:

  1. 运行_1_1_Install_Git.bat以默认设置安装Git
  2. 运行_1_2_Install_VisualStudio.bat以默认设置安装Visual Studio
  3. 保存你的工作内容, 运行_1_3_Restart_Computer.bat重启电脑
  4. 运行_2_0_Install_And_Run_MooaToon.bat按照提示登录Github账号, 等待下载和编译完成, 这可能需要1到3小时
    1. 中国大陆的用户请根据提示开启全局代理, 否则可能遇到网络问题
  5. 一切完成后, 项目将自动打开

检查项目​

启动项目后, 请耐心等待Shader编译完成, 随后你应该看到类似以下界面:

image-20230211012812909

在Content\MooaToonSamples\Maps目录可以找到所有示例关卡:

image-20230211002432647

随意探索一下吧.

获取更新​

你可以订阅MooaToon-Engine仓库以得知是否有更新, 并通过_3_0_Update_And_Run_MooaToon.bat脚本获取更新.

警告

请勿使用_2_0_Install_And_Run_MooaToon.bat获取更新, 该脚本只下载最少的内容, 只适用于第一次安装时使用.

解决冲突​

如果你修改了MooaToon的文件, 在更新时会收到提示, 如果已修改的文件和更新产生冲突, 则会有报错. 建议手动备份导致合并失败的文件, 运行_3_X_Clean_MooaToon_X后再次更新.

- 开发者用户​

如何从源码编译引擎: https://docs.unrealengine.com/5.1/zh-CN/building-unreal-engine-from-source/

前往: https://github.com/Jason-Ma-0012/MooaToon-Engine

使用Git拉取5.x分支以编译引擎, 拉取5.x_MooaToonProject分支以启动项目.

常见问题​

安装或更新期间的网络问题​

可以尝试以下解决方法:

自动获取最快的Github IP​

通常,中国大陆用户访问Github网速很慢, 运行该脚本可以缓解问题: _2_4_Fetch_Fastest_Github_IPs.bat

其原理是通过第三方网站查询当前网络中最快的Github服务器IP, 并写入Host文件, 实现加速下载.

设置全局代理​

如果你有更快的代理服务器, 请先在你的代理工具软件中打开全局代理.

然后运行该脚本启用代理:

  • _0_2_Set_CMD_And_Git_Proxy.bat

若要取消代理请运行该脚本:

  • _0_3_Cancel_CMD_And_Git_Proxy.bat

手动下载Zip​

您也可以选择不使用Git而是直接下载Zip, 这种方式下载可能更稳定, 并且可以使用迅雷加速下载和断点续传, 但每次更新都需要手动下载整个引擎和项目.

  1. 前往https://github.com/Jason-Ma-0012/MooaToon-Engine:

  1. 如图所示, 左侧选择的5.x为引擎分支, 点击右侧Code > Download ZIP开始下载引擎.

  2. 完成后请切换到5.x_MooaToonProject分支下载项目.

  3. 下载完成后回到MooaToon主目录, 将引擎解压到MooaToon\MooaToon-Engine目录内:

  4. 将项目解压到MooaToon\MooaToon-Project目录内:

  1. 运行_2_3_Setup_Unreal_Engine.bat, 注意, 这仍需要从Epic的服务器下载大量文件, 这一步目前无法绕过

  2. 运行_4_0_Build_And_Run_MooaToon.bat

Setup_Unreal_Engine期间的网络问题​

image-20230212142104841

由于Epic服务器或者网络速度问题, Setup期间可能卡在某一个文件, 或者下载失败.

你首先应该尝试使用全局代理, 或者切换代理服务器.

若仍然无法解决, 你可以从以下任意一个云盘手动下载:

下载后, 你应该得到如下分卷压缩文件:

image-20230212142605626

使用解压软件打开ue-gitdeps.zip, 将其内容解压到MooaToon-Engine\.git\ue-gitdeps文件夹, 然后再次运行_2_3_Setup_Unreal_Engine.bat, 现在你应该以相当快的速度完成.

然后运行_4_0_Build_And_Run_MooaToon.bat以构建并启动项目.

编译期间的错误​

编译器版本错误​

UE对编译器版本有一定要求, 你可以运行_1_2_Install_VisualStudio.bat自动安装正确的编译器版本, MooaToon编译时会优先选择正确的编译器版本.

如果持续出现编译问题, 你可以彻底卸载VS并重启电脑后重试上述步骤.

运行库缺失​

编译报错也可能是Windows缺少某些运行库导致, 请尝试:

  1. 安装最新的.NET Framework
  2. 下载工具并修复DirectX和C++运行库

预编译头文件(PCH)相关错误​

请根据官方文档增加虚拟内存.