1.6latestMedusa Anti-Xray v1.6: Commands & UX (GUI Suspect List, Paginated Alert History, Live Watcher Mode)Jul 1, 2026

Medusa Anti-Xray - Phase E: Commands & UX (v1.6) Empowering Staff with Rich Command Utilities and an Interactive GUI Dashboard __________________________________________________ Overview We are pleased to announce the release of v1.6 (Phase E: Commands & UX) for Medusa Anti-Xray. This update focuses on expanding command controls, improving ease of access, and eliminating chat spam for your moderation team. We have introduced a suite of new /medusa subcommands, built-in pagination, and a fully interactive, head-based GUI dashboard. __________________________________________________ Key Highlights in v1.6 1. Comprehensive Command Expansion The plugin command suite has been upgraded to a comprehensive investigation toolkit: · /medusa top [page] - View a ranked leaderboard of the most suspicious miners based on their hidden ore ratios. · /medusa history <player> [page] - Pull up a detailed alert history log for a specific user. · /medusa reset <player> - Reset a player's cached statistical data (requires confirmation). · /medusa stats - View real-time global statistics (total tracked players, flagged players, alerts today). · /medusa watch <player> - Toggle real-time verbose action feeds for a suspect directly in your chat. · /medusa list [page] - List all players currently flagged above suspicion thresholds. · /medusa help - Quick reference for commands. All commands feature full Tab Completion support for player names and options. 2. Smart Chat Pagination All listing and history commands now leverage a flexible pagination system to keep chat clean: · Configurable default page sizes (commands.page-size: 10). · Smart navigation footer hints (e.g. "Page 1/3. Type /medusa top 2 for next page."). · Fully customized headers and entries via Code (Text): config.yml . 3. Interactive GUI Dashboard (/medusa gui) An optional chest-based interface to monitor your server: · Custom Player Heads: Lists flagged suspects showing their player skin heads. · Detailed Hover Lore: Hover over heads to view their current ratio, score, and total mined blocks. · Quick Action Clicks: · Left-Click -> Teleport directly to the player. · Right-Click -> Display their full alert history in chat. · Shift-Click -> Reset their data (safely prompted with confirmation). · Fully paginated chest GUI with navigation arrows for larger suspect pools. · Easy toggling via config option to disable if you prefer CLI-only management. __________________________________________________ New Config Additions (config.yml) Add the following settings to your config.yml file to customize messages and GUI behavior: Code (YAML): commands: page-size : 10 gui: enabled : true title : "Medusa - Suspects" page-size : 45 # 5 rows of 9 skull-lore: - "&7Ratio : &c{ratio}%" - "&7Score : &f{score}" - "&7Blocks : &f{total}" - "" - "&eLeft-click &7-> Teleport" - "&eRight-click &7-> History" - "&eShift-click &7-> Reset" messages: top-header : "&7=== Top Suspects (Page {page}/{totalPages}) ===" top-entry : "&c#{rank} {player} &7| Ratio: &c{ratio}% &7| Score: &f{score} &7| Blocks: &f{total}" top-no-results : "&7No flagged players." history-header : "&7Alert history for &f{player} &7(page {page}/{totalPages}):" history-entry : "&7{timestamp} &c{tier} &7Ratio: &c{ratio}% &7Score: &f{score}" history-empty : "&7No alert history for &f{player}." reset-success : "&aDetection data for &f{player} &ahas been reset." reset-confirm : "&eUse &c/medusa reset {player} confirm &eto proceed." stats-message : "&7Tracked: &f{tracked} &7| Flagged: &c{flagged} &7| Alerts today: &c{alertsToday}" watch-enabled : "&aNow watching &f{player}&a. Live updates enabled." watch-disabled : "&7Stopped watching &f{player}&7." help-header : "&7=== Medusa Anti-Xray Help ===" __________________________________________________ Full Changelog · Added: /medusa top, /medusa history, /medusa reset, /medusa stats, /medusa watch, /medusa list, /medusa help, /medusa gui commands. · Added: Tab completion parser for player targets and confirmation parameters on all subcommands. · Added: Global pagination utility logic (PaginationHelper.java) for text commands. · Added: GUI menu event listeners (GuiListener.java) and chest dashboard renderer (MedusaGui.java). · Added: Custom head textures, lore metadata, and click-to-teleport/history/reset events. · Added: Subcommand permission checks (medusa.staff, medusa.admin). · Improved: Code structure - separated command executors to keep the main router cleaner. __________________________________________________ Found a bug or have a suggestion? Open an issue on our GitHub repository. GitHub Repository

