
需要服务器?
点击下方横幅,使用代码 FLEOX 在 Alyrix Cloud 购买前两个计费周期即可享受 30% 折扣:

Alyrix Cloud
FPAntiFreeCam 可阻止玩家利用 FreeCam、X-Ray 和 Block ESP 模组来寻找基地、洞穴和矿物。
它通过拦截服务器发送的数据包来实现,因此不会改变你的世界中的任何内容。客户端根本不会收到那些它不应该看到的方块数据:
- 在地表上,所有深层地下的内容都会被隐藏。使用 FreeCam 飞下去的玩家会发现一片虚空,或者在启用 Smart Fill 时看到看起来像正常地形的普通岩石。
- 在地下,玩家会看到周围的洞穴是正常的,但较远处的洞穴会被填充,直到他们实际到达那里才会显示出来。
- 矿物 在玩家拥有清晰视线之前都会以石头、深板岩或下界岩的形式发送。使用 X-Ray 模组只会看到岩石。
依赖要求
- PacketEvents 2.11.0 或更高版本
- Spigot, Paper, Purpur 或 Folia,支持 1.19 – 26.3 版本
- Java 17 或更高版本
功能特性
- 反 FreeCam: 当玩家处于地表时,隐藏设定 Y 轴高度以下的所有内容。
- 智能填充 (Smart Fill): 用从周围地形复制的岩石填充隐藏区域,而不是空气,从而让人难以察觉有任何内容被隐藏。
- 反 Xray: 矿物会在你能够实际看到它们之前保持隐藏状态,包括从 F5 视角观察时。可以为每个世界单独设置矿物列表和高度范围。
- 实体隐藏: 隐藏区域内的生物和物品展示框也会被隐藏(
chunk模式,默认)。raycast模式还会像 ESP 屏蔽器一样隐藏墙壁背后的所有实体,并可选择包含玩家。标签页列表不受影响。 - 隐藏的不只是方块: 隐藏区域内的箱子、告示牌、刷怪笼、生物、物品展示框、粒子效果和声音都会被隐藏,这样 F3 饼图和 ESP 模组就无法找到基地。
- FreeCam 模组检测: 在玩家加入时检查客户端是否安装了 FreeCam 模组,并执行你选择的命令(踢出、封禁、通知工作人员)。
- 基岩版支持: 兼容 Geyser 和 Floodgate。
- Folia 支持: 每项检查都在负责该区域的区域线程上运行。
- 网络负载低: 区块刷新分散在多个 tick 中进行,矿物揭示以小方块更新的形式发送,从不发送整个区块。
- 更新检测器: 在新版本发布时,在游戏中和控制台中通知管理员。
命令
| 命令 | 描述 |
|---|---|
/fpac reload |
重载配置文件 |
/fpac stats |
显示实时插件统计数据 |
/fpac debug |
切换调试日志记录 |
/fpac world <add|remove> <world> |
添加或删除受保护的世界 |
/fpac bypass <player> |
为某位玩家切换绕过权限,直到其离开服务器 |
/fpac help |
显示命令帮助信息 |
/fpreload |
/fpac reload 的简写 |
/fpdebug |
/fpac debug 的简写 |
所有命令均需 fpantifreecam.admin 权限。
别名: /fpafc, /antifreecam, /fpacreload, /fpacdebug
权限
| 权限节点 | 描述 | 默认分配 |
|---|---|---|
fpantifreecam.admin |
所有命令(不包含绕过权限) | OP |
fpantifreecam.reload |
重载配置文件 | OP |
fpantifreecam.debug |
切换调试模式 | OP |
fpantifreecam.world |
管理受保护的世界 | OP |
fpantifreecam.alerts |
在聊天中接收 FreeCam 检测警报 | OP |
fpantifreecam.bypass |
跳过 FreeCam 保护、反 Xray 和实体隐藏 | 无 |
fpantifreecam.bypass.freecam |
仅跳过 FreeCam 保护 | 无 |
fpantifreecam.bypass.xray |
仅跳过反 Xray | 无 |
fpantifreecam.bypass.entities |
仅跳过基于视线的实体隐藏 | 无 |
OP 和其他玩家一样受到保护。如果需要让工作人员或建筑者看到所有内容,请授予他们相应的绕过权限。
当设置了 bypass.freecam、bypass.xray 和 bypass.entities 时,它们会覆盖 bypass。例如,如果设置 bypass: true 且 bypass.xray: false,则该玩家的反 Xray 保护仍然生效。
配置文件
点击展开 config.yml
# ─────────────────────────────────────────────────────────────────────
# FPAntiFreeCam 配置
# 适用于 Spigot, Paper 和 Folia (1.19 - 26.3)。使用 /fpac reload 应用更改。
# ─────────────────────────────────────────────────────────────────────
# 请勿手动修改此值。
config-version: 5.8
# ── 常规设置 ──────────────────────────────────────────────────────────
settings:
# 在启动时检查更新,并在玩家加入时通知管理员。
update-checker: true
# 文件位于 plugins/FPAntiFreeCam/lang/<language>.yml
language: "en"
控制台调试输出。在线服务器请保持为 false。
debug-mode: false
单个玩家区块刷新的最小间隔秒数。
refresh-cooldown-seconds: 3
── 世界 ───────────────────────────────────────────────────────────
启用地下隐藏的世界列表。下界和末地可能会出现故障。
(Anti-Xray 和实体隐藏在下面有各自的世界设置。)
worlds: list: - "world" # - "survival"
── 保护 ───────────────────────────────────────────────────────
规则:void-y < deep-deactivation-y < protection-y
脚部位于或高于 protection-y:保护开启。
位于 deep-deactivation-y 和 protection-y 之间:仅当玩家抬头或拥有通往地面的开放路径时开启。
低于 deep-deactivation-y:关闭。
protection:
保护开启的 Y 坐标(玩家脚部)。设置为你的地表高度(海平面为 63)。开启时,该玩家视野中 void-y 及以下的所有内容都会被隐藏。这也是默认的天际线高度。
自定义地图且不确定地表高度?设置得稍低一些而不是太高,并开启 replacement.smart-fill.follow-terrain,以便隐藏更高地形中的洞穴。
protection-y: 64.0
protection-y 以下的方块数量,用于防止闪烁。
hysteresis-y: 2.0
此 Y 坐标及以下的方块将被隐藏。比你的最高基岩层高出约 5 格。
void-y: 15
每个世界的 void-y。未列出的世界使用默认的 void-y。
per-world-void-y:
resource_world: 20
低于此 Y 坐标,保护始终关闭。
deep-deactivation-y: 20.0
在隐藏区域中也隐藏箱子、告示牌、刷怪笼、生物、物品、粒子效果和声音(F3 饼图、ESP)。请保持开启。
pie-chart-protection: true
玩家周围显示的真实洞穴范围(需要 Smart Fill)。
smart-fill: # 在此范围内玩家可以行走或看到的洞穴被视为真实存在。 reveal-radius: 28
# 在此距离内的所有内容始终视为真实存在,即使穿过岩石。
near-radius: 6
# 视图前方这么远的区块会被刷新。
look-distance: 48
# 离开某区域后,该区域保持“真实”状态的秒数。0 = 立即。
# 高数值会让玩家更容易侦察基地并使用自由视角返回。
recently-revealed-ttl-seconds: 20
# 显示玩家视线可以穿透的远处洞穴。墙壁仍然会阻挡视线。
reveal-line-of-sight: true
# 将该距离限制在玩家的渲染距离内。
reveal-follow-render-distance: true
# 最大视线距离(方块单位,32-256)。
reveal-max-distance-cap: 128
# 每秒每个玩家检查的方块数。数值越低,服务器耗时越少。
reveal-sight-budget: 60000
── 隐藏方块的显示效果 ─────────────────────────────────────
replacement:
当 Smart Fill 关闭时,替代隐藏方块显示的材质。
block-type: "air"
用从附近地形复制的岩石和矿石填充隐藏区域,而不是空气。
smart-fill: enabled: true
# 在地下时也隐藏远处的洞穴,而不仅仅是在地表附近。
always-on: true
# 基岩(Geyser)会在区块重新加载时显示 Smart Fill 的刷新效果,因此基岩玩家将获得普通的隐藏效果。需要 Geyser 或 Floodgate。
disable-for-bedrock: true
# 此 Y 坐标以下的洞穴会被隐藏。数值通常与 protection-y 相同,除非你单独设置了它,但功能不同:protection-y 检查玩家的高度,ceiling-y 定义隐藏洞穴的最高高度。
# ceiling-y: 64
# 上下各 16 个方块层,用于从中复制方块(0-4)。
sample-radius-sections: 1
# 填充调色板中的最大方块类型数量(2-16)。
max-palette-size: 6
# 当没有附近地形可供复制时使用。
fallback-block: "stone"
# 地表附近的小型封闭房间(PvP 竞技场、水晶洞)将保留原样。如果那里有一个小型隐藏房间,也会被保留。
surface-structures:
# 屋顶位于或高于此 Y 坐标。
min-y: 30
# 最多这么高的方块(1-32)。
max-pocket-height: 10
# 也隐藏山丘和山脉内部、ceiling-y 以上的洞穴和基地。只有自然方块算作掩护,因此建筑和树木不会被影响。仅限主世界。在山脉附近会消耗更多 CPU。
follow-terrain:
enabled: false
# 在被隐藏之前,一个地点上方所需的自然方块数量(3-32)。
min-cover: 6
── Anti-Xray ────────────────────────────────────────────────────────
隐藏方块会被发送为玩家周围的岩石,直到玩家实际看到它们为止。不依赖于 worlds.list。
绕过权限:fpantifreecam.bypass.xray(或 fpantifreecam.bypass)。
如果 Paper 的 anti-xray 已开启,插件会自动关闭自身(并将 enabled 设为 false)。
anti-xray: enabled: true
当 Paper 的 anti-xray 导致本插件关闭时,在玩家加入时提示管理员。
如果你打算继续使用 Paper 的 anti-xray,请设置为 false。
paper-anti-xray-warning: true
此距离内的方块始终显示。
always-reveal-radius: 3
最大揭示距离(也受视距限制)。
max-ray-distance: 64
每次检查每个玩家的射线步数。数值越低,服务器耗时越少。
ray-budget: 20000
也从 F5 相机位置进行检查。
f5-aware: true
一旦玩家远离此距离,已揭示的方块会再次被隐藏。
forget-distance: 96
“default”用于主世界,“nether”和“the_end”用于对应类型的每个世界。
缺失的键将继承自“default”。若要为某个特定世界单独设置,请通过名称添加(例如 world_nether:)。
worlds: default: enabled: true min-y: -64 # 320 涵盖了山脉矿石。 max-y: 320 hidden-blocks: [coal_ore, deepslate_coal_ore, copper_ore, deepslate_copper_ore, iron_ore, deepslate_iron_ore, gold_ore, deepslate_gold_ore, redstone_ore, deepslate_redstone_ore, lapis_ore, deepslate_lapis_ore, diamond_ore, deepslate_diamond_ore, emerald_ore, deepslate_emerald_ore, raw_iron_block, raw_copper_block] nether: min-y: 0 max-y: 128 hidden-blocks: [nether_gold_ore, nether_quartz_ore, ancient_debris, gilded_blackstone] the_end: enabled: false min-y: 0 max-y: 256 hidden-blocks: [shulker_box, white_shulker_box, orange_shulker_box, magenta_shulker_box, light_blue_shulker_box, yellow_shulker_box, lime_shulker_box, pink_shulker_box, gray_shulker_box, light_gray_shulker_box, cyan_shulker_box, purple_shulker_box, blue_shulker_box, brown_shulker_box, green_shulker_box, red_shulker_box, black_shulker_box]
── 实体 ─────────────────────────────────────────────────────────
entities:
在隐藏区域中隐藏生物、物品展示框、矿车等。
hide-entities: true
实体的隐藏方式:
chunk - 仅在 Smart Fill 隐藏的区域内(你看不到的洞穴)隐藏。对 CPU 负载较低。
raycast - 即使在墙后也会隐藏,通过视线检查。可防止 ESP,但消耗更多 CPU。
hide-mode: chunk
hide-mode: raycast 的设置。
line-of-sight: # 也隐藏墙后的玩家(阻止玩家 ESP)。标签列表保持不变。 # 默认关闭:在 SMP 服务器中,玩家通常期望看到彼此。 # 当定位栏游戏内规则开启时,玩家永远不会被隐藏, # 因为该栏本身就会显示他们的位置。 include-players: false
# 在此距离内的实体始终显示。
always-show-radius: 8
# 实体离开视野后保持显示的毫秒数。
hide-delay-ms: 1500
# 每次检查每位玩家的射线步数。数值越低,服务器耗时越少。
ray-budget: 15000
# 也从 F5 视角位置进行检查。
f5-aware: true
# 禁用此功能的维度。
disabled-worlds: []
# 永远不会被隐藏的实体类型。
never-hide:
- ender_dragon
- wither
- lightning_bolt
- arrow
- spectral_arrow
- trident
- fireball
- small_fireball
- dragon_fireball
- wither_skull
- firework_rocket
- fishing_bobber
- ender_pearl
- snowball
- egg
- potion
- experience_bottle
- llama_spit
- shulker_bullet
- wind_charge
── 通知 ────────────────────────────────────────────────────────────
notifications: action-bar: # 玩家处于保护状态时的动作栏消息。 enabled: false message-active: "&c☠ FreeCam Protected"
── 反作弊 ────────────────────────────────────────────────────────
anti-cheat: freeze-detection: # 当受保护的玩家在此秒数内未移动时,控制台发出警告 # (可能意味着使用了位置欺骗的游离镜头模组)。 enabled: false seconds: 30
── 性能 ────────────────────────────────────────────────────────
performance:
Paper/Spigot:每刻刷新的最大区块数 (1-500)。
max-chunks-per-tick: 40
Folia:每刻向单个玩家重新发送的最大区块数 (1-64)。
max-chunks-per-player-per-tick: 8
靠近保护 Y 坐标时,一次性刷新大范围区块,以免真实方块闪烁。
instant-protection: enabled: true force-immediate-refresh: true # 区块半径。 instant-load-radius: 14 # 从保护 Y 坐标上方开始加载这么多方块。 pre-load-distance: 10
仅在保护状态变化时刷新此半径内的区块。
更远处的区块在重新加载前可能会显示真实方块。
limited-area: enabled: false chunk-radius: 4
── 游离镜头模组检测 ────────────────────────────────────────────────────
加入时,会短暂打开并关闭一个隐藏的告示牌编辑器,以检测 FreeCam 模组。每次加入仅检测一次。
freecam-detection: enabled: true
等待回复的刻数,加上玩家的延迟(20 = 1 秒)。至少为 60。
probe-timeout-ticks: 60
控制台中的每次检测调试信息。
debug: false
检测到后按顺序执行的控制台命令。
占位符:%player%, %uuid%, %key%
detected-commands: - "kick %player% &cFreecam detected" # - "ban %player% Freecam detected"
通知工作人员 (fpantifreecam.alerts) 和控制台。
alerts-enabled: true alert-message: "&8[&cFPAntiFreecam&8] &e%player% &7因 &cFreecam &7被标记 (&8%key%&7)"
</details>
## 统计数据
<div align="center">
[](https://bstats.org/plugin/bukkit/FPAntiFreecam/33706)
</div>
## 支持
发现错误或有问题?请在 Discord 上提问或在 GitHub 上提交 Issue。
[](https://discord.gg/5XEqzkSwza)
[](https://github.com/Fleoxzyy/FPAntiFreeCam)
*保护玩家不应看到的内容。*
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