针对透视(x-ray)和基于种子预测矿脉行为的服务器端矿石保护方案。
推荐配置:在 Paper 上安装 ProtocolLib,以便在支持的情况下启用 Oreveil 的数据包重写传输功能。ProtocolLib 在 Folia 上不使用。
什么是 Oreveil?
Oreveil 是一款面向 Paper 的服务器端矿石保护插件,并附带实验性的 Folia 支持。它有助于防御使用透视客户端、透明资源包、Baritone 辅助挖矿以及基于种子预测矿脉位置的行为。
Oreveil 不会向每个客户端发送隐藏的地下矿石的真实状态,而是将受保护的矿石状态保留为服务器权威,并在玩家通过正常游戏行为合法暴露这些矿石之前,将埋藏的矿石显示为自然的主岩方块。隐藏的矿石可能看起来像石头、深板岩、下界岩、凝灰石或其他根据维度及矿石类型配置的主岩方块。
可选的服务器私有加盐分布功能可以添加虚假的矿石信号,这些信号并非仅由公开的世界种子生成。对于 Paper 上的托管世界,Oreveil 还可以重新混合原版矿石放置算法,并使用私有生成密钥,使得再生成的矿石位置无法从公开种子中预测。
Oreveil 作为一个通用的 JAR 文件分发。Paper 支持从 Minecraft 1.16.x 到 1.21.x 以及 26.x 版本。Folia 支持处于实验阶段,适用于 PaperMC 发布的 Folia 版本。
为什么选择 Oreveil?
Oreveil 专为希望在不牺牲兼容性、可配置性或性能的前提下获得全面矿石保护的服务器所有者而设计。
- 旨在降低常见透视客户端和资源包透视的价值
- 减少基于公开种子的矿石预测能力
- 采用每位玩家独立的矿石展示方式,而非全局揭示状态
- 基于合法暴露的揭示规则
- 逼真自然的主岩方块替换效果
- 默认包含受保护的原始矿石方块
- 在兼容的 Paper 运行时上使用 ProtocolLib 数据包重写
- 当数据包重写不可用时,提供回退的分块预加载和方块更新同步机制
- 实验性 Folia 支持,具备区域感知调度功能
- 游戏内管理图形界面 (GUI)
- 实时诊断和方块检查工具
- 一个适用于所有受支持的 Paper 系列服务器的通用 JAR 包
工作原理
服务器端权威保护
Oreveil 在服务器上跟踪受保护的矿石,并决定每个玩家可以看到的内容。
- 基于暴露的揭示机制 - 只有当相邻暴露规则允许时(例如空气、流体、透明方块或配置的无遮挡邻居),矿石才会被揭示。
- 按玩家混淆 - 每个玩家可以接收独立的方块展示数据,因此一名玩家的矿石揭示不会自动向其他玩家泄露地下数据。
- 自然方块替换 - 隐藏的矿石会被替换为适合该维度的主岩方块,如石头、深板岩、下界岩、花岗岩或凝灰石。
- 私有种子保护 - 可选的加盐分布和 Paper 托管世界重混功能使用服务器私有密钥,使得公开种子的知识变得不那么有用。
智能数据包传输
Oreveil 会自动为您的服务器选择最佳的传输方式。
- 在兼容的 Paper + ProtocolLib 运行时上,Oreveil 会在客户端接收数据之前重写传出的分块和方块更新数据。
- 当无法进行完整的分块重写时,Oreveil 会对已加载的分块进行预加载,并发送同步的方块更新,以保持客户端视图的一致性。
- 在 Folia 上,即使安装了 ProtocolLib,也会禁用 ProtocolLib 数据包传输。Folia 使用区域感知调度和方块更新同步。
- Paper 26.x 使用与现代 1.21.x 构建相同的运行时兼容性探测,如果无法进行完整的分块重写,则会自动回退。
实时世界同步
Oreveil 持续响应游戏事件,包括:
- 挖矿
- 爆炸
- 流体
- 活塞
- 方块放置
- 传送
- 重生
- 玩家移动
- 分块加载
- 自然方块转换
管理工具
所有内容均可直接在遊戲內管理。
- 管理 GUI - 通过
/oreveil 命令配置 Oreveil。
- 受保护矿石管理 - 单独启用或禁用受保护的矿石。
- 暴露规则编辑器 - 定义哪些情况算作合法的暴露。
- 主岩映射 - 根据矿石或维度自定义替换方块。
- 诊断工具 - 监控传输状态、分块预加载、数据包重写计数器、合成方块发送量、故障和缓存统计信息。
- 方块检查器 - 查看 Oreveil 如何分类和展示任何目标方块。
- 托管世界 - 在 Paper 上,创建、再生、删除和配置由 Oreveil 管理的世界。
查看种子保护的实际效果
公开的世界种子可用于预测自然生成的矿石位置。
启用 Oreveil 的可选服务器私有加盐分布后,虚假的矿石信号会使这些预测显著变得不可靠,同时保持正常的挖矿体验。
| 已禁用种子保护 |
已启用种子保护 |
 |
 |