1.5Medusa Anti-Xray v1.5.0 - Alerting & Notifications (Webhooks, Clickable TP, Tiers, Digests)Jun 30, 2026

Medusa Anti-Xray v1.5.0 The Alerting & Notifications Update We are excited to release v1.5.0, focusing entirely on expanding how, where, and with what detail server administration teams are notified of potential X-ray activities. This update moves beyond basic in-game chat messages, introducing a robust, multi-channel alerting pipeline designed for modern server setups. Key Highlights · Escalation Tiers (WARNING ➔ ALERT ➔ CRITICAL): Detections are now classified into three tiers based on mining severity ratios. Each tier can be customized with its own alert permission, customized chat template, and unique sound profile. · Discord & Slack Webhooks: Instantly forward alerts to your external administration channels. Powered by a native, lightweight, asynchronous Java client to ensure zero impact on main-thread server performance. · Clickable Chat Components: Admin chat alerts now support Paper Adventure components. Detections include a clickable [TP] suffix that immediately teleport you to the suspect, alongside rich hoverable details. · Alert History Database Persistence: Every alert is archived to your database (SQLite or MySQL) with coordinates, ratio stats, and timestamps. Built-in automatic daily retention rules keep your tables clean. · New Notification Modes: Choose how staff are notified. Support has been added for play-on-demand sound effects, full subtitle screen overlays, and Bukkit boss bars with auto-expiry. · Suspect Digests: Keep tabs on general behavior with periodic, automated broadcasts summarizing the top suspect ratios directly to your online staff. Changelog & File Changes Added Files: · Introduced WebhookManager to handle secure, throttled HTTP POST requests. · Introduced AlertTier state enum to govern escalation logic. Configuration Updates: Your config.yml has been updated to version 1.4.0. Please merge the following blocks or let the plugin generate a fresh copy: Code (YAML): alerts: persist-history : true history-retention-days : 90 tiers: warning: threshold : 0.06 permission : "medusa.staff" message : "{prefix} &e

{player} &7shows unusual mining — Ratio: &e{ratio}% &7({score} pts / {total} blocks)" sound : BLOCK_NOTE_BLOCK_BELL volume : 0.5 pitch : 1.0 alert: threshold : 0.08 permission : "medusa.staff" message : "{prefix} &c

{player} &7may be X-raying! &cRatio: &f{ratio}% &7({score} pts / {total} blocks)" sound : BLOCK_NOTE_BLOCK_PLING volume : 1.0 pitch : 1.0 critical: threshold : 0.25 permission : "medusa.staff" message : "{prefix} &4&l

CRITICAL: {player} &7has extreme ratio! &4Ratio: &f{ratio}% &7({score} pts / {total} blocks)" sound : ENTITY_WITHER_SPAWN volume : 1.0 pitch : 1.0 clickable-components: enabled : true tp-command : "/tp {player}" tp-hover-text : "&7Click to teleport to &f{player}" check-hover-text : "&7Click for detailed stats" webhooks: enabled : false tiers : - alert - critical discord-url : "" slack-url : "" alert-modes: chat : true sound : true title : false title-fade-in-ticks : 10 title-stay-ticks : 70 title-fade-out-ticks : 20 boss-bar : false boss-bar-color : RED boss-bar-seconds : 5 digest: enabled : false interval-minutes : 15 top-n : 5 min-ratio : 0.04 message : "{prefix} &7Top {n} suspects:\n{entries}" entry-format : " &c{player} &7— Ratio: &c{ratio}% &7({score} pts / {total} blocks)" Thank you for running Medusa Anti-Xray. If you encounter any bugs or have suggestions, please submit them on our issue tracker.

1.4False-Positive Reduction: Mining Heuristics, Trust Tiers, & Calibration ModeJun 28, 2026

Medusa Anti-Xray v1.4.0 The False-Positive Reduction Update We are excited to announce the release of v1.4.0 for Medusa Anti-Xray! This update focuses heavily on False-Positive Reduction, introducing smart heuristics, grace periods, and baseline data-calibration tools to help you minimize false flags on legitimate players while maintaining high detection sensitivity for actual xrayers.

