-
Notifications
You must be signed in to change notification settings - Fork 139
ArtMesh Groups
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).
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.

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".

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.

If you have any questions that this manual doesn't answer, please ask in the VTube Studio Discord
!!
- Android vs. iPhone vs. Webcam
- Getting Started
- Introduction & Requirements
- Preparing your model for VTube Studio
- Where to get models?
- Restore old VTS Versions
- Joining the Beta
- Controlling multiple models with one device
- Copy config between models
- Loading your own Backgrounds
- Recoloring Models and Items
- Record Animations
- Recording/Streaming with OBS
- Sending data to VSeeFace
- Starting as Admin
- Starting without Steam
- Streaming to Mac/PC
- VNet Multiplayer Overview
- Steam Workshop
- Taking/Sharing Screenshots
- Live2D Cubism Editor Communication
- Lag Troubleshooting
- Connection Troubleshooting
- Webcam Troubleshooting
- Crash Troubleshooting
- Known Issues
- FAQ
- VTube Studio Settings
- VTS Model Settings
- VTube Studio Model File
- Visual Effects
- Sound Effects
- Twitch Interaction
- Twitch Hotkey Triggers
- Spout2 Background
- Expressions ("Stickers"/"Emotes")
- Animations
- Interaction between Animations, Tracking, Physics, etc.
- Google Mediapipe Face Tracker
- NVIDIA Broadcast Face Tracker
- Tobii Eye-Tracker
- Sony mocopi trackers
- Hand-Tracking
- Controller-Tracking
- Lipsync
- Item System
- Live2D-Items
- Between-Layer Item Pinning
- Item Scenes & Item Hotkeys
- ArtMesh/Layer Groups
- Add Special ArtMesh Functionality
- Display Light Overlay
- VNet Security
- Plugins (YouTube, Twitch, etc.)
- Web-Items
- Web-Item Plugins

