VoltrazAntiEsp - Block X-Ray & FreeCam

VoltrazAntiEsp — The Ultimate 2-in-1 Security Solution
Secure your server from ESP and X-ray hackers with zero lag. Native Folia support included!

▸ Overview
Most anti-cheats only focus on blocking X-ray, leaving underground bases and hidden entities completely vulnerable to ESP (Extra Sensory Perception) hacks. VoltrazAntiEsp is a packet-level, high-performance security engine that stops both. It completely erases hidden entities and underground chunks from the client's memory until they are actually visible.

▸ Optimized for 200+ Players
We know that anti-cheats can cause massive TPS drops. That's why VoltrazAntiEsp is heavily optimized to run on large servers with hundreds of players without breaking a sweat.

Check out our Spark Profiler results below:

Zero Main-Thread Impact: All checks are handled asynchronously via Netty I/O threads.
O(1) Eviction Algorithms: Constant-time data cleanup ensures CPU usage stays extremely low.
ThreadLocal Buffer Pooling: Eliminates memory leaks and prevents GC (Garbage Collection) spikes.

▸ Features

Advanced Anti-ESP Engine

Entity Hiding: Mobs, players, and item drops below a configurable Y-level are completely hidden from ESP users.
Chunk Clearing: Underground structures and bases are wiped from chunk packets, making them invisible to freecam/cave-finders.
Smart Re-reveal: Entities are smoothly spawned back when they move above the hidden Y-level limit.

Multi-Threaded Anti-Xray

Async Ray-Tracing: Ore visibility is calculated asynchronously on a dedicated thread pool.
Engine Modes: Supports both HIDE (replace with stone) and OBFUSCATE (fake random ores) modes.
Block Entity Safety: Safely bypasses block entities (Chests, Spawners) to prevent NBT data corruption.

Enterprise Performance (Folia Native)

Netty Pipeline Interception: Does not use heavy Bukkit events. Checks are done at the I/O packet level.
Folia Ready: 100% compatible with Folia's region-threaded scheduling out of the box. No external API dependencies required!

▸ Commands & Permissions

VoltrazAntiEsp runs completely passively in the background. There are no player commands needed.

Administrator Commands
Base Command: /voltrazantiesp (Aliases: /vae, /antiesp)

/vae reload
Permission: voltrazantiesp.admin
Reloads the config.yml instantly without restarting your server. Engineered to be 100% thread-safe (via atomic volatile swaps), meaning you can reload it while 200+ players are online without causing a single TPS drop.
/vae debug
Permission: voltrazantiesp.admin
Toggles debug mode in the console to monitor packet interception.
/vae timings
Permission: voltrazantiesp.admin
Displays performance metrics to monitor how much time the ray-tracing engine takes per chunk.

Staff & Bypass Permissions
Give these permissions to your Admins, Moderators, or Spectators. Anyone with these permissions will receive unmodified, clear chunk data. This is crucial so your staff members can spectate suspected cheaters clearly without the anti-cheat hiding underground bases or entities from their own view!

voltrazantiesp.bypass — Bypasses the Anti-ESP entity & block hiding system.
paper.antixray.bypass — Native bypass for the ray-trace ore obfuscation.

▸ Configuration
The plugin is completely plug-and-play, but offers extensive per-world customization.

YAML:

# ╔══════════════════════════════════════════════════════════════════╗
# ║                    VoltrazAntiEsp Configuration                 ║
# ║                                                                 ║
# ║  Anti-ESP + Anti-Xray + Entity Hider for Paper 1.21+            ║
# ║  Created by RevelX                                              ║
# ╚══════════════════════════════════════════════════════════════════╝
#
# Prerequisite: Paper anti-xray engine-mode: 1 (HIDE)
#   → Set in paper-world-defaults.yml → anticheat → anti-xray
#
# ────────────────────────────────────────────────────────────────────
# QUICK TUNING GUIDE (by server size)
# ────────────────────────────────────────────────────────────────────
#
#  Setting                        50 players   150 players   300 players
#  ─────────────────────────────  ──────────   ───────────   ───────────
#  ray-trace-threads              2            2-3           4
#  ms-per-ray-trace-tick          50ms         100-150ms     150-200ms
#  update-ticks                   1            2-3           3
#  ray-trace-distance             48.0         32.0          32.0
#  max-ray-trace-block-count      2048         1024          1024
#  chunks-per-tick                25           10            5
#
# ────────────────────────────────────────────────────────────────────
# Internal version. Do NOT change — used for auto-merging new keys on updates.
config-version: 5

