MedusaAntiXray

Medusa Anti-Xray
A lightweight, high-performance heuristic anti-xray solution for modern Minecraft servers.

Why Medusa Anti-Xray?
Unlike traditional engine-based Anti-Xray (like Paper's Engine-Mode 2) which can increase server resource usage, generate packet overhead, and affect client-side rendering, Medusa Anti-Xray uses a smart, server-side heuristic monitoring system. It silently tracks mining behaviors, differentiates exposed cave ores from hidden pocket ores, and detects suspicious patterns without impacting your server's performance.

⭐ Core Features

• Heuristic Detection Algorithm: Evaluates mining behavior dynamically using a sliding window rather than checking individual blocks.
• Exposed vs. Hidden Ore Weighting: Smart detection differentiates between naturally exposed cave ores (low suspicion) and fully enclosed stone-hidden ores (high suspicion).
• High Performance & Memory-Efficient: Keeps player history in a fast in-memory cache and automatically releases memory when players log out.
• Sliding Time-Window Analysis: Monitors activity over custom durations (e.g., last 30 minutes) to avoid false flags.
• Multi-World & Multi-Ore Customization: Separate configurations, tracked ores, and filler blocks for overworld and nether dimensions.
• Staff Alert Cooldowns: Automatically limits warning rate to prevent spamming staff chat.

Installation

• Download the MedusaAntiXray.jar file.

• Place the jar file inside your server's plugins directory.

• Restart your server to generate the configuration files.

• Customize the config.yml file to match your gameplay needs.

• Run /medusa reload to apply changes!