Demonstration 1

Orebfuscator - Anti X-RAY:


This plugin is used to counter X-RAY Client mods.

It modifies data that are sent to clients to hide blocks of your choice, such as Ore, chests, dungeons, etc.

It does not manipulate blocks in the world file, thus is safe to use.

ProximityHider is a feature that hides chests that are far from players.


Configuration Guide





Dropbox link removed due to Bukkit regulations. Latest version should be on BukkitDev, if not, then the dropbox link is still in the forum thread.

Please also download ProtocolLib and install it in the plugins folder. Download link: http://dev.bukkit.org/server-mods/protocollib/


  • Advanced algorithm that hides ore, chest and and anything you specify in the configuration
  • Spout compatible, but optional
  • No modifications to CraftBukkit.jar is needed
  • Customize the blocks you want to hide
  • HIDES DUNGEONS and other blocks that are in the dark
  • Different hiding mode, or scrambling.
  • Extensive configuration. Change updating methods depending on your bandwidth and processing speed.
  • Hide hidden chests and furnaces until a player is close to it.


Install: Copy "Orebfuscator.jar" to your plugins folder, and restart/reload your server.


See this: https://github.com/lishd/Orebfuscator/wiki


See this: https://github.com/lishd/Orebfuscator/wiki


See this: https://github.com/lishd/Orebfuscator/wiki

Source Code

Here you go! (Hosted on Github)


  • This plugin utilises Hidendra's plugin metrics system, which means that anonymous information of your OS and setup will be collected and sent to mcstats.org
  • Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.


  • This plugin uses an Auto-updater to fetch the latest version from BukkitDev automatically. It can be disabled in the configuration file.


  • AFFORESS, major help on code optimization and spout support!
  • raphfrk, helped with packet processing
  • Many donators!


  • None ATM


  • A command that generates the world cache for the existing chunks.


Version 2.1.3
  • Updated to MC1.7.8
Version 2.1.2
  • Fixed cast exception.
Version 2.1.1
  • Update to MC1.7.5.

Full history: https:github.com/lishd/Orebfuscator/wiki/Version-History




CPU testing with Initial radius and Caching:


A quick donation is always appreciated :D




