Extractioncraft コマンドと権限

Extractioncraftは以下のルートコマンドを登録します：

/extractioncraft
/exc

サブコマンドはMagmaCoreコマンドマネージャーによってランタイムに登録されます。

管理者コマンド

コマンド	権限	デフォルト	実行者	説明
/exc initialize	extractioncraft.initialize	op	プレイヤー	初回セットアップメニューを開く
/exc setup	extractioncraft.setup	op	プレイヤー	コンテンツのインストール、アンインストール、管理を行うコンテンツパッケージブラウザを開く
/exc protection bypass	extractioncraft.protection.bypass	op	プレイヤー	この状態を参照するブロック・操作チェックのバイパスを切り替える。マッチのテレポート制限やPvP禁止は回避しない。
/exc reload	extractioncraft.*	op	全員	プラグインをリロードする。進行中のマッチは終了し、そのプレイヤーはアイテムを保持する。リロードが完全に適用されない場合は、サーバーの完全再起動を推奨。

プレイヤーコマンド

コマンド	権限	デフォルト	実行者	説明
/exc createMatch <contentPackage.yml>	extractioncraft.creatematch	true	プレイヤー	指定されたコンテンツパッケージを使用して新しいマッチを作成し、プレイヤーをそのマッチに配置する。利用可能なコンテンツパッケージのファイル名がタブ補完される。
/exc start	extractioncraft.start	true	プレイヤー	最少プレイヤー数を満たしている場合、プレイヤーが現在参加しているマッチを開始する
/exc leave	（未設定）	true	プレイヤー	現在のマッチから退出する。マッチがまだ生成中の場合は、そのプレイヤーのマッチをキャンセルする
/exc quit	（未設定）	true	プレイヤー	/exc leave と同じ。

MagmaCore共通コマンド

MagmaCoreはExtractioncraftに同梱されているため、これらのコマンドもプラグインに付属します。

コマンド	権限	デフォルト	実行者	説明
/exc recommendedplugins	extractioncraft.setup	op	全員	Extractioncraftに推奨されるコンパニオンプラグインの一覧を開く（プレイヤーの場合）か、出力する（コンソールの場合）。
/nightbreak plugins	nightbreak.plugins	op	全員	Nightbreakプラグインカタログを開き、MagmaGuyの他のプラグインを閲覧・ダウンロードする。MagmaCoreによってグローバルに一度だけ登録される。
/nightbreaklogin <token>	nightbreak.login	op	全員	nightbreak.ioアカウントのトークンをゲーム内で登録し、サーバーがライセンス付きコンテンツを取得できるようにする。MagmaCoreによってグローバルに一度だけ登録される。
/nightbreaklogout	nightbreak.login	op	全員	サーバーに保存された nightbreak.io アカウントのトークンを消去する。MagmaCoreによってグローバルに一度だけ登録される。
/logify	logify.*	op	全員	現在の latest.log を mclo.gs に投稿し、管理者がバグ報告しやすくする。MagmaCoreによってグローバルに一度だけ登録される。
/extractioncraftchangelog	op、extractioncraft.*、extractioncraft.setup、または extractioncraft.initialize	op	プレイヤー	NightbreakからのExtractioncraftの未読リリースノートを表示する。dismiss で既読にし、disable で参加時のリマインダーを停止する。Extractioncraftの起動完了後に登録される。チェンジログ通知を参照。

権限一覧

権限	デフォルト	説明
extractioncraft.initialize	op	/exc initialize へのアクセス
extractioncraft.setup	op	/exc setup および /exc recommendedplugins へのアクセス
extractioncraft.protection.bypass	op	/exc protection bypass へのアクセス
extractioncraft.match.bypass	op	スタッフがマッチワールドにテレポートで入り、マッチのカウントダウン中や進行中もそこに留まれるようにする。拒否されたりメインワールドのスポーンへ送られたりすることはない。マッチの参加者にはならない。
extractioncraft.*	op	/exc reload へのアクセス
extractioncraft.creatematch	true	/exc createMatch へのアクセス
extractioncraft.start	true	/exc start へのアクセス
extractioncraft.leave	true	/exc leave 用に plugin.yml で宣言されているが、ランタイムでは強制されない（登録された quit/leave コマンドには権限チェックがない）
nightbreak.plugins	op	/nightbreak plugins へのアクセス（MagmaCoreによって登録）
nightbreak.login	op	/nightbreaklogin および /nightbreaklogout へのアクセス（MagmaCoreによって登録）
logify.*	op	/logify へのアクセス（MagmaCoreによって登録）

備考

• plugin.yml ではルートコマンド /extractioncraft と /logify が宣言されています。/extractioncraft のサブコマンドはMagmaCoreコマンドマネージャーを通じてランタイムに登録されます。
• extractioncraft.* は /exc reload で使用されますが plugin.yml では宣言されていないため、登録された権限ノードではありません。オペレーターは自動的に通過しますが、それ以外のユーザーには権限プラグインで明示的に付与する必要があります。
• quit と leave は同じコマンドの2つのエイリアスで、権限チェックはありません。extractioncraft.leave ノードが強制されることはありません。
• /logify、/nightbreak、/nightbreaklogin、/nightbreaklogout は（プラグインに同梱されている）MagmaCoreによってグローバルに登録され、サーバー上のすべてのMagmaCoreプラグインを通じてそれぞれ一度だけ登録されます。MagmaGuyの別のプラグインがすでにいずれかの名前を確保している場合、Extractioncraftはその登録をスキップし、既存のものが使用されます。
• 引数なしで /exc を実行すると、実行者の権限と種類で許可された登録済みサブコマンドが表示されます。quit/leave のハンドラーには使用法の文字列がないため、ヘルプ項目は不完全です。
• 権限ノードなしで登録されたサブコマンド（現在は quit/leave のみ）は、すべての実行者に対して権限チェックを通過します。
• /exc reload と /exc recommendedplugins を除くExtractioncraftのサブコマンドはすべてプレイヤー専用です。コンソールには This command must be run as a player! と返されます。
• /exc createMatch は、すでにマッチに参加しているプレイヤーや、マッチの生成を待っているプレイヤーを拒否します。同梱のMagmaCoreマッチシステムを使う別のプラグインのマッチも対象です。
• Extractioncraftは共有の downloadall サブコマンドを登録しないため、/exc setup 内の情報ボタンはこれを案内しません。コンテンツの管理にはセットアップメニュー自体を使用してください。
• Extractioncraftは共有の downloadpluginupdate や applypluginupdate サブコマンドも登録せず、プラグインアップデートの自動ダウンロード後の通知でも applypluginupdate は案内されません。アップデートを使うにはサーバーを再起動するか、ダウンロード前に config.yml で nightbreak.applyPluginUpdatesWithoutRestart を設定してください。