跳轉至
資源版本2.10.4伺服器版本26.2 · datapack
📥 取得模組ModrinthGitHub

VeinMiner 完整教學#

本教學分為五個章節，涵蓋連鎖採礦概念、資料包版與插件版的安裝使用，以及設定自訂與常見問題排除。全文適用 Minecraft 26.2（NeoForge 模組版 / Paper 插件版 / Vanilla 資料包版）。

一、連鎖採礦概念#

連鎖採礦（Vein Mining）是指挖掘一個礦塊時，系統自動偵測並同步挖掉所有與之相連的同種礦塊。 (wiki)

判定「相連」的規則：

  • 礦塊必須在六個正方向（上下左右前後）或二十六方向（含對角）之一相鄰，視資料包/插件設定而定。
  • 礦種相同才觸發（鑽石礦石不會連鎖深板岩鑽石礦石，除非設定包含兩者）。
  • 觸發後以遞迴或廣度優先搜尋遍歷，預設有上限（通常 64 格），防止效能爆炸。

工具與耐久規則：

  • 須手持對應工具（鎬→礦石類，斧→木頭類，鏟→泥土類）。
  • 每挖一格消耗一點工具耐久，與逐格手動挖掘完全相同。
  • 精準採集（Silk Touch）與時運（Fortune）附魔照常生效於所有被連鎖挖掘的方塊。
概念確認：了解連鎖採礦如何偵測相連礦脈後，接下來選擇你的安裝形式。

二、資料包版安裝與使用#

資料包版無需任何客戶端模組，適合 Vanilla 伺服器或不想強制玩家安裝 mod 的環境。 (wiki)

下載資料包#

前往資料包發布頁面（Modrinth 或 Planet Minecraft）下載適用於 26.2 的 .zip 檔。請勿解壓縮，直接使用 .zip。 需人工實測

安裝到單人存檔#

  1. 在主選單點選「單人遊戲」→ 選擇目標存檔 → 「編輯」→「開啟存檔資料夾」。
  2. 進入 datapacks/ 子資料夾（若不存在請手動建立）。
  3. 將下載的 .zip 複製進去。
  4. 回到遊戲，執行 /reload（需 OP 或創意模式）。
  5. 看到提示訊息 VeinMiner loaded 即代表成功。

安裝到多人伺服器#

  1. 連線至伺服器主機，找到存檔資料夾（預設 world/）。
  2. 進入 world/datapacks/ 目錄。
  3. 上傳 .zip 檔。
  4. 在伺服器控制台或遊戲內以 OP 身份執行 /reload。

使用方式#

安裝後預設所有玩家啟用連鎖採礦。 (wiki)

開關功能（個人）：

/function veinminer:toggle

執行後會顯示目前狀態（已啟用 / 已停用）。每位玩家的設定獨立儲存。

觸發連鎖採礦：

  • 手持對應工具，潛行（Shift）+ 左鍵挖礦即觸發連鎖採礦。
  • 未潛行時為正常單格挖掘。

資料包版不支援更改觸發鍵或調整搜尋範圍；如需高度自訂，請改用插件版。

資料包版完成：已可在 Vanilla 伺服器使用連鎖採礦。若需更多設定彈性，繼續閱讀插件版章節。

三、插件版安裝與使用（VeinMiner 2.10.4）#

插件版僅支援 Paper（或其 fork，如 Purpur）與 Folia 伺服器。Spigot 不確定相容性，Vanilla 不支援。 (wiki)

下載插件#

前往 VeinMiner on Modrinth 或 SpigotMC，下載對應 Paper 26.2 的 .jar 檔。 需人工實測

安裝#

  1. 停止伺服器（或確認可熱載）。
  2. 將 .jar 放入伺服器 plugins/ 資料夾。
  3. 啟動伺服器。
  4. 首次啟動後 plugins/VeinMiner/ 資料夾會自動產生 config.yml、lang/ 等設定檔。

基本指令#

以下指令需要對應權限（詳見 設定說明）。 (wiki)

指令 說明 權限節點
/veinminer toggle 個人開關連鎖採礦 veinminer.command.toggle
/veinminer version 顯示插件版本資訊 veinminer.command.version
/veinminer blocklist 列出目前啟用的礦塊白名單 veinminer.command.blocklist

觸發連鎖採礦#

觸發方式由 config.yml 中的 trigger-type 決定，預設為 SNEAK。 (wiki)

  • SNEAK：潛行（Shift）+ 挖掘。
  • ALWAYS：手持合法工具時，任何挖掘都觸發連鎖採礦。
  • KEYBIND：客戶端需安裝對應模組才能使用自訂按鍵（資料包版不支援）。

授予玩家權限#

在你的權限插件（LuckPerms 等）中授予：

veinminer.veinmine.*   — 允許對所有已設定礦塊使用連鎖採礦
veinminer.command.*    — 允許使用所有 /veinminer 子指令
插件版完成：伺服器已可使用 VeinMiner 插件。接下來說明如何調整設定。

四、設定自訂#

資料包版#

資料包版沒有獨立設定檔，所有調整需透過修改 .zip 內部的函式（.mcfunction）檔案完成，難度較高，一般使用者維持預設即可。 需人工實測

插件版 config.yml 重點選項#

詳細說明請參閱 設定說明。以下為最常用的三項：

更改觸發方式：

trigger-type: SNEAK  # 可改為 ALWAYS

排除特定世界：

disabled-worlds:
  - world_nether
  - world_the_end

工具與礦塊白名單：

連鎖採礦只對 tools 與 blocks 中列出的項目生效。若玩家反映某礦石未觸發連鎖，請確認它已加入 blocks 清單。 需人工實測

設定完成：已了解主要設定項目。以下整理常見問題。

五、常見問題#

Q1：潛行挖礦沒有觸發連鎖採礦#

可能原因與解法： (wiki)

  • 資料包版：確認 /function veinminer:toggle 顯示為「已啟用」。
  • 插件版：確認玩家有 veinminer.veinmine.* 權限，且礦塊在 blocks 白名單中。
  • 確認手持工具為該礦塊的對應工具（例：挖石頭類礦石需持鎬）。
  • 確認目前世界不在 disabled-worlds 清單中。

Q2：連鎖採礦只挖了幾格就停了#

預設有上限（通常 64 格），防止一次性挖掉過多礦石消耗伺服器效能。插件版可在 config.yml 調整 max-vein-size。 需人工實測

Q3：時運沒有正確觸發#

確認附魔工具在觸發連鎖採礦時手持正確工具，且礦塊為非 Silk Touch 模式可掉落的礦石。 需人工實測

Q4：資料包更新後連鎖採礦失效#

每次替換 .zip 後，必須重新執行 /reload 才能讓新版本生效。 (wiki)

Q5：插件版與其他插件衝突#

部分保護插件（如 WorldGuard）可能阻止連鎖採礦挖掘受保護區域的方塊，這是正常行為。若整體功能失效，請檢查伺服器日誌中是否有 VeinMiner 相關錯誤訊息。 需人工實測