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
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.
