Nightbreak 帳戶連結和權杖
Nightbreak 管理的內容下載透過 MagmaCore 使用共享的帳戶權杖。只需連結一次伺服器，該伺服器上所有相容的 MagmaGuy 外掛程式都會使用同一個權杖。
從瀏覽器連結伺服器
- 在遊戲內或從主控台執行不帶權杖的
/nightbreaklogin。 - 伺服器會顯示一個 nightbreak.io 連結和一組代碼，例如
K7QF-9XMB。在遊戲內，該連結可以點擊。 - 開啟連結，登入或建立免費的 Nightbreak 帳戶，確認頁面顯示的代碼與伺服器上的相同，然後核准伺服器。
- 幾秒內，伺服器會儲存您的帳戶權杖，顯示它現在連結的帳戶名稱，並提醒您
/nightbreaklogout會中斷連結。 - 重新啟動伺服器以完成設定。
連結會在 30 分鐘後失效。若連結已失效或被拒絕，請再次執行 /nightbreaklogin 取得新的連結。發起新的連結會取消前一個。
核准頁面會列出提出請求的伺服器、外掛程式和 Minecraft 版本。若該伺服器所在的網路與您的權杖所綁定的網路不同，頁面會警告，連結會使您位於舊網路的伺服器被鎖定，最長達 48 小時。
核准會把您的帳戶已有的權杖交給該伺服器，因此您先前連結的伺服器仍可繼續運作。沒有權杖的帳戶會獲得一個。若您的權杖是在伺服器連結功能出現之前建立的，頁面會詢問是否要取代它。取代後，所有使用舊權杖的伺服器都會被中斷連結，直到您重新連結它們為止。
已有可用權杖的伺服器不會自行切換帳戶。核准後，它會保留舊權杖，並請您在 5 分鐘內執行 /nightbreaklogin confirm 進行切換。若 Nightbreak 先前已拒絕已儲存的權杖，核准的連結會立即取代它。
BetterStructures、FreeMinecraftModels、EternalTD、CannonRTP 和 ResurrectionChest 的首次設定選單中的 Recommended Setup 選項，會在伺服器尚未連結時為您發起連結。
若伺服器無法連線到 nightbreak.io，或連結功能無法使用，指令會告知這一點，並引導您使用下方的權杖方式。
如何產生權杖並將其連結到您的伺服器
權杖方式仍然可用，例如用於自動化設定，或無法發起連結時。
- 開啟您的 Nightbreak 帳戶頁面。
- 點擊 Generate New Token 按鈕以產生您的伺服器權杖。
- 從帳戶頁面複製該指令並在遊戲中執行：
/nightbreaklogin <token>
- 重新啟動伺服器以完成權杖設定。
Generate New Token 會取代並使舊權杖失效；撤銷已外洩的權杖時也使用此操作。既有權杖會被隱藏，無法再次複製。請安全儲存新產生的指令，並更新每一台使用舊權杖的伺服器，或用 /nightbreaklogin 逐一重新連結。
權杖儲存後，無論是透過連結還是透過此指令，同一伺服器上的相容 MagmaGuy 外掛程式都可以使用它進行 Nightbreak 存取檢查和下載。
登入成功訊息只確認權杖已儲存在本機。指令不會立即驗證經過認證的存取權限。請開啟內容選單或要求一次有權限的下載，確認 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 感知的設定選單狀態
- 在遊戲內下載外掛程式 jar，包括外掛程式更新，以及從
/nightbreak plugins下載缺少的外掛程式。Nightbreak 只允許支持者進行這些下載；對外掛程式更新而言，這代表需要有效的支持者 Patreon 會籍
它不會繞過外掛程式特定的要求，例如：
- 安裝資源包
- 在設定選單中啟用內容套件
- 保持相依性已安裝
安全須知
- 將權杖視為伺服器憑證。
- 不要在公開聊天、螢幕截圖或支援日誌中發布它。
- 如果您認為它已洩露，請執行
/nightbreaklogout，然後從 Nightbreak 帳戶頁面撤銷它並產生新的。 - 如果權杖不是以
nbk_開頭，MagmaCore 會發出警告，但仍會嘗試儲存它。 - 只核准您自己發起的連結，並確認頁面上的代碼與您的伺服器相符。任何看到某個連結代碼的人，都可以把自己的帳戶核准到該伺服器上；而他人傳給您的連結，會把對方的伺服器連結到您的帳戶。
- 要取消某次連結，請在該伺服器上執行
/nightbreaklogout。要切斷您已無法控制的伺服器，請在帳戶頁面產生新的權杖。舊權杖隨後會在所有地方失效，因此請重新連結您自己的伺服器。
疑難排解
"No token registered"
外掛程式尚未偵測到有效的共享 Nightbreak 權杖。再次使用 /nightbreaklogin 或 /nightbreaklogin <token> 連結伺服器，並確認 plugins/MagmaCore/nightbreak.yml 現在包含真實的權杖，而不是缺失或佔位符值。如果該檔案根本不存在，代表權杖從未註冊過，或是有人執行了 /nightbreaklogout。
"The saved account token needs to be updated"
Nightbreak 拒絕了已儲存的權杖，例如因為已有較新的權杖取代了它。主控台會記錄第一次遭拒的情況及伺服器的回應，並隱藏之後的權杖錯誤。在您註冊新的權杖之前，內容下載、外掛程式更新下載以及遊戲內的外掛程式安裝都會以此訊息中止。請執行 /nightbreaklogin 並核准連結，這會立即取代被拒絕的權杖；或在 Nightbreak 帳戶頁面產生新的權杖，並執行 /nightbreaklogin <token>。
/nightbreaklogin 要求輸入權杖
最先載入的 Nightbreak 外掛程式會註冊 /nightbreaklogin，而在這台伺服器上，該外掛程式的版本早於伺服器連結功能，因此指令只接受權杖。請更新您的 Nightbreak 外掛程式，或使用權杖方式。
伺服器無法發起連結
指令無法連線到 nightbreak.io、連結功能目前無法使用，或是伺服器在幾分鐘內要求了過多的連結。訊息會指出原因，並顯示權杖方式。請等待幾分鐘後再試，或改用權杖連結。
連結已失效或被拒絕
請再次執行 /nightbreaklogin 取得新的連結。連結的有效期為 30 分鐘，而且一旦有人在頁面上拒絕它，伺服器就會立即停止等待。
連結已核准，但伺服器保留了舊帳戶
伺服器原本已有可用的權杖。請在核准後 5 分鐘內執行 /nightbreaklogin confirm 以切換到新帳戶，或忽略它以保留舊帳戶。
"You don't have access to this content"
權杖有效，但連結的 Nightbreak 帳戶當前未解鎖該套件。
一個外掛程式可以運作，另一個不行
檢查外掛程式特定的設定頁面。某些外掛程式仍然需要：
- 完成首次設定選單
- 匯入後重新載入
- 資源包安裝步驟
- 可選相依性，如 FreeMinecraftModels 或 ResourcePackManager