ChatFeelings - 聊天情绪插件

ChatFeelings 是一款让玩家通过指令在聊天中表达情感的插件，从拥抱到“Dab”舞步，多种情感指令可供选择。它包含粒子效果、独特音效、屏幕震动、季节性指令、屏蔽功能等丰富特性，保证成为玩家们的最爱。

💡版本兼容性

• 完全支持：1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21
• 部分支持：

- 1.12：需要手动配置音效。

- 1.11, 1.10, 1.9, 1.8：功能受限（无粒子效果，需手动配置音效）。

• 不支持：1.7 及以下版本。

**版本系列说明**

• v4 系列：最新版本，完全支持 1.13 至 1.21。
• v3 系列：支持 1.8 至 1.13，但存在已知漏洞。
• v2 系列：支持 1.7 至 1.12，比 v3 更稳定，但也有已知漏洞。

注意：除非你使用的是 v4 版本及一个完全支持的 Minecraft 版本，否则请不要寻求技术支持。

🎮指令与权限

情感指令

所有情感指令的格式均为 /指令名 <玩家名>。

• /hug - chatfeelings.hug
• /slap - chatfeelings.slap
• /poke - chatfeelings.poke
• /highfive - chatfeelings.highfive
• /yell - chatfeelings.yell
• /facepalm - chatfeelings.facepalm
• /bite - chatfeelings.bite
• /lick - chatfeelings.lick
• /snuggle - chatfeelings.snuggle
• /shake - chatfeelings.shake
• /stab - chatfeelings.stab
• /kiss - chatfeelings.kiss
• /punch - chatfeelings.punch
• /murder - chatfeelings.murder
• /dab - chatfeelings.dab
• /boi - chatfeelings.boi
• /cry - chatfeelings.cry
• /pat - chatfeelings.pat
• /scorn - chatfeelings.scorn
• /stalk - chatfeelings.stalk
• /sus - chatfeelings.sus

其他指令

• /feelings - chatfeelings.help (显示帮助)
• /cf mute <玩家> - chatfeelings.mute (禁言玩家)
• /cf unmute <玩家> - chatfeelings.mute (解除禁言)
• /cf mutelist - chatfeelings.mute (查看禁言列表)
• /cf ignore <玩家/all> - chatfeelings.ignore (屏蔽玩家/所有人)
• /cf stats [玩家] - chatfeelings.stats.others (查看统计)
• /cf stats - chatfeelings.stats (查看自己的统计)
• /cf version - 无权限要求 (查看版本)
• /cf reload - chatfeelings.admin (重载配置)
• /cf reset - chatfeelings.admin (重置数据)

**权限说明**

• 使用 chatfeelings.all 权限可授予所有情感指令。
• 默认情况下，情感指令的独立权限是禁用的。你需要在 config.yml 中将 Use-Feeling-Permissions 设置为 true 来启用它们。

✨主要特性

• 轻量高效：性能开销极低。
• 高度可定制：所有消息、音效、粒子均可配置。
• 丰富的交互：包含 18 种以上的情感指令，并持续更新。
• 粒子与音效：为情感指令提供视觉与听觉反馈（需要对应版本支持）。
• 冷却系统：可完全自定义的指令冷却时间。
• 屏蔽与禁言：支持屏蔽其他玩家，并可禁言玩家使用情感指令。
• 范围限制：可配置情感指令的有效距离。
• 多世界支持：可指定禁用情感指令的发送或接收世界。
• 隐身兼容：支持 Essentials 及其他隐身插件。
• 变量支持：支持 PlaceholderAPI。
• 惩罚系统集成：支持 Essentials、LiteBans、AdvancedBan 的禁言状态检测。
• 消息模式：可在全局广播与仅限参与者可见之间切换。
• 开源：代码完全开放。

🔧配置文件概览

ChatFeelings 的配置非常灵活，主要通过三个文件控制。

config.yml

控制插件的核心行为。

**主要设置项**

• Global-Feelings：控制情感通知是否全局广播。
• Cooldowns：为情感指令、屏蔽指令等设置冷却时间。
• Radius：启用后，玩家必须在一定距离内才能使用情感指令。
• Particles / Sounds：是否启用粒子效果和音效。
• Use-Feeling-Permissions：是否启用每个情感指令的独立权限检查。
• Disabled-Sending-Worlds / Disabled-Receiving-Worlds：禁用情感指令的发送/接收世界列表。
• Vanished-Players：是否对隐身玩家禁用情感指令。
• Debug：启用调试模式，在控制台输出详细信息。

emotes.yml

配置每一个情感指令的具体内容。

**每个情感的配置结构**

• Enable：是否启用该情感。
• Msgs：包含 Sender (发送者看到)、Target (目标看到)、Global (全局广播) 三种消息。
• Sounds：可配置最多两个音效，包含音效名、音量、音高。

messages.yml

配置插件所有交互文本和提示信息。

• 可以自定义所有消息的前缀、无权限提示、冷却提示、错误信息等。

❓常见问题解答

是否支持自定义情感？

• 目前不支持。未来有相关计划，但需要大量重构工作。

权限为什么不生效？

• 请确认 config.yml 中的 Use-Feeling-Permissions 已设置为 true。
• 确保你使用的是最新版本的 ChatFeelings。

情感指令无效（控制台有错误）？

• 停止服务器，更新到最新版 ChatFeelings，然后删除整个 ChatFeelings 插件文件夹，再重启服务器。
• 确认你的 Spigot 版本是 1.13 或更高。

情感指令无效（控制台无错误）？

• ChatFeelings 需要 Java 8 或更高版本。OpenJDK 不受支持，会导致指令无法识别。

插件无法运行？

• 检查是否有其他插件冲突。
• 确保使用 Java 8 或更高版本。

我可以查看源代码吗？

• 可以，源代码已在 GitHub 上开源。

使用情感指令时出现“invalid sound”错误？

• 你的 emotes.yml 中有一个或多个音效名称不正确。
• 请确保你使用的 Minecraft 版本与音效名称匹配（例如，1.13+ 的音效名称与旧版不同）。

尝试了以上方法仍报错？

• 在 config.yml 中开启 Debug 模式，重现错误。
• 加入我们的支持 Discord，在 #support 频道提交问题单。

为什么停止对 1.12 及以下版本的完全支持？

• 1.12 及以下被视为 Minecraft 的旧版本。专注于支持最新版本能确保插件保持更新和高效率。
• 如果你需要在 1.12 或以下版本使用，请下载对应的旧版插件。

⭐获取帮助

如果遇到问题，请先阅读上方的常见问题解答。若问题仍未解决，欢迎加入我们的支持 Discord 以获取快速响应。