Buried blocks are masked
Unrevealed protected ores are sent as believable host blocks. The client gets a normal cave wall, not a map of nearby ore veins.
Paper anti-xray plugin
Oreveil
Deterministic server-side ore obfuscation. Oreveil keeps buried ores authoritative on the server, masks what clients receive, and only reveals protected blocks when gameplay actually exposes them.
Client sees
stone, deepslate, netherrack, or end stone until exposure is legitimate.
Server knows
the real protected block, reveal state, and per-player visibility.
Per-playerVisibility can differ by player instead of leaking one shared ore view.
Exposure gatedMining, fluids, explosions, pistons, placement, movement, and chunk loading resync views.
Seed resilientOptional private salt reduces value from public seed-based prediction.
Versioned jarsPaper targets are split by Minecraft version band and Java runtime.
The ore model
Hidden until earned
Oreveil is not just a decorative disguise. It tracks which protected blocks should be visible, rewrites what the player receives, and keeps hidden ore data out of normal client view.
Exposed blocks come back
When gameplay exposes a protected block, Oreveil sends the real material back to players who should see it.
Admin control
Built for live servers
Configure protected ores, tune exposure rules, inspect block state, watch diagnostics, and let ProtocolLib handle the packet-aware path when the runtime supports it.
Chunk data
Compatible runtimes can rewrite chunk packet data before hidden ore reaches the player.
Updates
Block changes and reveal events are synchronized so exposed ores stay playable.
Fallback
If full chunk rewriting is unavailable, Oreveil keeps chunk priming and update sync active.
GUI
The `/oreveil` interface handles profiles, protected ore toggles, diagnostics, and world tools.
Release shape
Versioned Paper jars
Oreveil ships targeted builds by Minecraft version band, so legacy servers and modern servers each get the right API surface and bytecode level.
Supported targets
1.16.x / 1.17.xJava 16
1.18.x / 1.19.xJava 17+
1.20.0-1.20.4Java 17+
1.20.5-1.20.6 / 1.21.xJava 21+
26.xJava 25+
ProtocolLib is optional but recommended for packet-level transport.
| Feature | Paper Anti-Xray | Oreveil |
|---|---|---|
| Per-player obfuscation | Limited | Yes |
| Packet-level rewriting | Partial | Yes |
| Chunk packet rewriting | No | Yes* |
| Exposure-gated reveals | Limited | Yes |
| Server-authoritative ore model | No | Yes |
| Seed-resilient design | No | Yes |
| In-game admin GUI | No | Yes |
| Live diagnostics | No | Yes |
| Block inspection tool | No | Yes |
| World management | No | Yes |
*Oreveil uses automatic fallback when runtime chunk rewriting is unavailable.