Description
Gallery
Changelog
Versions
AntiXrayOP is a high-performance Paper anti-xray plugin focused on stopping xray abuse before it becomes a server problem.
It combines per-player ore obfuscation, fake-ore camouflage, behavior-based scoring, and staff-friendly tooling in one lightweight package.
New in 1.4.0
- Rebuilt the GUI into a cleaner dashboard with dedicated protection, detection, and material-list screens
- Added quick in-game actions for reload, protected-view refresh, and clearing live detection memory
- Fixed GUI edits on older configs so missing keys no longer fall back to broken raw values
- Reduced false positives by scoring only inside the configured detection Y-range
- Player-placed tracked ores now stay visible during runtime and no longer poison suspicion scoring
- Tightened update-check permission handling and improved the local Modrinth release flow
Core Features
- Per-player underground ore obfuscation in loaded chunks
- Real-time refresh after mining, placement, explosions, and movement
- Fake-ore camouflage to waste xray users' time
- Suspicion scoring based on ore ratio, concealed ore hits, and rapid ore chains
- Runtime protection for player-placed ore displays by avoiding live re-hide/re-score of tracked placed ores
- Staff alerts with cooldown protection against spam
- Recent mining history for fast staff review
- Optional auto-escalation commands for repeat offenders
In-Game GUI
Use /antixrayop to manage the plugin without leaving the server:
- Toggle strict-hide-all, camouflage, detection, auto-escalation, and OP bypass
- Tune scan/prune behavior, obfuscation height, decoy settings, alert windows, ratios, bonuses, and escalation thresholds
- Run quick reload / refresh / clear-memory actions directly from the dashboard
- Edit hidden ores, fake ore decoys, and valid base blocks in separate list editors
Commands
/antixray status [player]/antixray recent [player] [limit]/antixray top [limit]/antixray reload/antixray clear <player|all>/antixray toggle <player>/antixray refresh <player|all>/antixrayop
Permissions
antixrayop.adminantixrayop.guiantixrayop.alertantixrayop.bypass
Preview
Compatibility
- Java 21 build target
- Paper / Purpur / Folia / Spigot / Bukkit loaders listed on this page
- Minecraft 1.20+ server support listed in versions
Searching for a minecraft host? Look down
Direct link: https://billing.sparkedhost.com/aff.php?aff=3214
All Versions
+ Add Version
[2.0.0] AntiXrayOP 2.0.0
by perusi on Oct 15, 2026
Download
- Huge v2.0 Update!**: Introduced the **Explosive Baits** system!
- Troll Hackers**: Fake decoy ores now have a configurable chance to explode instantly when a hacker breaks them, killing them on the spot and broadcasting a shameful global message to the server!
[1.4.4] AntiXrayOP 1.4.4
by perusi on Oct 15, 2026
Download
- Critical Security Fix**: Fixed an exploit where typing
/reloadon the server would leave all currently online players completely unprotected by the anti-xray obfuscation until they logged out or changed worlds. The plugin now properly re-applies obfuscation to all online players upon server reload.
[1.4.3] AntiXrayOP 1.4.3
by perusi on Oct 15, 2026
Download
- Critical Exploit Fix**: Fixed a serious GUI exploit in
/antixray topwhere players could click and steal the player head items from the inventory, essentially allowing item duplication. - Performance**: Removed deprecated task scheduler API calls to improve stability on Paper 1.20+ servers.
[1.4.2] AntiXrayOP 1.4.2
by perusi on Oct 15, 2026
Download
- Performance**: Fixed a massive CPU spike caused by TNT explosions triggering hundreds of duplicate chunk rescans.
- Memory Leak Fix**: Player data is now properly cleared when a player quits the server.
- Memory Leak Fix**: Tracked placed blocks are now properly removed from chunk memory (PDC) when destroyed by explosions.
- Optimization**: The plugin now only tracks explicitly hidden materials in PDC, dramatically saving chunk memory over time.
[1.4.1] AntiXrayOP 1.4.1
by perusi on Oct 15, 2026
Download
- Discord Alerts**: Added Discord webhook alerts for Xray detections.
- Auto-Punish**: Added an automatic punish system configuration.
- Fix**: Improved tracking logic for player-placed ores using PersistentDataContainer.
- Update**: Massively improved /antixray top with an interactive Inventory GUI.
[1.4.0] v1.4.0
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.4.0
- Rebuilt the in-game GUI into a real dashboard with dedicated protection, detection, and material-list screens plus quick actions for reload, refresh, and memory clear.
- Fixed GUI editing on older
config.ymlfiles so missing keys now use the live loaded defaults instead of snapping to wrong raw values. - Reduced false positives by only scoring mining inside the configured detection Y-range and by ignoring player-placed tracked ores at runtime.
- Stopped hiding tracked player-placed ores during runtime, which keeps decorative/admin-placed ore blocks visible instead of turning them into fake anti-xray targets.
- Updated the Modrinth checker to respect the configured admin permission consistently and refreshed its scheduling/link handling.
- Improved the local Modrinth release script with icon auto-detection and a one-shot
release-updateaction for existing projects.
[1.3.0] v1.3.0
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.3.0
- Added
/antixray recent [player] [limit]to inspect recent ore hits from the active detection window. - Added optional auto-escalation with configurable console commands and placeholders such as
%player%,%score%,%ratio%,%y%, and%world%. - Expanded the in-game GUI with controls for alert cooldown, escalation toggle, score threshold, alert count, and escalation cooldown.
- Fixed GUI access to respect
antixrayop.guiinstead of requiring hardcoded OP status. - Refreshed project metadata and release notes for the new detection/escalation workflow.
[1.2.2] AntiXrayOP 1.2.2
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.2.2
- Updated plugin metadata description to mention fake ores + GUI.
[1.2.1] AntiXrayOP 1.2.1
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.2.1
- GUI: changing
hidden-materialsnow also refreshes obfuscation immediately (applies on the spot).
[1.2.0] AntiXrayOP 1.2.0
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.2.0
- Added in-game configuration GUI:
/antixrayop(OP only). - GUI edits apply instantly (saves config + reloads + refreshes obfuscation).
- Configure fake-ore camouflage directly from the GUI:
- Toggle
strict-hide-all,camouflage.enabled,detection.enabled. - Adjust
scan-radius,camouflage.decoy-chance-percent,camouflage.max-per-chunk,change-rescan-chunk-radius. - Edit lists:
camouflage.base-materials,camouflage.decoy-materials,hidden-materials.
[1.1.1] AntiXrayOP 1.1.1
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.1.1
- Added configurable fake-ore camouflage:
camouflage.base-materials(what blocks can be swapped client-side)camouflage.decoy-materials(what ores to use as decoys; defaults tohidden-materials)- Default
camouflage.base-materialsnow includesCOBBLESTONEandCOBBLED_DEEPSLATE. - Update checker now respects
admin-permissionfrom config (no longer hard-coded).
[1.1.0] AntiXrayOP 1.1.0
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.1.0
- Reworked underground obfuscation to hide ores more aggressively and add low-rate decoy camouflage while strict-hide-all is enabled.
- Added concealed-ore aware xray detection with weighted scoring for rare ores, rapid ore chains, and previously hidden ore hits.
- Expanded /antixray status and /antixray top with suspicion score, concealed ore hits, and weighted ore statistics for staff review.
- Added new config controls for camouflage and detection thresholds so the anti-xray system can be tuned per server.
- Updated the build metadata for this release line and packaged the new 1.1.0 jar.
[1.0.4] AntiXrayOP 1.0.4
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.0.4
- Fixed Modrinth update notifier links to use slug/version-number format for reliable direct download pages.
- Removed fragile version-ID URL usage and added robust fallback to the versions page.
- Maintenance release focused on update-checker stability across server joins.
[1.0.3] AntiXrayOP 1.0.3
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.0.3
- Added Modrinth update checker with OP/admin join notifications.
- Fixed update links to use stable version-number URLs (/version/<version_number>).
- Added fallback to the Modrinth versions page when latest version cannot be resolved.
[1.0.2] AntiXrayOP 1.0.2
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.0.2
- Maintenance synchronization release for unified plugin versioning across the suite.
- Kept OP/admin update notification flow and direct Modrinth link policy aligned for this release line.
- No gameplay or balance changes in this release; maintenance update only.
[1.0.1] AntiXrayOP 1.0.1
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.0.1
- Fixed xray flash issue where ores could appear briefly after block changes.
- Reworked chunk rescan to diff-based updates (no full reveal before remask).
- Added neighbor-chunk exposure checks to prevent visible ores on chunk borders.
- Improved strict protection defaults (
strict-hide-all, higher hidden block cap, wider vertical protection). - Reduced join delay so obfuscation applies much faster after login.
[1.0.0] AntiXrayOP 1.0.0
by perusi on Oct 15, 2026
Download
### AntiXrayOP 1.0.0
- Initial release of AntiXrayOP.
- Added per-player underground ore obfuscation to reduce xray visibility.
- Added synchronized ore reveal handling for mining, placement, chunk loading, and explosions.
- Added behavior-based detection using ore ratio in a sliding time window.
- Added configurable staff alerts with anti-spam cooldown.
- Added admin command suite: reload, status, top, clear, toggle bypass, and refresh.
