BetterStructuresコマンド

/betterstructuresまたは/bsを使用します。

セットアップとコンテンツ

コマンド	目的
/bs	メインのヘルプコマンド
/bs initialize	初回セットアップフロー（初回セットアップメニューを開く）
/bs setup	セットアップ/コンテンツメニューを開く
/bs recommendedplugins	BetterStructuresと相性の良いコンパニオンプラグインを表示
/bs downloadall	プラグインの更新（ある場合）および利用可能なすべてのコンテンツをダウンロードし、リロード
/bs downloadallcontent	利用可能なすべてのコンテンツパッケージのみをダウンロード（プラグインの更新は行わない）
/bs updatecontent	古いコンテンツの更新をダウンロード（エイリアス：/bs updateallcontent）
/bs forcereinstallcontent <package|all>	インストール済みのバージョンがすでに最新であっても、通常の認証済みパイプラインを通してコンテンツを再ダウンロードします。タブ補完ではallとすべてのNightbreakパッケージのスラッグが候補として表示されます。
/bs downloadpluginupdate	保留中のプラグイン更新をダウンロードします。更新は再起動で適用されますが、/bs applypluginupdateまたはnightbreak.applyPluginUpdatesWithoutRestart設定によって、それより早く適用することもできます。
/bs applypluginupdate	ダウンロード済みのプラグイン更新を、サーバーを再起動せずに適用
/bs reload	BetterStructuresの設定とコンテンツをリロードし、保留中のコンテンツをインポート
/bs version	プラグインバージョンを表示

/bs reload について

/bs reload はもうプラグインを無効化してから再度有効化することはありません。現在はインプレースのコンテンツリロードを行います：config.yml と ValidWorlds.yml がサーバースレッド上で再読み込みされ、続いてトレジャー、ジェネレーター、モジュールジェネレーター、スポーンプール、スキマティック、モジュール、コンテンツパッケージの各設定がワーカースレッド上で再構築されます。コマンド、リスナー、NMSアダプタは登録されたままです。

知っておく価値のある影響：

• リロードは実行中の事前生成とモジュール生成をキャンセルし、キューで待機中または進行中の構造物やダンジョンの貼り付けを、その時点の状態で停止します。セットアップメニューと初回セットアップメニューもリロード中は利用できません。
• リロード中は/bs place、/bs lootify、/bs pregenerate、/bs generateModulesがコンテンツのリロード中というメッセージで拒否されます。新しいチャンクのスキャンと保留中のダンジョンスキャンは、リロードが成功するまで保持されます。待機中のチャンクがアンロードされた場合、そのスキャンは次にチャンクが読み込まれるまで待機します。
• 実行中にもう一度 /bs reload を発行した場合、そのリクエストはキューに入り、あとから2回目の完全なリロードが走ります。そのため、リロード中に変更したファイルもきちんと拾われます。
• リロードが失敗した場合、BetterStructuresは中身が半分空のコンテンツレジストリのまま動き続けるのではなく、意図的に自身を無効化します。原因についてはコンソールを確認し、修正してからサーバーを再起動してください。

/bs forcereinstallcontent について

通常のダウンロードは、ローカルのバージョンがリモートのバージョンとすでに一致しているパッケージをスキップします。そのため、ディスク上のファイルが破損したり一部削除されたりしている場合には役に立ちません。forcereinstallcontentはそのバージョンチェックを回避し、選択したパッケージを同じ認証済みのダウンロード、インポート、リロードのパイプラインに通し直します。

• allは、BetterStructuresが現在ダウンロード済み・インストール済み・古い状態のいずれかだと認識しているすべてのパッケージを選択します。何も該当しない場合、コマンドは実行を拒否し、スラッグを直接指定するよう求めます。パッケージのファイルが完全に失われている場合は、まさにこちらが必要な動作です。
• 単一のスラッグを指定すると、そのパッケージだけが再インストールされます。
• 未知のスラッグは拒否され、タブ補完を案内するメッセージが表示されます。

/bs applypluginupdate について

/bs applypluginupdateは、すでにダウンロードされてサーバーのupdateフォルダーで待機しているBetterStructuresの更新を、再起動せずに入れ替えます。BetterStructuresと、それに依存するすべてのMagmaGuyプラグインを無効化し、jarを置き換えてから、それらを再度読み込んで有効化します。一緒にリロードされたプラグインはチャットに一覧表示されます。新しいjarが有効化されなかった場合は以前のjarが再度読み込まれ、更新は次回の再起動まで待機状態のまま残ります。

待機中の更新がない場合、待機中のjarが不正であるか実行中のバージョンより新しくない場合、または他の作者のプラグインがBetterStructuresに依存している場合、このコマンドは実行を拒否します。その場合はサーバーを再起動してください。進行中のボス、アリーナ、ダンジョンインスタンスは、プラグインのリロード時に終了します。

ダウンロードした更新を自動で適用するには、config.ymlでnightbreak.applyPluginUpdatesWithoutRestartを設定してください（設定を参照）。

ダウンロード/更新、おすすめプラグイン、プラグイン更新の各コマンドは、BetterStructuresに同梱されている共有のMagmaCore Nightbreakシステムによって提供されます。同じセットアップメニューには、Plugin Update項目、Recommended Plugins項目、Automatic Updatesトグルが表示されます（セットアップを参照）。