You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of lishid lishid Apr 18, 2014 at 06:55 UTC - 0 likes

    @Bobcat00: Go

    There's no protection against rails :/

    Unless if someone has a clever way of hiding them, your best chance is to use something like ProximityHider, but that might slow the server down quite a lot.

  • Avatar of Bobcat00 Bobcat00 Apr 17, 2014 at 23:02 UTC - 0 likes

    I discovered a player had dug straight down into a mineshaft and picked up all the rails. Whenever someone digs straight down, I get suspicious. And this player likes to build railroads. Plus he dug down in the middle of a river, which is a strange place to randomly dig.

    So, is there any way he could have bypassed Orebfusicator to see where to dig? Maybe a texture pack that only shows rails?

    <<size 0px>>BFAK:90822802,6b4abae79b787c1912d57328d2ee06a4477abe07c121d09ab07a5e797ef765be<</size>>

  • Avatar of lishid lishid Apr 17, 2014 at 07:41 UTC - 0 likes

    @Willcomputerguy79: Go

    Thank you for confirming that. I don't like other people's clients enough to download them, ended up making my own client to hack around and even to test out Orebfuscator.

  • Avatar of Willcomputerguy79 Willcomputerguy79 Apr 17, 2014 at 06:49 UTC - 1 like

    @cavemantoaster: Go

    I just downloaded Orebfuscator on my server to test it out because I've had xrayer issues recently. I, in fact, use Resilience on my server. I use the xray the client has to find real xrayers. I de-opped myself, removed all my permissions of admin, and then put myself in default group. After I installed Orebfuscator all stone and ores were random ores scattered around. So, yes, you're obviously here to troll. I use Resilience as well, and it doesn't bypass Orebfuscator. Just felt like putting my two cents in.

    Last edited Apr 17, 2014 by Willcomputerguy79
  • Avatar of lishid lishid Apr 14, 2014 at 21:11 UTC - 0 likes

    @cavemantoaster: Go

    Some people come here to try to advertise clients that they like, and they usually start with "Client XXX bypasses Orebfuscator" when they come here.

    And I'll make two points:

    1. If A certain client bypasses Orebfuscator, the author of the client would put up a giant text in his feature list saying "This client bypass Orebfuscator". I did not see anything like that for the client you mentioned.

    2. By theory Orebfuscator will prevent any "Xray" on clients. This is because the way Orebfuscator works, not because Orebfuscator tries to block anything client side, but it prevents the server from telling the client real values of blocks that the client can't see. By doing this, clients don't even know what blocks are real, so no client can hack over Orebfuscator, UNLESS if there is a vulnerability in CraftBukkit.

    So to end off, show me a picture or video or something.

  • Avatar of cavemantoaster cavemantoaster Apr 14, 2014 at 19:27 UTC - 0 likes

    @lishid: Go

    Why would I be trolling? And someone did confirm what I'm saying 5 pages back. I'm telling you so something could be done about it. I have no reason to troll. Plus everyone always just defaults to nodus as the go to hacked client. Resilience is relatively newer.

    Edit: here is the post. MShurson Feb 27, 2014 at 09:50 - 0 likes Like Quick thing, im pretty sure you made it to counter texture packs only, because Resilience hacks with X-ray does not get blocked if u would look at the coding for resilience and make an update that would be helpful, as most people will switch to that.

    Last edited Apr 14, 2014 by cavemantoaster
  • Avatar of lishid lishid Apr 14, 2014 at 19:16 UTC - 0 likes

    @jjor03: Go

    Well, as long as the world doesn't get corrupt by operations on the server (restart and stuff), orebfuscator should have no way to modify chunks and block data.

    Lag wise, I believe you are talking about client side lag? If graphical/FPS lag is what you're talking about, you can turn off AntiFreecamAndTexturepack which does exactly what it says, but puts a bigger impact on client FPS.

    @TheBoomer: Go

    Usually I recommend 6-8 as view distance, which is the best balance. And everything you said seems correct.

  • Avatar of TheBoomer TheBoomer Apr 14, 2014 at 17:44 UTC - 0 likes

    If your chunks are being generated for the first time, orebfuscator does contribute that much more work at one moment, pregenerated chunks -> less lag overall for that reason alone, orebfuscator or not.

    In my exhaustive experience, I find the majority of users crying about lag tend to ... not cry about it as much, once I show them that the java version they hve installed (windows users) is almost never correct. "But I just updated it a minute ago" ... means nothing, as most systems are now 64 bit, and being updated via a weblink, on a 32 bit webbrowser, that says 'ah, a 32 bit webbrowser, lets update the 32 bit java..." The majority of my users, upon installing 64 bit java on their 64 bit systems, or uninstalling an old java version that got stuck and didn't cleanly remove from an update before, tend to see both errors and general lag drop significantly. If it aint the server, its the client... I change nothing to the server, a hundred users get their java fixed, and a few mins later... all troubles gone. There are folks out there havne't updated java or touched it since minecraft was in v 1.0 release, the newer clients are very impacted by old javas.

    On the server, reducing the view radius from 10 to 9 chops out a fair bit of work for orebfuscator if there is server wide server lag though most folks try to run servers (commercialy hosted, cheap packages) that really cant support much, and a view radius of 6 tends to take loads of cpu and memory resource hogging out of the system.

    But basically, serverside: pregenerated chunks, big plus, reasonable view-radius helps; client side, almost all the time, java aint right, and for some reason, orebfuscator tends to really bring out the client hurting compared to non-orebfuscated servers, so naturally "its your server that lags, i've been on lots of them" (and I get dropped randomly, lots of errors, crashes a lot when its not server fault either...)"

    Been using Orebfuscator 2.5 years now, and have seen this client-side lag issue always there - like 170 times out of 180 disappear when java fixed... and the player gets a bonus of not randomly crashing as much.

    But Its education... its something we often cant have control over, except shout back into the wind "its your end, like 99% sure of it!" fruitlessly.

  • Avatar of jjor03 jjor03 Apr 14, 2014 at 09:42 UTC - 0 likes

    @lishid: Go

    Thank You for the ProximityHider help. That was getting kind of annoying. And I'm not the only one complaining about the lag, and the second I took the plugin off, it stopped lagging. Everyone that joins says they got hardcore lag after I installed this plugin. I'm just saying, it does put a damper on the server. Also, it was just a little suspicious that he was standing in the exact spot we started getting chunk errors the day after I download and installed this. And he was the only person suspected with xray hacks. I'm not saying it is the reason for the chunks being crazy, but I'm just saying keep an eye out for it. Thanks for the quick reply. I love this plugin, I just don't want my map to corrupt IF this is the plugin doing it. I'll test it more on my hub and let you know.


  • Avatar of lishid lishid Apr 14, 2014 at 04:16 UTC - 1 like

    @cavemantoaster: Go

    I'm going to assume you're trolling until somebody else comes up with the same conclusion. Unless there's an exploit in CraftBukkit, Orebfuscator is hack-proof.

    @jjor03: Go

    Unless if your server is running on a 8 year old CPU, this plugin shouldn't lag the game.

    Also, Orebfuscator does NOT touch any game objects or data, which means nothing in the world should be changed by the plugin. So if there's holes, it's not from this.

    And to finish off, chests and furnaces are turned to stone as a protection against chest finders. Turn it off if you want using the option "ProximityHider" in the config.


Date created
Sep 24, 2011
Last update
Apr 13, 2014
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files