Prospector Pick | 地质勘探镐

一个专为 Minecraft 1.7.10（特别是配合 GregTech 6 模组使用）设计的实用工具模组，旨在为玩家提供清晰、便捷的地质和岩层垂直分布探测功能。

A utility mod designed for Minecraft 1.7.10 (especially tailored for GregTech 6), providing players with a clear and convenient tool to scan and identify the vertical distribution of geological rock layers beneath their feet.

---

📖 模组介绍 | Overview

在 GregTech 6 或类似的大型地质分布模组中，垂直方向上的岩石层（如玄武岩、红花岗岩、绿片岩等）千变万化，寻找特定的地层往往十分繁琐。 地质勘探镐 (Prospector Pick) 允许玩家直接右键方块来扫描所在 X/Z 坐标下，当前高度到 Y=0 之间的所有岩石层分布，极大地便利了地质勘探与地下矿物开发。

In GregTech 6 and similar geological mods, the distribution of rock layers (e.g., Basalt, Red Granite, Chlorite Schist) varies dramatically across different heights. The Prospector Pick allows players to right-click a block to scan all rock layers from the current height down to Y=0 at the target X/Z coordinate, greatly simplifying prospecting and underground exploration.

---

✨ 核心特性 | Features

• 垂直探测 (Vertical Scanning):
  • 手持地质勘探镐，右键点击地表或洞穴中的任何方块，即可沿垂直列向下扫描直至基岩 (Y=0)。
  • Right-click any block to scan the entire vertical column down to bedrock (Y=0).
• 智能识别 (Smart Rock Detection):
  • 精准匹配矿物词典中注册为 stoneAnyStone 的所有方块，完美适配 GregTech 6 的各色地质岩层。
  • Scans and matches all blocks registered under the stoneAnyStone Ore Dictionary entry, perfectly compatible with GT6 rock types.
• 合并统计与范围显示 (Merged Height Ranges):
  • 自动统计并合并同类岩石层，在聊天栏输出每一层岩石的 起始高度到结束高度。
  • Automatically merges contiguous and duplicate rock layers, outputting the exact min and max Y coordinates for each stone type in chat.
• 生存友好 (Survival Friendly):
  • 耐久度机制: 最大耐久度为 512。每次成功探测消耗 1 点耐久，支持在耐久耗尽时播放损毁音效。
  • Durability: 512 maximum durability. Consumes 1 durability per scan, with break effects and sounds when depleted.
  • 防爆/防崩溃保护: 服务端线程安全计算，且有全局异常拦截，确保游戏平稳运行。
  • Stability: Handled purely server-side with try-catch blocks to prevent server crashes.

---

🔨 合成配方 | Crafting Recipe

在工作台中，使用 铁锭 (Iron Ingot) 和 木棍 (Stick) 按照以下镐子状配方合成：

Craft the Prospector Pick in a Crafting Table using Iron Ingots and Sticks:

配方布局	材料
I I I **I S  ** **  S  **	I: 铁锭 (Iron Ingot) S: 木棍 (Stick)

---

🛠️ 开发者指南 | Developer Guide

本模组采用 RetroFuturaGradle (RFG) 构建工具链。

1. 初始化开发环境 | Setting up the dev workspace

# Linux / macOS
./gradlew setupDecompWorkspace

# Windows
./gradlew.bat setupDecompWorkspace

Important

首次设置工作区后，请务必刷新 IDE 的 Gradle 模型（Refresh Gradle Project），否则 IDE 可能无法识别 Minecraft 和 Forge 类。

2. 编译打包 | Compiling

# Linux / macOS
./gradlew build

# Windows
./gradlew.bat build

编译产物将输出在 build/libs/ 目录下。

3. 运行客户端进行测试 | Running the client

# Linux / macOS
./gradlew runClient

# Windows
./gradlew.bat runClient

---

📄 开源协议 | License

本项目基于 MIT License 开源。