2026-07-30

MinerTrack Anti-XRay

MinerTrack Anti-XRay

Modrinth Downloads Hangar Downloads CurseForge Downloads

Dev Build CI Latest Version GitHub issues GitHub latest commit GPLv3 license

Support Version

Support Server

Hey! Welcome to MinerTrack's wiki page!

📚 Documentation

🆕 V2 Documentation (Recommended)

The new structured documentation with comprehensive guides:

Guide Description
📥 Installation Server requirements, installation steps, first startup verification, platform-specific notes
⚙️ Configuration Complete configuration reference: config.yml, world profiles, language.yml, Discord webhooks, tuning strategies
🎮 Commands & Permissions Full command reference, permission nodes, usage examples, and staff workflows
🔧 Troubleshooting Common issues, false positive/negative tuning, Discord webhook debugging, performance tips
❓ FAQ Frequently asked questions covering installation, configuration, detection logic, compatibility

📖 Legacy Documentation

🚀 Quick Start

  1. Download from Modrinth, Hangar, or CurseForge
  2. Install — Place JAR in plugins/ folder on Paper/Purpur/Folia 1.18+
  3. Start server — Configs generate automatically in /plugins/MinerTrack/
  4. Configure — Edit config.yml and Configuration/*.yml as needed
  5. Reload — Run /mtrack reload or restart
  6. Monitor — Use /mtrack verbose for real-time alerts

🎯 What is MinerTrack?

MinerTrack is a lightweight, algorithm-based Anti-XRay plugin that detects X-Ray users by analyzing mining behavior patterns rather than hiding ores (which consumes significant server resources).

How it works: Multi-dimensional analysis of ore rarity, vein count, mining path patterns (turns, branches, Y-changes), and natural environment context (caves, water, lava) to build a Violation Level (VL) score that decays with normal behavior.

Key advantages over ore-hiding solutions:

  • ✅ Lightweight — minimal performance impact
  • ✅ Innovative detection engine — catches X-Ray users who mine "too perfectly"
  • ✅ You decide the punishment — kick, ban, warn, or just log
  • ✅ Supports latest Minecraft versions (1.18–1.21, 26.x)
  • ✅ Tested on 20+ player servers with minimal false positives (default config)
  • ✅ Completely free (GPLv3)
Resource Link
Modrinth (Releases) https://modrinth.com/plugin/minertrack
Hangar (PaperMC) https://hangar.papermc.io/Author87668/MinerTrack
CurseForge https://www.curseforge.com/minecraft/bukkit-plugins/minertrack
GitHub (Source & Issues) https://github.com/At87668/MinerTrack
Discord Support https://discord.gg/MzTea2W9cb
Patreon (Support) https://patreon.com/Author87668
Wiki (This Site) https://minertrack.pages.dev/wiki/

📋 Supported Platforms

Platform Status Notes
Paper ✅ Fully Supported Primary development target
Purpur ✅ Fully Supported All Paper features + optimizations
Folia ✅ Supported Region-aware scheduling compatible
Paper Forks ✅ Mostly Tested on major forks (Pufferfish, etc.)
Spigot/CraftBukkit ❌ Not Supported Missing required Paper APIs
Forge/Fabric (Server) ⚠️ Use Fabric Mod Separate Fabric module available

Java Requirement: Java 17+ (Java 21 recommended for 1.21+/26.x)