AntiXray
AntiXray is a powerful Anti-XRay moderation plugin for Paper servers.
It helps staff detect suspicious mining behavior, monitor high-risk players, review ore statistics, and react quickly with advanced moderation tools. The plugin focuses on clean staff workflows, GUI-based controls, smart suspicion scoring, and optional manual X-Ray visualization for admins.
Main Features
Smart Ore Vein Detection
NeoAntiXray detects ore veins when players mine tracked ores.
It avoids repeated alerts from the same vein, so staff will not receive spam like:
x10, x9, x8, x7...
Instead, the vein is detected once and reported clearly.
Staff Alerts
Only staff members with the correct permission can see alerts.
Alerts include:
- Player name
- Ore type
- Vein size
- Suspicion information
- Location-related moderation context
TopLuck System
The TopLuck GUI ranks players by suspicious mining statistics.
It includes:
- Online / Offline / All player modes
- Mode switch button
- Player heads
- Diamond / Stone ratio
- Ore statistics
- Suspicion score
- Player profile GUI
Admin GUI
The /nax command opens the main admin interface.
The GUI includes access to:
- TopLuck
- Admin Tools
- Update Check
- Help
- History
- X-Ray controls
Personal X-Ray Mode
Admins can use:
/xray <on|off|status>
This enables a personal client-side X-Ray view for moderation.
When enabled:
- Non-ore blocks are shown as barrier blocks
- Ores remain visible
- Only the admin sees the fake blocks
- The real world is not changed
- Other players do not see anything
AutoMod / AutoKick / AutoBan
NeoAntiXray includes automatic moderation tools.
The system uses a more conservative suspicion calculation to reduce false punishments for legitimate cave miners.
AutoBan progression:
- First ban: 1 day
- Second ban: 7 days
- Third ban: 30 days
- Fourth ban: permanent
When a player is banned by the plugin:
- Inventory is cleared
- Ender Chest is cleared
- A styled ban message is shown
Update Checker
Admins receive update information on join.
The plugin can show:
- Outdated version
- Latest version
- Development version
The Modrinth update link is clickable in chat.
Language Support
Default language: English French can be supported through the plugin language system.
Commands
/nax
/topluck
/xray <on|off|status>
/autokick <on|off|status>
Permissions
neoantixray.admin
neoantixray.alerts
neoantixray.topluck
neoantixray.topluck.tp
neoantixray.update
neoantixray.stats
neoantixray.history
Compatibility
Paper 26.2
Java 21+
Author
pierrecreeper
Developed by pierrecreeper
Optimized for survival, faction, and semi-RP servers.

