MinerTrack Wiki v2
Welcome to the MinerTrack v2 Documentation — a comprehensive, structured guide for server administrators using MinerTrack Anti-XRay.
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). It supports Paper, Purpur, Folia, and compatible Paper forks on Minecraft 1.18+ (Java 17+).
📚 Documentation Map
| Guide | Description |
|---|---|
| 📥 Installation | Server requirements, installation steps, first startup verification, and platform-specific notes |
| ⚙️ Configuration | Complete configuration reference: config.yml, world profiles (Configuration/*.yml), language.yml, Discord webhooks, and 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, and platform-specific issues |
| ❓ FAQ | Frequently asked questions covering installation, configuration, detection logic, compatibility, and support |
🚀 Quick Start Checklist
| Step | Action | Verify |
|---|---|---|
| 1 | Install MinerTrack on Paper/Purpur/Folia 1.18+ | /mtrack help works |
| 2 | Start server once to generate configs | plugins/MinerTrack/config.yml exists |
| 3 | Review default configuration | Rare ores match your world |
| 4 | Configure Discord webhooks (optional) | Test alert fires |
| 5 | Grant staff permissions | /mtrack verbose works for staff |
| 6 | Monitor logs for first 24–48 hours | Check logs/ for false positives |
🎯 Detection Philosophy
MinerTrack does not hide ores (unlike Paper Anti-XRay or Orebfuscator). Instead, it analyzes multi-dimensional mining behavior:
| Dimension | What It Tracks |
|---|---|
| Ore Rarity | Only rare ores (diamond, emerald, ancient debris) trigger checks |
| Vein Count | Number of distinct veins mined in a session |
| Path Analysis | Turn count, branching, Y-level changes, direct paths to ores |
| Natural Context | Cave air, water, lava detection to reduce false positives in natural caves |
| Violation Level (VL) | Accumulating score that decays when behavior normalizes |
Key Principle: An X-Ray user has two choices — mine like a normal player (defeating the purpose of X-Ray) or get caught.
📦 Supported Platforms & Versions
| Platform | Versions | Notes |
|---|---|---|
| Paper | 1.18.x – 1.21.x, 26.x | Primary target, best performance |
| Purpur | 1.18.x – 1.21.x, 26.x | Fully supported |
| Folia | 1.18.x – 1.21.x, 26.x | Region-aware scheduling supported |
| Paper Forks | Compatible forks | Tested on major forks |
| ❌ Spigot | Not supported | Missing API / performance APIs |
| ❌ Forge / Fabric (server) | Use Fabric module | Separate Fabric module available |
Java Requirement: Java 17+ (Java 21 recommended for 1.21+/26.x)
🔗 Useful Links
| 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/ |
📖 Reading Order Recommendation
- New users: Start with Installation → Configuration → Commands
- Upgrading from v1: Read Configuration changes first
- Troubleshooting issues: Jump to Troubleshooting or FAQ
- Advanced tuning: Configuration → Tuning Strategies
📝 Legacy v1 Documentation
The legacy single-page documentation is preserved for reference:
- Legacy v1 Wiki (English)
- Legacy v1 Wiki (中文) (same file, bilingual)
Note: v1 documentation is no longer updated. All new features and configuration options are documented in v2 only.