Economy and progressFree
Kits
Kits of items with cooldown, price, permission and a starter kit for new players.
The Kits module lets you hand out sets of items: a starter kit for new players, a daily food kit, a paid tool kit, a VIP kit and so on. You build the content in game from your own inventory, then set everything else from the web editor.
Features
- Content captured in game:
/kit create <name>saves your current inventory as the kit, with every item exactly as it is (names, enchantments and so on). - Cooldown between two claims, or once only per player.
- Price in any currency of the economy.
- Permission to reserve a kit to some ranks. Players only see and claim the kits they are allowed to use.
- First join kit given automatically to new players.
- Nothing lost: what does not fit in the inventory is dropped at the player's feet, or kept in the player's mailbox if you prefer.
- Network wide: kits, cooldowns and claims are shared by all the servers of your network. A kit claimed on one server is on cooldown everywhere.
Setting it up
Create a kit
- In game, put the items of the kit in your inventory.
- Run
/kit create <name>. The name uses lowercase letters, digits and_. - Open the Kits module in the web editor: your kit appears in the Kits tab.
To change the content later, run /kit create <name> again with the new inventory. The content is replaced and the settings of the kit are kept.
A new kit starts with a cooldown of 1 day, no price and no permission.
Kits tab
Each kit has its own card showing its content and how many times it was claimed:
| Setting | What it does |
|---|---|
| Display name | Name shown to players when they receive the kit. |
| Icon | Item that represents the kit. |
| Cooldown | Time between two claims by the same player, for example 30m, 12h, 7d. 0s means no cooldown. |
| Price | Amount the player pays, and the currency. 0 makes the kit free. |
| Permission | Permission node needed to see and claim the kit. Empty means every player. |
| Once only | Each player can claim the kit a single time. The cooldown is then ignored. |
The Delete button removes the kit.
Settings tab
| Setting | What it does | Default |
|---|---|---|
| First join kit | Name of the kit given to new players on their first join. Empty means none. This kit is free and ignores its permission. | Empty |
| Drop what doesn't fit | When on, items that do not fit in the inventory drop at the player's feet. When off, the kit goes through the player's mailbox, and what does not fit waits there. | On |
Commands
| Command | What it does | Permission |
|---|---|---|
/kit |
Lists the kits you can use. Alias: /kits. |
inglis.kits.use (everyone) |
/kit <kit> |
Claims a kit, after checking its permission, cooldown and price. | inglis.kits.use (everyone) |
/kit create <name> |
Creates the kit from your inventory, or replaces the content of an existing kit. | inglis.kits.admin (operators) |
/kit delete <kit> |
Deletes a kit. | inglis.kits.admin (operators) |
/kit give <player> <kit> |
Gives a kit to an online player, for free and without cooldown. | inglis.kits.admin (operators) |
Each kit can also have its own permission, set in the Permission field of the kit.
Tips
- Make a "starter" kit with Once only on and set it as the First join kit: new players get it automatically and cannot claim it again.
- For rank kits, give the kit a permission such as
kits.vipand grant it to the rank in the ranks module. - Coming from another plugin? Kits can be brought over with a migration.