BetterStructuresセットアップ
BetterStructuresは手動インポートをまだサポートしていますが、現在推奨されるワークフローはNightbreak優先でゲーム内で行うものです。
要件
- WorldEditまたはFAWE互換のスケマティックサポート
- 現在のビルドラインのJava 21ランタイム
推奨ワークフロー
- BetterStructuresとWorldEditをインストールし、サーバーを一度起動します。
/bs initializeを実行します。/nightbreaklogin <token>でNightbreakトークンをリンクします。/bs setupを開いて構造物パックとモジュールパックを閲覧します。- 素早いブートストラップには
/bs downloadallを使用します（保留中のプラグイン更新とすべてのコンテンツを取得します）。 - パッケージの更新が利用可能な場合は
/bs updatecontentを使用します。
初回セットアップメニュー
/bs initializeは小さなガイド付きメニューを開きます。いずれかの選択肢が選ばれるまで、betterstructures.*を持つすべてのプレイヤーは参加から10秒後にリマインダーメッセージを受け取ります。3つの選択肢はいずれもconfig.ymlにsetupDone: trueを書き込むことでセットアップ完了を記録します。
| 選択肢 | 動作 |
|---|---|
| Recommended Setup | セットアップを完了としてマークし、3ステップの手順を表示します：nightbreak.io/accountでトークンを取得し、/nightbreaklogin <token>でリンクし、/bs setupを開きます。 |
| Manual Setup | セットアップを完了としてマークし、コンテンツ管理はあなたに委ねます。/bs setupとimportsフォルダを案内します。 |
| Use Current Content | 案内を閉じ、現在のコンテンツを維持します。スケマティックの登録一覧が空でなければリロードし、空ならコンテンツ未インストールと表示して/bs setupを案内します。この確認にはモジュールを含みません。 |
WorldEditもFastAsyncWorldEditもインストールされていない場合、3番目のスロットは、続行前にいずれかをインストールするよう促す警告に置き換えられます。
セットアップメニュー
/bs setupは、構造物パックとモジュールパックの2つのフィルターがあるページ送り式メニューを開きます。各パッケージには、インストール済み、ダウンロード済みだが無効、古い、Nightbreakアクセスが必要などの状態が表示されます。クリック時の操作は状態によって異なり、ダウンロード、インストール、更新、アンインストール、アクセス情報の表示のいずれかになります。
パッケージと併せて、メニューにはBetterStructuresに同梱された共有のMagmaCoreコントロールも表示されます：
- Plugin Update - より新しいBetterStructuresビルドが利用可能かどうかを表示し、ダウンロードできるようにします。更新は再起動で適用されますが、
/bs applypluginupdateを実行するか、config.ymlのnightbreak.applyPluginUpdatesWithoutRestartをwhen-emptyまたはimmediatelyに設定した場合はその限りではありません。このチェックは起動時に自動で実行され、およそ1時間ごとに更新されるため、起動直後のサーバーでは一時的に「Plugin Update Pending」と表示されることがあります。 - Recommended Plugins - コンパニオンプラグインのおすすめビューを開きます（
/bs recommendedpluginsと同じ）。列挙されたおすすめがすべてインストールされると、アイコンが緑色に変わります。 - Download All Content - パッケージ一覧の後に追加される一括エントリで、
/bs downloadallと同等です。 - Automatic Updates - 起動時にプラグインとコンテンツの更新を自動ダウンロードするかどうかを切り替えます。デフォルトはオフで、
config.ymlのnightbreak.autoDownloadPluginUpdatesに対応します。自動ダウンロードされたコンテンツは即時リロードされず、次回の再起動に備えて保存されます。ダウンロードされたプラグイン更新も再起動で適用されますが、nightbreak.applyPluginUpdatesWithoutRestartがwhen-emptyまたはimmediatelyに設定されている場合は除きます（設定を参照）。 - Installation tips - インフォボタンです。セットアップガイド、アカウントトークンのページ、サポートDiscord、クリック可能なセットアップコマンドをチャットに表示します。
コンテンツのリロード実行中は/bs setupは拒否されます。メニューはリロードワーカーが再構築しているのと同じレジストリを読むためです。リロードが成功を報告するまで待ってから開き直してください。
メニューはファイルの整合性を確認しません。パスが存在し、バージョンが一致していれば、破損や一部削除があっても最新と表示されることがあります。修復には/bs forcereinstallcontent <package|all>を使い、パッケージフォルダ全体がない場合はslugを直接指定してください。アンインストールしてもディスク上のファイルは残ります。アンインストールはパッケージのisEnabledをfalseにしてリロードし、そのリロードではパッケージのフォルダ内にあるすべてのスケマティックとモジュールが、サブフォルダも含めてスキップされます。
手動インポートフォールバック
手動インポートは以下を通じて引き続き機能します：
plugins/BetterStructures/imports
パッケージのzipをそのまま保持し、必要に応じて/bs reloadを実行します。/bs reload はリロードの一環としてこのフォルダにあるものをインポートするため、置いたパッケージを取り込むのに再起動は不要です。
なお、imports にファイルを残しておくと起動が遅くなります。このフォルダが空でない場合、BetterStructuresは自身の softdepend に列挙されたプラグインの初期化が終わるのを待ってから起動します。他のプラグインのデータフォルダへコンテンツをインポートするということは、そのプラグインをリロードする必要があるからです。フォルダが再び空になれば、BetterStructuresは待機せずに初期化します。
共有ガイドを参照: 手動インポート vs ゲーム内管理。