# 🛡️ FPAntiFreeCam [Folia Compatible!] ### Anti-FreeCam & Anti-Xray Protection ![Banner](https://cdn.modrinth.com/data/cached_images/5a285dc33930eb8c81443e43cfa23364e645af71.png) 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**. --- ## 🚀 No Dependencies Required! Drop it in, configure your worlds, done. Zero libraries to install. --- ## ✨ Features - 👁️ **Anti-FreeCam / Anti-Xray** — hides all underground blocks via packet manipulation. - 📦 **Entity hiding** — conceals mobs, item frames, and farms inside protected zones. - 🔍 **Two-layer detection** — hard Y-floor deactivation + raycast zone for cave/ceiling edge cases. - 🔔 **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. - 🛡️ **Robust Edge Case Protection:** - 🔄 **Teleport-Safe:** Prevents 1-tick NBT packet leaks on teleports. - 🚲 **Vehicle-Aware:** Instantly updates protection states upon entering or exiting mounts/vehicles. - 🕶️ **Spectator Friendly:** Automatically bypasses protection for spectator-mode players to prevent vision obscuration. --- ## 🖥️ 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 a protected world | `fpantifreecam.admin` | | `/fpac bypass ` | 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.0 # ── 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 < deep-deactivation-y < protection-y # Example with defaults: 15 < 20 < 64 deep-deactivation-y: 20.0 # Raycast zone: players between deep-deactivation-y and protection-y. # Two sub-checks decide whether to arm protection here: # 1. Look-direction: camera pointing upward (freecam angle exploit) # 2. Sky access: open vertical path to protection-y (cave ceiling gap) raycast: enabled: true # Minimum upward look vector (0.0–1.0) to arm protection. ~0.15 ≈ 9° above horizontal. min-upward-angle: 0.15 # Milliseconds of stability before applying a state change via raycast. # Prevents flicker near zone boundaries. 500ms is a good balance. deactivation-debounce-ms: 500 # Also cast diagonal rays (NE/NW/SE/SW) to catch angled cave openings. multi-directional: true # ── Replacement block ───────────────────────────────────────── # Block type sent to the client in place of hidden underground blocks. # "air" produces a clean void look (recommended). # "stone" can be used to fake a solid floor instead. replacement: block-type: "air" # ── Entity hiding ───────────────────────────────────────────── entities: # Hide non-player entities that are inside the hidden zone. # Prevents FreeCam from revealing mob farms / storage mobs. hide-entities: true # ── Player notifications ──────────────────────────────────────── notifications: action-bar: # Show a HUD message while protection is active for a player. enabled: false message-active: "&c☠ FreeCam Protected" # ── Anti-cheat helpers ──────────────────────────────────────── anti-cheat: freeze-detection: # Log a console warning if a protected player above protection-y # has not moved for N seconds (possible position-spoofing FreeCam). enabled: false seconds: 30 # ── Performance ─────────────────────────────────────────────── performance: # Folia: enable region-aware chunk scheduling (auto-detected) folia-optimizations: true # Paper/Spigot: max chunks refreshed per server tick max-chunks-per-tick: 40 # Instant protection: force a large-radius refresh when a player # first enters the surface-y zone so bases are hidden immediately. instant-protection: enabled: true # Chunks radius to refresh when instant protection fires instant-load-radius: 14 # Pre-load distance in blocks above surface-y where instant refresh is armed pre-load-distance: 10 # Force re-encode of chunk data immediately (prevents momentary base glimpse) force-immediate-refresh: true # Limit how far chunk REFRESHES reach when protection toggles. # WARNING: does NOT limit packet masking — but stale client cache outside # this radius may briefly show real blocks until those chunks reload. # Leave disabled unless you need the perf savings and accept that tradeoff. limited-area: enabled: false chunk-radius: 4 ```

--- ## ✅ Compatibility | Platform | Supported | |---|---| | Paper 1.19 – 26.1.2+ | ✅ | | Purpur | ✅ | | Spigot | ✅ | | Bukkit | ✅ | | Folia | ✅ | | Geyser / Floodgate | ✅ | --- ## 💬 Support **Discord:** [Join our Discord Server](https://discord.gg/ezA5Q6wGj) **GitHub:** [FPAntiFreeCam GitHub](https://github.com/Fleoxzyy/FPAntiFreeCam) *Secure what players shouldn't see.*

fleoraticlyyy

FP's AntiFreecam

Информация