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 Dec 7, 2013Thanks for adding new functions.
-
View User Profile
-
Send Message
Posted Dec 7, 2013I think i found a bug with the v1.2 build:
I have a ton of extra health from the SkillAPI plugin and the test items from /ils createlore in my inventory. http://i.imgur.com/oMsNKHq.png
I type /suicide and i die but instantly respawn. Some of the items i dropped are still on the ground, I picked up the rest and the extra hearts i had are gone. http://i.imgur.com/XgO18e2.png
If this helps at all here is my config which is basically what was created for me with the v1.2 build. I only changed the health stuff and environmental damage which is exactly how i had it in the previous version without any issues: http://pastebin.com/EjvQG7VS
EDIT: Was just messing around a bit more so i spawned 10 zombies then typed /ils createlore then instantly died (Not sure if it had anything to do with typing the command) and instantly respawned. I killed the zombies then logged out and logged back in. When I logged back in i instantly died and had to click respawn but it respawned me in the same spot i was in. Then i typed /suicide, died, then instantly respawned but was stuck in the death animation thing where your character is red and sideways. http://i.imgur.com/hWTubFU.png
-
View User Profile
-
Send Message
Posted Dec 7, 2013@bobtit
I'm also using that plugin with this. I just disabled base health for ILS (set "basehealth" to 0 in config) and all the health things worked fine, like gaining health from leveling up your class etc.
-
View User Profile
-
Send Message
Posted Dec 7, 2013thenk you
-
View User Profile
-
Send Message
Posted Dec 7, 2013@bobtit
Never tried that plugin but ILS reads the tooltip text, so if it is the same then there shouldn't be any problems.
@nevasko
Ops need this permission negating or the plugin won't work for them.
-
View User Profile
-
Send Message
Posted Dec 7, 2013Will this work with http://dev.bukkit.org/bukkit-plugins/skillapi/ Like will the health of the person increase when they are wearing the gear ( and if their base health has already changed due to their level)?
-
View User Profile
-
Send Message
Posted Dec 7, 2013Do not quite understand Is this permission does not prohibit action item?
-
View User Profile
-
Send Message
Posted Dec 7, 2013@nevasko
If you are an Op you will need - -ils.disabled.<WORLDNAME> permission for each world. That was something added in v0.943 so that's why it isn't working for you after v0.9.
-
View User Profile
-
Send Message
Posted Dec 7, 2013version 1.6.4 core mcpc + lore displayed, but does not give performance (no more than text)
(google translater)
-
View User Profile
-
Send Message
Posted Dec 7, 2013@nevasko
With the small amount of info you have provided there's not much more I can do.
-
View User Profile
-
Send Message
Posted Dec 7, 2013console clean as a baby's bottom
-
View User Profile
-
Send Message
Posted Dec 7, 2013Just uploaded v1.2 view the changes here.
If you want to test the build before it's approved just PM me.
-
View User Profile
-
Send Message
Posted Dec 7, 2013Anyone still having problems with the plugin not functioning correctly for Ops you need to negate a permission, so give each op - -ils.disabled.<WORLDNAME> for each world and the plugin will work as intended for Ops.
@nevasko
Any errors in console? I need more info than that.
@MikesJam
Any stat can be added to an item but I'm probably going to simplify it a bit more
@Celeress
I'll possibly add something like that in a future update.
-
View User Profile
-
Send Message
Posted Dec 6, 2013@nevasko
What version of Java are you using? It only works with Java7, but not Java6.
@MikesJam
I'm actually writing up a tutorial for him to help with that. While it's all perfectly explained, it's a bit of a tricky process.
You won't see any physical stat changes (such as more hearts), but it should still appear on the weapons. From what I understand of this plugin, is that it sends all checks when a player receives or deals damage. For instance, your sword really only deals as much damage as a sword is suppose to deal, but when it hits a mob, the plugin takes over and adds the damage from lore.
Also, in order for lore to work, you need to use proper formatting. In default config, it has an option "tooltipFormatting:". Which defaults to "GreenItalic". In order for lore to work, it needs to have GreenItalic formatting. Meaning you have to type &a&o (&a = green, &o = italic).
So to increase damage, you need to type /ils lore <line> &a&oDamage: +<number>
It's very exact and precise. If you mess up a single letter or symbol, it won't work. All symbols in the text are REQUIRED, with the exception of the <>'s
-
View User Profile
-
Send Message
Posted Dec 6, 2013can not I use after plugin version 0.94
-
View User Profile
-
Send Message
Posted Dec 6, 2013I'm not sure if this has been addressed yet, but could I make a suggestion for the next release? It'd be much appreciated if the instructions were clearer on how to modify the stats of a weapon through /ils lore. I find that despite following the instructions perfectly, I see no stat changes (unless if it's because I'm trying to add movement speed to a sword :p).
Thanks in advance, and keep up the good work! I can't wait to see what you'll do with this plugin over time :)
-
View User Profile
-
Send Message
Posted Dec 6, 2013@Celeress
yeah, level requirement or the permission requirement(for some special weapons or items). I would like to use permission requirement for cunstom level plugin , it will be perfect !!
-
View User Profile
-
Send Message
Posted Dec 6, 2013Just a suggestion: Maybe add support for plugins with progressive classes (Like SkillAPI or Heroes) so some of the items have a "level requirement" that needs to be met before you could equip it?
-
View User Profile
-
Send Message
Posted Dec 6, 2013Hopefully have another update out tonight, if you want to test and report any bugs on the build I upload before it's available here please PM me.
-
View User Profile
-
Send Message
Posted Dec 6, 2013@Supavitax I finally found the bug !!