diff --git a/README.md b/README.md index b082f3a..48b2eaa 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,141 @@ -ServerKits -====== +# ServerKits Kit plugin for PocketMine-MP + +## Category + +PocketMine-MP plugins + +## Requirements + +PocketMine-MP Alpha_1.4 API 1.9.0
+**Dependency Plugins:** MassiveEconomy v1.0 API 0.90 + +## Overview + +**ServerKits** allows you to create server kits. + +**EvolSoft Website:** http://www.evolsoft.tk + +***This Plugin uses the New API. You can't install it on old versions of PocketMine.***
+***YOU NEED MassiveEconomy TO USE THIS PLUGIN.*** + +With ServerKits you can create custom free and paid kits for your server.
+You can also set a default kit and players that will join for the first time on your server will get it and you can also place signs to get kits. (read documentation)
+*Remember that kits are case sensitive. This means that if you want to get a kit called "ToOls" for example, you can get it with "/kit ToOls" and not "/kit tools" or others...* + +**Commands:** + +***/serverkits*** *- ServerKits commands*
+***/kit*** *- Get a kit* + +**To-Do:** + +
- Bug fix (if bugs will be found)
+
- Get kit time limit
+ +## Documentation + +**Sign Creation:** + +*You must have the permission: "serverkits.create-sign" to create signs and you must have the permission "serverkits.use-sign" to use signs.* + +***Line 1:*** [ServerKits]
+***Line 2:*** <kit name (case sensitive)> + +**Add and configure a kit:** + +1. Open *kits.yml* file
+Default *kits.yml* file: +```yaml +--- +#Kit Name +Default: +#Kit Custom Name +name: "&bDefault_KIT" +#Kit Price +price: 0 +#Kit Items +#Items must have this format: "id:damage quantity" +items: +- "272 1" +- "274 1" +- "260 10" +- "298 1" +- "299 1" +- "300 1" +- "301 1" +#Kit Commands (optional) +commands: +- "tell {PLAYER} Kit Command Example" +Tools: +name: "&2Tools" +price: 0 +items: +- "272 1" +- "273 1" +- "274 1" +- "275 1" +Iron: +name: "&7IronKit" +price: 50 +items: +- "261 1" +- "262 16" +- "267 1" +- "306 1" +- "307 1" +- "308 1" +- "309 1" +Diamond: +name: "&9D&bIAMON&9D" +price: 200 +items: +- "261 1" +- "262 32" +- "276 1" +- "310 1" +- "311 1" +- "312 1" +- "313 1" +... +``` + +**Configuration (config.yml):** + +```yaml +--- +#Enable this if you want that a player who joined for the first time will get the kit +enable-default-kit: true +#Name of the kit that will get the player when he joins for the first time +default-kit: "Default" +#Enable this if you want to enable kit permissions. This will set to false only the permissions related to kits (ex. serverkits.kit.examplekit) +use-permissions: false +#Enable ServerKits signs creation/usage +enable-signs: true +#Message sent on kit received +#Available tags: +# - {KIT}: Show kit name +# - {KIT_NAME}: Show kit custom name +# - {PLAYER}: Show player name +# - {PRICE}: Show kit price +kit-received-message: "&aYou received the {KIT_NAME} &akit" +... +``` + +**Commands:** + +***/serverkits*** *- ServerKits commands (aliases: [skits])*
+***/kit <kit name (case sensitive)>*** - Get a kit* + +**Permissions:** + +-
serverkits.* - ServerKits permissions.
+-
serverkits.kit.* - ServerKits Kit permissions.
+-
serverkits.use-sign - Allows player to use ServerKits signs.
+-
serverkits.create-sign - Allows player to create ServerKits signs.
+-
serverkits.commands.* - ServerKits commands permissions.
+-
serverkits.commands.help - ServerKits command Help permission.
+-
serverkits.commands.info - ServerKits command Info permission.
+-
serverkits.commands.reload - ServerKits command Reload permission.
+-
serverkits.commands.kit - ServerKits command Kit permission.