X-ray Fix
X-ray Fix is a high-performance Minecraft server plugin designed to defeat both visual X-ray mods and seed-based X-ray exploits. It works by decoupling ore generation from the world seed and using advanced packet-level obfuscation to hide underground blocks from clients.
Features
- Seed-Based X-ray Protection — Ores are stripped and re-placed using a private server secret. Even if a player knows the world seed, they cannot predict ore locations.
- Visual X-ray Protection — Sends fake block data (random ores and stone) to the client for all hidden underground blocks.
- Multi-Dimension Support — Custom obfuscation rules and fake material pools for both the Overworld and the Nether.
- Folia Compatible — Fully thread-safe and compatible with both Folia and traditional Paper servers.
- Performance Optimized — Uses
ChunkSnapshotfor efficient scanning and batchedsendMultiBlockChangeupdates, ensuring zero impact on server MSPT.
How It Works
Ore Stripping & Replacement
When a chunk is generated (or loaded for the first time after installation), X-ray Fix scans it and removes all naturally generated ores. New ore positions are then calculated using a PRNG seeded with the chunk coordinates combined with a private server-side secret — making placement consistent for the server, but completely unpredictable for players.
Packet Obfuscation
When a chunk is sent to a player, X-ray Fix identifies all blocks that are hidden (not exposed to air or transparent blocks) and replaces them in the outgoing packet with random selections from a configurable pool of fake materials. Players never see the real blocks until they're actually exposed.
Dynamic Revealing
When a block is broken, placed, or blown up, X-ray Fix instantly sends high-priority multi-block change packets for all 6 adjacent neighbors — ensuring newly exposed blocks are revealed immediately with no visual glitches.
Requirements
- Server: Spigot, Bukkit, Paper, Purpur, Pufferfish, or Folia (1.21.1+)
- Java: 21+
- ProtocolLib (Required)
Installation
- Download and drop the JAR into your server's
pluginsfolder. - Start the server to generate
config.yml. - (Optional) Set a custom
secretinconfig.yml. If left empty, one will be auto-generated. - Adjust
max_yandfake_materialsto suit your needs. - Restart the server and you're protected.
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.20.6 |
1.20.6
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.20.5 |
1.20.5
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.20.4 |
1.20.4
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.6 |
1.21.6
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.9 |
1.21.9
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21 |
1.21
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.11 |
1.21.11
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.8 |
1.21.8
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.20.3 |
1.20.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.18 |
1.18
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.1 |
1.21.1
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.19.3 |
1.19.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.18.2 |
1.18.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.5 |
1.21.5
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.2 |
1.21.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.20.2 |
1.20.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.17.1 |
1.17.1
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.17 |
1.17
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.19.4 |
1.19.4
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.4 |
1.21.4
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.10 |
1.21.10
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.19.2 |
1.19.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.19 |
1.19
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.3 |
1.21.3
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.18.1 |
1.18.1
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.20.1 |
1.20.1
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.20 |
1.20
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
X-ray Fix - v0.1.0: Initial Release 0.1.0+mc1.21.7 |
1.21.7
|
bukkit, folia, paper, purpur, spigot
|
Download |