Antixray

插件

· 作者 kamshi

一个适用于你服务器的简易 Antyxray 插件

2 本站下载 0 关注 更新于 1 周前

最新 4.2.0 · 26.3 · Bukkit / Folia

一键开服(送7天)

? 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。

? 安装

  1. 下载 AntiXray-4.0.0.jar。
  2. 将 JAR 文件放入服务器的 plugins/ 文件夹中。
  3. 重启服务器。
  4. 插件将自动生成 config.yml 和 messages.yml。
  5. 在游戏中运行 /ax 以打开配置面板。
  6. 自定义你的设置,享受更完善的服务器保护!

⚠️ 重要提示:禁用 Paper 内置的 Anti-Xray

如果 config/paper-world-defaults.yml 中启用了 Paper 内置的 Anti-Xray,请将其禁用以避免冲突。如果检测到此配置,AntiXray 会在控制台中发出警告。

? 手动编辑配置

你也可以手动编辑:

plugins/AntiXray/config.yml

修改后,运行:

/ax reload

配置重载无需重启服务器。


? 保护你的世界。保持挖矿公平。

AntiXray 为你的服务器提供强大的反 X-ray 保护、灵活配置和实时监控——全部集成在一个轻量级插件中。

无依赖项。无世界修改。只是更智能的保护。

如果你遇到任何问题或有建议,请在我们的 Discord 服务器上报告!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源