Orebfuscator 防矿物透视插件

Orebfuscator 防透视插件

> 在数据包层面把玩家看不到的矿石伪装掉，让透视客户端和透视材质包全部失效；只改发包内容，不动存档，是目前最主流的服务端反矿透方案之一。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | Orebfuscator |
| 开发者 | Imprex Development |
| 最新版本 | 5.6.2（2026-09-19）|
| 许可协议 | GPL-3.0-only |
| 兼容版本 | Minecraft Java 1.16.5 – 26.3（最新构建；1.9.4 起需用 5.5.0 之前的旧版，已停止维护）|
| 运行平台 | Spigot、Paper、Purpur、Folia 及其分支 |
| 运行环境 | Java 17 或以上 |
| 前置依赖 | ProtocolLib 5.2.0 或以上（必需）|
| 项目地址 | https://modrinth.com/plugin/orebfuscator |
| 官方 Wiki | https://github.com/Imprex-Development/orebfuscator/wiki |
简介

Orebfuscator 解决的是服务端最头疼的问题之一：透视。它的做法不是在服务端做检测或惩罚，而是在服务端给客户端发包时就把玩家此刻看不到的方块换成假方块——客户端手里的数据里根本没有真矿脉，所以无论是 X-Ray 客户端还是透视材质包都无从下手。因为改的只是网络数据包，存档与世界数据完全不受影响，回滚和备份都不需要。

可配置程度是这个插件的卖点：哪些方块需要保护、按什么距离还原真实数据、使用哪种伪装引擎，都能按服务器需求调整；箱子、熔炉一类的方块实体（BlockEntity）同样可以隐藏，防止透视玩家直奔容器。5.6.0 起加入了岩浆伪装与非原版/模组方块支持，5.6.2 又补上了 26.3 与 Folia 的兼容。

需要留意两点：5.x 版本必须搭配 ProtocolLib 5.2.0 或以上，两者版本要同步升级；另外 Paper 自带的 anti-xray 也能达到类似效果，两套机制同时开启等于重复伪装，没有必要。作者从 27.x 起采用滚动支持策略，只维护最近两个 Minecraft 大版本。
核心特性
发包层伪装：只改发给客户端的方块数据，不写入存档、不改动世界
按距离动态还原：玩家靠近或方块本身暴露后才发送真实数据，其余时间看到的是伪装块
方块实体隐藏：箱子、熔炉等 BlockEntity 也能一并伪装，避免透视找容器
伪装引擎可换：提供多种伪装算法/引擎，在防护效果与性能开销之间取舍
精细方块控制：通过配置指定需要保护的方块，白名单式管理
岩浆伪装：5.6.0 起支持对岩浆做处理，兼顾下界等特殊场景
模组方块支持：非原版方块同样可以纳入伪装范围
Folia 支持：5.6.2 修复了 26.1 之后的 Folia 兼容性
内置缓存：带缓存机制（含 RegionFileCache），降低重复发包开销
版本策略明确：27.x 起只维护最近两个大版本，旧版仍可用但不保证修复
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Spigot、Paper、Purpur、Folia 等 1.16 以上服务端 |
| Minecraft | Java 版 1.16.5 – 26.3，具体以所下载构建标注为准 |
| Java 版本 | Java 17 或以上 |
| 前置依赖 | ProtocolLib 5.2.0 或以上（必需） |
| 注意事项 | 与 Paper 自带 anti-xray 同时开启会造成重复伪装，建议只保留一套 |
安装方法
先安装 ProtocolLib（5.2.0 或以上版本），放入 plugins/
下载 Orebfuscator 的 jar（如 Orebfuscator-5.6.2.jar），放入 plugins/
重启服务器，插件会生成 config.yml
按需调整需要伪装的方块、隐藏距离与伪装引擎
用有权限的账号查看插件运行状态，确认没有报错

> 两个插件都要正确加载，缺 ProtocolLib 时 Orebfuscator 不会正常工作。
使用提示
默认配置开箱可用，建议先用默认值跑一段时间，再按服务器实际情况微调
服务端升级时 ProtocolLib 和 Orebfuscator 要一起升级，否则容易出现数据包结构不匹配的报错
如果 Paper 已经开了自带 anti-xray 的 engine-mode，就不要再叠加 Orebfuscator，重复伪装只会白吃性能
验证效果最直接的办法：换个客户端进矿洞走一圈，确认未暴露的矿脉不可见
Java 11 或 1.9.4 这类老环境只能用 5.5.0 之前的旧版，作者已不再维护，新服不建议
性能开销与伪装范围、在线人数相关，高人数服务器建议先小范围试跑再全服推开
相关链接
Modrinth 下载：https://modrinth.com/plugin/orebfuscator
官方 Wiki（配置说明）：https://github.com/Imprex-Development/orebfuscator/wiki
常见问题排查：https://github.com/Imprex-Development/orebfuscator/wiki/Common-Issues
源码仓库：https://github.com/Imprex-Development/orebfuscator
前置插件 ProtocolLib：https://modrinth.com/plugin/protocollib