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.

This has only been tested on v1.6.4, v1.7.2 and v1.7.9 (May work on other versions but those are untested).


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. It is currently v4.82 and was designed for Minecraft V1.6.4, V1.7.2 and V1.7.9. Item Lore Stats offers random and unique loot tables for all of the default mobs and custom mobs.

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.


  • /ils - Will show a list of available commands.
  • /ils version - Will show the version of Item Lore Stats that's running.
  • /ils stats - Will display the total stats of of your armour and item in your hand.
  • /ils createlore - Creates a set of gear with lore to test the plugin.
  • /ils reload - Reloads the config.yml.
  • /ils repair - Repairs the item in hand (Requires op or ils.admin).
  • /ils sell - This will sell the item in your hand for the price listed in the tooltip of the item.
  • /ils name <text> - Sets the name of the item currently in your 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.
  • /ils lore <player_name> <line#> <text> - Adds or sets the lore line to the item currently in the players hand. If you don't include a <player_name> it will apply it to your own item in your hand. <player_name> must be online.
  • /ils give <player_name> <item_name> - This will generate a weapon 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 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. 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 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.).


Click here for a description of each stat.
The text on the tooltip has to be exactly how they are below, except <VALUE> is the amount/name you wish to add. The text can contain any colour.The lore it can read as stats are;

Armour: + or -<VALUE>%
Dodge: + or -<VALUE>%
Block: + or -<VALUE>%
Crit Chance: + or -<VALUE>%
Crit Damage: + or -<VALUE>%
Health: +<VALUE>
Health Regen: + or -<VALUE>%
Life Steal: + or -<VALUE>%
Ignition: + or -<VALUE>%
Reflect: + or -<VALUE>%
Slow: + or -<VALUE>%
Poison: + or -<VALUE>%
Wither: + or -<VALUE>%
Harming: + or -<VALUE>%
Blind: + or -<VALUE>%
Speed: + or -<VALUE>%
XP Bonus: + or -<VALUE>%
PvE Dmg Modifier: + or -<VALUE>
PvP Dmg Modifier: + or -<VALUE>
Level: <VALUE>
Class: <VALUE> (Requires permission ils.use.<VALUE>)
Bound to <VALUE>
Weapon Speed: <Very Slow, Slow, Normal, Fast, Very Fast>
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.


Click here for help with the config.yml


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

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 remove the "+X attack damage" from swords.

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.


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


Click here for the full Changelog


