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/`	已轉換結構圖的受管快取，可安全刪除

config.yml

結構間距

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` 可停用。

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

高度界限

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

鍵	預設值	說明
`lowestYNormalCustom`	`-60`	`NORMAL` 與 `CUSTOM` 世界的最低 Y
`highestYNormalCustom`	`320`	`NORMAL` 與 `CUSTOM` 世界的最高 Y
`lowestYNether`	`4`	地獄中的最低 Y
`highestYNether`	`120`	地獄中的最高 Y
`lowestYEnd`	`0`	終界中的最低 Y
`highestYEnd`	`320`	終界中的最高 Y

天空結構使用自己的設定，而且這些是在該直行最高方塊之上的偏移量，不是絕對的 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`	當伺服器任何地方有結構完成貼上或模組化地城開始生成時，是否向持有 `betterstructures.warn`（預設為 OP）的線上玩家發送可點擊的傳送訊息。`/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` 中自動更新切換開關背後的鍵。已下載的內容與外掛更新會在下次重新啟動後使用，除非 `nightbreak.applyPluginUpdatesWithoutRestart` 更早套用外掛更新。
`nightbreak.applyPluginUpdatesWithoutRestart`	`never`	已下載的外掛更新何時套用。`never` 會等到下次重新啟動。`when-empty` 會在下次沒有玩家在線時套用，每 30 秒檢查一次。`immediately` 會在下載完成後立即套用。其他任何數值都視為 `never`。套用更新會重新載入 BetterStructures 以及依賴它的 MagmaGuy 外掛，因此進行中的 Boss、競技場與地城實例都會結束。若有其他作者的外掛依賴 BetterStructures，則無法進行替換。`/bs applypluginupdate` 可隨時套用待套用的更新。

ValidWorlds.yml

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

New worlds spawn structures: true
Valid worlds v2:
  world: true
  world_nether: true
  world_the_end: true

鍵	預設值	說明
`New worlds spawn structures`	`true`	BetterStructures 尚未見過的世界是否會被註冊為啟用
`Valid worlds v2`	自動填入	每個世界一筆 `worldname: true/false` 條目。把某個世界設為 `false` 即可停止在其中生成所有結構。

升級時，含有舊鍵 Valid worlds 的 ValidWorlds.yml 會完整移至 plugins/MagmaCore/outdated files/BetterStructures/<archive batch>/ValidWorlds.yml。BetterStructures 會依照目前的世界預設值產生替代檔案。請查看封存檔中的原有設定，把想保留的選項重新填入 Valid worlds v2，然後執行 /bs reload。不要將舊檔原樣放回，否則它仍會被識別為已淘汰的格式。

自動行為

新世界會在載入時註冊。 首次載入的世界會立即被寫入一筆條目，其值取自 New worlds spawn structures。
由 EliteMobs 管理的世界會被排除。 即使 New worlds spawn structures 為 true，冒險者公會樞紐與副本地城的複本仍會被註冊為 false，因為它們未建構的虛空區塊會被算作新區塊，導致 BetterStructures 在地城樞紐上加裝結構。條目仍會寫入，因此如果你確實想要，把它改回 true 是有效的。
保留目前格式的設定。 BetterStructures 不會根據 em_ 名稱推斷世界歸屬，也不會改寫既有的 Valid worlds v2 開關。它使用 EliteMobs 的世界登錄資料決定新世界的預設值。明確啟用的 EliteMobs 世界會保持啟用，並顯示警告，讓你決定是否更改。舊的 Valid worlds 檔案則依上述流程封存並重新產生。
失效條目會被清除。 在啟動時，以及世界卸載後約十秒，其世界既未載入也不存在於磁碟上的條目會被移除，以免檔案無限膨脹。

資料夾結構​

config.yml

結構間距​

出生點保護​

高度界限​

效能​

管理與整合​