HeroAction - 英雄动作栏消息插件

HeroAction 是一款轻量且功能丰富的 Minecraft 插件，它能在玩家的屏幕上方（即 ActionBar）显示自定义信息。插件易于使用且高度可配置，支持多世界、变量替换、音效，并集成了 PlaceholderAPI 以提供更多可能性。

💡核心特性

• 易于使用：安装即用，配置简单直观。
• 高度可配置：从消息内容到显示时间均可自定义。
• 多世界支持：可指定仅在特定世界显示消息。
• PlaceholderAPI 支持：可使用大量外部变量来丰富消息内容。
• 可切换音效：消息更新时可播放自定义音效。
• 绕过权限：可为拥有特定权限的玩家禁用消息。
• 消息间隔：可设置消息之间的等待时间。
• 即时刷新：配置重载后消息立即更新。
• 消息开关：玩家可自行开关消息显示。
• 彩虹色消息：支持动态变化的彩色文本。

🎮内置变量

插件内置了以下变量，可直接在消息中使用

• %player% - 玩家名称
• %world% - 玩家所在世界名称
• %online% - 服务器在线玩家数
• %max_players% - 服务器最大玩家数
• %date% - 当前日期
• %time% - 当前时间
• %total_memory% - 总内存
• %free_memory% - 空闲内存
• %used_memory% - 已用内存
• %health% - 玩家生命值（以心形图标显示）
• %food% - 玩家饥饿值（以咖啡杯图标显示）
• %rainbow% - 随机颜色

如需更多变量，请安装 PlaceholderAPI 并参考其 占位符列表。

🔧配置说明 (`config.yml`)

主要配置选项如下

消息设置

• random: false - 是否随机显示消息列表中的内容。
• show_time: 3 - 每条消息显示的持续时间（秒）。
• time_between_messages: 0 - 消息之间的等待时间（秒）。
• only_in_custom_worlds: false - 是否仅在自定义世界中显示。
• sound: NONE - 消息切换时的音效。音效列表可参考提供的链接。
• bypass: false - 为拥有 HeroAction.bypass 权限的玩家禁用消息。
• toggleable_messages: false - 是否允许玩家使用 /HeroAction toggle 开关消息。
• list: - 消息列表，支持颜色代码和变量。

世界与变量格式

• Custom_Worlds: - 指定显示消息的世界列表。
• Variables: - 自定义 %date%、%time%、%health%、%food%、%rainbow% 等变量的显示格式。

⭐命令与权限

可用命令

• /HeroAction - 插件主命令。
• /HeroAction reload - 重载配置文件。权限： HeroAction.reload
• /HeroAction broadcast <duration> <text> - 广播一条临时消息。权限： HeroAction.broadcast
• /HeroAction toggle - 开关个人消息显示（需在配置中启用）。权限： 无（玩家可用）

权限节点

• HeroAction.bypass - 拥有此权限的玩家将不会看到消息（需在配置中设置 bypass: true）。
• HeroAction.reload - 允许重载配置。
• HeroAction.broadcast - 允许使用广播命令。
• HeroAction.* - 所有权限。

❓注意事项与提示

• 使用 /HeroAction toggle 和 HeroAction.bypass 功能前，务必先在 config.yml 中启用相应设置。
• 音效名称因服务器版本而异，请根据版本选择正确的音效名。
• 更新插件后可能需要重启服务器。
• 插件内置了更新检查功能，可在配置中关闭。

---

示例服务器：

• mc.darkup.cz
• play.melacraft.com

如需添加您的服务器至列表，请联系插件作者。