隧道工具

🚇 隧道工具 —— 一键隧道挖掘

隧道工具 是一款灵感来源于 MTR 车站方块交互的 Minecraft 模组。放置一个 隧道工具方块，设置起点和终点，只需一次点击即可挖掘出完美的矩形隧道——自动铺设你选择的墙壁方块，并自动密封缺口、悬崖和水下区域。

MineCraft 1.21.1 · NeoForge 21.1.x

---

✨ 特性

• 一个方块，全面隧道掌控 —— 右键点击该方块，或手持它时 左键点击 任意位置即可远程打开控制面板。
• 通过准星设置起点/终点 —— 支持倾斜隧道（不同 Y 坐标）、沿 X/Z 轴的直线隧道以及垂直竖井。
• 实时预览 —— 一条粗黄色轨迹带连接从起点到终点的方块顶部（手持方块时跟随你的准星，MTR 风格）。
• 对齐提示 —— 当你的准星与起点处于同一直线上时，会显示绿色消息：“当前瞄准方块与起点对齐，可用作隧道终点。”
• 中键拾取器（格式刷） —— 手持隧道工具并中键点击任意方块，即可立即将其设置为墙壁方块，无需打开 GUI。
• 宽度与高度 —— 1–32 格；可输入数字或在输入框上 滚动鼠标滚轮 调整。
• 自动密封 —— 隧道以完全封闭的矩形外壳形式挖掘；间隙、悬崖、空气和水下段会自动填充（水下末端会密封以防止水进入）。
• 维度级共享配置 —— 同一维度中的所有隧道工具方块共享相同的起点/终点/尺寸/墙壁设置，且配置保存在世界存档中。
• 永不自毁 —— 隧道工具方块和基岩始终受到保护。
• /tunnel_reset —— 重置所有维度的共享隧道配置。

---

🛠 使用方法

1. 放置一个 隧道工具方块（创造模式标签页“隧道工具”，或使用 /give @p tunnelmod:tunnel_block）。
2. 手持该方块并 左键点击 以打开面板（或右键点击该方块）。
3. 瞄准起点方块 → 设置起点。瞄准终点方块 → 设置终点。
4. 设置 宽度/高度，选择 墙壁方块，然后点击 执行挖掘。
5. 完成 —— 隧道立即被挖掘并铺设好。挖掘后起点/终点会清除，以便你设置下一段隧道。

快捷键（手持隧道工具时）：

• 左键点击 → 打开控制面板
• 中键点击 → 拾取瞄准的方块作为墙壁方块
• 滚动滚轮（在宽度/高度输入框上）→ 调整尺寸

---

📦 安装

1. 为 Minecraft 1.21.1 安装 NeoForge 21.1.x。
2. 将 tunnel-tool-1.1.0.jar 放入 .minecraft/mods 文件夹。
3. 启动游戏。

---

🔧 兼容性

• 需求：Minecraft 1.21.1、NeoForge 21.1.x（客户端 + 服务端，支持服务器和单人游戏）。
• 纯客户端/服务端分离：GUI 和预览在客户端运行；挖掘、配置和验证均在服务端运行。

---

❓ 常见问题

问：设置起点/终点没有反应？ 答：请确保你的准星确实瞄准了一个方块（而不是天空/水面）。面板底部会显示提示信息。

问：为什么对齐提示不显示？ 答：只有当你的准星方块与起点具有相同的 X 或 Z 坐标（即同一直线）时才会显示，且仅在尚未设置终点时出现。

问：我可以水下建造吗？ 答：可以——水/岩浆会被挖掘掉，隧道会自动密封，如同一个封闭的外壳。

---