Clairvoyant

插件

· 作者 nitg3n

一个通过记录和分析玩家行为来检测透视作弊者的插件。

0 本站下载 0 关注 更新于 1 年前

最新 1.1.0 · 1.21.8 · Paper / Purpur

一键开服(送7天)

Logo

? Clairvoyant 反 X 光作弊插件

Clairvoyant 是一款专为 PaperMC 服务器设计的强大、现代化的反 X 光作弊插件。它超越了简单的矿石混淆技术,转而专注于智能数据分析以识别可疑的玩家行为。通过仔细记录每一次挖掘动作并分析模式,Clairvoyant 为服务器管理员提供清晰、基于证据的洞察,帮助抓获作弊者并维持公平的游戏环境。

Clairvoyant 的目标不是自动封禁玩家,而是赋予管理员权力。它为每位玩家计算一个“嫌疑分数”,让你能够根据详细的报告和交互式游戏内可视化做出明智的决定。


✨ 功能特性

  • 详细的行为日志记录:将每次方块破坏、放置以及特定交互记录到本地 SQLite 数据库中,供后续分析使用。
  • 高级启发式引擎:针对多种可配置的启发式规则(例如:矿石与石头比例、隧道挖掘模式、在可疑 Y 轴高度进行挖掘)分析玩家数据,从而计算出总体嫌疑分数。
  • 交互式游戏内可视化:/cv trace 命令会在世界中生成仅管理员可见的交互式视觉标记,精确显示玩家挖掘的位置。右键点击标记可查看该行为的详细信息。
  • 综合报告:/cv check 命令提供一份详细报告,按每种启发式规则分解玩家的嫌疑分数,并带有颜色编码的状态等级([NORMAL]、[SUSPICIOUS]、[DANGEROUS])。
  • 高度可配置:分析引擎的几乎所有方面——从启发式权重到哪些矿石被视为有价值——都可以在 config.yml 文件中进行自定义。这包括对添加模组或自定义物品的完整支持。
  • 注重性能:采用异步架构构建,以最大限度地减少对服务器性能(TPS)的影响。

❔ 兼容性

本插件基于 Paper API 构建。它可以在任何作为 Paper 分支并保持插件兼容性的服务器软件上运行。

✅ 支持的服务器软件:

  • Paper(推荐)
  • Purpur
  • 以及其他 Paper 的直接分支版本。

❌ 不支持的服务器软件:

  • Folia
  • Velocity, Waterfall, BungeeCord
  • Spigot/Bukkit

?️ 命令与权限

主命令为 /clairvoyant,别名为 /cv。所有命令默认都需要 clairvoyant.admin 权限。

命令 参数 描述
/cv stats <player> 显示指定玩家的详细挖掘统计数据,包括每种被破坏方块的计数。
/cv trace <player> 生成玩家近期挖掘活动的交互式游戏内可视化效果。只有你能看到这些标记。
/cv check <player> 对玩家进行全面启发式分析,并显示包含总分和状态的详细嫌疑报告。
/cv help 显示可用命令列表。
/cv autopunish <on|off> 切换自动惩罚功能

⚙️ 安装指南

  1. 从发布页面下载最新的 clairvoyant-vX.X.X.jar 文件。
  2. 将 JAR 文件放入服务器的 /plugins 目录中。
  3. 启动或重启你的服务器。
  4. 插件将生成一个包含 config.yml 和 clairvoyant.db 文件的 Clairvoyant 文件夹。

? 配置指南 (config.yml)

所有配置均在 plugins/Clairvoyant/config.yml 文件中处理。本指南将详细解释每个部分。

weights

此部分控制每种启发式规则对最终嫌疑分数的影响程度。建议将所有权重的总和保持在 1.0。

  • 示例:如果你认为 tunneling-pattern(隧道挖掘模式)比 torch-usage(火把使用情况)更能可靠地指示作弊行为,你可以增加其权重并降低其他权重。
weights:
  high-value-ore-ratio: 0.15
  tunneling-pattern: 0.25 # 增加权重
  torch-usage: 0.05
  # ... 以此类推

ore-lists

在这里定义插件应该关注的方块。你可以使用其唯一的命名空间 ID(例如 mod_id:item_id)在此处添加来自模组或自定义插件的物品。

  • high-value:稀有且高价值矿石的列表。以不寻常的方式开采这些矿石将显著影响嫌疑分数。
  • common:常见矿石的映射。某些启发式规则使用它来检测玩家是否异常专注于某一种常见的矿石。
  • stones:通常在挖掘过程中被忽略的常见方块列表(如石头、泥土、深板岩)。此列表对于计算矿石与石头比例至关重要。

visualization-mapping

此部分自定义 /cv trace 命令的视觉反馈。

  • default-marker:用于下方 ores 列表中未指定的任何被挖掘方块的方块类型。
  • ores:定义特定被挖掘矿石应显示的方块类型的映射。例如,当 DIAMOND_ORE 被挖掘时,追踪线将显示 DIAMOND_BLOCK。

thresholds

此部分允许你微调每种启发式规则的灵敏度。

  • min-blocks-for-analysis:在分析玩家数据之前,玩家需要破坏的最少方块数量。这可以防止对新玩家的报告不准确。
  • high-value-ratio:当矿石与石头的比例超过此值时,启发式算法将开始增加可疑分数。
  • suspicious-y-levels:定义被认为适合发现珍贵矿石的 Y 层范围。在这些特定区域花费异常大量时间挖掘的玩家将获得更高的分数。
  • 以及许多其他选项用于控制每项具体分析的灵敏度。

suspicion-levels

此部分设置 /cv check 报告中显示的状态等级的分数边界。

  • suspicious:任何高于此值的分数都将被标记为 [SUSPICIOUS](可疑)。
  • dangerous:任何高于此值的分数都将被标记为 [DANGEROUS](危险)。

auto-punish

此部分设置自动惩罚功能的阈值等级和惩罚命令。

  • enabled:开启或关闭自动惩罚功能。
  • threshold-level:设置自动惩罚功能的阈值等级。
  • command:达到临界等级时执行的命令。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源