# 📚 信息 **social 🦜** 是一个完全模块化的插件，专注于**提升你的服务器的沟通**，而不会影响游戏体验。 它使用现代 API 开发，为服务器所有者和开发者提供一个**简单但强大的工具**。 **所有内容都可以进行配置**，包括消息。 ## 🤔 功能 * ✨ 完美兼容 [MiniMessage](https://docs.advntr.dev/minimessage/index.html) 和 [PlaceholderAPI](https://wiki.placeholderapi.com)，以获得美观的消息 * 🗣️ **基于频道的聊天提供程序**。你可以根据服务器的需求添加或删除频道。例如，你可以拥有一个全球频道和一个工作人员频道 * 😲 **反应**，带有漂亮的动画在玩家头顶上显示 * 🧵 **聊天回复和线程**。玩家可以点击消息进行回复。 * 🛡️ **群组聊天频道**。玩家可以使用 `/group` 创建自己的群组频道。服务器所有者可以使用 Social Spy 查看群组消息。 * 😎 **表情符号支持**，与 Discord 非常相似: `:emoji_name:` * ‼️ **提及**，可以与用户名和昵称一起使用。 * 🔗 **服务器链接**。自 Minecraft 1.21 起可用，服务器链接是向玩家分享外部资源在暂停菜单中的绝佳方式。 * 📢 **内置公告**，具有可配置的间隔。可以通过动作条广播消息 * 🤫 **私人消息**，为工作人员提供 social spy * 🖌️ **高级文本格式**，具有粗体、斜体、下划线和其他更多选项 * 🤬 **聊天过滤器**，可以阻止 IP、URL 或单词。甚至在私信中 * 🌊 **防止洪水/垃圾邮件** * ☕️ **对开发者友好的 API**，具有无数可能性。开发者可以添加自定义频道、反应、表情符号、过滤器、关键字…… * 👀 **无需依赖** ## ⚠️ 兼容性表 | | 兼容？ | 版本 | 备注 | |---------------------------------------------------------|-------|-------|----------------------------------------------| | [PaperMC](https://papermc.io/) | ✅ | 1.16+ | 反应从 1.20 开始可用 | | [PurpurMC](https://purpurmc.org/) | ✅ | 1.16+ | 反应从 1.20 开始可用 | | [Spigot](https://www.spigotmc.org) | ✅ | 1.16+ | 反应从 1.20 开始可用 | | [Bukkit](https://bukkit.org) | ✅ | 1.16+ | 反应从 1.20 开始可用 | | [Folia](https://papermc.io/software/folia) | ❌ | | | ## 🔌 集成 ### 🏷️ [PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI) - 兼容 PlaceholderAPI 添加的每个占位符。 ### 💬 [DiscordSRV](https://github.com/DiscordSRV/DiscordSRV) - 兼容聊天频道 ### 🐷 [banco](https://github.com/myth-MC/banco) - 添加关键字 `[balance]` 以在聊天中显示余额金额。 ## ➕ 官方插件 ### 👤 [social-chatheadfont](https://github.com/myth-MC/social-chatheadfont-addon) - 提供与 [ChatHeadFont](https://github.com/OGminso/ChatHeadFont) 的兼容性。 # 🖊️ 使用 ## 🔧 首次运行 你第一次运行 social 时，它会自动生成两个文件： * 'settings.yml' 包含常规设置 * 'messages.yml' 包含可配置的消息 你可以通过修改 `settings.yml` 禁用任何功能 ## ✏️ 关键概念 ### 💬 解析器 **social** 提供了一组强大的内置工具，以**解析器**的形式存在。解析器是修改文本的规则。以下是解析器类型列表： | | 描述 | 格式 | 玩家可触发？ | 示例 | |--------------|----------------------------------------------|----------------|-------------------------|-------------------------| | 过滤器 | 使用 “***” 替换表达式或单词 | _可配置_ | ✅ | `192.168.1.1 ➡️ ***` | | 表情符号 | 将单词替换为 Unicode 输入 (表情符号) | :emoji: | ✅ | `:smile: ➡️ 😄` | | 关键字 | 将单词替换为特定组件 | [keyword] | ✅ | `[balance] ➡️ 10.4$` | | 占位符 | 将单词替换为特定组件 | $placeholder | ❌ | `$channel ➡️ global` |