ClientPolicy

插件

· 作者 XenbleDev

对主动声明自身身份的客户端模组进行服务器端指纹识别,支持白名单/黑名单配置文件,提供 LOG → WARN → KICK 的分级处理机制,并允许玩家自行查阅相关规则。

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

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

ClientPolicy

ClientPolicy 用于识别主动宣告自身存在的客户端模组,将其与你定义的策略配置文件进行比对,并执行 LOG(记录日志)→ WARN(警告)→ KICK(踢出玩家) 的阶梯式处理。玩家可以通过 /clientpolicy rules 查看规则,确保没有人会在不知情的情况下被踢出服务器。

无需安装任何客户端模组。Vanilla(原版)、Fabric、Forge 和 NeoForge 客户端均可正常工作。


⚠️ 首先阅读:ClientPolicy 不是什么

ClientPolicy 不是反作弊系统。

其检测机制基于客户端主动提供的三项信息:

  1. 它注册的插件消息通道(plugin messaging channels),
  2. 它的 minecraft:brand 字符串,
  3. 是否存在模组加载器握手信号。

一个从不与服务器通信的模组对此方法是不可见的。X-ray(透视)、killaura(杀戮光环)、reach(超距攻击)、freecam(自由视角)、auto-clickers(自动点击器)等作弊行为不会注册任何通道,因此无法在此处被检测到。

ClientPolicy 确实 能可靠地看到以下模组:Litematica、Xaero's Minimap/World Map、JourneyMap、VoxelMap、WorldEditCUI、Baritone、ReplayMod、Distant Horizons、Simple Voice Chat、Vivecraft、LabyMod、Lunar Client,以及你教会它的任何其他模组。

出于故意,这一限制在 config.yml、/clientpolicy check 和 /clientpolicy rules 中均有重复说明。一种让管理员误以为具备反作弊能力的策略工具,比完全没有工具更糟糕。


✨ 功能特性

  • ? 指纹引擎 — 从登录时刻开始缓冲通道注册信息,因此即使在 PlayerJoinEvent(玩家加入事件)之前到达的记录也不会丢失。品牌标识和模组加载器握手信号会与之同步读取。
  • ? 签名数据库 — signatures.yml 将模组 ID 映射到通道模式(支持通配符,例如 litematica:*)、品牌正则表达式以及类别(MINIMAP 小地图、SCHEMATIC 蓝图、AUTOMATION 自动化、PERFORMANCE 性能优化、UTILITY 实用工具)。
  • ?️ 策略配置文件 — BLOCKLIST(黑名单,仅 deny 列表中的 ID 视为违规)或 ALLOWLIST(白名单,不在 allow 列表中的内容均视为违规)。玩家通过 clientpolicy.profile.<name> 解析到相应的配置文件,若未指定则回退至 default-profile(默认配置)。
  • ? 分级执行 — 每个配置文件拥有独立的阶梯策略:首次命中触发 WARN,后续命中触发 KICK,并配有可配置的升级阈值和计数器重置窗口。clientpolicy.bypass 权限可在仍记录检测信息的同时豁免玩家。
  • ⏱️ 延迟与重复扫描 — 首次评估在加入后 scan-delay-ticks 个刻钟运行,此后每新注册一个通道都会为 rescan-window-seconds 秒内的该玩家触发另一次评估。迟注册并不能规避执行。
  • ? 玩家透明度 — /clientpolicy rules 会向玩家展示其所属配置文件中允许和禁止的模组列表,并按类别分组。踢出消息会指明违规模组并指引玩家查阅规则。
  • ? 发现模式 — /clientpolicy inspect <player> 会打印原始通道、品牌、已匹配的签名以及未匹配任何签名的通道,以便你编写自己的签名规则。
  • ?️ 审计追踪 — 每次检测和采取的行动都会写入 SQLite 数据库,并通过 /clientpolicy history <player> 读取,包括服务器本地缓存中的离线玩家记录。
  • ? 未知通道策略 — 未匹配任何签名的通道会有独立的操作(默认为仅记录日志),这可以防止 ALLOWLIST(白名单)配置文件因无害的基础通信管道而踢出玩家。

明确超出范围的功能: 行为型作弊检测、客户端配套模组、资源包强制实施、模组文件哈希验证、Web 面板、MySQL 支持。


✅ 第一步:验证你的签名

通道名称会随 Minecraft 版本和模组更新而变化。随附的 signatures.yml 只是一个起始集合,并非绝对真理。请确认你所关心的每一项条目:

  1. 在自己的客户端上安装模组并加入服务器。
  2. 运行 /clientpolicy inspect <yourname> 并阅读 Unrecognised channels(未识别通道)部分。
  3. 将这些通道复制到 signatures.yml 的相应条目中。
  4. 运行 /clientpolicy reload。

在将任何配置文件切换为 ALLOWLIST(白名单)模式之前,请务必完成此操作。在白名单模式下,未经核实的签名列表意味着你会因为从未教过插件的通道而踢出玩家。

/clientpolicy check 提供的是仅限当前玩家自身的视图,且对所有人开放是安全的——正是这一点使得政策能够由其适用对象进行审计。


