ChatBubbles - 聊天气泡

简介

ChatBubbles 是一款为 Minecraft 服务器增添聊天气泡功能的插件。当玩家在聊天框发言时，其头顶会动态显示一个包含发言内容的气泡，气泡支持自定义格式、粒子效果和音效，为服务器互动增添更多视觉趣味。

💡重要须知

• 本插件必须搭配 HologramsAPI 使用，请务必先安装它。
• 插件部分功能仍在开发中，如果您遇到任何问题，请及时向开发者反馈。

🎮功能特性

• 完整颜色支持：气泡内的文本支持使用颜色与格式代码。
• 高度可配置：气泡的显示格式、高度、持续时间等均可自定义。
• 自动清理：气泡会在显示一段时间后自动消失，保持界面整洁。
• 粒子与音效：可为气泡的显示与消失配置粒子效果和自定义音效。
• 旁观模式禁用：可选择在玩家处于旁观模式时禁用气泡显示。
• MySQL 支持：可选启用 MySQL 以存储玩家的气泡开关状态（功能尚在开发）。

🔧命令与权限

命令列表

• /chatbubbles reload 或 /cb reload
• 重新加载插件配置文件，并清除服务器中所有现有的聊天气泡。
• /chatbubbles toggle 或 /cb toggle
• 开关您个人的聊天气泡显示功能。

权限节点

• chatbubbles.chat (默认：true)
• 允许玩家在聊天时生成聊天气泡。
• chatbubbles.reload (默认：op)
• 允许使用 /chatbubbles reload 命令。
• chatbubbles.toggle (默认：op)
• 允许使用 /chatbubbles toggle 命令。
• chatbubbles.sound (默认：未指定)
• 允许玩家在聊天时播放气泡音效。
• chatbubbles.particles (默认：未指定)
• 允许玩家在聊天时生成气泡粒子效果。

✨配置详解

以下是插件核心配置项的说明与默认值，您可以在 config.yml 文件中进行修改。

BubbleProperties (气泡属性)

• Format: '%playerdisplay% &bsaid: &r%msg%'
• 气泡的显示格式。%playerdisplay% 为玩家名，%msg% 为聊天内容。
• Higher: false
• 是否将气泡显示在更高位置。
• AutoDelete: true
• 是否自动删除气泡。
• AutoDeleteTimer: 10
• 气泡自动删除前的显示时间（秒）。
• DisableInSpectatorMode: true
• 是否在玩家处于旁观模式时禁用气泡。

音效配置

• SoundEnabled: true
• 是否启用气泡音效。
• Sound: 'CHICKEN_EGG_POP'
• 播放的音效类型（Bukkit 音效名）。
• SoundVolume: 1.0
• SoundPitch: 1.0

粒子效果配置

• ParticlesEnabled: true
• 是否启用粒子效果。
• Particle: 'FLAME'
• 粒子效果类型（Bukkit 粒子名）。
• ParticleAmount: 50
• 粒子数量。
• ParticleOffsetX/Y/Z: 1
• 粒子扩散范围。
• ParticleSpeed: 0.1
• 粒子速度。

Messages (提示消息)

可自定义插件发送的各种提示消息的颜色与内容。

• ChatBubbles: '&e[&b&lChatBubbles&r&e]'
• NoPermission: '&cYou cannot use this command.'
• ToggleEnabled: '&bChatBubbles &aenabled!'
• ToggleDisabled: '&bChatBubbles &cdisabled!'
• ConfigReloaded: '&aConfig succesfully reloaded!'

MySQL 配置

此功能仍在开发中，默认关闭。

• enabled: false

❓依赖与致谢

• 核心依赖：本插件运行必须安装 HologramsAPI（由 @inventivetalent 开发）。
• 翻译致谢：感谢 BukkitFAQ 提供的德语翻译支持。