CannonRTP コマンドと権限
CannonRTP は cannonrtp 名前空間でコマンドを登録します。
- ルートコマンド:
/cannonrtp - エイリアス:
/crtp,/wc
/wc はほとんどの管理者が使う短縮エイリアスですが、すべてのサブコマンドの基礎となる権限ノードは cannonrtp.admin です。
管理者コマンド
create、place、remove、target、center は、変更を適用する前に設定を保存します。保存に失敗するとエラーを報告し、再読み込みも変更の適用も行いません。報告されたファイルの問題を修正してから再試行してください。
変更が成功すると、これらのコマンドと delete は、編集したキャノンだけでなくすべてのキャノンを再構築します。進行中の発射はキャンセルされてそのプレイヤーはキャノンの座席に戻され、すべてのキャノンがキュー内の目的地を破棄して検索をやり直し、すべての発射クールダウンがリセットされます。
| コマンド | 送信者 | 説明 |
|---|---|---|
/cannonrtp | 任意 | ヘルプヘッダーに続き、送信者が利用可能なすべての登録済みサブコマンドを表示します |
/wc help | 任意 | /cannonrtp と同じ -- ヘルプ一覧を表示します |
/wc create <id> | プレイヤー | 新しいキャノン設定を作成し、現在地に最初のインスタンスを配置します。すでに存在する ID は拒否されます。その ID に配置を追加するには /wc place を使用してください。 |
/wc create <id> <display_name> | プレイヤー | 上記と同じですが、カスタム表示名を設定します(アンダースコアはスペースに変換されます) |
/wc place <id> | プレイヤー | 既存のキャノンの追加配置を現在地に追加します |
/wc remove <id> | プレイヤー | 現在のワールドで <id> の最も近い配置を削除します(設定ファイルは保持されます) |
/wc delete <id> | 任意 | キャノンの設定ファイルを完全に削除します |
/wc target <id> <world> | プレイヤー | キャノンのターゲット着地ワールドを変更します |
/wc center <id> | プレイヤー | キャノンの検索中心を現在地に設定します |
/wc list | 任意 | 表示名、ステータス、キューサイズ、最新ステータス詳細とともにすべての配置を一覧表示します |
/wc status | 任意 | /wc list と同じ出力 |
/wc probe | プレイヤー | 現在地が有効化されたすべての保護チェックを通過するかをテストします |
/wc reload | 任意 | CannonRTP を完全にリロードします: すべての設定ファイル、キャノン、保護アダプタに加え、imports/ フォルダで待機しているものも処理します |
/wc setup | プレイヤー | Nightbreak スタイルのコンテンツブラウザメニューを開きます(インストール済み/ダウンロード可能なキャノンパッケージを一覧表示) |
/wc recommendedplugins | 任意 | CannonRTP のおすすめ連携プラグインの Nightbreak カタログを開きます |
/wc downloadpluginupdate | 任意 | Nightbreak から新しい CannonRTP プラグイン jar をダウンロードします。次回のサーバー再起動後に使用されますが、config.yml の nightbreak.applyPluginUpdatesWithoutRestart が when-empty または immediately の場合はそれより早く使用されます |
/wc applypluginupdate | 任意 | ダウンロード済みの CannonRTP アップデートを、新しい jar からプラグインをリロードすることで、再起動なしで適用します。有効で新しいアップデートが待機していない場合、別の作者のプラグインが CannonRTP に depend または soft-depend している場合、または別のプラグイン差し替えが実行中の場合は拒否されます。新しい jar の有効化に失敗した場合は以前の jar が再度読み込まれ、アップデートは次回の再起動に備えて update フォルダに残ります。再起動なしでのアップデートの適用を参照してください。 |
/wc downloadall | 任意 | CannonRTP プラグインの更新 および Nightbreak で利用可能なすべてのコンテンツパッケージをダウンロードします |
/wc downloadallcontent | 任意 | Nightbreak で利用可能なすべての CannonRTP コンテンツパッケージをダウンロードします(コンテンツのみ、プラグイン jar は含まない) |
/wc updatecontent | 任意 | 古くなった CannonRTP コンテンツパッケージの更新をダウンロードします(エイリアス: /wc updateallcontent) |
/wc forcereinstallcontent <package|all> | 任意 | ローカルのコピーがすでに最新であっても、Nightbreak からコンテンツを再ダウンロードします -- 破損したファイルや手動編集されたパッケージファイルを修復するために使用します。すでにダウンロード済みのすべてのパッケージを対象にするには all を指定するか、Nightbreak のパッケージスラッグ 1 つをタブ補完してください(free-cannon-model、cannonrtp-premium-cannon-model)。 |
/wc initialize は cannonrtp.admin を持つプレイヤー向けの初期設定メニューを開きます。/wc setup はコンテンツブラウザーを開きます。共有の初期化処理が両コマンドを登録するため、プリセットモードの有無は initialize の存在を左右しません。
セットアップが完了済みとしてマークされるまで(config.yml の setupDone)、cannonrtp.admin を持つプレイヤーには、参加から約 10 秒後に /wc initialize と /wc setup へのクリック可能なリンク付きのチャットリマインダーが届きます。初回設定メニューのいずれの選択肢(Recommended Setup、Manual Setup、Use Current Content)も setupDone を true に設定し、リマインダーを止めます。
上記のすべての管理者サブコマンドには cannonrtp.admin が必要です。
これらの Nightbreak コマンドは CannonRTP に同梱されています
/wc setup、/wc initialize、/wc recommendedplugins、/wc downloadpluginupdate、/wc applypluginupdate、/wc downloadall、/wc downloadallcontent、/wc updatecontent、/wc forcereinstallcontentは、CannonRTP にシェード(shade)された共有 MagmaCore ライブラリによって提供されます。これらは自動的に登録されます --plugin.ymlには表示されません。別途用意されている/nightbreakloginコマンド(これも MagmaCore 由来)は、プレミアムダウンロード用にサーバーを Nightbreak アカウントにリンクし、/nightbreaklogoutはその接続を解除します(サーバーの接続解除を参照)。MagmaCore は
/wcchangelogも登録します。これは管理者に、未読の CannonRTP およびキャノンパッケージのリリースノートを表示します。チェンジログ通知を参照してください。
/wc setup、/wc downloadall、/wc updatecontent が実際に管理するものの詳細については、コンテンツパッケージ ページを参照してください。
createvsplacevsremovevsdelete1 つのキャノン設定 (
plugins/CannonRTP/cannons/<id>.yml) で、ワールド内の多数の配置を制御できます。createは設定を作成し、最初の配置を生成します。placeは既存の設定に別の配置を追加します。removeは配置を 1 つだけ削除します(あなたのワールド内で最も近いもの)が、設定は保持します。deleteは設定ファイルを完全に削除し、すべての配置を取り除きます。3 つの組み込みファイル(example_cannonrtp、cannonrtp_free_cannon、cannonrtp_premium_cannon)は、続くリロード時にデフォルト値かつ配置なしの状態で復元されます。
プレイヤーの操作
キャノンを起動するためのプレイヤー用コマンドはありません。プレイヤーはキャノンのトリガー半径(triggerRadius、デフォルト 1.75 ブロック)に入ることで CannonRTP を使用します。
権限
plugin.yml に登録されている権限ノードは 2 つです:
| 権限 | デフォルト | 説明 |
|---|---|---|
cannonrtp.admin | op | すべての管理者サブコマンド(同梱の Nightbreak setup / downloadall / updatecontent コマンドを含む)で必要 |
cannonrtp.use | true | プレイヤーがキャノンを起動するために必要 |
共有の /nightbreaklogin および /nightbreaklogout コマンド(MagmaCore が提供し、CannonRTP の plugin.yml には宣言されていません)は、独自の nightbreak.login 権限ノードを使用します。このノードのデフォルトは op です。
cannonrtp.use の動作
プレイヤーが cannonrtp.use を持たない場合、キャノンはそのプレイヤーを静かに無視します。この基礎権限チェックでは拒否メッセージは送信されません -- プレイヤーは発射されることなくキャノン領域をそのまま通り過ぎます。
キャノン別の追加権限
各キャノン設定では requiredPermission フィールドも定義できます。
requiredPermissionが空白(デフォルト)の場合、キャノンはcannonrtp.useのみをチェックします。requiredPermissionが設定されており、プレイヤーがcannonrtp.useを持っていてもキャノン別ノードを持たない場合、CannonRTP は設定されたnoPermissionメッセージにキャノンの表示名を含めて送信します。このメッセージはプレイヤーおよびキャノンごとに 3 秒に 1 回までスロットリングされます。
タブ補完
既存のキャノンを対象とするコマンド(place、remove、delete、target、center)は、既知のキャノン設定 ID のリストから <id> をタブ補完し、すでに存在する ID しか受け付けません。/wc create は例外で、その <id> と <display_name> は自由入力のため、タブ補完は <id> / <display_name> というヒントを表示するだけです。<world> 引数を取るコマンドは、現在ロードされているワールド名のリストからタブ補完され、/wc forcereinstallcontent は all と各 Nightbreak パッケージスラッグをタブ補完します。