[⚠️] NOTE! If you have any issues with the plugin, please report them on our Discord!
🔒 AntiXray Plugin: AntiXray is a lightweight anti-cheat plugin for Minecraft 1.21+ (Paper/Spigot) that prevents X-Ray cheating using ProtocolLib packet manipulation.
👉 Also available for versions 26.1+
Features:
🎮 Player Experience:
• Players mine normally – ores reveal when digging nearby
• X-Ray cheaters see only stone/deepslate instead of diamonds, emeralds, and gold
• No lag, no false positives, invisible protection
⚙️ Admin Commands (/antixray – requires antixray.admin permission):
• /antixray reload – Reload configuration
• /antixray toggle – Enable/disable protection
• /antixray mode <1|2> – Switch engine mode (1 = stone/deepslate, 2 = random blocks)
🛡️ Protection:
• Hidden ores: Diamond, Emerald, Gold, Iron, Coal, Lapis, Redstone, Copper, Ancient Debris, Nether ores
• Engine Mode 1 (Recommended): Replaces ores with stone (Y ≥ 0) or deepslate (Y < 0)
• Engine Mode 2: Replaces ores with random blocks from a configurable list
• Reveal mechanism: Ores become visible within update-radius (default: 2 blocks) when a player starts mining nearby
• update-on-damage: true triggers on first hit
🔐 Security:
• Packet-level obfuscation using ProtocolLib – modifies chunk data before sending to clients
• Each player has individual exposed-block tracking (stored in memory, cleared on logout)
• Effectively blocks X-Ray texture packs, mods, and shaders
📦 Requirements:
• Minecraft: 1.21+
• Dependencies: ProtocolLib (required)
• Server: Bukkit/Spigot/Paper 1.21.4+
• Java: 21
⚡ Performance:
• CPU: Low – obfuscation only on chunk load + mining events (event-driven)
• RAM: Minimal – ~32 bytes per exposed block (1000 blocks ≈ 32KB per player)
• Network: Negligible – small sendBlockChange() packets only
• Thread-safe (ConcurrentHashMap), no continuous scanning, asynchronous chunk processing
🚀 Installation:
• Download and install ProtocolLib from SpigotMC
• Place ProtocolLib.jar in the plugins/ folder
• Place AntiXray-2.0.jar in the plugins/ folder
• Restart server
• Configure plugins/AntiXray/config.yml (optional)
Plugin auto-detects ProtocolLib on startup (disables itself if missing).
