ChatManagement2

插件

· 作者 MistaSoup

简易反垃圾信息与聊天保护插件

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

ChatManagement 2

适用于 Minecraft 1.21.x 的高级反垃圾邮件与聊天保护插件

ChatManagement 2 是对原版 ChatProtection 插件的完全重写,具有改进的垃圾邮件检测算法、更少的误报以及增强的性能。完全兼容 Folia 的区域基于线程机制。


? 主要功能

智能垃圾邮件检测

  • 相似度匹配 - 使用改进的 Levenshtein 距离算法,即使存在拼写错误也能检测垃圾邮件
    • "hello everyone" 与 "helo everyone" → 如果过于相似则被拦截
    • 可配置的相似度阈值(默认:80%)
    • 基于长度的过滤可防止短消息出现误报

屏蔽词系统

  • 智能模式匹配 - 自动检测混淆字符:
    • 数字/符号替代 (Leetspeak):f*ck, fvck, fu<k
    • 字符替换:@→a, $→s, 0→o, 3→e
    • 空格技巧:f u c k
    • 特殊字符:f.u.c.k, f-u-c-k
  • 部分匹配控制 - 可选的部分单词屏蔽功能,并附带最小长度要求
  • 误报预防 - 智能边界检测可防止屏蔽合法词汇

反垃圾邮件保护

  • 重复内容预防 - 拦截重复发送的消息,支持可配置阈值
  • 快速垃圾邮件检测 - 自动踢出在短时间内发送过多消息的玩家(默认:5秒内7条消息)
  • 速率限制 - 按玩家进行基于时间的消息追踪

自动禁言系统

  • 惯犯检测 - 自动禁言反复因垃圾邮件被踢出的玩家(默认:10分钟内3次踢出 = 禁言5分钟)
  • 持久化存储 - 禁言状态在服务器重启后保留(数据库或 YAML 格式)
  • 智能计时器 - 玩家断开连接时暂停计时,重新连接时恢复
  • 可配置时长 - 完全自定义阈值和持续时间

私聊功能

  • 内置命令 - /msg, /w, /tell, /pm, /dm, /whisper
  • 回复系统 - 使用 /r 和 /reply 快速回复
  • 颜色自定义 - 私聊消息使用自定义颜色(默认:紫红色)
  • 垃圾邮件防护 - 所有反垃圾邮件检查同样适用于私聊
  • 禁言兼容性 - 可选设置,允许被禁言玩家接收(但不能发送)私聊消息

聊天增强

  • 彩色消息 - 在消息前添加 > 以显示自定义颜色(默认:浅绿色)
  • 静默拦截 - 当消息被拦截时可配置通知
  • 权限绕过 - 受信任的玩家可跳过所有检查
  • 自定义消息 - 所有插件消息均可自定义

技术优势

  • 兼容 Folia - 完全支持区域基于线程机制
  • 高性能 - 极低开销(每条消息不到1毫秒)
  • 数据库支持 - 支持 SQLite 或 MySQL 用于持久化存储
  • 热重载 - 执行 /cm reload 可在不重启服务器的情况下更新配置
  • 全面日志记录 - 提供调试模式和详细模式以便故障排除

? 安装

  1. 下载最新的 ChatManagement2-1.0.0.jar
  2. 将其放入服务器的 plugins 文件夹中
  3. 启动/重启服务器
  4. 根据需要配置 plugins/ChatManagement2/config.yml
  5. 运行 /cm reload 应用更改

要求

  • Minecraft 服务器:1.21.x(Paper、Folia 或兼容分支)
  • Java:21 或更高版本

⚙️ 配置

基本设置

默认配置开箱即用效果良好,但您可以自定义所有内容:

# 核心垃圾邮件检测
settings:
  similarity-threshold: 80  # 0-100%,数值越高越严格
  message-history-size: 10  # 每个玩家跟踪的消息数量

# 重复消息拦截
duplicate-messages:
  max-repeats: 2            # 允许重复2次后再拦截
  cooldown-seconds: 30      # 在此时间后清除历史记录

# 快速垃圾邮件检测
anti-spam-kick:
  enabled: true
  message-threshold: 7      # 时间窗口内的消息数量达到此值即踢出
  time-window-seconds: 5

# 对惯犯的自动禁言
auto-mute:
  enabled: true
  kick-threshold: 3         # 时间窗口内踢出次数达到此值即禁言
  kick-window-minutes: 10
  mute-duration-seconds: 300

高级配置

数据库设置

为了在大量禁言状态下获得更好的性能,请启用数据库存储:

