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

Nightbreak管理のコンテンツダウンロードは、MagmaCoreを通じた共有アカウントトークンを使用します。サーバーを一度リンクすれば、そのサーバー上の互換性のあるMagmaGuyプラグインはすべて同じトークンを使います。

ブラウザからサーバーをリンクする

1. ゲーム内またはコンソールから、トークンを付けずに /nightbreaklogin を実行します。
2. サーバーがnightbreak.ioのリンクと、K7QF-9XMB のようなコードを表示します。ゲーム内では、リンクをクリックできます。
3. リンクを開き、サインインするか無料のNightbreakアカウントを作成して、ページに表示されているコードがサーバーのコードと同じであることを確認し、サーバーを承認します。
4. 数秒以内に、サーバーがあなたのアカウントトークンを保存し、リンク先になったアカウントの名前を表示して、/nightbreaklogout で接続を解除できることを改めて知らせます。
5. サーバーを再起動してセットアップを完了します。

リンクは30分で期限切れになります。期限が切れたり拒否されたりした場合は、もう一度 /nightbreaklogin を実行して新しいリンクを取得してください。新しいリンクを開始すると、前のリンクはキャンセルされます。

承認ページには、リンクを要求したサーバー、プラグイン、Minecraftバージョンが表示されます。サーバーが、あなたのトークンが結び付けられているネットワークとは別のネットワーク上にある場合、ページは、リンクすると古いネットワーク上のあなたのサーバーが最大48時間ロックアウトされると警告します。

承認すると、アカウントがすでに持っているトークンがサーバーに渡されるため、以前にリンクしたサーバーも引き続き動作します。トークンを持たないアカウントには、トークンが発行されます。トークンがサーバーリンクの導入前に作成されたものである場合、ページはそのトークンの置き換えを求めます。置き換えると、古いトークンを使っていたすべてのサーバーは、もう一度リンクするまで接続が解除されます。

すでに有効なトークンを持つサーバーが、自動でアカウントを切り替えることはありません。承認後もサーバーは古いトークンを保持し、切り替えるには5分以内に /nightbreaklogin confirm を実行するよう求めます。Nightbreakが保存済みのトークンを拒否していた場合は、承認されたリンクがそれを直ちに置き換えます。

BetterStructures、FreeMinecraftModels、EternalTD、CannonRTP、ResurrectionChestの初回セットアップメニューにあるRecommended Setupオプションは、サーバーがまだリンクされていない場合、代わりにリンクを開始します。

サーバーがnightbreak.ioに接続できない場合や、サーバーリンクを利用できない場合は、コマンドがその旨を伝え、下記のトークン方式を案内します。

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

トークン方式も引き続き利用できます。たとえば、自動化されたセットアップの場合や、リンクを開始できない場合です。

1. Nightbreakアカウントページを開きます。
2. Generate New Tokenボタンをクリックしてサーバートークンを生成します。

3. アカウントページからコマンドをコピーし、ゲーム内で実行します：

/nightbreaklogin <token>

4. サーバーを再起動してトークンのセットアップを完了します。

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アカウントに連携する方法

1. Nightbreakアカウントページを開きます。
2. Linked Accountsセクションまでスクロールし、連携したいサービスのLinkボタンをクリックします。

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

トークンの保存場所

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

plugins/MagmaCore/nightbreak.yml

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

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

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

トークンで利用できる機能

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

• サーバーアカウントがコンテンツパッケージにアクセスできるかの確認
• 管理パッケージのリモートバージョンメタデータの確認
• プラグインのインポートフォルダへのコンテンツの直接ダウンロード
• インストール済みパッケージが古くなっているかの検出
• Nightbreak対応のセットアップメニューステータスの有効化
• ゲーム内でのプラグインjarのダウンロード（プラグインの更新と、/nightbreak pluginsからの未導入プラグインの両方）。Nightbreakはこれらのダウンロードをサポーターにのみ許可しています。プラグインの更新の場合、有効なPatreonサポーターメンバーシップが必要です

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

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

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

• トークンをサーバーの認証情報として扱ってください。
• 公開チャット、スクリーンショット、サポートログに投稿しないでください。
• 漏洩したと思われる場合は、/nightbreaklogout を実行したうえで、Nightbreakアカウントページから失効させ、新しいものを生成してください。
• MagmaCoreはトークンが nbk_ で始まらない場合に警告しますが、それでも保存を試みます。
• 自分で開始したリンクだけを承認し、ページのコードが自分のサーバーのコードと一致することを確認してください。リンクのコードを見た人は誰でも、自分のアカウントでそのサーバーを承認できます。また、他の人から送られてきたリンクを承認すると、その人のサーバーをあなたのアカウントに接続することになります。
• リンクを取り消すには、そのサーバーで /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 がトークンを求める

/nightbreaklogin は最初にロードされたNightbreakプラグインが登録します。このサーバーではそのプラグインがサーバーリンクの導入より前のバージョンのため、コマンドはトークンしか受け付けません。Nightbreakプラグインを更新するか、トークン方式を使ってください。

サーバーがリンクを開始できない

コマンドがnightbreak.ioに接続できなかったか、サーバーリンクが現在利用できないか、サーバーが数分の間にリンクを要求しすぎたかのいずれかです。メッセージには原因が示され、トークン方式が表示されます。数分待ってからもう一度試すか、トークンでリンクしてください。

リンクの期限が切れた、または拒否された

もう一度 /nightbreaklogin を実行して新しいリンクを取得してください。リンクの有効期間は30分で、ページで誰かが拒否した時点で、サーバーは待機を止めます。

リンクは承認されたが、サーバーが古いアカウントのままになっている

サーバーはすでに有効なトークンを持っていました。承認から5分以内に /nightbreaklogin confirm を実行すると、新しいアカウントに切り替わります。無視すれば、古いアカウントのままです。

"You don't have access to this content"

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

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

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

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