FP's AntiFreecam

✨ New Feature

Smart Fill: line-of-sight reveal

Smart Fill now reveals caves based on what you can actually see. Once a second, the plugin casts rays from your eyes and reveals every cave section they pass through, out to your render distance (or reveal-max-distance-cap, default 128 blocks). Large caverns are now revealed across their full width instead of ending in a wall of fake stone partway across. Walls and corners still block the view, so bases behind them stay hidden. The close-range reveal around you works as before.

New settings in protection.smart-fill:

• reveal-line-of-sight: turn the ray sweep on or off (default true)
• reveal-follow-render-distance: limit the sweep to your render distance (default true)
• reveal-max-distance-cap: hard cap in blocks, 32 to 256 (default 128)
• reveal-sight-budget: max blocks checked per player per second (default 60000)

Other new settings

• replacement.smart-fill.disable-for-bedrock (default true): Bedrock players (Geyser/Floodgate) get plain hiding below void-y instead of Smart Fill. Smart Fill re-sends chunks as players move, and Bedrock shows those re-sends as glitchy chunk reloads. Java players keep Smart Fill. Set this to false to give Bedrock players Smart Fill again.
• performance.max-chunks-per-player-per-tick (default 8, range 1-64): how many chunks one player can be sent per tick on Folia. Lower it if the network is still busy, or raise it if caves take too long to appear.

🧩 Compatibility

• Supports Paper, Folia, Purpur and Spigot, 1.19 – 26.3.
• Spigot support fixed: the plugin used to crash on plain Spigot. It now works there, with these differences:
  • Chunk refreshes use the server's view distance instead of each player's.
  • /fpac stats shows TPS as N/A.
  • Freecam mod detection is turned off, because it needs Paper.
• Requires PacketEvents 2.11.0 or newer. Use the PacketEvents version that matches your Minecraft version (for example 2.14.0+ for 26.3).

⚡ Performance

• Smart Fill no longer slows down the network or raises ping on busy servers. Smart Fill refreshes used to go to every nearby player, not just the one who needed them, so with many players in one area chunk traffic grew far faster than the player count. Each refresh now goes only to the player it's for, on Paper, Spigot and Folia.
• Folia: Smart Fill chunk refreshes are spread over several ticks with a per-player limit, instead of being sent in one large burst.
• Smart Fill remembers which chunks were sent to each player with hidden blocks in them, and only re-sends a chunk when the player has moved or turned enough to reveal something new. These records are cleared when a chunk unloads on the client, and on respawn, world change, quit, or when Smart Fill turns off for the player.
• Chunks already waiting to be refreshed are no longer queued again, which lowers server and network load.
• performance.max-chunks-per-tick is now actually used.
• Paper/Folia: entities are removed from the plugin's internal cache the moment they leave the world, instead of every world being scanned every 60 seconds. Spigot still uses the periodic scan.
• If your server doesn't support per-player chunk sending, the plugin logs one warning and goes back to the old method.

🐛 Bug fixes

Chunks & terrain

• Fixed players sometimes seeing a gap of missing chunks while mining underground with Smart Fill disabled. Walking into it froze the player and made the screen glitch until a relog or /fpac reload.
  • Chunks that were hidden while near the surface are now always restored once protection turns off. Any that slip through are repaired automatically within about a second.
  • Chunk refresh requests are no longer dropped when protection switches on and off quickly (most noticeable on Folia).
• Fixed some caves staying hidden in large caverns. When too many newly visible chunks appeared at once, the extras were skipped and never updated. They're now refreshed over the next few seconds.

Bedrock (Geyser/Floodgate)

• Fixed chunks constantly reloading every 1–2 seconds when Smart Fill was enabled. The world would flash between empty ground and half-loaded terrain with floating trees.
• Fixed chunks sometimes not loading at all. Too many chunks were re-sent at once and Bedrock clients dropped some of them. Smart Fill updates are now rate-limited for Bedrock players, and refreshes never go beyond their view distance.
• Fixed outdated chunks at the edge of Bedrock players' view. The outermost ring of chunks is now refreshed properly when protection changes.
• Fixed Bedrock detection breaking after /fpac reload.
• Clearer startup message when Geyser/Floodgate isn't found. If Geyser runs on a proxy (BungeeCord/Velocity), install Floodgate on the backend server too so Bedrock players are recognised.

Mobs & entities

• Fixed mobs sometimes being invisible while still attacking (creepers exploding, skeletons shooting, zombies hitting with nothing visible). Seen mostly on Folia.
  • Mobs whose spawn was hidden because they spawned below void-y are sent to the player again once they move somewhere that shouldn't be hidden.
  • Mobs hidden while underground are shown again as soon as they leave the hidden zone, instead of staying hidden until the player's own protection state changed.
  • Mobs inside hidden underground areas stay hidden, so base protection works the same as before.
• Entity Hider: minecarts, boats and chest/hopper/TNT/furnace/spawner minecarts placed underground were never hidden. They are now.
• Fixed entities staying hidden after turning hide-entities off and reloading.

Folia

• Fixed the Thread failed main thread check: Accessing entity state off owning region's thread error that appeared in console every 60 seconds during cache cleanup. Each entity is now checked on the thread that owns it.
• Showing or hiding a mob in a different region no longer throws an error and stops the remaining mobs from being shown. Those mobs are retried on the next check.
• Fixed a scheduling error that could stop chunk refreshes for a player until they relogged.

Other

• Sounds, particles and mob/item spawns in hidden areas now follow pie-chart-protection and Smart Fill's reveal, so you can hear and see them in your own cave again.
• Fixed some block sounds being hidden or shown based on the wrong position.
• pie-chart-protection: false now also stops hiding chest/sign/spawner data.
• Raycast no longer turns off Smart Fill's look-direction reveal.
• Fixed freeze detection never triggering.
• Smart Fill reveal settings now load on startup instead of only after a reload.

🧹 Config & cleanup

• config.yml is reorganized, with shorter and clearer comments.
• Removed the protection.raycast section. It now uses fixed, tuned values.
• Removed the unused folia-optimizations option.
• Freecam detection's translation keys are now built in.
• Removed the unused /fpac freecamtest command. Automatic Freecam detection on join is unchanged.

📝 Notes

• Your config updates automatically to version 5.3. New settings are added, removed keys are deleted, and your other values stay the same.
• For the new clean comments, delete plugins/FPAntiFreeCam/config.yml and let it regenerate.
• Bedrock players may see hidden caves turn into real blocks a few seconds later than Java players. Java players aren't affected.