# ═══════════════════════════════════════════════════════════════════
#  GLOBAL SETTINGS
# ═══════════════════════════════════════════════════════════════════
settings:
  # ── Engine ─────────────────────────────────────────────────────
  # Number of worker threads for ray-trace calculations.
  # Set to 0 for auto-detect (half of available CPU cores).
  # Shared hosting: keep at 2. Dedicated: 3-4.
  ray-trace-threads: 2
  # Milliseconds between ray-trace ticks.
  # Lower  = faster block reveal, higher CPU
  # Higher = slower block reveal, lower  CPU
  # Recommended: 50-100ms (small), 100-150ms (medium), 150-200ms (large)
  ms-per-ray-trace-tick: 150
  # Server ticks between main-thread result processing (1 tick = 50ms).
  # 1 = smoothest reveal, most main-thread time
  # 3 = good balance for 150+ players
  update-ticks: 3
  # ── Rehide Behavior ────────────────────────────────────────────
  # Delay (ms) before rehiding blocks after a player looks away.
  #   0    = instant rehide (most secure, highest bandwidth)
  #   2000 = 2s delay (recommended for 150+ players)
  rehide-delay-ms: 2000
  # Minimum time (ms) a block stays revealed before it can be rehidden.
  # Prevents exploit: rapid place/break to trigger reveal/rehide cycles.
  # Minimum enforced: 1000ms. Set to 0 to disable.
  rehide-cooldown-ms: 5000
  # ── World Filter ───────────────────────────────────────────────
  # Worlds where ALL VoltrazAntiEsp features are completely disabled.
  # Players in these worlds have no anti-xray, anti-esp, or entity hiding.
  blacklisted-worlds:
    - world_lobby
    - world_event
  # ── Debug ──────────────────────────────────────────────────────
  # Enable verbose debug logging. Only enable for troubleshooting.
  debug: false

