什麼是模組化地下城？
模組化地下城是 BetterStructures 2.0.0 及更高版本中引入的地下城系統。 與生成單一固定建築圖不同，模組化地下城從較小的手工製作的模組動態組裝。 這種方法允許大型、多層地下城在每個世界中都獨一無二，同時仍能無縫融入原版 Minecraft。
模組化地下城如何生成
-
模組 每個模組通常以可設定的大小構建（預設 16x16x16 方塊，但部分內容包使用 32x16x32 或其他尺寸）。模組使用標準化的連接點和邊界標籤系統設計，使它們可以與其他模組無縫連接而不會產生間隙或重疊。地下城的尺寸透過模組生成器設定中的
moduleSizeXZ和moduleSizeY設定選項設定。 模組可以包含走廊、房間、樓梯或特殊遭遇戰空間。 -
生成過程 當模組化地下城在新區塊中生成時，BetterStructures 使用波函數坍縮（WFC）演算法從可用池中程序化組裝模組。系統根據邊界標籤匹配隨機選擇相容的模組，並將它們「縫合」成一個完整的地下城。 生成時間因伺服器效能、地下城大小（半徑）、垂直範圍、模組數量和約束複雜度而異。系統使用工作負載分配來防止生成期間的伺服器延遲。
-
地下城大小 地下城可以使用半徑參數設定為各種大小生成。較大的半徑值會建立顯著更大的地下城，可以跨越數百個方塊。 大多數地下城包含多個樓層，透過樓梯模組或垂直通道連接。樓層之間的垂直連接透過設定了
upIsPassable和downIsPassable為 true 的模組實現。
多樣性與內容包整合
-
免費包 Dungeoneering Modules Free Pack 包含 15 個模組。它本身就是一個完全可遊玩的地下城。
-
進階包 Dungeoneering Modules Premium Pack 新增 38 個額外模組。與免費包結合後，兩組模組融合為一個擁有更大模組池的單一地下城系統。 這減少了重複並增加了生成佈局的多樣性。
-
道具整合 如果您同時安裝了 BetterStructures Prop Pack（透過 FreeMinecraftModels），模組化地下城將在建築中顯示自訂模型道具，如我們的展示截圖所示。 沒有道具包的情況下，地下城仍然正常運作，但不會有裝飾模型。
EliteMobs 整合
雖然大部分地下城僅依賴 BetterStructures 和原版 Minecraft 怪物，但某些地下城具有 Boss 遭遇戰：
- 如果同時安裝了 EliteMobs 和 FreeMinecraftModels → 完整的自訂 Boss 戰鬥及模型。
- 如果僅安裝了 FreeMinecraftModels → Boss 模型作為裝飾道具出現。
- 如果都未安裝 → Boss 房間將為空。
系統使用基於告示牌的生成系統，帶有 [spawn] 和 [pool: poolname] 等特殊標籤，將 Boss 放置在指定區域。Boss 等級根據與地下城中心的距離進行縮放，在整個結構中提供適當的挑戰。
如果未安裝 EliteMobs 但內容包需要它，管理員會收到警告訊息。
此設計使模組化地下城與原版風格的設定保持相容，同時為擁有額外外掛程式的使用者提供更深入的整合。
MythicMobs 整合
BetterStructures 也支援 MythicMobs 整合，用於模組化地下城中的自訂怪物遭遇戰。
安裝 MythicMobs 後，結構包可以在地下城生成過程中生成自訂 MythicMobs。這允許比原版 Minecraft 或 EliteMobs 提供的更精密的怪物遭遇戰和 Boss 戰。
如果未安裝 MythicMobs，外掛程式將通知具有適當權限的管理員並提供下載連結。
FMM 整合
模組化地下城也可以利用 FreeMinecraftModels（FMM）道具 來增強建造。
- 如果安裝了 FMM，模組建造者或建築師放置的任何道具都會出現在生成的地下城中。
- 道具純粹是裝飾性的，不影響遊戲玩法，但它們增強了環境的視覺逼真度和沉浸感。
- 如果未安裝 FMM，地下城仍然會正常生成，但這些自訂道具不會顯示。
這確保了建造者可以設計具有額外細節的地下城，同時為未安裝 FMM 的玩家保持相容性。
模組尺寸
重要： 模組大小是可設定的，不是固定的。
每個模組生成器使用以下選項定義其標準模組大小：
moduleSizeXZ：寬度和深度（以方塊為單位，預設：16）moduleSizeY：高度（以方塊為單位，預設：16）
預設大小： 16x16x16 方塊 常見替代方案： 32x16x32 方塊（部分內容包使用）
給模組建造者：
- 檢查您的生成器設定中的
moduleSizeXZ和moduleSizeY值 - 為該生成器建造的所有模組都必須匹配這些確切尺寸
- 尺寸不匹配將導致連接失敗
設定自訂尺寸： 在您的模組生成器設定檔中：
moduleSizeXZ: 32 # Width and depth
moduleSizeY: 16 # Height
注意：生成器中的所有模組必須使用相同的尺寸。您不能在同一個地下城系統中混合使用 16x16x16 和 32x16x32 的模組。
模組生成器設定欄位
除了 moduleSizeXZ 和 moduleSizeY 之外，模組生成器設定支援以下欄位：
| 欄位 | 預設值 | 說明 |
|---|---|---|
radius | 1 | 地下城半徑（以區塊為單位） |
edges | false | 是否生成邊緣模組 |
startModule | — | 用於生成的起始模組列表 |
minChunkY | 0 | 最小垂直區塊邊界 |
maxChunkY | 0 | 最大垂直區塊邊界 |
moduleSizeXZ | 16 | 模組的寬度和深度（以方塊為單位） |
moduleSizeY | 16 | 模組的高度（以方塊為單位） |
debug | false | 啟用除錯模式以排除生成問題 |
useGradientLevels | false | 啟用基於梯度的生成實體等級縮放 |
spawnPoolSuffix | — | 附加到此生成器的生成池名稱的後綴 |
isWorldGeneration | false | 此生成器是否用於世界生成 |
treasureFile | — | 寶藏設定檔案 |
validWorlds | — | 地下城可以生成的有效世界名稱列表 |
validWorldEnvironments | — | 有效的世界環境列表 |
centerModuleAltitude | 0 | 中心模組的高度 |
每個模組的設定欄位
每個單獨的模組可以定義以下設定欄位：
| 欄位 | 預設值 | 說明 |
|---|---|---|
isEnabled | true | 此模組是否啟用 |
weight | 100 | 生成期間此模組的選擇權重 |
repetitionPenalty | 0 | 此模組被多次選擇時施加的懲罰 |
noRepeat | false | 防止此模組重複 |
northIsPassable | true | 北面是否允許連接 |
southIsPassable | true | 南面是否允許連接 |
eastIsPassable | true | 東面是否允許連接 |
westIsPassable | true | 西面是否允許連接 |
upIsPassable | true | 頂面是否允許連接 |
downIsPassable | true | 底面是否允許連接 |
enforceVerticalRotation | false | 強制垂直旋轉約束 |
enforceHorizontalRotation | false | 強制水平旋轉約束 |
minY | -4 | 此模組的最小 Y 層級 |
maxY | 20 | 此模組的最大 Y 層級 |
biome | default | 此模組的生態域要求 |
minecraftBiome | null | 此模組的 Minecraft 生態域要求 |
treasureFile | — | 此模組的寶藏設定檔案 |
borders | — | 定義連接相容性的邊界標籤映射 |
cloneConfig | — | 從另一個模組設定檔案複製設定 |
compoundModule | — | 將此模組連結為複合（多部分）模組的一部分 |
isAutomaticallyPlaced | true | 此模組是否在生成期間自動放置 |