BetterStructures 設定檔

本頁是 BetterStructures 寫入 plugins/BetterStructures 的兩個外掛層級設定檔的參考文件。內容層級的設定則位於別處：請參閱建立生成器、建立結構、建立寶藏與模組化地城。

每當你執行 /bs reload 時，這兩個檔案都會在伺服器主執行緒上重新讀取，因此套用這裡的變更不需要重新啟動。

資料夾結構

路徑	內容
`config.yml`	外掛全域設定，詳述於下方
`ValidWorlds.yml`	各世界的開關，詳述於下方
`schematics/`	結構的 `.schem` 檔案及其產生的 `.yml` 設定檔，會遞迴掃描
`modules/`	模組化地城的 `.schem` 檔案及其產生的 `.yml` 設定檔，會遞迴掃描
`generators/`	生成器設定檔
`module_generators/`	模組生成器設定檔
`treasures/`	寶藏（戰利品表）設定檔
`spawn_pools/`	由 `[pool: name]` 告示牌使用的生成池設定檔
`content_packages/`	設定選單與下載指令所使用的套件描述檔
`components/`	啟動時建立的空資料夾，供隨附支援元件的內容使用
`imports/`	手動內容匯入的放置資料夾
`.schematic_cache/`	已轉換結構圖的受管快取，可安全刪除

BetterStructures 會將結構放置在以種子產生的菱形網格上，每種結構類型各有一個網格。距離鍵設定網格點之間的間隔，而偏移鍵則讓每個點偏離網格，使配置看起來不會太機械化。

兩者都以區塊（chunk）為單位，而非方塊。 distanceSurface 為 27 表示大約每 27 個區塊會有一個地表結構（約 432 個方塊）。

鍵	預設值	說明
`distanceSurface`	`27`	`SURFACE` 結構的網格間距
`distanceShallow`	`22`	`UNDERGROUND_SHALLOW` 結構的網格間距
`distanceDeep`	`22`	`UNDERGROUND_DEEP` 結構的網格間距
`distanceSky`	`90`	`SKY` 結構的網格間距
`distanceLiquid`	`60`	`LIQUID_SURFACE` 結構的網格間距
`distanceDungeonV2`	`80`	`DUNGEON` 放置的網格間距
`maxOffsetSurface`	`5`	套用於地表網格點的隨機偏移
`maxOffsetShallow`	`5`	套用於淺層地下網格點的隨機偏移
`maxOffsetDeep`	`5`	套用於深層地下網格點的隨機偏移
`maxOffsetSky`	`5`	套用於天空網格點的隨機偏移
`maxOffsetLiquid`	`5`	套用於液面網格點的隨機偏移
`maxOffsetDungeonV2`	`18`	套用於地城網格點的隨機偏移

距離越小表示結構越多。偏移越小表示放置越接近網格狀；偏移越大則表示放置越難以預測。

驗證。 距離必須至少為 1。偏移必須介於 0 和 1073741823 之間，也就是放置隨機器能安全使用的最大值。超出範圍的數值會讓 BetterStructures 記錄一則警告、把該鍵的預設值寫回 config.yml，並以預設值繼續執行，而不是讓生成失敗。

偏移是由世界種子與結構類型名稱推導而來，因此相同的種子在每次重新啟動後都會產生相同的配置。

鍵	預設值	說明
`spawnProtectionRadius`	`100`	以方塊為單位、距離座標 `0, 0` 的最小距離，在此範圍內不會放置任何結構。適用於所有世界。設為 `0` 可停用。

請注意這是從世界原點測量，而非從各世界的出生點測量。

這些設定會依維度限制地下結構最終可能出現的位置。錨點會落在範圍之外的結構會被拉回範圍內。

天空結構使用自己的設定，而且這些是在該直行最高方塊之上的偏移量，不是絕對的 Y 高度。每次放置都會在最小值與最大值之間擲出一個隨機值。

