Advanced XRay 新手实战教程：Minecraft 矿石透视模组从安装到配置一次搞定-开发者社区

Advanced XRay 新手实战教程：Minecraft 矿石透视模组从安装到配置一次搞定

【免费下载链接】XRay-ModNeoforge based XRay mod designed to aid players who don't like the ore searching process.项目地址: https://gitcode.com/gh_mirrors/xra/XRay-Mod

挖了半小时矿，钻石的影子都没见着；邻居新手第一镐就出钻石——这种时刻，你缺的不是运气，而是一个矿石透视模组。

Advanced XRay（仓库名 XRay-Mod）是一款基于 NeoForge 和 Fabric 双加载器的 Minecraft 矿石透视模组，核心用途就一句话：帮你快速定位钻石、绿宝石等矿石，把挖矿从"赌运气"变成"看地图"。这篇文章不聊虚的，直接带你走完"装 → 用 → 配 → 避坑"的完整闭环，读完就能上手。

先搞清楚：它能替你省下什么

先别急着装，咱们用一张对照表说清楚这个矿石透视模组到底解决哪些痛点：

你的痛点	传统做法	用了 Advanced XRay 之后
不知道脚下哪个方向有矿	挖"回字形"竖井全靠体力	打开透视，矿石高亮直接标在地形轮廓里
分不清矿种、下错方向	看材质靠猜	每种方块可以自定义颜色，扫一眼就分得出钻石还是铁
记不住哪些区块搜过	自己脑内建模	以玩家为中心的区块扫描会自动跟随你刷新
想找特定方块（如远古残骸）	逐层翻找	在方块列表里加进去，透视自动高亮

它的扫描调度核心在common/src/main/java/pro/mikey/xray/core/ScanController.java：按"区块"为单位，用多线程后台扫描你周围的方块，命中列表里的目标就把位置交给渲染层画轮廓——所以它不影响你正常挖矿，只是多了一双"透视眼"。

别急，先这样装（3 步搞定）

这模组不是直接下个 jar 就完事，因为它是开源项目，需要先拉源码自己构建。跟着走，全程约 5 分钟：

克隆源码：把仓库拉到本地；
构建模组：在项目根目录执行 Gradle 构建命令，产物在neoforge/build/libs/和fabric/build/libs/里；
放入 mods 文件夹：把对应加载器的 jar 丢进 Minecraft 的 mods 目录，启动游戏。

# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/xra/XRay-Mod # 2. 进入目录并构建（首次会下载依赖，耐心等一会儿） cd XRay-Mod ./gradlew build

# 3. 把构建产物复制到 mods 文件夹（以 Linux/macOS 为例） cp neoforge/build/libs/*.jar ~/.minecraft/mods/

✅如何验证成功：启动游戏后在"选项 → 控制"里能看到一个名为XRay的新按键分类，说明模组已加载。

📌 提示：NeoForge 和 Fabric 是两个不同的加载器，按你游戏实际用的加载器选择对应 jar，别两个一起放。

两条核心操作：照着做就行

整个模组日常就两件事：开关透视和管理方块列表。两个快捷键定义在common/src/main/java/pro/mikey/xray/XRay.java：

操作	默认按键	在哪改
开关矿石透视	反斜杠`\`	选项 → 控制 → XRay 分类
打开方块管理界面	`G`	同上

操作一：一键开关透视

效果：开启后，已添加且启用的方块会以彩色轮廓直接浮现在地形上，就算埋在石头里也看得见；
操作：按下\键，屏幕右上角出现覆盖层提示，说明透视已激活；再按一次关闭；
结果：你站在原地转一圈，就能看到周围区块里所有目标矿石的分布，直接规划挖掘路线。

💡 如果按了没反应，先确认是否开了输入法（中文输入法会吞掉\键），再检查控制设置里的键位绑定。

操作二：添加你要透视的方块

效果：把"想找的方块"加入扫描列表，之后它才会被高亮；
操作：按G打开管理界面，右侧有 4 个按钮——Add Block（从搜索列表添加）、Add from hand（添加当前手持的方块）、Add from looking at（添加你正在注视的方块）、Show Lava（岩浆高亮开关）；
结果：新方块出现在左侧列表里，点击列表项切换该方块的Enabled / Disabled，Shift + 点击可进入编辑（改名字、改颜色）。

这样配，直接起飞（拿来即用的配置模板）

模组有两份 JSON 配置，都在config/xray/目录下（common/src/main/java/pro/mikey/xray/Configuration.java和core/scanner/ScanStore.java定义了读写逻辑）：

①xray-client.json—— 全局开关与扫描范围：

{ "showOverlay": { "comments": ["Whether to show the overlay when XRay is enabled"], "value": true }, "radius": { "comments": ["The radius area (in chunks) that XRay will search within"], "value": 2 }, "lavaActive": { "comments": ["When true, lava will automatically be added to the scan list"], "value": false } }

字段	含义	推荐值
`showOverlay`	开启透视时是否显示屏幕右上角覆盖层	`true`
`radius`	扫描半径，数值越大搜索范围越大	`2`（默认）
`lavaActive`	是否自动高亮岩浆（红色警告）	挖矿防烫开`true`

②scan-store.json—— 你要透视的方块清单（核心）：

[ { "name": "Default", "color": 65280, "order": 0, "entries": [ { "type": "xray:block", "name": "Diamond Ore", "color": "rgb(0, 255, 0)", "order": 0, "enabled": true, "block_name": "minecraft:diamond_ore" }, { "type": "xray:block", "name": "Ancient Debris", "color": "rgb(128, 64, 0)", "order": 1, "enabled": true, "block_name": "minecraft:ancient_debris" } ] } ]

字段	含义	说明
`type`	扫描类型	目前固定为`xray:block`
`name`	列表中显示的名字	随意，比如 "Diamond Ore"
`color`	高亮颜色	支持`rgb()`、`rgba()`、`#RRGGBB`、`hsl()`等多种格式
`order`	排序权重	数字越小排越前
`enabled`	是否启用	`true`才参与扫描
`block_name`	方块注册名	必须是 Minecraft 标准注册名，如`minecraft:diamond_ore`

