AmazingKit

114k Downloads

logo!!!

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:

scr

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:

scr

Metrics Collection

This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:

  1. A unique identifier
  2. The server's version of Java
  3. Whether the server is in offline or online mode
  4. The plugin's version
  5. The server's version
  6. The OS version/name and architecture
  7. The core count for the CPU
  8. The number of players online
  9. 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.