# ═══════════════════════════════════════════════════════════════════
#  PER-WORLD SETTINGS
# ═══════════════════════════════════════════════════════════════════
#
# Each world falls back to "default" if no world-specific override exists.
# To override a specific world, add a section with the world name:
#
#   world_nether:
#     anti-esp:
#       hide-level: 100
#     anti-xray:
#       ray-trace-distance: 48.0
#
world-settings:
  default:
    # ─────────────────────────────────────────────────────────────
    #  ANTI-ESP (Section Hiding)
    # ─────────────────────────────────────────────────────────────
    # Hides entire chunk sections below a Y-level from players above it.
    # Prevents ESP clients from seeing underground structures.
    anti-esp:
      # Enable anti-ESP section hiding for this world.
      enabled: true
      # Y-level threshold: players ABOVE this level cannot see sections BELOW it.
      #  -20 = hides deep mining area only (Y -64 to -20), low CPU cost
      #    0 = hides everything below sea level
      #   35 = hides most underground (higher = more chunk resends)
      hide-level: -20
      # Style to use when hiding sections below hide-level.
      #   DEEPSLATE = fills hidden sections with solid deepslate (highly secure, blocks ESP lines/freecam)
      #   AIR       = clears hidden sections to air (original behavior)
      hide-style: DEEPSLATE
      # System for revealing sections below hide-level when player is underground:
      #   NEW = (Default) dynamically hides/reveals sections below hide-level based on reveal-radius or BFS.
      #         Prevents ESP/freecam chest bypass even when player is underground.
      #   OLD = completely reveals all sections below hide-level as soon as the player goes below hide-level.
      reveal-system: NEW
      # Only reveal chunks within this radius (in chunks) around the player when they are below hide-level.
      # Outside this radius, chunks remain hidden/filled with deepslate.
      # Set to 0 to disable (reveal all loaded chunks below hide-level).
      # Recommended: 1 or 2
      reveal-radius: 2
      # Re-hide chunks that leave the reveal-radius as the player moves below hide-level.
      #   true  = higher security (hides chunks as player walks away)
      #   false = better performance (chunks stay revealed once visited)
      rehide-distant-chunks: true
      # Re-hide chunk sections below hide-level when a player ascends ABOVE it.
      #   true  = chunks below hide-level get ESP-cleared again when player
      #           goes up (default, most secure)
      #   false = once revealed (player went below), chunks stay visible and
      #           ALL hide-level protections are disabled for that player
      #           (block updates, entities, sounds pass through normally).
      #           Resets on disconnect or chunk unload.
      rehide-on-ascend: true
      # Chunks resent per tick when a player crosses hide-level going downward.
      # Lower = less bandwidth spike, slower reveal
      # Higher = faster reveal, risk of bandwidth spike with many players
      #   10 = ~2.2s full reveal (smooth for shared hosting)
      #   25 = ~0.9s reveal (high bandwidth, dedicated servers only)
      chunks-per-tick: 10
      # ── Entity Hiding ──────────────────────────────────────────
      # Hide entities below hide-level from players above it.
      # Prevents ESP clients from scanning for entity clusters (bases, farms).
      hide-entities: true
      # Entity types to hide (Minecraft registry names, lowercase).
      # Only these types are suppressed — all others pass through normally.
      hidden-entity-types:
        # Minecarts (reveal farm layouts)
        - minecart
        - chest_minecart
        - hopper_minecart
        - furnace_minecart
        # Display entities (reveal base locations)
        - item_frame
        - glow_item_frame
        - armor_stand
        # Farm entities
        - villager
    # ─────────────────────────────────────────────────────────────
    #  ANTI-XRAY (Ray-Trace Block Reveal)
    # ─────────────────────────────────────────────────────────────
    # Uses ray-tracing to reveal hidden blocks only when visible to the player.
    # Requires Paper anti-xray engine-mode: 1 (HIDE) to be active.
    anti-xray:
      # Which engine to use for Anti-Xray/Anti-ESP?
      #   RAYTRACE = Mendeteksi visibilitas dari titik mata pemain ke setiap block chest/ore (Original)
      #   BFS      = Mencari jalur udara. Sangat cocok untuk menyembunyikan "Secret Base" secara total.
      engine-mode: RAYTRACE
      # ── Ray-Trace Engine ───────────────────────────────────────
      # Support third-person camera angles. Adds ~50% more ray-traces per player.
      ray-trace-third-person: false
      # Maximum ray-trace distance in blocks.
      # THIS is the biggest CPU tuning knob.
      #   32 = 2 chunks — optimal for large servers, saves ~40% CPU vs 48
      #   48 = 3 chunks — covers normal gameplay visibility
      #   64 = 4 chunks — hardcore anti-cheat, high CPU cost
      ray-trace-distance: 32.0
      # Where on the target block the ray aims at.
      #   center       = ray to block center (0.5, 0.5, 0.5)
      #                  Strongest protection. Some surface-attached blocks
      #                  (redstone, torches) may not reveal correctly.
      #   nearest-face = ray to nearest point on block surface
      #                  More accurate for surface-attached blocks,
      #                  slightly weaker protection on 1-thick walls.
      ray-trace-target: center
      # Strict block occlusion: any solid block on ray path = fully hidden.
      #   true  = blocks behind 1-thick stone walls stay hidden
      #           (stricter, may cause false-positive rehides)
      #   false = rays can "leak" through block corners
      #           (more accurate visibility, fewer false rehides)
      strict-block-occlusion: false
      # Maximum blocks per chunk tracked by ray-tracing.
      # Prevents lag spikes in ore-dense chunks.
      #   1024 = strict limit, safe for shared CPU
      #   2048 = moderate, good for dedicated servers
      #   4096 = lenient, only if CPU is not a concern
      max-ray-trace-block-count-per-chunk: 1024
      # ── Rehide ─────────────────────────────────────────────────
      # Re-hide blocks after the player looks away from them.
      # Note: If engine-mode is BFS, this will be automatically forced to FALSE.
      rehide-blocks: true
      # Distance for rehide checks (should match ray-trace-distance).
      rehide-distance: 32.0
      # ── Tracked Blocks ─────────────────────────────────────────
      # Blocks that trigger ray-trace tracking.
      # IMPORTANT: These MUST also be in Paper's hidden-blocks list to work!
      # Empty list = same as Paper hidden-blocks.
      ray-trace-blocks:
        # Storage
        - minecraft:chest
        - minecraft:trapped_chest
        - minecraft:barrel
        - minecraft:shulker_box
        - minecraft:white_shulker_box
        - minecraft:orange_shulker_box
        - minecraft:magenta_shulker_box
        - minecraft:light_blue_shulker_box
        - minecraft:yellow_shulker_box
        - minecraft:lime_shulker_box
        - minecraft:pink_shulker_box
        - minecraft:gray_shulker_box
        - minecraft:light_gray_shulker_box
        - minecraft:cyan_shulker_box
        - minecraft:purple_shulker_box
        - minecraft:blue_shulker_box
        - minecraft:brown_shulker_box
        - minecraft:green_shulker_box
        - minecraft:red_shulker_box
        - minecraft:black_shulker_box
        - minecraft:ender_chest
        # Utility
        - minecraft:furnace
        - minecraft:blast_furnace
        - minecraft:smoker
        - minecraft:crafting_table
        - minecraft:anvil
        - minecraft:chipped_anvil
        - minecraft:damaged_anvil
        - minecraft:enchanting_table
        - minecraft:brewing_stand
        - minecraft:beacon
        # Redstone
        - minecraft:hopper
        - minecraft:dropper
        - minecraft:dispenser
        - minecraft:crafter
        - minecraft:piston
        - minecraft:sticky_piston
        - minecraft:observer
        - minecraft:comparator
        - minecraft:repeater
        - minecraft:redstone_wire
        - minecraft:redstone_torch
        - minecraft:redstone_wall_torch
        - minecraft:redstone_block
        - minecraft:redstone_lamp
        # Valuables
        - minecraft:spawner
        - minecraft:trial_spawner
        - minecraft:vault
      # ── Bypass Rehide ──────────────────────────────────────────
      # Blocks that stay revealed once visible (until chunk unloads).
      # Use for blocks players interact with — rehiding causes visual glitches.
      bypass-rehide-blocks:
        # Storage
        - minecraft:chest
        - minecraft:trapped_chest
        - minecraft:barrel
        - minecraft:shulker_box
        - minecraft:white_shulker_box
        - minecraft:orange_shulker_box
        - minecraft:magenta_shulker_box
        - minecraft:light_blue_shulker_box
        - minecraft:yellow_shulker_box
        - minecraft:lime_shulker_box
        - minecraft:pink_shulker_box
        - minecraft:gray_shulker_box
        - minecraft:light_gray_shulker_box
        - minecraft:cyan_shulker_box
        - minecraft:purple_shulker_box
        - minecraft:blue_shulker_box
        - minecraft:brown_shulker_box
        - minecraft:green_shulker_box
        - minecraft:red_shulker_box
        - minecraft:black_shulker_box
        - minecraft:ender_chest
        # Utility
        - minecraft:furnace
        - minecraft:blast_furnace
        - minecraft:smoker
        - minecraft:crafting_table
        - minecraft:anvil
        - minecraft:chipped_anvil
        - minecraft:damaged_anvil
        - minecraft:enchanting_table
        - minecraft:brewing_stand
        - minecraft:beacon
        # Redstone
        - minecraft:hopper
        - minecraft:dropper
        - minecraft:dispenser
        - minecraft:crafter
  # ── World Override Examples ──────────────────────────────────────
  # Uncomment and customize for world-specific settings.
  # Any key not specified falls back to the "default" section above.
  #
  # world_nether:
  #   anti-esp:
  #     enabled: true
  #     hide-level: 100
  #   anti-xray:
  #     ray-trace: true
  #     ray-trace-distance: 48.0
  #
  # world_the_end:
  #   anti-esp:
  #     enabled: false
  #   anti-xray:
  #     ray-trace: false

▸ Compatibility

Minecraft Versions: 1.21 — 1.21.11
Server Software: Paper, Purpur, Leaf, Folia
Java Version: Java 21+

Need Help or Have Questions?
Message me directly on Discord!

VoltrazAntiEsp - Block X-Ray & FreeCam v2.3.5

Overview Updates (8) History