About Memory Usage

Updated: 11/29/2017

The Cubism Editor initially specifies 4 GB as the maximum available memory size. If you experience problems such as large textures not loading or slow playback of animations, increasing the maximum memory usage may solve the problems.

Note: The following settings are no longer required due to the new “Optimize Java memory allocation for editors” feature implemented in Cubism Editor 3.1.
However, if you wish to control memory usage yourself, please configure the following settings.

Specify Memory Usage

Point

The following operations require administrator privileges for the Windows and MacOS versions.

How to specify memory usage in Windows

To change the maximum memory usage, open “CubismEditorX.bat” and edit it.
The location of “CubismEditorX.bat” is as follows.

C:/Program Files/Live2D Cubism 3.0/CubismEditorX.bat
(For standard installations)

Copy the “CubismEditorX.bat” file to the desktop or other location and open it with a text editor such as Notepad.

Point

It is recommended that a backup of the original file be made when performing this operation.

When you open the “CubismEditorX.bat” file, you will find the following description on the 12th line from the top.

rem ** Memory Size
set MAX_MEMORY=4000
set MAXMEMORY=-Xmx%MAX_MEMORY%m

MAX_MEMORY=4000” in the above example means 4 GB (default setting).
If your system has 16 GB, we recommend a maximum of about 14 GB.
To set the size to 14 GB, enter the following:

MAX_MEMORY=14000

The size specified here is the maximum memory size that will be allocated when needed. There is no such thing as 14 GB immediately after startup.

Point

If the setting value is too large, Cubism Editor may not start.
In this case, set 1/3 of the installed memory capacity as a guide.

After you save the file, overwrite the original file with the same name (CubismEditorX.bat) by dragging and dropping it into the following folder.

C:\Program Files\Live2D Cubism X.X

Select “Yes” when the dialog box appears asking if you want to overwrite an already existing file.

Because it is a file edit in ano area where the system is installed, a dialog box such as “You must have administrator privileges to move to this folder” will appear.

Select “Continue” to overwrite the file.

When “CubismEditorX.exe” is executed, the application starts with the set memory size as the maximum size.
If it does not start properly, reduce the specified memory size and try again.

How to specify memory in Mac

To change the maximum memory usage, open “Info.plist” and edit it.
The location of “Info.plist” is as follows.

Right-click Live2D Cubism Editor.app in the Applications/Live2D Cubism X.X folder and click [Show Package Contents].
Open the Contents folder that appears.

Copy the “Info.plist” file to the desktop or other location and open it with a text editor.

Point

It is recommended that a backup of the original file be made when performing this operation.

When you open the “Info.plist” file, you will find the following description on the 10th line from the bottom.

<key>JVMOptions</key>
<array>
<string>-Djava.security.policy=$APP_PACKAGE/../res/live2d.policy</string>
<string>-Djava.library.path=$APP_ROOT/Contents/Java</string>
</array>

To set the maximum memory size, write “<string>-Xmx6000m</string>” as follows.

<key>JVMOptions</key>
<array>
<string>-Djava.security.policy=$APP_PACKAGE/../res/live2d.policy</string>
<string>-Djava.library.path=$APP_ROOT/Contents/Java</string>
<string>-Xmx6000m</string>
</array>

In the above example, “<string>-Xmx6000m</string>” means 6 GB.
If your system has 16 GB, we recommend a maximum of about 14 GB.
To set the size to 14 GB, enter the following:

<string>-Xmx14000m</string>

The size specified here is the maximum memory size that will be allocated when needed. There is no such thing as 14 GB immediately after startup.

Point

If the setting value is too large, Cubism Editor may not start.
In this case, set 1/3 of the installed memory capacity as a guide.

After you save the file, overwrite the original file with the same name (info.plist), right-click Live2D Cubism Editor.app in the Applications/Live2D Cubism X.X folder, and click [Show Package Contents].

Open the Contents folder that appears, and drag and drop the “Info.plist” file.
The dialog box “To change ‘Contents’ you need the administrator’s name and password” will appear.
If you select “Authentication,” a dialog box will appear indicating that the file will be replaced.
Select “Replace,” enter the user name and password, and click “OK.”

When “Live2D Cubism Editor.app” is executed, the application starts with the set memory size as the maximum size.
If it does not start properly, reduce the specified memory size and try again.

Was this article helpful?
YesNo
Please let us know what you think about this article.