
Paper 的反 X 射线机制对矿石有很好的防护效果,但对箱子毫无作用。
箱子会向客户端发送两次:一次作为方块,另一次在包含其精确坐标的独立实体列表中。反 X 射线仅处理方块,因此该列表原样发送。即使启用 engine-mode: 2,连箱子方块本身也会泄露。像 Krypton 这样的客户端中的储物 ESP、 stash 查找器和“基地查找器”模块会读取该列表,从而看到渲染距离内的所有容器。
OutOfSight 会在玩家实际能够看到之前,将容器从区块数据包中移除。
它隐藏的内容
- 箱子、陷阱箱、铜箱子、木桶、末影箱、潜影盒(所有颜色)、刷怪笼
- 熔炉、漏斗、酿造台、信标、附魔桌、床、告示牌和旗帜
- 箱子矿车、漏斗矿车和箱子船
- 你可以添加的其他任何内容。支持方块标签如
#beds,你也可以添加物品展示框和盔甲架等实体
当玩家在 48 格范围内且视线能直接照射到目标时,才会发送该容器。走进你的基地,箱子就会显示出来。站在别人基地上方的山丘上,或者从 150 格外扫描,它们就不会出现。实体仅遵循视线规则,因此开阔水域上的船只或墙上的物品展示框看起来与往常一样。
它不做的内容
它不处理移动或战斗相关功能。KillAura、水晶光环、飞行和加速需要模拟型反作弊;请使用 Grim,它可以与该插件并行运行而无冲突。它也无法隐藏隧道或坑洞,因为客户端需要地形形状才能在上面行走。
对于矿石 X 射线和下界合金查找器,你需要开启 Paper 的反 X 射线功能。默认情况下它是关闭的,且其默认列表排除了 ancient_debris、spawner 和 barrel。运行 /oos advise,插件会告诉你 Paper 配置中缺少什么。
要求
- Paper 或其分支如 Purpur:1.21.11、26.1、26.2 或 26.3
- PacketEvents 2.14.0 或更高版本(1.21.11 上 2.13.0 也可用)
- Java 21,或在 26.x 上使用 Java 25
- 不支持 Folia 和 Spigot
同一个 jar 包适用于上述列出的所有版本。ViaVersion 和 ViaBackwards 也可以正常使用。
安装
- 安装 PacketEvents。
- 将 OutOfSight 放入
plugins/ 目录并重启服务器。
- 护盾默认处于关闭状态。设置
shield.test-mode: true 和 shield.enabled: true,运行 /oos testme,重新连接后检查你是否仍能找到并打开自己的箱子。测试模式开启期间,只有你自己受影响。
- 满意后,设置
test-mode: false 以覆盖所有人。
命令
所有命令都需要 outofsight.admin 权限(默认 OP)。/oos 可作为快捷方式使用。
| 命令 |
功能 |
/oos shield |
切换护盾开关 |
/oos testme |
仅对自己应用护盾,用于测试 |
/oos advise |
报告 Paper 反 X 射线设置遗漏的部分 |
/oos xray [chunks] |
审计出站区块数据包是否存在泄露 |
/oos hidechest |
建造一个埋藏的测试箱,然后重新连接以检查是否隐藏 |
/oos perf |
显示护盾的性能开销 |
测试与限制
每次提交都会在真实 Paper 服务器上针对 1.21.11、26.1.2、26.2 和 26.3 版本进行测试。无头客户端加入服务器,解码收到的每个数据包,并检查在地狱和主世界中,埋藏的箱子和矿车保持隐藏,而可见的目标正常到达。随后关闭护盾重复相同场景,以确认测试能够捕获泄露。
这是一个测试版。它尚未在繁忙的服务器上运行过,负载测试最高仅达到 40 个机器人。护盾在网络线程上工作,在这些测试中 TPS 保持在 20。如果发现任何问题,请通过 /oos shield 关闭护盾并提交 Issue。
部分代码和本页面使用了 AI 辅助编写。
源码和完整文档:GitHub。GPL-3.0。

Paper's anti-xray does a good job on ores. It does nothing for chests.
A chest is sent to the client twice: once as a block, and once in a separate list of block entities with its exact coordinates. Anti-xray only touches blocks, so that list goes out as is. With engine-mode: 2 even the chest block itself leaks. Storage ESP, stash finders and "base finder" modules in clients like Krypton read that list and see every container in render distance.
OutOfSight takes containers out of the chunk packet until the player could actually see them.
What it hides
- Chests, trapped chests, copper chests, barrels, ender chests, shulker boxes (every colour), spawners
- Furnaces, hoppers, brewing stands, beacons, enchanting tables, beds, signs and banners
- Chest minecarts, hopper minecarts and chest boats
- Anything else you add. Block tags like
#beds work, and you can add entities such as item frames and armor stands
A container is sent once the player is within 48 blocks and a ray from their eye reaches it. Walk into your base and the chests are there. Stand on a hill above someone's base, or scan from 150 blocks out, and they aren't. Entities follow line of sight only, so a boat on open water or item frames on a wall look the same as they always did.
What it doesn't do
It doesn't touch movement or combat. KillAura, crystal aura, fly and speed need a simulation anticheat; use Grim, which runs next to this plugin without conflict. It can't hide tunnels or holes either, because the client needs the terrain shape to walk on it.
For ore X-ray and netherite finders you need Paper's anti-xray turned on. It ships off, and its default list leaves out ancient_debris, spawner and barrel. Run /oos advise and the plugin will tell you what your Paper config is missing.
Requirements
- Paper or a fork such as Purpur: 1.21.11, 26.1, 26.2 or 26.3
- PacketEvents 2.14.0 or newer (2.13.0 also works on 1.21.11)
- Java 21, or Java 25 on 26.x
- Folia and Spigot are not supported
The same jar works on every version listed. ViaVersion and ViaBackwards are fine too.
Installing
- Install PacketEvents.
- Drop OutOfSight into
plugins/ and restart.
- The shield starts off. Set
shield.test-mode: true and shield.enabled: true, run /oos testme, relog, and check that you can still find and open your own chests. Only you are affected while test mode is on.
- When you're happy, set
test-mode: false to cover everyone.
Commands
All need outofsight.admin (op by default). /oos works as a shortcut.
| Command |
What it does |
/oos shield |
Toggle the shield |
/oos testme |
Shield only yourself, for testing |
/oos advise |
Report what Paper's anti-xray settings leave open |
/oos xray [chunks] |
Audit outgoing chunk packets for leaks |
/oos hidechest |
Build a buried test chest, then relog to check it |
/oos perf |
Show what the shield costs |
Testing and limits
Every commit is checked on real Paper servers running 1.21.11, 26.1.2, 26.2 and 26.3. A headless client joins, decodes every packet it gets, and checks that buried chests and minecarts stay hidden while visible ones arrive, in the Overworld and the Nether. The same scene is then run with the shield off to confirm the test would catch a leak.
This is a beta. It hasn't run on a busy server yet and has only been load tested up to 40 bots. The shield works on network threads and TPS stayed at 20 in those runs. If something looks wrong, turn the shield off with /oos shield and open an issue.
Parts of the code and this page were written with AI assistance.
Source and full docs: GitHub. GPL-3.0.
评论 0
登录后参与评分
还没有评论,来抢沙发吧