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

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

直接該当するプラグイン:

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD

これらのプラグインは現在、同じ全体的なライフサイクルを共有しています。

1. プラグインと必須の依存関係をインストールする。
2. ファイルとメニューを生成するためにサーバーを一度起動する。
3. そのプラグインに初回セットアップコマンドがある場合は実行する。
4. /nightbreaklogin <token> で Nightbreak トークンを紐づける。
5. プラグインのセットアップメニューでコンテンツの閲覧、インストール、有効化、無効化、更新を行う。
6. 初期導入を素早く済ませたい場合は、一括ダウンロード/更新コマンドを使う。

MagmaCore が実際に共有しているもの

MagmaCore は、Nightbreak 管理フローの共通レイヤーです。以下を提供します。

• 共通の /nightbreaklogin <token> コマンド
• plugins/MagmaCore/nightbreak.yml での共通トークン保存
• 各プラグインのセットアップメニューで使われる共通 UI/状態管理
• 共通の 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 経由で共有されるため、一度紐づければ対応する MagmaGuy プラグイン全体で再利用できます。

4. 日常的なコンテンツ管理にはセットアップメニューを使う

現在、セットアップメニューが次の状態の信頼できる基準です。

• パッケージ状態
• アクセス状態
• インストール済みかダウンロード済みのみか
• 修復が必要な部分導入状態
• 古いコンテンツ
• カテゴリ別フィルター

トークンを紐づけているなら、コンテンツの導入と更新はセットアップメニューから行うのが推奨です。

5. 速度重視なら一括導入/更新を使う

サーバーを素早く立ち上げたいときは downloadall、古くなったものをまとめて更新したいときは updatecontent を使います。

共通一括ダウンローダーが対象にするのは、次の条件を満たす Nightbreak 管理パッケージだけです。

• Nightbreak slug を持っている
• 紐づけたトークンでアクセス可能
• まだダウンロードされていない、または古いと判定されている

現在の多くのプラグインは、一括ダウンロード成功後に自動でリロードします。

共通概念

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

パッケージはローカルに存在していても、有効化されていない場合があります。意味合いはプラグインごとに多少異なりますが、imports に zip があるかどうかより、セットアップメニュー上の状態を優先して判断してください。

一括ダウンロードも、プラグイン固有の import/reload 処理が完了する前に、手動インポートと同じ各プラグインの imports フォルダへ保存されます。

アクセス対応コンテンツ

セットアップメニューは現在、次の状態を区別できます。

• そのトークンで利用可能
• 購入または解放が必要
• インストール済み
• 部分的にしか導入されていない
• ダウンロード済みだが無効
• 古い

手動インポートは今でも有効

Nightbreak 管理型プラグインは、今でも手動インポートをサポートしています。現在は手動インポートが標準ではなく、フォールバック手段です。詳しくは 手動インポートとゲーム内管理の違い を参照してください。

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

この wiki にある全プラグインが Nightbreak 管理型ダウンロードコンテンツを使うわけではありません。

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