What's New? · Dynamic Mining-Style Classification Medusa now analyzes the spatial patterns of block-breaks (specifically Y-coordinate variance and ore-to-filler ratios) to classify players into distinct styles: CAVE explorers, STRIP miners, or BRANCH miners. Thresholds are dynamically adjusted based on these styles (e.g., natural cave explorers who naturally mine more exposed ores are granted relaxed thresholds, while strip miners are monitored more closely). ·

Teleport Cooldown Grace Period Prevents false flags when staff members teleport to players to observe them or when players use teleportation commands (/home, /warp, /tp). Players are exempt from suspicion scoring for a configurable duration (default: 10 seconds) immediately following a teleport event. · Learning & Baseline Calibration Mode Not sure what alert threshold to set? Turn on the new Learning Mode! It will passively sample the average ore-to-filler ratios across your server over a duration (e.g., 24 hours), suppress all alerts, and output recommended alert thresholds tailored to your specific world generation and player base. · ️ Granular Trust Tiers Instead of a binary "bypass or scan" system, you can now configure trust multipliers. Trusted veterans or players in certain permission groups can be given a lower suspicion sensitivity multiplier (e.g., Code (Text): 0.5 multiplier means they require twice as much suspicion to trigger an alert). Controlled via permission nodes or explicit UUID config listings. ·

Mine-Gap Suspicion Metric Xrayers typically beeline from vein to vein, leading to rapid successive ore breaks, whereas honest miners encounter ores at a slower, more natural pace. The new mine-gap multiplier amplifies the weight of ore breaks when mined in tight chronological succession.

New Configuration Additions Add the following options to your Code (Text): config.yml under their respective sections: Code (Text): detection: # C5 — Mine-gap multiplier (vein-first-discovery time metric) # Amplifies suspicion when ores are found in rapid succession mine-gap-multiplier: enabled: true min-gap-ms: 3000 # Gap <= this gets max-multiplier max-gap-ms: 120000 # Gap >= this gets 1.0 (no multiplier) max-multiplier: 2.0 # Multiplier applied at min-gap # C2 — Mining-style classification # Infers style (cave, branch, strip) and adjusts threshold sensitivity style-multipliers: enabled: true cave: 0.6 # Cave miners: threshold relaxed (0.08 / 0.6 ≈ 0.133) branch: 1.0 # Default strip: 1.1 # Strip miners: slightly more suspicious unknown: 1.0 false-positive-guards: # C1 — Seconds to exempt a player from detection after teleporting (0 = disabled) teleport-cooldown-seconds: 10 # C4 — Trust tiers & player whitelist # Multiplier scales the final suspicion score (lower = less sensitive) trust: default: 1.0 perm-multipliers: medusa.trust.high: 0.25 medusa.trust.medium: 0.5 medusa.trust.low: 0.75 players: {} # C3 — Learning / baseline calibration mode # Samples ratios to recommend thresholds; suppresses alerts during active calibration learning-mode: enabled: false duration-minutes: 1440 # 24 hours log-output: true persist: true recommend-percentile: 99 ️ Commands & Permissions · Command: Code (Text): /medusa trust <get|set> <player> [multiplier] (Permission: Code (Text): medusa.admin ) Allows operators to get or adjust a player's trust multiplier in real-time. · Permissions Added: · Code (Text): medusa.trust.high (default multiplier: 0.25) · Code (Text): medusa.trust.medium (default multiplier: 0.5) · Code (Text): medusa.trust.low (default multiplier: 0.75) Thank you for using Medusa Anti-Xray! Please report any feedback or issues on GitHub.

1.3MedusaAntiXray v1.3.0: Vein & Depth Accuracy UpdateJun 26, 2026