As of v1.759 this plugin sends statistics about the usage to the server 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.


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.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of DrakeSnodgrass DrakeSnodgrass Dec 21, 2014 at 19:18 UTC - 0 likes

    im having this issue if anyone can help me

  • Avatar of Demonrammstein Demonrammstein Dec 20, 2014 at 05:54 UTC - 1 like

    I have this error! Help please! INFO ... 20 more 20.12 00:52:59 [Server] INFO at$1.execute( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at java.lang.reflect.Method.invoke(Unknown Source) [?:1.7.0_51] 20.12 00:52:59 [Server] INFO at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) [?:1.7.0_51] 20.12 00:52:59 [Server] INFO at sun.reflect.GeneratedMethodAccessor246.invoke(Unknown Source) [?:?] 20.12 00:52:59 [Server] INFO at com.github.supavitax.itemlorestats.Damage.DamageSystem.onEntityDamage( [?:?] 20.12 00:52:59 [Server] INFO Caused by: java.lang.ClassCastException: org.bukkit.craftbukkit.v1_7_R3.projectiles.CraftBlockProjectileSource cannot be cast to org.bukkit.entity.Entity 20.12 00:52:59 [Server] INFO at [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.MinecraftServer.u( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.DedicatedServer.v( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.MinecraftServer.v( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.WorldServer.tickEntities( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.World.tickEntities( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.World.playerJoinedWorld( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.World.entityJoinedWorld( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.EntityProjectile.h( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.EntityEgg.a( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.EntityAnimal.damageEntity(SourceFile:145) [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at net.minecraft.server.v1_7_R3.EntityLiving.damageEntity( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at org.bukkit.craftbukkit.v1_7_R3.event.CraftEventFactory.handleEntityDamageEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at org.bukkit.craftbukkit.v1_7_R3.event.CraftEventFactory.callEntityDamageEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at org.bukkit.craftbukkit.v1_7_R3.event.CraftEventFactory.callEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at org.bukkit.plugin.SimplePluginManager.callEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at org.bukkit.plugin.SimplePluginManager.fireEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at org.bukkit.plugin.TimedRegisteredListener.callEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at org.bukkit.plugin.RegisteredListener.callEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO at$1.execute( [spigot.jar:git-Spigot-1456] 20.12 00:52:59 [Server] INFO org.bukkit.event.EventException 20.12 00:52:59 [Server] ERROR Could not pass event EntityDamageByEntityEvent to ItemLoreStats v4.82 20.12 00:52:56 [Server] INFO ... 20 more 20.12 00:52:56 [Server] INFO at$1.execute( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at java.lang.reflect.Method.invoke(Unknown Source) [?:1.7.0_51] 20.12 00:52:56 [Server] INFO at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) [?:1.7.0_51] 20.12 00:52:56 [Server] INFO at sun.reflect.GeneratedMethodAccessor246.invoke(Unknown Source) [?:?] 20.12 00:52:56 [Server] INFO at com.github.supavitax.itemlorestats.Damage.DamageSystem.onEntityDamage( [?:?] 20.12 00:52:56 [Server] INFO Caused by: java.lang.ClassCastException: org.bukkit.craftbukkit.v1_7_R3.projectiles.CraftBlockProjectileSource cannot be cast to org.bukkit.entity.Entity 20.12 00:52:56 [Server] INFO at [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.MinecraftServer.u( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.DedicatedServer.v( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.MinecraftServer.v( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.WorldServer.tickEntities( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.World.tickEntities( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.World.playerJoinedWorld( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.World.entityJoinedWorld( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.EntityProjectile.h( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.EntityEgg.a( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.EntityAnimal.damageEntity(SourceFile:145) [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at net.minecraft.server.v1_7_R3.EntityLiving.damageEntity( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at org.bukkit.craftbukkit.v1_7_R3.event.CraftEventFactory.handleEntityDamageEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at org.bukkit.craftbukkit.v1_7_R3.event.CraftEventFactory.callEntityDamageEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at org.bukkit.craftbukkit.v1_7_R3.event.CraftEventFactory.callEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at org.bukkit.plugin.SimplePluginManager.callEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at org.bukkit.plugin.SimplePluginManager.fireEvent( [spigot.jar:git-Spigot-1456] 20.12 00:52:56 [Server] INFO at org.bukkit.plugin.TimedRegisteredListener.callEvent( [spigot.jar:git-Spigot-1456]

  • Avatar of lilblue22 lilblue22 Dec 19, 2014 at 17:24 UTC - 0 likes

    @krapcher: Go

    Ok I will try that and just to clarify I deleted all the weapons made using the plugin then deleted world/players and essentials/userdata not sure if there is anything else i can delete but it's just not working for pvp for the 3 people who used the itemlorestats custom weaponry.

  • Avatar of TheMinecrafter606 TheMinecrafter606 Dec 18, 2014 at 20:29 UTC - 0 likes

    Ok, so I've been coming up with a few stats I think you'll like, tell me what you think of them.

    so here's the first idea for a new stat. It would be called a 'combo.' It would work like an alternative to the damage stat. Here an example on how it would look.

    Combo: +1 +2 +3

    The numbers can be changed, of course. It would work like this: The first time you hit with the weapon, it would do 1 damage, the second time, 2 damage, and the third time would do 3. After that the damage would reset and start back from the beginning. This would be the stat I would most like to see, it would be incredibly useful.

    Another idea is a stat that's similar to the PvE Damage and the PvP Damage stats. It would be a bonus damage stat for different mobs, example.

    Skeleton Damage: +10

    It would do 10 more damage to a skeleton on top of the damage the weapon would already do.

    I would prefer the Combo more than the skeleton one tho, tell me what you think.

  • Avatar of krapcher krapcher Dec 18, 2014 at 19:22 UTC - 0 likes

    @SmilingTrickster: Go

    Are you using heroes plugin ?

  • Avatar of SmilingTrickster SmilingTrickster Dec 17, 2014 at 22:14 UTC - 1 like

    I found this spamming the console, and players can only inflict the vanilla damage. Is there a way to solve it?

  • Avatar of Danstryder Danstryder Dec 17, 2014 at 20:44 UTC - 0 likes

    Can you add support for 1.7.10 please?! D:

    Are you a fan of Avatar: The Last Airbender love to play Minecraft?
    Ever wanted to play on Minecraft with Avatar implemented into the game?
    Come to Strydercraft on our Avatar Server!!!

    More information can be found here:

  • Avatar of krapcher krapcher Dec 17, 2014 at 05:00 UTC - 0 likes

    @lilblue22: Go

    So you have installed the plugin, created a custom item a weapon for instance and gave it to someone. Then you uninstalled the plugin and the person holding that custom weapon doesn't get any damage from other players while he can hit others.

    If this is what you meant, I've tested it and I could still get damage. I don't think it is about this plugin anyway but you can try to delete scoreboards.dat in Data folder and try again. Maybe it can solve your problem there are several datas in it might be relevant to your problem. Don't forget to back up the file before deleting.

  • Avatar of lilblue22 lilblue22 Dec 16, 2014 at 21:04 UTC - 0 likes

    @krapcher: Go

    well basically anyone who had access to this plugin and had item lore stuff now can't pvp it's like they are in god mode to eachother but they can pvp other people just not eachother and iremoved the plugin delete player files and it still happens :'(

  • Avatar of krapcher krapcher Dec 16, 2014 at 10:34 UTC - 0 likes

    @lilblue22: Go

    You cannot get any answer with that attidute. Explain the issue further.


Date created
Oct 26, 2013
Last update
Dec 10, 2014
Development stage
All Rights Reserved
Curse link
Item Lore Stats
Recent files