- 版权类型
- 原创
- 插件中文名称
- 反透矿
- 插件英文名称
- MirageAntiXray
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
MirageAntiXray 并非传统的矿物隐藏插件，而是一套结合“真实矿物伪装、玩家独立诱饵、客户端追踪污染与挖矿行为分析”的综合反 Xray 方案。
插件不会修改服务器中的真实世界方块，而是针对每名玩家单独处理客户端视野：将远距离真实矿物伪装成普通岩石，同时生成大量仅该玩家可见的动态假矿。无论是 Xray 材质包、矿物高亮、BlockESP，还是读取客户端区块数据的矿物追踪功能，都将得到被隐藏的真矿与大量错误目标。
当玩家靠近、开始挖掘，或者爆炸、活塞等行为改变附近方块时，插件会及时恢复正确的客户端显示，不影响正常生存与矿物采集。
假矿会随着玩家移动、传送和区块加载持续更新，并定期轮换位置，使长期缓存型矿物追踪器同样产生大量噪声。
玩家靠近矿物后，客户端会自动恢复正确方块，不修改服务器真实世界数据。
传统核心采用全服单一分片任务，并设置严格的主线程时间预算；Folia 环境下，区块读取在对应区域线程执行，客户端数据发送在玩家实体线程执行，避免跨区域线程违规。
即使玩家原有假矿配额已经占满，也会按性能预算回收身后诱饵，将配额逐步迁移到玩家前进方向。
管理员可以通过状态指令检查：
核心原生 Anti-Xray 负责保护玩家首次收到的区块数据，MirageAntiXray 则负责动态诱饵、真实矿物二次隐藏、客户端缓存污染与行为评分。
批量方块更新会尽可能合并发送，在控制服务器上行流量的同时，避免大量微小压缩包造成过高的 Netty CPU 占用。
异步重新读取配置文件。旧诱饵会按照性能预算分批清理，不会一次性恢复大量方块造成主线程尖峰。
/antixray status [玩家]
查看指定玩家的防护状态，包括：
清理指定玩家或全服的客户端诱饵。清理任务会分批进入预算队列，不会同步恢复数万个方块。
指令别名：
/axray<br>/fanxray
允许使用全部管理指令，默认提供给 OP。
mirageantixray.notify
接收可疑挖矿行为告警，默认提供给 OP。
mirageantixray.bypass
跳过诱饵与行为检测。默认不会自动生效，需要在配置中主动开启旁路权限支持。
插件不会修改服务器中的真实世界方块，而是针对每名玩家单独处理客户端视野：将远距离真实矿物伪装成普通岩石，同时生成大量仅该玩家可见的动态假矿。无论是 Xray 材质包、矿物高亮、BlockESP，还是读取客户端区块数据的矿物追踪功能，都将得到被隐藏的真矿与大量错误目标。
当玩家靠近、开始挖掘，或者爆炸、活塞等行为改变附近方块时，插件会及时恢复正确的客户端显示，不影响正常生存与矿物采集。
核心技术亮点
1. 玩家独立动态诱饵
每名玩家都会收到不同位置的假矿数据，无法通过共享坐标、多人对比或固定地图缓存筛选诱饵。假矿会随着玩家移动、传送和区块加载持续更新，并定期轮换位置，使长期缓存型矿物追踪器同样产生大量噪声。
2. 真实矿物二次隐藏
插件会将揭示范围外的真实矿物在客户端伪装为：- STONE
- DEEPSLATE
- NETHERRACK
玩家靠近矿物后，客户端会自动恢复正确方块，不修改服务器真实世界数据。
3. Bukkit 与 Folia 双架构支持
原生兼容 Spigot、Paper、Purpur、Leaves 、 Folia 等核心传统核心采用全服单一分片任务，并设置严格的主线程时间预算；Folia 环境下，区块读取在对应区域线程执行，客户端数据发送在玩家实体线程执行，避免跨区域线程违规。
4. 百人服性能预算
默认配置按照约 100 人在线场景设计：- 全服仅维护一个循环派发任务
- 不为每名玩家创建独立重复任务
- 每次扫描与方块恢复均设有硬上限
- 不主动加载未加载区块
- 不遍历完整世界或全部实体
- 真矿隐藏与假矿诱饵使用独立配额
- TPS 低于设定值时自动暂停新增诱饵
- 配置重载与诱饵清理均采用分批处理
5. 多维挖矿行为评分
插件不会因为玩家偶然挖到一个诱饵就直接处罚，而是通过滚动窗口综合分析：- 玩家挖中诱饵的比例
- 挖掘行为样本数量
- 隐藏钻石、绿宝石与远古残骸矿脉的发现次数
- 找到不同隐藏矿脉所需的平均挖掘方块数
- 短时间内连续发现高价值矿脉的效率
核心功能
跨客户端矿物追踪干扰
已针对以下客户端功能进行兼容核对：- Xray Ultimate 26.X
- Meteor Client Xray
- Meteor Client BlockESP
- Wurst Search
- Wurst OreFinder 等
多维度矿物诱饵池
主世界诱饵包括：- 煤矿
- 铁矿
- 铜矿
- 金矿
- 红石矿
- 青金石矿
- 钻石矿
- 绿宝石矿
- 对应的深板岩矿物版本
- 下界石英矿
- 下界金矿
- 远古残骸
视野区块预热
玩家登录、移动、飞行或传送进入新区块后，插件会将相关区块加入高优先级预热队列。即使玩家原有假矿配额已经占满，也会按性能预算回收身后诱饵，将配额逐步迁移到玩家前进方向。
区块最低覆盖保障
每个进入防护范围的区块都会优先获得最低数量的假矿，避免出现“玩家总诱饵很多，但部分视野区块完全没有防护”的情况。管理员可以通过状态指令检查：
- 已覆盖区块
- 低覆盖区块
- 等待补充区块
- 活动诱饵数量
- 隐藏真矿数量
核心 Anti-Xray 自动配置
在 Paper、Purpur 与 Leaves 环境下，插件可以自动检查并配置核心原生 Anti-Xray：
JSON：
enabled: true
engine-mode: 2
max-block-height: 320核心原生 Anti-Xray 负责保护玩家首次收到的区块数据，MirageAntiXray 则负责动态诱饵、真实矿物二次隐藏、客户端缓存污染与行为评分。
网络压缩自动优化
插件可以自动检查 server.properties 中的网络压缩设置，默认将压缩阈值调整为 256。批量方块更新会尽可能合并发送，在控制服务器上行流量的同时，避免大量微小压缩包造成过高的 Netty CPU 占用。
插件指令
/antixray reload异步重新读取配置文件。旧诱饵会按照性能预算分批清理，不会一次性恢复大量方块造成主线程尖峰。
/antixray status [玩家]
查看指定玩家的防护状态，包括：
- 当前活动诱饵
- 已隐藏真实矿物
- 视野区块覆盖情况
- 风险评分
- 诱饵命中率
- 隐藏高价值矿脉数量
- 派发平均与峰值耗时
- 核心 Anti-Xray 运行状态
- 网络压缩状态
清理指定玩家或全服的客户端诱饵。清理任务会分批进入预算队列，不会同步恢复数万个方块。
指令别名：
/axray<br>/fanxray
权限节点
mirageantixray.admin允许使用全部管理指令，默认提供给 OP。
mirageantixray.notify
接收可疑挖矿行为告警，默认提供给 OP。
mirageantixray.bypass
跳过诱饵与行为检测。默认不会自动生效，需要在配置中主动开启旁路权限支持。
