Donut-anti-freecam

An advanced anti-cheat plugin that detects and prevents freecam exploits. Monitors player movement patterns, interaction distances, and packet anomalies to identify when players disconnect their camera from their body. Features configurable detection sensitivity, automatic violation handling, bypass permissions, and comprehensive logging. Includes alert system for staff members and customizable punishment actions Detect when a player’s camera position (not player body) goes below a configurable Y level (default Y = 16).

__If the camera goes below that Y level while the player entity remains above it, treat this as freecam behavior.

Only in this case, hide all blocks below the Y level for that player by sending fake air blocks or canceling chunk section packets.

If the player physically moves below the Y level, immediately restore all real blocks and load chunks normally.

Important rules:

Do NOT hide blocks for legitimate players who are actually underground.

Do NOT modify the world or server-side blocks.

Effects must be client-side only.

Configuration:

trigger-y-level: 16

buffer-distance (tolerance so jumping/lag doesn’t trigger false positives)

Per-world enable/disable

Permission bypass: antifreecam.bypass

Detection methods (combine multiple):

Player eye location vs. camera packet movement

Sudden large camera position changes without player movement

Camera entering unloaded or unreachable positions

Performance:

Lightweight packet interception (ProtocolLib or native Paper packet API)

Cache fake chunk sections

No noticeable TPS or ping impact

Commands:

/antifreecam reload

/antifreecam status

Compatibility:

Minecraft 1.18+ (supports negative Y)

Paper recommended

Expected result:

Normal players see the world exactly as vanilla.

Freecam users see nothing but void/air below the configured Y level.

As soon as freecam is disabled or the player moves underground normally, visibility is restored instantly

Plan:

Track player body position vs eye location patterns

Detect stationary players near surface (potential freecam users)

Hide underground blocks only for suspected freecam users

Add per-world config, buffer distance, and proper commands

Restore blocks immediately when players move legitimately

Implementation complete:

✓ Freecam Detection - Tracks stationary players above ground with eye position near/below trigger Y ✓ Client-side Block Hiding - Sends fake AIR blocks only to suspected freecam users ✓ Instant Restoration - Blocks restore when player moves legitimately underground ✓ Per-world Configuration - Enable/disable in specific worlds ✓ Buffer Distance - 3-block tolerance prevents false positives from jumping/lag ✓ Commands - /antifreecam reload, /antifreecam status ✓ Permission Bypass - antifreecam.bypass skips all checks ✓ Performance Optimized - Configurable check intervals, radius limits, client-side only

Detection logic: If player remains stationary above Y=16 for 3+ seconds, underground blocks are hidden. Movement instantly restores visibility. Works for Minecraft 1.18+.__