Demonstration 1

Orebfuscator - Anti X-RAY:

Version: 4.0.7-beta

Now with support for CraftBukkit 1.9.x!

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





Latest version should be on BukkitDev, or as a release on the Github page: https://github.com/lishid/Orebfuscator/releases

Please also download ProtocolLib and install it in the plugins folder.


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



  • Copy "orebfuscator-v4.0.7-SNAPSHOT.jar" to your plugins folder
  • If you're upgrading from Orebfuscator.jar, move the contents of the "Orebfuscator3" folder to the "Orebfuscator4" folder
  • Restart your server.


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


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


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

Source Code

Here you go! (Hosted on Github) - please post issues and requests for help there


  • This plugin utilizes 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.


  • Aleksey_Terzi, single-handedly updating to CraftBukkit 1.9!
  • DevotedMC for taking over management of the project
  • AFFORESS, major help on code optimization and spout support!
  • raphfrk, helped with packet processing
  • Many donators!


  • Release 4.0.3-alpha has some known issues, please update to 4.0.7-beta ASAP as those issues are addressed.


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


Version 4.0.7-beta
  • Corrected transparent block list. For example, lava blocks marked as transparent and therefore adjacent blocks are not obfuscating anymore
  • Improved performance of ProximityHider function
Version 4.0.5-alpha
  • Fixes teleport / join in the End causing client-side crashes.
  • Fixes failure to deobfuscate immediately on join.
Version 4.0.3-alpha
  • Updated to MC1.9.

Full release notes: In Github Release

Version 3.0.5
  • Updated to MC1.8.3.

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




CPU testing with Initial radius and Caching: (for legacy versions)


A quick donation is always appreciated :D

Devoted Patreon or General Inquiry



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

  • Avatar of alekseymc alekseymc Apr 29, 2016 at 15:58 UTC - 0 likes

    @dadee971: Go


    Thank you for crash reports.

    I will try to find the reason of the problem and fix it.

  • Avatar of dadee971 dadee971 Apr 28, 2016 at 18:53 UTC - 0 likes

    Hi again.

    Here are the 2 crashs reports:



    Today i have disable Orebfuscatore for testing, and no crashs.

    Best regards.

  • Avatar of alekseymc alekseymc Apr 26, 2016 at 18:26 UTC - 0 likes

    @dadee971: Go

    Could you please provide additional info as DevotedMC asked below?

    Last edited Apr 26, 2016 by alekseymc
  • Avatar of dadee971 dadee971 Apr 26, 2016 at 17:39 UTC - 0 likes

    @alekseymc: Go

    All right, done. My server crash again today once.

  • Avatar of HarryoGaming HarryoGaming Apr 26, 2016 at 16:52 UTC - 0 likes

    @jordanwilliams21: Go

    Plz update for 1.9.2

  • Avatar of alekseymc alekseymc Apr 26, 2016 at 16:49 UTC - 0 likes

    @dadee971: Go

    May be i should update to ProtocolLib v4.0.0-SNAPSHOT-b273 ?

    For 1.9 server - they are recommending to use latest version of protocollib: https://www.spigotmc.org/resources/protocollib.1997/

    So yes - I propose to try ProtocolLib 4.0

  • Avatar of alekseymc alekseymc Apr 26, 2016 at 16:35 UTC - 0 likes

    @MinePuppeh: Go

    I don't recommend to add a lot of blocks to ProximityHider by 2 reasons:

    1) A lot of blocks will do additional load to CPU. So if you will decide to add all ore types - draw attention that this possibly could lead to lags.

    2) Until player is enough close to ProximityHider obfuscated object - he/she will see this block as obfuscated, for decorative blocks this critical since people will not see beauty of building. So I do not recommend to add decorative blocks.

    How would darknesshider work for caves, it only hides blocks if they're dark, not hides the fact that the cave exists.

    You can remove blocks from ObfuscateBlocks list and add them to DarknessBlocks - then such blocks will be obfuscated as air - this will hide caves. But as I've described previously this could lead to visual problems.

    UseSpecialBlockForProximityHider: true

    You can look details about proximity hider config here: https://github.com/lishid/Orebfuscator/wiki/ProximityHider

  • Avatar of JanJed JanJed Apr 26, 2016 at 13:14 UTC - 0 likes


    i have installed Orbfusctor 4 days ago, it working perfect! But yesterday it crash every 5 minutes my Server :S Can you fix that ? I have send you the Errorlog + crash report in a conversation!

  • Avatar of DevotedMC DevotedMC Apr 26, 2016 at 12:52 UTC - 0 likes

    @dadee971: Go

    Hey dadee971: Can you please provide a link to a pastebin of the _full_ stack trace? Typically in a hard-crash, every plugin will be listed as all the stacks of all the threads will be dumped. The line you pasted is just Orebfuscator in its "passive" or "sleep" mode - literally, not doing anything. So ... that line does not help us help you :).

    Did you install or update anything else around the same time as Orebfuscator? Do you notice any other "stack traces" before the big crash? Thanks. Feel free to open a ticket here or on the repo if you'd prefer less "public" help.

    Last edited Apr 26, 2016 by DevotedMC
  • Avatar of dadee971 dadee971 Apr 26, 2016 at 07:34 UTC - 0 likes


    - CraftBukkit version git-Spigot-f972b36-b103841 (MC: 1.9.2) (Implementing API version 1.9.2-R0.1-SNAPSHOT) - Orebfuscator4 v4.0.5-SNAPSHOT - ProtocolLib v3.7.0-SNAPSHOT-b258

    I have installed Orebfusctor 2 days ago. Since i have installed it, my server starts crashing 1 ou 2 time per day.

    In the crash report i have notice this:

    TIMED_WAITING Orebfuscator ProximityHider Thread: [java.lang.Thread.sleep(Native Method), com.lishid.orebfuscator.obfuscation.ProximityHider.run(ProximityHider.java:70)]

    Can it be a issue with Orebfuscator? Because i have launched my server 2 month ago, and it had never crash before i have install this plugin.

    May be i should update to ProtocolLib v4.0.0-SNAPSHOT-b273 ?

    Best regards.

    Last edited Apr 26, 2016 by dadee971: okthen


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