Nightbreak 帳戶連結和權杖
Nightbreak 管理的內容下載現在透過 MagmaCore 使用共享權杖流程。
如何產生權杖並將其連結到您的伺服器
- 開啟您的 Nightbreak 帳戶頁面。
- 點擊 Generate New Token 按鈕以產生您的伺服器權杖。
- 從帳戶頁面複製該指令並在遊戲中執行：
/nightbreaklogin <token>
- 重新啟動伺服器以完成權杖設定。
成功後，同一伺服器上的相容 MagmaGuy 外掛程式可以使用共享權杖進行 Nightbreak 存取檢查和下載。
每個已載入的外掛程式會在下次存取權杖時檢查共享權杖檔案的修改時間，因此無需重新啟動即可察覺新權杖。不過仍建議以重新啟動作為收尾步驟，因為部分外掛程式的啟動工作 —— 包括自動更新下載 —— 只會在外掛程式啟用期間執行。
MagmaCore 為此命令註冊的共享權限是 nightbreak.login，預設授予伺服器操作員，除非伺服器管理員進行變更。
Nightbreak 核發的權杖以 nbk_ 開頭。若你貼上的內容並非如此，該命令會警告你但仍會儲存。空值以及字面上的預留位置 YOUR_TOKEN_HERE 則會被直接拒絕。
中斷伺服器連結
若要解除某台伺服器與其 Nightbreak 帳戶的連結，請執行：
/nightbreaklogout
它使用與登入相同的 nightbreak.login 權限。它會直接刪除 plugins/MagmaCore/nightbreak.yml，而不是把值清空，因此檔案中不會留下任何權杖副本。已載入的外掛程式會在下次權杖檢查時發現該檔案消失，並在不需重新啟動的情況下退回未連結的行為。
請在把伺服器交給他人之前、把伺服器副本上傳到任何地方之前，或懷疑權杖外洩時使用它。登出只會從這台伺服器移除權杖 —— 若權杖可能已曝光，請同時到 Nightbreak 帳戶頁面撤銷它。
如何將您的 Patreon 或 Itch 帳戶連結到 Nightbreak 帳戶
- 開啟您的 Nightbreak 帳戶頁面。
- 向下捲動到 Linked Accounts 區段，並點擊您想連結之服務的 Link 按鈕。
- 您將被帶到該服務的網頁；若尚未登入，系統會要求您登入，接著直接進入授權視窗，要求您允許 Nightbreak 存取連結帳戶所需的資料。
- 連結帳戶後，只要權杖設定正確，您應該就能在 Nightbreak 帳戶上與遊戲中存取透過該服務取得的內容。
權杖儲存位置
權杖儲存在：
plugins/MagmaCore/nightbreak.yml
位於 token 鍵下，而非各個外掛程式的私有資料夾內。
這表示：
- 您不需要為每個外掛程式單獨註冊權杖
- 重新安裝一個外掛程式不一定會遺失權杖
- 刪除 MagmaCore 的共享設定可能需要您重新註冊權杖
權杖解鎖的功能
已連結的權杖用於：
- 檢查伺服器帳戶是否可以存取內容套件
- 檢查管理套件的遠端版本中繼資料
- 將內容直接下載到外掛程式匯入資料夾
- 偵測已安裝的套件是否過時
- 啟用 Nightbreak 感知的設定選單狀態
它不會繞過外掛程式特定的要求，例如：
- 安裝資源包
- 在設定選單中啟用內容套件
- 保持相依性已安裝
安全須知
- 將權杖視為伺服器憑證。
- 不要在公開聊天、螢幕截圖或支援日誌中發布它。
- 如果您認為它已洩露，請執行
/nightbreaklogout，然後從 Nightbreak 帳戶頁面撤銷它並產生新的。 - 如果權杖不是以
nbk_開頭，MagmaCore 會發出警告，但仍會嘗試儲存它。
疑難排解
"No token registered"
外掛程式尚未偵測到有效的共享 Nightbreak 權杖。再次執行 /nightbreaklogin <token> 並確認 plugins/MagmaCore/nightbreak.yml 現在包含真實的權杖，而不是缺失或佔位符值。如果該檔案根本不存在，代表權杖從未註冊過，或是有人執行了 /nightbreaklogout。
"You don't have access to this content"
權杖有效，但連結的 Nightbreak 帳戶當前未解鎖該套件。
一個外掛程式可以運作，另一個不行
檢查外掛程式特定的設定頁面。某些外掛程式仍然需要：
- 完成首次設定選單
- 匯入後重新載入
- 資源包安裝步驟
- 可選相依性，如 FreeMinecraftModels 或 ResourcePackManager