Nightbreakセットアップとコンテンツ管理

このページは、Nightbreak管理プラグインの共有セットアップガイドです。

以下のプラグインに直接適用されます：

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD

これらのプラグインは、同じ全体的なライフサイクルを共有するようになりました：

1. プラグインと必須の依存関係をインストールします。
2. ファイルとメニューが生成されるように、サーバーを一度起動します。
3. プラグインに初回セットアップコマンドがある場合は実行します。
4. /nightbreaklogin <token> でNightbreakトークンをリンクします。
5. プラグインのセットアップメニューを使用して、コンテンツの閲覧、インストール、有効化、無効化、更新を行います。
6. より速い初期ブートストラップが必要な場合は、プラグインの一括ダウンロード/更新コマンドを使用します。

MagmaCoreが実際に共有するもの

MagmaCoreは、Nightbreak管理フローの背後にある共有レイヤーです。以下を提供します：

• 共有コマンド /nightbreaklogin <token>
• plugins/MagmaCore/nightbreak.yml での共有トークン保存
• プラグインセットアップメニューで使用される共有セットアップメニュープリミティブ
• 共有のNightbreakアクセス、バージョン、ダウンロードチェック
• 所有プラグインの imports フォルダにファイルをダウンロードする共有一括ダウンロードロジック

/em initialize や /bs setup などのプラグイン固有のコマンドは、各プラグインによって実装されます。MagmaCoreは、これらのコマンドが使用する共有システムを提供します。

共有初回パターン

現在のほとんどのNightbreak管理プラグインは以下を公開します：

プラグイン	初回コマンド	セットアップメニュー	一括インストール	一括更新
EliteMobs	/em initialize	/em setup	/em downloadall	/em updatecontent
BetterStructures	/bs initialize	/bs setup	/bs downloadall	/bs updatecontent
FreeMinecraftModels	/fmm initialize	/fmm setup	/fmm downloadall	/fmm updatecontent
EternalTD	/etd initialize	/etd setup	/etd downloadall	/etd updatecontent

initialize は初回ガイダンスフローです。プラグイン固有のセットアップメニューやコンテンツ管理コマンドを置き換えるものではありません。

MagmaCoreにはプラグイン起動時の別の初期化システムもありますが、ここで説明されているプレイヤー向けの initialize コマンドとは異なります。

サーバーオーナー向け推奨フロー

1. まずプラグインをインストールする

プラグインのjarファイルと必要な依存関係を plugins/ に配置し、サーバーを一度起動します。

2. 初回セットアップフローを実行する

プラグインが initialize コマンドを提供している場合は、最初に使用してください。現在のメニューは以下のように設計されています：

• 初回セットアップを完了済みとしてマークする
• Nightbreakアカウント連携を案内する
• 現在のセットアップメニューに誘導する
• 手動インポートがまだ有効な場合を明確にする

初回メニューの動作自体は共有されていますが、正確なコマンド名とフォローアップロジックはプラグイン固有のままです。

3. Nightbreakアカウントをリンクする

Nightbreakアカウントページにアクセスし、サーバートークンを取得して、以下を実行します：

/nightbreaklogin <token>

トークンはMagmaCoreを通じて共有されるため、リンクされた1つのトークンを、そのサーバー上のすべての互換性のあるMagmaGuyプラグインで再利用できます。

4. 日常のコンテンツ管理にはセットアップメニューを使用する

セットアップメニューは、以下の現在の正式なソースです：

• パッケージの状態
• アクセスの状態
• インストール済み vs ダウンロード済みのコンテンツ
• 修復が必要な部分的にインストールされたコンテンツ
• 古くなったコンテンツ
• カテゴリ別のコンテンツフィルター

リンクされたトークンがある場合、セットアップメニューはコンテンツのインストールと更新に推奨される場所です。

5. 速度が必要な場合は一括インストール/更新を使用する

サーバーを素早くセットアップしたい場合は downloadall コマンドを、古くなったすべてのコンテンツを更新したい場合は updatecontent コマンドを使用します。

共有一括ダウンローダーは、以下のNightbreak管理パッケージのみを試行します：

• Nightbreakスラッグを持つ
• リンクされたトークンでアクセス可能
• まだダウンロードされていない、または古いとマークされている

現在のほとんどのプラグインは、一括ダウンロード成功後に自動的にリロードされます。

共有コンセプト

ダウンロード済み vs インストール済み

パッケージは、有効化されていなくてもローカルに存在できます。正確な意味はプラグインによってわずかに異なりますが、imports にzipが存在するかどうかよりも、セットアップメニューの状態が重要です。

一括ダウンロードも、プラグイン固有のインポート/リロードステップが完了する前に、手動インポートで使用されるのと同じプラグインの imports フォルダに保存されます。

アクセス対応コンテンツ

セットアップメニューは、以下のコンテンツを区別できるようになりました：

• トークンで利用可能
• 購入またはアンロックが必要
• インストール済み
• 部分的にのみインストール済み
• ダウンロード済みだが無効
• 古くなっている

手動インポートは引き続き有効

Nightbreak管理プラグインは、手動インポートワークフローを引き続きサポートしています。手動インポートは現在、デフォルトパスではなくフォールバックパスです。手動インポートとゲーム内管理の比較を参照してください。

このフローを使用しないプラグイン

このWikiのすべてのプラグインがNightbreak管理のダウンロード可能なコンテンツを使用するわけではありません。

• BetterFoodはNightbreakパッケージ管理を使用しません
• ResurrectionChestはNightbreakパッケージ管理を使用しません
• WorldCannonはNightbreakパッケージ管理を使用しません
• ResourcePackManagerはリソースパックを管理し、Nightbreak DLCパッケージは管理しません