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
I have a question, is equipcontrol able to check display.Lore tag strings?
@JustazG
The plugin checks the items you specify in the config file.
Why the plugin doesn't check the Leather helm(298 ID) ?
@JustazG
The plugin should work with 1.5.1 Use the new additional checks from 0.5 to handle dispenser and rightclick.
I'll update the plugin for this cases as soon as it is possible with Bukkit.
Plz update this plugin to 1.5.1 version i am really need this plugin
Right clicking and dispensers break this plugin, besides that its great!
Any speculations about when the update is coming?
Great work!
@broluigi
I added 2 additional, optional, armor checks with 0.5, which should help in this case.
-> config.yml CheckArmorOnDamage: true CheckArmorPeriodical: true#check every CheckArmorTimer seconds CheckArmorTimer: 30 #time in seconds
However, thanks for your report. I´ll look into it. (May take a while, as Bukkit needs to add a way to handle it)
1.5 breaks this plugin due to the dispensers auto equipping onto you
Hey, Can you maybe add this for potions and tools aswell? Would love that for my server! I'm not very much of a java coder myself :s
This is exactly what I did, step by step.
1.[]Created a wooden sword in RPG Items named test
/rpgitem test create, /rpgitem test give, /rpgitem test display test, /rpgitem test quality uncommon
2.[]Checked the format at an anvil
I placed the item in the anvil and the finished result said "00000000altest"
"00000000altest" = "&0&0&0&0&0&0&0&0&a<est"
3.[]Setup EquipControl to check for this item
4.[]Give your group the required permission to use this item
equipcontrol.weapon.268.test
Group A
Permissions: equipcontrol.weapon.268
Can use all wooden swords, including unchecked ones renamed by an anvil or other plugins
Cannot use named items checked by this plugin. The item I made is being checked
Without equipcontrol.weapon.268.test they cannot deal damage with it
Group B
Permissions: equipcontrol.weapon.268.test
Can use the wooden sword made earlier named test
Cannot use regular wooden swords or unchecked ones renamed by an anvil or other plugins
Group C
Permissions: equipcontrol.weapon.268, equipcontrol.weapon.268.test
Can use all wooden swords, including unchecked ones renamed by an anvil or other plugins and use the wooden sword made earlier named test
EquipControl should only disable damage with weapons not prevent you from casting a spell with that item. If you follow these directions it should work, it does for me!
@gameroy8
I just tested my last suggestion and it worked. You are doing something wrong somewhere with your permissions. Please post exactly what you are doing.
@gameroy8
Where do you want decimal/hex support?
would it be possible to add decimal and hexidecimal support for the formatting? would possibly make more plugins work. PRETTY PLEASE IF POSSIBLE?
@artlune
damn no luck. That sucks cuz that plugin is AMAZING.
i also notice that when you scroll through and it shows the name of your equipped item that it's not centered, but offset to the right a little, if that has anything to do with the 0s
@gameroy8
I don't even know how to begin to answer that. Any letter or number before test is supposed to be paired with an "&" character. So I guess it's actually named "&0&0&0&0&0&0&0&0&a<est". Wonder why there's so many 0's. Try this:
@artlune
the anvil said 00000000altest
how would i format that?
@gameroy8
You can find the format by using an anvil. Put the item in the first slot and hover over the finished item. Judging by the video I saw, it looks like the uncommon (green) items begin with &a&l so your item would technically be named "&a<est". If this is true it should say "altest" in the anvil gui and you would need to restrict it with this plugin by using
Note that with this plugin you have to use § instead of &. Best of luck
If anyone can figure out the formatting for the RPGItems plugin that would be phenominal. I wannt to restrict an uncommon (green text) wooden sword named test.
Thanks.
@SydMontague
You're right. Shows how much I know.
@gameroy8
The example config I showed earlier works and it also allows the use of renamed items from anvils because they aren't being checked. I was getting too far ahead of myself. It sounds like you are having a naming issue. Try the plugin I suggested for renaming items.
@SydMontague
It's the same format as default names, it's white. Just renamed by NBTedit plugin to Farshaker.
not sure how that plugin handles formats. but yeah. it's default format.
I'll pastebin my stuff after work.