💡 想分享配置？直接把这份scan-store.json发给朋友覆盖到同路径即可，比手动一个个加省事得多。

新手最容易踩的 3 个坑

坑 1：加了方块却看不到高亮

错误做法：按G把方块加进列表，以为完事了；
后果：列表项显示Disabled，扫描直接跳过它，透视自然没反应；
正确做法：点击列表项，让状态变为绿色Enabled，然后按\重新开启透视（每次改动后强制刷新一次扫描）。

坑 2：在公共服务器上开着透视招摇过市

错误做法：把模组当"官方外挂"在别人服务器上大摇大摆挖矿；
后果：封号。项目 README 里作者说得很直白："服务器不让用就别用，因此被封是你应得的"；
正确做法：只在单机、自己的服务器或明确允许该模组的服务器使用，且不要在服里高调炫耀矿点。

坑 3：开了光影（着色器）后透视失灵

错误做法：装了 Complementary / BSL 等光影后直接问"模组坏了？"；
后果：白折腾半天，其实这是已知的兼容性问题；
正确做法：先关掉光影验证透视是否恢复；确认是光影问题后，看模组更新日志，或在仓库提 issue 附上你的 Minecraft 与光影版本。

进阶一步：让效率翻倍的小技巧

🎯扫描范围按场景调：管理界面右侧的Distance按钮，左键点击加一档、右键减一档，范围从 1 档到 5 档循环。找钻石开大范围"地图扫描"，垂直下井时调小省性能。
👀"Looking At" 精准添加：需要透视带特定状态的方块（比如某些可交互方块）时，用Add from looking at而不是From hand，前者会记录更完整的方块数据（对应common/src/main/java/pro/mikey/xray/screens/ScanManageScreen.java）。
🔥岩浆当陷阱预警：把lavaActive打开，岩浆会以#FF0000红色高亮，下矿洞时等于多了一个"防烫提醒"。
⚡配色按稀有度分级：钻石用绿色rgb(0,255,0)、远古残骸用棕色rgb(128,64,0)、红石用红色——一眼分清优先级，不用走近看。
📌改动后记得刷新：每次在 GUI 里增删方块并关闭界面后，模组会自动触发一次强制重扫（见ScanManageScreen的removed()方法），如果觉得画面没更新，再按一次\重开即可。

到哪里找帮助与源码

遇到问题先按图索骥，项目代码都在common/目录下（Fabric 与 NeoForge 各自的实现分别在fabric/和neoforge/里）：

扫描与渲染逻辑：common/src/main/java/pro/mikey/xray/core/——ScanController.java（调度扫描）、OutlineRender.java（绘制轮廓）；
方块清单与数据格式：common/src/main/java/pro/mikey/xray/core/scanner/ScanStore.java、ScanType.java、BlockScanType.java；
全局配置读写：common/src/main/java/pro/mikey/xray/Configuration.java；
界面源码：common/src/main/java/pro/mikey/xray/screens/（管理界面、搜索添加、帮助页都在这里）；
版本与更新记录：仓库根目录的CHANGELOG.md和README.md，作者只在里面支持最近两个大版本，装旧版前先瞄一眼。

下一步，就现在

装好、配上、挖到钻石——这三步走完，你已经比 90% 的矿工省下了一半以上的找矿时间。现在就把\键按下去，进游戏转一圈，看看你脚下藏着多少矿。剩下的路，交给你的镐子。

祝挖矿愉快，钻石多多！🎮⛏️

【免费下载链接】XRay-ModNeoforge based XRay mod designed to aid players who don't like the ore searching process.项目地址: https://gitcode.com/gh_mirrors/xra/XRay-Mod

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考