VRoid Studio 中文学习官网 3D人物建模软件

换装功能功能介绍佩戴饰品

Fri, 22 May 2026 09:21:47 +0800

本页面讲解如何佩戴配饰。我们将以cacao的“颈挂式相机 | 相机及背带
”为例进行说明。下表列出了服装和配饰在搭配功能上的区别。

	戏服	配件
文件格式	XWear	XWear
移动、缩放、旋转	能	能
动画过程中遵循的骨骼设置	无法完成（髋关节已修复）	是的（初始值为空）

配饰与服装一样，被视为 XWear 文件，但主要区别在于你可以设置骨骼来跟随它们移动。
这项功能允许你灵活地放置配饰，例如让帽子跟随头部移动，或让手镯跟随手臂移动。

为了进一步说明具体规则，
每个 XWear 物品都会附加一个 HumanoidMapComponent 或 AccessoryEditRootComponent。
（如果未附加，则无法加载。）

在 VRoid Studio 中加载 XWear 文件时，如果 AccessoryEditRootComponent 位于根目录
，则该物品将被视为独立配饰；如果位于根目录之下，则该物品将被视为套装内配饰。

如果 AccessoryEditRootComponent 不存在，则
在 SkinnedMeshRenderer 中使用 Humanoid 骨骼作为权重目标的物品将被视为套装，而未使用 Humanoid 骨骼作为权重目标的物品将被视为配饰
。

此外，使用除 SkinnedMeshRenderer 或 MeshRenderer 之外的其他渲染器的物品
也将被视为配饰。

如何出口配件

饰品可以导出为 XWear 文件。
详情请参阅以下帮助。

▼如何转换为 XWear 数据
https://vroid.pixiv.help/hc/ja/articles/38730429718041

如果您在“8. 设置选择”中选择“设置为饰品”，即可将饰品导出为 XWear 文件。

如何在VRoid Studio中佩戴它

1. 进口配件

点击“添加服装”，打开配饰的 XWear 文件。
配饰的初始位置是根据导出时的数据状态确定的。

2. 将配件调整到所需位置。

就像换衣服一样，移动、旋转、调整配饰的大小，将它们调整到你想要的位置。

3. 设置骨骼跟随。

默认情况下，饰品跟随的骨骼被设置为空（Null）。
当物体静止不动时，这没有问题，但在动画过程中可能会导致不自然的运动。
因此，您需要设置饰品跟随合适的骨骼。

由于目标骨骼默认为空，饰品不会跟随角色移动，因此

有两种方法可以设置饰品跟随的骨骼：
直接从列表中选择，或者选择3D模型上显示的骨骼。
这里，我们将解释后一种方法。

点击要选中的骨骼的“选择骨骼”按钮。
在3D模型中点击目标骨骼。
在本例中，摄像机位于胸部上方，因此请点击该区域（上胸部）。

点击后，骨骼将高亮显示。
点击底部的“确认”按钮。点击“确认”按钮将完成目标对象的骨骼设置。
检查动画是否按预期运行。
如果未按预期运行，请更改动画所跟随的骨骼。

常问问题问：Unity 中的显示不正确（眼睛周围的区域是黑色/粉色的）。

Fri, 22 May 2026 09:20:20 +0800

答：必要的着色器可能没有导入到项目中。

如果模型材质中使用的着色器未包含在项目中，模型可能无法正确显示。对于

VRoid Studio 模型和VRM格式模型，需要 MToon 着色器才能正确显示。您可以通过在项目中安装 UniVRM 来使用 MToon。

▼在此处下载 UniVRM：
https://github.com/vrm-c/UniVRM/releases

例如，对于 VRoid Studio 模型，如果没有 MToon，透明度可能无法正常工作，导致眼睛周围或部分服装显示为黑色。

左图：模型在未安装 MToon 的项目中显示（眼睛周围显示为黑色）
右图：模型显示正常

如果您的模型显示状态如左图所示，请安装 UniVRM，然后重新导入 XAvatar。

同样，对于 VRChat 模型，您需要将每个头像、服装和配饰的相应着色器导入到项目中。

