メインコンテンツまでスキップ

Nightbreakアカウント連携とトークン

Nightbreak管理のコンテンツダウンロードは、MagmaCoreを通じた共有トークンフローを使用するようになりました。

トークンを生成してサーバーに連携する方法​

  1. Nightbreakアカウントページを開きます。
  2. Generate New Tokenボタンをクリックしてサーバートークンを生成します。
image
  1. アカウントページからコマンドをコピーし、ゲーム内で実行します：
/nightbreaklogin <token>
  1. サーバーを再起動してトークンのセットアップを完了します。

成功すると、同じサーバー上の互換性のあるMagmaGuyプラグインが、Nightbreakアクセスチェックとダウンロードに共有トークンを使用できます。

各プラグインは共有トークンファイルが変更されるたびに再読み込みするため、既に読み込まれているプラグインも再起動なしで新しいトークンを認識します。それでも仕上げとして再起動を推奨します。自動アップデートのダウンロードを含む一部のプラグイン起動処理は、プラグインの有効化中にしか実行されないためです。

MagmaCoreがこのコマンドに登録する共有パーミッションは nightbreak.login で、サーバー管理者が変更しない限り、デフォルトでサーバーオペレーターに付与されます。

Nightbreakが発行するトークンは nbk_ で始まります。それ以外のものを貼り付けた場合、コマンドは警告を出したうえで保存します。空の値と、プレースホルダーそのものである YOUR_TOKEN_HERE は明確に拒否されます。

サーバーの接続解除​

サーバーとNightbreakアカウントの連携を解除するには、次を実行します：

/nightbreaklogout

これはログインと同じ nightbreak.login パーミッションを使用します。値を空にするのではなく plugins/MagmaCore/nightbreak.yml を丸ごと削除するため、ファイル内にトークンのコピーが残ることはありません。読み込み済みのプラグインは次回のトークンチェック時にファイルが消えたことを検出し、再起動なしで未連携時の動作に戻ります。

サーバーを他人に譲渡する前、サーバーのコピーをどこかにアップロードする前、あるいはトークンが漏洩した疑いがある場合に使用してください。ログアウトはこのサーバーからトークンを削除するだけです — 漏洩の可能性がある場合は、Nightbreakアカウントページでも失効させてください。

PatreonまたはItchアカウントをNightbreakアカウントに連携する方法​

  1. Nightbreakアカウントページを開きます。
  2. Linked Accountsセクションまでスクロールし、連携したいサービスのLinkボタンをクリックします。
image
  1. サービスのウェブページに移動し、未ログインの場合はログインを求められた後、アカウント連携に必要なデータへのアクセスをNightbreakに許可するための認可画面に直接移動します。
  2. アカウントを連携すると、そのサービス経由で取得したコンテンツに、Nightbreakアカウント上でアクセスできるようになり、トークンが正しく設定されていればゲーム内でもアクセスできるようになります。

トークンの保存場所​

トークンは以下に保存されます：

plugins/MagmaCore/nightbreak.yml

各プラグインのプライベートフォルダ内ではなく、token キーの下に保存されます。

これは以下を意味します：

  • プラグインごとに個別にトークンを登録する必要はありません
  • 1つのプラグインを再インストールしても、必ずしもトークンは失われません
  • 共有のMagmaCore設定を削除すると、トークンの再登録が必要になる場合があります

トークンが解除するもの​

リンクされたトークンは以下に使用されます：

  • サーバーアカウントがコンテンツパッケージにアクセスできるかの確認
  • 管理パッケージのリモートバージョンメタデータの確認
  • プラグインのインポートフォルダへのコンテンツの直接ダウンロード
  • インストール済みパッケージが古くなっているかの検出
  • Nightbreak対応のセットアップメニューステータスの有効化

以下のようなプラグイン固有の要件はバイパスしません：

  • リソースパックのインストール
  • セットアップメニューでのコンテンツパッケージの有効化
  • 依存関係のインストール維持

セキュリティに関する注意​

  • トークンをサーバーの認証情報として扱ってください。
  • 公開チャット、スクリーンショット、サポートログに投稿しないでください。
  • 漏洩したと思われる場合は、/nightbreaklogout を実行したうえで、Nightbreakアカウントページから失効させ、新しいものを生成してください。
  • MagmaCoreはトークンが nbk_ で始まらない場合に警告しますが、それでも保存を試みます。

トラブルシューティング​

"No token registered"​

プラグインはまだ有効な共有Nightbreakトークンを検出していません。/nightbreaklogin <token> を再度実行し、plugins/MagmaCore/nightbreak.yml に欠損値やプレースホルダー値ではなく実際のトークンが含まれていることを確認してください。ファイル自体が存在しない場合は、トークンが登録されたことがないか、誰かが /nightbreaklogout を実行したかのどちらかです。

"You don't have access to this content"​

トークンは有効ですが、リンクされたNightbreakアカウントは現在そのパッケージをアンロックしていません。

1つのプラグインは動作するが、別のプラグインは動作しない​

プラグイン固有のセットアップページを確認してください。一部のプラグインでは以下がまだ必要です：

  • 初回セットアップメニューの完了
  • インポート後のリロード
  • リソースパックのインストールステップ
  • FreeMinecraftModelsやResourcePackManagerなどのオプション依存関係