Oreveil

What Is Oreveil?

Oreveil is a server-side ore protection plugin for Paper, with experimental Folia support, that helps defend against x-ray clients, transparent resource packs, Baritone-assisted mining, and seed-based ore prediction.

Instead of sending every client the true state of hidden underground ores, Oreveil keeps protected ore state server-authoritative and presents buried ores as natural host blocks until they are legitimately exposed through gameplay. Hidden ore can look like stone, deepslate, netherrack, tuff, or other configured host blocks depending on the dimension and ore type.

Optional server-private salted distribution can add fake ore signals that are not derived from the public world seed alone. For managed worlds on Paper, Oreveil can also remix vanilla ore placement with a private generation secret so regenerated ore locations are not predictable from the public seed.

Oreveil is distributed as one universal JAR. Paper is supported from Minecraft 1.16.x through 1.21.x and 26.x. Folia support is experimental and available for Folia versions published by PaperMC.

Why Oreveil?

• Designed to reduce value from common x-ray clients and resource-pack x-ray
• Reduces public seed-based ore prediction
• Per-player ore presentation instead of global reveal state
• Legitimate exposure-based reveal rules
• Believable natural host-block replacement
• Protected raw ore blocks included by default
• ProtocolLib packet rewriting on compatible Paper runtimes
• Fallback chunk priming and block update sync when packet rewriting is unavailable
• Experimental Folia support with region-aware scheduling
• In-game administration GUI
• Live diagnostics and block inspection tools
• One universal JAR for supported Paper-family servers

How It Works

• Server-Authoritative Protection - Oreveil tracks protected ores on the server and decides what each player is allowed to see.
• Exposure-Gated Reveals - Ores reveal only when adjacent exposure rules say they should, such as air, fluids, transparent blocks, or configured non-occluding neighbors.
• Per-Player Obfuscation - Every player can receive an independent block presentation, so one player's reveal does not automatically leak underground data to everyone else.
• Natural Block Replacement - Hidden ores are replaced with dimension-appropriate host blocks such as stone, deepslate, netherrack, granite, or tuff.
• Packet-Aware Transport - On compatible Paper + ProtocolLib runtimes, Oreveil rewrites outgoing chunk and block update data before the client receives it.
• Compatibility Fallback - When full chunk rewriting is unavailable, Oreveil primes loaded chunks and sends synchronized block updates to keep the client view aligned.
• Private-Seed Protection - Optional salted distribution and Paper managed-world remixing use server-private secrets so public seed knowledge is less useful.
• Live World Sync - Mining, explosions, fluids, pistons, block placement, chunk loading, teleporting, movement, and respawns trigger targeted client corrections.
• Diagnostics - The admin GUI and commands expose transport status, chunk priming, packet rewrite counters, synthetic block sends, and cache sizes.

Quick Start

1. Download the universal Oreveil JAR.
2. Place it inside your plugins folder.
3. For Paper servers, optionally install a compatible version of ProtocolLib.
4. Restart your server.
5. Run /oreveil as an operator or a player with oreveil.admin.
6. Use /oreveil diagnostics and /oreveil inspect to verify transport and reveal behavior.

Supported Server Software

• Paper - Supported for Minecraft 1.16.x through 1.21.x and 26.x.
• Folia - Experimental support. Uses region-aware scheduling and fallback block update sync.

Java Requirements

• 1.16.x - Java 16
• 1.17.x - Java 16
• 1.18.x - Java 17+
• 1.19.x - Java 17+
• 1.20.0-1.20.4 - Java 17+
• 1.20.5-1.21.x - Java 21+
• 26.x - Java 25+

Oreveil itself is compiled for Java 16 compatibility. The Java requirements above come from the corresponding server versions.