? 命令

根命令 /clientpolicy,别名 /cp。

命令 描述 权限节点
/clientpolicy rules 显示你自己配置文件中允许/禁止的模组列表,按类别分组 clientpolicy.rules (所有人)
/clientpolicy check 显示服务器当前在你客户端上看到的内容 clientpolicy.check (所有人)
/clientpolicy inspect <player> 原始通道、品牌、已匹配签名、扫描状态 clientpolicy.admin (OP)
/clientpolicy history <player> [limit] 过去的检测记录和采取行动(默认 10,最大 100) clientpolicy.admin
/clientpolicy profile <player> 玩家解析到了哪个配置文件及其原因 clientpolicy.admin
/clientpolicy rescan <player> 立即重新应用策略,包括阶梯升级 clientpolicy.admin
/clientpolicy reload 重载 config.yml 和 signatures.yml clientpolicy.admin

权限节点

节点 默认值 含义
clientpolicy.rules everyone 使用 /clientpolicy rules
clientpolicy.check everyone 使用 /clientpolicy check
clientpolicy.admin op 检查、历史记录、配置文件、重扫、重载
clientpolicy.bypass nobody 豁免所有行动。检测信息仍会被记录,工作人员仍会收到通知。
clientpolicy.notify op 在每次违规时接收聊天通知
clientpolicy.profile.<name> nobody 将玩家绑定到 <name> 配置文件

通过权限插件分配 clientpolicy.profile.<name>,并为每位玩家或组分配恰好一个权限——如果一名玩家持有多个配置文件权限,则取最先找到的那个生效。


⚙️ 配置

detection:
  scan-delay-ticks: 60          # 首次评估,加入服务器后 60 tick = 3s
  rescan-window-seconds: 120    # 新通道在此时长内重新触发评估
  track-brand: true
  brand-unknown-action: LOG     # ALLOW | LOG | WARN | KICK,在窗口结束时应用

policy:
  default-profile: default
  unknown-channel-action: LOG   # 保持宽松;这是白名单的安全阀
  ignore-channels:              # 从不进行评估,支持 * 和 ?
    - "minecraft:*"
    - "bungeecord:*"
    - "fabric:registry_sync"

enforcement:
  kick-message: |
    <red>检测到本服务器不允许的模组:<white><mod>
    <gray>允许的模组:查看 <aqua>/clientpolicy rules
  warn-message: "<gold>[!] <yellow><mod> <gray>在此不被允许。下次你将被踢出。"
  notify-staff: true
  notify-format: "<gray>[CP] <white><player> <gray>-> <red><mod> <dark_gray>(<action>)"

profiles:
  default:
    mode: BLOCKLIST             # ALLOWLIST | BLOCKLIST
    allow: [litematica, sodium, iris, worldeditcui, replaymod]
    deny:  [xaeros-minimap, journeymap, voxelmap, baritone]
    ladder:
      first: WARN
      after: KICK
      escalate-after: 2         # 第 1-2 次警告,第 3 次起踢出
      counter-reset-hours: 24
  builder:                      # clientpolicy.profile.builder
    mode: BLOCKLIST
    allow: [litematica, worldeditcui, sodium, iris, xaeros-minimap]
    deny:  [baritone]
    ladder:
      first: LOG
      after: WARN
      escalate-after: 3
      counter-reset-hours: 24

storage:
  retention-days: 30            # 旧记录将在启动时被清理

messages:
  prefix: "<dark_gray>[<aqua>ClientPolicy<dark_gray>] "

所有消息均使用 MiniMessage 格式。kick-message、warn-message 和 notify-format 中的占位符包括:<player>、<mod>、<mod_id>、<channels>、<category>、<profile>、<reason>、<action>、<count> —— 其中 <reason> 为以下值之一:DENIED、NOT_ALLOWED、UNKNOWN_CHANNEL、UNKNOWN_BRAND。

仅 WARN 和 KICK 会广播至 clientpolicy.notify。LOG 类型的检测仅记录到控制台并可通过 /clientpolicy history 查看 —— 一个单一的模组客户端很容易暴露十几个未编入目录的通道,若全部广播将使该权限功能不可用。

通道一旦注册便不会被遗忘:即使客户端注册后立即注销,也已暴露了模组信息。


? 安装

  1. 将 ClientPolicy-<version>.jar 放入 plugins/ 目录。
  2. 启动服务器。config.yml、signatures.yml 和 data.db 将在 plugins/ClientPolicy/ 中创建。
  3. 在你信任它们之前验证签名 —— 见上文章节。
  4. 编辑 config.yml 中的配置档案,然后运行 /clientpolicy reload。
服务器 Paper 1.21 – 1.21.11(整个版本线共用一个 jar;无 NMS,无反射)
Java 21
依赖项 org.xerial:sqlite-jdbc,由 Paper 的库加载器在运行时下载

如果你的服务器无法访问 Maven Central,SQLite 驱动程序将无法加载。检测和强制执行功能仍可正常工作;仅 /clientpolicy history 和跨会话违规计数器被禁用,并在启动时打印警告。

? 源码

源代码与问题追踪器:CyberSoldier112/clientpolicy

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源