
? 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> |
切换自动惩罚功能 |
⚙️ 安装指南
- 从发布页面下载最新的
clairvoyant-vX.X.X.jar 文件。
- 将 JAR 文件放入服务器的
/plugins 目录中。
- 启动或重启你的服务器。
- 插件将生成一个包含
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:达到临界等级时执行的命令。

? Clairvoyant Anti-X-ray
Clairvoyant is a powerful, modern anti-x-ray plugin designed for PaperMC servers. It moves beyond simple ore obfuscation and instead focuses on intelligent data analysis to identify suspicious player behavior. By meticulously logging every mining action and analyzing patterns, Clairvoyant provides server administrators with the clear, evidence-based insights needed to catch cheaters and maintain a fair gameplay environment.
The goal of Clairvoyant is not to automatically ban players, but to empower administrators. It calculates a "Suspicion Score" for each player, allowing you to make informed decisions based on detailed reports and interactive in-game visualizations.
✨ Features
- Detailed Action Logging: Logs every block break, block place, and specific interactions to a local SQLite database for later analysis.
- Advanced Heuristic Engine: Analyzes player data against multiple configurable heuristics (e.g., ore-to-stone ratio, tunneling patterns, mining at suspicious Y-levels) to calculate an overall suspicion score.
- Interactive In-Game Visualization: The
/cv trace command generates interactive, admin-only visual markers in the world, showing exactly where a player has mined. Right-click a marker to get detailed information about the action.
- Comprehensive Reports: The
/cv check command provides a detailed report, breaking down the player's suspicion score by each heuristic, complete with color-coded status levels ([NORMAL], [SUSPICIOUS], [DANGEROUS]).
- Highly Configurable: Almost every aspect of the analysis engine—from heuristic weights to what ores are considered valuable—can be customized in the
config.yml file. This includes full support for adding modded or custom items.
- Performance-Focused: Built with an asynchronous architecture to minimize impact on server performance (TPS).
❔ Compatibility
This plugin is built on the Paper API. It will work on any server software that is a fork of Paper and maintains plugin compatibility.
✅ Supported Server Software:
- Paper (Recommended)
- Purpur
- And other direct forks of Paper.
❌ Unsupported Server Software:
- Folia
- Velocity, Waterfall, BungeeCord
- Spigot/Bukkit
?️ Commands & Permissions
The main command is /clairvoyant, with alias /cv. All commands require the permission clairvoyant.admin by default.
| Command |
Arguments |
Description |
/cv stats |
<player> |
Shows detailed mining statistics for the specified player, including counts for each block type broken. |
/cv trace |
<player> |
Generates an interactive, in-game visualization of the player's recent mining activity. Only you can see the markers. |
/cv check |
<player> |
Runs a full heuristic analysis on the player and displays a detailed suspicion report with an overall score and status. |
/cv help |
|
Displays the list of available commands. |
/cv autopunish |
<on|off> |
Toggles the auto-punish feature |
⚙️ Installation
- Download the latest
clairvoyant-vX.X.X.jar from the releases page.
- Place the JAR file into your server's
/plugins directory.
- Start or restart your server.
- The plugin will generate a
Clairvoyant folder containing the config.yml and clairvoyant.db files.
? Configuration Guide (config.yml)
All configuration is handled in the plugins/Clairvoyant/config.yml file. This guide explains each section in detail.
weights
This section controls how much influence each heuristic has on the final suspicion score. It's recommended to keep the sum of all weights equal to 1.0.
- Example: If you think
tunneling-pattern is a more reliable indicator of cheating than torch-usage, you can increase its weight and decrease the other.
weights:
high-value-ore-ratio: 0.15
tunneling-pattern: 0.25 # Increased weight
torch-usage: 0.05
# ... and so on
ore-lists
This is where you define which blocks the plugin should care about. You can add items from mods or custom plugins here using their unique namespaced ID (e.g., mod_id:item_id).
high-value: A list of rare and valuable ores. Mining these ores in unusual ways will significantly impact the suspicion score.
common: A map of common ores. Used by some heuristics to detect if a player is abnormally focusing on one type of common ore.
stones: A list of common blocks that are typically ignored during mining (like stone, dirt, deepslate). This list is crucial for calculating ore-to-stone ratios.
visualization-mapping
This section customizes the visual feedback for the /cv trace command.
default-marker: The block that will be used for any mined block not specified in the ores list below.
ores: A map that defines which block to show for a specific mined ore. For example, when a DIAMOND_ORE is mined, the trace will show a DIAMOND_BLOCK.
thresholds
This section allows you to fine-tune the sensitivity of each heuristic.
min-blocks-for-analysis: The minimum number of blocks a player must break before their data can be analyzed. This prevents inaccurate reports for new players.
high-value-ratio: The ore-to-stone ratio above which the heuristic will start adding to the suspicion score.
suspicious-y-levels: Defines the Y-level ranges that are considered optimal for finding valuable ores. Players who spend an unusual amount of time mining in these specific zones will get a higher score.
- And many others to control the sensitivity of each specific analysis.
suspicion-levels
This section sets the score boundaries for the status levels displayed in the /cv check report.
suspicious: Any score above this value will be flagged as [SUSPICIOUS].
dangerous: Any score above this value will be flagged as [DANGEROUS].
auto-punish
This section sets the threshold level and punishment command for the auto-punish feature.
enabled: Turns the auto-punish feature on and off.
threshold-level: Sets the threshold level for the auto-punish feature.
command: Sets the command to execute when the critical level is reached.
评论 0
登录后参与评分
还没有评论,来抢沙发吧