鍵	預設值	說明
`normalCustomAirBuildingMinAltitude`	`80`	`NORMAL` 與 `CUSTOM` 世界中的最低天空偏移
`normalCustomAirBuildingMaxAltitude`	`120`	`NORMAL` 與 `CUSTOM` 世界中的最高天空偏移
`endAirBuildMinAltitude`	`80`	終界中的最低天空偏移
`endAirBuildMaxAltitude`	`120`	終界中的最高天空偏移

地獄會忽略這四個設定：該處的天空結構會被放置在掃描 Y 45 到 Y 100 之間所找到的空氣空腔內。

鍵	預設值	說明
`percentageOfTickUsedForPasting`	`0.2`	BetterStructures 可用來貼上方塊的每個伺服器 tick 比例，範圍從 `0.01`（1%）到 `1`（100%）。數值越低越能減少卡頓，但建築物的浮現會更明顯。
`percentageOfTickUsedForPregeneration`	`0.1`	`/bs pregenerate` 使用的每個伺服器 tick 比例，範圍同樣是 `0.01` 到 `1`
`pregenerationTPSPauseThreshold`	`12.0`	當伺服器 TPS 低於此值時，預先生成會暫停
`pregenerationTPSResumeThreshold`	`14.0`	當 TPS 達到或高於此值時，預先生成會恢復。請讓它高於暫停閾值，以避免快速地反覆暫停/恢復。
`modularChunkPastingSpeed`	`10`	目前未使用。此鍵仍會寫入 `config.yml`，但沒有任何程式讀取它，因此更改它不會有任何效果。

鍵	預設值	說明
`warnAdminsAboutNewBuildings`	`true`	當附近生成結構時是否通知管理員。`/bs silent` 會反轉此數值並儲存。
`setupDone`	`false`	首次設定流程是否已完成。設為 `false` 並重新載入，即可讓 `/bs initialize` 再次提示。
`protectEliteMobsRegions`	`true`	BetterStructures 是否為 EliteMobs 支援的戰鬥區域建立 WorldGuard 保護。需要同時安裝 WorldGuard 與 EliteMobs。
`regionProtectedMessage`	`&8[BetterStructures] &cDefeat the zone's bosses to edit blocks!`	當玩家嘗試在這些受保護區域內編輯方塊時顯示的訊息
`nightbreak.autoDownloadPluginUpdates`	`false`	外掛與內容更新是否在啟動時自動下載。這是 `/bs setup` 中 Automatic Updates 切換開關背後的鍵。已下載的外掛更新仍需重新啟動才會套用。

此檔案決定 BetterStructures 會在哪些世界中生成內容。

New worlds spawn structures: true
EliteMobs worlds excluded by default: true
Valid worlds:
  world: true
  world_nether: true
  world_the_end: true

鍵	預設值	說明
`New worlds spawn structures`	`true`	BetterStructures 尚未見過的世界是否會被註冊為啟用
`Valid worlds`	自動填入	每個世界一筆 `worldname: true/false` 條目。把某個世界設為 `false` 即可停止在其中生成所有結構。
`EliteMobs worlds excluded by default`	一次性遷移後寫入為 `true`	內部標記。請勿編輯。

新世界會在載入時註冊。 首次載入的世界會立即被寫入一筆條目，其值取自 New worlds spawn structures。
由 EliteMobs 管理的世界會被排除。 即使 New worlds spawn structures 為 true，冒險者公會樞紐與副本地城的複本仍會被註冊為 false，因為它們未建構的虛空區塊會被算作新區塊，導致 BetterStructures 在地城樞紐上加裝結構。條目仍會寫入，因此如果你確實想要，把它改回 true 是有效的。
既有的 em_ 條目已被遷移過一次。 任何僅因舊有寬鬆預設值而為 true 的 em_ 世界都被翻轉為 false 一次，而 EliteMobs worlds excluded by default 標記則記錄該遷移已經執行過。之後你刻意重新啟用的世界會在重新啟動之間維持啟用。
失效條目會被清除。 在啟動時，以及世界卸載後約十秒，其世界既未載入也不存在於磁碟上的條目會被移除，以免檔案無限膨脹。