MessageOverHead - 头顶消息显示

💡MessageOverHead

MessageOverHead 是一款 Minecraft 插件，它允许玩家的聊天信息以气泡形式显示在其头顶，为服务器聊天增添独特的视觉效果。支持多行文本、颜色及丰富的自定义选项。

🎮功能特性

• 头顶消息显示：将玩家发送的聊天信息显示在其头顶上方。
• 多行文本支持：消息可以跨越多行显示。
• 颜色支持：
• 支持 HEX 颜色代码（适用于 1.16 及以上版本）。
• 支持 渐变颜色（适用于 1.16 及以上版本）。
• 权限管理：可设置显示和发送头顶消息的权限。
• 高度可定制：可自定义气泡出现时的音效和粒子效果。
• 聊天插件兼容：支持与 ChatControl、Chatty 等聊天插件协同工作。
• 聊天频道支持：兼容其他聊天插件实现的频道系统。
• 独立运行：本插件的优势在于不依赖任何全息图插件。

🔧配置说明

配置文件为 YAML 格式，主要设置如下

settings:
  listener:
    chat: true
  message:
    clearColorFromPlayerMessage: false
  particle:
    enable: true
    particleType: CLOUD
    count: 4
    offsetX: 0.2
    offsetY: 0.2
    offsetZ: 0.2
  sound:
    enable: true
    soundType: BLOCK_ANVIL_STEP
    volume: 3
    pitch: 3
  format: "%player_name% %message%"
  distance: 10
  biasY: 2.15
  visibletextforowner: true
  delay: 4
  sizeLine: 24

配置项详解

• format：消息格式。支持 PlaceholderAPI、HEX 颜色（例如 &#123456）和渐变颜色（例如 {#ffffff:#0039a6:#d52b1e 文本}）。
• distance：消息气泡的可见距离（单位：格）。
• biasY：气泡在玩家头顶生成的高度基准值。
• visibletextforowner：发送者自身是否能看到自己发出的气泡。
• delay：气泡的持续时间（单位：秒）。
• sizeLine：气泡中单行文本的最大字符长度。

✨命令列表

• /moh reload - 重载插件配置。
• /moh send <message> - 发送一个气泡消息（消息将对配置范围内所有玩家可见）。
• /moh create <sender> <recipients> <bubble config> <message> - 管理员命令，用于创建自定义气泡。详情请查阅相关链接。
• /moh config - 在屏幕上显示当前配置（管理员命令）。

✨权限节点

• moh.admin - 使用管理员命令的权限。
• moh.see - 查看头顶消息气泡的权限（可配置）。
• moh.send - 发送头顶消息气泡的权限（可配置）。

⭐依赖与兼容

• 必需依赖：ProtocolLib
• 软依赖（可选）：PlaceholderAPI（用于在格式中使用更多变量）

❓支持与反馈

• 请将所有 Bug 报告至 GitHub。如果您发现了问题，请务必提交报告！
• Discord 支持：TheDiVaZo#3794
• Telegram：https://t.me/thedivazo
• 插件使用情况统计：bStats Metrics

🔧版本与捐赠

• 最新版本信息与详细 Wiki 请查看发布页面。
• 支持开发者：
• 俄罗斯用户：可通过 Qiwi 捐赠。
• 其他国家/地区用户：可通过 PayPal（开发者父亲的账户）捐赠。

💡简介

CLICK 是一款轻量级的 Minecraft 插件，它允许玩家通过点击告示牌来执行命令。无论是传送、给予物品还是执行其他操作，只需简单点击即可完成，为服务器管理和玩家互动提供了极大的便利。

🎮功能特性

• 点击执行：玩家通过右键点击告示牌即可触发预设的命令。
• 灵活配置：支持为每个告示牌单独设置命令、权限和冷却时间。
• 多行命令：一个告示牌最多可设置四行不同的命令。
• 变量支持：命令中可以使用 {player} 变量，它会被替换为点击玩家的名字。
• 冷却系统：可为每个告示牌设置独立的点击冷却时间，防止滥用。
• 权限控制：可以为每个告示牌设置所需的权限节点，实现精细的访问控制。

🔧命令与权限

命令

• /click help

显示插件帮助信息。

*权限*：无

• /click create <第一行命令> [第二行命令] [第三行命令] [第四行命令]

在你面前创建一个新的可点击告示牌。命令参数将按行设置在告示牌上。

*权限*：`click.create`

• /click set <行号> <命令>

编辑你面前告示牌指定行的命令。行号范围为 1 到 4。

*权限*：`click.set`

• /click remove

移除你面前的告示牌（使其变为普通告示牌）。

*权限*：`click.remove`

• /click cooldown <秒数>

为你面前的告示牌设置点击冷却时间（单位：秒）。设置为 0 则禁用冷却。

*权限*：`click.cooldown`

• /click permission <权限节点>

为你面前的告示牌设置所需的权限节点。设置为 `none` 则移除权限要求。

*权限*：`click.permission`

• /click info

查看你面前告示牌的详细信息，包括各行的命令、冷却时间和权限。

*权限*：`click.info`

权限节点

• click.create - 允许使用 /click create 命令。
• click.set - 允许使用 /click set 命令。
• click.remove - 允许使用 /click remove 命令。
• click.cooldown - 允许使用 /click cooldown 命令。
• click.permission - 允许使用 /click permission 命令。
• click.info - 允许使用 /click info 命令。
• click.bypasscooldown - 允许绕过所有告示牌的点击冷却时间。

✨安装与使用

安装步骤

• 确保服务器已安装 Spigot、Paper 或兼容的服务器核心。
• 将下载的 CLICK.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件会自动生成配置文件 config.yml。

创建你的第一个可点击告示牌

• 放置一个普通的告示牌。
• 面对这个告示牌，执行命令：

   /click create say {player} 点击了告示牌！

• 现在，任何玩家右键点击这个告示牌，都会在聊天栏看到“[玩家名] 点击了告示牌！”的消息。

配置告示牌

你可以对已创建的可点击告示牌进行进一步设置

• 设置冷却时间：面对告示牌，执行 /click cooldown 10，将其冷却时间设置为 10 秒。
• 设置权限：面对告示牌，执行 /click permission my.custom.permission，只有拥有该权限的玩家才能点击。
• 编辑命令：面对告示牌，执行 /click set 2 give {player} diamond 1，可以修改第二行的命令。
• 查看信息：面对告示牌，执行 /click info 来查看其所有当前设置。

❓常见问题

• 问：告示牌上的文字会变吗？

答：不会。插件不会修改告示牌上显示的文字，所有命令和配置都是内部存储的。告示牌看起来和普通告示牌一样。

• 问：支持控制台命令吗？

答：支持。只需在命令前加上 console: 前缀，例如 console:say 服务器公告，该命令就会以控制台身份执行。

• 问：如何让命令对点击者本人生效？

答：在命令中使用 {player} 变量，它会被自动替换为点击玩家的名字。例如 tp {player} 100 64 100。

• 问：插件兼容其他插件吗？

答：是的。CLICK 可以执行任何有效的 Minecraft 或插件命令，只要执行者（玩家或控制台）拥有相应的权限。

• 问：如何备份我的可点击告示牌？

答：所有告示牌数据都保存在 plugins/CLICK/signs.yml 文件中。定期备份此文件即可。