由于缺少必要的着色器，服装会显示为粉红色。

在 XWear Package v0.3.1 及更高版本中，只有当 XAvatar 使用的着色器包含在项目中时，才能导入 XAvatar。

有关如何更新 XWear Packager 的说明，请参阅以下帮助页面：

▼如何安装 XWear Packager
https://vroid.pixiv.help/hc/ja/articles/38903414455449

常问问题问：我无法使用自动服装试穿功能。

Fri, 22 May 2026 09:20:02 +0800

答：该服装可能与自动合身功能不兼容。

如果服装的臀部骨骼在 HumanoidMapComponent 中注册为 HumanoidBones，则启用自动适配功能。

在XWear Packager的XWear自动设置中，分配权重的骨骼被设置为 HumanoidMapComponent 中的 HumanoidBones。

在这种情况下，对于没有臀部骨骼或没有为其分配权重的服装（例如仅由手套或鞋子组成的服装），臀部不会自动设置为人形骨骼。

之所以对于没有臀部的服装禁用自动适配功能，


是因为这项规范旨在尽可能保留服装原有设计的同时调整尺寸。
为了避免意外的尺寸变化，
如果HumanoidBones中没有臀部，则自动适配功能将被禁用。

对于有臀部骨骼的服装，即使服装数据只包含手套和鞋子，也可以通过在 HumanoidMapComponent 中手动将臀部注册到 HumanoidBones 来使用自动适配。

常问问题问：我导入到 VRoid Studio 中的配件看起来很奇怪（它们消失了/小装置的位置不对）。

Fri, 22 May 2026 09:19:32 +0800

答：原产地可能远离配件。

在 VRoid Studio 的换装功能中，配件小工具（用于移动配件的箭头）会出现在配件的原点。

如果原点设置得离配件本体很远，那么在放大配件时，该装置可能会移出屏幕。

相反，将小工具放在屏幕上有时会导致你找不到自己的配件。

缩小相机镜头或隐藏底座模型可能有助于您找到丢失的配件或小工具。

XWear 配件将 AccessoryRootComponent 的“自动适配原点”作为其原点。

通过将 AccessoryRootComponent 的“自动安装原点”设置为靠近配件本身的位置，可以避免此问题。

常问问题问：当我尝试打开一个启用了 XWear Packager 的项目时，它会启动到安全模式。

Fri, 22 May 2026 09:19:07 +0800

A：请检查您的项目设置。

使用XWear Packager需要以下环境。

VRChat 创建者助手 (VCC)

Unity2022 头像项目
Unity 版本：2022.3.22f1
VRChat SDK 版本：Avatars 3.7.1 或更高版本

不同版本的 Unity 或 VRChat SDK 可能会导致应用程序无法正常启动或出现意外行为。

请检查上述环境并重试。

常问问题问：VRM0.x 版本是否不支持导出功能？

Fri, 22 May 2026 09:18:29 +0800

A：VRM0.x 版本不支持导出。

为了尽可能准确地在VRM中重现VRChat 启发的数据中使用的表达式，服装更换功能的导出使用了 VRM 1.0。

例如，以下是 VRM 1.0 中新增的功能。

胶囊碰撞器（SpringBone 中已将胶囊碰撞器类型添加到碰撞器类型中）
调整每个 SpringBone 关节的振荡行为（现在可以使用 VRM1.0 的 SpringBoneJoint 实现）
MatCap 的遮罩功能（在 VRM 1.0 的 MToon10 着色器中添加）

VRM0.x 还可以用于导入到换装功能中以及从VRoid 编辑中导出。

有关 VRM 的更多信息，请访问此处（外部网站）：
https://vrm.dev/

常问问题问：我可以在不使用 Unity 的情况下使用它吗？

Fri, 22 May 2026 09:17:35 +0800

答：即使没有 Unity，你也可以更换服装并导出为 VRM。

服装更换功能以两种形式提供：作为 VRoid Studio 中的一个功能，以及作为 Unity 编辑器扩展（XWear Packager ）。

