Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Occlude
Ray traced anti-xray and anti-ESP for Paper and Folia 1.21.1+.
Paper's built-in anti-xray only hides ores that are fully buried, so every ore touching a cave stays visible to x-ray. Occlude hides every configured block the player has no line of sight to and reveals it the moment it comes into view.
Features
- Ores: hidden unless visible from the player's eye. Buried ores are never sent to the client.
- Fake ores: irregular decoy veins inside solid rock, with realistic height distributions per ore. They vanish when someone mines near them.
- Entity culling: entities behind walls are removed from the client, so ESP and tracers see nothing. Players are only culled while sneaking, since name tags show through walls anyway.
- Tile culling: chests, spawners, signs and other block entities are sent as air, along with their NBT, until visible.
- Custom blocks: ItemsAdder and Nexo ids, or any exact block state.
- Per-world config: each world gets its own file, with sensible defaults for the overworld, nether and end.
- In-game menu: toggle features for the current world without touching a file.
Requirements
- Paper, Paper fork or Folia 1.21.1+
- PacketEvents 2.14+
- EnderaLib 1.6+
Disable Paper's own anti-xray in the worlds Occlude handles.
Commands
| Command | Permission | Description |
|---|---|---|
/occlude (/antixray) |
occlude.command |
Settings menu for the current world |
/occlude toggle |
occlude.command.toggle |
Personal x-ray bypass |
/occlude reload |
occlude.command.reload |
Reload all configs |
How it works
Each outgoing chunk is scanned before it reaches the player. Configured blocks are swapped for stone, deepslate or netherrack, and fake veins are added in solid rock. Worker threads then trace rays from the player's eye to every hidden block and tracked entity, and reveal only what is actually in view. Tracing is skipped while the player stands still and nothing around them changes.
Links
Source, config reference and issues: GitHub