SQLite(推荐大多数服务器使用):

database:
  enabled: true
  type: sqlite

MySQL(适用于大型服务器):

database:
  enabled: true
  type: mysql
  mysql:
    host: localhost
    port: 3306
    database: chatmanagement
    username: your_username
    password: your_password

屏蔽词

根据您的需要配置词过滤器:

blocked-words:
  enabled: true
  block-partial-matches: false  # 防止误报
  min-word-length: 4            # 部分匹配的最小单词长度
  word-list:
    - badword1
    - badword2

自定义消息

所有消息均可自定义并切换开关:

messages:
  notify-blocked-message: false  # 静默拦截
  blocked-message-notification: "&cYour message was blocked."
  
anti-spam-kick:
  notify-player: true
  kick-message: "&cYou have been kicked for spamming!"

auto-mute:
  notify-player: true
  mute-notification: "&cYou have been muted for &e{duration} &cseconds."
  mute-message: "&cYou are muted. Time remaining: &e{time} &cseconds."

私聊

自定义私聊外观:

private-messaging:
  enabled: true
  message-color: "&d"  # 紫红色
  sent-format: "&7[&dYou &7-> &d{receiver}&7] &r{message}"
  received-format: "&7[&d{sender} &7-> &dYou&7] &r{message}"

聊天颜色

启用彩色聊天功能:

chat-colors:
  enabled: true
  color-prefix: ">"       # 输入 >message 以显示彩色文本
  prefix-color: "&a"      # 浅绿色

? 命令

主要命令

  • /chatmanagement 或 /cm - 插件主命令
  • /cm reload - 重新加载配置
  • /cm help - 显示帮助信息
  • /cm version - 显示插件版本

私聊功能

  • /msg <玩家> <消息> - 发送私聊消息
  • /w <玩家> <消息> - /msg 的别名
  • /tell <玩家> <消息> - /msg 的别名
  • /pm <玩家> <消息> - /msg 的别名
  • /dm <玩家> <消息> - /msg 的别名
  • /whisper <玩家> <消息> - /msg 的别名
  • /r <消息> - 回复上一条消息
  • /reply <消息> - /r 的别名

? 权限

  • chatmanagement.reload - 允许重新加载插件(默认:op)
  • chatmanagement.bypass - 绕过所有聊天限制(默认:op)

? 故障排除

误报过多

如果合法消息被阻止:

  1. 提高相似度阈值:

    settings:
      similarity-threshold: 85  # 数值越高越严格,误报越少
    
  2. 禁用部分单词匹配:

    blocked-words:
      block-partial-matches: false
    
  3. 增加最小消息长度:

    duplicate-messages:
      min-message-length: 5
    

消息未被拦截

如果垃圾信息仍然通过:

  1. 降低相似度阈值:

    settings:
      similarity-threshold: 75  # 数值越低,拦截的垃圾信息越多
    
  2. 降低反垃圾踢出阈值:

    anti-spam-kick:
      message-threshold: 5
    
  3. 启用调试模式:

    settings:
      debug: true
    

    在控制台中查看检测信息。

数据库问题

如果数据库连接失败:

  1. 检查配置文件中的凭据
  2. 确保数据库已存在(针对 MySQL)
  3. 插件将自动回退到 YAML 存储
  4. 查看控制台以获取错误信息

? 性能

ChatManagement 2 旨在实现极低的性能影响:

  • 平均开销:每条消息 <1ms
  • 内存占用:典型服务器约为 2-5 MB
  • 数据库查询:使用预处理语句进行优化
  • 线程安全:完全兼容 Folia 的线程模型

? 与 ChatProtection 的区别

ChatManagement 2 是一次彻底的重写,带来了重大改进:

  1. 更高的准确性 - 改进了垃圾邮件检测,减少了误报
  2. 基于长度的过滤 - 防止拦截短小且合法的聊天消息
  3. 部分匹配控制 - 智能边界检测被屏蔽词汇
  4. 数据库支持 - 可选 SQLite/MySQL 以提升性能
  5. 增强的禁言系统 - 断开/重新连接时暂停/恢复
  6. 改进的配置 - 对所有功能提供更精细的控制
  7. 更好的文档 - 包含详尽的注释和示例

? 更新日志

v1.0.0(初始版本)

  • ChatProtection 模组完全重写
  • 改进了垃圾信息检测算法
  • 支持数据库(SQLite/MySQL)
  • 增强了带持久化功能的静音系统
  • 提供了更丰富的配置选项
  • 文档更加全面
  • 兼容 Folia
  • 减少了误报情况
  • 性能优化

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源