VRoid Studio 中的各项功能可以单独与 VRoid Studio 一起使用。

VRChat Creator Companion (VCC) 使用了 Unity 编辑器扩展程序 (XWear Packager)，因此需要 Unity 才能使用其功能。

▼点击此处查看如何使用 XWear Packager 的说明：
如何安装 XWear Packager

即使没有 Unity 也能使用的功能

VRoid Studio 提供以下功能：

换衣服
编辑换装功能的编辑数据（ XRoid ）。
导出为 XAvatar 格式
导出为VRM1.0格式。
将 .vroid 或 .vroidcustomitem 服装和配饰导出为 XWear。

▼如何更换服装：服装更换功能入门（适合喜欢更换服装的用户） ▼如何导出为 XAvatar 格式：用于 VRChat ▼如何导出为 VRM 1.0格式：用于 VRM 格式▼如何将 .vroid 或 .vroidcustomitem 服装和配饰导出为 XWear：将VRoid Studio 服装和配饰转换为 XWear

Unity所需的功能

VCC 上安装的 XWear Packager 具有以下功能：

将自定义模型导入VCC。
将VRChat头像转换为XAvatar格式。
将 VRChat 服装和配饰转换为 WXear 格式。

▼ 如何将修改后的模型导入 VCC（
用于 VRChat）

 ▼ 如何将 VRChat 头像转换为 XAvatar 格式
（使 VRChat 兼容的头像与换装功能兼容 - XAvatar 转换）

 ▼ 如何将 VRChat 兼容的服装和配饰转换为 WXear 格式（
使 VRChat 兼容的服装和配饰与换装功能兼容 - XWear 转换）

XWear Packager 显示的错误和警告列表

Fri, 22 May 2026 09:17:06 +0800

错误列表

