MegaBlock Survivors セットアップ

MegaBlock Survivorsのセットアップフローは、Nightbreakが管理するコンテンツパッケージを中心に構築されており、FreeMinecraftModelsによるオプションのモデルサポートがあります。

必要条件

Java 21
1.21 APIラインのPaper/Spigot互換サーバー

オプションの連携：

FreeMinecraftModels カスタムモブおよび武器モデル用（ソフト依存）

MegaBlock Survivorsが作成するもの

起動時に、MegaBlock Survivorsは以下のパスを初期化または使用します：

plugins/MegaBlockSurvivors/config.yml
plugins/MegaBlockSurvivors/content_packages/
plugins/MegaBlockSurvivors/imports/
plugins/MegaBlockSurvivors/worlds/
plugins/MegaBlockSurvivors/leaderboard.yml
plugins/MegaBlockSurvivors/version.txt

設定

config.yml の内容：

キー	型	デフォルト	説明
`setupDone`	boolean	`false`	初回セットアップガイダンスが完了したかどうかを追跡

初回セットアップの警告

setupDone が false の場合、megablocksurvivors.* 権限を持つプレイヤーがログインすると、プラグインが初回セットアップの警告を表示します。これにより初期コンテンツのダウンロードが案内されます。

推奨される初回セットアップ手順

MegaBlock Survivorsをインストールし、サーバーを一度起動します。
/nightbreaklogin <token> でNightbreakアカウントをリンクします。
/mbs downloadall を実行して、アクセス可能なすべてのMegaBlock Survivorsコンテンツパッケージを plugins/MegaBlockSurvivors/imports にダウンロードします。
/mbs setup を実行して、個別のパッケージの閲覧、有効化、無効化、更新を行います。
コンテンツのダウンロード後に /mbs reload を実行して、新しいマップとリソースを読み込みます。

/nightbreaklogin <token> はNightbreak/MagmaCore共有アカウントフローの一部であり、MegaBlock Survivorsの plugin.yml で宣言されたコマンドではありません。

コンテンツパッケージ

コンテンツパッケージは content_packages/ フォルダ内のYAMLファイルで設定されます。各パッケージは以下を定義できます：

フィールド	型	説明
`isEnabled`	boolean	パッケージが有効かどうか
`name`	string	パッケージの表示名
`description`	string list	説明文
`downloadLink`	string	手動ダウンロードURL
`version`	integer	パッケージのバージョン番号
`nightbreakSlug`	string	自動ダウンロード用のNightbreakコンテンツスラグ
`schematicFiles`	string list	パッケージに含まれるスケマティクスファイル
`worldFolders`	string list	含まれるワールドフォルダ
`worldContainerFolders`	string list	含まれるワールドコンテナフォルダ
`modelFolders`	string list	FreeMinecraftModels用のモデルフォルダ
`markerFileName`	string	パッケージがインストールされているか検出するためのマーカーファイル
`category`	enum	`FREE`、`PREMIUM`、または `RESOURCES`
`toggleable`	boolean	パッケージのオン/オフを切り替えられるかどうか

バージョン更新通知

プラグインがバージョン更新を検出すると（version.txt との比較）、コンソールとすべてのオンラインOPにバージョン変更を通知します。

必要条件​

MegaBlock Survivorsが作成するもの​

設定​

初回セットアップの警告​

推奨される初回セットアップ手順​

コンテンツパッケージ​

バージョン更新通知​