EquipControl

EquipControl

Important

The config layout has changed in 0.4. If you update from a lower version, you need to update your config as well.
Read here for further details.

Summary

EquipControl let's you control which weapons/armor a player can use via Permissions.
You can define which items are checked, what makes this plugin as dynamic as possible.
As of 0.4 you can also restrict the use of named weapons/armor.

Usage

When using a weapon without the permissions, it will not deal any damage.
When wearing a forbidden armor it will moved into the player's inventory after closing it. If it's full the armor will be dropped.

Permissions

Armor Permissions:
equipcontrol.armor.<id>
equipcontrol.armor.<material>
equipcontrol.armor.<material|id>.<nametag>
Weapon Permissions:
equipcontrol.weapon.<id>
equipcontrol.weapon.<material>
equipcontrol.weapon.<material|id>.<nametag>

<id> is the ID of this Item, <material> is the material name defined in bukkit.
<nametag> is the key, used in config, to identify restricted Itemnames.
You can find a list here: Link (1.1)

Config

Only Item-IDs are allowed.
Nametags/keys must be unique in every item but can be duplicated in different items.
IMPORTANT If you use formated item names (like color), you NEED to specifiy the format code in the item name. (§<code>)
To add Items without name restriction, put them under the list: section.
For items with name restriction create a new section

<id>:
    <nametag1>: "<name of the item>"
    <nametag2>: "<name of the item>"
    <nametagX>: "<name of the item>"

Default config:

checked_weapons:
    list:
    - 267
    - 268
    - 272
    - 276
    283:
        nametag: "Thors Hammer"
checked_armor:
    list:
    - 299
    - 300
    - 301    
    298:
        namekey: "Just a Hat"
string:
    weapon: "You don't have the needed permissions to use this weapon"
    helmet: "You don't have the needed permissions to wear this helemet"
    chest: "You don't have the needed permissions to wear this chestplate"
    leggings: "You don't have the needed permissions to wear this leggings"
    boots: "You don't have the needed permissions to wear this boots"
    namedarmor: "You don't have the needed permissions to wear %item%"
    namedweapon: "You don't have the needed permissions to use %item%"
CheckArmorOnDamage: false
CheckArmorPeriodical: false
CheckArmorTimer: 30 #time in seconds
useItemName: false

Source

Get the source on GitHub