Item Lore Stats

Thanks to BrightDanny for the logo.
Add functioning stats to your items to allow players to increase their player stats. Any gear/weapons that contain the correct lore that the plugin can detect (list below) will affect the wearer/wielder. ItemLoreStats helps you create an epic RPG experience. Will add more stats/options based on requests.
Description
This is the Item Lore Stats plugin you can add to your server to get players farming/trading/looting gear to get the perfect stats for their character. Item Lore Stats offers random and unique loot tables for all of the default mobs and custom mobs. WorldGuard 6+ is required for WorldGuard support. Vault is required for currency support.
I will continue to support this and add many more features. If you have any suggestions please let me know through a ticket.
Installation and configuration
Place the ItemLoreStats.jar into your plugins directory. Then all you need to do is run your server.
Commands
| /ils | Show a list of available commands. |
| /ils version | Show the version of Item Lore Stats that's running. |
| /ils reload | Reload the Item Lore Stats config. |
| /ils stats | Will display the total stats of your armour and item in your hand. |
| /ils createlore | Creates a set of gear with lore to test the plugin. |
| /ils repair | Repair your gear. |
| ils sell | This will sell the item in your main hand for the price listed in the tooltip of the item. |
| /ils name <text> | Sets the name of the item currently in your main hand. Supports all text formatting. |
| /ils setMultiplier |
All of the mobs health and damage will be scaled by their distance from the location that you type this command. The health is calculated using (distance(when spawned) x multiplier) + base health = new health. The damage is calculated using (distance x multiplier) = new damage. Mobs will also receive a level based on the distance they are from the location that the command is entered. By default a mobs level will increase every 10 blocks but this can be changed by using the command below. |
| /ils blocksPerLevel <number> | ILS will increase the mobs level every X blocks from wherever the /ils setMultiplier command was entered. |
| /ils lore <player_name> <line#> <text> | Adds or sets the lore line to the item currently in the players main hand. If you don't include a <player_name> it will apply it to your own item in your main hand. <player_name> must be online. |
| /ils give <player_name> <item_name> | This will generate an item from the specified file name (plugins/ItemLoreStats/SavedItems/<item_name>) and give it to the specified player (more info on the config here). The item can be given to a player with a different name with /ils give <player_name> <item_name>, <new_item_name>. |
| /ils export <item_name> | This will export the item in your main hand to a file (plugins/ItemLoreStats/SavedItems/<item_name>) with the specified name so that it can be imported at a later date (more info on the config here). |
| /ils upgrade hand | This will upgrade the item you're currently holding in your main hand. Item requires Level Lore to upgrade. |
| /ils upgrade armour | This will upgrade the armour you're currently wearing. Items require Level Lore to upgrade. |
| /ils upgrade all | This will upgrade the item you're holding in your main hand and armour you're currently wearing. Items require Level Lore to upgrade. |
| /ils combatlog | This will enable/disable the ILS combat log that is displayed in chat (You hit a Zombie for X damage.). |
Stats
Click here for a description of each stat.
The text on the tooltip has to contain they keyword of the stat.The text can contain any colour.The lore it can read as stats are;
| Damage: +<MIN_VALUE>-<MAX_VALUE> | Damage +12.4-23.9 |
| Armour: + or -<VALUE>% | Armour +3.7% |
| Dodge + or -<VALUE>% | Dodge +8.2% |
| Block + or -<VALUE>% | Block -1.7% |
| Crit Chance: + or -<VALUE>% | Crit Chance +2.8% |
| Crit Damage: + or -<VALUE>% | Crit Damage +31.6% |
| Health: +<VALUE> | Health +67.2 |
| Health Regen: + or -<VALUE>% | Health Regen +5.7% |
| Life Steal: + or -<VALUE>% | Life Steal +13.5% |
| Ignition: + or -<VALUE>% | Ignition +6.3% |
| Reflect: + or -<VALUE>% | Reflect +4.7% |
| Slow: + or -<VALUE>% | Slow +3.8% |
| Poison: + or -<VALUE>% | Poison +8.3% |
| Wither: + or -<VALUE>% | Wither +4.2% |
| Harming: + or -<VALUE>% | Harming +5.1% |
| Blind: + or -<VALUE>% | Blind +2.1% |
| Speed: + or -<VALUE>% | Speed +16.8% |
| XP Bonus: + or -<VALUE>% | XP Bonus +3.7% |
| PvE Dmg Modifier: + or -<VALUE> | PvE Dmg Modifier +34 |
| PvP Dmg Modifier: + or -<VALUE> | PvP Dmg Modifier -27 |
| Level: <VALUE> | Level 4 |
| Class: <VALUE> (Requires permission ils.use.<VALUE>) | Class Mage, Priest,Warlock |
| Bound to <VALUE> | Bound to Supavitax |
| Weapon Speed: <Very Slow, Slow, Normal, Fast, Very Fast> | Weapon Speed: Slow |
| Right-click to cast Living Bomb | |
| Right-click to cast Lightning | |
| Right-click to cast Fireball | |
| Right-click to cast Frostbolt | |
| Right-click to cast Minor Heal | |
| Right-click to cast Major Heal |
The name of the stat can be changed within the config and if it has, then you must change that in the tooltip accordingly.
Config
Click here for help with the config.yml
Permissions
Negate these to restrict ops.
- ils.admin
description: Required for the /ils createlore, /ils name, /ils setMultiplier and /ils lore commands.
default: op - ils.use.<Class_Name>
description: This allows gear to be restricted to specific classes or groups that have the required permission. If an item contains the lore Class: Mage then that player would need the ils.use.Mage permission.
default: op
- ils.commandlist
description: This allows the player to see the ILS command list.
default: op
Recommended plugins
These are some plugins I recommend using with Item Lore Stats;
- BarAPI
This will allow the players health to be displayed visually as the boss bar like shown in the video here.
- AttributeHider
This will hide default attributes such as "+X attack damage" from swords.
- ProtocolLib
Adds extra support to ItemLoreStats. Creating a smoother, more enjoyable experience for the players.
Have a suggestion or need to report a bug?
Please use the ticket system if you have a suggestion or need to report a bug. This helps me find the problems/suggestions much easier and will also contain the required information I would need rather than looking through the comments.
Tutorials
Simple Weapon creation (Made for 1.7 so may be slightly incorrect with newer version of ILS)
Setting the name of an item (more of a guide than a tutorial)
Adding a blank line (more of a guide than a tutorial)
Adding the Damage stat (more of a guide than a tutorial)
Adding the Crit Chance stat (more of a guide than a tutorial)
Adding the Life Steal stat (more of a guide than a tutorial)
Adding the Movement Speed stat (more of a guide than a tutorial)
Adding the Soulbound stat (more of a guide than a tutorial)
Adding the Level stat (more of a guide than a tutorial)
Adding the Spell stat (more of a guide than a tutorial)
Adding Durability (more of a guide than a tutorial)
Thai Tutorial by ShakeStudioMC
Changelog
Click here for the full Changelog
Metrics
As of v1.759 this plugin sends statistics about the usage to the server www.mcstats.org/. You can disable it by setting "opt-out" to true in \plugins\PluginMetrics\config.yml.

