CannonRTP コンテンツパッケージ
CannonRTP は、公式のキャノンモデルおよび設定バンドルを純粋な手動インポートではなく、Nightbreak が管理する コンテンツパッケージ として扱います。各パッケージには、キャノンの YAML 設定と、その 3D キャノンモデルを駆動する FreeMinecraftModels リソースが含まれています。
主なコマンド
| コマンド | 用途 |
|---|---|
/wc setup | Nightbreak コンテンツブラウザメニューを開きます(インストール済み/ダウンロード可能なキャノンパッケージを一覧表示) |
/wc downloadall | 利用可能なすべての CannonRTP コンテンツパッケージを Nightbreak から一括ダウンロードします |
/wc updatecontent | 古くなった CannonRTP コンテンツパッケージを一括更新します(エイリアス: /wc updateall) |
/wc reload | 手動インポート後に CannonRTP をリロードします |
/nightbreaklogin <token> | 共通の Nightbreak トークン登録 -- プレミアムパッケージに必要 |
これらすべてに cannonrtp.admin が必要です。
組み込みパッケージ
CannonRTP には、デフォルトで 2 つの Nightbreak バンドルのパッケージ定義が同梱されています:
| パッケージ ID | 表示名 | 入手元 |
|---|---|---|
cannonrtp | Free CannonRTP | Nightbreak の無料ダウンロード |
cannonrtp_premium | Premium CannonRTP | Nightbreak プレミアムサポーターアクセスが必要 |
各定義は plugins/CannonRTP/content_packages/<id>.yml にあり、以下を保存しています:
version-- ローカルにインストール済みのバージョン(/wc updatecontentが古いものを判定するために使用)nameおよびdescription--/wc setupメニューに表示downloadLink-- 一括ダウンロードフローで使用される Nightbreak ページfolderNameおよびcontentFilePrefixes-- パッケージ内のどのファイルを CannonRTP がそのパッケージに属するとみなすかnightbreakSlug-- ダウンロード/更新エンドポイントで使用される Nightbreak プロジェクトスラッグ
これらのファイルは通常、手動で編集すべきではありません -- プラグインが再生成し書き換えます。
パッケージの状態
/wc setup メニュー内では、各パッケージは以下のいずれかとして表示されます:
- installed -- パッケージのキャノンファイルが
plugins/CannonRTP/cannons/に存在し、isEnabledがtrue - downloaded but disabled -- パッケージのキャノンファイルが
plugins/CannonRTP/cannons_disabled/に置かれている - outdated -- より新しいバージョンが Nightbreak で利用可能
- not downloaded -- ローカルにはまだ何もない
メニュー内でパッケージをクリックすると、ダウンロード、インストール、有効化、無効化が行えます。パッケージを無効化すると、そのキャノン設定が cannons/ から cannons_disabled/ に移動されます(削除はされません)。そのため、再度有効化すれば同じファイルが復元されます。
キャノンフォルダ構成
| フォルダ | 用途 |
|---|---|
plugins/CannonRTP/cannons/ | アクティブなキャノン設定。ここに置かれているものは、起動時または /wc reload 時にロードされます。 |
plugins/CannonRTP/cannons_disabled/ | 現在オフになっているパッケージ済みキャノン設定。ここのファイルはローダーから無視されますが、後で再度有効化するために保持されます。 |
plugins/CannonRTP/imports/ | 手動パッケージインポート用のドロップフォルダ。CannonRTP は起動時にここをスキャンし、その内容をパッケージフォルダにマージします。 |
手動インポートによるフォールバック
パッケージを手動でインストールすることも引き続き可能です:
- Nightbreak からパッケージの zip をダウンロードします。
- zip を(展開せずそのまま)
plugins/CannonRTP/imports/にドロップします。 /wc reloadを実行します。
CannonRTP はパッケージを認識し、ファイルを適切なフォルダに移動して、キャノン設定をリロードします。手動インポートは引き続きサポートされていますが、もはや推奨されるワークフローではありません -- /wc setup および /wc downloadall が自動的に処理します。
プレミアムアクセス
プレミアムコンテンツパッケージ(cannonrtp_premium など)には、リンクされた Nightbreak アカウントが必要です。Nightbreak アカウントページから取得したトークンを使って /nightbreaklogin <token> を 1 度実行すれば、その後 /wc downloadall や /wc setup メニューからプレミアムコンテンツを取得できるようになります。
ログインしていない場合、プレミアムパッケージはセットアップメニューには表示されますが、ダウンロードはできません。