ADSAnitiray

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

1. 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_ITEM vs PLAYER_HEAD).
2. 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).
3. 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.
4. 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.
5. 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.
6. 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.
7. 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.
8. 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.
9. Speed Analysis: Detects abnormally fast consecutive ore breaks by comparing intervals against configurable thresholds, using median and IQR for robust anomaly detection.
10. Enhanced Player Data Tracking: The PlayerData model 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.
11. Asynchronous & Thread Safety: Uses ConcurrentHashMap for thread-safe data storage of player data, decoy blocks, IP bans, reports, and statistics. Tasks are scheduled via Bukkit.getScheduler() for periodic analysis.
12. IP Ban System: Full IP ban management system with configurable durations, persistence to ipbans.yml, and automatic kick-on-join enforcement. Includes ban/unban commands.
13. 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.
14. Comprehensive Statistics: The plugin tracks and reports statistics including players tracked, pending reports, IP bans, decoys deployed/hits, kicks, and alerts, viewable via /adsar stats or the Admin GUI.
15. 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.
16. Extended Command Set: Several new administrative commands have been added for better control and investigation, including notify, history, checkall, purge, export, and dbi (manual decoy deployment).
17. 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 history command or file inspection.
18. 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.
19. Language Support: Added support for both English and Chinese (Simplified) messages throughout the plugin and GUIs, configurable via language setting in config.yml.
20. Sensitivity Control: Global sensitivity setting (1-10) that affects detection, adjustable via command (/adsar sensitivity) or the Settings GUI.

Command Usage (New Version):

---

Chinese Version (Chinese Version):

新版相比旧版增加的功能：

1. 多版本支持： 明确支持 Minecraft 1.7 至 26.2 版本（基于 Spigot 1.13.2 API），而原版支持 1.7.10-1.16.5。包含针对旧版（1.13 之前）的兼容层（例如 getTypeId, SKULL_ITEM 与 PLAYER_HEAD）。
2. GUI 系统：
   • 管理员 GUI： 一个全面的图形界面 (/adsar guiop)，供管理员查看在线玩家、他们的违规等级 (VL)、嫌疑评分 (QSS)、执行重载配置、开关插件、访问设置、管理举报、查看统计信息。
   • 玩家举报 GUI： 一个 GUI 系统 (/adsar report)，允许玩家举报可疑玩家使用 X-Ray 或 AutoTool，举报会发送给在线的管理员。
   • 举报管理 GUI： 管理员可以通过专门的 GUI (ReportManagerHolder) 查看和处理待处理的玩家举报。
   • 设置 GUI： 一个 GUI (/adsar config)，供管理员实时调整灵敏度、切换检测模块、更换语言、修改警报/踢出阈值。
   • 玩家详情 GUI： 在管理员面板中点击玩家，查看其在所有检测模块中的 QSS 详细评分，以及快速操作（踢出、IP封禁、设置VL、清除数据）。
3. 伪方块交互探测 (DBI)： 一种主动检测系统，会在高 VL 玩家附近放置 "诱饵" 石头/深板岩方块。这些方块会被插件内部跟踪；尝试挖掘它们 strongly indicates X-Ray 使用行为，并会增加玩家的违规等级。重复交互会导致踢出。具有可配置的冷却时间和使用次数限制。
4. 自动工具检测 (AutoTool Detection)： 一个专门设计的新检测模块，用于识别使用自动切换到最适合挖掘方块的工具的 mods/客户端。它分析快速的库存槽切换 (ToolSwitchRecord) 并将其与矿石发现事件相关联。
5. 增强的路径与移动分析：
   • PathAnalysis： 替代了 SPC 和 APE。使用方向熵（对 8 个罗盘扇区的香农熵）、路径线性度（带 R² 评分的最小二乘回归）和分支模式（检测分支采矿中常见的 90 度转弯）来检测异常的采矿路径。
   • ViewAnalysis： 替代了 TA。分析玩家的视角角度（Yaw/Pitch）寻找急动和关联，同时使用角速度和 IQR 统计方法判断视角是否与矿石发现有关。
6. 统计数学工具库： 直接添加到 DetectionEngine 中的一套完整的 14 个数学和统计实用方法，包括正态分布累积分布函数/概率密度函数、误差函数、二项分布/泊松分布生存函数、香农熵、圆统计、皮尔逊相关系数和最小二乘拟合。
7. OSI (OreSeekerIndex)： 一个全新的核心算法，对比玩家的矿石发现率与预期的 vanilla 生成率，使用二项分布进行统计假设检验。还测量玩家挖掘路径的直接性和矿石发现的聚集程度。
8. 时间分析 (Temporal Analysis)： 替代了 TAS。使用四分位距 (IQR) 和中位数分析方块破坏时间间隔的一致性，以区分人类操作的变异性和机器人的一致性。
9. 速度分析 (Speed Analysis)： 通过比较连续矿石破坏的间隔与可配置的阈值，检测异常快速的挖掘行为，使用中位数和 IQR 进行稳健的异常检测。
10. 增强的玩家数据追踪： PlayerData 模型现在追踪工具切换记录（带槽位信息）、持久性累积统计（总采矿数、总矿石数、各矿石类型计数）和诱饵命中次数。数据按世界保存和加载到 YAML 文件中。
11. 异步与线程安全： 使用 ConcurrentHashMap 实现线程安全的数据存储（玩家数据、诱饵方块、IP封禁、举报、统计）。通过 Bukkit.getScheduler() 安排定期分析任务。
12. IP封禁系统： 完整的 IP 封禁管理系统，支持可配置的封禁时长、持久化到 ipbans.yml，并在玩家加入时自动执行封禁。包含 ban/unban 指令。
13. 玩家举报系统： 完整的玩家驱动举报机制。玩家可以通过 GUI 举报他人使用 X-Ray 或 AutoTool。举报会被存储、具有冷却时间、过期后自动失效，并由管理员通过专门的 GUI 进行管理。
14. 全面统计功能： 插件追踪并报告统计信息，包括被跟踪玩家数、待处理举报数、IP封禁数、部署/命中诱饵数、自动踢出数和警报数，可通过 /adsar stats 或管理员 GUI 查看。
15. 数据导出： 管理员可以使用 /adsar export <player> 将玩家的完整采矿记录导出为 CSV 文件，用于离线详细分析或作为证据。
16. 扩展的命令集： 增加了多个新的管理命令，以便更好地控制和调查，包括 notify, history, checkall, purge, export，以及 dbi (手动部署诱饵)。
17. 改进的踢出与举报处理： 保存踢出记录（包含 QSS、VL、原因来源、位置坐标）和玩家举报记录（包含目标、类型、时间戳），供管理员通过 history 指令或文件查看。
18. 可配置的警报与踢出阈值： 允许根据 QSS 分数和累积的违规等级 (VL) 精细控制何时发送警报 (qss-threshold-low-alert, qss-threshold-high-alert) 以及何时踢出或封禁 IP (kick-vl-threshold, ip-ban-vl-threshold)。VL 每次分析周期增加，并随时间衰减。
19. 语言支持： 全插件和 GUI 中添加了英文和中文（简体）双语消息支持，可通过 config.yml 中的 language 设置进行配置。
20. 灵敏度控制： 影响检测效果的全局灵敏度设置（1-10），可通过指令 (/adsar sensitivity) 或设置 GUI 进行调整。

指令用法 (新版)：

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:

1. **Multi-Version Sup