Commands & permissions
The root command is /creeperconfetti, with /cc and /confetti registered as aliases. Every feature is a subcommand.
Command overview
| Subcommand | Aliases | Purpose | Players only |
|---|---|---|---|
help [page|command] | ?, h | Paginated help with clickable page buttons | no |
effect <action> | effects, style, styles, firework | Manage styles and per-style chances | some |
chance [percent] | probability, percent | View or set the overall chance | no |
gui | menu | Open the in-game style manager | yes |
language <action> | lang | View, switch and reload languages | no |
reload | rl | Reload config, styles, language and aliases | no |
Running /cc with no arguments is the same as /cc help. An unknown subcommand prints a hint and opens the first help page.
/cc effect
Everything about styles lives here. Brackets are optional arguments, angle brackets are required.
| Usage | Description | Permission | Restriction |
|---|---|---|---|
/cc effect list | List every style: index, name, effect count, current chance | effect | — |
/cc effect add [name] | Save the rocket in your hand as a new style; without a name it becomes style1, style2… | effect | players only |
/cc effect set <name> | Overwrite a style with the rocket in your hand (creates it if missing) | effect | players only |
/cc effect remove <name> | Delete a style; alias delete | effect | — |
/cc effect reset | Restore the four built-in styles and rebalance the chances | effect | — |
/cc effect preview [name] | Preview a style at your feet; without a name a random one is previewed; alias test | effect | players only |
/cc effect chance | Show every chance and the total | effect | — |
/cc effect chance <name> <percent> | Pin one style to a chance; the rest are compensated | effect | — |
/cc effect chance reset | Reset all chances to an even split | effect | — |
Examples
# what is configured right now
/cc effect list
# hold a rocket with an effect, save it as "festival"
/cc effect add festival
# give it half of the weight; the others share the rest
/cc effect chance festival 50
# preview it on its own
/cc effect preview festival
# remove it
/cc effect remove festivalStyle names are case-insensitive: Classic and classic are the same style. The original capitalisation is kept for display and when writing back to the config.
add and set automatically preview the style at your position on success, so you do not need a separate preview.
/cc chance
| Usage | Description |
|---|---|
/cc chance | Show the current overall chance |
/cc chance <0-100> | Set the overall chance; written to the config immediately |
/cc chance 100 # every creeper becomes a firework
/cc chance 5 # five percent
/cc chance 0 # effectively disable itValues outside 0–100 or non-numbers are rejected with a message. This value and the per-style weights are two separate dimensions: first the plugin decides whether to convert, then it draws a style.
/cc gui
Opens the 54-slot style manager. Same capabilities as /cc effect, but visual. Requires creeperconfetti.command.effect and a player. See In-game GUI.
/cc language
| Usage | Description |
|---|---|
/cc language or /cc language info | Show the current language's display name and code |
/cc language list | List every available language, marking the current one |
/cc language set <code> | Switch language and write it to config.yml |
/cc language reload | Re-read the language files (use this after editing YAML) |
/cc language set zh_cn
/cc language list
/cc language reload/cc reload
Does four things, always in this order:
- re-reads
config.yml; - re-parses every firework style and chance;
- reloads the language files;
- unregisters and re-registers the
/ccand/confettialiases — so alias switches also apply without a restart.
/cc reload does not run config migration and does not re-register the root command. If you changed config-version or swapped the jar, do a full restart.
Permission nodes
| Node | Default | Purpose |
|---|---|---|
creeperconfetti.command | op | Base permission; without it even help is unavailable |
creeperconfetti.command.effect | op | Style management, including gui |
creeperconfetti.command.chance | op | View and change the overall chance |
creeperconfetti.command.language | op | Switch and reload the language |
creeperconfetti.command.reload | op | Reload the plugin |
creeperconfetti.command lists the four sub-permissions as children, so granting the base node to an admin group is usually enough:
# LuckPerms: grant full access
/lp group admin permission set creeperconfetti.command trueTo let someone edit styles but not reload the plugin, grant the child nodes explicitly:
/lp user Steve permission set creeperconfetti.command true
/lp user Steve permission set creeperconfetti.command.effect true
/lp user Steve permission set creeperconfetti.command.reload falseThe help screen only lists entries you have permission for, so a low-privilege player sees a shorter list. That is intended.
Tab completion
Completion is permission-aware; subcommands you cannot use never appear as suggestions:
- first level: every subcommand you have access to;
- after
/cc effect:list / add / set / remove / reset / preview / chance; - after
/cc effect set|remove|preview|chance: existing style names, plusresetforchance; - after
/cc language set: every language code; - after
/cc help: subcommand names.
Style names are read from memory, so a style added a second ago is already tab-completable.