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 Nov 9, 2014@Supavitax
Thanks! If you need any help playtesting or looking for bugs, let me know!
Is there a way to add a custom name to an item in the SavedMobs, besides defining a SavedItem? It would be really cool to have an item drop as "Speedy Rapier of Life Draining" or "Quick Claymore of the Castle" rather than just Sword. (It would also be neat to be able to random apply stats or prefixes to saveditems that drop as well, is there any way to do this?)
-
View User Profile
-
Send Message
Posted Nov 9, 2014@zeshan321
It's probably not even working. I wish one of the devs on this plugin will respond and help.
-
View User Profile
-
Send Message
Posted Nov 9, 2014@iSleepzZz
Yeah, I don't see a difference either.
-
View User Profile
-
Send Message
Posted Nov 9, 2014I tested both weapon speeds "Very Slow" and "Very Fast" both are 100% equal on attack speed. Is this broken and not working or something or am I doing something wrong?
-
View User Profile
-
Send Message
Posted Nov 9, 2014@Luke616
Change log for the next update http://dev.bukkit.org/bukkit-plugins/item-lore-stats/pages/change-log/
@iSleepzZz
The extra 1 damage is from vanilla damage but that change has been reverted so in the next update it will do the 2 damage and not 3.
-
View User Profile
-
Send Message
Posted Nov 8, 2014Any word on how the update is coming along?
-
View User Profile
-
Send Message
Posted Nov 8, 2014Waiting for help please. Question still stands. :)
-
View User Profile
-
Send Message
Posted Nov 7, 2014Hello, I have a lore as "Damage +2" and it constatnly hits 3? I want it to actually hit 2s not 3s. How can I do this? I have the includeDamage set to false also.
-
View User Profile
-
Send Message
Posted Nov 4, 2014@mobilephone2003:
For what its worth, I've been using ILS without issues for over 6 months and I have not experienced any memory leaks or other noticeable performance issues.
I'm not a programmer so I can't speak to the quality of the code but I absolutely think this mod is high quality and can be relied upon for introducing a stat system to your survival server. I have been unable to find anything that works as well or has as many features.
Supavitax has been introducing wanted features by the community, and fixing logged issues with his mod for over a year now and has been one of the more responsive developers on Bukkit and I thank him for his continued support.
-
View User Profile
-
Send Message
Posted Nov 3, 2014Hi, First of all thanks for this plugin I have some problems when i use cauldron-1.7.10-1.1231.01.208-server work this plugins When I re-attack monsters the weapon's Lore will Disappear I was use v 4.67 can you help me? Thanks.
-
View User Profile
-
Send Message
Posted Nov 2, 2014You need another language? :)
-
View User Profile
-
Send Message
Posted Nov 1, 2014@mobilephone2003
I have never refused to accept flaws as no one has ever said that anything was wrong with the code.
What memory leak? I run two servers and both have been active for a year and I've never had any issues with memory leaks.
If you have any issues then let me know or if you think some of the code could be improved then tell me. No one has ever said that the code could be improved and I'm always trying to improve the code and make it more efficient.
So please don't make false accusations.
-
View User Profile
-
Send Message
Posted Oct 31, 2014I think players would appreciate the ability to look up each other's stats
Can the stats command be used to work with this?
Edit: Never mind, this plugin has a memory leak and I've been told the developer refuses to accept he has flaws in his code.
That and most of his answers to tickets say.. "I'll look into it"
Not recommended for a survival server.
-
View User Profile
-
Send Message
Posted Oct 31, 2014Hi, First of all thanks for this amazing plugin and sorry for my poor english. I have a Cauldron server with mods which adds weapons and items. I add it in plugin config file, but i cant remove weapon default damage, for example: Trident normal damage: +7, Custom Trident with lore Damage: +10-12, make damage between 17 and 19 . The vanilla items its possible to remove default damage in config file. My question is if you know some way to remove it in customs??
Thanks so much, and here some suggestions:
-
View User Profile
-
Send Message
Posted Oct 29, 2014There is an update coming soon once it's ready. Just need to sort through a few more of the tickets and it will be ready.
@gucek012
Which version of CB/Spigot are you using?
@Babibab
I don't have much knowledge of SkillAPI so I need to look into it more. I did add some functionality recently which seems to be alright but there were some issues with retrieving the damage set by SkillAPI.
@Whitiy91
If you pm the ip of your server I'll come and and you can give me some gear to test it.
@midlander23
If you pm the ip of your server I'll come and and you can give me some gear to test it.
-
View User Profile
-
Send Message
Posted Oct 25, 2014Hi, i have a little problem, if i wear random item and click any item in my bag, item disappear, can you help me ?
-
View User Profile
-
Send Message
Posted Oct 21, 2014Hey,
Asking again because of my first query may have lost itslef in the bottomless depths of comments: Will this plugin ever be compatible with SkillApi?
Thanks.
Bab
-
View User Profile
-
Send Message
Posted Oct 21, 2014Hello @Supavitax Im using the latest version without heroes plugin, and i find it hard to make the class restriction work.
My example is that i use PEX and have it like this
Warlock_Master:
ils.use.Warlock
I then edited in the confix class list with
List:
- 'Warlock' And it won't work. When i use an item with Class: Warlock on i can wear is but when i hit anything it changes the weapon. If i use someone else's class like Paladin it changes the weapon asap. So it might seem that something is wrong. + In the code you provided. You have 6x spaces in.
Class
List:
6x space - 'Classname' 6x space - 'Classname' but in the confix its only 4?
I really need some feedback cause I'm using your plugin in my server.
-
View User Profile
-
Send Message
Posted Oct 18, 2014@Supavitax
it's not working like this for us in the server, if you open the inventory and place the armour in its place you can perfectlywear it although you don't have the required level. However, if you click it from out of inventory while you hold it, then you can't wear it. Hope that helps you to find out what's going on. Thanks.
-
View User Profile
-
Send Message
Posted Oct 18, 2014@midlander23
If you try to wear/equip a piece of armour that is a higher level than you it will be automatically unequipped and put back into your inventory.