Item Lore Stats

Table of Contents

Logo

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

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.

stats

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.

Click Here to support the project on Patreon

Comments

_ForgeUser12510414
- Join Date: 10/27/2013
- Posts: 8
- Member Details
#33 _ForgeUser12510414

View User Profile

Send Message

Posted Nov 5, 2013
Awesome, guy :)

Can you add some powers like 'lightining', 'fireballs', etc?

Rollback Post to Revision RollBack
_ForgeUser12449371
- Join Date: 10/17/2013
- Posts: 12
- Member Details
#32 _ForgeUser12449371

View User Profile

Send Message

Posted Nov 5, 2013
@Supavitax

I mean that maybe it could be done through using potions effects? Haste would increase the speed of the arms swinging and mining fatigue would decrease the speed.

Rollback Post to Revision RollBack
Supavitax
- Join Date: 1/28/2012
- Posts: 752
- Member Details
#31 Supavitax

View User Profile

Send Message

Posted Nov 5, 2013
@SecrecyT

I'll try and put something together.

@PanteLegacy

I'll have a look at this but I don't think the weapon speed can me changed by the server without doing it the same way a similar plugin does it by adding an internal cooldown to every weapon and then bringing it back to the base cap with stats. I can have a look into adding that though.

@C0nd3mn3d

Yes I'll add something in the next update.

Rollback Post to Revision RollBack
_ForgeUser12558136
- Join Date: 11/4/2013
- Posts: 8
- Member Details
#30 _ForgeUser12558136

View User Profile

Send Message

Posted Nov 4, 2013
Was wondering if you'd like me to make a Tutorial video for this, just PM me if so. Thanks!

Rollback Post to Revision RollBack
_ForgeUser12449371
- Join Date: 10/17/2013
- Posts: 12
- Member Details
#29 _ForgeUser12449371

View User Profile

Send Message

Posted Nov 4, 2013
would it be possible to add a stat for modifying the attack speed of the person wielding a certain item?

Rollback Post to Revision RollBack
_ForgeUser5915129
- Join Date: 10/26/2010
- Posts: 156
- Member Details
#28 _ForgeUser5915129

View User Profile

Send Message

Posted Nov 4, 2013
Would it be possible to add a 'pvpDamageMultiplier' that can be applied to individual weapons, so that more advanced weapons are less effective in PVP?

Rollback Post to Revision RollBack
Supavitax
- Join Date: 1/28/2012
- Posts: 752
- Member Details
#27 Supavitax

View User Profile

Send Message

Posted Nov 4, 2013
@DoubleRainbro

Thanks, I'll have a look into that and see if there is anything wrong on my side. I could do that but its more efficient in my opinion to just do it on the InventoryCloseEvent because if they dragged an item then they would eventually close their inventory and on the PickupEvent they would more than likely go into their inventory to check the stats of the item which would then require them to close the inventory again.

@xppoint

If I understand you correctly then no I don't think that's possible.

Rollback Post to Revision RollBack
_ForgeUser8088805
- Join Date: 12/16/2011
- Posts: 3
- Member Details
#26 _ForgeUser8088805

View User Profile

Send Message

Posted Nov 4, 2013
@Supavitax

Awesome! Loving these new features. I haven't been able to deal damage to any monsters or animals, though. My .jar is 1.6.4-R2.0 and I downloaded v0.76 of Item Lore Stats as the only plugin, but it still isn't working. Seems like I'm the only one with this problem, though :/

Maybe you could have it update whenever a player uses the InventoryPickupItemEvent and InventoryDragEvent. Using the pickup event to check all new items, and if it's not an armor item then it adds the stats to your player. And if it is an armor item it waits until the drag event?

I don't know haha, I don't know any programming. I just looked up event listeners.

Rollback Post to Revision RollBack
_ForgeUser11726318
- Join Date: 6/24/2013
- Posts: 11
- Member Details
#25 _ForgeUser11726318

View User Profile

Send Message

Posted Nov 4, 2013
I mean how to do so without changing the id to put up additional texture to the weapon as if it would have been like an iron sword but with different textures, or change the id is it possible to do?

Rollback Post to Revision RollBack
Supavitax
- Join Date: 1/28/2012
- Posts: 752
- Member Details
#24 Supavitax

View User Profile

Send Message

Posted Nov 4, 2013
@Rotebay

I'll add that in the next update.

@xppoint

I'm not sure what you mean.

Rollback Post to Revision RollBack
_ForgeUser8233608
- Join Date: 1/10/2012
- Posts: 92
- Member Details
#23 _ForgeUser8233608

View User Profile

Send Message

Posted Nov 4, 2013
I mean like normal minecraft experience bar as a source of lvl restrictions :) So as you lvl up you can use better and better items.

I would love it if you can do it :)

Rollback Post to Revision RollBack
_ForgeUser11726318
- Join Date: 6/24/2013
- Posts: 11
- Member Details
#22 _ForgeUser11726318

View User Profile

Send Message

Posted Nov 3, 2013
how to add sub texture to the object without changing the previous?

