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.
could really do with a /plugin reload command... to adjust these config values and test better.
also look forward to more ways for players to be able to get the items.. some sort of way for players to get them from mobs, and maybe another way for them to use the plugin to craft or merge stats
some sort of durability stat or base durability for all armor/items that can be use to decrease armor being run down.
@AlexSmith49
I'll add the Ice and Fire stats in the next update. Also the thing with damage ranges that is coming in a future update.
@LordVerlion
I'll add something like that in the next update. So something like "/ils give <player> Warmonger" would generate the item from the Warmonger file and give it to the specified player.
@XeonG8
I will be adding item drops very soon so players can farm mobs for different items with random stats. I'll try and get it added in the next update cause that was going to be the new feature for v1.0, as its quite a big feature.
@Rulerish DakadoHealth, MoreHearts
Also, will we see new stats any time soon? Well here are some of my ideas so I'll just put them out there: Ice, slows down enemies. Fire, fireaspect but looks better in the item lore ;3, In addition, I'm hitting a major issue: I'm constantly being one hit by mobs, then can't respawn.
@AlexSmith49
Such as?
@Supavitax
Well, I just mean having the plugin create a secondary config or something. Specifically that records the Lore name. That way all future items with the lore, would automatically get the stats added to it. I've noticed many plugins do similar checks, but your plugin is the best for adding specific stats. Was hoping to get it combined, so that the plugin checks the secondary config, sees a name "Warmonger", and sets all items with that Lore to the stats specified by "Warmonger"
At the moment, this seems to require the admin to specifically add the Lore on all items that would need it. As no command seems to refer to a player (like /ils lore <person> <line#> <text> or similar). It also only works on item in hand, rather than a specific item, again limiting awarding them out on a constant basis
To explain, secondary config would look like this :
Warmonger:
Armour : <value>
Health : <value> PvP Damage : <value>
Damage : <value> etc.
@LordVerlion
No but I'm sure you would be able to add the item in hand?
@AlexSmith49
Will be in a future update.
@XeonG8
Will be in a future update but I will be adding the feature for items with lore on to drop from mobs.
Is there a specific file that is generated to represent the lore items?
For instance, if I create an item with the Lore tag "Warbringer". That adds to damage and stuff, would all future items equipped with Lore tag "Warbringer" add the same stats automatically?
I would like to combine this with a quest program that I'm setting up for my server. I can award items with Lore already on them, so would want it to autogenerate the stats the Lore tag has been set to generate
@XeonG8
I cant get exactly what you mean about creepers, if their explosion damage is too high - reduce it with changing global monster damage.
What about obtaining items - as been said - any lore-writing plugins are not designed for controlling mobs, drops and other. If you want to proceed you need to build some MMO-like platform based on at least 3 plugins.
@iBogiii You can get a plugin that sets playerhearts then set them to 0
Feature request: Damage ranges instead of a set #
yeh I want to know how to prevent that.. then I can keep the plugin otherwise its a bit op and ruining normal players experience just so a few of us can use the items.
and as there is no built in way for players to attain boosted item stats its a bit pointless as I'm personally not going to be setting up another plugin just to give out these kind of items.
@iBogiii
Option #1: After death their health should be at 20 points again
Option #2: Enable plugin, set it to 20 health, disable.
Whats the panic?
Awesome!.. I just removed this plugin and half of my players now have 50 Hearts .. I tried installing it again and setting the base health to 20 but didnt work .. Awesome.. Now I have to delete all players.dat files and they'll loose everything they have in their inv/enderchests..
@XeonG8
This plugin is designed for MMO-like characteristics like an addition to a something big already, so if you want to control mobs, drops, you need to visit some other plugins.
hmm its nice but needs more ways for players to be able to get the items.. right now creepers blowing up are shredding players god armor with just normal enchants.
@iBogiii
You cannot craft an item with lore (as i can remember). Anyways you can set item for drops from monsters - try to use MythicDrops.
Can you add a way to Craft those stuff ? Never tried your plugin tho. Since RPG Items got abandoned there wasnt a plugin which applies some new effects to items and you are able to craft those items
@XeonG8
At the moment I think it's only the level checking that doesn't work for ops but I'll fix that in an update. That permission is to disable the plugin on the specified world.
Will disable Item Lore Stats for that player/group on the specified world.
ok stats seem to work for normal players.. i see now the perm negating for ops...
but - -ils.disabled.* doesn't seem to work ?
@XeonG8
No, if you set up the tooltips correctly then it will affect your character.
is this purely decorative? because i'm not seeing any actual changes in dmg or movement speed etc when testing this