All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.
5-r.5-beta.3 - 2026-01-08
- Add scripts and assets for using the
Universal Render Pipelineand custom render passes toAssets/Live2D/Cubism/Rendering/URP. - Add a feature to allow rendering of arbitrary objects before and after the rendering of model draw objects.
- Add
CubismLookCenterTransformandCubismLookCenterArtMeshto allow setting the look-at center using either a Transform or an ArtMesh.
- Change to work based on the
Universal Render Pipeline.Built-in Render PipelineandHigh Definition Render Pipelineare not supported.Cubism 5 SDK for Unity R4_1and its derivative packages will be maintained asBuilt-in Render Pipelinecompatible versions.- Models and features from
Cubism 5.3and later cannot be used.
- Models and features from
- The use of custom render passes is required.
- Fix an issue where
ReleaseStaleRenderTextures()could releaseRenderTexturein use depending on the timing of its invocation. - Fix an issue where the texture settings were not as intended when imported.
- Fix an issue where look-at tracking was misaligned when using
CubismLookController. - Fix an issue where the Koharu model's .model3.json was missing references to .motion3.json.
- Fix Koharu's corrupted .motion3.json files.
- Fix an issue where Raycast was functional even when
CubismRaycastablewas inactive.
- Remove unused shaders and materials.
- Remove
Assets/Live2D/Cubism/Rendering/CubismCommonRenderFrameBuffer.csandAssets/Live2D/Cubism/Rendering/ArrayExtensionMethods.cs. - Remove
Assets/Live2D/Cubism/Rendering/Resources/Live2D/Cubism/Prefabs/ModelCanvas.prefab. - Remove scripts and related processes under
Assets/Live2D/Cubism/Rendering/MaskingandAssets/Live2D/Cubism/Samples/Masking.- Remove
Assets/Live2D/Cubism/Editor/Inspectors/CubismMaskControllerInspector.cs,Assets/Live2D/Cubism/Editor/Inspectors/CubismMaskTextureInspector.cs, andAssets/Live2D/Cubism/Rendering/Resources/Live2D/Cubism/GlobalMaskTexture.assetaccordingly. - Mask processing has been integrated into
CubismRenderer.
- Remove
5-r.5-beta.2 - 2025-10-14
- Change to a method where
RenderTexturefor offscreen is pre-created in small numbers and reused. - Change the version of the development project to
6000.0.58f2.
- Fix an issue where objects were not rendered when redisplayed.
- Fix an issue where offscreen was not affected by
OverrideFlagForModelMultiplyColorsandOverrideFlagForModelScreenColors. - Fix an issue where collision detection remained active even when the collision detection Drawable was hidden.
- Fix an issue where pressing the reset button in the
CubismParametersInspectorwould revert to the state before the reset when running the scene. - Fix a bug that hit detection does not match the model’s visual appearance.
- Fix a bug that the model may be partially clipped when rendered.
- Fix the size of models using features introduced in
Cubism 5.3differed from models created in prior toCubism 5.3. - Fixed an issue where models for
Cubism 5.3were not rendered correctly in environments whereUNITY_REVERSED_Zis enabled.
5-r.5-beta.1 - 2025-08-26
- Add support for Blend mode and Offscreen drawing.
- If the model uses blend mode or offscreen drawing, it will be rendered using a new drawing method that differs from
Cubism 5.2and earlier.
- If the model uses blend mode or offscreen drawing, it will be rendered using a new drawing method that differs from
- Add high-precision mask method.
- This is only available with the new rendering method in
Cubism 5.3and later, and masks in the new rendering method fromCubism 5.3onward will automatically use this method.
- This is only available with the new rendering method in
- Change the version of the development project to
6000.0.55f1. - Change
_isOverriddenDrawableScreenColorsand_isOverriddenDrawableMultiplyColorsto_isOverriddenDrawObjectScreenColorsand_isOverriddenDrawObjectMultiplyColors.- The property names that use these backing fields have also been updated accordingly.
- Serialization of
_isOverriddenDrawableScreenColorsand_isOverriddenDrawableMultiplyColorsis maintained by theFormerlySerializedAsattribute.
- Remove
CubismCoreDll.GetDrawableRenderOrdersandCubismUnmanagedDrawables.RenderOrders.- If you need to use these functions, please use
CubismModel.AllDrawObjectsRenderOrderinstead.- See
CHANGELOG.mdin Core.
- See
- If you need to use these functions, please use
- Remove Chrome OS from the tested environment.
5-r.4.1 - 2025-07-17
- Implement support for Android 16KB page size.
- Fix a bug that prevented builds from working under certain settings.
5-r.4 - 2025-05-29
- Add an empty
AnimatorControllerat the same hierarchy level as each model's Prefab. - Add an API to
CubismMotionJsonfor verifying the consistency ofmotion3.json. by @pillowtrucker - Add parameter repeat processing that connects the right and left ends of the parameter to create a loop, allowing the motion to repeat.
- Add the variable
_isOverriddenParameterRepeatto theCubismModelclass for managing parameter repeat flags at the model level. - Add variables
_isOverriddenUserParameterRepeatto theCubismModelclass and_isParameterRepeatedto theCubismParameterclass for managing parameter repeat flags for each parameter.
- Add the variable
- Change the version of the development project to
2022.3.59f1. - Change CubismMath class not to inherit from MonoBehaviour.
- Change
CubismMoc._bytesnot to be displayed in Inspector.
- Fix
CubismPhysicsControllerto be in the correct disabled state. - When performing a Reimport Fixed a problem that
.cdi3.jsonupdates were not reflected inCubismDisplayInfoParameterName,CubismDisplayInfoPartName. - Fix a problem in which the slider of CubismParametersInspector and CubismPartsInspector in the Inspector window did not move when operated.
- Fix a bug that CubismParametersInspector and CubismPartsInspector do not display the names of parameters and parts if .cdi3.json is not set on the model.
- Fix
CubismParameterInspectorandCubismPartInspectorcan be operated in play mode. - Fix a bug that prevented MotionFade fade-out from working properly.
- Fix unnecessary processing in
CubismFadeController. - Fix so that end events are sent for all clips played by
CubismMotionController. - Fix an error that occurred when playing a expression that uses parameters that do not exist in the model.
5-r.3 - 2024-11-28
- Add processing to parse
CombinedParametersfrom.cdi3.jsonfile.- Also add
CubismDisplayInfoCombinedParameterInfocomponent to store this information.
- Also add
- Add
AnimationBeganHandler, which calls a function when the motion playback starts, to bothCubismMotionControllerandCubismMotionLayer. - Add the definition of the function
GetLogFunctiontoCubismCoreDll.
- Change an expression "overwrite" to "override" for multiply color, screen color, and culling to adapt the actual behavior.
- Change
OnGeneratedCSProjectFilesfunction to be disabled in Unity 2017.3 and later by @moz-moz - Change to a single function The initialization process in CubismModel class. by @KT
- Change to optimize update process for Multiply Color and Screen Color.
- Change argument type of
CubismMotionLayer.AnimationEndHandlerandCubismMotionController.AnimationEndHandlerto match the current usage. - Move the definition of
csmSetLogFunctionfromCubismLoggingtoCubismCoreDlland rename toSetLogFunction. - Raycast processing now supports 3D intersection determination.
- In the
AsyncBenchmarkscene andAutomaticAsyncBenchmark, changed it so that asynchronous processing is not performed in WebGL.
- The fade in and fade out functionality has been improved to better maintain compatibility with other CubismSDK implementations.
- Fix an issue in which when the number of textures for masks was increased, masks were not generated for the increased number of textures from the time of execution.
- Fix an issue that caused an error when parsing Json if the name of the model had certain characters.
- Fix the condition for setting the fade-out end time for Expression.
5-r.2 - 2024-04-04
- Add HarmonyOS NEXT from the tested environment.
- Fix an issue where the
Allow 'unsafe' Codeproperty was not enabled in theLive2D.Cubism.asmdef.
5-r.1 - 2024-03-26
- Add
CubimMathclass in namespaceLive2D.Cubism.Framework.Utils. - Add function
ModF()to compute floating-point remainder inCubismMathclass.
- Change the message to output the latest Moc version supported by the CubismCore when the
.moc3file fails to load correctly. - Change the version of the development project to
2021.3.36f1.
- The
ToIndex()andReturnTiles()functions of theCubismMaskTilePoolclass are not used.
- Fix fade calculation bug in MotionFade.
- Fix a bug in which masks were not generated correctly when using multiple render textures and displaying two or more models.
- Fix an issue where normal processing could not be performed when
CubismMaskTilePool.Subdivisionsis less than1.
- Remove
CubismWebGLPluginProcessor.cs. - This change is due to the removal of Cubism Core built with
Emscripten 1.38.48. - See
CHANGELOG.mdin Core.
5-r.1-beta.4 - 2024-01-18
- Add
CubismDrawableInspectorand parent Part display. - Add
CubismPartInspectorto show parent and descendant trees. - Add expression to check for index out of range with
CubismRenderer.OnMaskPropertiesDidChange().
- Change
CubismPartsInspectorInspectorto be hierarchical.
- Fix an issue where models with a specific number of masks could not be drawn correctly.
5-r.1-beta.3 - 2023-11-14
- Add
HarmonicMotionsample scenes.
- Change the version of the development project to
2021.3.30f1. - Change the value of
EditortoAnyCPUin thePlatform settingsofLive2DCubismCore.bundle.- Apple Silicon version of the Unity Editor will work without the need to change
Platform settings.
- Apple Silicon version of the Unity Editor will work without the need to change
- Fix an error when displaying CubismRendererInspector for uninitialized models.
- Fix condition for clearing AnimationCurve when Reimporting .motion3.json.
- Fix fade calculation bug in MotionFade.
5-r.1-beta.2 - 2023-09-28
- Added configuration file so that assemblies are split.
- Replace the sample model
Maowith the updated version that is compatible with Cubism 5.0.
- Fix an issue where 1 byte of memory was allocated unnecessarily.
- Fix a bug where automatic eye blinking did not close the eyes fully.
5-r.1-beta.1 - 2023-08-17
- When importing a Cubism Model in Unity Workflow, the AnimatorController is now set to the Animator in the Model Prefab.
- Change so that multiply and screen colors applied to parent parts are propagated to child parts.
- Fix an issue where information was being got using indexes instead of IDs when getting cdi3.json data.
- Fix a bug that prevented proper operation when the Unity Transition was longer than the motion fade.
4-r.7 - 2023-05-25
- The number of render textures used can now be increased arbitrarily.
- The maximum number of masks when using multiple render textures has been increased to "number of render textures * 32".
- You can also continue to use the pre-R6_2 method.
- Importing a model now generates a MaskTexture asset containing the model's name.
- It is generated only if the model prefab has not been generated.
- Add the function of checking consistency on importing a MOC3. (
CubismMoc.CreateFrom)- This feature is enabled by default.Please see the following manual for more information.
- Add component for changing Multiply Color / Screen Color from parent part.
- Components are automatically added to each part object of the model when the model is imported.
- Fix to improve physics and rendering performance. by @ppcuni
- Fix an issue with
ResetSwapInfoFlagsfunction where flags were not initialized correctly. by @ppcuni
4-r.6.2 - 2023-03-16
- Fix some problems related to Cubism Core.
- See
CHANGELOG.mdin Core.
- See
4-r.6.1 - 2023-03-10
- Add function to validate MOC3 files.
4-r.6 - 2023-01-26
- Add the feature to search for Subrig objects by the name of the physics group. by @ppcuni
- Add the feature to set the magnification of the output of the physics group uniformly to an arbitrary value. by @ppcuni
- Add the feature to uniformly set the inversion flag for the output of the physics group. by @ppcuni
- Add editor extension to the Inspector of CubismPhysicsController to display physics group names. by @ppcuni
- To apply this feature to sample models, we regenerated sample models prefab, etc.
- Sample model assets are brought up to date.
- Change the version of the development project to
2020.3.41f1.
- Fix a bug that caused a warning to appear when importing a model with an unmatched Object Name.
- Fix an issue where unwanted curves on
.animwere not correctly erased when re-importing a model where Pose3.json exists. - Fix wrong condition for getter in HandlerInterface of Multiply Color and Screen Color. by @qualice-hirakawa
- After setting the multiply color (or screen color) and related flags on the inspector, the changes are now retained when starting play mode. by @qualice-hirakawa
- Fix a bug that caused
.fadeMotionListto be created incorrectly when loading a model containing.pose3.json, depending on the order in which theCubismPoseMotionImporterwas executed.
4-r.5 - 2022-09-08
- Add Unity 2022 to the development environment.
- Add the multilingual supported documents.
- Add immediate stabilization of physics.
- Remove Unity 2019 from the development environment.
4-r.5-beta.5 - 2022-08-04
- Add a feature to change the value of components in batches.
- Update
Maomodel.
- Fix crash with exception when reading .moc3 files of unsupported versions.
- The console now produces an explicit error log instead of an exception.
- Fix physics system input to be split by the physics setting time.
- Fix a bug in which processing was interrupted when an invalid vertex was specified in the middle of a physics operation.
4-r.5-beta.4 - 2022-07-07
- Add properties to get the latest .moc3 version and the .moc3 version of the loaded model in CubismMoc.
- Add
Maomodel. - Add
Demo4.2scene to runMaomodel. - Add a function to get the type of parameters of the model.
- Add a function to get the parent part of the model's Drawable.
- Fix
GetMocVersionfunction argument inCoreDllclass that was different from the original Core API argument. - Fix that does not occur error when Sorting Mode of CubismRenderController is changed in the Project window.
4-r.5-beta.3 - 2022-06-16
- Change the version of the development project to
2019.4.39f1.
- Fix physics system behaviour when exists Physics Fps Setting in .physics3.json.
4-r.5-beta.2 - 2022-06-02
- Fixed a bug that caused Multiply Color / Screen Color of different objects to be applied.
- See
CHANGELOG.mdin Core. - No modifications to Samples and Framework.
- See
4-r.5-beta.1 - 2022-05-19
- Add support to prevent exceptions depending on the presence or absence of parameters. by @ppcuni
- Add Weight argument to BlendToValue function. by @ppcuni
- Add processing related to Multiply Color / Screen Color added in Cubism 4.2.
- Fix for changes
EditorUserBuildSettingsin 2021.2 and later.
4-r.4.2 - 2022-03-09
- Fix an issue where inversion masks did not work properly and the mask limit was different from normal.
4-r.4.1 - 2022-02-10
- Added an editor extension that switches the library depending on Unity version when exporting to WebGL.
4-r.4 - 2021-12-09
- Add Unity 2021 to the development environment.
- Add the function to set assets to a component when importing a model.
- Add Chrome OS from the tested environment.
- Change the version of the development project to
2019.4.29f1. - Change
Enable AsyncinAsyncBenchmarkscene to be disabled by default. - Change the sample scene in
Samples/OW/Expressionso that the expressions are displayed in the order of the elements inexpressionList.asset. - Change
UserDatathat it can be edited from Inspector. - Change multiple
UserDatacan be edited in bulk from the inspector.
- Fix an issue with duplicate elements in the Expression List.
- Fix the elements of
expressionList.assetto be empty when importing in Unity 2021 and 2020. - Fix to keep
Layerat reimport. - Fix
CubismMotionControllerdo not be removed at reimport.
- Remove Unity 2018 from the development environment.
4-r.3 - 2021-06-10
- Add a function to read data from
.cdi3.json. by @ShigemoriHakura - Add a function to display the names of parameters and parts described in
.cdi3.json. by @ShigemoriHakura - Add a function to change the display name of parameters and parts to any name.
- Add a display of elapsed time to the sample scene
AsyncBenchmark. - Add a sample scene that manipulates the number of models to be displayed to achieve the specified frame rate.
- Change to continue importing when an error occurs. @TakahiroSato
- Fix failing the model generation when importing with Unity 2020.
- Fix registering the dynamically selection of the index for
PlayerLoopSystem.subSystemList. - Fix the updating process for InstanceId; Update the InstanceId without adding the element of .fadeMotionList when the InstanceId that is registered the AnimationClip was changed.
- Fix import of models with invalid masks. by @DenchiSoft, @ShigemoriHakura.
4-r.2 - 2021-01-12
- Add Unity 2020 to the development environment.
- Add a process that applies the Culling configuration from Model Data.
- Add an
AnimatorControllergenerator that is already setCubismFadeStateObserver.
- Change the setting of Player Loop customized by other assets not to be rewritten in Unity 2019.3 or later.
- Change to get the path of the audio files associated with
.motion3.jsonfrom.model3.json. - Change to enable the appropriate Cubism iOS plugin before building.
- Change the handling of
UnmanagedArrayViewpointers due to improve the performance. @ppcuni - Change the default importing mode to
Original Workflow.- Note: Importing this version into an older version SDK will override this setting. see Cubism SDK Manual page
- Fix the bug of the weight calculation of
MotionFade. - Fix the bug of the weight calculation of
Expression. - Fix the bug when playing a motion that is shorter than the fade time or transitioning to a motion with a different fade value.
- Fix fixed value for the generated .exp3.asset fade value when there is no fade value in .exp3.json.
- Fix registering the delegate duplicately on calling
CubismUpdateController.Refresh(). - Fix checking bounding box hit every time before checking mesh hit by @DenchiSoft.
- Remove Unity 2017 from the development environment.
4-r.1 - 2020-01-30
- Change registration of
CubismModel.OnRenderObject()toPlayer Loopon Unity 2018. - Change access modifier of
CubismFadeController.Refresh()topublic. - Restructure scene maintaining Unity 2017-2019 compatibility.
- Change to manage .meta files, samples and models in the repository.
- Separate license file from
README.md. - Change to use gravity and wind settings from
physics3.json. - Reformat some code according to the coding standards.
- Change the shorten type name
Actionto full nameSystem.Action.
- Fix occurring runtime error when importing the model exist with
.moc3.asset. - Fix only
EndTimeupdate with latest motion when motion fading. - Fix the path of
.motion3.jsonto save.fade.asset. - Fix the
InstanceId. - Fix to reuse
InstanceIdrecorded in generatedAnimationClip. - Fix condition to clear existing
AnimationClipcurve on reimporting. - Fix the script of the
Original Workflow samplescene.
4-beta.2 - 2019-11-14
- Fix sample scene sourcecode:
CubismSampleController.cs - Fix a bug when switching multiple motions in the same layer of
Motioncomponent. - Fix priority not being set when playing idle motion.
- Fix importing process of
.pose3.jsononOriginal Workflow.
4-beta.1 - 2019-09-04
- Support new Inverted Masking features.
- Add
.editorconfigand.gitattributesto manage file formats. - Add
UWP/ARM64Core binary file for experimental use. - Add method to know playing motion or not #35.
- Add sample model and sample scene.(
./Assets/Live2D/Cubism/Samples/OriginalWorkflow/DemoCubism4)
- Upgrade Core version to 04.00.0000 (67108864).
- Move to
Plugin/Experimental/UWPfromPlugin/Experimental/uwp/Windows. - Convert all file formats according to
.editorconfig. LICENSE.txtfile has been integrated intoREADME.md- Remove changelog and regenerate
CHANGELOG.md. - What was
Package.jsonis currently being changed tocubism-info.yml. - Improve CubismUpdateController #34.
- Fix issue of
DemoandMotionsample inOriginalWorkflow. - Fix issue that mesh remain when deleting model.
- Fix issue where Priority value was not reset after playing motion with CubismMotionController.