CannonRTP コンテンツパッケージ

CannonRTP は公式のキャノンモデルを Nightbreak のコンテンツパッケージとして管理します。現在の Free Cannon と Premium Cannon のダウンロードには、FreeMinecraftModels のモデルと content_packages/ 内のパッケージバージョン情報が含まれています。対応するキャノン設定は CannonRTP 自体が cannons/ に生成します。ダウンロードには配置設定は含まれていません。

主なコマンド

コマンド	用途
/wc setup	Nightbreak コンテンツブラウザメニューを開きます(インストール済み/ダウンロード可能なキャノンパッケージを一覧表示)
/wc downloadall	CannonRTP本体の更新と利用可能な全コンテンツパッケージをNightbreakからダウンロードします
/wc updatecontent	古くなった CannonRTP コンテンツパッケージを一括更新します(エイリアス: /wc updateallcontent)
/wc reload	手動インポート後に CannonRTP をリロードします
/nightbreaklogin <token>	共通の Nightbreak トークン登録 -- プレミアムパッケージに必要

/wcの管理コマンドにはcannonrtp.adminが必要です。別のアカウントコマンド/nightbreaklogin <token>にはnightbreak.loginが必要です。

/wc setup メニューには、キャノンパッケージのほかに、プラグイン更新のエントリ(クリックすると利用可能な更新をダウンロード)、おすすめプラグインのエントリ、/wc downloadall を実行する一括ダウンロードのエントリ、config.yml の nightbreak.autoDownloadPluginUpdates を書き換える自動更新トグルも表示されます(設定を参照)。

組み込みパッケージ

CannonRTP には、デフォルトで 2 つの Nightbreak バンドルのパッケージ定義が同梱されています:

パッケージ ID	表示名	入手元
cannonrtp	Free CannonRTP	Nightbreak の無料ダウンロード
cannonrtp_premium	Premium CannonRTP	Nightbreak プレミアムサポーターアクセスが必要

各定義は plugins/CannonRTP/content_packages/<id>.yml にあり、以下を保存しています:

• isEnabled -- パッケージが有効かどうか。パッケージを有効化または無効化すると /wc setup メニューがこれを書き込みます
• version -- ローカルにインストール済みのバージョン(/wc updatecontent が古いものを判定するために使用)
• name および description -- /wc setup メニューに表示
• downloadLink -- パッケージに nightbreakSlug がなく手動でダウンロードする必要がある場合に CannonRTP が案内する Nightbreak ページ。古くなったパッケージについてのコンソール警告にもこのリンクが表示されます
• folderName および contentFilePrefixes -- パッケージ内のどのファイルを CannonRTP がそのパッケージに属するとみなすか
• nightbreakSlug -- ダウンロード/更新エンドポイントで使用される Nightbreak プロジェクトスラッグ

これらのファイルは通常、手動で編集すべきではありません -- プラグインが再生成し書き換えます。

パッケージの状態

/wc setup メニュー内では、各パッケージは以下のいずれかとして表示されます:

• インストール済み -- 以下のダウンロード判定を満たし、メタデータが isEnabled: true で、対応するキャノン設定が plugins/CannonRTP/cannons/ に存在する
• ダウンロード済みだが無効 -- モデルのダウンロードは認識されているが、パッケージは有効ではない。メニューで無効化すると、キャノンファイルを plugins/CannonRTP/cannons_disabled/ に移動する
• 更新あり -- パッケージがインストール済みで、より新しいバージョンが Nightbreak で利用可能。リンクしたアカウントがアクセス権を失っている場合、メニューは更新を提示する代わりにその旨を表示する
• アクセスが必要 -- パッケージが未ダウンロードで、ログイン済みだが、Nightbreak アカウントにそのパッケージへのアクセス権がない
• 未ダウンロード -- 正のローカルバージョン値がないか、モデルファイルが見つからない

生成されたキャノンの YAML だけでは、ダウンロード済みとは判定されません。パッケージのローカル version がゼロより大きく、plugins/FreeMinecraftModels/models/ または plugins/FreeMinecraftModels/Models/ の下にあるパッケージの folderName 内に、少なくとも 1 つの .bbmodel ファイルが必要です。モデルフォルダがない場合、生成されたキャノン設定が残っていても、パッケージは再びダウンロード可能になります。

メニュー内でパッケージをクリックすると、ダウンロード、インストール、有効化、無効化が行えます。パッケージを無効化すると、そのキャノン設定が cannons/ から cannons_disabled/ に移動されます(削除はされません)。そのため、再度有効化すれば同じファイルが復元されます。CannonRTP は組み込みの cannonrtp_free_cannon.yml と cannonrtp_premium_cannon.yml が cannons/ にない場合は常に再作成するため、無効化後のリロードでは配置のないデフォルトのコピーがそこに残ります。再度有効化すると、保存されていたファイルがそれらを上書きする形で戻されます。

キャノンフォルダ構成

フォルダ	用途
plugins/CannonRTP/cannons/	アクティブなキャノン設定。ここに置かれているものは、起動時または /wc reload 時にロードされます。
plugins/CannonRTP/cannons_disabled/	現在オフになっているパッケージ済みキャノン設定。ここのファイルはローダーから無視されますが、後で再度有効化するために保持されます。
plugins/CannonRTP/imports/	手動パッケージインポート用のドロップフォルダ。CannonRTP は起動時にここをスキャンし、その内容をパッケージフォルダにマージします。

手動インポートによるフォールバック

パッケージを手動でインストールすることも引き続き可能です:

1. Nightbreak からパッケージの zip をダウンロードします。
2. zip を(展開せずそのまま)plugins/CannonRTP/imports/ にドロップします。
3. /wc reload を実行します。

CannonRTP はパッケージを認識し、ファイルを適切なフォルダに移動して、キャノン設定をリロードします。手動インポートは引き続きサポートされていますが、もはや推奨されるワークフローではありません -- /wc setup および /wc downloadall が自動的に処理します。

プレミアムアクセス

プレミアムコンテンツパッケージ(cannonrtp_premium など)には、リンクされた Nightbreak アカウントが必要です。Nightbreak アカウントページから取得したトークンを使って /nightbreaklogin <token> を 1 度実行すれば、その後 /wc downloadall や /wc setup メニューからプレミアムコンテンツを取得できるようになります。

ログインしていない場合、プレミアムパッケージはセットアップメニューには表示されますが、ダウンロードはできません。