Installation Guide

Unity2018.4.0(LTS) or higher

MagicaCloth requires Unity2018.4.0(LTS) or a higher version.
Also, since the setting of Job System + Burst compiler is necessary, please execute the following setup in order.


Installation of Burst package

Open [Window]-> [Package Manager] from the menu.
Select the [Burst] package as shown in the image and install it.


Install Jobs package (Unity2018/2019)

In Unity 2018/2019, you need to set the preview package display settings first.
Start [Window]-> [Package Manager] from the menu.
Jobs are still (preview), so you need to select Show preview packages from the Advanced menu to see the (preview) packages.

When the preview package appears in the list, install the Jobs package as follows.


Install Jobs package (Unity2020)

In Unity2020, you need to display the preview package in the following way.
Select Edit-> Project Settings… from the menu and set the preview package display settings as shown in the image.

Then start Package Manager and install the Jobs package.


Install Jobs package (Unity2021 or later)

Since Unity2021, the Jobs package has been hidden because it is under development.
Therefore, please install according to the following procedure.
Open the Package Manager, press the “+” button in the upper left and select [Add Pacakge from git URL…].

Enter [] in the URL and press the [Add] button.

This will automatically install the Jobs package.


(UNITY2018 only) Install COLLECTIONS / MATHEMATICS package

If you use Unity2018, please install [Collections] [Mathematics] package additionally.
It is automatically installed in Unity2019 and later.


If an error occurs

If the following error occurs in the process up to this point, package dependencies are a problem.
This often occurs due to package upgrades.

In this case, follow the steps below.
(1) Uninstall [Jobs] [Burst][Collections][Mathematics] package once
(2) Install [Jobs] package

This will automatically install the [Burst] package that matches the current [Jobs].
Error should disappear.

If you still get the error, try updating all the [Jobs] [Burst] [Collections] [Mathematics] packages to the latest version.


Magica Cloth import

Open [Windows]-> [Asset Store] and import MagicaCloth.

Packages are organized in the Assets/MagicaCloth folder.

Execution test of sample scene

Let’s run the sample and test if there are any problems with Unity settings or the Magica Cloth package.
Five samples are included in the Example/Scene folder.

Double click the UnityChanClothSample scene to load it.

Let’s run the sample scene.
If the hair and skirt of Unity-Chan are shaking without any problem, installation is complete.


Example folder can be deleted

The Example folder can be deleted if it is not needed.


Combined with ECS

Add the following settings to use MagicaCloth with Unity Entity Component System (ECS).
This setting is required only for Unity 2018.4 / Unity 2019.2.
There is no need to set it for Unity 2019.3 or later.

Open Edit-> Project Settings ..-> Player from the editor menu.
Add [MAGICACLOTH_ECS] to Scripting Define Symbols of Configuration.


Notes on Windows builds

When building with IL2CPP for Windows, please do not set the [C ++ Compiler Configuration] setting to [Master].
This is because a bug in the Microsoft Linker can cause a crash, as described in the Issue Tracker below.


When building with Windows + IL2CPP, select the [Release] configuration as shown in the image.
Unfortunately, there is currently no other workaround.