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

Supavitax
- Join Date: 1/28/2012
- Posts: 752
- Member Details
#989 Supavitax

View User Profile

Send Message

Posted Mar 26, 2014
@DrakeSnodgrass

Could you post your config as well please

Rollback Post to Revision RollBack
Kzaqul
- Join Date: 1/9/2013
- Posts: 87
- Member Details
#988 Kzaqul

View User Profile

Send Message

Posted Mar 26, 2014
need help with this error

http://pastebin.com/0Hei2u7J

Rollback Post to Revision RollBack

TeirDal

Join Date: 7/7/2011
Posts: 131
Member Details

#986 Posted Mar 26, 2014

@adw123 @Supavitax

I was thinking more of a global formula / formulas... Something you can let users program into a YML file themselves and then call the formula by the item:

for example: xpformulas.yml

    weapon_level:
        maxLVL: 0 #set 0 to disable
        statMultiplier: 1.15 #15% increase
#kills needed to get to the next level (format: killsNeeded = baseKills*(multiplier^itemLevel))
#above is your basic exponential growth formula, so with base 100 at level 5 it will be ~300
        formula: 100 * (1.25 ^ itemLevel)

then in the drop table zombie.yml

  '15':
    '1':
    itemId: 261
    nameColour: '&f&l'
    prefix: random
    suffix: random
    properties:
      weaponspeed: random
      damage: '&b1-20-player+1-30'
      durability: '&7200-500'
      xpLevel: '&b10-player+10'
      itemLevel: '1-5'
      formula: weapon_level

BUT that is just my opinion. if it sounds too complicated, dont worry about it

Last edited by TeirDal: Mar 26, 2014

_ForgeUser1823883
- Join Date: 12/21/2008
- Posts: 375
- Member Details
#985 _ForgeUser1823883

View User Profile

Send Message

Posted Mar 26, 2014
@Supavitax:

I may still be confused...I understand what you're talking about regarding items leveling up but what I'm looking for is the ability to add stats when a player levels up. So currently you have a setting in your config file:

healthPerLevel: 1 (1 extra health is added per level)

There would be additional fields here

pvedmgmodPerLevel: 1
armourPerLevel: 0.5%
reflectPerLevel: 0.5%
etc...

These would be added whether you're wearing armor or not. Does that make sense? Maybe that is out of the scope of your mod since it's a player oriented and not item oriented change...

Last edited by _ForgeUser1823883: Mar 26, 2014

Rollback Post to Revision RollBack
_ForgeUser1823883
- Join Date: 12/21/2008
- Posts: 375
- Member Details
#984 _ForgeUser1823883

View User Profile

Send Message

Posted Mar 26, 2014
@tierdal:

I agree that being able to level the item as you explained would be preferred to the player level defining the stat increases but this may be more difficult as Supavitax would probably have to design an exp system for each item to store and update values rather than just reference something that already exists.

In my case though, I'm looking for the ability to add innate stats to players when they level up independent of any particular item being equipped. (The same way as health is added automatically when you level up)

That said being able to level up particular items would be a great way to create more options for designing your drop tables so I'm all for that as well.

Thanks.

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

View User Profile

Send Message

Posted Mar 26, 2014
@tierdal

It's much easier for the stats to upgrade when a player levels up as the the formula for the xp on each item would have to be displayed on the tooltip, unless there was a config for every single item that could possibly drop.

@adw123

Yes, when a player levels up it will upgrade the stats on the armour/item in hand that is currently equipped. The stats will upgrade those items only, and will not transfer from one item to another. My intention is that If the items on the server are balanced well, a level 10 item that has been levelled up by 5 levels (now level 15) should be similar or slightly worse than a level 15 item that could drop. I would never want to make it so that a player join the server, find a level 1 sword and keep that for the rest of their play time without ever having to change it. That's another reason why the "cap" that can be enabled will be implemented.

It'd be nice to be able to grant the stat upgrades to any items they equip when they level up but it seems like the plugin would be branching too far from its original purpose so I'm going to leave it so that it's only applied to the armour/item in hand that is currently equipped. Though a separate plugin like that would be fairly easy to make so it may come in time.

Rollback Post to Revision RollBack
TeirDal
- Join Date: 7/7/2011
- Posts: 131
- Member Details
#982 TeirDal

View User Profile

Send Message

Posted Mar 26, 2014
@adw123

I feel like it'd be better if you could "level up the Item" instead it just leveling depending on your character. Like Items would have their own little XP formula where you can specify how long it takes to level up that Item or how many kills to get to increase that items' level... If the items are dependent on the character level up it takes the whole "hard work" out...

Rollback Post to Revision RollBack
_ForgeUser1823883
- Join Date: 12/21/2008
- Posts: 375
- Member Details
#981 _ForgeUser1823883

View User Profile

Send Message

Posted Mar 26, 2014
@Supavitax:

This sounds like a great idea, but will this allow stats to level with a player independent of the item? For instance if my character has no gear at all and levels from 1 to 2 will your configuration still provide the innate stat increases that I specify?

I have my server configured with different tiers of items for levels 1-10, 11-20, etc and my intention is that the player switch out their gear as they level. All items may not have the specific stats that I want to be granted to users when they level up so if this is based only on items it won't completely provide what I'm looking for.

If you can add mana and mana regen as stats that are compatible with heroes that would be great so that I can itemize my drop tables with caster type loots.

Thanks!

Last edited by _ForgeUser1823883: Mar 26, 2014

Rollback Post to Revision RollBack
_ForgeUser1823883
- Join Date: 12/21/2008
- Posts: 375
- Member Details
#980 _ForgeUser1823883

View User Profile

Send Message

Posted Mar 26, 2014
@Blackfire62

You should be able to turn that off by going into the config file and setting the damage done to false under outgoing damage.

