// ChatBubbles - ChatBubbles

💡Chat Bubbles 简介

Chat Bubbles 是一款免费插件，旨在让玩家的聊天信息以气泡形式显示在头顶，并且气泡会跟随玩家移动。本插件改进了其他同类插件中气泡不跟随玩家的缺陷，并提供了丰富的自定义选项，让服务器可以自由调整气泡的显示方式。

💡重要更新：V1.20.1.a.1

长期困扰 HolographicDisplays 和 DecentHolograms 的可见性 Bug（自 1.17 版本以来）已在它们的最新版本中被修复。本插件已适配这些修复，所有与可见性相关的问题应该都已解决。

• 如果你使用 HolographicDisplays，玩家在服务器执行 /reload 后必须重新登录，否则全息图将无法正常显示。这是 HolographicDisplays 本身的 Bug。

🎮前置需求

运行本插件必须安装以下前置插件

• HolographicDisplays 或 DecentHolograms（推荐使用 DecentHolograms）
• ProtocolLib（全息图库需要此插件以实现完整功能）

可选的前置插件（用于集成功能）

• Factions（可选集成）
• Citizens（可选集成，需给 NPC 添加 chatbubble 特性）

关于 HolographicDisplays 版本的特别说明

截至 2023年6月27日，如果你使用 HolographicDisplays，请确保使用此特定版本。从 Bukkit 或最新构建下载的版本（例如 3.0.3 版本 #258）可能无法正常工作。未来请使用 3.0.3 之后的任何版本。

🎮测试服务器

• mc.kaoshkraft.net
• mc.herosfaith.eu

✨核心功能

• 简易“配置模式”切换：允许插件以多种预设（但仍可配置）的方式运行。
• PlaceholderAPI 支持：允许在插件中使用 PlaceholderAPI 的占位符。
• 气泡格式自定义：通过格式化，你可以从服务器端更好地控制气泡的外观。
• Factions 模式：允许同阵营的成员看到彼此的气泡。
• 权限系统：可以将气泡功能设置为捐赠者或 VIP 特权。
• 可自定义的前缀/后缀：为你的服务器打造独特的外观和感觉。
• 气泡开关：拥有权限的玩家可以独立开关自己的聊天气泡。
• 支持高负载服务器：即使在 250+ 玩家的服务器上也能完美运行。
• Hex 颜色支持（自 1.17.1.a.1）：使用 &#HEX 格式发送自定义颜色，例如 &#FF66FF。
• DecentHolograms 支持（自 1.18.1.a.1）：新增对 DecentHolograms 的支持。
• EventPriority 支持（自 1.18.1.a.2）：有助于解决与部分聊天管理插件的简单冲突。
• Citizens 支持（自 1.18.1.a.6）：Citizens NPC 可以通过气泡说话，需添加 chatbubble 特性。
• NPC 自定义音效支持（自 1.18.1.a.12）：可在 config.yml 中为每个 NPC 配置音效，支持自定义资源包音效（需安装 DecentHolograms）。
• 黑名单功能（自 1.19.2.a.1）：在 config.yml 中添加了黑名单部分（仅针对气泡内容，非全局聊天过滤）。
• 配置模式 6（自 1.19.2.a.5）：在此模式下，所有消息都会自动变为气泡，除非它们以 config.yml 中列出的前缀开头。
• 可配置的 messages.yml（自 1.20.1.a.2）：新增了可配置的 messages.yml 文件。

关于 PlaceholderAPI 的重要说明

如果你不熟悉 PlaceholderAPI，请注意：你必须先下载其“模块”，占位符才会生效。例如，要使用 %player_name%，你必须在服务器上输入 /papi ecloud download player 来下载 Player 模块。这是 PlaceholderAPI 的要求，无法在本插件中修复。

🔧命令与权限

所有权限都是可选的，如果启用，其具体值由服主在配置文件中定义。

• /cb <消息>

发送一个聊天气泡。

• 所需权限：chatbubble.use
• 注意：仅在配置模式 1 下有效。

• /cbreload

重新加载插件配置。

• 所需权限：chatbubble.reload

• /cbtoggle

开关玩家自己的聊天气泡。

• 所需权限：chatbubble.toggle

❓常见问题与提示

• 教程：作者认为没有必要提供书面教程，但如果你有相关的 YouTube 讲解视频，可以联系他。
• 配置：更多功能请查看“即将到来”列表和 config.yml 文件。
• 权限：所有权限都是可选的，具体取决于服务器的配置。

⭐开发计划

• [1.2.8] Factions 集成：允许同阵营的成员看到彼此的聊天气泡。
• 更多配置模式：如果你有关于新配置模式的想法，请在讨论区提出。
• [1.3.1] 插件更新通知器：以最不打扰的方式通知用户有可用更新。
• [1.3.1] 配置自动更新：当配置布局重置时自动更新配置文件（过去使用低于 1.3.1 版本的用户需手动备份/删除旧配置才能利用此功能）。
• 配置更改在自动更新中保留：如果更改仍然适用于新配置，则予以保留。
• [1.4.1] PlaceholderAPI 支持：已实现。
• [1.4.1] 自定义气泡格式：已实现，服主对气泡外观有更多控制权。
• [1.4.2] 隐身玩家支持：使隐身玩家不发送气泡（仅考虑通过 Spigot API 实现的隐身，对通过数据包控制的隐身无效）。
• [1.4.4] 自定义高度选项：允许在放置气泡时考虑自定义名牌插件。
• [1.4.5] 自动换行：当玩家输入的消息长于配置的长度时自动换行。
• [1.4.6] 重叠控制：新消息的气泡将替换旧消息的气泡。
• [1.5.6] 音效支持：气泡可以播放音效，支持原版或自定义资源包中的音效（建议先用 /playsound 测试音效名称）。

🔧支持作者

作者只是一名大学生，开发插件仅是业余爱好。你无需付费，但如果你愿意帮助支付高昂的书籍和课程费用，将不胜感激。

• 支持链接：https://paypal.me/AaronSkeels