显示的信息	显示条件	如何修复
要输出的游戏对象处于非活动状态。	当目标游戏对象处于非活动状态时，会出现此错误。	请激活您想要输出的游戏对象。您也可以使用“自动纠错”按钮。
请指定要输出的游戏对象。	当没有设置要输出的游戏对象时，会出现此消息。	在“导出目标”字段中，将要输出为 .xwear/.xavatar 文件的 GameObject 设置为。
子节点包含空值。	如果在生成 .xavatar 文件时，包含的服装列表中有任何未设置的项目，则会显示此消息。	请删除任何未配置的部分，或配置所包含服装的设置。
导出为头像时，根游戏对象必须附加一个动画器。	如果 .xavatar 文件不是人形角色，则会显示此消息。生成 .xavatar 文件时必须附加动画器，因为它用于识别人形角色。	将动画器附加到要输出为 .xavatar 的游戏对象的根目录，并配置相应的 UnityEngine.Avatar 设置。
导出为头像时，导出目标必须是人形角色。	当 .xavatar 文件不是人形时，会出现此消息。附加到根目录的 UnityEngine.Avatar 文件不是人形，因此无法输出。	.fbx 导入设置可能设置为“通用”。请检查并设置正确的 UnityEngine.Avatar。
要输出头像，必须附加 HumanoidMapComponent 组件。您可以从窗口进行自动配置，也可以手动配置。	HumanoidMapComponent 组件允许服装自定义功能识别人形骨骼。如果该组件未附加到目标游戏对象，则在导出为 .xavatar 文件时会显示该组件。	将 HumanoidMapComponent 附加到动画器所附加的游戏对象上。您可以按“自动校正”按钮自动附加它。
要输出为服装，必须附加 HumanoidMapComponent 或 AccessoryRootComponent。您可以从窗口进行自动配置，也可以手动配置。	HumanoidMapComponent 是换装功能用来识别人形骨骼的组件。AccessoryRootComponent 是换装功能用来识别饰品的组件。导出为 .xwear 文件时，如果这两个组件都没有附加到目标游戏对象上，则会显示该文件。	将 HumanoidMapComponent 或 AccessoryRootComponent 附加到要输出的游戏对象上。按下“设置为服装”按钮会自动附加 HumanoidMapComponent，按下“设置为配件”按钮会自动附加 AccessoryRootComponent。
AccessoryRootComponent 所依附的层级结构是嵌套的。	AccessoryRootComponent 是装扮功能用来识别配件的组件。当此组件所附加的层级下方存在其他 AccessoryRootComponent 层级时，它会被显示。	请移除子层级结构中的 AccessoryRootComponent。
HumanoidMapComponent 所依附的层级结构是嵌套的。	AccessoryRootComponent 是装扮功能用来识别配件的组件。当此组件所附加的层级结构下方存在更深层的 HumanoidMapComponent 层级结构时，它会被显示。	请删除子层级结构中的 HumanoidMapComponent。
HumanoidMapComponent 没有骨骼。	HumanoidMapComponent 是服装更换功能用来识别人形骨骼的组件。如果此组件注册的骨骼为空，则会显示错误消息，因为这是不允许的。	您需要正确配置 HumanoidMapComponent。按下“自动修复”按钮即可自动配置。如果附加了动画器，请在 UnityEngine.Avatar 中进行配置。否则，它将根据变换名称自动配置。
HumanoidMapComponent 包含空值。	HumanoidMapComponent 是服装更换功能用来识别人形骨骼的组件。如果此组件中注册的骨骼值为空，则会显示错误消息，因为这是不允许的。	请检查 HumanoidMapComponent 的设置并配置相应的骨骼。
HumanoidMapComponent 中包含相同的 HumanBodyBones。	HumanoidMapComponent 是服装更换功能用来识别人形骨骼的组件。如果设置了相同的 HumanBodyBones，则会显示错误消息。	请检查 HumanoidMapComponent 的设置并配置相应的骨骼。
同一个 Transform 也注册在 HumanoidMapComponent 中。	HumanoidMapComponent 是服装更换功能用来识别人形骨骼的组件。如果存在相同的骨骼组，则会显示错误信息。	请检查 HumanoidMapComponent 的设置并配置相应的骨骼。
以下组件只能附加到输出游戏对象：HumanoidMapComponent 或 AccessoryRootComponent。	HumanoidMapComponent 是换装功能用来识别人形骨骼的组件。AccessoryRootComponent 是换装功能用来识别配件的组件。当HumanoidMapComponent 和 AccessoryRootComponent都附加到待输出游戏对象的根节点时，它们才会显示。待输出游戏对象只能附加 HumanoidMapComponent 或 AccessoryRootComponent 中的一个。	根据要输出的内容，删除其中一个组件。
附加了多个 HumanoidMapComponents。	HumanoidMapComponent 是服装更换功能用来识别人形骨骼的组件。由于不允许在目标游戏对象的根节点上附加多个此类组件，因此会显示错误消息。	请移除所有不必要的HumanoidMapComponents组件。
已附加多个 AccessoryRootComponents。	AccessoryRootComponent 是装扮功能用来识别配件的组件。由于不允许将多个此类组件附加到目标 GameObject 的根对象，因此将显示错误消息。	请移除所有不必要的 AccessoryRootComponents。
当前激活的蒙皮网格渲染器引用了一个未被渲染的骨骼。	当一个设置为不输出的 GameObject 包含被输出 SkinnedMeshRenderer 引用的骨骼时，会显示此消息。在此状态下不允许输出，以防止因未输出网格引用的骨骼而导致网格损坏。	按下“检查目标”按钮，即可查看哪些骨骼处于非活动状态。您需要激活目标游戏对象，或者停用蒙皮网格渲染器所附加的游戏对象。
HumanoidMapComponent所需的骨骼尚未注册。导出为头像时，必须注册动画器引用的头像骨骼。	HumanoidMapComponent 是换装功能用来识别人形骨骼的组件。当动画器附加到游戏对象时，HumanoidMapComponent 的内容会与动画器中从 UnityEngine.Avatar 获取的人形骨骼进行比较。如果动画器中存在任何未在 HumanoidMapComponent 中注册的人形骨骼，则会显示出来。	请检查 HumanoidMapComponent 的设置。您也可以删除 HumanoidMapComponent，让 XWear Packager Window 自动配置。
HumanoidMapComponent 注册了一些动画师引用的 Avatar 所不具备的骨骼。	HumanoidMapComponent 是换装功能用来识别人形骨骼的组件。当动画器附加到游戏对象时，HumanoidMapComponent 的内容会与动画器中从 UnityEngine.Avatar 获取的人形骨骼进行比较。在此过程中，如果 HumanoidMapComponent 中设置的骨骼并非动画器中获取的人形骨骼，则会显示出来。	请检查 HumanoidMapComponent 的设置。您也可以删除 HumanoidMapComponent，让 XWear Packager Window 自动配置。
有一个渲染器不引用任何材质。	当 MeshRenderer 或 SkinnedMeshRenderer 中的材质引用包含空值时，会出现此消息。	请检查渲染器中的材质参考设置。

