<\/p>\n
# X-ray Fix<\/p>\n
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.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Seed-Based X-ray Protection** \u2014 Ores are stripped and re-placed using a private server secret. Even if a player knows the world seed, they cannot predict ore locations.
\n– **Visual X-ray Protection** \u2014 Sends fake block data (random ores and stone) to the client for all hidden underground blocks.
\n– **Multi-Dimension Support** \u2014 Custom obfuscation rules and fake material pools for both the Overworld and the Nether.
\n– **Folia Compatible** \u2014 Fully thread-safe and compatible with both Folia and traditional Paper servers.
\n– **Performance Optimized** \u2014 Uses `ChunkSnapshot` for efficient scanning and batched `sendMultiBlockChange` updates, ensuring zero impact on server MSPT.<\/p>\n
—<\/p>\n
## How It Works<\/p>\n
### Ore Stripping & Replacement
\nWhen 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 \u2014 making placement consistent for the server, but completely unpredictable for players.<\/p>\n
### Packet Obfuscation
\nWhen 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.<\/p>\n
### Dynamic Revealing
\nWhen a block is broken, placed, or blown up, X-ray Fix instantly sends high-priority multi-block change packets for all 6 adjacent neighbors \u2014 ensuring newly exposed blocks are revealed immediately with no visual glitches.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– **Server:** Spigot, Bukkit, Paper, Purpur, Pufferfish, or Folia (1.21.1+)
\n– **Java:** 21+
\n– **ProtocolLib** (Required)<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download and drop the JAR into your server’s `plugins` folder.
\n2. Start the server to generate `config.yml`.
\n3. *(Optional)* Set a custom `secret` in `config.yml`. If left empty, one will be auto-generated.
\n4. Adjust `max_y` and `fake_materials` to suit your needs.
\n5. Restart the server and you’re protected.<\/p>\n","protected":false},"excerpt":{"rendered":"
X-ray Fix defeats visual X-ray mods and seed-based exploits by re-generating ore locations using a private server secret and sending fake block data for hidden underground blocks, with no impact on server performance.<\/p>\n","protected":false},"featured_media":172100,"template":"","meta":{"_minecraft_slug":"x-ray-fix","_minecraft_project_id":"NTx4A7v0","_minecraft_author":"esaiaswestberg","_minecraft_license":"MIT","_minecraft_downloads":85,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"x-ray-fix.zip","_minecraft_size_bytes":688348,"_minecraft_version_count":28,"_minecraft_updated_at":"2026-05-15T20:13:08.179290Z","_minecraft_date_created":"2026-04-12T00:10:19.018257Z","_minecraft_date_modified":"2026-04-08T11:01:12.908382Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/x-ray-fix","_minecraft_icon_attachment_id":172100,"_minecraft_imported_at":"2026-06-09T21:50:24+00:00","_minecraft_import_hash":"b6db37cb85e492a047e3faa7b165e851","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,127,128,129,92,159],"mod_loader":[130,131,132,133,134],"minecraft_version":[49,50,51,52,53,54,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-172099","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-worldgen","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n