Commands and Permissions
This page lists every EcoCrates command and permission, so you can hand out keys, place crates, and control who can open what. All commands run under /ecocrates, /crates, /crate, /key, or /keys.
Commands
| Command | Description | Permission |
|---|---|---|
/ecocrates | Base command | ecocrates.command.ecocrates |
/ecocrates reload | Reloads the plugin | ecocrates.command.reload |
/ecocrates set <crate> | Set the block you're looking at to be a crate | ecocrates.command.set |
/ecocrates give <player> key <key> [physical\|virtual] [amount] | Gives a player keys (virtual by default) | ecocrates.command.give |
/ecocrates give <player> envoy <envoy> <flare\|compass> [amount] | Gives a player an envoy's flare or compass | ecocrates.command.give |
/ecocrates give <player> pouch <pouch> [amount] | Gives a player pouches | ecocrates.command.give |
/ecocrates giveall <key\|envoy\|pouch> <id> [variant] [amount] | Same as give, for all online players | ecocrates.command.giveall |
/ecocrates giveoffline <key\|envoy\|pouch> <id> [variant] [amount] | Same as give, for all online and offline players | ecocrates.command.giveoffline |
/ecocrates take <player> <key\|envoy\|pouch> <id> [variant] [amount] | Takes keys or items from an online player | ecocrates.command.take |
/ecocrates keys | View your keys | ecocrates.command.keys |
/ecocrates preview <crate\|pouch> <id> | Opens the preview for a crate or pouch | ecocrates.command.preview |
/ecocrates open <crate> [player] | Opens a crate using virtual keys | ecocrates.command.open |
/ecocrates open <crate> <player> | Opens a crate for another player | ecocrates.command.open.others |
/ecocrates forceopen <crate> | Force-opens a crate without a key | ecocrates.command.forceopen |
/ecocrates forceopen <crate> <player> | Force-opens a crate for another player | ecocrates.command.forceopen.others |
/ecocrates resetwins <player/all> | Resets tracked reward wins | ecocrates.command.resetwins |
/ecocrates convert <converter> | Converts data from a supported crate plugin | ecocrates.command.convert |
/ecocrates envoy set <envoy> <current\|x> [y] [z] | Marks a spawn point for a points-mode envoy | ecocrates.command.envoy.set |
/ecocrates envoy unset <envoy> <point#> | Removes a spawn point | ecocrates.command.envoy.set |
/ecocrates envoy locate | Lists remaining envoy crates, click to teleport | ecocrates.command.envoy.locate |
/ecocrates envoy start <envoy> | Manually starts an envoy | ecocrates.command.envoy.start |
/ecocrates envoy end | Ends the active envoy | ecocrates.command.envoy.end |
For give, giveall, giveoffline and take, the word after the player (or first, for giveall/giveoffline) is the type: key, envoy or pouch. The ID after it is read from that type's folder. Keys use the key ID from /keys/, not the crate ID. With giveoffline, physical items for offline players are handed over the next time they join; give needs the player online for physical items. Amounts must be whole numbers above 0.
Additional permissions
| Permission | Description |
|---|---|
ecocrates.open.<crate> | Permission to open a specific crate |
ecocrates.open.* | Permission to open all crates |
ecocrates.pouch.<pouch> | Permission to open a specific pouch. Given by default |
ecocrates.pouch.* | Permission to open all pouches |
ecocrates.reroll.<crate> | Permission to reroll the crate reward (if enabled). Given by default; negate to prevent rerolls |
ecocrates.reroll.* | Permission to reroll all crates |
ecocrates.rewards.<reward> | Permission to be eligible for a specific reward (use ecocrates.rewards.* for all rewards) |
ecocrates.command.envoy | Allows the use of /ecocrates envoy (and /ecoenvoy) |
ecocrates.craft.flare | Permission to craft envoy start flares (if the envoy's flare recipe sets one). Given by default |
ecocrates.craft.compass | Permission to craft envoy compasses (if the envoy's compass recipe sets one). Given by default |
Chance multiplier permissions
You can create permissions that give players a chance multiplier for rewards, in config.yml.
permission-multipliers:
- permission: ecocrates.multiplier.vip # The permission node
multiplier: 1.5 # The chance multiplier applied to eligible rewards
priority: 1 # Higher priority wins when a player has several, e.g. 2 beats 1
Where to go next
Keys: hand out and configure keys in How to Make a Key.
Multipliers: the full multiplier config lives in Plugin Config.
Rerolls: see how rerolls work on Animations / Rolls.
Envoys: configure flares, compasses, and rarities in How to Make an Envoy.
Pouches: make single-use reward items in How to Make a Pouch.