Update Cubism Components

Updated: 11/25/2021

This section describes how to replace a Unity project that has been created in [Import SDK – Place Models] with the latest package.


There are two ways to obtain the Cubism SDK: from a package or from GitHub.

The package contains the latest Core libraries and CubismComponents at the time of its release, as well as samples that make use of them.

To apply Cubism SDK updates from GitHub to your Unity project, follow the steps described below.

If you are not yet familiar with Unity, please make a backup of your project before updating.


SDK updates can also be done by overwriting the latest .unitypackage.
In this case, the library cannot be updated and the overwrite may fail.
See “Frequently Asked Questions” in the Cubism SDK Manual for details.

Get the Latest Package

Obtain the latest package from the Cubism SDK download page.

Apply the Latest Package to Your Unity Project

When overwriting an existing Unity project, it may not be possible to continue using Cubism Core on the Unity side and update it.

In this case, follow the procedure below to update.

  1. Save all currently used scenes.
  2. After saving is complete, create a new scene using “Ctrl + N” or similar.
  3. Restart Unity with the new scene created.
  4. Once Unity starts, overwrite the latest package.

If no compile errors occur after overwriting, the Cubism SDK update for the Unity project is complete.

If a compile error occurs at this point, the following causes are possible.

  • The classes themselves included in the package are customized
  • A class with the same name as a class added to the package already exists in the project

Starting with the Cubism 4 SDK for Unity beta13, the Cubism SDK is now compatible with Cubism 4.0.

The format of the built-in data exported from the Cubism 4 Editor is .moc3 as before, but due to the lack of backward compatibility with added features such as mask inversion, the Cubism 4 method .moc3 cannot be read by the Cubism 3 SDK.

Conversely, the Cubism 4 SDK can read .moc3 in Cubism 3 format.
We recommend that you use the Cubism 4 SDK when creating a project from now on.

  Cubism SDK ver
Cubism 3 Cubism 4

.moc3 ver

Cubism 3
Cubism 4
Was this article helpful?
Please let us know what you think about this article.