HatCosmetics - 帽子模型插件

💡注意

此插件已不再由我（Tonus_）继续开发。为了让插件在没有更新的情况下继续运行，2.0.0 及以上版本不再包含插件所依赖的 API——NBT-API。NBT-API 现在是一个必需的依赖项，你可以在此处下载。所有 1.x.x 版本虽然包含此 API，但将无法在未来的 Minecraft 版本中工作。插件的源代码可在其 GitHub 仓库找到。

🎮插件简介

HatCosmetics 提供了一种简单的方法，可以将使用自定义模型数据的自定义资源包模型应用到你的服务器。所有提供的“帽子”都放置在一个可自定义的 GUI 中，玩家只要没有穿戴实际的盔甲并且拥有该帽子的权限，就可以装备它。除了提供获取自定义模型的便捷方式外，插件还包含确保帽子始终保持在玩家头上而非其他位置的功能。

✨功能特性

• 访问所有帽子的 GUI：此 GUI 是插件的主菜单，玩家可以浏览并选择要装备的帽子。他们可以查看所有帽子，但只能装备拥有权限的帽子。帽子周围的边框可以设置为任何物品，包括空气！
• 防止因死亡/背包操作而丢失帽子：即使服务器未开启死亡不掉落，玩家也无法丢弃帽子或将其移动到背包的其他位置（创造模式玩家可以自由移动帽子）。生存模式玩家可以通过使用卸载命令或直接在背包中点击帽子来卸下帽子。
• 无需重启服务器即可重载插件配置：如果你需要快速添加帽子、更改 GUI 大小或物品，无需重启服务器即可使更改生效！
• 完整的帽子与消息自定义：通过自定义名称、描述以及为单个帽子指定特定物品，让你的帽子独一无二。此外，你还可以随心所欲地更改插件的所有提示消息！

🔧指令与权限

插件主指令为 /hats，其别名为 /hatcosmetics。

基础指令

• /hats - 打开帽子选择 GUI。

- 所需权限：`hatcosmetics.hat.<hat>`（用于访问特定帽子）。

• /hats help - 打开插件的指令列表。
• /hats equip <hat> [player] - 为指定玩家装备指定的帽子。

- 所需权限：`hatcosmetics.equip.other`（用于为其他玩家装备）。

• /hats unequip [player] - 移除指定玩家已装备的帽子。

- 所需权限：`hatcosmetics.unequip.other`（用于移除其他玩家的帽子）。

• /hats reload - 重载插件配置。

- 所需权限：`hatcosmetics.reload`。

⭐配置文件预览

config.yml

# HatCosmetics 配置文件版本：3
# 为了你我的方便，请勿更改此版本号！
# 物品列表请参考 Spigot-API Materials：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html

# 所有帽子默认使用的物品：
item: FEATHER
# GUI 中帽子周围的边框物品：
border: LIGHT_BLUE_STAINED_GLASS_PANE
# GUI 中帽子的行数（必须在 1 到 4 之间）
# 此设置仅针对帽子本身，不包括边框和关闭菜单物品的两行
gui_rows: 1

hats:
  # 在此处添加你的帽子
  staffHat:              # 用于 /hats equip 指令和权限的帽子名称
    #item: DIAMOND_HOE  # （可选）仅当此帽子使用与其他帽子不同的物品时设置
    data: 1000101        # 在你的资源包中为此物品定义的自定义模型数据
    name: "&fStaff Hat"  # 物品上显示的名称
    #description:        # （可选）在“Hat Cosmetic”行下方添加描述文本
    #  - ""
    #  - "&bShow who's boss!"

messages.yml

# HatCosmetics 消息文件版本：2
# 为了你我的方便，请勿更改此版本号！
# 可用占位符：
# {hat} - 返回已装备/已卸下帽子的名称

prefix: "&3&lHats"
suffix: " &3&l>> "
gui_title: "&b&lHats"
hat_equip: "&bClick to equip"
hat_unequip: "&bClick to unequip"
hat_not_exist: "&bThat hat does not exist!"
hat_success: "&bYou equipped {hat}&b successfully!"
hat_success_other: "&bThe player equipped {hat}&b successfully!"
hat_unequip_success: "&b{hat}&b has been unequipped!"
hat_unequip_success_other: "&bThat player's {hat}&b has been unequipped!"
helmet_exist: "&bSomething else is already on your head!"
helmet_exist_other: "&bThat player already has something on their head!"
no_hat: "&bYou don't have a hat equipped!"
no_hat_given: "&bYou must specify a hat to equip!"
no_hat_other: "&bThat player doesn't have a hat equipped!"
no_hat_permission: "&bYou do not have permission to equip {hat}&b."
no_hat_permission_other: "&bThat player does not have permission to equip {hat}&b."
no_permission: "&bYou do not have permission to do this."
not_online: "&bThat player is not currently online!"
plugin_reload: "&bPlugin has been reloaded!"

❓如何制作自定义帽子模型

我个人使用一款名为 BlockBench 的程序来制作模型。你可以查看他们的快速入门指南来开始学习。