AmazingKit
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.
Is it possible to make buyable kits using this? If so, could somebody please tell me?
In reply to Chaos44445:
is it clear inventory when you choose another kit?
@Supermariokid99
De-Op them....
Opped players have access to everything anyway. If it's an Issue why give them Op?
I have this plugin but have 1 Problem with it... Opped players can bypass the cooldown and I want to know how to disable this
I curious to wonder what can truly be done about bwink's issue "...I have a starter kit I want players to only get on first time and never again... "
Putting a large cooldown is a workaround, but that's exactly what it is. Would you be able to implement the feature where
example:
A kit that can only be used twice by one character that gives the player some starter equipment that they will be expected to craft themselves thereafter.
I've looked at and tested countless kit plugins, and this is the only one that remotely works for my application without game breaking bugs. I was ready to make my own until i found yours. Keep up the great work! Very robust so far. PS. Any plans to add economy system support?
@a1var023
It wont let deoped people use the kit. Help Me! thx JoJo Ps: Plugin is great exept for that part I hope the add that in a future update
I've pushed an update which fixes kits with very big cooldown (99999999+ seconds). Now they must work properly.
@Gahshunk292
Glad to hear it. Thanks!
This plugin is a godsend among kit plugins. Please, keep up the amazing work!
Love this plugin easy to use and verry helpfull but i got one thing that will really finish this. Could you pleas make a option that you can use a kit once per life so you cannot spamm the kit when the cooldown is over ore use more kits at once ( i have a kit pvp server ). Il hope you could do this and if you don't i still <3 your plugin (:
There needs to be a kit give command
i got a problem why players cannot use any kits command
Seems to work in 1.7.2
But I do have a small issue. I have a starter kit I want players to only get on first time and never again. Since I can't make a kit a one time kit, I set the delay at 99999999 which should be 1157 days. But if someone calls the kit it tells them they can refresh after 14 days. You might need to change your int into a long. Or add the option to not be able to regain a kit.
@Fibbs123
I've tested it on 1.6.2, it works OK... probably.
Update to 1.6.2!
@UserDead
Yeah , mostly Survival server needed..
Hi everyone. So maybe you add a economy to kits? Most need)
Yeah thanks. Just tested that :)
@WauloK
You can get a kit again and again despite the cooldown because you have a "amazingkit.manage" permission. I thought that this feature will be useful for administrators.