EventAntiXray

EventAntiXray is a lightweight Minecraft Fabric mod designed for server administrators to detect potential X-ray cheating. It tracks when players mine specific blocks and alerts staff if suspicious patterns are detected, without affecting gameplay or server performance. Note: This mod is purely observational and doesn't interfere or send packets or affect block visibility.

Features

Smart Detection System

• Block Break Monitoring: Tracks mining activity for valuable ores and rare blocks
• Configurable Thresholds: Set custom thresholds for each block type (e.g., alert after 10 diamonds in 30 minutes)
• Progressive Alerts: Receive follow-up alerts if suspicious activity continues
• Time Window Analysis: Detects when too many valuable blocks are mined in a specified time period

Alert Management

• Customizable Messages: Fully configurable alert messages with player, block, count, and time placeholders
• Staff-Only Notifications: Alerts only visible to staff with appropriate permissions
• Continued Activity Tracking: Special indicators for ongoing suspicious behavior
• Auto-Reset Timer: Configurable timer to reset tracking after a period of inactivity
• Discord Webhook Integration: Send alerts to Discord channels with custom embeds
• Player Inventory Display: View the player's inventory contents at the time of detection
• Stackable Alerts: Updates existing webhook messages when continued activity is detected

Advanced Configuration

• Per-Block Settings: Individual thresholds and alert messages for each block type
• Block-Specific Timers: Set different time windows for different ore types
• Automatic Reset: Configure automatic tracking reset after alerts (e.g., reset after 10 minutes)
• Comprehensive Defaults: Pre-configured for all valuable blocks in vanilla Minecraft
• Sectioned Configuration: Organized config structure with separate sections for general, alerts, debug, and webhook settings

Ready-to-Use Defaults

• Diamond Ores: Alert after mining 10 ores in 30 minutes
• Ancient Debris: Alert after mining 5 blocks in 20 minutes
• Emerald Ores: Alert after mining 8 ores in 30 minutes
• Gold Ores: Different thresholds for Nether and Overworld variants
• Spawners: Special detection for monster spawners (alerts after just 2)
• Rare Blocks: Coverage for suspicious sand/gravel, budding amethyst, etc.

Server-Friendly Design

• Zero Performance Impact: Lightweight implementation doesn't affect server TPS
• Memory Efficient: Smart data structures minimize memory usage
• Observation Only: Never affects or cancels valid block breaks
• Automatic Cleanup: Self-maintaining data storage with periodic cleanup
• Asynchronous Webhooks: Non-blocking webhook operations to ensure server performance

Management Tools

• Admin Commands: View status, reload configuration, and more via /antixray
• JSON Configuration: Easily configure through a documented JSON file
• Permission-Based: Uses standard permission system for staff alerts (antixray.notify)
• Comprehensive Logging: Optional detailed logging of suspicious activity

Dependencies

• Kotlin
• Fabric API
• EverlastingUtils

Usage

monitoring configuration. Staff with the antixray.notify permission or OP level 3+ will receive alerts when potential X-ray cheating is detected.

To enable Discord webhooks, set webhook.enabled to true and add your webhook ID/token to webhook.url in the configuration.