Skip to content

ArtMesh Groups

Denchi edited this page Mar 27, 2026 · 13 revisions

You can set up layer/ArtMesh groups for your models. These groups can contain an arbitrary number of layers/ArtMeshes and they can be used in other parts of the app, for example to apply functionality to all of the contained layers/ArtMeshes at the same time.

This page will use the word "layer" when referring to ArtMeshes (technical name for the layers of Live2D models).

Setting up layer groups

To open up the layer group editor, click "Customize Model", then select "Set up layer groups".

In the layer editor, you can now select all layers you want to be part of the group. The number next to the layer names is the current order of the ArtMesh within the model (at the time when the list was opened, order can change over time).

You can also filter the list using the text filter or click the model to filter the list so it only shows the ArtMeshes at the click position.

To visualize which layers are/aren't part of the group, you can choose a "Highlight color" and a "Deselected color".

Instead of manually adding layers to the group one-by-one, you can add/remove them by ID as well. For example, if you type "hair" into the "Add by ID" field, it will add all layers to the group that contain "hair" in the ID. Of course this requires your model to have properly set up ArtMesh IDs (many riggers just leave the names as the default ArtMesh1, ArtMesh2, etc). Before actually adding the layers, VTS will show you a list of all layers that would be added by this.

You can also bulk-add layers by UserData, which is explained further below.

After you've set up the layer group, you can now use it to bulk-set functionality for ArtMeshes.

For example, you can do ArtMesh recoloring for many layers at the same time using layer groups.

Setting up layer groups for Live2D items

When you load a Live2D model as Live2D item, all its groups will be carried over into the item as expected.

However, you can also create layer groups directly in the Live2D item. Just long-click it (press-and-hold) to open its item settings, then choose "Set up layer groups".

ArtMesh UserData Tags

Another way to bulk-select layers is by using UserData tags.

UserData tags are tags that can be applied to ArtMeshes by your rigger when setting up the model using the UserData field.

Each ArtMesh has this field and you can type as many tags as you want. VTS splits the contents of this field into individual tags at spaces and newlines.

Using this, your rigger could prepare tags/groups that can later be used to filter layers of the model for other functionality.

When using UserData, make sure to check the "Export UserData" box when exporting the model from Live2D Cubism.

Clone this wiki locally