Phantom

Phantom is a lightweight Anti-Freecam and Anti-Xray plugin that keeps your world secure by hiding what players should never see. It uses raytrace based entity filtering to make anything behind walls invisible to cheaters, raytrace ore protection that prevents Xray clients from revealing valuable blocks, and a Y-Level World Hiding system that keeps everything below y 0 fully concealed until a player legitimately goes down there. It runs quietly in the background, stays performant, and makes your server feel clean and fair for everyone.

Y-Level World Hiding

Raytrace Entity Hiding

Raytrace Anti-Xray

Default Configuration

# Phantom Configuration

# Worlds where Phantom is enabled
worlds:
  - world
  - world_nether
  - world_the_end

# Raytrace antixray options - tune carefully before enabling in production
raytrace-anti-xray:
  enabled: true
  # Blocks to hide from players until visible via ray tracing / exposure (Enable Paper AntiXray Engine Mode 1 first for best results)
  hidden-blocks:
    - DIAMOND_ORE
    - DEEPSLATE_DIAMOND_ORE
    - IRON_ORE
    - DEEPSLATE_IRON_ORE
    - GOLD_ORE
    - DEEPSLATE_GOLD_ORE
    - EMERALD_ORE
    - DEEPSLATE_EMERALD_ORE
    - COAL_ORE
    - DEEPSLATE_COAL_ORE
    - LAPIS_ORE
    - DEEPSLATE_LAPIS_ORE
    - COPPER_ORE
    - DEEPSLATE_COPPER_ORE
    - REDSTONE_ORE
    - DEEPSLATE_REDSTONE_ORE
    - NETHER_QUARTZ_ORE
    - NETHER_GOLD_ORE
    - ANCIENT_DEBRIS
    - CHEST
    - SPAWNER
    - CAVE_AIR
  # Block used to mask hidden ores client-side if there are no valid blocks below to replace
  mask-block: STONE
  # Maximum ray-trace distance from player eyes when determining visibility
  max-ray-distance: 128.0
  # Whether to consider only direct line-of-sight (true) or allow limited diffusion in caves (false)
  strict-line-of-sight: false
  # How often to re-evaluate visibility around each player (in ticks)
  update-interval-ticks: 10
  # Horizontal/vertical radius (in blocks) around each player to scan for hidden ores
  scan-radius: 128
  # If true, hidden ores will only be revealed if they are exposed to air. It is recommended to enable Paper AntiXray Engine Mode 1 for best results.
  require-air-exposure: true
  # Maximum number of ore blocks processed per player per tick when scanning (helps with low TPS)
  max-blocks-per-tick: 1024

# Y-level hiding options
y-level-hiding:
  enabled: true
  # Y-level below which blocks are hidden
  y-threshold: 0
  # Y-level that the player has to be to reveal the blocks below y-threshold
  reveal-y: 16
  # Block used to mask the y level
  mask-block: DEEPSLATE
  # Chunk radius (in chunks) around each player to reveal
  refresh-chunk-radius: 4

# Raytrace entity hiding options
raytrace-entity-hiding:
  enabled: true
  max-ray-distance: 64.0
  scan-radius: 64
  max-entities-per-tick: 64
  excluded-entities:
    - ENDER_DRAGON

# Debug options
debug:
  log-packet-handling: false
  show-rays: false