Rollback Post to Revision RollBack
_ForgeUser11728583
- Join Date: 6/24/2013
- Posts: 13
- Member Details
#979 _ForgeUser11728583

View User Profile

Send Message

Posted Mar 26, 2014
Nice plugin !

Can you tell me, how to deny this plugin saying "You hit XXX for XXX damage" ?

Thanks

Rollback Post to Revision RollBack
TeirDal
- Join Date: 7/7/2011
- Posts: 131
- Member Details
#978 TeirDal

View User Profile

Send Message

Posted Mar 26, 2014
@Supavitax

:D cant wait great job

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

View User Profile

Send Message

Posted Mar 26, 2014
@tierdal

Yea this is something I want to add, I'll try to add it in the next update or the one after.

@adw123

This has given me a good idea which I'll add to the next update. Basically, each stat (that has a value) can level with the player (if enabled) with slight stat increases. So when the player gains a level it will increase each stat by their configurable value. It will only increase the stats specified in the config so you could have damage level with the player but armour will remain unchanged. As the player levels with the item, the items level requirement will also increase and be visible in the "Level" lore with a [+X] tag, there will also be a "cap" on this in the config to how many levels the item can increase by.

Example:
..Level 10 Player:
....Damage: +22.3-38.2
....Crit Chance: 7.5%
....Crit Damage: 12.8%
....Fire: 4.1%

....Level: 8

..Player increased level by 1:
....Damage: +22.3-38.2
....Crit Chance: 7.9%
....Crit Damage: 13.1%
....Fire: 4.7%

....Level: 9 [+1]

The PvP damage and PvE damage is a little difficult to modify as it's usually set to a specific amount but I'll see if I can come up with something. For the Heroes stats they should be pretty easy to add.

Last edited by Supavitax: Mar 26, 2014

Rollback Post to Revision RollBack
TeirDal
- Join Date: 7/7/2011
- Posts: 131
- Member Details
#976 TeirDal

View User Profile

Send Message

Posted Mar 26, 2014
O i got another good one.. possibly adding Upgrade Slots and Upgrade Gems (diamonds with 1 random stat) that you can apply to an item (maybe perm or config base - for those who want to disable removing gems from said items)

SO to put it short, the gems (lets say diamonds) would be dropped equipped with 1 random Stat (we can configure that Already, so there is nothing to change. Items would be able to have a "random" (from a set range) of "upgrade slots" and of course a "randomapply" as well. If you put the said GEM in your crafting grid with the item with an empty slot, It'd apply that stat to the Item, allowing players to further customize their experience based on their very own preferences.

I don't how you'd go about it... but let me know what your think of this.

Rollback Post to Revision RollBack
_ForgeUser1823883
- Join Date: 12/21/2008
- Posts: 375
- Member Details
#975 _ForgeUser1823883

View User Profile

Send Message

Posted Mar 26, 2014
@ProjectHyrule:

I use ILS in a similar way with the item functionality built into MythicMobs plug in. I don't use any of the command line stuff to create my items, rather I just fill in the lore and have the items drop via killing mobs or purchasing stuff from a vendor...My guess is that it would work similarly with MythicDrops though I haven't used that mod personally.

Last edited by _ForgeUser1823883: Mar 26, 2014

Rollback Post to Revision RollBack
_ForgeUser1823883
- Join Date: 12/21/2008
- Posts: 375
- Member Details
#974 _ForgeUser1823883

View User Profile

Send Message

Posted Mar 26, 2014
@Supavitax:

Do you know if it's possible to add stat increases on level up other than just health when used with the heroes plug in? I'd like to add a couple points of Pve dmg modifier for every level up for instance.

Also, any chance of getting mana or mana regen stats added that would work with Heroes?

Thanks.

Last edited by _ForgeUser1823883: Mar 26, 2014

Rollback Post to Revision RollBack
TeirDal
- Join Date: 7/7/2011
- Posts: 131
- Member Details
#973 TeirDal

View User Profile

Send Message

Posted Mar 25, 2014
Question / suggestion... On crafting weapons or armor in workbench would it be possible for random lore addition? So you could have a chance of creating an item just by crafting it...

Rollback Post to Revision RollBack
_ForgeUser12481552
- Join Date: 10/22/2013
- Posts: 48
- Member Details
#972 _ForgeUser12481552

View User Profile

Send Message

Posted Mar 25, 2014
Is it possible to have this plugin installed, but adding all the actual lore to weapons in MythicDrops (http://dev.bukkit.org/bukkit-plugins/mythicdrops/) and still have the effects applied? This would allow me to sell the weapons from a vendor plugin, add them to drops from custom bosses, give the weapons sockets and what not.

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

View User Profile

Send Message

Posted Mar 25, 2014
@tierdal

It should all work fine as the ID's are hardcoded into ILS so even after the ID's have been removed ID 276 in the mob configs will still translate to a diamond sword for example.

Rollback Post to Revision RollBack
TeirDal
- Join Date: 7/7/2011
- Posts: 131
- Member Details
#970 TeirDal

View User Profile

Send Message

Posted Mar 25, 2014
got somewhat of a technical question... what do you plan on doing with the 1.8 Update getting rid of item id's?

Would it require us going through all of our items and changing everything ourselves or will you encode a converter or something else?

just wondering because that update will break a huge lot of plugins...

Rollback Post to Revision RollBack
_ForgeUser13564778
- Join Date: 2/15/2014
- Posts: 259
- Member Details
#969 _ForgeUser13564778

View User Profile

Send Message

Posted Mar 25, 2014
Suggestion:

Class: Warrior / Barbarian

Class: Warrior + Knight

Multi permissions

Last edited by _ForgeUser13564778: Mar 25, 2014

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

148,593

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