Phantom

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： folia paper

标签： game-mechanics management

Phantom

Phantom is an advanced anti-xray plugin for Paper and Folia servers. It hides underground terrain, entities, dungeons, mineshafts, and other valuable information until players legitimately explore the area.

Instead of only replacing individual ores, Phantom conceals deeper terrain and reveals it naturally as players travel underground. This makes cave-finder, freecam, and underground structure exploits far less useful while keeping normal gameplay smooth.

Features

• Hides underground terrain from players above the configured reveal level
• Reveals caves and tunnels naturally as players explore
• Conceals dungeon and mineshaft spawner rooms
• Hides underground entities until they should become visible
• Per-world enable and disable lists
• Configurable replacement block
• Optional permission bypass
• Geyser/Floodgate player support
• In-game administration GUI and commands
• Paper and Folia support
• Performance controls for larger servers

Recommended Paper Anti-Xray Setup

For the best protection, use Phantom alongside Paper’s built-in anti-xray with Engine Mode 2 enabled.

Paper Engine Mode 2 handles ore obfuscation throughout the world, while Phantom adds deeper terrain, structure, entity, and exploration-based protection. Using both provides much stronger coverage than either system alone.

Installation

1. Download Phantom-1.1.0.jar.
2. Place it in your server’s plugins folder.
3. Restart the server.
4. Configure Phantom in plugins/Phantom/config.yml.
5. Use /phantom status to confirm protection is active.

Phantom requires PacketEvents. If PacketEvents is not already installed, Phantom will attempt to install the required version.

Commands

• /phantom — Open the control panel
• /phantom status — View the current protection status
• /phantom toggle — Toggle protection
• /phantom on — Enable protection
• /phantom off — Pause protection
• /phantom reload — Reload the configuration
• /phantom refresh <player> — Refresh a player’s terrain
• /phantom refreshall — Refresh all online players
• /phantom check [player] — Inspect a player’s protection state
• /phantom worlds — View configured worlds
• /phantom scan — Scan loaded worlds
• /phantom version — Show the installed version

Permissions

• phantom.admin — Access all Phantom commands and the control panel
• phantom.bypass — Bypass protection when bypass access is enabled

Default Configuration

# Phantom — anti-xray protection
# Toggle everything without unloading the plugin.
enabled: true

# ---------------------------------------------------------------------------
# Depth (block Y)
# ---------------------------------------------------------------------------
# Terrain at or below this Y is replaced with the fill block for protected clients.
mask-y: 16
# Players at or below this Y are treated as "revealed" (no depth obfuscation).
# Should usually be at or above mask-y.
clear-y: 24

# ---------------------------------------------------------------------------
# Worlds
# ---------------------------------------------------------------------------
worlds:
  # Worlds where Phantom protection is enabled. At least one world is required.
  enabled:
    - world
  # Worlds where Phantom protection is always disabled (even if also listed under enabled).
  disabled:
    - world_nether
    - world_the_end
    - spawn

# ---------------------------------------------------------------------------
# Access
# ---------------------------------------------------------------------------
access:
  # When true, players with phantom.bypass skip protection.
  allow-bypass: true
  # Skip Geyser/Floodgate players (UUID starts with 000000).
  skip-bedrock-players: false

# ---------------------------------------------------------------------------
# Fill (what hidden terrain looks like)
# ---------------------------------------------------------------------------
fill:
  enabled: true
  # Any solid block material name (e.g. DEEPSLATE, STONE, NETHERRACK).
  block: DEEPSLATE

# ---------------------------------------------------------------------------
# Structures
# ---------------------------------------------------------------------------
structures:
  dungeons:
    enabled: true
    # Resend a dungeon room when the player is this close (blocks).
    reveal-distance: 6
    # Nearby cobblestone/mossy cobblestone required to treat a spawner as a vanilla dungeon.
    min-cobblestone: 5
    # Helps avoid hiding custom spawner builds. Set 0 to only require cobblestone/chests.
    min-mossy-cobblestone: 2

  mineshafts:
    enabled: true
    # Resend a mineshaft spawner room when the player is this close (blocks).
    reveal-distance: 6
    # Hide spawner rooms that have at least this many nearby cobwebs.
    min-cobwebs: 6

# ---------------------------------------------------------------------------
# Reveal (ray-based cave / tunnel visibility)
# ---------------------------------------------------------------------------
reveal:
  # How often (in ticks) to re-evaluate visibility for online players.
  check-every-ticks: 2
  # When true, chunks that leave the reveal area are hidden again for that player.
  # When false, once revealed they stay visible for the session.
  rehide-when-leaving: false
  # Skip redundant reveal work when the player barely moved.
  optimized-movement: true
  # Base number of rays cast for cave visibility (higher = denser, more CPU).
  ray-count: 48
  # Extra chunks beyond the calculated radius to keep visible.
  extra-chunk-radius: 2
  # Hard ceiling on reveal radius in chunks.
  max-chunk-radius: 3

  # Continuously re-send nearby chunks while a player is underground.
  continuous:
    enabled: true
    radius: 3
    # Max chunks queued for resend per player per tick (higher = faster catch-up, more bandwidth).
    max-chunks-per-tick: 150
    # Soft cap on total revealed chunks tracked per player (0 = unlimited).
    total-limit: 0

# ---------------------------------------------------------------------------
# Performance
# ---------------------------------------------------------------------------
performance:
  # Prefer handling packet work off the main server thread when possible.
  # Disable only if you hit async-related errors.
  async-packets: true
  # Background worker threads for obfuscation/reveal work.
  worker-threads: 2

Compatibility

• Paper
• Folia
• Minecraft 1.21.x
• Java 21
• PacketEvents 2.11.2

For the strongest anti-xray setup, combine Phantom with Paper Anti-Xray Engine Mode 2.