Skip to main content

Getting Started

tip

NEW: Version 5.4 is now available!

Experience an executable demo​

TODO

Select the engine version that you want to install​

MooaToon is essentially a plugin that requires modifications to the engine code, and you can choose to install either the pre-compiled version or the source version.

- Install the precompiled version of the engine​

If you are an artist and just want to try out MooaToon, the precompiled version is a good choice.

The advantage of the precompiled version is that it can be used out of the box without waiting for the engine to be compiled, and the downloaded content is the least, and the running performance is the best.

The disadvantage of the precompiled version is that it cannot package C++ games, does not contain debugging information, and needs to re-download the entire package every time a small update is made.

Execute the following scripts in sequence to use the precompiled version:

  1. Download installation tool and unzip
  2. Double click to run: _0_0_Install_Latest_MooaToon_Precompiled_And_Override_All_Modified_Files.bat will automatically download and decompress
  3. Double click to run: _0_1_Run_MooaToon_Precompiled_Project.bat to open the project
caution
  1. Download problem

Because the service is based on Github, for users in mainland China, it is strongly recommended to enable the global proxy, otherwise the download speed and stability cannot be guaranteed.

If the proxy cannot be used, it is recommended to run the script _2_4_Fetch_Fastest_Github_IPs.bat first to increase the download speed to a certain extent.

  1. Running problems

If an error is reported when starting the project, first run _0_0_Install_Latest_MooaToon_Precompiled_And_Override_All_Modified_Files.bat again to ensure the integrity of the downloaded content, and then open the project.

If the problem is not resolved, please download and run the library repair tool, restart the computer and open the project again.

You can also use the script _0_0_Install_Latest_MooaToon_Precompiled_And_Override_All_Modified_Files.bat to update MooaToon, all modified files will be overwritten, and new files will not be overwritten if they do not have the same name as the MooaToon files.

- Compile the engine from source code​

If you want to get full engine functionality and faster update speed, please refer to:

Compile the engine from source code

Installing a specific UE version​

You can edit setting file to select the UE version you want to install:

  1. Right-click _2_5_Settings.bat, select Edit

  2. Change the UE version in the engineBranchName and projectBranchName fields to the version you want to install, such as 5.1:

set engineBranchName=5.1 
set projectBranchName=5.1_MooaToonProject
  1. Save and re-execute the installation process
caution

You can choose to use an older version, but the older version may not contain the latest features or fixes.

Since development and maintenance across multiple UE versions is extremely tedious, MooaToon is like Epic in that it only maintains the latest version, and maintenance of older versions is a paid service.

File directory structure​

  • Precompiled version
MooaToon ----------------------------------------- Root directory
 ├-MooaToon-Engine-Precompiled ------------------- Engine Installation Directory
 │ ├-Windows\Engine\Plugins\MooaToonScripts------- MooaToon Engine Plugins, C++ code included.
 │ ├-Windows\Engine\Plugins\MooaToonThirdparty---- MooaToon Engine Plugin Dependencies
 │ └-Windows\Engine\Binaries\Win64 --------------- Engine executable directory
 │ └-UnrealEditor.exe ---------------------------- Engine executable file
 ├-MooaToon-Project-Precompiled ------------------ Project installation directory
 │ ├-Art ----------------------------------------- Art resource file directory
 │ ├-Config -------------------------------------- Project settings directory
 │ ├-Content ------------------------------------- Project content directory
 │ │ ├-Global ------------------------------------ MooaToonSamples dependent resources
 │ │ └-MooaToonSamples --------------------------- All samples of MooaToon, can be deleted.
 │ ├-Plugins\MooaToon ---------------------------- Plugins for MooaToon project, including textures and blueprints.
 │ └-MooaToon_Project.uproject ------------------- Project file
 │
 ...
  • Source version
MooaToon ----------------------------------------- Root directory
 ├-MooaToon-Engine ------------------------------- Engine installation directory
 │ ├-Engine\Plugins\\MooaToonScripts ------------- MooaToon Engine Plugins, including C++ code
 │ ├-Windows\Engine\Plugins\MooaToonThirdparty---- MooaToon Engine Plugin Dependencies
 │ └-Engine\Binaries\Win64 ----------------------- Engine executable directory
 │ └-UnrealEditor.exe ---------------------------- Engine executable file
 ├-MooaToon-Project ------------------------------ Project installation directory
 │ ├-Art ----------------------------------------- Art resource files directory
 │ ├-Config -------------------------------------- Project settings directory
 │ ├-Content ------------------------------------- Project content directory
 │ │ ├-Global ------------------------------------ MooaToonSamples dependent resources
 │ │ └-MooaToonSamples --------------------------- All samples of MooaToon, can be deleted.
 │ ├-Plugins\MooaToon ---------------------------- Plugins for MooaToon project, including textures and blueprints.
 │ └-MooaToon_Project.uproject ------------------- Project file
 │
 ...

(Optional) Install Ultra Dynamic Sky​

Similar L_TimeOfDay_Require_UltraDynamicSky levels require you to purchase and install Ultra Dynamic Sky plugin to support the dynamic weather system: