Occlusion

Occlusion

介绍

服务端反自由视角。服务器会判断每位玩家实际能看到什么，并且只发送这些内容。视野之外的洞穴、基地和生物都不会被发送，因此自由视角（或任何客户端作弊）也无从显示。隐藏区域会以普通石头的形式发送，一旦进入视野就会变成真实方块，所以正常游玩的玩家完全察觉不到。

此外还提供 射线检测反矿透（视线无法到达的矿石会以石头形式发送）和 反透视（墙后的实体完全不会发送）。

截图

在地下基地上方的岩层内部使用自由视角：

在地下深处向下观察。原版会发送所有洞穴、废弃矿井和基地：

墙另一侧的生物在玩家能够看到它们之前，不会出现在客户端：

功能

• 反自由视角：使用客户端自身的区块段遍历方式，并结合地下视线射线，检查每个 16x16x16 区块段。玩家移动方向前方的区块段会提前发送，因此不会突然显现。
• 射线检测反矿透：接触空气、但从玩家视角无法通过任何射线触及的矿石会以石头形式发送。密封的空气空间也会被填充。
• 反透视：除投射物外，每个实体都会进行方块级视线检测。32 格内的玩家始终会显示，发光实体和 Boss 血条也会保留。
• 挖掘显现：你挖掘的方块后方会在方块被破坏前显示，因此瞬间挖掘时不会看到石头。
• 第三人称（F5）视角也会被视作玩家视线。
• 支持通过 Geyser 接入的基岩版玩家。Simple Voice Chat：隐藏玩家的声音仍会从其实际位置传来。
• 供其他模组使用的前置库：PandaOcclusionApi.canSee(ServerPlayer, AABB)（全息图、伪造实体）。

不影响正常玩家

• 完整的原版音效：客户端会根据已加载的方块和生物自行生成许多音效（熔岩噼啪声、传送门嗡鸣、火焰、熔炉、刷怪笼、监守者心跳、烈焰人、不死图腾等）。Occlusion 会在服务器端处理这些音效并发送给玩家，因此无论周围内容是否隐藏，玩家仍能听到所有方块音效和细微声响。
• Boss 血条：墙后的凋灵仍会像原版一样显示生命条。
• 光照：隐藏区域重新显示时光照正确，不会出现黑块。
• 瞬间挖掘：开始挖掘方块时，其后方内容就会显现，因此绝不会看到填充用的石头。

性能与测试

• 带宽：登录和飞行时，区块数据量降至原版的 0.30-0.40x；在下界则降至 0.17-0.30x。
• 服务器开销：视线检测在独立线程中运行。在 Hardcore Anarchy 上，每刻开销约为 0.4 毫秒（占服务器线程的 0.8%）。同时有 30 个机器人在地下移动时，每次检测的线程外开销为 0.2 毫秒，服务器线程每刻开销约为 0.02 毫秒。
• 射线检测反矿透：接触空气但位于视野外、仍会发送给客户端的矿石数量，在测试洞穴中从 478 降至 18；没有把任何视野内的矿石错误隐藏。
• 测试：每次更改都会运行一套包含 36 项机器人的自动化测试，并与上一版本对比，逐一检查玩家可见的方块和实体。视线范围内错误方块数为 0。自 2026 年 10 月起，已在 Hardcore Anarchy 和 Skyblock Anarchy 上运行。

与 GrimAC 兼容

与 GrimAC 兼容，但有个问题：Occlusion 重新发送玩家所在区块时，上游 Grim 会短暂地把玩家判定为身处尚未加载的区块，并将其回弹（不会触发警报）。35bf13c 这个提交修复了问题，位于TreeOfSelf/Grim fork中，两台服务器都在使用该分支。

配置

config/PandaOcclusion.json文件会在首次启动时生成。每项功能都有各自的开关（hideEntities、hideUnseenOres、hideSealedPockets、revealBehindDig、thirdPersonCamera、hiddenSounds，等等）。

与反矿透模组搭配效果良好：在反矿透模组的隐藏方块列表和 keepHiddenUntilExposed 中填写相同的天然方块。

命令

需要 3 级管理员权限：

• /occlusion reload，/occlusion stats
• /occlusion bypass：让自己看到所有内容（切换开关）
• /occlusion section <player> <pos>，/occlusion why <player> <entity id>：查看某项内容被隐藏或显示的原因

紧急关闭："enabled": false 和 /occlusion reload。

试试看

hardcoreanarchy.gay（Deathban Anarchy）
sky.hardcoreanarchy.gay（Skyblock Anarchy）

更多模组

• Anti-Exploit – 即装即用的模组，用于防止常见漏洞。支持全面配置，也能与 GrimAC 等其他反作弊模组良好配合。
• GeyserAC – 面向通过 Geyser 加入的基岩版玩家的反作弊：检测移动、战斗和方块交互。
• No Lag – 阻止服务器常见的卡顿来源。可按自己的喜好进行配置。
• Dupe Fix – 简单易用的模组，可防止各种复制物品漏洞。启用该模组后，TNT 复制、重力方块复制等漏洞都将无法使用。

我的所有模组

问题反馈

漏洞和问题请提交到 GitHub Issues。不提供 Discord 支持。

许可证