Creates advanced Minecraft hac…

# Minecraft 1.20.1 Fabric X-Ray模组开发指南

一、准备工作

• 安装 JDK 17（1.20.1 必须 Java 17）
• 准备开发环境：从 Fabric 官网获取 Fabric Example Mod 模板（基于 Fabric Loader + Fabric API + Yarn mappings，版本需对应 1.20.1）
• 用 IntelliJ IDEA 打开项目，运行 ./gradlew genSources 生成反编译源码便于查阅

二、核心实现思路

1. 注册事件监听：在 ClientTickEvents.END_WORLD_TICK（Fabric API 提供的客户端事件）中，每 tick 扫描玩家周围区块

2. 遍历方块：以玩家为中心，设定扫描半径（建议 16~32 格，过大会卡顿），用 World.getBlockState(pos) 遍历方块位置

3. 目标方块匹配：

• 钻石矿：Blocks.DIAMOND_ORE、Blocks.DEEPSLATE_DIAMOND_ORE
• 远古残骸：Blocks.ANCIENT_DEBRIS
• 可扩展：绿宝石、下界合金相关矿

4. 渲染高亮：使用 WorldRenderEvents.AFTER_TRANSLUCENT 事件，用 VertexConsumerProvider 绘制 DebugRenderer.drawBox（或 drawFilledBox）画出目标方块的线框/半透明填充，颜色区分矿种（钻石青色、残骸棕褐色）

三、性能与体验优化

• 限制扫描范围：仅扫描玩家 Y 轴附近 ±16 格，避免全高度遍历
• 间隔扫描：不必每 tick 全量重扫，可每 10~20 tick 更新一次缓存的目标列表
• 快捷键开关：通过 KeyBindingHelper（Fabric API）注册按键（如默认 X 键）动态启停，符合多数服务器单人/整合包习惯
• 用 HashSet<BlockPos> 缓存目标，渲染时直接读取

四、代码结构建议

```

src/main/java/.../

├── XrayMod.java // ModInitializer，注册按键与客户端事件

├── OreScanner.java // 扫描逻辑，输出目标方块集合

└── XrayRenderer.java // WorldRenderEvents 渲染高亮框

fabric.mod.json / mixins（本方案可不用 mixin）

```

五、注意事项

• 仅限单人或允许模组的服务器使用，多人服务器使用透视功能通常违反规则
• 1.20.1 的映射名与相邻版本有差异，调试时以 genSources 生成的源码为准
• 打包用 ./gradlew build，产物在 build/libs 下，放入 .minecraft/mods 即可

如需完整可运行代码模板，可进一步告诉我你的渲染偏好（线框/填充）。