手動匯入與遊戲內管理

Nightbreak 管理的外掛程式現在優先使用遊戲內設定和內容管理，但手動匯入仍然作為備用方案存在。

備用方案：手動匯入

手動匯入在以下情況下仍然有用：

您已經下載了套件的 zip 檔案
您正在伺服器之間移動檔案
您想在測試期間脫離 Nightbreak 離線工作
套件被有意在遊戲內下載路徑之外分發

Nightbreak 的批次下載也會進入外掛程式的 imports 資料夾。區別在於遊戲內路徑會為您處理存取檢查和下載步驟。

匯入資料夾對照表

外掛程式	匯入資料夾
EliteMobs	`plugins/EliteMobs/imports`
BetterStructures	`plugins/BetterStructures/imports`
FreeMinecraftModels	`plugins/FreeMinecraftModels/imports`
EternalTD	`plugins/EternalTD/imports`
ResurrectionChest	`plugins/ResurrectionChest/imports`
WorldCannon	`plugins/CannonRTP/imports`

WorldCannon 的外掛程式資料夾名為 CannonRTP —— 那是該外掛程式的內部名稱，它的 imports 資料夾與已安裝內容都放在那裡。

手動匯入規則

除非外掛程式特定文件另有說明，否則保持下載的套件為壓縮狀態。
將套件放入正確的 imports 資料夾。
如果外掛程式特定文件要求，請重新載入或重新啟動外掛程式。
之後重新開啟設定選單以確認安裝狀態。

共享匯入器可以處理：

放置在 imports 中的 .zip 套件
如果包含 pack.meta，則可處理某些已解壓縮的資料夾
FreeMinecraftModels 的 .bbmodel 檔案

封存檔會被解壓縮到 imports 內的一個隱藏暫存資料夾中，並僅從該處安裝。FMM 會在成功或失敗後清理該暫存資料夾，因此一般的匯入失敗只會留下原本的 zip 供你重試，而不會在它旁邊留下可見的半解壓套件。

匯入器接受什麼

`pack.meta` 決定內容的去向

套件可以在頂層提供一個 pack.meta 檔案,指名它所針對的外掛程式平台 —— elitemobs、betterstructures、freeminecraftmodels、eternaltd、extractioncraft、resurrectionchest、megablocksurvivors 或 worldcannon（同時也接受 cannonrtp 或 world_cannon）。該名稱以不分大小寫的方式比對,且會忽略前後空白、換行符號與開頭的位元組順序標記,因此由 Windows 編輯器儲存的檔案也能正常運作。

若封存檔沒有 pack.meta,它會被視為屬於它被丟入之 imports 資料夾所屬外掛程式的套件。

若 pack.meta 指名了匯入器不認得的東西,該套件會被拒絕,而 zip 會被保留在 imports 中,讓你修正後再試一次。

頂層資料夾名稱必須被辨識

匯入器會依名稱把套件中的每個頂層資料夾路由到目的地。有些名稱適用於所有平台：

資料夾	去向
`worldcontainer`	伺服器的世界容器（每個子資料夾成為一個世界）
`models` 或 `modelengine`	FreeMinecraftModels 的 models 資料夾;若只安裝了 ModelEngine 則為其 blueprints 資料夾
`scripts`	`plugins/FreeMinecraftModels/scripts`
`pack.meta`	忽略 —— 它是中繼資料,不是內容

其餘一律依平台解析（例如 EliteMobs 的 custombosses、customitems 與 content_packages;BetterStructures 的 schematics、spawn_pools 與 components）。

匯入器在該平台上無法辨識的頂層資料夾，會導致整個套件被拒絕而非部分安裝,且封存檔會被保留。若你的套件無法匯入,主控台會指出有問題的資料夾。

匯入失敗會回滾

匯入會以單一交易的方式套用。既有檔案在被取代前會先備份，被取代的世界資料夾是被移到旁邊而非刪除，而中途任何失敗都會還原該套件曾動過的每個目的地。zip 會留在 imports 中，因此重試是安全的。如果回滾本身遇到檔案系統錯誤，主控台會明確回報回滾並未完成，並提示你先檢查記錄中的目的地再行重試。

封存檔只有在匯入完全提交之後才會被刪除。如果你在重新載入之後仍看到某個套件留在 imports 中,那就是匯入器在告訴你它沒有安裝成功 —— 請查看主控台了解原因。

重要區別

遊戲內路徑

權杖感知
可以顯示鎖定和過時的內容
批次操作後通常自動重新載入
反映當前預期的管理工作流程

手動路徑

無需遊戲內下載存取即可運作
需要您自己管理 zip 檔案
可能仍需要外掛程式重新載入
根據外掛程式不同，可能會將內容留在已下載但未啟用的狀態
可能會暴露遊戲內存取流程通常在安裝時才會顯示的套件結構問題

推薦：遊戲內管理​

備用方案：手動匯入​

匯入資料夾對照表​

手動匯入規則​

匯入器接受什麼​

pack.meta 決定內容的去向​

頂層資料夾名稱必須被辨識​

匯入失敗會回滾​

重要區別​

遊戲內路徑​

手動路徑​

推薦：遊戲內管理