Item Stats
Description
This plugin allows players to add stats and other text to the lore section of items. A large variety of stats are available for players to add to their weapons and items so each one has a little personalization to it. These stats currently range from player kill counters, to specific monsters, or groups of certain creatures. For kill counters, the numbers displayed on the item will increase by 1 for each of the specified creatures a player kills while wielding that item.
Commands
/itemstats [mode]
This command is the only one featured in this plugin. It adds text to an item's lore depending on the mode entered. Valid kill-count modes include the following:
players, monsters, animals, bosses, bats, chickens, cows, mooshrooms, pigs, sheep, squid, ocelots, cats, wolfs, dogs, endermen, zombiepigmen, blazes, creepers, ghasts, silverfish, skeletons, witherskeletons, slimes, magmacubes, spiders, witches, zombies, snowgolems, irongolems, enderdragons, withers, undead, arthropods, hellspawn, nightspawn, cubes, babies, pets, golems
Other modes include:
signature - Signs the players name to the item and prevents adding additional stats (if signatureLock is enabled).
slayer - Records the next mob kill. For example, using this then killing a creeper would add the text "Creeper Slayer" to the item.
bane - Records the next player kill. For example, using this then killing Notch would add the text "Bane of Notch" to the item.
Please note these modes must be entered exactly as they are shown above.
Permissions
Currently disabled due to problems with it. I'll fix this sometime in the future.
Name | Description |
---|---|
itemstats.* | Grants all permissions (even though there is currently only one) |
itemstats.addstat | Add stats to items |
Configuration
Name | Type | Description | Default |
---|---|---|---|
maxStats | Integer | The maximum number of stats that a single item may have. | 3 |
statsOnBlocks | True/False | Enables or disables item stats on blocks. Stats are lost when blocks are placed, so disabling this may prevent some confusion. | True |
requireName | True/False | Enables or disables requiring names to add stats to an item. When enabled, only items that have been renamed on an anvil can have stats added. | False |
standardStyle | Text | Determines the appearance of a stat's text. See the Minecraft Wiki's page on formatting codes for more information. | §e |
slayerStyle | Text | Determines the appearance of the slayer and bane text on an item. | §6 |
signatureLock | True/False | When enabled, prevents adding additional stats to an item that has been signed (via the command's signature mode). | True |
Upcoming Changes
- A "Top Shot" stat for bows that records the greatest distance something that is already being kill counted from has been killed from.
- Non-combat stats, including blocks mined, diamonds mined, and logs chopped.
Why is it even i configured the config to maxstats to 10 i still have 3 maxstats but written maxstats 10?
Stats will continue counting properly even when updated, unless I change the format of the data stored on each item. I think I may change it in the future, but it won't be for quite a while. In the future, I might make add an invisible identifier to each stat to make the plugin more compatible with other plugins that modify item lore (meaning the stats would stay even if you removed the plugin; they just wouldn't increase with kills). The stats are actually just saved as plain text in the item's lore meta data. At the moment, my plugin treats every line of lore on an item as a stat, counting towards the stat limit. Anyway, this change won't be for a while.
I may add a command to remove stats, but I didn't add it initially because I like the stats being a way of adding character or uniqueness. If people can remove them easily, they would be able to remove this character. If I do add it, I'll certainly add a option in the config file to prevent people from using this command on an item unless they were the one that signed it. If you need to remove them right now, you can just use any lore/metadata/NBT editor to remove them.
Another thing, as you update the plugin, will it keep the same stats from the previous version or will stats reset every update?
This is a brilliant plugin! Make sure you keep updating this :) is there anyway of removing stats from an item?
There's no language file, but I could add some values to the config file that lets you set every bit of the text that is visible to players to be whatever you want it to be.
Hope there's a language file! :)
@joshpwnstango
I'll update it shortly. I haven't had much free time until this week, so I wasn't been able to keep it up to date.
hello there quite a few of my players have been begging for a plugin like this.
I'm currently on 1.5.2 and was curious to know if you were planning on updating at all?
@Dysphorick
If you wish to contact me via Skype, just PM me your Skype name and I'll add you. As for plugin development, I do intend to continue developing this plugin, but do not plan to add anything that would actually impact game play in anyway. While compensation for making a plugin like what you have described would be nice, I do not currently have enough free time to take on such a project.
@Lord_Roy
It works like a dream now. I really like this plugin thanks for making it.
I'm uploading a version without permissions. That should fix the problems everyone is having.
How can I make myself able to use it?
when i do /itemstats, it say : you don't have itemstats.addstats
and im Op wich make no sense since operator have every permission by default
im on 1.4.7
@venoxis1108
I have it on my test server (which is on 1.4.7) and it works fine.
will it work with 1.4.7?
@GaseousMaximus
It doesn't exactly change the name, but it does add text to the item's tag that appears when you mouse over it. But yes, it does add combat stats. You could even rename the item with an anvil and have it keep any existing combat related stats you put on it previously! At any rate, I'll put up some screenshots to clear up any confusion.
Nice. If I read this correctly, it changes the name similar to the new anvils and adds combat related stats to the title? Did I get this right?