Minecraft X-Ray

Minecraft X-Ray is a utility whose primary purpose is to aid in finding valuable ores and resources inside a Minecraft world. It's also very useful for simply exploring your Minecraft world, or finding your way out of a deep cave system. It is distributed under the New/Modified BSD License. X-Ray is not a mod - it is a separate program run outside of Minecraft itself.

In general, X-Ray is only useable on singleplayer worlds, but if you have access to the data files from a multiplayer server, X-Ray will load those from your harddrive without problems as well.

The original X-Ray versions were written by plusminus, but has been maintained here since v2.7. Many thanks to him for providing both the application and the sourcecode, so that it could live on.

Minecraft X-Ray is unrelated to the clientside mod also named XRay (now part of the CJB mod set), or to the X-Ray Texture Packs.


Note: This hasn't been updated since early 2012, and as such probably doesn't work with current versions of Minecraft. The source is all available on github, etc, so if anyone feels like taking over maintaining X-Ray, feel free to fork and send in pull requests, etc. I suspect that this has probably been supplanted by other tools by now, though. Anyway...


Current Version

3.6.2 (released March 11, 2012)

Previous Versions


As mentioned above, Minecraft X-Ray is a utility whose primary purpose is to aid in finding valuable ores and resources inside a Minecraft world. By default, when you select a resource type to highlight, X-Ray will cause any blocks of that type to visibly glow within the range of loaded chunks. The glowing can be toggled between two different styles, or turned off entirely. Turning the glowing off will still leave all instances of the selected mineral visible on the screen, which can be quite useful for more plentiful minerals like iron. X-Ray can also be configured in the GUI to highlight any block from Minecraft, not just ores.

Additionally, X-Ray is somewhat useful for taking a look at natural underground caves, to find out how extensive they are, or even to help find your way out if you're lost.

Minecraft X-Ray operates by loading your world from the hard drive. This means that for most people, X-Ray will not be useful for finding ores on multiplayer worlds, which are typically stored on a server the user won't have access to. If you do have the server data files, though, X-Ray will load it just fine, and even let you cycle through camera presets of every player on the server.

The Changelog lists all the changes that have taken place since X-Ray 2.7. Some general features, though:

See the README for more information, and the TODO file for a list of known bugs and features that I'd like to implement eventually.


Feel free to mail me at pez@apocalyptech.com with questions, though your questions may possibly do better in the X-Ray forum topic:


If you've got bugs to report, the best place would probably be Sourceforge's bug tracker.

Many thanks to plusminus for creating the utility, and double THAT amount of thanks for releasing the sourcecode as well.

Minecraft X-Ray is released under the New/Modified BSD License.

Shameless Advertising

Support This Project

Have too much money? I could help you with that, if you want!