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 Jan 13, 2017Well, this plugin removes the cooldown combat system... needs to be updated :p
Also there is an option to activate health and health regeneration system? i want to use another plugin to manage the health level (not gaining from items.... only for players level up Plugin:LevelMaxHealth)
-
View User Profile
-
Send Message
Posted Jan 11, 2017Ah found a very annoying bug.
ILS Damage is added after the weapon cooldown calculations.
So if I swing with a slow weapon and just spam attack it will deal 0 damage + the ILS damage.
And since I removed the default attack damage on each weapon they always deal the damage in the ILS stat.
This is really annoying, it removes the combat feature with cooldowns and such. A diamond axe is supposed to be a slow weapon and you need to wait till it recharges but now you can just spam it like a diamond hoe (super fast cooldown) and deal the exact same amount of damage.
Sorry if I was confusing, again simple explanation: ILS Damage doesn't work with weapon cooldowns and instead of doing the supposedly 0 damage when a weapon is still charging it will deal the exact damage specified in the lore.
-
View User Profile
-
Send Message
Posted Jan 2, 2017Hi, Fantastic plugin, congratulations.
Could you put an option to change the durability of lore without changing the date of the item?
-
View User Profile
-
Send Message
Posted Jan 2, 2017Your plugins is great,but can you support SpongeMC?
-
View User Profile
-
Send Message
Posted Dec 28, 2016Want to support the Custom item textures, What I mean. https://www.spigotmc.org/wiki/custom-item-models-in-1-9-and-up/
-
View User Profile
-
Send Message
Posted Dec 28, 2016Thanks a lot for updating this plugin. I was struggling to find a decent replacement for it.
Sadly, I'm having two serious problems. I'm running on Spigot 1.11, ILS v7.38.
First, scrolling the hotbar (no items in it) seems to lower my health for half a second or so. I've already disabled updateStatsOnLevel or something, as you suggested to another user with a similar problem.
Second, when I die the chat gets spammed with "<player> died" and then it won't let me click on the Respawn button. Basically, I can't respawn unless I delete my UUID file.
If you need more info (ex. plugin list), please let me know. I really need this plugin.
-
View User Profile
-
Send Message
Posted Dec 26, 2016V6.21
Found a serious problem! By operating the keypad in the item bar 0-9
Can cross grade detection, so wear high-grade equipment!
PaperSpigot1.8.8
-
View User Profile
-
Send Message
Posted Dec 25, 2016EnvironmentalDamag can add a enable or disable option
-
View User Profile
-
Send Message
Posted Dec 26, 2016Set value to 0 and it will revert to vanilla values.
-
View User Profile
-
Send Message
Posted Dec 25, 2016How does the setBonus work? How do i write it on it? And what setBonus effects are there? Is there like particle effect to put on?
-
View User Profile
-
Send Message
Posted Dec 26, 2016SetBonus hasn't been added yet.
-
View User Profile
-
Send Message
Posted Dec 23, 2016EnvironmentalDamage can not open or close a option
-
View User Profile
-
Send Message
Posted Dec 25, 2016Not sure what you mean
-
View User Profile
-
Send Message
Posted Dec 25, 2016EnvironmentalDamag can add a enable or disable option
-
View User Profile
-
Send Message
Posted Dec 22, 2016I have a question how do you get lore exp?
-
View User Profile
-
Send Message
Posted Dec 25, 2016It works off vanilla xp
-
View User Profile
-
Send Message
Posted Dec 20, 2016Still very interested in having this work with Heroes properly. I've had numerous users ask for support for ILS and other than showing you our javadocs / aPI i'm unsure how I can assist in making that happen.
@Supavitax
-
View User Profile
-
Send Message
Posted Dec 18, 2016I've been testing for a few days now on 1.11 with the latest build of ILS and I only found a few small issues:
- Lingering potions of damage (and the dragon breath) still don't deal damage. (I know it has to do with ILS because when I disable the plugin these are working fine and deal damage)
- I tested with several tools on how the damage works when in the config: includeDamage: false
So I gave myself several tools and put one lore line on all the items which was: Damage: 3-3
Then I logged the damage done when I hit a pig and these are the results:
All Hoes do 1 more damage than specified
Iron Pickaxe does 2 more damage than specified
Stone Axe does .. 17 more damage than specified (it does 20 when Damage: 3-3 on the item)
This is when the weapons are "fully charged".
Then the Hoes seem to be fine when not fully charged but the Iron Pickaxe and the Stone Axe deal -3, -3, -5, 0 damage when not fully charged.
I think the damage problems are some mistake in the formulas? Not sure.
Actually those are the only two big issues.
The item damage is the biggest issue for me because I need all of these tools to do 0 or 1 damage by default and when it has Damage: 3-3 in the lore then it should do exactly 3 damage (using the config option to disable defaultdamage).
-
View User Profile
-
Send Message
Posted Dec 19, 2016I've just added the Lingering of Harming potions and I've changed some of the base values for the items which should now be correct.
Still got to add add Dragon Breath but it should be ready after that.
-
View User Profile
-
Send Message
Posted Dec 20, 2016Thanks the Lingering potions now deal damage.
The damage on the weapons seem good aswell now.
The only thing that isn't working now is the option in the config to disable the Vanilla: includeDamage.
I tried putting it on false and on true but everything still deals damage equal to their base value + the ils Damage stat (and in creative you don't only deal 1 damage anymore if that helps fixing this?)
And the dragonbreath but that's not super important, it's easy to make a workaround and let the dragon shoot potions of harming instead ^^
Btw did you add an option in the config that has something to do with offhand? I couldn't find that (I did make sure I had the latest config version).