Phantom

# Phantom Phantom is an advanced anti-xray plugin for Paper and Folia servers. It hides underground terrain, ores, containers, entities, dungeons, mineshafts, and other valuable information until players legitimately see that area. Instead of only replacing individual ores, Phantom conceals deeper terrain and reveals it naturally as players travel underground. A ray tracer then shows ores, containers, and entities only when the player has a clear line of sight. This makes cave-finder, freecam, xray, 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 - Ray-traced ore and container hiding — blocks stay hidden until the player’s eye has line of sight - Ray-traced entity hiding — living entities stay hidden until they are actually visible - Conceals dungeon and mineshaft spawner rooms until the player is close - Optional amethyst geode hiding (off by default) - Optional memory of chunks a player has already seen (`remember-visited`, off by default) - Cave decorations like glow lichen and dripstone do not seal tunnels from reveal rays - Per-world enable and disable lists - Configurable replacement block - Optional permission bypass - Optional skip for Geyser/Floodgate players - Existing `config.yml` files keep their values; missing keys are added on load - 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 1** enabled. Paper Engine Mode 1 randomly replaces ores so clients cannot trust raw chunk data. Phantom then adds deeper terrain hiding, ray-traced ore and entity reveal, structure concealment, and exploration-based cave visibility. Using both provides much stronger coverage than either system alone. Do **not** use Paper Engine Mode 2 with Phantom. Phantom already handles per-block ore hiding with line-of-sight reveal. ## Installation 1. Download `Phantom-1.2.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 **2.13.0**. If PacketEvents is not already installed, Phantom will attempt to download and load that version automatically. ## Commands Alias: `/ph` - `/phantom` — Show command help - `/phantom help` — Show command help - `/phantom status` — View the current protection status - `/phantom on` — Enable protection - `/phantom off` — Pause protection - `/phantom reload` — Reload the configuration and resync online players - `/phantom refresh <player>` — Refresh a player’s terrain - `/phantom refreshall` — Refresh all online players - `/phantom check ` — Inspect a player’s protection state - `/phantom worlds` — View configured and loaded worlds - `/phantom version` — Show the installed version ## Permissions - `phantom.admin` — Access all Phantom commands - `phantom.bypass` — Bypass protection when `access.allow-bypass` is true ## Default Configuration ```yaml # 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: dun