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 Feb 21, 2014um......I have a novel suggestion for your plugin developing. first, please see this image: http://upload.lsforum.net/users/public/m29787imaged91.bmp or http://upload.lsforum.net/users/public/a16545imageg91.bmp You will get some attributes When you put some configurable items in here.(Accessories?)Thats may be a different change . Its a Extra Equipment! @DillaWolf When you are Configured : baseHealth: 0. The stats of Health is not work? bug?
-
View User Profile
-
Send Message
Posted Feb 20, 2014@iSiiLeX ah......That's a Normal things but you want authors add some new stats(Range damage/Melee damage)?
-
View User Profile
-
Send Message
Posted Feb 20, 2014Can this plugin be used with Essentials kits? Help! If so how?
-
View User Profile
-
Send Message
Posted Feb 20, 2014@Supavitax
Bug found:
Shooting and also hiting with a bow deal the same damage. Please fix =)
-
View User Profile
-
Send Message
Posted Feb 20, 2014@Supavitax @LordKainzo
An alternative could be say, throwing events on HealthAdjustmentEvent or something to when the health is changed and have an event.getBaseHealth() and event.setBaseHealth(double) to which compatibility between other plugins doesn't have to directly be written into this plugin, simply writing a compatibility plugin between both plugins can be written, which I'm willing to do (seeing as I maintain Heroes ;)).
Likewise, if I've decompiled correctly, it would be less hard coding on ILS with compatibility and more API for people wanting to get this working with their plugins modifying the max health.
Alternatively, you could just write in the Heroes.getInstance().getClassManager().getBaseMaxHealth(), Heroes.getInstance().getClassManager().getMaxHealthPerLevel(), and using some math for the Hero being used with hero.getLevel() which returns the level of their current HeroClass. at any time, hero.resolveMaxHealth() will tell Heroes to recalculate the max health given all internal adjustments (including those found on our private branch running on our server), and return the double MaxHealth that Heroes thinks this player's maxHealth should be.
-
View User Profile
-
Send Message
Posted Feb 20, 2014@Supavitax
I understand that there's a lot of ways to handle things.
Hero#getHeroClass()#getMaxHealth() - is close to what we'd need to find the max/health of the player.
More can be find in the javadocs (http://hc.to/javadocs)
Either way, wonderful plugin, really like what you've done!
-
View User Profile
-
Send Message
Posted Feb 20, 2014@LordKainzo
I do use the vanilla system but ILS needs to know a "base" health to work from and that's where the problem rises when trying to use ILS with other plugins that alter the health.
If you unequip the gear, the max health should go down because you would no longer have that gear equipped. Without me specifically requiring a "base" health, ILS doesn't really know what health you had before without the gear equipped. Like I said, I tried many things but none were 100% reliable and would sometimes return an incorrect amount. The only other way I thought of was storing it all in player files but I'd rather stay away from that.
Am I able to grab a health value from the Heroes api to use as that "base" health?
-
View User Profile
-
Send Message
Posted Feb 19, 2014@Supavitax
Well, by using the API of plugins - onEnable you can have it use that... This plugin handles health really oddly though - the main thing I saw that was broken was the health. We fall back on the vanilla health - so items with attribute +max health work fine with our system, but your items are using something different - it resets the max-health and if I unequip the items it goes back down to 20 hp.
It's your plugin, I'm impressed by what you've done, just wishing for better integration with already well established systems.
-
View User Profile
-
Send Message
Posted Feb 19, 2014@LordKainzo
I spent many hours trying to come up with a system that would allow other plugins to handle the health but nothing worked well enough for a release. To support one plugin would mean I would have to support them all and there are too many that alter the health so I'd rather not support any.
@iSiiLeX
No not that I know of.
@drewch123
I'll look into it.
-
View User Profile
-
Send Message
Posted Feb 19, 2014There's a lot of issues with how this plugin handles health with other plugins like Heroes
http://hc.to/javadocs
-
View User Profile
-
Send Message
Posted Feb 19, 2014Prompt please. Maybe I'm not so custom configuration. I disabled .. When a player has for example 50 lives it does not allow him to present these 50 hearts! If a player receives 3 damage he loses 20 hearts ... How to fix it?
-
View User Profile
-
Send Message
Posted Feb 19, 2014@Supavitax
one Question: is there a way to generate random items in a Phatloot chest using ils with a Woodensword named "Ruined Sword of.." which have a x%(random) amount to generate the stat XY with x%(random) ? If yes how can i do it?
hope u can help me :) (sry 4 my bad english)
-
View User Profile
-
Send Message
Posted Feb 18, 2014@Supavitax can you add a villagerzombie and witherskeleton yml file or can i just put one in ?
-
View User Profile
-
Send Message
Posted Feb 18, 2014hey , could you remove ": " for lores? (sor my english so bad) example: "&3Damage: &b+20" change to: "&3Damage &b+20"
-
View User Profile
-
Send Message
Posted Feb 18, 2014Can you add a new status of Effect(Trails)t.For example you have amazing trail effects left behind players locations.(Effect: Fire?)That's very cool. Also,I want to add a extra attributes when i have all Specified equipment.For example: 'Kit: ' 'Ghost flames' 'Frost Sword' 'Extra: Health: +10'? Thats a great stats.
-
View User Profile
-
Send Message
Posted Feb 18, 2014@BrotherMic
Yes this works with PhatLoots, but its a little bit tricky to set items in Chest Loot Tables which are working with ILS. Send me a PM if you want if you need help with that.
-
View User Profile
-
Send Message
Posted Feb 17, 2014Can you make it so that the lore stacks. For example. If I have a pair of boots
Health: +20 Health: +20
It's reporting 20 health, not 40.
I have a socket / gem system that allows players to add gems to their armor, which basically just replaces the (Socket) lore, with the attribute. So players cannot use 2 of the same gem at the moment :(
-
View User Profile
-
Send Message
Posted Feb 17, 2014Love this plugin, it helps make my server we have added so much to it too. Thank you very much and hope to Donate here soon.
-
View User Profile
-
Send Message
Posted Feb 17, 2014@tpl0sured0mem
Which version was you using?
-
View User Profile
-
Send Message
Posted Feb 17, 2014I removed the plugin after we used it for a while; I noticed all the health of players remained what it was with all the attributes. For example; my health was 690 and now in vanilla w/o the plugin; my health bar shows over 159 hearts of health. How could I change this to the standard 10?