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
• E-Utils

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.

EventAntiXray

EventAntiXray is a lightweight, purely observational Fabric mod for server administrators who want to detect potential X-ray cheating without impacting server performance or gameplay. It intelligently tracks player mining activity for valuable blocks and discreetly alerts staff when it detects suspicious patterns, complete with Discord integration.

Dependencies

• Fabric API
• Fabric Language Kotlin
• E-Utils (EverlastingUtils)

Features

• Observational Detection: Monitors block breaks without interfering with gameplay. It never cancels actions, sends packets, or affects block visibility, ensuring zero impact on players.
• Time-Window Analysis: Detects suspicious activity by tracking how many valuable blocks a player mines within a configurable time period (e.g., 10 diamonds in 30 minutes).
• Progressive Alerts: Sends an initial alert and then tracks continued suspicious activity, sending follow-up alerts with a special prefix if the behavior persists.
• Discord Webhook Integration: Sends detailed, customizable embed messages to a Discord channel when an alert is triggered, including the player's inventory at the time of detection. Alerts for continued activity will smartly update the original Discord message.
• Player-Placed Block Tracking: Features an optional MySQL database integration to track blocks placed by players, effectively eliminating false positives from players mining their own placed ores.
• Highly Configurable: Customize everything from thresholds and time windows on a per-block basis to the in-game alert messages and sounds.
• Performance First: Built to be extremely lightweight. It has zero impact on server TPS and uses efficient data structures to minimize memory usage, with non-blocking operations for webhooks.

Commands

The primary command is /antixray, with the alias /eax.

Configuration

EventAntiXray uses a single, well-documented configuration file located at config/eventantixray/config.json. This file is broken down into clear sections for easy management.

tracked_blocks - The Core of Detection

This is a list where you define every block you want to monitor. Each entry has several key options:

alerts - Customizing Staff Notifications

This section controls how staff are notified in-game.

• sound: Configure the sound_id, volume, and pitch of the sound played to staff on an alert. You can even set multipliers to make the sound louder or higher-pitched for each subsequent alert.
• continued_alert_prefix: A MiniMessage-formatted prefix added to alerts for ongoing suspicious activity (e.g., "<red>[Continued]</red> ").

webhook - Discord Integration

Connect the mod to your Discord server for remote monitoring.

• enabled: A simple true/false toggle to turn on webhook notifications.
• url: The full URL of your Discord webhook. Alerts will be sent here as detailed embed messages.

database - Preventing False Positives

This section is for configuring the optional MySQL database to track player-placed blocks.

• enabled: If true, the mod will connect to your MySQL database to log and check against blocks placed by players. When a player breaks a block, the mod will first check the database. If the block was player-placed, it will be ignored for X-ray detection, preventing false alerts.
• Connection Details: The config provides fields for your database address, databasename, username, and password, along with other standard connection options.