Orebfuscator empowers server owners to protect their server from X-Ray Clients and Texture Packs, all while offering a high degree of configurability. This is achieved through modifying network packets without altering your game world, guaranteeing a secure and reliable experience for users. With Orebfuscator, you can tailor the settings to suit your server's needs, ensuring precise control over the visibility of specific blocks. This means that not only does Orebfuscator safeguard your world's integrity, but it also empowers you to fine-tune your Anti-X-Ray measures for the best gameplay experience.
- Seamless Integration: Plug & Play functionality for effortless use.
- Extensive Configuration: Highly customizable settings to tailor the experience to your liking.
- Server Compatibility: Designed for Spigot-based servers 1.16 and newer.
- Block Obfuscation: Conceal non-visible blocks from players' view.
- Block-Entity Support: Hide block entities such as Chests and Furnaces.
- Dynamic Block Visibility: Adjust block visibility based on player proximity and distance.
- Java 17 or higher
- Spigot, Paper, Folia or compatible forks (1.16.5 or newer)
- ProtocolLib 5.4.0 or later
- Download ProtocolLib
- Download Orebfuscator
- Place both plugins in your plugins directory
- Start your server and configure Orebfuscator to your liking
Still having trouble getting Orebfuscator to run check out our common issues.
Orebfuscator follows a rolling support window for Minecraft versions.
Starting with Minecraft 27.x, Orebfuscator will officially support only the two most recent major Minecraft releases.
Example:
| Latest Minecraft Version | Supported Versions |
|---|---|
| 27.x | 27.x and 26.x |
| 28.x | 28.x and 27.x |
When a new major Minecraft version is released, the oldest supported version will be dropped in a future Orebfuscator release.
Older versions may still work but are not guaranteed to receive fixes or compatibility updates.
Testing policy differs depending on the Minecraft release cycle.
Until Minecraft 27.x
Each Orebfuscator release is tested against all supported Minecraft versions on PaperMC and Spigot with the following exceptions:
- 1.17.x
- 1.18.x
- 1.19.x
The following versions are still included in testing:
- 1.16.5
- 1.20.x and newer supported releases
After Minecraft 27.x
Testing will focus on the latest Minecraft major version only for each Orebfuscator release.
Other versions within the support window may remain compatible but will not necessarily be tested for every release.
Servers running untested versions may still function, but issues specific to those versions may not be prioritized.
For compatibility with Java 11 or Minecraft 1.9.4 and later, you can use any legacy release prior to version 5.5.0. Please note that these legacy releases will no longer receive regular support or updates. However, they may receive critical security and vulnerability patches if necessary.
To include the API in your Maven project, add the following configuration to your pom.xml:
<repositories>
<repository>
<id>codemc-repo</id>
<url>https://repo.codemc.io/repository/maven-public/</url>
</repository>
<!-- Additional repositories can be added here if needed -->
</repositories>
<dependencies>
<dependency>
<groupId>net.imprex</groupId>
<artifactId>orebfuscator-api</artifactId>
<version>5.2.4</version>
</dependency>
<!-- Add other dependencies as required -->
</dependencies>Copyright (C) 2020–2026 Imprex-Development
Completely rewritten to support Minecraft v1.14 and higher.
Copyright (C) 2016 Aleksey_Terzi
Significant rework to support Minecraft v1.9.
These modifications are distributed under the same license as the original work.
Copyright (C) 2011–2015 lishid
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/.
See the LICENSE file for the full license text.