配置文件

主配置：plugins/FakeModBlocker/config.yml

基础选项

language: en          # 语言文件后缀，对应 messages_en.yml（自带 en 与 cn 两份）
enable: true          # 总开关
logger: true          # 控制台打印玩家频道 / 模组相关消息（便于收集关键词）
useCustomKickCommand: true
command: "kick %player% %kickMessage%"   # 占位符：%player% %kickMessage%
notifyStaff: true
notificationPermission: fakemodblocker.notify

选项	说明
language	加载 messages_<language>.yml，自带 en 与 cn，详见消息与多语言
enable	false 时关闭模组检测
logger	开启后控制台会刷频道列表，适合排查，生产环境可按需关闭
useCustomKickCommand	是否用自定义踢出命令代替默认踢人
command	自定义踢出命令模板
notifyStaff	是否通知有权限的员工

forbiddenList

这是插件频道关键词，不是模组显示名。

forbiddenList:
  - "fabric"
  - "forge"
  - "xaeroworldmap"
  - "servux:tweaks"      # 含 ':' 时只精确匹配该频道
  - "servux:structures"

匹配规则：

• 不含 :：频道等于关键词，或以 关键词: 开头（前缀匹配）
  • 例：xaeroworldmap 可匹配 xaeroworldmap:main
• 含 :：仅精确匹配该完整频道名
  • 例：servux:tweaks 不会误伤 servux:litematics

常见误区

把 meteorclient、sodium 这种显示名直接写进列表通常无效——除非该模组真的注册了同名频道。

正确做法：

1. 打开 logger: true
2. 带着模组进服，看控制台打印的频道
3. 把真实频道关键词写进 forbiddenList
4. 若模组根本不注册频道，改用 告示牌翻译检测

extra-detections

extra-detections:
  packet-events:
    enabled: true          # 需安装 PacketEvents
  sign-translation:
    enabled: true
    skip-bedrock-via-floodgate: true
    avoid-open-screens: true      # 有界面占屏时等待，而不是顶掉它
    max-attempts: 4               # 客户端一直不回传时最多重开几轮
    evade-timeout-seconds: 300    # 挂着界面超过这么久上报一次
    evade-action: NOTICE          # NOTICE | KICK
    mods:
      Freecam:
        detect:
          key: "key.freecam.toggle"
        punishment:
          action: "KICK"   # NOTICE | KICK | BAN | IGNORE
          reason: "&c..."

escalation

可选的"警告 → 踢出 → 封禁"阶梯处罚系统，默认关闭。

escalation:
  enabled: false
  per-mod: true
  count-once-per-session: true
  reset-after: "30d"
  ladder:
    - violations: 1
      action: KICK      # WARN | KICK | BAN | COMMAND | IGNORE
      message: "&c&l警告 &7(第 %count% 次) &f请卸载 %mod%，下次将被封禁。"
    - violations: 2
      action: BAN
      duration: ""      # 留空为永久

计数按玩家保存在 violations.yml，用 /modblocker violations <玩家> 和 /modblocker clear <玩家> [模组] 管理。

完整说明：阶梯处罚

详见：频道检测、告示牌翻译检测

discord

经由 DiscordSRV 的可选 Discord 通知，默认关闭。

discord:
  enabled: false
  channel: ""        # "" = DiscordSRV 主频道 | 游戏频道名 | Discord 频道 ID
  embed: true
  mention: ""
  events:
    channel-detection: true
    sign-detection: true
    escalation: true
    evade: true

需要已安装 DiscordSRV；没装时这一段不起任何作用。填好后用 /modblocker discord test 验证。消息模板在语言文件的 discord: 段里。

完整说明：Discord 通知