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 22, 2013@tierdal
Thanks, I've fixed this on the next build which should be ready soon.
-
View User Profile
-
Send Message
Posted Dec 21, 2013alright i gave this plugin a test run and I only have 1 problem with it. multiworld. I disabled usage through permissions, however items still spawn in other worlds. Would it be possible to instead add an option into the config.yml to disable worlds completely, so there are no drops or nothing else in the disabled worlds? i'll await the response, thank you in advance
-
View User Profile
-
Send Message
Posted Dec 21, 2013@Celeress
You can't yet but in the next build you can which should be ready soon.
-
View User Profile
-
Send Message
Posted Dec 21, 2013Can I make mobs drop more than 1 item in the config and also change what mobs drop per world? And can you make 'bosses' drop different items?
-
View User Profile
-
Send Message
Posted Dec 20, 2013@nevasko
"Negate this on each world for ops (e.g. - -ils.disabled.<WORLDNAME>) or the plugin won't work correctly for ops on. "
-
View User Profile
-
Send Message
Posted Dec 19, 2013Yes, can not configure permissions.
done in different ways.
-
View User Profile
-
Send Message
Posted Dec 19, 2013@nevasko
Do you mean the plugin isn't working for ops?
-
View User Profile
-
Send Message
Posted Dec 18, 2013I didn't configure your permission plugin for it not working let me please permission for the player(operator)
-
View User Profile
-
Send Message
Posted Dec 18, 2013@XeonG8
You shouldn't put a plugin on a live server without testing it. The only other way to change the health without saving it to the players .dat file is to reverse the effect when they log off and then re-apply it when they login. Though I didn't think it was necessary to do all those calculations during a player login. I have changed baseHealth to 20 by default in the next update but like I said, you should never download a plugin you're not familiar with and put it on a live server without any testing.
-
View User Profile
-
Send Message
Posted Dec 18, 2013@XeonG8
You obviously do not posses even the slightest understanding of Bukkit, Plugins, or their development. There are quite a few plugins that alter a player.dat's file. If you do not posses the intelligence to use the tools provided to fix the issue, then you have failed as a Server Admin. Especially if you didn't fully test and document the features of this plugin before putting it on a server that actually as a player-base.
Could this plugin handle the health situation better? Yes. Does it require you to post acting like a child? No.
Players who came online with plugin active, will need to be online with the plugin set to default health configs. If you cannot get these players to log on, then what is your big deal? They obviously aren't coming back.
Secondly, I also must wonder about your competence.. A simple google search of "how to edit a player.dat file" brought up quite a few results. (Perhaps this?).
P.S. - If you don't like how health is implemented, try posting a bug ticket or maybe... you know, google a way to fix the problem.
-
View User Profile
-
Send Message
Posted Dec 18, 2013There should really be a warning on the plugin page to visitors that it alter player.dat file under default configuration! No excuse for it, its fking headache when a server admin has no idea what caused it.
The last plugin that did this left crazy potion effects on players, who often disconnected trying to remove the effect, after the plugin was removed they were never able to play properly until there player.dat was wiped. How the fuck that even got approved at bukkit dev is anyones guess but it was malicious and stupid development. If such access to player.dat files are needed they really should include in the plugin a reset state on player dat files to original state on whichever part the plugin had a hand in changing.
So that those plugins can be removed safely without requiring every fking player to come online!
Not saying that this is malicious case here, as it at least provides a way of restoring original health only if the player comes online, but it should be stated that this plugin adjusts players.dat files on health.
Personally I see no reason why the plugin cannot handle that with its own storage system, core dat files should not be messed with really.
-
View User Profile
-
Send Message
Posted Dec 17, 2013@XeonG8
Very easy to keep this plugin running in the background as well. You can change all default config options (environmental damage, mob health, player health, etc.) into the generic MC numbers (20 health for Players, no bonus to mob health, etc.), and then just leave it up.
Using other plugins and server info, I've found that ILS actually uses very small amounts of RAM/CPU to do it's duties. If you disable all additional features and run it in background for a couple weeks, it'll hit every new or old player who joins with updated config.
It's a harder choice, but you can also looking into deleting the player files (located in the "Player" folder inside the "World" folders. As this will delete player inventory, gear, ender chests, and potentially mess up claims, factions, towns, etc, I suggest this as a last resort.
-
View User Profile
-
Send Message
Posted Dec 17, 2013@XeonG8
Then their health won't update. Though that player will have had to have been online when the plugin was active for their health to have changed.
-
View User Profile
-
Send Message
Posted Dec 17, 2013This is necessary if you remove this plugin, or player's health will not update.
What if the player doesn't come online while the new health is set in the config... then what..
-
View User Profile
-
Send Message
Posted Dec 16, 2013Can I make mobs drop more than 1 item and can I change what mobs drop per world?
-
View User Profile
-
Send Message
Posted Dec 16, 2013@XeonG8
Refer to Supavitix's last comment.
By default, Minecraft health is 20 (2 health = 1 heart). This plugin automatically increases that. If you want to go back to default settings, you will need to change the config of this plugin and set the health modifier to 20 (default MC).
This is necessary if you remove this plugin, or player's health will not update.
-
View User Profile
-
Send Message
Posted Dec 14, 2013how to fix players healthbars, on dynmap they show as 20 hearts...
say if I wanted to remove the plugin would those players still have 20hearts?
-
View User Profile
-
Send Message
Posted Dec 10, 2013@QBcrusher
Set baseHealth to 20 in the config and then reload the plugin.
-
View User Profile
-
Send Message
Posted Dec 9, 2013uhhh i removed the plugin and I still have 50 hearts...help plz?!?
-
View User Profile
-
Send Message
Posted Dec 8, 2013Level requirement function has a exception way that let players equip the weapon(or item).