? AntiXray
轻量。强大。零依赖。
AntiXray 是一款专为 Paper 和 Purpur 1.20–26.x 设计的轻量级反 X-ray 插件。它通过隐藏有价值的矿石、容器和刷怪笼来保护你的服务器免受 X-ray 模组、材质包和作弊客户端的侵害,且不会修改你的世界数据。
无需 ProtocolLib。无需额外插件。只需一个 JAR 文件。
⚠️ 警告
如果你在使用该插件时遇到任何问题,请前往我们的 Discord 服务器进行反馈。
✨ 功能特性
- ?️ 高级反 X-ray 保护 — 在不更改实际世界数据的情况下,向 X-ray 用户隐藏关键方块。
- ⚡ 高性能 — 经过优化的处理流程,对服务器性能的影响极小。
- ? 假矿石模式 — 让 X-ray 用户在实心石头中看到散布的假矿石。
- ?️ 距离隐藏器 — 在玩家接近之前,保持容器、刷怪笼、保险箱和暴露的矿石处于隐藏状态。
- ? 智能揭示系统 — 当挖掘、爆炸、活塞、掉落物以及其他支持的事件导致方块暴露时,立即揭示矿石。
- ? 全维度支持 — 保护主世界、下界和末地。
- ? 游戏内 GUI — 使用
/ax 命令直接在游戏内配置重要设置。
- ? 实时性能监控 — 追踪区块处理、隐藏方块、揭示方块以及处理时间。
- ? 自动引擎选择 — 根据服务器版本自动选择最佳的保护引擎。
- ? 员工绕过 — 允许受信任的工作人员查看真实且未修改的世界。
- ? 可自定义消息 — 使用 MiniMessage 格式编辑插件消息。
- ? 零依赖 — 无需 ProtocolLib 或其他插件。
? 玩家体验
AntiXray 旨在保护你的服务器,同时不影响合法玩家的游戏体验。
- X-ray 用户看到的是石头。 隐藏在实心方块后的矿石会被替换为相应的类石方块,如石头、深板岩、下界岩或末地石。
- 矿石自然揭示。 当玩家挖掘方块并暴露出矿石时,附近的玩家可以看到真实的方块。
- 容器保持隐藏。 箱子、 barrels、潜影盒、刷怪笼和其他支持的方块在玩家进入配置的范围内之前都会保持隐蔽。
- 墙壁提供真正的保护。 可选的光线追踪功能确保隐藏的方块无法通过墙壁被揭示。
- 覆盖所有维度。 保护主世界、下界和末地中的珍贵资源。
- 合法 gameplay 保持不变。 玩家可以正常挖掘和探索,而不会因为可见方块的视觉混淆而受到不必要的影响。
?️ 保护引擎
AntiXray 支持两种保护引擎,并会根据你的服务器自动选择最合适的选项。
? 数据包引擎 (Packet Engine)
适用于支持的 Paper 版本,包括 Paper 1.20.5+ 和 26.x。
- 在数据包到达客户端之前,从区块数据包中移除隐藏方块的信息。
- 防止客户端和 X-ray 模组接收被隐藏方块的真实数据。
- 在网络线程上进行处理,以减少主线程的开销。
- 使用自动自检功能在真实区块上验证引擎。
? API 引擎 (API Engine)
用作 Paper 1.20–1.20.4 的回退方案。
- 在区块发送后混淆隐藏方块。
- 提供与旧版支持服务器的兼容性。
- 在适当情况下自动选择。
⚙️ 保护模式
模式 1 — 隐藏 (Hide)
六个面都被覆盖的方块会被替换为相应的类石材料。这可以防止 X-ray 用户透过实心方块看到有价值的矿石。
模式 2 — 假矿石 (Fake Ores)
包含“隐藏”模式的所有功能,并增加了一层欺骗性:根据你的配置密度,在实心石头中散布假矿石。
X-ray 用户可能会看到到处都是矿石,这使得区分真实矿脉和假矿脉变得更加困难。
?️ 距离隐藏器
AntiXray 可以在玩家接近之前隐藏以下方块:
- 箱子和陷阱箱
- 桶
- 末影箱
- 潜影盒
- 生物刷怪笼
- 试炼刷怪笼
- 保险箱
- 洞穴中暴露的矿石
可用选项包括:
- 可配置的检测距离
- 可选的光线追踪视线检查
- 可配置的检测间隔
- 可选择保护的方块
- 可选的暴露矿石隐藏
插件还会从相关数据包中剥离隐藏方块实体数据,防止客户端接收隐藏的容器信息。
? 智能揭示系统
当隐藏方块通过支持的世界事件暴露时,它们会被更新,包括:
更新半径是可配置的,并且正确处理靠近区块边界的矿石。
? 绕过权限
受信任的工作人员可以使用以下权限绕过所有混淆:
antixray.bypass
拥有此权限的玩家可以看到真实且未修改的世界。
?️ 游戏内 GUI & 实时监控
交互式设置面板
运行 /ax 以打开游戏内配置面板。
只需几次点击即可配置重要设置,包括:
- 启用/禁用保护
- 保护模式
- 假矿石密度
- 保护引擎
- 揭示半径
- 距离隐藏器
- 检测距离
- 光线追踪
- 洞穴矿石保护
- 检测间隔
- 调试模式
- 按世界保护
更改将保存到 config.yml 并立即生效。
? 实时性能监控
使用 /ax monitor 启用实时性能显示。
监控信息包括:
- 每秒处理的区块数
- 每个区块的处理时间
- 每秒隐藏的方块数
- 每秒揭示的方块数
可以选择使用 Boss 栏或动作栏显示。
? 可自定义消息
所有插件消息都存储在 messages.yml 中,并支持 MiniMessage,包括渐变、悬停事件和可点击文本。
自定义插件消息以匹配你服务器的风格。
⌨️ 命令与权限
命令权限: antixray.admin
默认权限级别: OP
| 命令 |
说明 |
/ax |
打开设置 GUI |
/ax gui |
打开设置 GUI |
/ax status |
显示插件状态、活动引擎、模式、近距离隐藏器和受保护的世界 |
/ax stats |
显示性能统计信息,包括已处理的区块、平均处理时间、隐藏/揭示的方块以及错误 |
/ax monitor |
切换实时 Boss 栏/动作栏监控器 |
/ax toggle |
启用或禁用保护 |
/ax selftest [world] |
在当前区块或世界的出生点区块上测试保护引擎 |
/ax reload |
在不重启服务器的情况下重新加载 config.yml 和 messages.yml |
/ax resetstats |
重置性能统计信息 |
权限
| 权限 |
说明 |
antixray.admin |
访问 GUI 和所有插件命令 |
antixray.bypass |
查看未被混淆的真实矿石和方块 |
⚙️ 配置
AntiXray 提供灵活的配置选项,以便将保护适应你的服务器。
主要选项
| 设置项 |
说明 |
hidden-blocks |
定义哪些方块应该被隐藏。支持通配符,如 *_ORE。 |
engine.type |
选择 auto(自动)、packet(数据包)或 api(API)。 |
engine.mode |
选择模式 1(隐藏)或模式 2(假矿石)。 |
fake-ore-density |
控制假矿石的密度。 |
replaceable-blocks |
定义在混淆过程中可以被替换的方块。 |
proximity |
配置检测距离、光线追踪、检查间隔、暴露矿石隐藏以及受保护的方块。 |
update-radius |
控制当矿石暴露时附近方块的检查范围。 |
disabled-worlds |
指定禁用保护的世界。 |
monitor.style |
配置实时监控器的显示样式。 |
debug |
启用额外的诊断信息。 |
更多详细信息和默认值可在生成的配置文件中找到。
版本兼容性: 在你的服务器版本中不存在的方块名称会被自动跳过。
自动迁移: 旧配置文件会自动迁移,并保留备份。
⚡ 性能
AntiXray 旨在提供强大的保护,同时保持低开销。
- 基于数据包的混淆在网络线程上运行。
- 空的区块部分会被完全跳过。
- 预计算的查找表优化了方块处理。
- 当区块卸载或玩家离开时,会清理按玩家进行的跟踪数据。
- 如果发生错误,受影响的数据包将原样发送,并且错误会记录在
/ax stats 中。
- 玩家不会因内部处理错误而被踢出。
报告的基准测试: 在我们的测试中,大约为 每个区块 0.3–0.5 毫秒。实际性能取决于服务器硬件、世界条件和配置。
✅ 测试版本
以下 Paper 版本已经过测试,包括真实客户端测试:
- Paper 1.20.1
- Paper 1.20.6
- Paper 1.21.4
- Paper 1.21.11
- Paper 26.1.2
- Paper 26.2
- Paper 26.3
测试内容包括隐藏矿石、挖掘和世界事件后的揭示行为、TNT、活塞、下落的沙砾、带视线检查的近距离隐藏、下界保护、绕过权限、GUI 以及插件命令。
与其他版本和 Paper 分支的兼容性可能有所不同。
? 要求
- 服务器软件: Paper、Purpur 或其他兼容的 Paper 分支
- Minecraft 版本: 1.20–26.x,具体取决于服务器软件的兼容性
- Java: Java 17+ 或你的服务器所需的版本
- 依赖项: 无
不支持: Folia、纯 Spigot 和 CraftBukkit。
? 安装
- 下载
AntiXray-4.0.0.jar。
- 将 JAR 文件放入服务器的
plugins/ 文件夹中。
- 重启服务器。
- 插件将自动生成
config.yml 和 messages.yml。
- 在游戏中运行
/ax 以打开配置面板。
- 自定义你的设置,享受更完善的服务器保护!
⚠️ 重要提示:禁用 Paper 内置的 Anti-Xray
如果 config/paper-world-defaults.yml 中启用了 Paper 内置的 Anti-Xray,请将其禁用以避免冲突。如果检测到此配置,AntiXray 会在控制台中发出警告。
? 手动编辑配置
你也可以手动编辑:
plugins/AntiXray/config.yml
修改后,运行:
/ax reload
配置重载无需重启服务器。
? 保护你的世界。保持挖矿公平。
AntiXray 为你的服务器提供强大的反 X-ray 保护、灵活配置和实时监控——全部集成在一个轻量级插件中。
无依赖项。无世界修改。只是更智能的保护。
如果你遇到任何问题或有建议,请在我们的 Discord 服务器上报告!
🔒 AntiXray
Lightweight. Powerful. Zero dependencies.
AntiXray is a lightweight anti-X-ray plugin for Paper and Purpur 1.20–26.x. It protects your server by hiding valuable ores, containers, and spawners from X-ray mods, texture packs, and cheat clients — without modifying your world data.
No ProtocolLib. No extra plugins. Just one JAR.
⚠️ Warning
If you encounter any issues with the plugin, please report them on our Discord server.
✨ Features
- 🛡️ Advanced Anti-Xray Protection — Hide valuable blocks from X-ray users without changing your actual world.
- ⚡ High Performance — Optimized processing with minimal impact on server performance.
- 🎭 Fake Ore Mode — Make X-ray users see fake ores scattered throughout solid stone.
- 👁️ Proximity Hider — Keep containers, spawners, vaults, and exposed ores hidden until players get close enough.
- 🔍 Smart Reveal System — Reveal ores immediately when mining, explosions, pistons, falling blocks, and other supported events expose them.
- 🌍 All Dimensions Supported — Protect the Overworld, Nether, and End.
- 🎮 In-Game GUI — Configure important settings directly in-game using
/ax.
- 📊 Live Performance Monitor — Track chunk processing, hidden blocks, revealed blocks, and processing times.
- 🔧 Automatic Engine Selection — Automatically selects the best protection engine for your server version.
- 🔑 Staff Bypass — Allow trusted staff to see the real, unmodified world.
- 💬 Customizable Messages — Edit plugin messages using MiniMessage formatting.
- 📦 Zero Dependencies — No ProtocolLib or other plugins required.
🎮 Player Experience
AntiXray is designed to protect your server without affecting legitimate players.
- X-ray users see stone. Ores hidden behind solid blocks are replaced with appropriate stone-like blocks, such as stone, deepslate, netherrack, or end stone.
- Ores reveal naturally. When a player mines a block and exposes an ore, the real block becomes visible to nearby players.
- Containers stay hidden. Chests, barrels, shulker boxes, spawners, and other supported blocks remain concealed until the player comes within the configured distance.
- Walls provide real protection. Optional ray-tracing ensures hidden blocks cannot be revealed through walls.
- Every dimension is covered. Protect valuable resources in the Overworld, Nether, and End.
- Legitimate gameplay stays unchanged. Players can mine and explore normally without unnecessary visual obfuscation of visible blocks.
🛡️ Protection Engines
AntiXray supports two protection engines and automatically selects the most suitable option for your server.
📡 Packet Engine
Available on supported Paper versions, including Paper 1.20.5+ and 26.x.
- Removes hidden block information from chunk packets before they reach the client.
- Prevents clients and X-ray mods from receiving the real data of concealed blocks.
- Processes protection on the network thread to reduce main-thread overhead.
- Uses an automatic self-test to verify the engine on a real chunk.
🔄 API Engine
Used as a fallback for Paper 1.20–1.20.4.
- Obfuscates hidden blocks after the chunk is sent.
- Provides compatibility with older supported server versions.
- Is selected automatically when appropriate.
⚙️ Protection Modes
Mode 1 — Hide
Blocks covered on all six sides are replaced with the appropriate stone-like material. This prevents X-ray users from seeing valuable ores through solid blocks.
Mode 2 — Fake Ores
Includes everything from Hide mode, with an additional layer of deception: fake ores are scattered throughout solid stone according to your configured density.
X-ray users may see ores everywhere, making it much harder to distinguish real deposits from fake ones.
👁️ Proximity Hider
AntiXray can hide the following blocks until players approach them:
- Chests and trapped chests
- Barrels
- Ender chests
- Shulker boxes
- Mob spawners
- Trial spawners
- Vaults
- Ores exposed in caves
Available options include:
- Configurable detection distance
- Optional line-of-sight checks using ray-tracing
- Configurable check intervals
- Selectable blocks to protect
- Optional hiding of exposed ores
The plugin also strips hidden block entity data from relevant packets, preventing clients from receiving concealed container information.
💥 Smart Reveal System
Hidden ores are updated when they become exposed through supported world events, including:
- Mining
- Explosions
- Pistons
- Falling sand and gravel
- Burning blocks
The update radius is configurable, and ores near chunk borders are handled correctly.
🔑 Bypass Permission
Trusted staff members can bypass all obfuscation using:
antixray.bypass
Players with this permission see the real, unmodified world.
🖥️ In-Game GUI & Live Monitor
Interactive Settings Panel
Run /ax to open the in-game configuration panel.
Configure important settings with a few clicks, including:
- Protection enabled/disabled
- Protection mode
- Fake ore density
- Protection engine
- Reveal radius
- Proximity hider
- Detection distance
- Ray-tracing
- Cave ore protection
- Check interval
- Debug mode
- Per-world protection
Changes are saved to config.yml and applied immediately.
📊 Live Performance Monitor
Use /ax monitor to enable the live performance display.
Monitor information such as:
- Chunks processed per second
- Processing time per chunk
- Hidden blocks per second
- Revealed blocks per second
Choose between a boss bar and an action bar display.
💬 Customizable Messages
All plugin messages are stored in messages.yml and support MiniMessage, including gradients, hover events, and clickable text.
Customize the plugin's messages to match your server's style.
⌨️ Commands & Permissions
Command permission: antixray.admin
Default permission level: OP
| Command |
Description |
/ax |
Open the settings GUI |
/ax gui |
Open the settings GUI |
/ax status |
Display the plugin state, active engine, mode, proximity hider, and protected worlds |
/ax stats |
Display performance statistics, including processed chunks, average processing time, hidden/revealed blocks, and errors |
/ax monitor |
Toggle the live boss bar/action bar monitor |
/ax toggle |
Enable or disable protection |
/ax selftest [world] |
Test the protection engine on your current chunk or a world's spawn chunk |
/ax reload |
Reload config.yml and messages.yml without restarting |
/ax resetstats |
Reset performance statistics |
Permissions
| Permission |
Description |
antixray.admin |
Access the GUI and all plugin commands |
antixray.bypass |
See real ores and blocks without obfuscation |
⚙️ Configuration
AntiXray offers flexible configuration options for adapting protection to your server.
Main Options
| Setting |
Description |
hidden-blocks |
Defines which blocks should be hidden. Supports wildcards such as *_ORE. |
engine.type |
Selects auto, packet, or api. |
engine.mode |
Selects Mode 1 (Hide) or Mode 2 (Fake Ores). |
fake-ore-density |
Controls the density of fake ores. |
replaceable-blocks |
Defines which blocks can be replaced during obfuscation. |
proximity |
Configures detection distance, ray-tracing, check intervals, exposed ore hiding, and protected blocks. |
update-radius |
Controls how far nearby blocks are checked when ores become exposed. |
disabled-worlds |
Specifies worlds where protection is disabled. |
monitor.style |
Configures the live monitor display style. |
debug |
Enables additional diagnostic information. |
Additional details and defaults are available in the generated configuration file.
Version compatibility: Block names that do not exist in your server version are automatically skipped.
Automatic migration: Older configuration files are migrated automatically, and a backup is kept.
⚡ Performance
AntiXray is designed to provide strong protection while keeping overhead low.
- Packet-based obfuscation runs on the network thread.
- Empty chunk sections are skipped entirely.
- Precomputed lookup tables optimize block processing.
- Per-player tracking is cleaned up when chunks unload or players leave.
- If an error occurs, the affected packet is sent unchanged and the error is recorded in
/ax stats.
- Players are not kicked because of internal processing errors.
Reported benchmark: Approximately 0.3–0.5 ms per chunk in our tests. Actual performance depends on server hardware, world conditions, and configuration.
✅ Tested Versions
The following Paper versions have been tested, including real-client tests:
- Paper 1.20.1
- Paper 1.20.6
- Paper 1.21.4
- Paper 1.21.11
- Paper 26.1.2
- Paper 26.2
- Paper 26.3
Testing includes hidden ores, reveal behavior after mining and world events, TNT, pistons, falling gravel, proximity hiding with line-of-sight checks, Nether protection, bypass permissions, the GUI, and plugin commands.
Compatibility with other versions and Paper forks may vary.
📦 Requirements
- Server software: Paper, Purpur, or another compatible Paper fork
- Minecraft versions: 1.20–26.x, subject to server software compatibility
- Java: Java 17+ or the version required by your server
- Dependencies: None
Not supported: Folia, plain Spigot, and CraftBukkit.
🚀 Installation
- Download
AntiXray-4.0.0.jar.
- Place the JAR file in your server's
plugins/ folder.
- Restart your server.
- The plugin will automatically generate
config.yml and messages.yml.
- Run
/ax in-game to open the configuration panel.
- Customize your settings and enjoy improved server protection!
⚠️ Important: Disable Built-in Paper Anti-Xray
If Paper's built-in Anti-Xray is enabled in config/paper-world-defaults.yml, disable it to avoid conflicts. AntiXray will warn you in the console if it detects this configuration.
🔧 Editing Configuration Manually
You can also edit:
plugins/AntiXray/config.yml
After making changes, run:
/ax reload
No server restart is required for configuration reloads.
🔒 Protect Your World. Keep Mining Fair.
AntiXray gives your server powerful anti-Xray protection, flexible configuration, and real-time monitoring — all in one lightweight plugin.
No dependencies. No world modifications. Just smarter protection.
If you encounter any issues or have suggestions, please report them on our Discord server!
评论 0
登录后参与评分
还没有评论,来抢沙发吧