EventAntiXray

EventAntiXray is a compact Minecraft mod built on the Fabric platform, designed for server administrators who want to detect potential X-ray cheating. The mod tracks when players mine specific blocks and notifies staff if suspicious patterns are detected, without affecting gameplay or server performance. Important: this mod is solely for observation purposes and does not interfere with game mechanics, send packets, or alter block visibility.

Key Features

Intelligent Detection System

• Block Mining Monitoring: Tracks activity related to mining valuable ores and rare blocks.
• Customizable Thresholds: Set individual limits for each block type (e.g., alert after 10 diamonds within 30 minutes).
• Progressive Notifications: Receive follow-up alerts if suspicious activity continues.
• Time Window Analysis: Detects when excessive amounts of valuable blocks are mined within a specified time frame.

Alert Management

• Customizable Messages: Fully configurable notification texts with placeholders for player, block, count, and time data.
• Staff-Only Notifications: Alerts visible only to authorized staff members.
• Ongoing Activity Tracking: Special indicators for continued suspicious behavior.
• Auto-Reset Timer: Adjustable timer to reset tracking after periods of inactivity.
• Discord Integration: Sends notifications to Discord channels with customizable embeds.
• Player Inventory Display: View the contents of the player's inventory at the time of detection.
• Updatable Notifications: Updates existing Discord messages when ongoing activity is detected.

Advanced Configuration

• Per-Block Settings: Individual thresholds and alert messages for each specific block type.
• Block-Specific Timers: Set different time windows for various ore types.
• Automatic Reset: Configure automatic tracking reset after alerts (e.g., reset after 10 minutes).
• Ready Defaults: Pre-configured settings for all valuable blocks in vanilla Minecraft.
• Structured Configuration: Organized configuration layout with sections for general settings, alerts, debugging, and webhooks.

Default Ready Settings

• Diamond Ores: Alert after mining 10 ores within 30 minutes.
• Ancient Debris: Alert after mining 5 blocks within 20 minutes.
• Emerald Ores: Alert after mining 8 ores within 30 minutes.
• Gold Ores: Different thresholds for Nether and Overworld variants.
• Spawners: Special monitoring for mob spawners (alert after just 2 instances).
• Rare Blocks: Support for suspicious sand/gravel, budding amethyst, and other valuable blocks.

Server-Friendly Design

• Zero Performance Impact: Lightweight implementation that doesn't affect server TPS.
• Memory Efficient: Smart data structures minimize RAM usage.
• Observation Only: Never interferes with or cancels legitimate block mining.
• Automatic Cleanup: Self-maintaining data storage with periodic cleanup routines.
• Asynchronous Webhooks: Non-blocking webhook operations to maintain server performance.

Management Tools

• Admin Commands: View status, reload configuration, and access other functions via the /antixray command.
• JSON Configuration: Easy setup through a well-documented JSON file.
• Permission-Based: Uses standard permission system for staff notifications (requires antixray.notify permission).
• Detailed Logging: Optional comprehensive logging of suspicious activities.

Dependencies

For the mod to function properly, it requires: Fabric API, Kotlin, and EverlastingUtils.