Welcome to RayTraceAntiXray
RayTraceAntiXray is a Paper plugin that extends Paper Anti-Xray engine-mode 1 (HIDE). Paper hides buried ores by replacing them with decoy blocks in chunk packets, but ores exposed to air — on cave walls or in open pockets — remain visible. This plugin closes that gap with server-side async ray tracing.
Quick Navigation
Installation
Requirements, Paper Anti-Xray setup, PacketEvents, and first-run steps.
Recommended setup
Copy-paste Paper Anti-Xray and plugin config presets for production.
Configuration
Interactive reference for every config.yml key.
Commands
reload and timings subcommands with permission nodes.
Permissions
Full permission tree for command access.
Features
How ray tracing works, pipeline stages, and limitations.
Troubleshooting
Reload limits, Leaf compatibility, reconnect advice.
Why RayTraceAntiXray?
Paper Anti-Xray engine-mode 1 is effective for blocks not adjacent to air. RayTraceAntiXray adds a second layer: when a chunk is sent to a player, air-exposed ore positions are obfuscated immediately, then asynchronously ray-traced from the player's eye. Only blocks with an unobstructed line of sight are revealed via block-update packets.
For supported versions, block entities (e.g. chests) can be fully hidden — see Paper and plugin release notes.
