What Orebfuscator works with.
| Platform | Java Edition |
|---|---|
| Loaders | Bukkit, Folia, Paper, Purpur, Spigot |
| Minecraft versions | 1.16.5, 1.18.2, 1.19.4, 1.20.6, 1.21.1, 1.21.11, 26.1, 26.2 |
Orebfuscator is an anti-x-ray plugin for Minecraft Java servers running Bukkit, Folia, Paper, Purpur, or Spigot. An x-ray texture pack or x-ray cheat client works by making stone and other blocks transparent so a player can see ore through solid rock. Orebfuscator stops this by editing the block data sent to each client, so hidden ore is never in the packet a cheat client could reveal, without touching the actual world save.
How Orebfuscator hides ore blocks
Instead of scanning for cheat software, Orebfuscator changes what a normal client is ever told about nearby blocks. Every chunk section sent to a player has non-visible ore, and any other blocks the server owner configures, swapped for stone or another filler block before it leaves the server. The real block is swapped back only once a player actually breaks into that space, so mining still works normally.
- Block obfuscation: hides configured blocks, ores by default, that are not visible to the player
- Block-entity support: also hides chests, furnaces, and other block entities from x-ray view
- Dynamic visibility: adjusts what is hidden based on player proximity and render distance
- Per-world configuration: which blocks are obfuscated is fully configurable
Installing Orebfuscator on Paper, Spigot, and Folia
- 1.Install ProtocolLib 5.4.0 or later, the packet library Orebfuscator depends on.
- 2.Download the Orebfuscator jar from Modrinth or GitHub.
- 3.Place both jars in the server's plugins folder.
- 4.Restart the server, then edit Orebfuscator's config to choose which blocks it hides.
Supported Minecraft versions and server software
The current 5.6.1 release covers every server software build for Bukkit, Folia, Paper, Purpur, and Spigot from 1.16.5 through 26.2. Orebfuscator follows a rolling support window: once Minecraft 27.x ships, only the two most recent major versions stay officially supported going forward. Versions from 1.9.4 up to 1.16.4 only work with a legacy pre-5.5.0 build that Imprex-Development no longer updates, so an older server does not get current fixes.
Where Orebfuscator fits with other server plugins
Orebfuscator only controls what a client can see. It does not detect cheat software or ban players, so pairing it with an anti-cheat plugin such as Grim Anticheat covers detection while Orebfuscator removes the ore data an x-ray tool would otherwise reveal. Land-protection and audit plugins address different problems entirely and run alongside it without conflict.
Setting up anti x-ray on a server with Orebfuscator
Questions about Orebfuscator.
5 questions
What does Orebfuscator do?
Orebfuscator hides ore blocks and other configured blocks from a player's client so x-ray texture packs and x-ray cheat clients have nothing to reveal. It edits the block data in outgoing chunk packets instead of scanning players for cheat software, so it protects the world regardless of which x-ray tool a player uses.
Does Orebfuscator need any other plugins?
Yes. Orebfuscator requires ProtocolLib 5.4.0 or later to read and rewrite the packets it hides ore in. Install ProtocolLib in the same plugins folder before starting the server, or Orebfuscator will fail to load.
Which Minecraft versions does Orebfuscator support?
The current release covers Bukkit, Folia, Paper, Purpur, and Spigot from 1.16.5 through 26.2. Versions from 1.9.4 up to 1.16.4 only work with a legacy pre-5.5.0 build that Imprex-Development no longer updates or patches.
Does Orebfuscator work on Folia?
Yes. Folia is one of the five server software targets Orebfuscator officially builds for, alongside Bukkit, Paper, Purpur, and Spigot.
Is Orebfuscator safe to run on a live server?
Orebfuscator is open source under the GPL-3.0 license and distributed through Modrinth and GitHub. It only changes the block data sent to clients and never edits the world save, so removing it later leaves the world unchanged.
