Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/luca28pet/advancedkits
A PocketMine-MP plugin that adds kits to your server with many features and support for UIs and custom enchantments
https://github.com/luca28pet/advancedkits
pocketmine-mp-plugin
Last synced: about 1 month ago
JSON representation
A PocketMine-MP plugin that adds kits to your server with many features and support for UIs and custom enchantments
- Host: GitHub
- URL: https://github.com/luca28pet/advancedkits
- Owner: luca28pet
- License: agpl-3.0
- Created: 2014-07-16T21:29:31.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-09-15T05:29:01.000Z (about 1 year ago)
- Last Synced: 2024-09-26T10:21:41.355Z (about 2 months ago)
- Topics: pocketmine-mp-plugin
- Language: PHP
- Homepage:
- Size: 178 KB
- Stars: 42
- Watchers: 24
- Forks: 65
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
AdvancedKits
============
A PocketMine-MP plugin that adds kits to your server with many features and support for UIs (FormAPI plugin) and custom enchantments (PiggyCustomEnchants)
*Latest release: https://poggit.pmmp.io/p/AdvancedKits/*
*Latest development phars: https://poggit.pmmp.io/ci/luca28pet/AdvancedKits/AdvancedKits*
This plugin only supports PocketMine-MP. It might work on other forks as well, but please Do NOT open issues if you have problems with AdvancedKits and you are using a fork.
**Features overview:**
- Highly configurable
- UI (user interface) support using libFormAPI (already included in the phars)
- Custom enchantments support using PiggyCustomEnchants plugin
- Custom permissions support
- Built in permissions system if you don't want to use any permissions manager (see kits.yml)
- Economy support: pay to get a kit. Support for EconomyS, PocketMoney and MassiveEconomy
- Sign support: write a sign to let users get a kit
- Time limit (cooldown) for kits
- Option for one kit per life (see config.yml)
- Execute commands with kits
- Easy translation system
**Commands:**
The main command: /kit
Alias for /kit: /ak, /advancedkits .
- /kit [kitname] - Selects a kit. If no argument is kit name, opens the UI if possible or display a list of available kits.
- /akreload - reloads kits.yml (when edited while the server is running)
**Signs:**
To let users get a kit through a sign, you can create one like this: (capitals don't matter)
Line 1: [AdvancedKits]
Line 2: kitname
Line 3 & 4: Whatever you like
The default kit is: testkit.
You can add kits editing kits.yml (see "Kit settings").
**UI support:**
You don't need to install the plugin FormAPI as it is already included in the latest phars from poggit.
To let users select a kit using a UI, enable 'show-form-no-args' in the config.yml
Then, to open the UI, use /kit
If you run this plugin in folder format, you will have to use DEVirion and manually install FormAPI, or disable 'show-form-no-args' in the config.yml
**Permissions:**
If 'permissions-mode' in the config.yml is true: with the permission advancedkits.kitname, a player will be able to get the kit named "kitname".
Note: in the permission, the kit name HAS to be ALL in lowercase letters.
If 'permissions-mode' in the config.yml is false, you can specify in the kits.yml which users (and in which worlds) can get a kit. (see kit settings)
**Kit Settings:**
In order to add a kit you will need to edit the config kits.yml .
If you open that file with bloc notes, you will be not able to edit because it will be all in one line, so open it with WordPad, Notepad ++, ...
You can add lots of kits, but remember to keep this format:
```
testkit:
# ITEM FORMAT: "id:damage:count:name:ench_name:ench_level"
# NO enchantments and NO custom name: "id:damage:count"
# ONLY custom name: "id:damage:count:custom name"
# ONLY enchantments: "id:damage:count:DEFAULT:enchantment1:level"
# (Put DEFAULT in the name field if you do not want a custom name)
# You can put as many enchantments as you want like this: "id:damage:count:DEFAULT:enchantment1:level:enchantment2:level" etc.
# Enchantments AND custom name: "id:damage:count:custom name:enchantment1:level"
# You can put as many enchantments as you want like this: "id:damage:count:custom name:enchantment1:level:enchantment2:level" etc.
# You can write both numeric or string IDs
items:
- "260:0:10"
- "267:0:1:Sword Name"
helmet: "diamond_helmet:0:1"
chestplate: "diamond_chestplate:0:1:DEFAULT:protection:1"
leggings: "diamond_leggings:0:1:Leggings Name"
boots: "diamond_boots:0:1"
# Set items for specific slots, will override existing items. Only use if you want to assign items to specific slots, otherwise delete this.
slots:
9: "golden_apple:0:5"
12: "bow:0:1"
commands:
- "tell {player} you got an awesome kit thanks to AdvancedKits plugin!"
cooldown:
hours: 24
minutes: 30
# EFFECT FORMAT: "name:seconds:amplifier"
effects:
- "speed:120:2"
# Add a cost for the kit. Compatible with EconomyAPI, PocketMoney and MassiveEconomy
# Put 0 if you want the kit to be free
money: 50
# If you do not use pureperms, use 'worlds' to specify in which worlds you want this kit to be used
# Leave blank to let use the kit in all worlds
worlds:
- "kitpvp"
# If you do not use pureperms, use 'users' to specify which players will be able to get this kit
# Leave blank to let all the players use this kit
users:
- "luca28pet"
- "dioconsole"
# FormAPI users:
# Img type: 'url' or 'path'
img-type: ''
# Put here the image URL/path
img-data: ''
# How the kit is displayed on the form
form-name: 'Test Kit: 50$'
```
You can find a list of available enchantments in the file Enchantment.php in the pmmp source code: https://github.com/pmmp/PocketMine-MP/blob/master/src/pocketmine/item/enchantment/Enchantment.php
If you don't specify users or world, then the kit will be available to all users or in all worlds.
If 'permissions-mode' in the config.yml is true, these parameters will be ignored
**Translations:**
You can easily translate plugin messages by editing the lang.properties file inside the plugin folder. Remember to don't change the "lang-version" parameter, as it is used for internal proposes.
**Config:**
```
---
# Users are able to get only one kit per life
one-kit-per-life: true
# Users are able to get a kit if they log out even if they did not die (only works if one-kit-per-life: true)
reset-on-logout: true
# Use built in permission system even if using PurePerms
force-builtin-permissions: false
# Sign text (capitals and color codes don't matter)
sign-text: "[AdvancedKits]"
...
```