XRay Wiki

XRay is a client-side utility mod that lets you see through ordinary blocks to reveal the ores, caves, and structures hidden behind them. Toggle it with a keybind and the world's stone, dirt, and other "noise" blocks turn invisible, leaving only the blocks you care about - diamonds, iron, redstone, ancient debris, caves, and so on - clearly visible.

It also includes quality-of-life extras: an on-screen coordinate display so you can mark finds, and a fullbright option that brightens the world so you can explore caves without torches.

XRay only changes what your client renders; it does not modify the world. Be aware that many multiplayer servers consider X-ray cheating - use it on your own worlds or where it is permitted.

1. Load into a world.
2. Press the X-ray toggle key (see Keybinds) - the surrounding terrain becomes transparent and only your selected blocks remain visible.
3. Mine straight toward the exposed ores. Toggle X-ray back off to see normally.

XRay is driven by keybinds you can rebind in Options > Controls (look for the mod's category):

• Toggle X-ray - turn the see-through view on/off (the core feature).
• Open the block-list menu - choose which blocks remain visible while X-ray is active.
• Toggle fullbright - brighten the world to maximum so caves are lit without torches.

Pick keys that do not clash with your normal controls so you can flip X-ray on and off quickly while mining.

The power of XRay is choosing exactly which blocks show while everything else turns invisible.

• Open the block-list / configuration menu (via its keybind or the mod config screen).
• Enable the ores and blocks you want to see (diamond, gold, iron, redstone, lapis, emerald, ancient debris, spawners, etc.).
• Disable everything else - those blocks become transparent so the targets stand out.
• You can usually add custom blocks to the list, so you can hunt for anything (e.g. chests, specific deepslate variants, or modded ores).

Tune the list to the job: a tight list of just the ore you are after gives the cleanest view.

• Use the coordinate display to write down where you spotted a vein, then dig there directly.
• Turn on fullbright for cave exploration so you never need to place torches.
• Keep your visible-block list short when hunting one resource - fewer block types means less visual clutter.
• Toggle X-ray off before building or navigating tight spaces, since transparent terrain can be disorienting.

X-ray doesn't toggle. Check the keybind in Options > Controls - it may be unbound or conflicting with another key.

I see through everything / nothing. Open the block list and make sure the ores you want are enabled and the filler blocks are disabled.

Will this get me banned online? Many servers prohibit X-ray and have detection. Only use it in single-player or where the server explicitly allows it.

My FPS drops with X-ray on. Rendering through large amounts of terrain is heavier; shorten your render distance or your visible-block list to ease the load.