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 29, 2014@v0212345678
If there is a plugin that can run commands when a player enters the server for the first time then you can use the /ils give <player_name> <item_name> and then configure the weapon/armour in the configs.
If you use something like BossShop then you can add the lore to the BossShop configs and that will allow you to put ItemLoreStats items in shops.
I'm not sure what you mean by the last question.
-
View User Profile
-
Send Message
Posted Jan 29, 2014Hi! I am a Taiwanese player, I hope you can help me Let me ask how to create objects using the plug-in can be set in the new players to enter the server for the first time given the items? The second question on how to use the plugin to create NPC selling items? I hope the author can answer for me!And why I have installed this plugin, a significant increase in damage when landing?
-
View User Profile
-
Send Message
Posted Jan 29, 2014@tomori_peti
If you add soulbound: true to the items config it will bind it to the first person that picks it up.
You left click the workbench with the materials required to craft the item you are repairing in your inventory.
-
View User Profile
-
Send Message
Posted Jan 29, 2014Are there an option to bound saved item's to that player who first picks them? If there wasn't could you add it in the next release?
How can be items repaired? I tried it in workbench but when i place leather and the item i can't craft anything.
-
View User Profile
-
Send Message
Posted Jan 29, 2014Having a PVP multiplier is fantastic. This adds so much more depth to my RPG server. Fantastic plugin. Thank you for your work!
-
View User Profile
-
Send Message
Posted Jan 29, 2014could we get some API info - I have some GUI ideas ;)
-
View User Profile
-
Send Message
Posted Jan 28, 2014@Supavitax can you please reply to my PM, :) thanks so much
-
View User Profile
-
Send Message
Posted Jan 28, 2014@mobilephone2003
A lot of people wanted the option to colour the stats differently so I did it. You don't have to colour every single stat. You can leave them as the default dark purple.
I have plans to redo all the commands anyway so that will be something I'll make easier.
Yes you do unless you craft the item. The tutorial is missing a lot of things because it wasn't made with the current version of ILS.
-
View User Profile
-
Send Message
Posted Jan 28, 2014I guess it's nice to have complete customisation but having to colour every single stat is very time consuming.
Could there not be a standard to the colouring like in the picture?
Do we have to put the durability in manually? the tutorial is missing a lot of things out
-
View User Profile
-
Send Message
Posted Jan 27, 2014@MedievalMinecrafters
You can set up items with different drop chances to drop from mobs with stats that are randomly generated from specified ranges.
http://dev.bukkit.org/bukkit-plugins/item-lore-stats/pages/saved-mobs-example/
-
View User Profile
-
Send Message
Posted Jan 27, 2014Hi i want to ask a question. This plugin looks fantastic, one of the best i've seen; but how would they be on a mob or something for it to drop? like do you have to actually make the item and physically give it to a player. cuz if so then it wont really work in rpg servers, because most people dont want hand out weapons to their community when it would be more rpg like if they drop on random from mobs. you know what i mean?
Anyways thats just a question please respond soon, i need to know :)
-
View User Profile
-
Send Message
Posted Jan 26, 2014<<reply 1995272>>
There is the asked error log: http://pastebin.com/ULJD1LhL
I also updated my previous post, with a little extra information
-
View User Profile
-
Send Message
Posted Jan 26, 2014@tomori_peti
Could you post the error for /ils export please.
Looks like you have a stat set as "0%" which isn't allowed.
-
View User Profile
-
Send Message
Posted Jan 26, 2014-/ils export can't recognise Fire and Ice attributes (they don't exported) If level is also set the plugin throws an error too.
If i attack another player i get this nice error: :I
Error: http://pastebin.com/bX2MdFeY
Plugins list: ItemLoreStats, GroupManager, WorldEdit, Authme, Essentials, Citizens, Herochat, MyPet, Rloot, SkillAPI, Vault, WorldGuard
Config: http://pastebin.com/NbVaNHZr
*Update: It seems like it's only happens if i use an ILS item without level.
-
View User Profile
-
Send Message
Posted Jan 26, 2014WHy not infinity in stats for bows??
-
View User Profile
-
Send Message
Posted Jan 26, 2014@Supavitax
alright thank you for the info. My personal opinion is that a radius in the point option would be better because iam not using WorldGuard regions. But iam excited to see it :)
-
View User Profile
-
Send Message
Posted Jan 26, 2014@MARODEUR2
There is no max range and no limit to how strong the enemy's become. The health is calculated by (distance(when spawned) x multiplier) + base health = new health, and the damage is distance(when spawned) x multiplier = new damage.
I do plan to make this feature better in the future though. If WorldGuard is installed it will use those regions to multiply the health/damage for the mobs only within that region allowing different zones to have different difficulty of mobs.
-
View User Profile
-
Send Message
Posted Jan 26, 2014@Supavitax
aaah i understand so there is no max range or so at which they get normal? And how strong they get when you go far away from the point? is the Multiplier the base value or the max value? or how does this work?
-
View User Profile
-
Send Message
Posted Jan 26, 2014@MARODEUR2
They don't return back to normal. The further you go the more powerful the enemy is.
-
View User Profile
-
Send Message
Posted Jan 26, 2014Could you explain me how exactly the /ils setmultiplier command works? I want to increase the strength of mobs at a location. So i set the multiplier settings to it. But i dont get in which region they are stronger now. there is just defined a specific point, but no range. And how the multiplier works? when i set health to 2.000 then they have double health?
okey i found it out how the mulitplier works, but whats with the range? I set the point, sure but where they get normal again?