CannonRTP Content Packages

CannonRTP treats official cannon model and config bundles as Nightbreak-managed content packages instead of pure manual imports. Each package contains the cannon YAML configs and any FreeMinecraftModels resources that drive its 3D cannon model.

Main Commands

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

All of these require cannonrtp.admin.

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:

• 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 used by the bulk download flow
• 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's cannon files are present in plugins/CannonRTP/cannons/ and isEnabled is true
• downloaded but disabled -- the package's cannon files are sitting in plugins/CannonRTP/cannons_disabled/
• outdated -- a newer version is available on Nightbreak
• not downloaded -- nothing local yet

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.

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.