SkinSetter - 皮肤切换器

💡简介

SkinSetter 是一款允许服务器管理员或玩家自定义角色皮肤的插件。它支持从在线玩家或本地保存的皮肤文件中应用皮肤，并提供皮肤持久化、默认皮肤、随机皮肤等实用功能。请注意，本插件需要 MidnightCore 作为前置插件才能运行。

🎮前置需求

• 必需插件: MidnightCore

🔧基本使用

以下命令可用于管理皮肤。

设置皮肤

• /skin set <玩家> <皮肤名> - 将指定玩家的皮肤设置为一个已保存的皮肤。
• /skin set <玩家> <玩家2> -o - 将指定玩家的皮肤设置为另一个在线玩家的皮肤（需要使用 -o 标志）。
• /skin setrandom <玩家> - 为指定玩家随机设置一个已保存的皮肤。

保存与管理皮肤

• /skin save <玩家> <名称> - 将玩家当前应用的皮肤保存到本地磁盘。
• /skin reset <玩家> - 将玩家的皮肤重置为其登录时的默认皮肤。
• /skin reload - 从磁盘重新加载所有已保存的皮肤。

默认与持久化设置

• /skin setdefault <名称> - 设置一个默认皮肤，将应用于所有没有自定义皮肤的玩家。
• /skin cleardefault - 移除已设置的默认皮肤。
• /skin persistence [enable/disable] - 启用或禁用皮肤持久化功能。

高级编辑

• /skin edit <皮肤名> - 编辑已保存皮肤的各项属性，如显示名称、关联物品、所属分组等。
• /skin head <皮肤名> - 给予自己一个应用了指定皮肤的头颅物品。

✨配置说明

主要配置文件为 config.yml，包含以下两个主要字段：

• persistent_skins: [true/false] - 设置为 true 时，服务器将在玩家离开后保留其自定义皮肤，并在其重新加入时自动应用。
• default_skin: <皮肤名称> - 设置一个默认皮肤的名称，该皮肤将应用于所有没有其他自定义皮肤的玩家。

皮肤文件

插件会在配置目录的 skins 文件夹中查找所有 .yml 文件来加载已保存的皮肤。每个文件应包含一个名为 skins 的列表。

每个皮肤的格式如下（除 id 和 skin 字段外，其余均为可选）：

id: "[皮肤ID]"
skin:
  uid: "[UUID]"
  b64: "[皮肤数据]"
  sig: "[皮肤签名]"
name: "[显示名称]"
item:
  type: "[物品ID]"
  count: 1
  tag: [NBT数据]
in_random_selection: true
groups:
  - "[分组名称]"

你可以参考 sample-skins.yml 文件来了解完整的皮肤配置示例。

⭐权限列表

• skinsetter.command.set - 允许使用 /skin set 命令应用已保存的皮肤。
• skinsetter.command.set.online - 允许使用 /skin set 命令应用在线玩家的皮肤（需 -o 标志）。
• skinsetter.command.setrandom - 允许使用 /skin setrandom 命令。
• skinsetter.command.reset - 允许使用 /skin reset 命令。
• skinsetter.command.save - 允许使用 /skin save 命令。
• skinsetter.overwrite_skins - 允许在使用 /skin save 时覆盖已存在的同名皮肤。
• skinsetter.command.reload - 允许使用 /skin reload 命令。
• skinsetter.command.setdefault - 允许使用 /skin setdefault 命令。
• skinsetter.command.cleardefault - 允许使用 /skin cleardefault 命令。
• skinsetter.command.persistence - 允许使用 /skin persistence 命令。
• skinsetter.command.edit - 允许使用 /skin edit 命令。
• skinsetter.command.head - 允许使用 /skin head 命令。

❓重要提示

关于 3.0.0 版本更新

SkinSetter 3.0.0 版本与旧版本的配置文件不兼容。在启动服务器时，插件会尝试自动将旧的皮肤数据更新到新格式。建议在更新前备份原有配置。

已保存皮肤与在线皮肤

当使用 /skin set <玩家> <名称> 命令时，如果 <名称> 与一个已保存的皮肤同名，插件默认会应用该已保存的皮肤。

如果你想应用一个在线玩家的皮肤，必须在命令末尾加上 -o 标志，例如：/skin set Steve Alex -o。