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.
%2526business%253dsupavitax%2540gmail.com%2526bn%253dPP-DonationsBF%253abtn_donateCC_LG.gif%253aNonHosted%2526cancel_return%253dhttp%253a%252f%252fdev.bukkit.org%252fbukkit-plugins%252fitem-lore-stats%252f%2526lc%253dUS%2526item_name%253dItem%2bLore%2bStats%2b(from%2bBukkit.org)%2526cmd%253d_donations%2526rm%253d1%2526no_shipping%253d1%2526currency_code%253dUSD)
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 Owner
-
View User Profile
-
Send Message
Posted Apr 5, 2014@jhicks32917
I'll have to look into it but I've never used it.
ILS actually does use the Bukkit Damage to set the damage, the only way the damage indicators will work correctly to show the exact damage done is if it has an api that allows it.
-
View User Profile
-
Send Message
Posted Apr 4, 2014@Supavitax
Hey Supavitax, you are correct, the bug was being caused by an interaction with another plugin I'm using, SkillAPI Would you mind looking into compatibility issues between the two plugins?
Though, it turns out the damage displaying incorrectly with Damage Indicator Holograms is due to the way Item Lore Stats deals with damage. Below is the response I got when I mentioned to the plugin dev that the damage is showing up incorrectly.
"That means that those plugins aren't handling damage correctly or are throwing their own events. Heroes RPG plugin used to do this but we fall back on Bukkit Damage. Urge your plugin devs to do the same or they will constantly have clashes like this."
-
View User Profile
-
Send Message
Posted Apr 4, 2014@Awesome_Soul
It's the potion of harming effect but lasts 3 seconds.
-
View User Profile
-
Send Message
Posted Apr 4, 2014@Supavitax I have looked around and it isn't ever really clearly stated what the "Harming" effect does. Just that it lasts for 3 seconds, if you could clear that up that would be fantastic.
-
View User Profile
-
Send Message
Posted Apr 3, 2014@Kyren_Leah
Crafted and dropped items used the same boolean to apply durability to items so I've changed this in the next update so each can be toggled, the update should be out in a few days.
@jhicks32917
This definitely isn't caused by another plugin? Unless that plugin has an api that allows me to enter a value it won't work correctly, even with my update that's coming out in a few days.
-
View User Profile
-
Send Message
Posted Apr 2, 2014Good morning!
We're currently working on outfitting all the standard items from minecraft with lore stats, everything works smoothly except crafting - I've registered, for example, the recipe for a wooden pickaxe with Craftbook and added a durability of 150. I've removed any color tags for the recipe to avoid any problems too.
However, whenever the recipe is crafted the restulting wooden pickaxe has a different durability, ranging from 100 to 300. I could add the lore stats with the command after the crafting too, but is there a way to avoid this problem?
Thanks already!
-
View User Profile
-
Send Message
Posted Apr 2, 2014Wonderful plugin and thanks for all of your hard work, but I'm having some issues:
1. Regardless of the item in hand, when I attack mobs it seems there's a very high chance for the mobs to be ignited/withered/poisoned. This occurs with any weapon and any block, even if the weapon/block has no custom lore attached.
2. The damage being dealt to the mobs is less than what is displayed. It seems that the damage being displayed is before any resistances, but this could be a bug with the damage display plugin I'm using, Damage Indicator Holograms
-
View User Profile
-
Send Message
Posted Apr 2, 2014@Awesome_Soul:
This should work for you, I use a number of non-weapons types with the durability stat and it seems to work fine.
-
View User Profile
-
Send Message
Posted Apr 2, 2014I have a quick question, I was planning to use a Hoe as a unique type of weapon, but as you know, in vanilla Minecraft a Hoe's durability doesn't go down when you hit a mob or player, only when you til the soil. So I was wondering, if I gave the Hoe a new durability and attack stat via this plug-in, would it's durability go down if it was used to attack players and mobs? (I can't test this myself at the moment)
-
View User Profile
-
Send Message
Posted Apr 2, 2014@Supavitax:
Per the change log, I'm thrilled to see you decided to go the route of removing vanilla armor entirely. I think it really is the best way to implement mitigation on armor. I can't wait for this release!
-
View User Profile
-
Send Message
Posted Apr 2, 2014@DrakeSnodgrass
This is something I've just fixed (change log) including hitting for the damage displayed on the item. I'll try and sort the multiple classes on the tooltips for the next update but I'm hoping to have that out by the end of the week.
@Mre30
I'll try and sort it for the next update.
-
View User Profile
-
Send Message
Posted Apr 2, 2014is it possible to make it where only leather gear will drop for say classes mage and druid or cleric, so like you wont pick up a gold helm thats for a mage?
looks kinda funny when the mages on my server are wearing diamond armor "heavy armor"
-
View User Profile
-
Send Message
Posted Apr 2, 2014@Supavitax
ah i see, but i notice the gear breaks before the ils durability even hits 50% normals
theirs a trick with like f3 or something that allows you to still see the bukkit durability on the item
so i see
ils durability 1750/1750
then at very bottom theres a second one thats like anywhere from 250/250-750/750
-
View User Profile
-
Send Message
Posted Apr 1, 2014Is there a underwater breathing stat?
-
View User Profile
-
Send Message
Posted Mar 29, 2014@Supavitax:
I think that the best option is to remove vanilla mitigation and keep the armour stat. This method allows far more customization in my opinion because users can set whatever armour value they want to any type. You can have leather armor with 60% mitigation or diamond armor with only 10% mitigation if you want. With Armour, Dodge, Reflect, and Block you have multiple ways to customize your items.
Doing it this way is also more straight forward once your documentation is updated. Just let that players know that your mod removes vanilla armour stats from the minecraft armor types but if they want to they can just add the armour value equal to whatever armor type they had before.
Another option might be to add a new section in your config file where the player can add base armor values to armor types if they want or set all the values to 0 to remove vanilla values entirely.
Thanks.
-
View User Profile
-
Send Message
Posted Mar 29, 2014@vaxjo
Yea will do.
@EnchantedBishop
Need to know which other plugins you're using as one may be conflicting with ILS.
-
View User Profile
-
Send Message
Posted Mar 29, 2014Hi,
Can you please add a /ils repairall ? For repair all items in inventory ? Thank you !
-
View User Profile
-
Send Message
Posted Mar 29, 2014I am trying to use the item lore plugin at the moment so i did /ils createlore and got the item. And some of the stats don't work like +health or the health regen.
-
View User Profile
-
Send Message
Posted Mar 29, 2014@Nightphoenix16
Sure, just create a ticket or pm with any suggestions you have.
-
View User Profile
-
Send Message
Posted Mar 29, 2014Hey, I was wondering is we can talk sometime about a few suggestions I have for your plugin. I can be reached via. PM here or on Skype.