Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
English
ADSAntiray2 - Keep Your Minecraft Server Fair. For Free.
Tired of players finding all your diamonds in minutes? ADSAntiray2 is a lightweight anti-cheat that just works. It quietly watches for X-ray and auto-mining behavior, so you can focus on running your server.
Why it's different:
- Runs Smoothly: Designed to have almost zero impact on your server's performance. No lag, just protection.
- It's Free. Really. This is a passion project. Use it on your community server, no strings attached.
- Smart Detection: Uses a mix of statistical analysis to tell the difference between a lucky digger and a cheater, reducing false positives.
- Simple for Admins: Get alerts in chat, check player suspicion levels, and use simple commands. A clear GUI makes it easy to see what's up.
- Proactive Protection: Features a Decoy Block Interaction (DBI) system that deploys fake blocks to catch X-ray users in the act.
Important Stuff:
- Free for Community Use: You can't sell it or bundle it with a paid server host. Keep it free for everyone.
- All Rights Reserved: The code is closed source. Please don't decompile or reverse engineer it.
- Development: This is developed in spare time. Updates come when they're ready.
For server owners who want a no-nonsense, free solution to keep things fair.
Chinese Version
ADSAntiray2 - 免费为你的服务器守护公平
受够了玩家五分钟挖光所有钻石？ADSAntiray2 是一个轻量级反作弊插件，它默默工作，专门应对透视和自动挖矿，让你能专心管理服务器。
它的不同之处：
- 运行顺畅： 几乎不会拖慢你的服务器。不卡顦，只有保护。
- 完全免费，真心免费。 这是一个用爱发电的项目。放心用于你的社区服，没有套路。
- 智能检测： 通过统计分析来区分幸运儿和作弊者，有效减少误封。
- 管理简单： 在聊天栏接收警报、查询玩家可疑度、使用简单命令。清晰的管理界面让你一目了然。
- 主动防御： 采用伪方块交互探测 (DBI) 系统，部署隐藏诱饵方块来当场捉住透视作弊者。
重要须知：
- 免费用于社区： 禁止商用。你不能出售它或将其用于付费托管服务。让它对所有人免费。
- 保留所有权利： 本项目闭源。请勿进行反编译或逆向工程。
- 开发状态： 这是利用空闲时间开发的项目。有更新时就会发布。
献给所有需要一款简单、免费、有效的公平游戏守护者的服主。
ADSAntiray2: How It Works
This plugin quietly runs on your server, watching how players mine blocks. It doesn't just count diamonds; it looks for patterns that don't make sense, using statistical methods that go beyond simple thresholds.
The Basics:
- Data Collection: It logs what blocks are broken, when, and where. It also notes how players look around while mining and which tools they are holding when they break blocks.
- Multi-World Check: It analyzes behavior separately in the Overworld, Nether, and End.
- Threaded Processing: Configuration and setup happen on the main server thread, but the data structures are built to support efficient processing.
- Persistent Statistics: Tracks cumulative mining stats (total blocks, total ores found, ore type counts) across sessions for long-term behavior analysis.
What It Looks For:
The core of the plugin is a combined score (QSS - Query Suspicion Score) built from a set of advanced checks:
- OreSeekerIndex (OSI): The flagship algorithm. Uses binomial distribution tests to determine if a player's ore discovery rate is statistically impossible for legitimate play. Also checks mining path directness and ore clustering.
- Value vs. Effort: Flags players who find a suspiciously high number of valuable ores without mining much else.
- Timing Analysis: Spots players who break valuable blocks with machine-like perfect timing, lacking the natural variance of human players.
- Movement: Detects robotic-looking head turns, snap movements, or movement between digs that seems too precise. Also checks if a player's view direction correlates with finding hidden ores.
- Pathing: Identifies miners who take abnormally efficient, straight-line paths to every ore. Uses least-squares regression to analyze linearity and Shannon entropy to measure directional randomness.
- AutoTool Detection: Catches players using clients that automatically swap to the best tool for a block just before breaking it, based on rapid inventory slot changes.
- Decoy Block Interaction (DBI): Deploys invisible decoy blocks near suspicious players. Mining these blocks is strong evidence of X-ray usage.
Built for Performance, Offered for Free.
It's a single, self-contained plugin. It's free for you to use on your server. You can't use it for commercial purposes or reverse engineer it.
Compare: New Features Added in the New Version Compared to the Old
- Multi-Version Support: Explicitly supports Minecraft versions 1.7 through 26.2 (based on Spigot 1.13.2 API), compared to 1.7.10-1.16.5 in the original. Includes compatibility layers for legacy (pre-1.13) versions (e.g.,
getTypeId,SKULL_ITEMvsPLAYER_HEAD). - GUI Systems:
- Admin GUI: A comprehensive graphical interface (
/adsar guiop) for admins to view online players, their violation levels (VL), suspicion scores (QSS), perform actions like reloading configs, toggling the plugin, accessing settings, managing reports, and viewing statistics. - Player Report GUI: A GUI system (
/adsar report) allowing players to report suspicious players for X-Ray or AutoTool usage, which sends notifications to online admins. - Report Management GUI: Admins can view and manage pending player reports through a dedicated GUI (
ReportManagerHolder). - Settings GUI: A GUI (
/adsar config) for admins to adjust sensitivity, toggle detection modules, change language, and modify alert/kick thresholds in real-time. - Player Detail GUI: Click on a player in the admin panel to see a detailed breakdown of their QSS scores across all detection modules, plus quick actions (kick, IP ban, set VL, clear data).
- Admin GUI: A comprehensive graphical interface (
- Decoy Block Interaction (DBI): An active detection system that places "decoy" stone/deepslate blocks near high-VL players. These blocks are tracked internally; attempting to mine them strongly indicates X-Ray usage and increases the player's violation level. Repeated interactions lead to kicks. Features configurable cooldowns and usage limits.
- AutoTool Detection: A new detection module specifically designed to identify players using mods/clients that automatically switch to the optimal tool for the block being mined. It analyzes rapid tool switch timings (
ToolSwitchRecord) and correlates them with ore discovery events. - Enhanced Path and Movement Analysis:
- PathAnalysis: Replaces SPC and APE. Detects abnormal mining paths using directional entropy (Shannon Entropy over 8 compass sectors), path linearity (Least Squares regression with R² scoring), and branching patterns (detecting 90-degree turns common in branch mining).
- ViewAnalysis: Replaces TA. Analyzes player view angles (yaw/pitch) for snap movements and correlates view direction with ore discovery locations using angular velocity and IQR-based statistical analysis.
- Statistical Math Library: A complete suite of 14 mathematical and statistical utility methods has been added directly to the
DetectionEngine, including Normal CDF/PDF, Error function, Binomial/Poisson survival functions, Shannon Entropy, Circular statistics, Pearson correlation, and Least Squares fitting. - OSI (OreSeekerIndex): A brand-new core algorithm that performs statistical hypothesis testing (binomial distribution) on a player's ore discovery rate versus the expected vanilla generation rate. It also measures path directness to ores and clustering of ore discoveries.
- Temporal Analysis: Replaces TAS. Analyzes the consistency of time intervals between block breaks using the Interquartile Range (IQR) and median to distinguish between human-like variability and bot-like consistency.
- Speed Analysis: Detects abnormally fast consecutive ore breaks by comparing intervals against configurable thresholds, using median and IQR for robust anomaly detection.
- Enhanced Player Data Tracking: The
PlayerDatamodel now tracks tool switch records (with slot from/to info), persistent cumulative stats (total blocks mined, total ores found, per-ore-type counts), and decoy hit counts. Data is saved and loaded from YAML files per world. - Asynchronous & Thread Safety: Uses
ConcurrentHashMapfor thread-safe data storage of player data, decoy blocks, IP bans, reports, and statistics. Tasks are scheduled viaBukkit.getScheduler()for periodic analysis. - IP Ban System: Full IP ban management system with configurable durations, persistence to
ipbans.yml, and automatic kick-on-join enforcement. Includesban/unbancommands. - Player Report System: A complete player-driven reporting mechanism. Players can report others for X-Ray or AutoTool via a GUI. Reports are stored, have a cooldown, expire after a set time, and are managed by admins through a dedicated GUI.
- Comprehensive Statistics: The plugin tracks and reports statistics including players tracked, pending reports, IP bans, decoys deployed/hits, kicks, and alerts, viewable via
/adsar statsor the Admin GUI. - Data Export: Admins can export a player's full block break history to a CSV file using
/adsar export <player>for detailed offline analysis or evidence. - Extended Command Set: Several new administrative commands have been added for better control and investigation, including
notify,history,checkall,purge,export, anddbi(manual decoy deployment). - Improved Kick and Report Handling: Saves logs of kicks (with QSS, VL, source, location) and player reports (with target, type, timestamp) for later review by admins via the
historycommand or file inspection. - Configurable Alert & Kick Thresholds: Allows finer control over when alerts are sent (
qss-threshold-low-alert,qss-threshold-high-alert) and when players are kicked or IP-banned (kick-vl-threshold,ip-ban-vl-threshold), based on QSS scores and accumulated Violation Levels (VL). VL increases per analysis cycle and decays over time. - Language Support: Added support for both English and Chinese (Simplified) messages throughout the plugin and GUIs, configurable via
languagesetting inconfig.yml. - Sensitivity Control: Global sensitivity setting (1-10) that affects detection, adjustable via command (
/adsar sensitivity) or the Settings GUI.
Command Usage (New Version):
| Command | Description | Permission |
|---|---|---|
/adsar on |
Enable the plugin | adsantiray.admin |
/adsar off |
Disable the plugin | adsantiray.admin |
/adsar reload / /adsar restart |
Reload configuration file | adsantiray.admin |
/adsar guiop |
Open the Admin GUI | adsantiray.admin |
/adsar config |
Open the Settings GUI | adsantiray.admin |
/adsar report |
Open the Player Report GUI | Player only |
/adsar vl <player> |
Show player's total violation level | adsantiray.admin |
/adsar auto <player> |
Recommend action based on QSS/VL analysis | adsantiray.admin |
/adsar check <player> |
Immediately check a player and show detailed scores in chat | adsantiray.admin |
/adsar checkall |
Check all online players | adsantiray.admin |
/adsar list |
List all online tracked players and their total VL | adsantiray.admin |
/adsar topvl |
Show top 10 online players by total violation level | adsantiray.admin |
/adsar clear <player> |
Clear all tracked data for a player | adsantiray.admin |
/adsar setvl <player> <value> |
Manually set a player's violation level | adsantiray.admin |
/adsar ban <player> [reason] |
IP-ban a player for 3 hours | adsantiray.admin |
/adsar unban <player> |
Unban a player by name | adsantiray.admin |
/adsar dbi <player> |
Manually deploy decoy blocks for a player | adsantiray.admin |
/adsar history <player> |
Show kick history for a player | adsantiray.admin |
/adsar export <player> |
Export a player's mining data to a CSV file | adsantiray.admin |
/adsar stats |
Show plugin runtime statistics | adsantiray.admin |
/adsar purge [days] |
Clean up old offline player data files | adsantiray.admin |
/adsar notify <player> <message> |
Send a private notification to a player | adsantiray.admin |
/adsar sensitivity <1-10> |
Set detection sensitivity level | adsantiray.admin |
/adsar lang |
Toggle between English and Chinese language | adsantiray.admin |
/adsar version |
Show plugin and supported MC version | Everyone |
/adsar status |
Show if the plugin is active or disabled | Everyone |
/adsar help |
Show help menu | Everyone |
Chinese Version (Chinese Version):
新版相比旧版增加的功能：
- 多版本支持： 明确支持 Minecraft 1.7 至 26.2 版本（基于 Spigot 1.13.2 API），而原版支持 1.7.10-1.16.5。包含针对旧版（1.13 之前）的兼容层（例如
getTypeId,SKULL_ITEM与PLAYER_HEAD）。 - GUI 系统：
- 管理员 GUI： 一个全面的图形界面 (
/adsar guiop)，供管理员查看在线玩家、他们的违规等级 (VL)、嫌疑评分 (QSS)、执行重载配置、开关插件、访问设置、管理举报、查看统计信息。 - 玩家举报 GUI： 一个 GUI 系统 (
/adsar report)，允许玩家举报可疑玩家使用 X-Ray 或 AutoTool，举报会发送给在线的管理员。 - 举报管理 GUI： 管理员可以通过专门的 GUI (
ReportManagerHolder) 查看和处理待处理的玩家举报。 - 设置 GUI： 一个 GUI (
/adsar config)，供管理员实时调整灵敏度、切换检测模块、更换语言、修改警报/踢出阈值。 - 玩家详情 GUI： 在管理员面板中点击玩家，查看其在所有检测模块中的 QSS 详细评分，以及快速操作（踢出、IP封禁、设置VL、清除数据）。
- 管理员 GUI： 一个全面的图形界面 (
- 伪方块交互探测 (DBI)： 一种主动检测系统，会在高 VL 玩家附近放置 "诱饵" 石头/深板岩方块。这些方块会被插件内部跟踪；尝试挖掘它们 strongly indicates X-Ray 使用行为，并会增加玩家的违规等级。重复交互会导致踢出。具有可配置的冷却时间和使用次数限制。
- 自动工具检测 (AutoTool Detection)： 一个专门设计的新检测模块，用于识别使用自动切换到最适合挖掘方块的工具的 mods/客户端。它分析快速的库存槽切换 (
ToolSwitchRecord) 并将其与矿石发现事件相关联。 - 增强的路径与移动分析：
- PathAnalysis： 替代了 SPC 和 APE。使用方向熵（对 8 个罗盘扇区的香农熵）、路径线性度（带 R² 评分的最小二乘回归）和分支模式（检测分支采矿中常见的 90 度转弯）来检测异常的采矿路径。
- ViewAnalysis： 替代了 TA。分析玩家的视角角度（Yaw/Pitch）寻找急动和关联，同时使用角速度和 IQR 统计方法判断视角是否与矿石发现有关。
- 统计数学工具库： 直接添加到
DetectionEngine中的一套完整的 14 个数学和统计实用方法，包括正态分布累积分布函数/概率密度函数、误差函数、二项分布/泊松分布生存函数、香农熵、圆统计、皮尔逊相关系数和最小二乘拟合。 - OSI (OreSeekerIndex)： 一个全新的核心算法，对比玩家的矿石发现率与预期的 vanilla 生成率，使用二项分布进行统计假设检验。还测量玩家挖掘路径的直接性和矿石发现的聚集程度。
- 时间分析 (Temporal Analysis)： 替代了 TAS。使用四分位距 (IQR) 和中位数分析方块破坏时间间隔的一致性，以区分人类操作的变异性和机器人的一致性。
- 速度分析 (Speed Analysis)： 通过比较连续矿石破坏的间隔与可配置的阈值，检测异常快速的挖掘行为，使用中位数和 IQR 进行稳健的异常检测。
- 增强的玩家数据追踪：
PlayerData模型现在追踪工具切换记录（带槽位信息）、持久性累积统计（总采矿数、总矿石数、各矿石类型计数）和诱饵命中次数。数据按世界保存和加载到 YAML 文件中。 - 异步与线程安全： 使用
ConcurrentHashMap实现线程安全的数据存储（玩家数据、诱饵方块、IP封禁、举报、统计）。通过Bukkit.getScheduler()安排定期分析任务。 - IP封禁系统： 完整的 IP 封禁管理系统，支持可配置的封禁时长、持久化到
ipbans.yml，并在玩家加入时自动执行封禁。包含ban/unban指令。 - 玩家举报系统： 完整的玩家驱动举报机制。玩家可以通过 GUI 举报他人使用 X-Ray 或 AutoTool。举报会被存储、具有冷却时间、过期后自动失效，并由管理员通过专门的 GUI 进行管理。
- 全面统计功能： 插件追踪并报告统计信息，包括被跟踪玩家数、待处理举报数、IP封禁数、部署/命中诱饵数、自动踢出数和警报数，可通过
/adsar stats或管理员 GUI 查看。 - 数据导出： 管理员可以使用
/adsar export <player>将玩家的完整采矿记录导出为 CSV 文件，用于离线详细分析或作为证据。 - 扩展的命令集： 增加了多个新的管理命令，以便更好地控制和调查，包括
notify,history,checkall,purge,export，以及dbi(手动部署诱饵)。 - 改进的踢出与举报处理： 保存踢出记录（包含 QSS、VL、原因来源、位置坐标）和玩家举报记录（包含目标、类型、时间戳），供管理员通过
history指令或文件查看。 - 可配置的警报与踢出阈值： 允许根据 QSS 分数和累积的违规等级 (VL) 精细控制何时发送警报 (
qss-threshold-low-alert,qss-threshold-high-alert) 以及何时踢出或封禁 IP (kick-vl-threshold,ip-ban-vl-threshold)。VL 每次分析周期增加，并随时间衰减。 - 语言支持： 全插件和 GUI 中添加了英文和中文（简体）双语消息支持，可通过
config.yml中的language设置进行配置。 - 灵敏度控制： 影响检测效果的全局灵敏度设置（1-10），可通过指令 (
/adsar sensitivity) 或设置 GUI 进行调整。
指令用法 (新版)：
| 指令 | 说明 | 权限 |
|---|---|---|
/adsar on |
启用插件 | adsantiray.admin |
/adsar off |
禁用插件 | adsantiray.admin |
/adsar reload / /adsar restart |
重载配置文件 | adsantiray.admin |
/adsar guiop |
打开管理员 GUI | adsantiray.admin |
/adsar config |
打开设置 GUI | adsantiray.admin |
/adsar report |
打开玩家举报 GUI | 玩家专用 |
/adsar vl <玩家名> |
查看玩家的总违规等级 | adsantiray.admin |
/adsar auto <玩家名> |
根据 QSS/VL 分析推荐处理方式 | adsantiray.admin |
/adsar check <玩家名> |
立即检查玩家并在聊天栏显示详细评分 | adsantiray.admin |
/adsar checkall |
检查所有在线玩家 | adsantiray.admin |
/adsar list |
列出所有被追踪的在线玩家及其总VL | adsantiray.admin |
/adsar topvl |
显示违规等级前10名的在线玩家 | adsantiray.admin |
/adsar clear <玩家名> |
清除指定玩家的所有追踪数据 | adsantiray.admin |
/adsar setvl <玩家名> <值> |
手动设置玩家的违规等级 | adsantiray.admin |
/adsar ban <玩家名> [原因] |
封禁玩家的 IP 3小时 | adsantiray.admin |
/adsar unban <玩家名> |
解封指定玩家 | adsantiray.admin |
/adsar dbi <玩家名> |
为玩家手动部署诱饵方块 | adsantiray.admin |
/adsar history <玩家名> |
查看玩家的踢出历史记录 | adsantiray.admin |
/adsar export <玩家名> |
将玩家的采矿数据导出为 CSV 文件 | adsantiray.admin |
/adsar stats |
显示插件运行统计信息 | adsantiray.admin |
/adsar purge [天数] |
清理旧的离线玩家数据文件 | adsantiray.admin |
/adsar notify <玩家名> <消息> |
向玩家发送私聊通知 | adsantiray.admin |
/adsar sensitivity <1-10> |
设置检测灵敏度 | adsantiray.admin |
/adsar lang |
切换中英文语言 | adsantiray.admin |
/adsar version |
显示插件及支持的 MC 版本 | 所有人 |
/adsar status |
显示插件是否启用/禁用 | 所有人 |
/adsar help |
显示帮助菜单 | 所有人 |
The old description
English
ADSAntiray2 - Keep Your Minecraft Server Fair. For Free.
Tired of players finding all your diamonds in minutes? ADSAntiray2 is a lightweight anti-cheat that just works. It silently watches for X-ray and auto-mining, so you can focus on running your server.
Why it's different:
- Runs Smoothly: Designed to have almost zero impact on your server's performance. No lag, just protection.
- It's Free. Really. This is a passion project. Use it on your community server, no strings attached.
- Gets the Job Done: Uses a mix of smart checks to tell the difference between a lucky digger and a cheater.
- Simple for Admins: Get alerts in chat, check player suspicion levels, and use simple commands. A clear GUI makes it easy to see what's up.
Important Stuff:
- Free for Community Use: You can't sell it or bundle it with a paid server host. Keep it free for everyone.
- All Rights Reserved: The code is closed source. Please don't decompile or reverse engineer it.
- Development: I work on this in my free time. Updates come when they're ready.
For server owners who want a no-nonsense, free solution to keep things fair.
中文版本
ADSAntiray2 - 免费为你的服务器守护公平
受够了玩家五分钟挖光所有钻石？ADSAntiray2 是一个轻量级反作弊，它默默工作，专门应对透视和自动挖矿，让你能专心管理服务器。
它的不同之处：
- 运行顺畅： 几乎不会拖慢你的服务器。不卡顿，只有保护。
- 完全免费，真心免费。 这是一个用爱发电的项目。放心用于你的社区服，没有套路。
- 效果到位： 通过多种智能判断来区分幸运儿和作弊者，有效减少误封。
- 管理简单： 在聊天栏接收警报、查询玩家可疑度、使用简单命令。清晰的管理界面让你一目了然。
重要须知：
- 免费用于社区： 禁止商用。你不能出售它或将其用于付费托管服务。让它对所有人免费。
- 保留所有权利： 本项目闭源。请勿进行反编译或逆向工程。
- 开发状态： 这是我利用空闲时间开发的项目。有更新时就会发布。
献给所有需要一款简单、免费、有效的公平游戏守护者的服主。
ADSAntiray2: How It Works
This plugin quietly runs on your server, watching how players mine blocks. It doesn't just count diamonds; it looks for patterns that don't make sense.
The Basics:
- Data Collection: It logs what blocks are broken, when, and where. It also notes how players look around while mining.
- Multi-World Check: It analyzes behavior separately in the Overworld, Nether, and End.
- Async Processing: All this analysis happens off the main server thread, so it doesn't cause lag.
What It Looks For:
The core of the plugin is a combined score (QSS) built from a few key checks:
- Value vs. Effort: Flags players who find a suspiciously high number of valuable ores without mining much else.
- Timing: Spots players who break valuable blocks with machine-like perfect timing.
- Movement: Detects robotic-looking head turns or movement between digs that seems too precise.
- Pathing: Identifies miners who take unbelievably efficient, straight-line paths to every ore.
Built for Performance, Offered for Free.
It's a single, self-contained plugin. It's free for you to use on your server. You can't use it for commercial purposes or reverse engineer it.
compare:
English Version:
New Features Added in the New VersionCompared to the Old:
- Multi-Version Support: Explicitly supports Minecraft versions 1.12 to 1.20.4 (based on Spigot 1.13.2 API), compared to 1.7.10-1.16.5 in the original. Includes compatibility layers for legacy (pre-1.13) and modern versions.
- GUI Systems:
- Admin GUI: A comprehensive graphical interface (
/adsar guiop) for admins to view online players, their violation levels (VL), suspicion scores (QSS), perform actions like reloading configs, toggling the plugin, and accessing advanced settings. - Player Report GUI: A GUI system (
/adsar report) allowing players to report suspicious players for X-Ray or AutoTool usage, which sends notifications to online admins. - Report Management GUI: Admins can view and manage pending player reports through a dedicated GUI.
- Admin GUI: A comprehensive graphical interface (
- Decoy Block Interaction (DBI): An active detection system that places hidden "decoy" blocks (client-side invisible) near high-VL players. Attempts to mine these decoys strongly indicate X-Ray usage and can lead to automatic kicks.
- AutoTool Detection: A new detection algorithm (
calculateAutoTool) specifically designed to identify players using mods/clients that automatically switch to the optimal tool for the block being mined, based on rapid tool switch timings. - Enhanced Spatial Analysis (SLM & APE): Added two new detection algorithms:
- SLM (Straight-Line Mining): Detects mining in unusually straight lines.
- APE (Abnormal Path Efficiency): Detects pathfinding or movement that is abnormally efficient towards valuable blocks.
- Asynchronous Processing & Thread Management: Uses an
ExecutorService(fixed thread pool) for potentially heavier tasks and emphasizes asynchronous execution for analysis to minimize server impact. - Data Encryption: Implements AES encryption for storing sensitive player data like kick records and report histories.
- Self-Test System: A comprehensive self-check runs on startup and periodically, verifying configs, version compatibility, algorithm weights, material definitions, reflection methods, and encryption, disabling the plugin if critical failures occur.
- More Detailed Player Data: Tracks tool switch timestamps in addition to block breaks and turn records.
- Extended Command Set: Several new administrative commands have been added for better control and investigation.
- Improved Kick and Report Handling: Saves encrypted logs of kicks and player reports for later review by admins.
- Configurable Alert & Kick Thresholds: Allows finer control over when alerts are sent and when players are kicked based on QSS scores and VL.
Command Usage (New Version):
| Command | Description | Permission |
|---|---|---|
/adsar on |
Enable the plugin | adsantiray.admin |
/adsar off |
Disable the plugin | adsantiray.admin |
/adsar restart |
Restart the plugin | adsantiray.admin |
/adsar reload |
Reload configuration file | adsantiray.admin |
/adsar vl <player> |
Show player's total violation level | adsantiray.admin |
/adsar auto <player> |
Recommend action based on VL analysis | adsantiray.admin |
/adsar sensitivity <1-10> |
Set detection sensitivity level | adsantiray.admin |
/adsar list |
List all online tracked players and their total VL | adsantiray.admin |
/adsar clear <player> |
Clear all data for a player | adsantiray.admin |
/adsar topvl |
Show top 10 online players by total violation level | adsantiray.admin |
/adsar notify <player> <message> |
Send a notification to a player | adsantiray.admin |
/adsar guiop |
Open the Admin GUI | adsantiray.admin |
/adsar report |
Open the Player Report GUI (for reporting others) | (None, but player only) |
/adsar history <player> |
Show kick history for a player | adsantiray.admin |
/adsar check <player> |
Immediately check a player and show detailed scores | adsantiray.admin |
/adsar setvl <player> <value> |
Manually set a player's violation level | adsantiray.admin |
/adsar reset <player> |
Completely reset all data for a player | adsantiray.admin |
/adsar help |
Show help menu | adsantiray.admin |
中文版本 (Chinese Version):
新版相比旧版增加的功能：
- 多版本支持： 明确支持 Minecraft 1.12 到 1.20.4 版本（基于 Spigot 1.13.2 API），而原版支持 1.7.10-1.16.5。包含了针对旧版（1.13之前）和新版的兼容层。
- GUI 系统：
- 管理员 GUI： 一个全面的图形界面 (
/adsar guiop)，供管理员查看在线玩家、他们的违规等级 (VL)、嫌疑评分 (QSS)、执行重载配置、开关插件、访问高级设置等操作。 - 玩家举报 GUI： 一个 GUI 系统 (
/adsar report)，允许玩家举报可疑玩家使用 X-Ray 或 AutoTool，举报会发送给在线的管理员。 - 举报管理 GUI： 管理员可以通过专门的 GUI 查看和处理待处理的玩家举报。
- 管理员 GUI： 一个全面的图形界面 (
- 伪方块交互探测 (DBI)： 一种主动检测系统，会在高 VL 玩家附近放置隐藏的“诱饵”方块（客户端不可见）。尝试挖掘这些诱饵方块 strongly indicates X-Ray 使用行为，并可能导致自动踢出。
- 自动工具检测 (AutoTool Detection)： 一个新的检测算法 (
calculateAutoTool)，专门设计用于识别使用 mods/客户端自动切换为最适合挖掘方块的工具的玩家，基于快速切换工具的时间。 - 增强的空间分析 (SLM & APE)： 增加了两个新的检测算法：
- SLM (直线挖掘检测)： 检测不自然的直线挖掘行为。
- APE (异常路径效率)： 检测通向有价值方块的路径或移动异常高效。
- 异步处理与线程管理： 使用
ExecutorService（固定线程池）处理潜在的重任务，并强调分析的异步执行以最小化服务器影响。 - 数据加密： 使用 AES 加密存储敏感的玩家数据，如踢出记录和举报历史。
- 自检系统： 一个全面的自检在启动时和定期运行，验证配置、版本兼容性、算法权重、材料定义、反射方法和加密，如果发生严重错误则禁用插件。
- 更详细的玩家数据： 除了记录方块破坏和转向，还记录工具切换的时间戳。
- 扩展的命令集： 增加了多个新的管理命令，以便更好地控制和调查。
- 改进的踢出和举报处理： 保存加密的踢出记录和玩家举报日志，供管理员后续查看。
- 可配置的警报和踢出阈值： 允许根据 QSS 分数和 VL 更精细地控制何时发送警报和踢出玩家。
指令用法 (新版)：
| 指令 | 说
Spoiler
明 | 权限 |
| :--- | :--- | :--- |
| /adsar on | 启用插件 | adsantiray.admin |
| /adsar off | 禁用插件 | adsantiray.admin |
| /adsar restart | 重启插件 | adsantiray.admin |
| /adsar reload | 重载配置文件 | adsantiray.admin |
| /adsar vl <玩家名> | 查看玩家的总违规等级 | adsantiray.admin |
| /adsar auto <玩家名> | 根据 VL 分析推荐处理方式 | adsantiray.admin |
| /adsar sensitivity <1-10> | 设置检测灵敏度 | adsantiray.admin |
| /adsar list | 列出所有被追踪的在线玩家及其总VL | adsantiray.admin |
| /adsar clear <玩家名> | 清除指定玩家的所有数据 | adsantiray.admin |
| /adsar topvl | 显示违规等级前10名的在线玩家 | adsantiray.admin |
| /adsar notify <玩家名> <消息> | 向玩家发送通知消息 | adsantiray.admin |
| /adsar guiop | 打开管理员GUI | adsantiray.admin |
| /adsar report | 打开玩家举报GUI（用于举报他人） | （无，但需玩家执行） |
| /adsar history <玩家名> | 查看玩家的踢出历史记录 | adsantiray.admin |
| /adsar check <玩家名> | 立即检查玩家并显示详细评分 | adsantiray.admin |
| /adsar setvl <玩家名> <值> | 手动设置玩家的违规等级 | adsantiray.admin |
| /adsar reset <玩家名> | 完全重置玩家的所有数据 | adsantiray.admin |
| /adsar help | 显示帮助菜单 | adsantiray.admin |