ユーティリティと管理コマンド

コマンド	目的
/bs place <schematic> <type>	プレイヤーの現在のチャンクを起点に適切な配置を探します。近隣の位置が選ばれる場合もあります。有効なタイプ: SURFACE, UNDERGROUND_SHALLOW, UNDERGROUND_DEEP, SKY, LIQUID_SURFACE
/bs lootify <generator> <rarity> <minAmount> <maxAmount> <weight>	持っているアイテムを宝テーブルに追加。ジェネレーターは有効な宝設定であること、レアリティはその設定内に存在すること、minAmountは1以上、maxAmountは64以下であること、そしてアイテムを持っている必要があります。
/bs pregenerate <centerType> <shape> <radiusInBlocks> <applyWorldBorder>	BetterStructuresを有効にしてチャンクを事前生成。ワールドはプレイヤーの現在のワールドから取得されます。centerType: HERE, WORLD_CENTER, WORLD_SPAWN。shape: SQUARE, CIRCLE。applyWorldBorder: TRUE/FALSE。
/bs cancelPregenerate	プレイヤーの現在のワールドでアクティブな事前生成をキャンセル（エイリアス：/bs cancelpregenerate）
/bs generateModules <generatorFile>	モジュールジェネレーターファイルからモジュラーコンテンツを生成
/bs teleport <world> <x> <y> <z>	特定の場所にテレポート（エイリアス：/bs tp）
/bs silent	特定のオペレーター警告を切り替え

これらのユーティリティコマンドには次の制約があります。

• /bs placeのメッセージは配置を試みたことを示すもので、配置完了の確認ではありません。
• /bs lootifyはメインハンドにアイテムを持ってゲーム内で実行してください。個数と重みの引数は整数です。1 <= minAmount <= maxAmount <= 64と正の重みを指定してください。コマンドは不正な範囲をすべて拒否するわけではありません。エントリを保存するとコンテンツのリロードが始まります。
• /bs pregenerateの半径は0ブロック以上で、チャンク単位に切り上げられます。applyWorldBorderがTRUEなら、完了時に直径2 × radiusInBlocksの正方形のワールド境界が設定されます。CIRCLE生成でも境界は正方形です。キャンセルしても境界は設定されず、生成済みのチャンクも元に戻りません。チャンクの読み込みに失敗した場合、事前生成は停止し、失敗したチャンクをログに記録し、ワールド境界は変更しません。
• /bs teleportには読み込み済みのワールドと整数座標が必要です。相対座標には対応していません。

権限

権限	説明	デフォルト
betterstructures.setup	/bs setup、/bs recommendedplugins、/bs downloadallcontent、/bs updatecontentへのアクセス	OP
betterstructures.initialize	/bs initializeへのアクセス	OP
betterstructures.generatemodules	/bs generateModulesへのアクセス	OP
betterstructures.generatemodules.slowly	plugin.ymlに登録されていますが、現在ソースコード内のどのコマンドにも使用されていません。おそらく過去の残留物です。	OP
betterstructures.generatemodules.instantly	plugin.ymlに登録されていますが、現在ソースコード内のどのコマンドにも使用されていません。おそらく過去の残留物です。	OP
betterstructures.*	ユーティリティおよび管理コマンド（place、pregenerate、cancelPregenerate、reload、teleport、version、lootify、/bsヘルプ）と、管理用コンテンツコマンド/bs downloadall、/bs downloadpluginupdate、/bs applypluginupdate、/bs forcereinstallcontentのワイルドカード。デフォルトでOPが保持します。	OP
betterstructures.*	サーバー全体の警告設定を変更する/bs silentにも必要です。	OP
betterstructures.warn	warnAdminsAboutNewBuildingsがtrueの間、クリック可能な「新しい建物が生成された」「新しいダンジョンの生成が始まった」メッセージを受け取ります。plugin.ymlで宣言されていないため、Bukkitはデフォルトでこの権限をOPに付与します。	OP

betterstructures.setupはコンテンツの閲覧/管理コマンドを、betterstructures.initializeは初回セットアップを、betterstructures.generatemodulesはダンジョン生成をカバーします。プラグインとコンテンツを併せて扱う/bs downloadall、プラグインのみの/bs downloadpluginupdateと/bs applypluginupdate、修復向けの/bs forcereinstallcontentは、管理用ワイルドカードbetterstructures.*の背後でゲートされています。.slowlyおよび.instantlyのバリエーションはplugin.ymlに引き続き宣言されていますが、現在のところどのコマンドもチェックしていません。

betterstructures.*、betterstructures.setup、betterstructures.initialize、betterstructures.generatemodulesのいずれかがあればルートコマンドにアクセスできます。各サブコマンドは自身の権限を確認するため、セットアップだけを担当する管理者にワイルドカード権限は必要ありません。

betterstructures.*は初回セットアップのリマインダーも制御します。この権限を持つプレイヤーには、config.ymlのsetupDoneがfalseの間、参加するたびに10秒後に/bs initializeを案内するメッセージが表示されます。