KitPlugin 1.6.4
Overview
Let’s your users simply get predefined Kits with one command.
Users have to pay for the kits, if the server is running with Vault and any supported economy plugin.
Works with Minecraft 1.6+
Plugin Setup
Main Config:
| ShowSelect |
|
config.yml (created on first start)
KitMessage: 'Enjoy your Kit ;)'
CheckUpdate: true
DownloadUpdate: false
Explanation
- KitMessage: This defines the message which is printed after you received your kit.
- CheckUpdate: To enable/disable the update checking (true/false).
- DownloadUpdate: To enable/disable the update downloading (true/false).
|
Kits config:
| ShowSelect |
|
kits.yml (created on first start)
Extended example:
mykitname:
items:
examplesword:
id: 276
data: 0
amount: 1
enchantments:
- 33,2
- 32,1
- 0,1
lore:
- '&0This makes a colored text'
- '&1This is colored too'
- 'This is uncolored'
- 'Recipient's name is (player)'
name: '&1Colored Swordname'
slot: inventory
orangewool:
id: 35
data: 1
amount: 10
slot: inventory
magentawool:
id: 35
data: 2
amount: 10
slot: inventory
myhelmet:
id: 301
amount: 1
slot: helmet
color: 51 255 204
commands:
- say That triggered a say command
- tell (player) Hi, I am the console.
removeeffects: true
effects:
- 1,10,2
- 2,10,3
givemoney: 20
givexp: 50
usages: 0
clearinv: true
cleararmor: true
cooldown: 10
price: 0
message: '&1Enjoy it ;)'
Simple example:
simpletkitname:
items:
coloredwool:
id: 35
data: 3
amount: 10
slot: inventory
helmetlether:
id: 298
amount: 1
slot: helmet
cooldown: 10
message: '&1Enjoy it ;)'
How to make kits
Kits are defined in this format:
[kitname]:
items:
[identifier - any string]
id: [any integer]
data: [data value - for wool/potions/etc]
amount: [any integer]
color: [any rgb color]
enchantments:
- [ID,Level]
lore:
- '[any string]'
name:
- '[any string]'
slot: [helmet, chestplate, leggings, boots, inventory]
commands:
- [your commands string here - no "/" required]
removeeffects: [true or false]
effects:
- [ID, Duration(seconds), strength]
givemoney: [any floating-point number]
givexp: [any integer]
usages: [-1, 0, 1 or more]
clearinv: [true or false]
clearamor: [true or false]
cooldown: [cooldown in seconds]
price: [price as floating-point number]
message: '[any string]'
IMPORTANT: The kits config is using Bukkit’s yaml parser. That means you can’t use TAB indentation and you have to use spaces (see example).
Also if you don’t set an attribute, it will use its default value.
Available config attributes
| attribute |
description |
possible |
default |
| items |
This is where you put all your items IDs in (surrounded by ‘ ‘). See example above. |
item ids |
none |
| identifier |
This is a string you have to put right above every item section. That allows you to use the same item ID multiple times. |
any string |
none |
| id |
Put in the item ID without data values here (data value belongs to data – for wool/potions/etc). |
any item id |
0 |
| data |
This can be used for data values (e.g. wool, potions, etc) |
any data id |
0 |
| amount |
The amount of the item |
any integer |
0 |
| color |
Only works for leather armor. Requires a RGB color String. Scroll down for detailed explanation. |
any rgb color |
none |
| enchantments |
Define the enchantments for the item here. Format: ID,Level |
any enchant id |
none |
| lore |
Here you can set an item desciption (colors supported – see below). Has to be surrounded with ‘ ‘ |
any string |
none |
| name |
Define an item name here if you want. |
any string |
none |
| slot |
Here you can define the slot for the item (helmet,chestplate,leggings,boots,inventory) |
see description |
inventory |
| commands |
Here you can list commands which are being executed after requesting a kit. (player) represents the name of the player who is getting the kit. See example above.Note: This are console commands! Players don’t need the permissions for the commands. |
strings |
none |
| removeeffects |
If true, this removes all effects on the player when requesting the kit |
true or false |
false |
| effects |
Potion effects that are directly applied to the player. Format: ID,Duration,Strength |
any effect id |
none |
| givemoney |
Give money to the user who is requesting the kit (requires Vault + Economy plugin). |
any floating-point number |
0.0 |
| givexp |
Give experience points to the kit requester. |
any integer |
0 |
| usages |
Defines how often a player can request this kit. -2 = deathkit; -1 = starterkit; 0 = infinite; 1 = only once; 2 or higher = limited to the given number |
-2, -1, 0, 1 or higher |
0 |
| cooldown |
Here you can set a cooldown (in seconds) if you want. |
any integer |
0 |
| clearinv |
Set this to true if you want the player’s inventory to be cleared out before sending the kit. |
true or false |
false |
| cleararmor |
Set this to true if you want the player’s armor to be cleared out before sending the kit. |
true or false |
false |
| price |
If you got Vault + Economy plugin installed, you can set a price here. |
any floating-point number |
0.0 |
| message |
Here you can specify a custom message for this kit. The default message from config.yml will be used if you leave that empty or remove the “message:” field. Colors are possible: See color codes. Has to be surrounded with ‘ ‘ |
any string |
nothing |
Enchantmemt IDs
| ID |
Enchant |
| 0 |
Protection |
| 1 |
Fire Protection |
| 2 |
Feather Falling |
| 3 |
Blast Protection |
| 4 |
Projectile Protection |
| 5 |
Respiration |
| 6 |
Aqua Affinity |
| 7 |
Thorns |
| 16 |
Sharpness |
| 17 |
Smite |
| 18 |
Bane Of Arthropods |
| 19 |
Knockback |
| 20 |
Fire Aspect |
| 21 |
Looting |
| 32 |
Efficiency |
| 33 |
Silk Touch |
| 34 |
Unbreaking |
| 35 |
Fortune |
| 48 |
Power |
| 49 |
Punch |
| 50 |
Flame |
| 51 |
Infinity |
Color IDs
| ID |
Color |
| &0 |
Black |
| &1 |
Dark Blue |
| &2 |
Dark Green |
| &3 |
Dark Aqua |
| &4 |
Dark Red |
| &5 |
Dark Purple |
| &6 |
Gold |
| &7 |
Gray |
| &8 |
Dark Gray |
| &9 |
Blue |
| &a |
Green |
| &b |
Aqua |
| &c |
Red |
| &d |
Light Purple |
| &e |
Yellow |
| &f |
White |
| &k |
Magic/Obfuscated |
| &l |
Bold |
| &m |
Strikethrough |
| &n |
Underline |
| &o |
Italic |
| &r |
Reset Color |
|
Commands:
| ShowSelect |
|
Commands
- /kit
Shows a list of all available Kits.
- /kit testkit
Gives you the Kit with the name “testkit” (kit must be set in config).
- /kit testkit player1
Gives “player1” the Kit with the name “testkit” (kit must exist).
- /kit reload
Reloads kits and main config.
|
Permissions:
| ShowSelect |
|
Permissions
- kit.kit
Permission to use /kit
- kit.nameofkit
Permission to use /kit nameofkit.
Every kit has its own permission node composed of “kit.” the name of the kit.
- kit.proxy
Bypass cooldowns and ability to give other players Kits.
- kit.reload
Permission to use /kit reload
- kit.version
Everyone with this permission will get a notice about new plugin versions when they join the server.
|
Don’t post issues in the comments. Open a ticket instead.
Requirements for v6.0 or higher
- Craftbukkit between 1.4.x and 1.6.x
- Permissions Plugin
- Vault (for Economy support) – Optional !
Subscribe for real-time notifications
You ever wondered how to subscribe to plugins and get e-mail notifications about updates?
Just hit the Subscriptions button in the menu and use the same settings as here.
Misc
KitPlugin is using metrics to collect stats! It only collects basic things such as version type, and players online. It also includes an update-checker and auto-updater. You can enable/disable both in the config file
Changelogs:
v6.6
- Leather armor colors are not working when using “inventory” as slot
v6.5
v6.4
- Names on items are now getting colorized if a color is defined
- Colors for leather armor are now optional
v6.3 for MC 1.6.4
- Auto Updater: KitPlugin now downloads updates automatically if you set “DownloadUpdate” to “true” in the config.yml
v6.0 for MC 1.6.2
Fixed
- Items are now getting dropped if your inventory is full
- Kits are now using the proper stacksize for items
Changed
- Another small config rework to support new stuff
- History is now stored in yaml files
- Updated Metrics to R7
Added
- The “new version available” notification now includes the number of the newer version
- Item name and description
- Status effects which are applied directly to the player
- Deathkits! You can get this kits only once per life.
- You now can define which slot shall be used for items
- It is now possible to remove armor contents before giving kits
- Colors for messages
Important notes
- This version does not work with older configs (v4.x or v5.x). You have to update them!
Download KitPlugin
For 1.6.4
http://dl2.5minecraft.net/download.php?file=978d0fe2b1d2ce24e12f09e3005712b6
Old version
http://dl2.5minecraft.net/download.php?file=5189eb971ae0ea1aa07ad582090585b3
http://dl2.5minecraft.net/download.php?file=f2cebc00a808319117df3a82491f64d9
http://dl2.5minecraft.net/download.php?file=1d5c21be9e0c74eb5f55954439e47194
For 1.6.2
http://dl2.5minecraft.net/download.php?file=694b56dd582e53cd35b870829cdcef80
For 1.5.2
http://dl2.5minecraft.net/download.php?file=fe93acdec2a618912531be012b6ce33f
Credits: recon88
Minecraft Download 1.8.8 Minecraft download center
