Skip to main content

CannonRTP Commands and Permissions

CannonRTP registers its commands under the cannonrtp namespace.

  • Root command: /cannonrtp
  • Aliases: /crtp, /wc

/wc is the short alias most admins will use, but the underlying permission node is cannonrtp.admin for every subcommand.

Admin Commands

CommandSenderDescription
/cannonrtpAnyShows the help header followed by every registered subcommand the sender can use
/wc helpAnySame as /cannonrtp -- prints the help listing
/wc create <id>PlayerCreates a brand new cannon config and places the first instance at your current location
/wc create <id> <display_name>PlayerSame as above, but sets a custom display name (underscores become spaces)
/wc place <id>PlayerAppends another placement of an existing cannon at your current location
/wc remove <id>PlayerRemoves the nearest placement of <id> in your current world (config file is kept)
/wc delete <id>AnyDeletes the cannon's config file outright
/wc target <id> <world>PlayerChanges the cannon's target landing world
/wc center <id>PlayerSets the cannon's search center to your current location
/wc listAnyLists every placement with display name, status, queue size, and last status detail
/wc statusAnySame output as /wc list
/wc probePlayerTests whether your current location would pass all enabled protection checks
/wc reloadAnyReloads global config, every per-cannon config, tasks, and protection adapters
/wc setupPlayerOpens the Nightbreak-style content browser menu (lists installed and downloadable cannon packages)
/wc recommendedpluginsAnyOpens the Nightbreak catalog of recommended companion plugins for CannonRTP
/wc downloadpluginupdateAnyDownloads a newer CannonRTP plugin jar from Nightbreak (applied after the next server restart)
/wc downloadallAnyDownloads the CannonRTP plugin update and every available content package from Nightbreak
/wc downloadallcontentAnyDownloads every available CannonRTP content package from Nightbreak (content only, no plugin jar)
/wc updatecontentAnyDownloads updates for outdated CannonRTP content packages (alias: /wc updateallcontent)

CannonRTP does not ship a separate first-time /wc initialize menu -- it has no preset modes. The first time an admin joins after install, a Nightbreak chat warning prompts them to run /wc setup.

All of the admin subcommands above require cannonrtp.admin.

These Nightbreak commands ship inside CannonRTP

/wc setup, /wc recommendedplugins, /wc downloadpluginupdate, /wc downloadall, /wc downloadallcontent, and /wc updatecontent are provided by the shared MagmaCore library that is shaded into CannonRTP. They are registered automatically -- you do not see them in plugin.yml. The separate /nightbreaklogin <token> command (also from MagmaCore) registers your Nightbreak account token for premium downloads.

See the Content Packages page for details on what /wc setup, /wc downloadall, and /wc updatecontent actually manage.

create vs place vs remove vs delete

One cannon config (plugins/CannonRTP/cannons/<id>.yml) can drive many in-world placements. create makes the config and seeds the first placement. place appends another placement to an existing config. remove deletes one placement (the closest one to you in your world) but keeps the config. delete deletes the config file outright, removing every placement.

Player Interaction

There is no player command to activate a cannon. Players use CannonRTP by walking into the cannon's trigger radius (triggerRadius, default 1.75 blocks).

Permissions

Two permission nodes are registered in plugin.yml:

PermissionDefaultDescription
cannonrtp.adminopRequired for every admin subcommand (including the bundled Nightbreak setup / downloadall / updatecontent commands)
cannonrtp.usetrueRequired before a player can trigger any cannon

The shared /nightbreaklogin <token> command (provided by MagmaCore, not declared in CannonRTP's plugin.yml) uses its own nightbreak.login permission node.

How cannonrtp.use works

If a player lacks cannonrtp.use, the cannon silently ignores that player. No denial message is sent for this base permission check -- they simply walk through the cannon area without launching.

Per-Cannon Permission Gate

Each cannon config can also define a requiredPermission field.

  • If requiredPermission is blank (the default), the cannon only checks cannonrtp.use.
  • If requiredPermission is set and the player has cannonrtp.use but lacks the per-cannon node, CannonRTP sends the configured noPermission message including the cannon's display name. The message is throttled to once every three seconds per player per cannon.

Tab Completion

Commands that take a cannon <id> argument tab-complete from the list of known cannon config ids. Commands that take a <world> argument tab-complete from the list of currently loaded world names.