AntiFreecam — 针对 Paper 1.21.x 的反 Freecam 与反 ESP 保护
? 概述
AntiFreecam 是一款轻量级的服务端反作弊插件,用于阻止 Freecam(自由视角)和 ESP/X-ray 透视作弊。它会将所有低于可配置 Y 层的方块对地表玩家隐藏,因此在地底飞行的 Freecam 或 ESP 相机看到的将全是实心石头——而正常的地下游玩体验保持原版不变。无需安装任何客户端模组;所有功能均通过 PacketEvents 在服务端运行。
✨ 特性
- Freecam 拦截器 —— 向地表玩家发送低于你设定的 Y 阈值的区域全部为石头。
- 反 ESP —— 地下的洞穴、基地、矿石和实体从地表不可见。
- 类似原版的揭示 —— 当玩家真正进入地下时,其周围区域会平滑地显示出来。
- 自动重新遮蔽 —— 一旦玩家返回地表,这些区域会再次被隐藏。
- 实体隐藏 —— 低于阈值的生物和玩家对地表玩家隐藏。
- 模组检测 —— 尽力而为的客户端品牌检查(Wurst),支持自动踢出和管理员警报。
- 工作人员绕过 —— 一条命令即可赋予工作人员完全视野。
- 简洁且可重载的配置。
⚙️ 工作原理
- 服务端拦截发出的区块数据包。
- 对于地表玩家,所有低于 hideBelowY 的方块在到达客户端之前都会被重写为石头。
- 当玩家下降时,附近的区块会以未遮蔽状态重新发送,使挖矿看起来正常。
- 当他们爬回地面时,这些区块会被重新遮蔽。
? 要求
- Paper / Purpur 1.21.x
- Java 21
- 已安装 PacketEvents 插件(必需依赖项)
? 安装
- 将 PacketEvents 安装到你的 plugins/ 文件夹中。
- 将 AntiFreecam.jar 放入 plugins/ 目录。
- 重启服务器 —— 将生成 config.yml。
- 调整设置并运行 /antifreecam reload。
? 命令与权限
/antifreecam reload —— 重载配置 (antifreecam.reload)
/antifreecam bypass [player] —— 切换工作人员的遮蔽绕过状态 (antifreecam.bypass)
?️ 关键配置选项
hideBelowY —— 对地表玩家隐藏此 Y 值以下的所有内容
revealBelowYWhenUnder —— 玩家被视为“在地下”时的 Y 值
lazyUnmask.distance —— 地下提前揭示的范围(设置为接近视距 × 16 以获得完整的原版手感)
maskEntities —— 对地表玩家隐藏 Y 值以下的实体
modDetection —— 启用/禁用 Wurst 检测、自动踢出和警报
此插件需要 PacketEvents 才能运行。
PacketEvents(免费,必需):
Modrinth:
GitHub:
在使用 AntiFreecam 之前,请先将 PacketEvents 安装到你的 plugins/ 文件夹中。
为什么 Freecam 后会出现“隐形墙”
这不是卡顿或服务器错误——这是保护系统的预期行为。
服务端仅在玩家实际位置周围揭示真实方块。任何低于受保护 Y 层且玩家未合法到达的区域,都会作为假石头发送。当 Freecam 模组仅移动相机时,服务端仍认为玩家站在原始位置,并继续发送被遮蔽的方块数据。
因此,玩家可能会使用 Freecam “发现”洞穴、矿石或隧道,但这些位置实际上并未由服务端揭示。尝试在那里挖矿将会失败,因为客户端的视图与服务端的真实方块数据不匹配。
在某些情况下,即使玩家将真实角色移动到该位置,受影响的区块可能仍然不同步,因为它们之前是通过 Freecam 加载的。玩家可能会看到缺失的地形、虚空般的区域或无法挖掘的方块。
如何解决
刷新这些区块只有两种方法:
- 移动足够远以使受影响的区块卸载,然后不使用 Freecam 返回。
- 重新连接服务器,这将强制进行完整的区块重新同步。
一旦区块正常刷新,真实地形将被揭示,挖矿也将按预期工作。
简而言之,Freecam 可以显示玩家尚未合法到达的区域,但这些区域在服务端正确刷新区块数据之前仍然是无法访问的。
AntiFreecam — Anti-Freecam & Anti-ESP protection for Paper 1.21.x
? OVERVIEW
AntiFreecam is a lightweight, server-side anti-cheat that shuts down Freecam and ESP/X-ray vision cheats. It hides every block below a configurable Y-level from players who are on the surface, so a freecam or ESP camera flying underground sees nothing but solid stone — while normal underground gameplay stays completely vanilla. No client mod required; everything runs on the server through PacketEvents.
✨ FEATURES
Freecam blocker — surface players are sent stone for everything below your Y-threshold.
Anti-ESP — caves, bases, ores and entities underground are invisible from the surface.
Vanilla-like reveal — when a player actually goes underground, the area around them is revealed smoothly.
Auto re-mask — areas are hidden again the moment the player returns to the surface.
Entity hiding — mobs and players below the threshold are hidden from surface players.
Mod detection — best-effort client-brand check (Wurst) with auto-kick and admin alerts.
Staff bypass — give your staff full vision with a single command.
Clean, reloadable configuration.
⚙️ HOW IT WORKS
- The server intercepts outgoing chunk packets.
- For surface players, all blocks below hideBelowY are rewritten to stone before reaching the client.
- When a player descends, nearby chunks are re-sent un-masked so mining looks normal.
- When they climb back up, those chunks are re-masked.
? REQUIREMENTS
Paper / Purpur 1.21.x
Java 21
PacketEvents plugin installed (required dependency)
? INSTALLATION
- Install PacketEvents into your plugins/ folder.
- Drop AntiFreecam.jar into plugins/.
- Restart the server — a config.yml is generated.
- Tune the settings and run /antifreecam reload.
? COMMANDS & PERMISSIONS
/antifreecam reload — reload the config (antifreecam.reload)
/antifreecam bypass [player] — toggle masking bypass for staff (antifreecam.bypass)
?️ KEY CONFIG OPTIONS
hideBelowY — hide everything below this Y from surface players
revealBelowYWhenUnder — Y at which a player counts as "underground"
lazyUnmask.distance — how far ahead is revealed underground (set near view-distance × 16 for full vanilla feel)
maskEntities — hide below-Y entities from surface players
modDetection — enable/disable Wurst detection, auto-kick and alerts
This plugin requires PacketEvents to run.
PacketEvents (free, required):
Modrinth:
GitHub:
Install PacketEvents into your plugins/ folder before using AntiFreecam.
Why "Invisible Walls" After Freecam Are Expected
This is not lag or a server bug — it is an intentional part of the protection system.
The server only reveals real blocks around a player's actual position. Any area below the protected Y-level that the player has not legitimately reached is sent as fake stone. When a freecam mod moves only the camera, the server still sees the player standing in the original location and continues sending masked block data.
Because of this, a player may appear to discover caves, ores, or tunnels with freecam, but those locations are not actually revealed by the server. Attempting to mine there will fail because the client's view does not match the server's real block data.
In some cases, even after moving the real character to that location, the affected chunks may remain desynced because they were previously loaded through freecam. The player may see missing terrain, void-like areas, or blocks that cannot be mined.
How to Fix It
There are only two ways to refresh those chunks:
- Move far enough away for the affected chunks to unload, then return without using freecam.
- Reconnect to the server, which forces a complete chunk resynchronization.
Once the chunks are refreshed normally, the real terrain will be revealed and mining will work as expected.
In short, freecam can show areas that the player has not legitimately reached, but those areas remain inaccessible until the server properly refreshes the chunk data.
评论 0
登录后参与评分
还没有评论,来抢沙发吧