BetterStructuresコンテンツパッケージ
BetterStructuresは公式コンテンツを、純粋な手動インポートワークフローではなく、管理されたパッケージとして扱うようになりました。
主要コマンド
| コマンド | 目的 |
|---|---|
/bs initialize | 初回セットアップフロー |
/bs setup | パッケージの状態を閲覧・管理 |
/bs downloadall | プラグインの更新（ある場合）と利用可能なすべてのコンテンツをダウンロードし、リロード |
/bs downloadallcontent | 利用可能なすべてのコンテンツのみをダウンロード（プラグインの更新は行わない） |
/bs updatecontent | 古いコンテンツを更新（エイリアス：/bs updateallcontent） |
/bs forcereinstallcontent <package|all> | インストール済みのバージョンがすでに最新であってもコンテンツを再ダウンロード。破損したり一部削除されたりしたパック向けの修復コマンドです |
/bs recommendedplugins | BetterStructuresと相性の良いコンパニオンプラグインを一覧表示 |
/nightbreaklogin <token> | 共有Nightbreakトークン登録 |
これらのコンテンツコマンドは、BetterStructuresに同梱されている共有のMagmaCore Nightbreakシステムに由来するため、同じライフサイクル（トークンチェック、アクセスチェック、ダウンロード、自動リロード）がMagmaGuyのプラグイン全体で同一になっています。
パッケージタイプ
各パッケージはcontentPackageTypeを宣言し、セットアップメニューはタイプごとに1つのフィルターを提供します：
contentPackageType | セットアップメニューのフィルター | ファイルの配置先 |
|---|---|---|
STRUCTURE（デフォルト） | Structure Packs | plugins/BetterStructures/schematics/<folderNameV2> |
MODULAR | Module Packs | plugins/BetterStructures/modules/<folderNameV2> |
古い静的リストに頼らず、/bs setupを使用してパッケージをフィルタリングおよび検査してください。
パッケージ設定のフィールド
各パッケージはplugins/BetterStructures/content_packages内の設定ファイルで記述されます。これらを手作業で編集する必要はほとんどありません（プラグインに同梱されており、パッケージの状態を追跡する仕組みそのものです）が、各フィールドは次のとおりです：
| キー | デフォルト | 説明 |
|---|---|---|
isEnabled | true | パッケージのコンテンツが有効かどうか。セットアップメニューからインストールまたはアンインストールすると自動的に切り替わります。 |
name | — | セットアップメニューに表示される表示名 |
description | — | セットアップメニューに表示される説明行 |
downloadLink | — | パッケージの取得元 |
version | 0 | ローカルのコンテンツバージョン。リモートのバージョンと比較して、パッケージが古いかどうかを判断します |
folderNameV2 | — | タイプに応じてschematicsまたはmodulesの下に置かれる、パッケージのファイルが入るサブフォルダ |
contentPackageType | STRUCTURE | STRUCTUREまたはMODULAR |
nightbreakSlug | — | アクセスチェックとダウンロードに使われ、/bs forcereinstallcontentのセレクタにもなるNightbreak識別子 |
STRUCTUREパッケージをインストールまたはアンインストールすると、そのフォルダ内のすべてのスケマティック設定のisEnabledも切り替わり、その後リロードが実行されます。MODULARパッケージはパッケージ単位でのみ切り替えられます。
パッケージの状態
パッケージとトークンの状態に応じて、BetterStructuresは以下を区別できます：
- インストール済みコンテンツ
- ダウンロード済みだが有効化されていないコンテンツ
- 古いコンテンツ
- Nightbreakアクセスが必要なコンテンツ
つまり、プラグインがインストール済みと認識している内容を確認するには、セットアップメニューが現在最良の方法だということです。
手動インポートフォールバック
手動インポートは引き続き以下を使用します：
plugins/BetterStructures/imports
パッケージのzipをそのまま保持し、必要に応じてBetterStructuresをリロードします。手動インポートはまだサポートされていますが、もはや主要な文書化されたワークフローではありません。