快速开始
环境要求
- 服务端: Paper,或实验性的 Folia
- ProtocolLib: 在 Paper 上推荐使用,可选;在 Folia 上不使用
- Java: 与你运行的服务端版本匹配
安装步骤
- 下载通用的 Oreveil JAR 文件。
- 将其放入服务端的
plugins 文件夹中。
- 对于 Paper 服务端,可选安装兼容版本的 ProtocolLib。
- 重启服务端。
- 以操作员身份或使用拥有
oreveil.admin 权限的玩家运行 /oreveil 命令。
- 使用
/oreveil diagnostics 和 /oreveil inspect 验证传输与揭示行为。
支持的服务端软件
| 软件 |
状态 |
备注 |
| Paper |
支持 |
Minecraft 1.16.x 至 1.21.x 及 26.x |
| Folia |
实验性 |
使用区域感知调度与回退区块更新同步 |
Java 要求
| Minecraft |
Java |
| 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 使用与 Java 16 兼容的字节码编译。Java 版本要求取决于对应的服务端版本。
旨在帮助防范
- 常见的 X 射线客户端
- 透明的 X 射线资源包
- 基于 Baritone 辅助的寻矿行为
- 基于公开种子(seed)的矿石预测
- 基于数据包的泄露行为
当前 Folia 的限制
- Folia 支持处于实验阶段。
- Folia 不使用 ProtocolLib 数据包传输。
- 在当前兼容性适配中,Folia 上的受管世界矿石重混功能已禁用。
- Folia 依赖区块预热和方块更新同步,而非数据包层面的初始区块清理。
命令
主要命令
/oreveil
/oreveil status
/oreveil inspect
/oreveil diagnostics
/oreveil reload
/oreveil reset confirm
使用 /oreveil help 或 /oreveil help <topic> 获取完整的命令参考。
示例
/oreveil set live_sync_radius 96
/oreveil toggle reveal_on_exposure
/oreveil ore add DIAMOND_ORE
/oreveil ore toggle ANCIENT_DEBRIS
/oreveil exposure adjacent add WATER
/oreveil host default NORMAL STONE
/oreveil host override ANCIENT_DEBRIS NETHERRACK
/oreveil world status
Server-authoritative ore protection for x-ray and seed-aware mining.
Recommended: Install ProtocolLib on Paper to enable Oreveil's packet-rewriting transport where supported. ProtocolLib is not used on Folia.
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?
Oreveil is built for server owners who want comprehensive ore protection without sacrificing compatibility, configurability, or performance.
- 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.
- Private-Seed Protection - Optional salted distribution and Paper managed-world remixing use server-private secrets so public seed knowledge is less useful.
Smart Packet Transport
Oreveil automatically selects the best transport available for your server.
- On compatible Paper + ProtocolLib runtimes, Oreveil rewrites outgoing chunk and block update data before the client receives it.
- When full chunk rewriting is unavailable, Oreveil primes loaded chunks and sends synchronized block updates to keep the client view aligned.
- On Folia, ProtocolLib packet transport is disabled even if ProtocolLib is installed. Folia uses region-aware scheduling and block update sync.
- Paper 26.x uses the same runtime compatibility probe as modern 1.21.x builds and falls back automatically if full chunk rewriting is unavailable.
Live World Synchronization
Oreveil continuously reacts to gameplay events, including:
- Mining
- Explosions
- Fluids
- Pistons
- Block placement
- Teleportation
- Respawning
- Player movement
- Chunk loading
- Natural block transformations
Administration Tools
Everything can be managed directly in-game.
- Administration GUI - Configure Oreveil through
/oreveil.
- Protected Ore Management - Enable or disable protected ores individually.
- Exposure Rule Editor - Define what counts as legitimate exposure.
- Host Block Mapping - Customize replacement blocks by ore or dimension.
- Diagnostics - Monitor transport status, chunk priming, packet rewrite counters, synthetic block sends, failures, and cache statistics.
- Block Inspector - See exactly how Oreveil classifies and presents any targeted block.
- Managed Worlds - On Paper, create, regenerate, delete, and configure Oreveil-managed worlds.
See Seed Protection in Action
Public world seeds can be used to predict naturally generated ore locations.
With Oreveil's optional server-private salted distribution enabled, fake ore signals make those predictions significantly less reliable while preserving normal mining.
| Seed Protection Disabled |
Seed Protection Enabled |
 |
 |
Quick Start
Requirements
- Server: Paper, or experimental Folia
- ProtocolLib: Recommended for Paper, optional, and not used on Folia
- Java: Matches the server version you're running
Installation
- Download the universal Oreveil JAR.
- Place it inside your server's
plugins folder.
- For Paper servers, optionally install a compatible version of ProtocolLib.
- Restart your server.
- Run
/oreveil as an operator or a player with oreveil.admin.
- Use
/oreveil diagnostics and /oreveil inspect to verify transport and reveal behavior.
Supported Server Software
| Software |
Status |
Notes |
| Paper |
Supported |
Minecraft 1.16.x through 1.21.x and 26.x |
| Folia |
Experimental |
Uses region-aware scheduling and fallback block update sync |
Java Requirements
| Minecraft |
Java |
| 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 is compiled with Java 16-compatible bytecode. The Java requirement comes from the corresponding server version.
Designed to Help Protect Against
- Common x-ray clients
- Transparent x-ray resource packs
- Baritone-assisted ore hunting
- Public seed-based ore prediction
- Packet-based reveal leaks
Current Folia Limitations
- Folia support is experimental.
- Folia does not use ProtocolLib packet transport.
- Managed-world ore remixing is disabled on Folia in the current compatibility pass.
- Folia relies on chunk priming and block update sync, not packet-level initial chunk sanitization.
Commands
Main Commands
/oreveil
/oreveil status
/oreveil inspect
/oreveil diagnostics
/oreveil reload
/oreveil reset confirm
Use /oreveil help or /oreveil help <topic> for the complete command reference.
Examples
/oreveil set live_sync_radius 96
/oreveil toggle reveal_on_exposure
/oreveil ore add DIAMOND_ORE
/oreveil ore toggle ANCIENT_DEBRIS
/oreveil exposure adjacent add WATER
/oreveil host default NORMAL STONE
/oreveil host override ANCIENT_DEBRIS NETHERRACK
/oreveil world status
评论 0
登录后参与评分
还没有评论,来抢沙发吧