警告列表

显示的信息	显示条件	如何修复
SkinnedMeshRenderer 引用了空骨骼。这些空骨骼将在输出时从网格引用中移除。原始数据不会被修改。	当 SkinnedMeshRenderer 引用的骨骼包含空值时，会显示此消息。例如，如果从场景中删除了 SkinnedMeshRenderer 引用的 GameObject，则可能会引用空骨骼。	输出过程中，空值会自动移除，并调整绑定姿势和骨骼权重。原始数据不会被修改。
没有影响力的骨骼将不包含在输出中。	当“不输出的游戏对象”设置设为“非活动或不受影响的骨骼”时，会显示此消息。在这种情况下，仅被蒙皮网格渲染器引用且未输出的骨骼将从输出中排除。此警告会显示被排除对象的列表。	如果有一些游戏对象需要输出，可以在“不输出的游戏对象设置”部分中将它们设置为“全部输出”。
此文件包含一个未引用网格的 SkinnedMeshRenderer。此 SkinnedMeshRenderer 将不会被输出。	当 SkinnedMeshRenderer 没有引用网格时，就会出现这种情况。在这种情况下，SkinnedMeshRenderer 将不会包含在输出中。	如果正确指定网格，或者在不再需要时移除 SkinnedMeshRenderer，则警告将消失。
HumanoidMapComponent 组件没有定义 Hips 属性。因此， VRoid Studio 中无法执行自动适配。	当 HumanoidMapComponent 中未设置 Hips 属性时，会出现此消息。由于 VRoidStudio 的自动适配功能是基于基础模型和服装的 Hips 属性计算的，因此在此状态下无法执行自动适配。	将 HumanoidMapComponent 设置为 Hips 可以防止出现此警告。
已找到与动画器中定义的骨骼结构完全相同的骨骼结构。您可能需要合并骨骼。原始数据不会被编辑。	当在目标游戏对象下找到与动画器中人形角色定义具有相同层级结构的游戏对象时，会显示此消息。显示此警告是因为角色换装可能无法正确执行。	按下“合并骨骼”按钮，即可将动画器中定义的具有相同层级结构的骨骼合并为类人骨骼。原始网格数据和其他元素将不会被编辑。
在动画器中定义的骨骼结构下，发现了一个同名的子骨骼。您可能需要合并这些骨骼。原始数据不会被修改。	当动画器输出中发现与人形骨骼同名的子骨骼时，就会出现此消息。显示此警告是因为它可能会导致服装更换无法正确执行，或者服装无法正确编辑。	按下“合并骨骼”按钮，即可将同名骨骼合并到动画器中定义的人体骨骼中。原始网格数据不会被修改。
SkinnedMeshRenderer 引用了重复的骨骼。输出过程中，网格将被编辑以消除重复部分。原始数据不会被修改。	当 SkinnedMeshRenderer 中存在重复的骨骼引用时，会出现此警告。在 Unity 编辑器中编辑网格或其他元素时，可能会出现重复的骨骼引用。如果存在重复的骨骼，则服装更换过程无法正确执行，因此会出现此警告。	输出过程中，重复数据会自动删除，并且会调整绑定姿势和骨骼权重。原始数据不会被修改。
输出目标的坐标不在原点。它们会在输出过程中被移动到原点。	导出基础模型或服装时，如果目标游戏对象不在原点，则会显示此消息。	输出时，物体将自动移动到原点。场景状态不会改变。
子网格和材质的数量不同。输出时，网格将进行编辑以匹配子网格和材质的数量。原始数据不会被修改。	当渲染器使用的子网格和材质数量不同时，就会出现此消息。例如，当通过移除子网格来部分隐藏网格时，就可能出现这种情况。	输出过程中，每个网格的子网格数量和材质会自动调整。原始数据不会被修改。