Auto-checking for updates
As of v2.18 this plugin will check for updates using Curse's ServerMods API. It always checks the current version with the version on BukkitDev and will notify ops or any players/groups with the ils.admin permission that there is an update available. It will never automatically download an update without the user typing /ils update. All of the updates are downloaded from BukkitDev. These checks can be disabled in the config.yml by setting checkForUpdates to false.
Donate
As people have requested a donation button to help support the development of Item Lore Stats I've decided to add one. Thanks to the current and future donations I really appreciate it.
Patreon
You can now also help support the project and allow me to dedicate more time to keep Item Lore Stats up to date by pledging on Patreon.


-
View User Profile
-
Send Message
Posted Jan 22, 2014@Alexcamostyle
You need to update your Java. User had same issue here.
-
View User Profile
-
Send Message
Posted Jan 21, 2014Help! I need this plugin and it's not installing! Because of an error: java.lang.UnsupportedClassVersionError: com/github/supavitax/itemlorestats/ItemLoreStats : Unsupported major.minor version 51.0 (I'm new to Bukkit forum and I could post the full error if it didn't turn it into one sentence, how do I fix that?)
-
View User Profile
-
Send Message
Posted Jan 21, 2014@Supavitax
Nice that you finally finished it :) Version works fine. It was a pleasure to help you testing, iam looking forward to the next great updates and hopefully mcmmo support and other great features. I said it very often to you, but: great work ;)
-
View User Profile
-
Send Message
Posted Jan 21, 2014ItemLoreStats v1.759 is now available to download. Check out the Change Log.
-
View User Profile
-
Send Message
Posted Jan 21, 2014@kenandthe985
Yea sure. Once the update is available this page may change slightly as I update it for the new features.
-
View User Profile
-
Send Message
Posted Jan 21, 2014When the Update is allow to download,Could I translate your Item Lore Stats to Chinese and share to another Web page? I will Mark authors with your name , Beacuse this Plugins is so good , i want to share to more people,Please ,thanks.
-
View User Profile
-
Send Message
Posted Jan 20, 2014@CR_Raphire
Thanks and yes you can.
@rasnyderiii
After looking at mcmmo I'm just going to add an option to disable the durability features in ILS as it's much easier, but the reason I added the durability stat was because gear could be destroyed with a single hit if the attackers damage was high enough.
-
View User Profile
-
Send Message
Posted Jan 20, 2014Love the update, thank you for your work Supavitax!
Just a question about repairing: Do items with names work aswell? (Say a diamond with the name 'random' or a random lore added? It would be awesome if that were possible.
-
View User Profile
-
Send Message
Posted Jan 20, 2014Thank you very much for your work. another option is to be able to completely disable this feature as for many servers - Mcmmo and Economy are a huge "time and money sink" needed - so having "unbreakable" items would be terrible for us.
Thank you again!
-
View User Profile
-
Send Message
Posted Jan 20, 2014@rasnyderiii
I've not checked mcmmo but if it uses the vanilla durability to repair then yes it would. It can be disabled but items will be unbreakable.
I'll look into the mcmmo events and see if I can sort something out for that.
-
View User Profile
-
Send Message
Posted Jan 20, 2014the new durability system (i have not tested this) renders all "mcmmo repair" and "economy repair" useless - correct?
Is there a way to completely disable this function as the economy and skill to repair items is very important.
-
View User Profile
-
Send Message
Posted Jan 20, 2014When the Update is allow to download,Could I translate your Item Lore Stats to Chinese and share to another Web page? I will Mark authors with your name 我可以翻譯成中文並分享在其他論壇上嗎? Beacuse this Plugins is so good , i want to share to more people,Please ,thanks.
-
View User Profile
-
Send Message
Posted Jan 20, 2014Update is awaiting approval so hopefully it will be available soon. The new version is for both 1.6.4 and 1.7.2. Check out the Change Log here.
The biggest change that will affect game play is the new durability system. Rather than using the vanilla durability it now uses durability as a stat. If the weapon doesn't have any durability then it will be unbreakable. Though any item that is crafted will have some durability applied automatically (can be configured in the config). The only way an item wouldn't have durability is if it has been spawned in and a durability stat hasn't been applied. You can repair these items by holding it in your hand and left clicking a workbench (can be changed in the config). The requirements to repair are the items used to craft the item you are trying to repair. The amount of durability that is repaired is in the config (can be changed in the config). There are warning messages that will be displayed to the wearer of the item to notify them that the durability is at 75%, 50% and 25% (can be enabled/disabled in the config).
Players can also get bonus health for each level. By default players will earn an extra 6 health (can be changed in the config) for each level. As a lot of people were requesting LevelHealth support, I decided to just add my own.
Unfortunately with this change it also means that any items in-game on that world will be unbreakable until they have the durability stat applied.
-
View User Profile
-
Send Message
Posted Jan 19, 2014Player
-
View User Profile
-
Send Message
Posted Jan 19, 2014Please add SkillAPI suppport :D
-
View User Profile
-
Send Message
Posted Jan 19, 2014@tibbpow
Was the shooter an npc or player?
-
View User Profile
-
Send Message
Posted Jan 19, 2014Another slight weird issue.
With a full drawn bow hit on a player with full diamond armor, it'll do as much damage as if the player wasn't wearing any armor at all.
That's a slight issue for PvP.
Hope it's fixed in the update.
-
View User Profile
-
Send Message
Posted Jan 19, 2014@jjl97
They did originally but I changed it so that items wouldn't be destroyed in 1 hit because of the amount of damage they could do. Since it was causing a lot of problems with other plugins I've changed it back and added durability as a stat.
-
View User Profile
-
Send Message
Posted Jan 19, 2014Hi!
Could you somehow fire entitydamage events in your damagehandler? It would increase the plugins compatibility with any other plugin big time!
-
View User Profile
-
Send Message
Posted Jan 19, 2014@CR_Raphire
That's fixed in the next update.