Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
AntiXRay — High-Performance Raytrace Anti-XRay
Stop X-Ray cheaters without killing your server performance.
AntiXRay uses a DDA raytracing algorithm to check, for every block, whether an ore is actually visible to the player. If there's no clear line of sight, the client is sent plain stone instead — so X-Ray clients have nothing real left to render.
Features
- Three engine modes —
RAYTRACE(most secure),PROXIMITY(fastest),HYBRID(best balance, recommended) - Multi-ray DDA raytracing with configurable step count (accuracy vs. performance)
- Asynchronous, multithreaded processing via a work-stealing thread pool that scales automatically with your CPU
- Lock-free TTL cache to avoid unnecessary recalculations
- TPS guard — automatically reduces load during server lag
- Built-in X-Ray detection — sliding-window analysis of ore-mining patterns with configurable thresholds per ore type
- Notifications via console, staff chat, log file, or custom commands
- Per-world configuration — independent modes, replacement blocks, and enable/disable per world
- Full support for 1.16 – 26.1.x, including deepslate ores, Ancient Debris, Trial Spawners, and Vaults
- Folia-compatible out of the box
- Bypass permission for staff and creative-mode players
Requirements
| Requirement | Details |
|---|---|
| Java | 17+ |
| Minecraft | 1.16 – 26.1.x |
| Server Software | Bukkit / Spigot / Paper / Purpur / Folia |
| Dependency | ProtocolLib (required — please use the latest version) |
Installation
- Make sure ProtocolLib is installed on your server.
- Drop
AntiXRay-2.0.0.jarinto yourplugins/folder. - Restart the server —
config.ymlwill be generated automatically. - Adjust the settings to fit your server size, then run
/axr reload.
Commands & Permissions
| Command | Description |
|---|---|
/axr reload |
Reload the configuration without a restart |
/axr status |
Show engine status and statistics |
/axr debug |
Toggle/view debug mode |
/axr bypasslist |
Show players with bypass permission |
| Permission | Default | Description |
|---|---|---|
antixray.admin |
op | Access to all admin commands |
antixray.bypass |
false | Bypass block obfuscation |
antixray.notify |
op | Receive X-Ray detection notifications |
Recommended Presets
| Server Size | ray_steps | cache_ttl_ticks | async_processing |
|---|---|---|---|
| Small (<50) | 16 | 2 | true |
| Medium (50–200) | 12 | 4 | true |
| Large (200+) | 8 | 8 | true |
| Budget VPS | 4 | 10 | false |
License
MIT — free to use and modify.
