UltiChat

智能聊天管理模块 / Smart Chat Management Module

从 UltiEssentials 提取的独立聊天功能模块，提供自动回复、聊天格式、公告广播、频道系统等 8 大功能。

Standalone chat module extracted from UltiEssentials with 8 features: auto-reply, chat format, announcements, channels, mentions, anti-spam, join/quit messages, and custom emojis.

功能 / Features

功能	Feature	说明
智能自动回复	Auto-Reply	关键词匹配（精确/包含/正则），多行回复，冷却时间
聊天格式	Chat Format	自定义前缀/后缀，颜色代码，PlaceholderAPI
入退消息	Join/Quit	自定义入服/退服消息，首次入服奖励，欢迎标题
定时广播	Broadcasts	聊天/Boss栏/标题三种广播，轮播消息
@提及	Mentions	@玩家名高亮提示+音效
聊天频道	Channels	全局/本地/自定义频道，范围限制，权限控制
防刷屏	Anti-Spam	冷却时间/重复检测/禁言，按权限豁免
自定义表情	Emojis	:shortcode: 替换为自定义文本/颜色

命令 / Commands

管理命令 / Admin Commands

命令	权限	说明
/uchat reload	ultichat.admin	重载配置 / Reload configs
/uchat autoreply list	ultichat.admin	列出自动回复规则 / List auto-reply rules
/uchat autoreply add <name> <response>	ultichat.admin	添加规则 / Add rule
/uchat autoreply remove <name>	ultichat.admin	移除规则 / Remove rule

频道命令 / Channel Commands

命令	权限	说明
/ch list	ultichat.channel	列出可用频道 / List channels
/ch <name>	ultichat.channel	切换频道 / Switch channel

配置 / Configuration

配置文件位于插件数据目录 config/ 下：

文件	说明
config/chat.yml	聊天格式、@提及、入退消息、表情开关
config/autoreply.yml	自动回复规则（关键词、匹配模式、回复内容、冷却）
config/channels.yml	频道定义（名称、范围、权限、颜色）
config/announcements.yml	定时广播（聊天/Boss栏/标题，消息列表，间隔）
config/emojis.yml	自定义表情映射

自动回复示例 / Auto-Reply Example

auto-reply:
  enabled: true
  case-sensitive: false
  cooldown: 5
  rules:
    greeting:
      keyword: "你好"
      mode: contains      # exact / contains / regex
      response:
        - "&a欢迎来到服务器！"
        - "&7输入 /help 查看帮助"
      permission: ""
      cooldown: 10

频道示例 / Channel Example

channels:
  enabled: true
  default-channel: global
  definitions:
    global:
      display-name: "&f[全局]"
      format: "{channel} {player}: {message}"
      range: -1
      permission: ""
    local:
      display-name: "&a[本地]"
      format: "{channel} {player}: {message}"
      range: 100
      permission: ""

权限 / Permissions

权限	说明
ultichat.admin	管理命令
ultichat.channel	频道切换
ultichat.chat.color	聊天中使用颜色代码
ultichat.chat.emoji	使用自定义表情
ultichat.mention	@提及其他玩家
ultichat.mention.self	@提及自己
ultichat.bypass.spam	豁免防刷屏
ultichat.channel.<name>	使用指定频道

构建 / Build

cd plugins/UltiChat
mvn clean package

JAR 文件: target/UltiChat-1.0.0.jar

测试 / Testing

cd plugins/UltiChat
mvn test

375 tests, 97.9% instruction coverage (JaCoCo).