Installation Guide


Unity2019.4.31(LTS) or higher

MagicaCloth requires Unity2019.4.31(LTS) or a higher version.
Also, since two packages, Burst and Jobs, are required for operation, please execute from the following setup in order.


Installation of Burst package

First install the Burst package.
Open [Window]-> [Package Manager] from the menu.
Select Unity Registry from the list menu.

Select the [Burst] package as shown in the image and install it.



Install Jobs package (Unity2019)

In Unity 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.



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 the [Burst] [Jobs] package


Magica Cloth import

Also open Package Manager from the menu and select My Assets.

Select Magica Cloth from the list to download and import the latest version.
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.
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.


How to check the version

You can check the currently installed version of Magica Cloth by the following method.
Select Tools / Magica Cloth / About from the editor menu.


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.