?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
X-ray Fix

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.

87
0
87
0

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x
1.19.2–1.19.4
1.19
1.18.x
1.17.x

Platforms

Links

Report issues View source
Sponsor on GitHub

Tags

Creators

Details

Licensed MIT
Published last month

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

  • 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 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

  • Server: Spigot, Bukkit, Paper, Purpur, Pufferfish, or Folia (1.21.1+)
  • Java: 21+
  • ProtocolLib (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.