衣柜

在 Hytale 商店结账时使用创作者支持代码 JACKSON

 

概述

Wardrobe 是 Hytale 的一款可自定义装饰模组，让创作者能在资源包中添加可自定义的装饰，而无需添加新的盔甲物品！

Wardrobe 默认不附带任何装饰。你必须安装或创建一个添加装饰的资源包。

装饰支持 Hytale 装饰的所有功能，例如渐变套装颜色、纹理变体、模型选项等！资源包甚至可以添加新的装饰槽位和类别，以防你的装饰不适合默认类别。装饰的外观还可以根据玩家穿戴的盔甲和其他装饰来显示不同的外观。

玩家可以通过制作并交互新的“装饰镜”方块，或使用命令 /wardrobe，来访问熟悉的角色自定义界面。

利用 Wardrobe 可扩展的 API，开发者可以创建附加组件，以添加专门的装饰类型，使其与你的模组或服务器配合，并直接挂接到自定义菜单中。该 API 目前仍在开发中，我们需要你的反馈！    

创建新装饰

Wardrobe 是一个极其灵活且可自定义的装饰系统。它尽可能还原 Hytale 的装饰系统，这意味着所有装饰都支持与 Hytale 装饰相同的功能，仅存在一些差异。

这些功能包括（但不限于）：

• 纹理变体（变体）
• 外观变体（模型选项）
• 渐变套装颜色
• 感知盔甲的外观
• 感知装饰的外观

装饰系统目前有两种装饰类型：模型附着物和玩家模型。Wardrobe 附加组件的开发者可以使用我们的 API，添加 Wardrobe 菜单支持的装饰类型。

玩家模型

玩家模型装饰是 Wardrobe 添加的一种特殊装饰类型。这种装饰类型允许你定义一个服务器 ModelAsset 来作为玩家的模型。玩家模型使用与 /model 菜单中相同的模型，意味着你可以定义自定义动画、摄像机属性、碰撞箱等。

它们不仅支持自定义模型，而且玩家模型装饰与 Wardrobe 中的任何其他装饰一样。它们可以支持模型选项、纹理变体、渐变套装，甚至可以在特定槽位与模型不兼容时隐藏其他装饰槽位。

玩家模型装饰不支持感知装饰或感知盔甲的外观。我们希望尽快为所有装饰带来条件外观系统！

模型附着物

Wardrobe 和 Hytale 中的大多数装饰都是模型附着物。这些是简单的装饰，使用内置的模型附着系统将一个公共 blockymodel 资源附着到你的玩家身上。模型附着物支持所有装饰功能。

   

Wardrobe 菜单

玩家可以通过新的“装饰镜”访问 Wardrobe 菜单！装饰镜可以用 五个金属棒（任意类型）和 三个白色水晶碎片 制作。它可以放在地上或墙上，交互后，新的 Wardrobe 菜单将打开，你可以随心所欲地自定义你的角色！

您也可以在聊天中使用 /wardrobe 命令访问该菜单。服务器管理员可以使用权限节点 hardaway.wardrobe.commands.wardrobe 更改此命令的权限。

Wardrobe 菜单看起来非常熟悉！它的设计旨在与 Hytale 角色编辑器相似，因此玩家已经知道如何操作。创作者可以在资源包中添加新的类别和装饰槽位，以及装饰变体和选项。装饰变体允许玩家自定义其装饰的纹理/颜色，而选项则允许更高级的外观，例如不同的模型配置。

注意：官方 Hytale 装饰不包含在 Wardrobe 的菜单中，也无法在游戏中更改。当你加入服务器时，你装备的 Hytale 装饰将被视为你的默认外观。Wardrobe 装饰将覆盖任何占据相同槽位的 Hytale 装饰。

搜索栏旁边还有一个“隐藏默认装饰”按钮。启用后，占据该槽位的 Hytale 装饰将被隐藏，以防它与你的自定义角色风格不匹配。某些装饰（例如面部、眼睛、耳朵、内衣和身体特征）无法使用此按钮隐藏。制作不支持这些类型的玩家模型装饰的创作者应考虑使用 HiddenCosmeticSlots 字段来隐藏它们。

   

面向创作者和开发者

Wardrobe 使用 Hytale 提供的内置资源存储系统。这意味着所有装饰资源（装饰、槽位、类别）都受游戏内资源编辑器的支持，并且可以实时重新加载。

在 JSON 文件中定义你的装饰，将它们指向你的模型和纹理，它们将自动出现在 Wardrobe 菜单中。添加新装饰无需任何代码！

该系统设计灵活且强大。你可以添加具有单纹理模型的简单装饰，或具有多种变体、颜色选项、感知盔甲外观和重叠检测的复杂装饰。装饰还可以隐藏冲突的槽位，或仅限于具有特定权限的玩家使用。

在你的资源包中，装饰 JSON 应存储在 <你的资源包>/Server/Wardrobe/Cosmetics/<装饰_id>.json 路径下。如果需要组织，它们可以放在子文件夹中。公共资源（如 blockymodel、动画和纹理）应位于 <你的资源包>/Common/ 目录中。这些资源需要根据资源类型放置在特定的子文件夹中。有关构建资源包结构的更多信息，请参阅 Hytale 文档。

模型附着物

请参阅 GitHub 上的 模型附着物

 

渐变套装

装饰还支持使用带有渐变套装的灰度纹理。这些是游戏内置的颜色集，用于提供手工调制的调色板。如下例所示，此装饰使用了 Colored_Cotton 渐变套装。这将自动提供渐变套装中所有可用的颜色，并为 GrayscaleTexture 字段中提供的灰度纹理上色。这些颜色将显示在 Wardrobe 菜单的“变体”部分下。

请参阅 GitHub 上的 渐变套装

 

纹理变体

要为同一模型提供多种纹理而不使用渐变套装，请使用变体纹理配置。模型保持不变，但玩家可以在不同纹理之间进行选择。WardrobeColor 数组定义了菜单中显示的预览颜色。数组中的每种颜色都是一个色条（请参阅 Wardrobe UI 概述）。

与渐变套装一样，这些变体显示在 Wardrobe 菜单的“变体”部分下。

请参阅 GitHub 上的 纹理变体

 

外观变体

要提供完全不同的模型作为选项，请使用变体外观。这些显示在 Wardrobe 菜单的“选项”下拉菜单中。

请参阅 GitHub 上的 外观变体

 

玩家模型

玩家模型稍有不同。虽然它们与模型附着物具有相同的结构，但 外观 中的 Model 字段处理方式不同。

对于玩家模型，Model 字段是一个 ModelAsset ID，而不是公共资源路径 blockymodel。模型资源可以在 Server/Models/ 文件夹中找到，并可由其他资源包添加。这些资源定义了动画、眼睛高度、碰撞箱等属性。

这些装饰应尽量始终放在 BodyCharacteristic 槽位中，以减少潜在的冲突。玩家模型装饰会完全覆盖玩家模型的基础，这意味着放置在不同槽位的任何其他玩家模型装饰可能会争夺显示哪个模型。

请参阅 GitHub 上的 玩家模型

 

你还可以组合多个方面，并拥有一个变体外观，其颜色选择会根据玩家选择的选项而变化。

有关所有功能、配置选项和高级装饰功能的完整文档，请参阅 Wiki（文档仍在编写中！），查看 Violet's Wardrobe 的源代码作为示例包，或加入我们的 Discord 以获得直接帮助。

 

署名声明：本页截图和示例材料中使用的所有装饰资源均来自 Violet's Wardrobe，并经 Violet 许可使用 :)