zAntiFreeCam

zAntiFreeCam

Server-side anti-freecam protection for Paper and Folia.

zAntiFreeCam protects underground areas from being exposed through Freecam-style camera movement and underground scouting. It filters outgoing chunk data sent to surface players instead of modifying the actual world.

Protected underground data can be replaced with a configurable solid mask, preventing caves, ores, air pockets, and other underground information from being exposed to surface players.

No client-side mod is required.

Features

• Server-side underground protection
• No client mod required
• Overworld protection
• Configurable protection Y level
• Solid block masking
• Prevents cave layouts from being exposed through AIR and CAVE_AIR
• Configurable mask block
• Optional underground entity hiding
• Optional block entity stripping
• Automatic remasking when returning to the surface
• World exclusions
• Bypass permission
• Debug and diagnostic options
• Performance controls
• Paper and Folia support

How It Works

By default, blocks below Y=16 are protected for players on the surface.

The default protection settings are:

• Hide below Y: 16
• Reveal below Y: 15
• Mask mode: SOLID
• Mask block: STONE
• Block masking: Enabled
• Block entity stripping: Enabled

Protected positions are represented by the configured mask block instead of the real underground data.

This covers underground data such as:

• Ores
• AIR and CAVE_AIR
• Water and lava
• Chests and other block entities
• Underground terrain

The actual world is never modified. The protection only affects data sent to the player's client.

Players who legitimately move underground can receive the real terrain based on their server-side position.

Example Configuration

The following settings represent the recommended default configuration:

• Protection Y: 16
• Reveal Y: 15
• Mask mode: SOLID
• Mask block: STONE
• Mask blocks: Enabled
• Rewrite: Enabled
• Strip block entities: Enabled
• Reveal radius: 4
• Remask on surface: Enabled

World Protection

Protection is designed for the Overworld.

• Overworld: Protected
• Nether: Not masked
• The End: Not masked

Additional world exclusions can also be configured.

Entity Protection

Underground entities can optionally be hidden from surface players.

• Underground entity hiding: Enabled
• Always visible entities: Configurable
• Hidden entity types: Configurable

Performance

zAntiFreeCam includes configurable limits for chunk updates and state checks.

• Maximum updates per tick: 32
• Chunk refresh delay: 150 ms
• Dirty chunk limit: 256
• State check interval: 10 ticks

Permission

zantifreecam.bypass

Allows a player to bypass underground visibility protection.

Commands

• "/zantifreecam"
• "/zantifreecam reload"
• "/zantifreecam bypass"
• "/zantifreecam bypass "
• "/zantifreecam status"

Compatibility

• Paper
• Folia
• Minecraft 26.x
• Java 25

zAntiFreeCam by KingBrezz