All Versions
+ Add Version- add version 1.21 - 1.21.11
## From 4.0 to 4.5
## Version 4.5
### Changed
- Updated plugin version to
4.5. - Updated target server version to Paper
26.2.
### Removed
- Removed
/manuel. - Removed all manual surveillance features related to
/manuel.
### Added
- Added
/xray <on|off|status>as a personal admin X-Ray command. - Added
/nax xrayGUI access. - Added client-side X-Ray visualization for admins.
### Improved
/xray on,/xray off, and/xray statusno longer open the menu.- X-Ray mode now only affects the admin who enabled it.
- Other players cannot see when an admin enables X-Ray mode.
- The real world is not modified.
### X-Ray Mode Behavior
When enabled:
- Non-ore blocks around the admin are shown as barrier blocks.
- Ores remain visible.
- The effect is client-side only.
- Other players see the world normally.
## Overview
NeoAntiXray 4.0.0 is the largest update released so far. This version completely redesigns the staff workflow, TopLuck system, update notifications, GUI navigation, punishment system, and overall user experience.
# New Features
## New Main Menu
Command:
``
text
/nax
`
Now opens a modern GUI hub instead of displaying simple messages.
Main menu includes:
- TopLuck
- Admin Tools
- Check Updates
- History
- Help
- Statistics
## TopLuck Redesign
### Player Heads
Players are now displayed using their Minecraft heads.
### Sorting System
Players are sorted by:
`text
Diamond / Stone %
`
Highest percentage first.
### Modes
TopLuck supports:
- Online Players
- Offline Players
- All Players
A single button cycles through:
`text
Online → Offline → All → Online
`
### Detailed Player Profile
Clicking a player opens:
- Diamond %
- Total ores mined
- Stone mined
- Ore breakdown
- Luck score
- Suspicion score
- Teleport button
# Admin Tools
A dedicated Admin Tools menu has been added.
Contains:
- AutoMod
- AutoKick
- AutoBan
- Pardon Player
- Punishment History
- Statistics Controls
## Pardon Player GUI
Clicking:
`text
Admin Tools → Pardon Player
`
opens an anvil GUI.
Process:
1. Type player name.
2. Take result paper.
3. NeoAntiXray executes:
`text
/nax pardon <player>
`
4. Automatically returns to Admin Tools.
# Auto Moderation System
## AutoMod
Automatically tracks suspicious mining behavior.
Uses:
- Diamond ratio
- Ancient Debris ratio
- Vein sizes
- Total mined blocks
- Mining consistency
## AutoKick
Automatically kicks highly suspicious players.
Configurable.
Command:
`text
/autokick
`
## AutoBan
Automatic progressive punishment system.
### First Detection
`text
1 Day Ban
`
### Second Detection
`text
7 Day Ban
`
### Third Detection
`text
30 Day Ban
`
### Fourth Detection
`text
Permanent Ban
`
## Inventory Reset
When AutoBan triggers:
- Inventory is cleared
- Ender Chest is cleared
# Anti-XRay Improvements
## One Alert Per Vein
Fixed spam issue:
`text
x10
x9
x8
x7
x6
...
`
Now only:
`text
X-Ray Steve found x10 Deepslate Diamond Ore
`
once per vein.
## Improved Suspicion Formula
Legitimate cave miners are much less likely to be punished.
New calculation includes:
- Diamond %
- Stone mined
- Ore diversity
- Ancient Debris ratio
- Large vein frequency
- Mining duration
# Update System
## Automatic Update Check
Admins receive a message when joining.
Possible states:
### Outdated
`text
A new version is available.
Click here to download.
`
### Latest
`text
You are running the latest version.
`
### Development Version
`text
You are running a development build.
`
## Clickable Download Link
Update messages are now clickable.
Opens:
`text
https://modrinth.com/plugin/neoantixray
`
## Update GUI
Command:
`text
/nax update gui
`
Opens:
- Current version
- Available versions
- Release history
Current version is displayed in gray.
# Help GUI
Command:
`text
/nax help gui
`
Displays:
- All commands
- Permissions
- Descriptions
- Navigation buttons
# History GUI
Command:
`text
/nax history
`
Features:
- Newest alerts first
- Pagination
- Teleport to alert location
- Player filtering
# Console Improvements
## Enable Message
Large NeoAntiXray pixel-art banner displayed on startup.
Includes:
- Version
- Author
- Server version
- Status
## Disable Message
Large NeoAntiXray shutdown banner.
Displays:
- Plugin shutdown status
- Session statistics
# Permissions
`text
neoantixray.admin
neoantixray.alerts
neoantixray.topluck
neoantixray.topluck.tp
neoantixray.stats
neoantixray.history
neoantixray.update
`
# Compatibility
`text
Paper 26.1.2
Java 21+
`
# Version
`text
NeoAntiXray 4.0.0
``/nax command, adds command auto-completion, improves compatibility with Paper 26.1.2, and enhances the TopLuck and Anti-XRay systems.Fixed the following error:
``
text
NoSuchMethodError: org.bukkit.Tag.isTagged(java.lang.Object)
``
NeoAntiXray no longer uses:
`java
Tag.BASE_STONE_OVERWORLD.isTagged(...)
`
Instead, the plugin now uses manual stone detection fully compatible with Paper 26.1.2.
Tracked stone blocks:
`text
STONE
DEEPSLATE
GRANITE
DIORITE
ANDESITE
TUFF
CALCITE
DRIPSTONE_BLOCK
`
Result:
- No more crashes when breaking blocks.
- Improved compatibility with Paper 26.1.2.
## Added
### New Main Command
Added a shorter command:
`text
/nax
`
The original alias is still available:
`text
/neoantixray
`
### Available Subcommands
`text
/nax topluck
/nax reload
/nax stats <player>
/nax history
/nax reset <player|all>
/nax help
`
### Command Auto-Completion
Typing:
`text
/nax
`
will automatically suggest:
`text
topluck
reload
stats
history
reset
help
`
Typing:
`text
/nax stats
`
will suggest online players.
Typing:
`text
/nax reset
`
will suggest:
`text
all
`
and online players.
## Improved
### Anti-XRay Alert System
Staff alerts are only visible to players with:
`text
neoantixray.alerts
`
The anti-spam system remains active:
- One alert per vein.
- No more
x10, x9, x8, x7 spam.Immediate notification when a tracked ore vein is discovered.
### TopLuck GUI
The /nax topluck GUI includes:
- Diamond / Stone percentage ranking.
- Sorting from highest percentage to lowest.
- Click a player head to view detailed statistics.
- Staff teleport button.
- Ore breakdown statistics.
- Suspicion score display.
## Permissions
`text
neoantixray.alerts
neoantixray.topluck
neoantixray.topluck.tp
neoantixray.command
neoantixray.admin
neoantixray.stats
neoantixray.history
``### Added
- One-time vein alert system
- Staff-only detailed TopLuck GUI
- Player detail view with ore stats
- Teleport button in TopLuck detail menu
- Global ore tracking system
### Improved
- TopLuck now sorts players by highest diamond percentage first
- GUI now focuses on useful suspicion data
- Vein detection no longer spams alerts for the same ore vein
### Fixed
- Same vein no longer triggers x10, x9, x8, x7... style repeated alerts
- Better tracking for mined ores and stone count
- Changelog 1.2.1**
- fix alert system
