Skip to content

Home

Jump to bottom
Jason Ma edited this page Dec 17, 2022 · 16 revisions

安装MooaToon

目前需要手动安装, 之后会开发一个自动安装工具.

根据你的网速和CPU, 整个安装过程可能需要5~10个小时, 请稍安勿躁, 如果过程中有无法解决的问题可以提交Issues.

- 普通用户

关联账号

在开始之前, 你需要一个**Epic账号和Github账号**, 如果没有请前往注册.

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

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

image-20221212004135659image-20221212004144195

下载MooaToon引导仓库

下载此仓库的Zip, 解压到你认为合适的位置, 强烈建议至少保留100~200GB的SSD硬盘空间.

然后可以开始安装过程.

使用工具自动安装

依次执行:

  1. _1_1_Install_Git.bat以默认设置安装Git
  2. _1_2_Install_VisualStudio.bat以默认设置安装VS2022
  3. 保存你的工作内容
  4. _1_3_Restart_Computer.bat重启电脑
  5. _2_0_Install_And_Run_MooaToon.bat按照提示输入Github账号密码, 等待下载和编译完成, 这可能需要5到10小时
  6. 完成后, 工程将自动给打开

可能遇到的问题

网络问题
自动获取最快的Github IP

通常, 大陆用户访问Github网速很慢, 要解决这个问题请运行以下脚本:

  • _2_4_Fetch_Fastest_Github_IPs.bat

该脚本在运行_2_0_Install_And_Run_MooaToon.bat时会自动执行, 其原理是通过第三方网站查询当前网络中最快的Github服务器IP, 并写入Host文件, 实现加速下载.

手动设置Git代理

如果你有更快的代理服务器, 也可以手动为Git设置代理, Win + R输入以下命令(请将代理端口替换为你自己的代理端口):

  • Socks5: git config --global http.proxy socks5://127.0.0.1:10808
  • Http: git config --global http.proxy http://127.0.0.1:10808

取消Git代理: git config --global --unset http.proxy

手动下载Zip

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

  1. 你可以前往https://github.com/Jason-Ma-0012/MooaToon-Engine下载Zip:
  2. image-20221213162935558
  3. 如图所示, 左侧选择的5.1为引擎分支, 点击右侧绿色的Code > Download ZIP开始下载引擎.
  4. 完成后请切换到5.1_MooaToonProject分支下载项目.
  5. 下载完成后回到MooaToon主目录, 将引擎解压到MooaToon\MooaToon-Engine目录内
  6. 将工程解压到MooaToon\MooaToon-Project目录内
  7. 运行_2_3_Setup_Unreal_Engine.bat, 注意, 这仍需要从Epic的服务器下载大量文件, 这一步目前无法绕过
  8. 运行_4_0_Build_And_Run_MooaToon.bat

检查项目

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

image-20221212014623216

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

image-20221212015220026

获取更新

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

你也应该时常检查引导仓库的更新情况, 并通过_3_5_Update_InstallTool.bat脚本进行更新.

解决冲突

如果你修改了MooaToon的文件, 在更新时会收到提示, 如果已修改的文件和更新产生冲突, 则会有报错.

建议手动备份并删除导致合并失败的文件, 然后再次更新.

如果要放弃所有已修改的文件, 请运行_3_4_Force_Update_MooaToon_X.bat.

- 开发者用户

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

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

拉取5.1分支以编译引擎, 拉取5.1_MooaToonProject分支以启动项目, Enjoy it.

(可选)安装Ultra Dynamic Sky

类似L_TimeOfDay_Require_UltraDynamicSky的关卡需要您自行购买并安装Ultra Dynamic Sky插件:

  • 购买:https://www.unrealengine.com/marketplace/zh-CN/product/ultra-dynamic-sky
  • 在Epic启动器的保管库中, 将Ultra Dynamic Sky安装到MooaToon-Projectimage-20221212015537921
  • 重启UE5
  • 再次打开L_TimeOfDay_Require_UltraDynamicSky, 你应该能够看到:image-20221212015845771
  • 你可以Play以查看动态天气效果:image-20221212020046200
  • 你可以使用快捷键G预览Play显示设置
  • 有关Ultra Dynamic Sky的用法可以在其购买页面找到

重要提示

  • 请复制而不是更改MooaToon资源, 否则可能会因为更新而丢失改动

  • 官方 5.1 BUG: 有时角色RT阴影消失, Play或隐藏/显示角色后OK

  • 官方 5.1 BUG: TSR和Ultra Dynamic Sky同时开会crash

  • 官方 5.1 BUG: RT阴影获得的ShadingModelID永远是DefaultLit, 这意味着如Subsurface Transmission之类的效果不生效

  • 官方 5.1 BUG: 材质预览场景地板在开启RT Skylight时是黑的

  • 官方 5.1 BUG: OIT会导致半透明Add混合失效

  • 官方BUG: 调整Layer材质相当容易Crash, 使用时记得经常保存

Clone this wiki locally