MedusaAntiXray v1.2.0 - Release Notes We are pleased to announce the release of MedusaAntiXray v1.2.0. This update, focused on Detection Accuracy, introduces a series of enhancements to the core statistical model. These changes are designed to improve signal accuracy, refine the scoring heuristics, and significantly reduce false positives. Key Features & Enhancements · Y-Level / Depth Normalization (B1) Mining tracked ores at optimal distribution layers (e.g., Diamond Ore at Y=-58) is mathematically normalized to carry less suspicion, whereas mining ores at improbable depths will carry a higher suspicion weight. This is managed via per-ore depth profile configurations. · Ore-Vein Grouping / Vein Awareness (B2) Contiguous ore blocks of the same type broken in rapid succession are now grouped and treated as a single vein event. The suspicion weight is distributed across the vein size using a configurable decay or division mode, preventing large natural veins from generating false-positive alerts. · Per-Ore Configurable Weights (B3) Replaced global flat weight defaults with custom, per-ore configurations. Each tracked ore can now have its own unique hidden and exposed weight values, allowing administrators to prioritize suspicion scoring for high-value targets like Diamond Ore and Ancient Debris. · Tool & Enchantment Awareness (B4) The plugin now evaluates the player's active tool type and enchantments. Legitimate mining equipment, such as tools with Silk Touch or Fortune, applies positive scoring multipliers, while mining valuable ores using basic, unenchanted tools applies a configurable penalty. · Graduated Exposure & Light Refinement (B5) Replaced binary exposure checks with a graduated exposure score. The heuristic counts the number of exposed faces on the ore block and applies a light-level penalty (such as sky light) to lower the suspicion score of ores exposed naturally or on the surface. · End World Support (B6) Extended tracking capabilities to the End dimension. Support has been added for tracking blocks such as Obsidian, End Stone Bricks, Purpur Blocks, and Chests in End-specific environments. Configuration Additions To utilize the new features, update your config.yml to include the following configuration parameters: Code (YAML): detection: depth-normalization: enabled : true default-multiplier : 1.0 profiles: DIAMOND_ORE: - y-min : -64 y-max : -54 multiplier : 0.5 - y-min : -53 y-max : 320 multiplier : 2.0 DEEPSLATE_DIAMOND_ORE: - y-min : -64 y-max : -54 multiplier : 0.5 - y-min : -53 y-max : 320 multiplier : 2.0 vein-grouping: enabled : true max-distance : 3 timeout-ticks : 100 mode : "divide" tool-modifiers: enabled : true silk-touch-multiplier : 0.5 fortune-multiplier-per-level : 0.8 no-enchantments-multiplier : 1.2 exposure-scoring: enabled : true sky-light-penalty : 0.5 hidden-threshold-faces : 1 worlds: end: enabled : false names : - "world_the_end" tracked-ores : - OBSIDIAN - END_STONE_BRICKS - PURPUR_BLOCK - CHEST filler-blocks : - END_STONE Upgrade Instructions · Shut down the Minecraft server instance. · Replace the existing plugin jar in the plugins directory with the new version. · Update the configuration file with the new parameters listed above. · Restart the server to apply the update.

1.2Ironclad FoundationJun 25, 2026

v1.1 — Ironclad Foundation This update is a pure stability release - no new detection features, just a hardened and more reliable foundation. If you're running v1.0, this upgrade is strongly recommended. Bug Fixes & Thread-Safety · Fixed a concurrency defect where the block-exposure check (isBlockExposed) was being called from an async task. Reading world/chunk state off the main thread is unsafe in Paper and could produce incorrect exposure results or, in rare cases, cause server instability. The check now always runs on the main thread. · Fixed a race condition where events mined between a player joining and their data loading from the database could be silently dropped. The merge logic now correctly preserves any blocks broken during the load window. · Prevented duplicate database loads for the same player on rapid rejoin scenarios. ️ Database Improvements · Data retention policy - A scheduled task now automatically purges events older than a configurable number of days (default: 30), preventing unbounded table growth over time. Set database.retention.days: 0 to disable. · Database failure fallback - If the database is unavailable at startup (e.g. MySQL host unreachable), the plugin now clearly logs that it is running in memory-only mode and how long until the next reconnect attempt. It will automatically reconnect and resume full persistence once the database becomes available again, without requiring a server restart. Configure with database.retry-interval-seconds (default: 120).

Config Validation The plugin now validates your config.yml on every startup and reload. If a value is out of range, a Material name is misspelled, or an unsupported database type is set, a clear [WARNING] will appear in your console pointing directly to the problem. No more silent fallbacks to defaults with no explanation. As always, please report any issues on the discussion thread or via GitHub Issues. Thank you for your support!

1.1Paper API migration O(1) ratio tracking, async detection & exposure checks, SQLite/MySQL persistenceJun 20, 2026

Offloaded the isBlockExposed exposure check and all ratio calculations to Paper's async scheduler, preventing main-thread lag when multiple players mine simultaneously.

1.0.0Jun 7, 2026

MedusaAntiXray

Similar projects

Let Me Despawn

JourneyMap

Emotecraft

Simple Tpa

Common Network

Set Home