Oreveil

插件

· 作者 ryduzz

一个服务端矿石混淆插件,用于防止 X 光和基于种子的漏洞利用

0 本站下载 0 关注 更新于 4 个月前

最新 0.1.3 · 26.2 · Folia / Paper

一键开服(送7天)

Oreveil

针对透视(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: 与你运行的服务端版本匹配

安装步骤

  1. 下载通用的 Oreveil JAR 文件。
  2. 将其放入服务端的 plugins 文件夹中。
  3. 对于 Paper 服务端,可选安装兼容版本的 ProtocolLib。
  4. 重启服务端。
  5. 以操作员身份或使用拥有 oreveil.admin 权限的玩家运行 /oreveil 命令。
  6. 使用 /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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源