CannonRTP コマンドと権限
CannonRTP は cannonrtp 名前空間でコマンドを登録します。
- ルートコマンド:
/cannonrtp - エイリアス:
/crtp,/wc
/wc はほとんどの管理者が使う短縮エイリアスですが、すべてのサブコマンドの基礎となる権限ノードは cannonrtp.admin です。
管理者コマンド
| コマンド | 送信者 | 説明 |
|---|---|---|
/cannonrtp | 任意 | ヘルプヘッダーに続き、送信者が利用可能なすべての登録済みサブコマンドを表示します |
/wc help | 任意 | /cannonrtp と同じ -- ヘルプ一覧を表示します |
/wc create <id> | プレイヤー | 新しいキャノン設定を作成し、現在地に最初のインスタンスを配置します |
/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 | 任意 | グローバル設定、すべてのキャノン別設定、タスク、保護アダプタをリロードします |
/wc setup | プレイヤー | Nightbreak スタイルのコンテンツブラウザメニューを開きます(インストール済み/ダウンロード可能なキャノンパッケージを一覧表示) |
/wc recommendedplugins | 任意 | CannonRTP のおすすめ連携プラグインの Nightbreak カタログを開きます |
/wc downloadpluginupdate | 任意 | Nightbreak から新しい CannonRTP プラグイン jar をダウンロードします(次回のサーバー再起動後に適用) |
/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の存在を左右しません。
上記のすべての管理者サブコマンドには cannonrtp.admin が必要です。
これらの Nightbreak コマンドは CannonRTP に同梱されています
/wc setup、/wc recommendedplugins、/wc downloadpluginupdate、/wc downloadall、/wc downloadallcontent、/wc updatecontent、/wc forcereinstallcontentは、CannonRTP にシェード(shade)された共有 MagmaCore ライブラリによって提供されます。これらは自動的に登録されます --plugin.ymlには表示されません。別途用意されている/nightbreaklogin <token>コマンド(これも MagmaCore 由来)は、プレミアムダウンロード用に Nightbreak アカウントトークンを登録します。
/wc setup、/wc downloadall、/wc updatecontent が実際に管理するものの詳細については、コンテンツパッケージ ページを参照してください。
createvsplacevsremovevsdelete1 つのキャノン設定 (
plugins/CannonRTP/cannons/<id>.yml) で、ワールド内の多数の配置を制御できます。createは設定を作成し、最初の配置を生成します。placeは既存の設定に別の配置を追加します。removeは配置を 1 つだけ削除します(あなたのワールド内で最も近いもの)が、設定は保持します。deleteは設定ファイルを完全に削除し、すべての配置を取り除きます。
プレイヤーの操作
キャノンを起動するためのプレイヤー用コマンドはありません。プレイヤーはキャノンのトリガー半径(triggerRadius、デフォルト 1.75 ブロック)に入ることで CannonRTP を使用します。
権限
plugin.yml に登録されている権限ノードは 2 つです:
| 権限 | デフォルト | 説明 |
|---|---|---|
cannonrtp.admin | op | すべての管理者サブコマンド(同梱の Nightbreak setup / downloadall / updatecontent コマンドを含む)で必要 |
cannonrtp.use | true | プレイヤーがキャノンを起動するために必要 |
共有の /nightbreaklogin <token> コマンド(MagmaCore が提供し、CannonRTP の plugin.yml には宣言されていません)は、独自の nightbreak.login 権限ノードを使用します。
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 パッケージスラッグをタブ補完します。