FP's AntiFreecam

Minecraft 版本： 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit folia paper purpur spigot

标签： game-mechanics management worldgen

---

Protect underground bases, caves, and hidden structures from players using FreeCam or X-Ray mods. FPAntiFreeCam intercepts outgoing packets and replaces underground blocks with air so FreeCam users see nothing but void below the surface.

⚠️ This plugin does not block ore X-ray. It is designed to protect bases, farms, and hidden structures underground.

---

? Dependencies

FPAntiFreeCam requires the following plugin to be installed on your server:

• PacketEvents 2.x — Required for packet interception & protocol handling.

---

✨ Features

• ?️ Anti-FreeCam / Anti-Xray — hides all underground blocks via packet manipulation.
• ? Entity hiding — conceals mobs, item frames, and farms inside protected zones.
• ? Update checker — notifies admins in-game and in console when a new version is available.
• ⚡ Async & optimized — tick-batched chunk refreshes, minimal performance impact.
• ? Universal platform support — Paper, Purpur, Spigot, Bukkit & Folia (multi-threaded region-aware scheduling).
• ? Bedrock support — Geyser / Floodgate compatible.

---

?️ Commands

Command	Description	Permission
/fpac reload	Reload the config	fpantifreecam.admin
/fpac stats	Show live plugin stats	fpantifreecam.admin
/fpac debug	Toggle debug logging	fpantifreecam.admin
/fpac world <add\|remove> <world>	Add/remove a protected world	fpantifreecam.admin
/fpac bypass <player>	Toggle bypass for a player	fpantifreecam.admin
/fpac help	Show command help	fpantifreecam.admin
/fpreload	Quick config reload shortcut	fpantifreecam.admin
/fpdebug	Quick debug toggle shortcut	fpantifreecam.admin

Aliases: /fpafc, /antifreecam, /fpacreload, /fpacdebug

---

? Permissions

Permission	Description	Default
fpantifreecam.admin	Full access to all commands	OP
fpantifreecam.reload	Reload configuration	OP
fpantifreecam.debug	Toggle debug mode	OP
fpantifreecam.world	Manage protected worlds	OP
fpantifreecam.bypass	Exempt from protection (staff/builders)	❌

---

⚙️ Config

Click to expand config.yml ```yaml # ============================================================ # FPAntiFreeCam – Configuration # Anti-FreeCam protection for Spigot / Paper / Folia # 1.19+ · 1.20+ · 1.21+ · 26.1+ # ============================================================ # PLEASE DO NOT CHANGE!! config-version: 4.2 # ── General ────────────────────────────────────────────────── settings: # Check for updates on startup and notify admins (fpantifreecam.admin permission) on join. update-checker: true # Language file in plugins/FPAntiFreeCam/lang/.yml language: "en" # Print verbose debug info to console (leave false in production) debug-mode: false # Seconds a player must wait between FreeCam-state refresh triggers. # Prevents spam-refreshing when rapidly crossing the surface Y level. refresh-cooldown-seconds: 3 # ── Protected worlds ───────────────────────────────────────── # Add every world name that should have underground-hiding active. # Tip: avoid nether/end worlds – they can cause visual glitches. worlds: list: - "world" # - "survival" # - "resource_world" # ── FreeCam protection thresholds ──────────────────────────── protection: # Y level at-or-above which hiding is ALWAYS armed. # Players standing at or above this Y cannot see blocks below void-y. # Recommended: set to roughly your world's actual surface height. # Example: 64 for a normal overworld, 31 for a flat/custom world. # NOTE: This replaces the old "surface-y" key. Both are supported. protection-y: 64.0 # Blocks below protection-y before protection turns OFF when descending. # Prevents chunk-refresh spam when jumping at the surface boundary. hysteresis-y: 2.0 # Every block at-or-below this Y is replaced with the void block # (replacement.block-type) when protection is active. # Pick the highest Y where your bases/storage actually sit, then add ~5 blocks. # Unsure? Stand on your deepest vault floor in-game and use that Y minus 2. # Default 15 works for typical overworld bases dug to Y~11-20. void-y: 15 # Optional per-world void-y overrides (world name -> Y level). # Worlds not listed here use the global void-y above. # per-world-void-y: # world_nether: 40 # resource_world: 20 # Pie-chart protection: strips tile entities and entity spawns from packets # while protection is active. This prevents players from using the F3 pie chart # to find bases (chests, mob farms, etc.) through the void. pie-chart-protection: false # Absolute Y floor. Players BELOW this value always have protection OFF. # Fixes the void-floor bug when digging straight down near void-y level. # Rule: void-y

---

? Support

Secure what players shouldn't see.