Antixray

[⚠️] 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).