跳至主要内容

Nightbreak 帳號綁定與 Token

Nightbreak 管理內容的下載現在透過 MagmaCore 使用共用的 token 流程。

它如何運作​

  1. 打開你的 Nightbreak 帳號頁面。
  2. 產生或複製你的伺服器 token。
  3. 執行：
/nightbreaklogin <token>

成功之後，同一台伺服器上的相容 MagmaGuy 外掛就能共用這個 token 進行 Nightbreak 存取檢查與下載。

MagmaCore 為這個指令註冊的共用權限是 nightbreak.login，預設授予伺服器 OP，除非管理員另外修改。

Token 儲存在哪裡​

Token 會儲存在：

plugins/MagmaCore/nightbreak.yml

的 token 鍵位下，而不是每個外掛自己的私有資料夾裡。

這代表：

  • 你不需要為每個外掛分別重新註冊 token
  • 重新安裝某一個外掛不一定會讓 token 消失
  • 如果刪掉共用的 MagmaCore 設定，你可能需要重新註冊 token

Token 會解鎖什麼​

已綁定的 token 會用來：

  • 檢查伺服器帳號是否能存取某個內容套件
  • 檢查 Nightbreak 管理套件的遠端版本資訊
  • 直接把內容下載到外掛的匯入資料夾
  • 判斷已安裝套件是否過期
  • 啟用 Nightbreak 感知的設定選單狀態

它不會繞過外掛本身仍然需要的條件，例如：

  • 安裝資源包
  • 在設定選單中啟用內容套件
  • 維持依賴項安裝完整

安全注意事項​

  • 把 token 視為伺服器憑證。
  • 不要把它貼在公開聊天、截圖或支援日誌裡。
  • 如果你懷疑它外洩了，請到 Nightbreak 帳號頁面撤銷並產生新 token。
  • 如果 token 的前綴看起來不像 Nightbreak token，MagmaCore 會警告，但仍然會嘗試儲存。

疑難排解​

「No token registered」​

外掛目前還沒看到有效的共用 Nightbreak token。請再次執行 /nightbreaklogin <token>，並確認 plugins/MagmaCore/nightbreak.yml 裡現在有真實 token，而不是缺失值或佔位內容。

「You don't have access to this content」​

Token 是有效的，但目前綁定的 Nightbreak 帳號還沒有解鎖該套件。

某個外掛可以用，另一個不行​

請檢查該外掛自己的設定頁面。有些外掛仍然需要：

  • 先完成首次設定選單
  • 匯入後重新載入
  • 安裝資源包
  • 額外的可選依賴，例如 FreeMinecraftModels 或 ResourcePackManager