checks.md

checks.yml 是 Matrix 所有检查的规则文件。

TIP

在阅读本文件之前，请确保您已阅读 Matrix 的核心概念。

您可以：

启用/禁用检查或子检查
更改检查的惩罚
更改检查的阈值
更改检查的魔法值

入门

打开 checks.yml，您会看到类似这样的内容：

yaml

# 检查 A
check-name-a:
  enable: true

  other-settings: ...

  decay:
    interval: 15
    amount: 5

  commands:
    10: '...'
    20: '...'

# 检查 B
check-name-b:
  enable: true

  other-settings: ...

  decay:
    interval: 15
    amount: 5

  commands:
    10: '...'
    20: '...'

# 检查 C
check-name-c:
...

让我来为您解释，在 checks.yml 中，根节点是检查类型，冒号后面是一系列相关设置。

enable 表示是否启用该类型的检查
other-settings 表示该类型检查的其他设置，通常可以在这里定义一些子检查（模块）的设置或开关
decay 表示该类型检查的违规等级衰减设置
commands 表示当该类型检查的违规等级达到某个值时要执行的命令

以 KillAura 检查为例

yaml

killaura:
  # 是否启用 KillAura 检查？
  enable: true

  # Matrix 的各种 KillAura 检查模块列表
  modules:
    # 检查玩家在战斗中是否表现出缺陷
    flaw:
      type_a:
        enable: true
        vl: 3
      type_b:
        enable: true
        vl: 10
      type_c:
        enable: true
        vl: 10
      type_d:
        enable: true
        vl: 10
      type_e:
        enable: true
        vl: 5
    # 检查玩家在攻击时是否具有正确的旋转
    rotation:
      type_a:
        enable: true
        vl: 2
      type_b:
        enable: true
        vl: 2
    # 检查玩家是否表现出类似于自动瞄准的特征
    aimbot:
      vl_weight: 7
      cancel_hit: true

      check_aimbot_sync: true
      check_aimbot_shake: true
      check_aimbot_snap: true
      check_aimbot_sensitivity: true
      check_aimbot_acceleration: true
      check_aimbot_bad_rotation: true

    # KillAura NPC 检查，它会在玩家身后生成一个虚拟玩家以检测
    # 玩家是否在使用 KillAura，不用担心，玩家只能看到自己的 NPC
    npc:
      enable: true
      vl_weight: 5

      # NPC 的位置计算是否应该异步运行，因为这可能会消耗一些资源
      async: true

      # NPC 是否应该使用真实实体 ID 而不是随机生成的 ID？
      # 一些作弊客户端可以绕过随机实体 ID
      real_entity_id: true

      # NPC 是否仅由命令生成？如果设置为 false，NPC 将在玩家战斗时自动生成。
      # 如果设置为 true，您只能通过 "matrix npc" 命令为玩家生成 NPC。（默认值：true）
      only_command_trigger: true

      # 玩家是否可以看到这个 NPC？（true = 可见）
      visible: true

      # 强制随机名称（默认值：false）
      # 如果启用此选项，Matrix 生成的 NPC 将强制使用随机名称
      # 而不是在线玩家的随机名称，这可以解决一些客户端绕过 "重复" 名称 NPC 的问题。
      # 但 Matrix 不会为随机名称的 NPC 应用团队，您可能需要使用 API
      # 自行为 NPC 应用团队，否则一些客户端会根据 NPC 名称是否有颜色来绕过检查
      force_random_name: false

      # NPC 存在时间设置（以 ticks 为单位）
      check_ticks:
        base: 100
        attack_add: 20
        hit_bot_add: 50

      # NPC 运动设置
      movement:
        distance_base: 3.2
        distance_random_size: 0.75
        distance_attack_base: 3.0
        move_up_after_attack: false

    # Critical Hit 检查，防止玩家进行异常暴击攻击
    critical:
      # 是否启用此模块？
      enable: true

      # 玩家被此模块标记后应获得多少违规等级？
      vl_weight: 5

      # Matrix 是否应该在检测到玩家作弊后取消玩家的攻击？
      cancel_attack: true

    # Strafe 检查
    strafe:
      enable: true
      vl_weight: 3
      cancel_move: true

    # 组合检查
    combine:
      aimbot_with_reach:
        time: 5000
        condition:
          - 'ka.abt.magic'
          - 'hb.reach'
          - 'hb.reach'
        action: 5 # +5 违规等级

  # 自定义违规等级衰减间隔（秒）和衰减步长
  decay:
    interval: 15
    amount: 5

  # 违规等级阈值
  # number_of_violations: '<command>'
  commands:
    10: 'matrix npc %player% 100'
    20: 'matrix notify %player% might be using combat hacks (KillAura)'
    35: 'matrix notify %player% is using combat hacks (KillAura) #2'
    45: 'matrix delay 5 matrix kick %player% KillAura'

decay 部分特别重要，因为它控制玩家的违规等级（VL）如何随时间减少。interval 设置决定每次衰减操作之间的时间（秒），而 amount 设置决定每次减少的违规等级。这使得玩家在停止作弊后，违规等级可以逐渐减少，避免因临时作弊行为导致的永久高违规等级。

commands 部分用于定义当玩家的违规等级达到某些阈值时应该采取的行动。左侧的数字表示违规等级阈值，右侧的字符串是当达到这些阈值时要执行的命令。

例如，当玩家的违规等级达到 10 时，会执行命令 matrix npc %player% 100。此命令会生成一个虚拟玩家（NPC）存在 100 ticks，以进一步检查玩家是否在使用 KillAura。

当违规等级达到 20 和 35 时，会向服务器管理员发送通知，提醒他们玩家可能在使用战斗作弊。

最后，当违规等级达到 45 时，玩家会在 5 秒延迟后被踢出服务器，原因是 "KillAura"。

此配置文件允许服务器管理员根据需要自定义 KillAura 检查，调整检查的灵敏度和惩罚的严重程度。

占位符

%player%: 触发检查的玩家的名字。
%message%: 检测详情的信息。
%tooltips%: 检测详情的工具提示信息。
%add_vl%: 要添加到玩家总违规等级的分数。
%vl%: 玩家总违规等级分数。
%ping%: 玩家延迟。
%tps%: 服务器的 TPS。
%component%: 检查的组件。
%version%: 玩家使用的版本。
%world: 玩家所在的世界。

您还可以安装 PlaceholderAPI 获取更多占位符。

checks.md ​

入门 ​

以 KillAura 检查为例 ​

占位符 ​

checks.md

入门

以 KillAura 检查为例

占位符