AmazingKit is a plugin that allows players to receive a variety of play kits.
This idea is not new, and by myself i enjoyed /kit's in CommandBook for a long time, but it had serious disadvantages, that forced me to write this plugin.
Features:
- Create and edit kits directly in the game - you can not even touch the config file during setup!
- Save user recharges (cooldowns) of kits after server reboot: a familiar situation when players immediately after a server restart receive all kits? In this plugin so do not work, user recharges stored in a separate file.
- The ability to name a kit so as you want - in any language. For example, /kit food, /kit еда or /kit λύφο.
- You can store in kits any type of item with any metadata - even enchanted tools or written books!
- The ability to get one of the kits automatically when the player joins to the server first time.
Configuration
- messages.<language>.<key> - translation of any phrase being used by the plugin. You can edit it as you wish.
- locale - language translation being used by the plugin ("ru" or "en" at the present time).
- kitOnFirstJoin - any player after first join on the server will receive this kit (if have permission). May be <kitname> or "none" if not.
- kits.* - information about stored kits.
Permissions
- amazingkit.kit - access to command /kit.
- amazingkit.kit.<kitname> - access to a kit with name <kitname>.
- amazingkit.manage - full access to kit creating and editing. Note that you must have amazingkit.kit permission additionally.
Command reference
- /kit (or /kit list) - get list of available kits
- /kit <name> - get kit with name <name>
- /kit reload - reload configuration file
- /kit clearcooldown - reset all user cooldowns
- /kit create <name> - create empty kit with name <name>
- /kit erase <name> - fully remove kit with name <name>
- /kit clear <name> - remove all items in kit <name>
- /kit view <name> - view information about kit <name>
- /kit add/push/put <name> (with item in hand) - add item in your hand at the end of kit <name>
- /kit set <name> <position> (with item in hand) - put item in your had to the kit <name> on position <position>
- /kit get <name> <position> - get item from kit <name> on position <position>
- /kit delete/remove/del/rem <name> <position> - remove item in kit <name> on position <position>. All items in kit after <position> will be shifted to the left by 1.
- /kit cooldown <name> <cooldown> - edit cooldown of the kit <name>. Cooldown measured in seconds.
Installing
- Download a plugin
- Put it in /plugins directory
- Restart server
- Enjoy!
Usage example
This is an example of creating, editing, and getting of a kit:
That was consistent execution of these commands:
- /kit create starter
- /kit push starter (with diamond in hand)
- /kit push starter (with book in hand)
- /kit cooldown starter 86400
- /kit view starter
- /kit starter
- /kit starter
So, after that config.yml looks like this:
Metrics Collection
This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- The plugin's version
- The server's version
- The OS version/name and architecture
- The core count for the CPU
- The number of players online
- The Metrics version
Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.
Source code
https://github.com/akkez/AmazingKit
Sorry for my bad english, my native language is russian.