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/Purpur) that prevents X-Ray cheating using ProtocolLib packet manipulation without modifying the actual world data.

👉 Compatible with Java 21+ and Paper/Purpur 1.21.4+

Features:

🎮 Player Experience:

• Legit players see everything normally – ores visible from caves are rendered correctly with zero delay.
• Ores reveal instantly when mining – nearby ores are exposed automatically as you dig.
• X-Ray cheaters see fake blocks instead of valuable ores like diamonds, gold, and emeralds.
• Lag-free invisible packet protection.

⚙️ Admin Commands (/antixray – alias: /ax – requires antixray.admin permission):

• /antixray reload – Hot-reload config.yml and rebuild the NMS block registry without restarting the server.
• /antixray status – Display live cache metrics (size, hit/miss rate, and JVM/ProtocolLib status).
• /antixray debug – Show current debug logs status.
• /antixray help – Show command help menu.

🛡️ Protection Engine:

• Configurable Hidden Blocks: Choose which ores to protect (defaults: Diamond, Emerald, Gold, Iron, Coal, Lapis, Redstone, Copper, Ancient Debris, Nether Ores, etc.).
• Engine Mode - LAYER: Replaces ores that are completely covered on all 6 sides by solid blocks with stones/deepslate.
• Engine Mode - OBFUSCATE: Replaces hidden ores AND injects random fake ores into stone/deepslate to completely mislead X-Ray users.
• Reveal Mechanism: Ores become visible within a configurable reveal-radius (default: 2 blocks) when a block is broken nearby.
• World Whitelist & Blacklist: Explicitly enable or disable protection on specific worlds.

🔐 Security:

• Packet-level Obfuscation: Intercepts outgoing MAP_CHUNK packets using ProtocolLib and rewrites the bit-packed PalettedContainer byte array.
• Bypass Permission: Players with the antixray.bypass permission will see the real, unmodified chunk data (great for trusted admins).
• Robust Protection: Blocks all client-side X-Ray mods, texture packs, cheat clients, and custom shaders.

📦 Requirements:

• Server: Paper or Purpur 1.21.4+ (required for NMS Mojang mappings).
• Java: 21 or Java 25.
• Dependency: ProtocolLib 5.3.0+ (required).

⚡ Performance & Optimization:

• Thread-safe LRU Cache: Obfuscated chunk packet data is cached globally per chunk (ChunkDataCache) – chunks are processed once and served instantly to all players, minimizing CPU usage.
• Read-Write Locking: Thread-safe execution for multi-threaded packet handling.
• Smart Boundary Checks: Invalidates cache for adjacent chunks when a block is broken on chunk borders.
• Minimal Memory Footprint: Efficient cache invalidation on block break/place and TTL cleanups.

🚀 Installation:

1. Download and install ProtocolLib from SpigotMC or GitHub.
2. Place ProtocolLib.jar in your plugins/ folder.
3. Place antixray.jar in your plugins/ folder.
4. Restart your server to generate the default configuration.
5. Customize plugins/AntiXray/config.yml and run /antixray reload.