X-ray Fix

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.

85

Quick challenge

How far can you run before the mobs catch you?

X-ray Fix

A wide, promotional graphic for a Minecraft security tool called "XRayFix." The image uses a split-screen composition within a rustic, stone-textured border to showcase a side-by-side comparison of a dark underground cave. On the left side, labeled "BEFORE XRAYFIX," various ores like diamonds, gold, and coal are clearly visible through the stone walls, alongside a hidden chest. On the right side, labeled "WITH XRAYFIX," the cave appears more complex with mining tracks and machinery, but the ore locations are obscured or randomized. In the center stands a classic Minecraft character (Steve) holding a pickaxe next to a large, glowing shield emblem featuring a red "X" and various gemstones. The text at the bottom reads "XRAYFIX: ANTI-XRAY PROTECTION PACKET OBFUSCATOR" in a blocky, Minecraft-style font. The overall art style is a detailed, isometric pixel art aesthetic with dramatic lighting.

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

- Performance Optimized — Ores are stripped and re-placed using a private server secret. Even if a player knows the world seed, they cannot predict ore locations. - Performance Optimized — Sends fake block data (random ores and stone) to the client for all hidden underground blocks. - Performance Optimized — Custom obfuscation rules and fake material pools for both the Overworld and the Nether. - Performance Optimized — Fully thread-safe and compatible with both Folia and traditional Paper servers. - Performance Optimized — Uses `ChunkSnapshot` for efficient scanning and batched `sendMultiBlockChange` updates, 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

- Java: Spigot, Bukkit, Paper, Purpur, Pufferfish, or Folia (1.21.1+) - Java: 21+ - Java: (Required)

---

Installation

1. Download and drop the JAR into your server's `plugins` folder. 2. Start the server to generate `config.yml`. 3. *(Optional)* Set a custom `secret` in `config.yml`. If left empty, one will be auto-generated. 4. Adjust `max_y` and `fake_materials` to suit your needs. 5. Restart the server and you're protected.

ADS