KitMaster
KitMaster is a short-term inventory/effect/permission kit management plugin. As a server owner, you define kits in the plugin's configuration files. Your players can then take the kits either via a simple command, or by punching one of the kit selection signs depicted above. KitMaster provides you with the greatest amount of functionality possible, while at the same time remaining astonishingly lightweight and delivering rapid performance.
Click here to find out more about KitMaster and learn how to use the configuration and permissions.
This plugin uses the common MCStats data collection system to collect statistics about server version, plugin version, operating system, machine specs, etc. If this makes you uncomfortable, you can always disable it through the PluginMetrics configuration in plugins/PluginMetrics/config.yml.
In addition, this plugin by default will automatically download the latest versions of itself from BukkitDev and install them in order to keep itself up to date. If this makes you uncomfortable, you can disable automatic downloading of updates, OR disable the version check completely via the plugin's configuration in plugins/KitMaster/config.yml.
Features
- Dynamic and powerful syntax for defining items within kits
- All items are parsed using the same format, so you don't have to remember tricky formatting
- Different items have different data, but it's all configured using the same, simple format
- Kits can carry more than just items
- Define time-limited potion effects, or effects that renew automatically as long as you have the kit
- Add permissions to kits that will be granted to players when they take the kit, and revoked when it's lost (Vault required)
- Full MySQL support for saving internal data
- MySQL is a lightning-fast database that saves changes instantly and suffers no lag at startup, no matter how much data is stored
- Optionally enable MySQL to store internal data like sign locations, timestamps, and histories
- Never worry about lag on startup from loading massive files
- If your server crashes without saving data files, all your changes are still saved in the MySQL database
- Define timeouts for kits
- Configure kits so that a certain amount of time must pass before they can be taken again
- Apply a universal timeout so that nobody else on the server can take the kit until the timeout has passed
- Clearing inventories is completely configurable
- Individual kits can be configured to clear a player's inventory when taken, or leave it alone - useful for main class kits and auxiliary "supply drop" kits
- Selectively configure kits to clear inventories, potion effects (including recurring kit-granted), or kit-granted permissions
- Hook into economies
- Allow kits to either grant money or charge money when taken (Vault required)
- Special permissions to allow player's to bypass currency charges for taking a kit
- Powerful and effortless inheritance system
- Kits inherit both attributes and contents from their parents
- Multilevel recursive inheritance - parents, grandparents, great-grandparents...
- Allow a parent kit's permissions to override the child's, or require the parent's permissions in addition to the child's
- Simple, intuitive permissions granting
- Grant permissions per-kit
- Grant permissions for players to take a kit only by sign, or only by command
- Grant permissions to bypass timeouts and currency charges
- Never worry about needing to revoke permissions - permissions are always denied, unless explicitly granted
- Simple, clean kit list by command
- Players will only be shown kits which they have permission for
- Restrictions for how a player may take a kit are displayed next to the kit's name
- Kits may be configured to be invisible in the kit list
- Easy for other plugins to hook into
- Provides a capable yet secure API for other developers to hook into and manipulate the plugin, including custom events
- Kits can be defined with an extra "identifier" string to help dependent plugins find the kit they need or categorize kits
- Full item metadata support
- Save the contents of a book with a command and give the book to other players in kits
- Define custom potions within the custom data config and give them to players
- Give out your own skull (or somebody else's)
- Set up custom-colored leather armor to easily denote specific classes
- Save a firework with a command and give it to other players in kits
- Custom item names and lore
- Save or configure items with custom names and lore, and give them out in kits
- Access a custom item in a kit config simply by using its custom name
- Make up custom potions
- Use the custom data config to brew up your own unique concoctions with unique sets of effects
- Combine custom potion effect data with custom item names and lore to create completely new potions
Hi, is it possible for a message to be sent to the player after they take the kit?
Ok, I actually got all of the kits to work! So great about that. But I was testing the kits while in a lower rank and I was able to get "ranger." Then I killed myself so i could get it again and that worked. So then I wanted to get the bruiser kit. So I killed myself again and typed /kit Bruiser and it said: this kit can only be used ones. Although I am pretty sure i put in the configuration file for it Single Use as false. So i don't know what is wrong with this. I will put my config file and kits file into a paste bin link:
Kits.yml and Config.yml
Can u make it so where when u hit someone with a sword it will give the enemy the wither effect?
@Cheeserwizzer
Paste your kits.yml as well as the logs from the server startup into a paste at http://www.pastebin.com, and send me the links in a PM. I'll do my best to help.
Well, i guess bukkit decided to screw things up. It bunch all of the text into a giant paragraph. I hope someone can still find the problem though.
Hi, I got this plugin today and was super excited about all of the features. However I created a few kits which took me like an hour and now they don't work. I don't know what is wrong with it. I joined the server to test them (with /kit brawler etc.) and it said that each of them didn't exist! Here is the entire kits.yml, PLEASE HELP!
Brawler: items: - Diamond_Sword:1 Sharpness:2 - Iron_Helmet:1 - Iron_Chestplate:1 Protection:1 - Iron_Leggings:1 - Iron_Boots:1 - Bread:64 effects: - Strength:1 infiniteEffects: true timeout: duration: 0 global: false singleUse: false singleUsePerLife: true clear: all: true inventory: true effects: true permissions: true inheritance: parent: '' upgrade: true inheritParentPerms: false requireParentPerms: false economy: cost: 0.0 cash: 0.0 restrictions: armor: false drops: true deathDrops: true pickups: false otherKits: true showInList: true Ranger: items: - Bow:1 Power:3 Punch:1 Infinity:1 - Wood_Sword:1 - Chainmail_Helmet:1 Protection:1 - Chainmail_Chestplate:1 Protection:1 - Chainmail_Leggings:1 Protection:1 - Chainmail_Leggings:1 Protection:1 - Bread:64 effects: - Night_Vision:1 - Speed:2 infiniteEffects: true timeout: duration: 0 global: false singleUse: false singleUsePerLife: true clear: all: true inventory: true effects: true permissions: true inheritance: parent: " upgrade: true inheritParentPerms: false requireParentPerms: false economy: cost: 0.0 cash: 0.0 restrictions: armor: false drops: true deathDrops: true pickups: false otherKits: true shownInList: true Bruiser: items: - Iron_Sword:1 - Diamond_Helmet:1 - Diamond_Chestplate:1 - Diamond_Leggings:1 - Diamond_Boots:1 - Bread:64 effects: - Resistance:1 infiniteEffects: true timeout: duration:0 global: false singleUse: false singleUsePerLife: true clear: all: true inventory: true effects: true permissions: true inheritance: parent: " upgrade: true inheritParentPerms: false requireParentPerms: false economy: cost: 0.0 cash: 00 restrictions: armor: false drops: true deathDrops: true pickups: false otherKits: true shownInList: true Shaman: items: - Gold_Sword:1 Sharpness:5 Unbreaking:3 Fire_Aspect:2 - Gold_Helmet:1 Unbreaking:3 - Gold_Chestplate:1 Unbreaking:3 - Gold_Leggings:1 Unbreaking:3 - Gold_Boots:1 Unbreaking:3 - Bread:64 effects: - Resistance:1 - Speed:1 - Strength:1 - Regeneration:1 - Fire_Resistance:1 - Night_Vision:1 infiniteEffects: true timeout: duration:0 global: false singleUse: false singleUsePerLife: true clear: all: true inventory: true effects: true permissions: true inheritance: parent: " upgrade: true inheritParentPerms: false requireParentPerms: false economy: cost: 0.0 cash: 0.0 restrictions: armor: false drops: true deathDrops: true pickups: false otherKits: true showInList: true WarLord: items: - Diamond_Sword:1 Sharpness:1 - Diamond_Helmet:1 Protection:1 - Diamond_Chestplate:1 Protection:1 - Diamond_Leggings:1 Protection:1 - Diamond_Boots:1 Protection:1 effects: - Resistance:1 - Speed:1 - Strength:1 - Regeneration:1 - Fire_Resistance:1 - Night_Vision:1 infiniteEffects: true timeout: duration:0 global: false singleUse: false singleUsePerLife: true clear: all: true inventory: true effects: true permissions: true inheritance: parent: " upgrade: true inheritParentPerms: false requireParentPerms: false economy: cost: 0.0 cash: 0.0 restrictions: armor: false drops: true deathDrops: true pickups: false otherKits: true showInList: true
Hello! I don't know if this a bug or not, but I can't seem to make more than 2 custom items. And it doesn't seem like the permissions work with kits, either that, or my permission node is wrong.
Also I'd like to ask if the new potion effects will be added, and will I be able to add them to my kits?
You should a link to your Github page. I was able to find it by guessing that your Github username was AmoebaMan, it would make it easier to contribute if there was a link to it.
@ImLeo4006
I'll check it out and include the fix in the coming release.
Hello! I think I've found a bug with the permissions... Apparently Permissions dont allow a person to do /givekit <name> <kit> BUT, there is a command that works even without the permission kitmaster.kit which is /kit give <name> <kit> It's kind of a pain... Could you please fix it?
Update coming very soon
@Cavimine
To make a player respawn with a kit, give them the permission node
kitmaster.respawn.<kit>
.I don't know how to make it so that they are able to respawn with the kit? Where is that in the config? Please help.
Update your permissions page to reflect /kitinfo. The node is - kitmaster.info
@rohan0444mc
Include something like this in the kit config:
I can't figure this out and the kit config page doesn't help. Apparently you can make it so that when a player takes a kit they get a permission but they lose that permission when they die. I can't figure out how to do that and all I can find about permissions is that you can have them cleared on death. How do you add them???
How can i make it so players do not automatically respawn with kit?
Is it possible in any way for the kits to be made in-game, I've seen a few plugins like LiteKits and Kits and ClassesRP (RP plugin) do it and i think it would be alot easier on the user if you could do that.
Peace
Can you select kits from books with this plugin.. if you cant, does anyone know what plugin that is?
Thanks!
For all of you wondering, I've been away at U.S. Army Basic Combat Training and Advanced Individual Training for the past few months, which is why the plugin hasn't been updated or worked on at all.
I apologize for any inconvenience this has caused. Development and assistance should resume soon.