CannonRTP Content Packages

CannonRTP manages official cannon models as Nightbreak content packages. The current Free Cannon and Premium Cannon downloads contain the FreeMinecraftModels model and a package version marker under content_packages/. CannonRTP itself generates the matching cannon configs in cannons/; the downloads do not supply placement configs.

Main Commands

Command	Purpose
/wc setup	Opens the Nightbreak content browser menu (lists installed and downloadable cannon packages)
/wc downloadall	Downloads the CannonRTP plugin update and every available content package from Nightbreak
/wc updatecontent	Bulk-updates outdated CannonRTP content packages (alias: /wc updateallcontent)
/wc reload	Reloads CannonRTP after a manual import
/nightbreaklogin <token>	Shared Nightbreak token registration -- required for premium packages

The /wc management commands require cannonrtp.admin. The separate account command /nightbreaklogin <token> requires nightbreak.login.

Besides the cannon packages, the /wc setup menu shows a plugin update entry (click it to download an available update), a recommended plugins entry, a download-everything entry that runs /wc downloadall, and an automatic-updates toggle that writes nightbreak.autoDownloadPluginUpdates in config.yml (see Configuration).

Built-in Packages

CannonRTP ships package definitions for two Nightbreak bundles by default:

Package id	Display name	Source
cannonrtp	Free CannonRTP	Free Nightbreak download
cannonrtp_premium	Premium CannonRTP	Requires Nightbreak premium supporter access

Each definition lives in plugins/CannonRTP/content_packages/<id>.yml and stores:

• isEnabled -- whether the package is turned on; the /wc setup menu writes it when you enable or disable the package
• version -- local installed version (used by /wc updatecontent to decide what is outdated)
• name and description -- shown in the /wc setup menu
• downloadLink -- the Nightbreak page CannonRTP points you to when a package has no nightbreakSlug and has to be downloaded by hand, and the link in the console warning about an outdated package
• folderName and contentFilePrefixes -- which files inside the package CannonRTP considers part of it
• nightbreakSlug -- the Nightbreak project slug used by the download/update endpoint

You should not normally hand-edit these files -- they are regenerated and rewritten by the plugin.

Package States

Inside the /wc setup menu each package shows as one of:

• installed -- the package meets the downloaded checks below, its metadata has isEnabled: true, and matching cannon entries are present in plugins/CannonRTP/cannons/
• downloaded but disabled -- the model download is recognized, but the package is not active; disabling through the menu moves its cannon files to plugins/CannonRTP/cannons_disabled/
• outdated -- the package is installed and a newer version is available on Nightbreak; if your linked account no longer has access, the menu says so instead of offering the update
• needs access -- the package is not downloaded, you are logged in, and your Nightbreak account does not have access to it
• not downloaded -- the package lacks a positive local version marker or its model files cannot be found

Generated cannon YAML files alone do not prove a package was downloaded. CannonRTP requires both a local package version greater than zero and at least one .bbmodel file inside the package's folderName under plugins/FreeMinecraftModels/models/ or plugins/FreeMinecraftModels/Models/. A missing model folder therefore makes the package downloadable again even if its generated cannon configuration still exists.

Clicking a package in the menu downloads, installs, enables, or disables it. Disabling a package moves its cannon configs from cannons/ into cannons_disabled/ without deleting them, so re-enabling restores the same files. CannonRTP recreates its built-in cannonrtp_free_cannon.yml and cannonrtp_premium_cannon.yml whenever they are missing from cannons/, so after a disable the reload leaves default copies with no placements there; re-enabling moves the saved files back over them.

Cannon Folder Layout

Folder	Purpose
plugins/CannonRTP/cannons/	Active cannon configs. Anything here is loaded on startup or /wc reload.
plugins/CannonRTP/cannons_disabled/	Packaged cannon configs that are currently turned off. Files here are ignored by the loader but preserved for later re-enable.
plugins/CannonRTP/imports/	Drop folder for manual package imports. CannonRTP scans this on startup and merges its contents into the package folders.

Manual Import Fallback

You can still install a package by hand:

1. Download the package zip from Nightbreak.
2. Drop the zip (intact) into plugins/CannonRTP/imports/.
3. Run /wc reload.

CannonRTP will pick the package up, move the files into the appropriate folders, and reload the cannon configs. Manual import is still supported but is no longer the recommended workflow -- /wc setup and /wc downloadall handle it automatically.

Premium Access

Premium content packages (such as cannonrtp_premium) require a linked Nightbreak account. Use /nightbreaklogin <token> once with a token from your Nightbreak account page, then /wc downloadall or the /wc setup menu will be able to fetch premium content.

If you are not logged in, premium packages still appear in the setup menu but cannot be downloaded.