词汇表什么是“unitypackage”？

Fri, 22 May 2026 09:15:35 +0800

本节解释 VRoid Studio 换装功能中出现的术语“unitypackage”。

*本说明专门针对 VRChat 头像、服装和配饰的 Unity 包。

unitypackage

它是 Unity 中使用的数据格式之一。

您可以管理为 VRChat 设置好的虚拟形象、服装和配饰。

这会将 unitypackage 中包含的、为 VRChat 设置的预制件转换为 XAvatar 或 XWear 格式，以便与换装功能一起使用。

▼ 如何转换头像数据：
使 VRChat 兼容的头像与换装功能兼容（XAvatar 转换）

▼ 如何转换服装和配饰数据：
使 VRChat 兼容的服装和配饰与换装功能兼容（XWear 转换）

可用软件

统一

词汇表

学期	概述	可用软件
▼ 换装功能
X化身	用于服装更换功能的虚拟形象数据。此数据也用于将更换后的模型上传到 VRChat。	VRoid Studio （仅限换装功能） Unity （需要 VCC 和 XWear Packager）
XWear	角色扮演活动中使用的服装和配饰数据。	VRoid Studio （仅限换装功能） Unity （需要 VCC 和 XWear Packager）
XRoid	保存换装功能的数据。网格删除和服装变形可以以可逆的方式保存。	VRoid Studio （仅限换装功能）
XWear 包装器	这是一个 Unity 编辑器扩展，提供角色服装更换功能。它允许您创建 XAvatar 和 XWear。此外，在将修改后的模型上传到 VRChat 时也会用到它。	Unity（需要 VCC）
▼VRoid 编辑
.vroid	用于VRoid Studio编辑功能的数据编辑。它可以用作换装功能中的虚拟形象数据。	VRoid Studio （VRoid 编辑和换装功能）
定制商品	这指的是VRoid Studio编辑功能处理的每个部件的数据。服装和配饰可以导出为XWear格式。	VRoid Studio （仅限 VRoid 编辑）
▼其他
车辆参考模块 (VRM)	一种用于处理角色头像的常用文件格式。它可以用作换装功能中的头像数据。	VRoid Studio （编辑功能仅限于换装功能） Unity（需要 OkiVRM）
FBX	其中一种3D文件格式。在VRChat中设置完成后，它会被转换为XAvatar或XWear格式以供使用。	建模软件 Unity等。
unitypackage	一种可以处理VRChat中设置的虚拟形象、服装和配饰的数据格式。它可以转换为XAvatar或XWear格式，以便在换装功能中使用。	统一

词汇表什么是“FBX”？

Fri, 22 May 2026 09:15:13 +0800

本节解释 VRoid Studio 换装功能中出现的术语“FBX”。

FBX

它是3D文件格式之一。

该数据包含在 VRChat 的虚拟形象、服装和配饰数据中。

虽然它可以存储各种数据，例如网格、骨骼和材质，但 VRChat 需要单独的设置。

因此，为 VRChat 创建的头像、服装和配饰通常以预配置的unitypackages的形式提供。

服装定制功能允许您将为 VRChat 设置的预制件视为头像、服装和配饰，方法是将它们转换为 Xavatar 或 XWear 格式。

▼如何使用VRChat设计的虚拟形象进行换装：
使VRChat设计的虚拟形象与换装功能兼容（XAvatar转换）

▼如何将VRChat设计的服装和配饰与换装功能配合使用：
使VRChat设计的服装和配饰与换装功能兼容（XWear转换）