开源地址：Github (opens new window)

FiguraAvatars 自带一个示例外观，外观原件来自 Gakuto1112 (opens new window)，由 MrXiaoM 进行汉化，并针对服务器生态移除了 Ex-Skill 的触发方式。

这篇文档将向你展示这个示例外观是如何制作的。

创建文件夹

首先，在插件目录下的 avatars 文件夹里创建一个文件夹，比如 hoshino。文件夹名称即外观ID。

然后，创建一个配置文件 metadata.yml，写入以下内容，请自行修改相关配置。

# 外观配置文件
# 在 avatars 文件夹中，每个子文件夹都代表「一个外观」，文件夹名称即为外观的ID
# 在子文件夹中，必须要有以下文件
#   metadata.yml（本文件，外观的额外元数据）
#   *.moon 或 *.nbt（外观通过 /figura export 命令导出的文件，任意文件名都可，只能有一个，放多个文件只会读取第一个）

# 在菜单上显示的物品图标
material: PAPER
custom-model-data: 10000
# 显示名称，如果注释掉此选项，则使用外观文件中的名称
display: '小鳥遊　星野'
# 描述，显示在菜单中
description:
  - '&e电子游戏&f「&b蔚蓝档案&f」&e的角色'
  - '&e小鸟游星野 &7(Hoshino Takanashi)'
# 外观相关权限，注释相关选项，则无需权限
permissions:
  # 在界面中查看的权限
  view: 'figura.view.default'
  # 外观使用权限
  equip: 'figura.avatars.hoshino'

然后，在游戏中（可不连接到服务器）切换到相应的本地外观，输入命令 /figura export avatar 导出文件，导出的文件会出现在 游戏目录/figura/exported_avatar.nbt。

游戏目录 通常是 .minecraft/，如果开启了版本隔离，就是 .minecraft/versions/版本/。

将导出的 exported_avatar.nbt 文件复制到与 metadata.yml 同一个目录。文件名可改可不改，文件夹中必须要有且只有一个 .nbt 或 .moon(老版本后缀) 文件。

如果你要二次发布由别人制作的外观，请自觉遵守相关的协议，比如本插件借用 Gakuto1112 制作的外观作为示例配置，就带上了发布仓库中的 MIT License 一同发布。

所有文件都准备好后，使用 /avatars reload 命令重载插件即可。

给予玩家权限

你也看到了，配置中有外观相关权限配置，如果设置了权限，需要给予玩家相应的权限，玩家才能预览或切换到该外观。