Rollback Post to Revision RollBack
Supavitax
- Join Date: 1/28/2012
- Posts: 752
- Member Details
#21 Supavitax

View User Profile

Send Message

Posted Nov 3, 2013
@DoubleRainbro

I've fixed that bug with the colour but I'm still looking into the stat clearing. The problem with it is that I'm trying to do it efficiently without impacting the server by constantly checking but rather updating when needed such as someone getting a new piece of gear where the player would open their inventory, so I can perform the stat updates through that event.

I've added more support for the tooltips so that the plugin can work along side others. The "tooltipStatColor" has changed to "tooltipFormatting". The colour has to be before the formatting style like Purple Italic or Green Bold.

Your config will need to be deleted before updating to correctly update the config with any changes I've made.

@AlexSmith49

Thanks for the suggestion. I have added that in the config so the names can be customised like so;

statNames:
..armour: Armour
..critChance: Crit Chance
..damage: Power
..health: HP
..healthregen: Regen
..lifesteal: Leech Life
..movementspeed: Speed

Your config will need to be deleted before updating to correctly update the config with any changes I've made.

@Rotebay

Where would the level come from? Would it use the level from the Experience bar? I have made RPG plugins in the past to create a levelling experience but all of those used separate player data files to store the level.

As this plugin wasn't designed to be a full RPG plugin then I doubt I will be adding the feature for separate player data files but if you would just like it to be restricted by the Experience level then I can add that in the next update.

@iSiiLeX

Thanks that's been added with the possibility of being able to customise the names of the stats.

Last edited by Supavitax: Nov 3, 2013

Rollback Post to Revision RollBack
_ForgeUser8088805
- Join Date: 12/16/2011
- Posts: 3
- Member Details
#20 _ForgeUser8088805

View User Profile

Send Message

Posted Nov 2, 2013
It is possible to add lore to PhatLoots' drops. But it shows up as italic, Dark_Purple text. You can't change the formatting through PhatLoots and it's lore doesn't support color codes as far as I can tell.

And if I try to change the color on the Item Lore Stats config to anything but Green then I'm not able to deal any damage (until it's changed back to Green), so I can't test out if changing the color to match PhatLoots' works.

And if I clear my inventory while wearing stat-boosting armor, then the bonuses stay on until I open my inventory. Not a big deal, but thought I'd point it out.

Awesome plugin, by the way :)

Rollback Post to Revision RollBack
_ForgeUser7661268
- Join Date: 10/6/2011
- Posts: 81
- Member Details
#19 _ForgeUser7661268

View User Profile

Send Message

Posted Nov 2, 2013
Random lore is possible with a plugin called Skript. Look up "skript diablo drops bukkit" and you will find the script you put within the plugin (you'll understand once you scan the documentation.) Edit this script and you will have random drops voila! Also, Supa, I suggest customizable attributes (name-wise) as in changing Health Regen to Regen and still allowing it to work.

Rollback Post to Revision RollBack
Supavitax
- Join Date: 1/28/2012
- Posts: 752
- Member Details
#18 Supavitax

View User Profile

Send Message

Posted Nov 2, 2013
@Rotebay

I'll have a look into adding that feature in an upcoming build.

Rollback Post to Revision RollBack
_ForgeUser8233608
- Join Date: 1/10/2012
- Posts: 92
- Member Details
#17 _ForgeUser8233608

View User Profile

Send Message

Posted Nov 2, 2013
Add level restrictions and i'm in :) Now i'll stay to LoreAttributes.

Rollback Post to Revision RollBack
_ForgeUser8855380
- Join Date: 5/6/2012
- Posts: 44
- Member Details
#16 _ForgeUser8855380

View User Profile

Send Message

Posted Nov 2, 2013
Could you add an language support? Would be awesome ^.

Rollback Post to Revision RollBack
Supavitax
- Join Date: 1/28/2012
- Posts: 752
- Member Details
#15 Supavitax

View User Profile

Send Message

Posted Nov 1, 2013
Just uploaded v0.55 that fixes the bug with the npc damage and added a new feature to multiply the default damage of npcs so that they're not incredibly weak after the player gets better stats. Also added a new stat called Movement Speed to increase the wearer/wielders movement speed.

@iSiiLeX

Not at the moment and its unlikely that I will get around to it.

Rollback Post to Revision RollBack
_ForgeUser8855380
- Join Date: 5/6/2012
- Posts: 44
- Member Details
#14 _ForgeUser8855380

View User Profile

Send Message

Posted Nov 1, 2013
@Supavitax

Is this plugin compatible with Heroes? Like Damage and Health. And maybe the support of Mana reg.

Would be another cool feature ^.

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

67983
Created

Oct 26, 2013
Last Released File

Nov 15, 2017
Total Downloads

138,401

Bukkit

Item Lore Stats

Bukkit Plugins

Item Lore Stats

Table of Contents

Description

Installation and configuration

Commands

Stats

Config

Permissions

Recommended plugins

Have a suggestion or need to report a bug?

Tutorials

Changelog

Metrics

Auto-checking for updates

Donate

Patreon

Comments

About This Project

Categories

Members

Recent Files

Bukkit