BetterHats - 生存兼容装饰帽子

BetterHats 现已上线我的服务器！欢迎来到 mc.RonanCraft.net！只需输入 /cosmetica 即可体验！

💡简介

BetterHats 是一款允许玩家在生存或冒险模式下，无需破坏或寻找方块即可将任何方块作为帽子佩戴的插件。玩家通过插件提供的 GUI 菜单选择并装备帽子后，在生存/冒险模式下将无法自行取下，从而保证了游戏平衡性。帽子在玩家死亡时也不会掉落。

✨核心特性

• 可在 menu.yml 文件中或通过命令自由设置任何方块作为帽子。
• 支持启用/禁用 GUI 菜单中的按钮，当物品超过 45 个时自动分页。
• 在生存/冒险模式下，已装备的帽子物品将被锁定，无法被移动或使用。
• 玩家死亡时，其装备的帽子不会掉落。
• 支持实时编辑，几乎无需配置。

🔧安装与使用

快速安装

• 下载 BetterHats.jar 文件。
• 将其放入服务器的 plugins 文件夹。
• 重载或重启服务器，执行 /hats reload 完成配置。

命令列表

命令别名：hats, bhats

• /betterhats - 打开帽子选择菜单（显示 menu.yml 中列出的所有帽子）。
• /betterhats set [玩家] <物品> [物品名称] - 为自己或指定的在线玩家设置帽子。
• /betterhats remove [玩家] - 移除自己或指定玩家的帽子。
• /betterhats add [物品名称] - 将手中持有的物品添加到帽子菜单中（可自定义物品名称）。
• /betterhats reload - 重载插件配置。
• /betterhats help - 显示所有命令帮助。

🎮权限节点

权限采用树状结构，以下是主要节点摘要

• betterhats.use - 使用菜单（默认：true）。
• betterhats.set - 为自己设置帽子（默认：op）。
• betterhats.set.other - 为他人设置帽子（默认：op）。
• betterhats.remove - 移除自己的帽子（默认：op）。
• betterhats.remove.other - 移除他人的帽子（默认：op）。
• betterhats.add - 向菜单添加新帽子（默认：op）。
• betterhats.delete - 从菜单删除帽子（默认：op）。
• betterhats.reload - 重载插件（默认：op）。
• betterhats.updater - 接收插件更新通知（默认：op）。
• betterhats.* - 包含所有权限。

⭐配置与占位符

主要配置

配置文件 (config.yml) 主要包含版本、设置和消息。关键设置包括：

• PermissionToOpenGUI: 控制打开 GUI 是否需要权限。
• EnableGUI: 是否启用 GUI 菜单。
• Messages: 可自定义所有操作提示信息的前缀和内容。

菜单配置

菜单布局和物品在 menu.yml 中定义，支持：

• 自定义菜单标题、分页按钮。
• 为每个帽子物品设置显示名称、材质、描述（Lore）和独立权限。
• 配置“移除帽子”和“删除物品”按钮。

PlaceholderAPI 支持

若已安装 PlaceholderAPI，可使用以下占位符：

• %betterhats_hat% - 返回玩家当前佩戴的帽子名称。

❓注意事项与支持

兼容性说明

• 本插件与 Essentials 等插件的 /hats 命令不兼容，因为它们对不可穿戴物品的保护机制可能冲突。若需使用其他帽子插件，可能需频繁使用 /hats remove 命令。

数据统计 (bStats)

• 本插件会匿名收集服务器数量、核心数、在线玩家等基本统计信息以激励开发者更新。您可以在 bStats 配置文件中选择退出。

支持与反馈

• 需要帮助？ 欢迎加入我们的 Discord 社区：http://discord.gg/8Kt4wKm 或使用代码 8Kt4wKm。
• 如果您喜欢这个插件，请留下五星评价。
• 请将错误报告或功能建议发布在讨论页面。

版权声明

• 您可以分发此插件，但必须保持下载链接指向本页面。
• 禁止复制、重命名或反编译代码并声称是您自己的作品。
• 感谢翻译贡献者：@AfterBurn2point0 (英文), @Maximiliano (西班牙文)。