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 Aug 11, 2014Hello, this is a really good plugin and i need it for my server! But I've an another plugin, this is OtherDrops. I want to have drop with custom lores like "Damage: +2" But this plugin don't like that character ":" (Mapping values are not allowed here...) Is there an option to disable the ":" ? Or other thing? Thanks! :D (Sorry, my english isn't good too)
-
View User Profile
-
Send Message
Posted Aug 11, 2014@VeilyV
What version of craftbukkit are you using? If you want to give me the IP I'll come on.
-
View User Profile
-
Send Message
Posted Aug 11, 2014oh sorry, now its work :) Thank u for your attention
-
View User Profile
-
Send Message
Posted Aug 11, 2014@VeilyV
Do you have any other plugins that change the health?
-
View User Profile
-
Send Message
Posted Aug 11, 2014i think i got some error. When iam type /ils lore 1 &fHealth: +2.0 to my iron helm, when i equipped that iron helm, my health is not increase by 2.0 (or 1 hearth) and i get this error (sorry for my Bad english)
[16:06:27] [Server thread/WARN]: [ItemLoreStats] Task #610 for ItemLoreStats v4.44 generated an exception java.lang.IllegalArgumentException: Health must be between 0 and 50.0 at org.bukkit.craftbukkit.v1_7_R1.entity.CraftLivingEntity.setHealth(CraftLivingEntity.java:81) [craftbukkit.jar:git-Bukkit-1.7.2-R0.3-b3020jnks] at com.github.supavitax.itemlorestats.ItemLoreStats.updateHealth(ItemLoreStats.java:1328) [?:?] at com.github.supavitax.itemlorestats.ItemLoreStats$ItemLoreStatsListener$7.run(ItemLoreStats.java:2127) [?:?] at org.bukkit.craftbukkit.v1_7_R1.scheduler.CraftTask.run(CraftTask.java:53) [craftbukkit.jar:git-Bukkit-1.7.2-R0.3-b3020jnks] at org.bukkit.craftbukkit.v1_7_R1.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:345) [craftbukkit.jar:git-Bukkit-1.7.2-R0.3-b3020jnks] at net.minecraft.server.v1_7_R1.MinecraftServer.u(MinecraftServer.java:587) [craftbukkit.jar:git-Bukkit-1.7.2-R0.3-b3020jnks] at net.minecraft.server.v1_7_R1.DedicatedServer.u(DedicatedServer.java:250) [craftbukkit.jar:git-Bukkit-1.7.2-R0.3-b3020jnks] at net.minecraft.server.v1_7_R1.MinecraftServer.t(MinecraftServer.java:545) [craftbukkit.jar:git-Bukkit-1.7.2-R0.3-b3020jnks] at net.minecraft.server.v1_7_R1.MinecraftServer.run(MinecraftServer.java:457) [craftbukkit.jar:git-Bukkit-1.7.2-R0.3-b3020jnks] at net.minecraft.server.v1_7_R1.ThreadServerApplication.run(SourceFile:617) [craftbukkit.jar:git-Bukkit-1.7.2-R0.3-b3020jnks]
-
View User Profile
-
Send Message
Posted Aug 10, 2014@Datoby92
There will be an option to toggle vanilla damage/armour in the next update which will be uploaded on 16th at the latest.
This is possibly a conflict with another plugin.
For Shops I always used the plugin BossShop, which works really well with ILS as it has a gui for items.
-
View User Profile
-
Send Message
Posted Aug 10, 2014Hello this is great plugin ! Iam thinking about donations but i have fast 3 questions.
Default swords ( non edited ) diamond giving only 1 dmg to mobs and players how let default weapons their default weapon dmg ?
When i make item named example &4Test sword and i use command to save it, in *.yml there is "?4Test sword" and with command /ils give item is without color and with "?" symbol at name
And last question is how to my new weapons and items put into chestshops or let players to buy them ? :)
thnx a lot
-
View User Profile
-
Send Message
Posted Aug 10, 2014@Supavitax
Okay, thanks for the quick response.
-
View User Profile
-
Send Message
Posted Aug 10, 2014@drewch123
Possibly, I have a few things I need to get added first though.
-
View User Profile
-
Send Message
Posted Aug 9, 2014@Supavitax
Hey Supa, are you adding the option to change the repair items in the newest update?
-
View User Profile
-
Send Message
Posted Aug 9, 2014@BenButler77
Speed and Health Regen will be included in the next update.
-
View User Profile
-
Send Message
Posted Aug 9, 2014Hey, you know how you can set how much HP you get on level? Is it possible to make it so you can set other stat gains on leveling, like Speed, Attack, Armor, etc?
-
View User Profile
-
Send Message
Posted Aug 9, 2014@InsomniaCraft
I don't but I usually have dev builds available that I send out for people to test once I believe they're stable enough.
As I'm doing a big change to the code I don't have one yet but the next update will be released on 16th at the latest so I'll definitely have a dev build available before that for you.
-
View User Profile
-
Send Message
Posted Aug 9, 2014Thank you very much Supavitax, do you have a Jenkins or something where I can grab your updates before bukkit approval? They take forever at times lol
-
View User Profile
-
Send Message
Posted Aug 9, 2014@InsomniaCraft
I'll add options in the config so enable/disable vanilla stuff.
@pepper82
You would need to create the item and then export it with /ils export <item_name>, and then you would need run /ils give <player_name> <item_name>.
-
View User Profile
-
Send Message
Posted Aug 9, 2014Agree with Insomnia. This plugin is great and I was about to use it but then found out that it changes the default damage values of weapons in minecraft. Any diamond sword is doing onl 1 damage only and this is very very bad. The plugin should not replace any default weapon attributes but allow us to use the weapons made with this plugin as a special item with cool effects and stuff.
I am not using any other part of this plugin but the command to give a player a pre-defined weapon for ingame money or at events.
I am not using this plugin for mob drops, etc.
Also, I am wondering how I can give a specific player a pre-defined weapon? It seems like I have to bind a weapon already in the item's config file. Is there a way to have any pre-defined weapon given to a user I specify?
-
View User Profile
-
Send Message
Posted Aug 8, 2014I understand that it's difficult to tailor a plugin fitting everyones specific needs but it would be a huge favor to do something about the damage and armor being applied or being changed to default.
Like I mentioned earlier, my drops, drop rates, lore application, etc are handled already and I've put months into making it work, but the attributes or stats part of it is difficult for me and any plugins I've used or shit or broken. This is by far the best one I've found, but the way the application of the lore works, you can't simply use this as an attributes plugin.
By that, I mean that if a person buys a diamond sword from a sign shop or any economy server, the damage lore or the armor lore wont be applied and diamond swords will do 0 damage. Many servers use this method. Additionally, if my mobs are dropping items, weapons and armor with the lore already predefined and calculated by another plugin or method using your attributes, they won't work effectively due to the damage calculation.
What you did with sharpness is great, increasing damage by a percentage at the end. My sollution if you're open to it would be allow vanilla weapon to do their default damage, change the + damage stat to add damage rather than define it.
Diamond sword does 7 damage Damage: +5-6 Would hit as 12-13 in the end. (Armor could work the same way) This provides more compatibility for other plugins. Even if you made it optional in the config.
My only other solution would be to find a way to make all weapons and armor have lore applied to them regardless of their origin, and that I find difficult.
Please, keep me updated, even if the answer is no, It would help to know so I can settle for something else. Thank you.
-
View User Profile
-
Send Message
Posted Aug 8, 2014sry.
-
View User Profile
-
Send Message
Posted Aug 8, 2014@Supavitax
Why not add your own health bar to the mobs? just a suggestion. Also can you add compability to crackshot guns plugin?
-
View User Profile
-
Send Message
Posted Aug 8, 2014The one issue that I'm having is Snowballs doing damage. I currently use the CrackShot weapon plugin, and any weapon that fires snowballs will do no damage, neverless register the hit. I'm assuming that there's something that I'm missing here and that this isn't a glitch... Tere are also no errors in the console.
-Bond