FP's AntiFreecam

插件

· 作者 fleoraticlyyy

保护你的服务器免受 Freecam、X-Ray 和 ESP 的侵害。灵感来源于 Donut SMP

0 本站下载 0 关注 更新于 3 天前

需要前置:PacketEvents

最新 1.5.4-f152a66 · 26.3 · Bukkit / Folia

一键开服(送7天)

Banner

需要服务器?

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

Alyrix Cloud

Alyrix Cloud


FPAntiFreeCam 可阻止玩家利用 FreeCam、X-Ray 和 Block ESP 模组来寻找基地、洞穴和矿物。

它通过拦截服务器发送的数据包来实现,因此不会改变你的世界中的任何内容。客户端根本不会收到那些它不应该看到的方块数据:

  • 在地表上,所有深层地下的内容都会被隐藏。使用 FreeCam 飞下去的玩家会发现一片虚空,或者在启用 Smart Fill 时看到看起来像正常地形的普通岩石。
  • 在地下,玩家会看到周围的洞穴是正常的,但较远处的洞穴会被填充,直到他们实际到达那里才会显示出来。
  • 矿物 在玩家拥有清晰视线之前都会以石头、深板岩或下界岩的形式发送。使用 X-Ray 模组只会看到岩石。

依赖要求

功能特性

  • 反 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">

[![bStats](https://bstats.org/signatures/bukkit/FPAntiFreecam.svg)](https://bstats.org/plugin/bukkit/FPAntiFreecam/33706)

</div>

## 支持

发现错误或有问题?请在 Discord 上提问或在 GitHub 上提交 Issue。

[![Discord Banner](https://img.shields.io/badge/Join_Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/5XEqzkSwza)
[![GitHub Banner](https://img.shields.io/badge/GitHub_Repository-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/Fleoxzyy/FPAntiFreeCam)

*保护玩家不应看到的内容。*

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源