原创 聊天 [1.16.x~1.21.x]墨聊天——聊天前缀 | 权限分组 | 关键词过滤 | 自动禁言 ，强大的聊天插件 1.0.0

[MD] ### 🎮 插件交流群 [/MD]
点击加入【墨系列插件交流群】

[MD] # MoChatPlugin 功能介绍文档 ## 插件概述 MoChatPlugin 是一个功能强大的 Minecraft 服务器聊天管理插件，集成了聊天格式化、权限分组和敏感词过滤三大核心功能。插件采用模块化设计，性能优化，对服务器 TPS 影响极小。 ## 核心功能模块 ### 1. 聊天消息格式化系统 #### 1.1 自定义聊天格式 - **灵活格式配置**：通过配置文件自定义聊天消息的显示格式 - **占位符系统**：支持丰富的占位符，实时替换为玩家信息 - **颜色代码支持**：完整支持 Minecraft 颜色和格式代码 - **多组格式**：为不同玩家组设置不同的聊天格式 #### 1.2 占位符支持 插件支持以下占位符： | 占位符 | 说明 | 示例输出 | |--------|------|----------| | `{player}` | 玩家用户名 | `Player123` | | `{displayname}` | 玩家显示名称 | `§6VIP§fPlayer123` | | `{world}` | 玩家所在世界 | `world` | | `{health}` | 玩家当前生命值 | `10.0` | | `{max_health}` | 玩家最大生命值 | `20.0` | | `{level}` | 玩家等级 | `30` | | `{food}` | 玩家饥饿值 | `18` | | `{message}` | 原始聊天消息 | `大家好！` | | `{prefix}` | 玩家聊天前缀 | `[VIP]` | | `{suffix}` | 玩家聊天后缀 | `⭐` | | `%world%` | 世界名称（简化格式） | `world` | | `%health%` | 生命值（带心形符号） | `❤10` | #### 1.3 PlaceholderAPI 集成 MoChatPlugin 支持与 PlaceholderAPI 集成，当服务器安装了 PlaceholderAPI 插件时，您可以在聊天格式中使用任何 PlaceholderAPI 支持的占位符。 **启用条件**： - 服务器必须安装 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) 插件 - 插件将自动检测并启用 PlaceholderAPI 支持 **使用示例**： ```yaml groups: vip: prefix: "&6[VIP]" suffix: "&6⭐" format: "{prefix} &e%player_name% &6等级: %player_level% &6{suffix}&7: &f{message}" permission: "mochat.group.vip" ``` **支持的 PlaceholderAPI 占位符示例**： - `%player_name%` - 玩家名称 - `%player_level%` - 玩家等级 - `%player_health%` - 玩家生命值 - `%player_world%` - 玩家所在世界 - `%vault_eco_balance%` - 玩家经济余额（需要 Vault 和经济插件） - `%luckperms_prefix%` - 玩家 LuckPerms 前缀 - 以及其他所有 PlaceholderAPI 支持的占位符 **注意事项**： 1. PlaceholderAPI 占位符格式为 `%占位符名称%` 2. 插件会先替换内部占位符，再使用 PlaceholderAPI 解析剩余占位符 3. 如果 PlaceholderAPI 不可用，将自动跳过相关解析 #### 1.4 格式配置示例 ```yaml # config.yml 中的格式配置 groups: default: prefix: "&7[玩家]" suffix: "" format: "{prefix} &f{player}&7: &f{message}" vip: prefix: "&6[VIP]" suffix: "&6⭐" format: "{prefix} &e{player}&6{suffix}&7: &f{message}" permission: "mochat.group.vip" ``` ### 2. 分组权限管理系统 #### 2.1 多级分组支持 - **默认组**：未匹配任何权限组的玩家使用的默认格式 - **VIP组**：拥有 `mochat.group.vip` 权限的玩家 - **管理组**：拥有 `mochat.group.admin` 权限的玩家 - **赞助组**：拥有 `mochat.group.donor` 权限的玩家 - **自定义组**：支持无限扩展自定义分组 #### 2.2 权限控制 - **分组权限**：每个聊天组可配置独立的权限节点 - **颜色权限**：`mochat.color` - 允许使用颜色代码 - **格式权限**：`mochat.format` - 允许使用格式代码（粗体、斜体等） - **管理权限**：`mochat.admin` - 管理员权限 ### 3. 黑名单敏感词过滤系统 #### 3.1 核心特性 - **多模式匹配**：支持严格、模糊、正则表达式三种匹配模式 - **灵活操作**：支持阻止、替换、通知等多种处理方式 - **惩罚机制**：可配置警告、踢出、封禁等惩罚措施 - **白名单支持**：特定权限玩家可绕过过滤 #### 3.2 过滤模式 1. **严格模式 (strict)** - 完全匹配，区分大小写 - 示例：消息 "垃圾" 匹配词库 "垃圾" 2. **模糊模式 (fuzzy)** - 包含匹配，不区分大小写 - 示例：消息 "你这个垃圾" 匹配词库 "垃圾" 3. **正则表达式模式 (regex)** - 使用正则表达式匹配 - 示例：`regex:https?://[^\\s]+` 匹配所有URL #### 3.3 处理操作 1. **阻止发送 (block)** - 完全阻止消息发送 - 可配置惩罚措施 2. **替换内容 (replace)** - 将敏感词替换为星号 `***` - 消息正常发送 3. **替换为指定文本 (replace-text)** - 将敏感词替换为配置的文本 - 示例：替换为 `[已屏蔽]` 4. **仅通知管理员 (notify)** - 消息正常发送 - 仅向管理员发送警告通知 #### 3.4 惩罚机制 ```yaml # blacklist.yml 中的惩罚配置 punishment: enabled: true warning-message: "&c您的消息包含敏感词，请注意言辞！" action: warn # warn, kick, ban_temp, ban_permanent duration: 60 # 临时封禁时长（分钟） ``` #### 3.5 词库管理 - **内置词库**：包含常见敏感词、广告词等 - **自定义词库**：支持管理员自定义添加敏感词 - **正则支持**：支持正则表达式模式 - **热重载**：修改词库无需重启服务器 ### 4. 配置管理系统 #### 4.1 配置文件结构 ``` plugins/MoChatPlugin/ ├── config.yml # 主配置文件 ├── blacklist.yml # 黑名单配置文件 └── data/ # 数据存储目录（预留） ``` #### 4.2 配置文件热重载 - **命令重载**：`/mochat reload` 重载所有配置 - **自动保存**：修改配置后自动保存 - **版本兼容**：配置自动升级和兼容处理 #### 4.3 配置验证 - **格式验证**：自动检查配置格式正确性 - **默认值**：缺失配置项自动使用默认值 - **错误处理**：配置错误时显示详细错误信息 ### 5. 命令系统 #### 5.1 玩家命令 - `/mochat test [消息]` - 测试当前聊天格式 - `/mochat help` - 显示帮助信息 #### 5.2 管理员命令 - `/mochat reload` - 重载插件配置 - `/mochat debug` - 切换调试模式 - `/mochat version` - 显示插件版本 ## 配置示例 ### 完整配置示例 ```yaml # config.yml global: default-format: "&7[玩家] &f{player}&7: &f{message}" enabled: true log-to-console: true max-message-length: 256 allow-color-codes: true allow-format-codes: true groups: default: prefix: "&7[玩家]" suffix: "" format: "{prefix} &f{player}&7: &f{message}" vip: prefix: "&6[VIP]" suffix: "&6⭐" format: "{prefix} &e{player}&6{suffix}&7: &f{message}" permission: "mochat.group.vip" debug: false update-check: true ``` ```yaml # blacklist.yml enabled: true mode: fuzzy action: replace replacement-text: "***" notify-permission: "mochat.notify.blacklist" bypass-permission: "mochat.bypass.blacklist" punishment: enabled: false warning-message: "&c您的消息包含敏感词，请注意言辞！" action: warn duration: 60 word-list: - "垃圾" - "废物" - "傻福" - "**" - "****" - "shit" - "加群" - "加QQ" - "代刷" - "出售" ``` ### 获取帮助 - 查看服务器日志文件 - 使用 `/mochat debug` 启用调试模式 - 联系插件作者获取技术支持 --- *最后更新：2026年4月* *插件作者：墨凡* *联系QQ：2423150185* [/MD]