Demonstration 1

Orebfuscator - Anti X-RAY:

For all releases of 1.9/1.9.1/1.9.2/1.9.4/1.10: Version 4.1.4

Now with support for CraftBukkit 1.9/1.9.1/1.9.2/1.9.4/1.10!

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





Please read compatibility information before downloading as not all releases work with all versions of CraftBukkit.

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.1.4.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!
  • Lishid, for years(!) of maintaining this plugin, and MarioG1 for recent patch support
  • raphfrk, helped with packet processing
  • Many donators!


  • See the issues page for any outstanding problems.


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


Version 4.1.4
  • Improving performance of ChunkReloader
Version 4.1.2
  • It is now possible to use Worlds list either as blacklist (i.e. all worlds are subject for obfuscation excluding listed) or as whitelist (i.e. only listed worlds are subject for obfuscation)
  • Fixed bug with using ProximityHider and Signs. It is now possible to add WALL_SIGN and SIGN_POST to ProximityHider obfuscation.
  • Updated wiki so commands and configuration pages are matching to the current Orebfuscator.
Version 4.1.1
  • Various Small fixes
  • Config file now supports block names additionally to IDs
Version 4.1.0
  • Support for CB 1.10 - thanks Asgarioth!
Version 4.0.14
  • Single jar supports all releases of 1.9.x now!
  • Some chunk reload issues are corrected (on teleport, etc.)
  • Add support for 1.9.4 - this release does not support prior versions.
Version 4.0.12
  • Fixed entity list reload issue
Version 4.0.11
  • Fixed failure to deobfuscate along chunk boundaries under specific conditions.
Version 4.0.10
  • Fixed crash for PaperSpigot servers
Version 4.0.9
  • Fixed crash when chunk section (16 x 16 x 16) has more than 127 different block types
  • Implemented different "transparent block" lists for Engine Mode 1 and Engine Mode 2. For now only difference is with lava block, for mode 1 it is non-transparent, for mode 2 it is transparent.
  • Implemented possibility to specify which blocks are transparent and not in the config file, sections: TransparentBlocks and NonTransparentBlocks.
  • Fix which may have solved java.util.ConcurrentModificationException
  • Fix for phantom blocks (visible after chunk reloaded) when player is digging straight line on the chunk border.
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 Re4ly Re4ly Oct 07, 2013 at 16:35 UTC - 0 likes

    Orebfuscator 1.9.7 for CB 1.6.2
    Changelog: Updated to CB 1.6.4 thihi

    Last edited Oct 07, 2013 by Re4ly


  • Avatar of lishid lishid Oct 07, 2013 at 02:24 UTC - 0 likes

    @iGamingStudioX: Go

    Chest being stone is a feature called ProximityHider, which hides chests from xray until players are close enough to see them. You can disable it in the config.

    What's your view-distance? Set it to less than 6. Also, leave compression at 1, having it higher will significantly take CPU.

    Finally, Orebfuscator should not affect TPS at all. If it does, then you're hosting too many players on a very slow machine.

    Show me your config file.

  • Avatar of iGamingStudioX iGamingStudioX Oct 06, 2013 at 14:15 UTC - 0 likes

    Alright, today I tried the plugin out. And what I get was lots of glitches and lags... Here is the list of glitches: Blocks of stone will suddenly turn into the blocks I set to be randomized. Chests turn into stone sometimes and only return to normal when hit. When blocks are broken, they will reappear. They take at least 2 times to really break it.

    And here's the biggest problem. After a while having this plugin installed, massive lag started to happen... The TPS dropped from 20 to 18 then 12. Command takes a few second to actually work and players get disconnected by end of stream errors massively... This became such a problem that I uninstalled a plugin... Can someone tell me a fix for the bugs and how to config it so it is the least laggy (Suppose I want every single CPU). At the same time hide all the diamond ores... Spawners... Chests... Mossy cobblestone and mineshafts.

  • Avatar of lishid lishid Oct 03, 2013 at 14:15 UTC - 0 likes

    @iGamingStudioX: Go

    Orebfuscator uses your other free cores on your server to process chunks, so it doesn't impact the game at all. If you're just concerned about wasting electricity then sure, but there are no reason to worry about orebfuscator taking CPU much as long as you don't change the config to some crazy values.

    The best way to minimize CPU is to reduce view-distance in your server.properties file. Reducing that value by one or two is usually more than enough in CPU usage reduction compared to completely disabling orebfuscator.

    @iGamingStudioX: Go

    Engine 2 is much safer. With engine 1 some smart hackers can still get around.

    @KleinesGumi: Go

    Check the updated versions?

  • Avatar of KleinesGumi KleinesGumi Oct 03, 2013 at 09:58 UTC - 0 likes

    pls update this plugin!!!

  • Avatar of iGamingStudioX iGamingStudioX Oct 03, 2013 at 09:24 UTC - 0 likes

    And also, is engine mode 1 or 2 better? I like the way engine mode 2 Orebfuscates everything but I am afraid it will use to much CPU time...

  • Avatar of iGamingStudioX iGamingStudioX Oct 03, 2013 at 09:18 UTC - 0 likes

    Can I know just which cobfiguration will decrease CPU usage... I only need a few features and I want as much free CPU as possible, not just 'not laggy'. And also, how much CPU will the plugin use compared to other plugins? Can you please give some examples and configuration that decrease CPU usage? Please.

  • Avatar of lishid lishid Oct 03, 2013 at 00:33 UTC - 0 likes

    @iGamingStudioX: Go

    Default configuration should be good enough for both. Just install the jar and it should start working after a restart.

  • Avatar of iGamingStudioX iGamingStudioX Oct 02, 2013 at 23:24 UTC - 0 likes

    Ok, but how to set the configuration so it Orebfuscates all the ores and uses least CPU?

  • Avatar of lishid lishid Oct 02, 2013 at 16:42 UTC - 0 likes

    @iGamingStudioX: Go

    Your server should have plenty enough to run orebfuscator on default settings. If it lags then you can trade-off some protection for performance, but I highly recommend default setting to start with.