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 24, 2015Hello!
We have a problem in that we can't edit the config without it reverting.
Any changes we make to the config are not being considered when reloading. Restarting the server causes the config to revert to its default settings.
We are finding this extremely problematic.
-
View User Profile
-
Send Message
Posted Jan 24, 2015Excellent Work
This is a great plugin, good job on all the hard work. Curiously, I found something in the config called 'Set Bonus'. But I can only edit the value and colour of it? I was wondering, is this like a bonus from wearing several pieces of equipment from the same set? if so, I haven't seen it implemented, but would LOVE to.
Secondly, Are Spells disabled in 1.8? Because I have no way of getting them to work. I know this isn't really made for 1.8 yet, but almost everything seems to work just fine. (Other than spells)
EDIT: Also, Harming and Poison skills don't work on 1.8
-
View User Profile
-
Send Message
Posted Jan 23, 2015@Dsiddia
Does this appear with every item?
@sdvn
Looks great, will pm you with a few suggestions I have.
-
View User Profile
-
Send Message
Posted Jan 23, 2015Im making it for you :D
Still develop
http://i.imgur.com/kUSvvyn.jpg
-
View User Profile
-
Send Message
Posted Jan 22, 2015Everytime I loot a drop I get ILS_ on my item name. Any way to fix it?
Running 1.8.1 bukkit so that might be the case.
http://puu.sh/eSgfX/fca4ca02bc.jpg - Example
-
View User Profile
-
Send Message
Posted Jan 21, 2015@Supavitax
Cool! Thanks a lot! :D
Also, did you see my suggestion about the combo stat? It would be really useful :D
-
View User Profile
-
Send Message
Posted Jan 19, 2015@Supavitax
Thanks Supavitax! I know myself along with a few others have bugged you before for SkillAPI compatibility in the past. SkillAPI's developer is creating some neat ways to integrate your plugin with his skill creation plugin by adding the ability for skills to read the lore of an item and apply various effects. This creates many interesting ways for the two plugins to work & I would be incredibly exited to see SkillAPI and ILS working well with each other.
-
View User Profile
-
Send Message
Posted Jan 19, 2015@TheMinecrafter606
Yes http://dev.bukkit.org/bukkit-plugins/item-lore-stats/pages/change-log/
-
View User Profile
-
Send Message
Posted Jan 19, 2015@Supavitax
Do you have any plans on updating to 1.8?
-
View User Profile
-
Send Message
Posted Jan 18, 2015@Supavitax
Ill accidently found a way to get the exact item id name;)
::
I equiped the citizens npc the mod item in his hand. Next I went into the plugin folder of citizens and opened the saves.yml. I searched the npc name: looked for the item hand type: - CUSTOMNPCS_NPC"ITEM NAME"
so: - CUSTOMNPCS_NPCKUKRI
or: - CUSTOMNPCS_NPCDIAMOND_DAGGER
Ill will try it out and reply the answer if it worked::
Added "- CUSTOMNPCS_NPCKUKRI" under materials.tools::
And it worked!
-
View User Profile
-
Send Message
Posted Jan 18, 2015@TobioRy2
I'll add a command and pm you a dev build to test if you want?
-
View User Profile
-
Send Message
Posted Jan 18, 2015@Supavitax
Ill tried that to, but unfortunately it didn't work :(
* - X4453:KUKRI and - X4258:DIAMOND_DAGGER
Yes it would be nice if there was somekind of a command.
I know alot of people that have te same issue ;)
Adding the name to a mod weapon works fine. Only the effects of a mod weapon don't work...
-
View User Profile
-
Send Message
Posted Jan 18, 2015@Supavitax
http://dev.bukkit.org/bukkit-plugins/item-lore-stats/?page=5#c1896
http://dev.bukkit.org/bukkit-plugins/item-lore-stats/?comment=1897
http://dev.bukkit.org/bukkit-plugins/item-lore-stats/?comment=1900
Long story short when I add new Item into game and give it Damage: +4 it hits 4 + its orginal damage which is not supposed to be I guess since include vanilla damage is set to false.
-
View User Profile
-
Send Message
Posted Jan 18, 2015@TobioRy2
Try this; under materials.tools add - X4453:KUKRI and - X4258:DIAMOND_DAGGER.
I'll add a command to automatically add the item in hand to the config as it can be quite confusing.
-
View User Profile
-
Send Message
Posted Jan 18, 2015how config item lore Stats with mythic mob ? thx.
-
View User Profile
-
Send Message
Posted Jan 18, 2015How can I add a weapon from a mod to the config file of Item Lore Stats?
Because I want to add te Poison effect to the mod weapon but then i have to first add the right name of the mod weapon to the config file of Item Lore Stats.
I tried many names but none of them seem to work.
When I attack a mob with the mod weapon, the affect of Poison wont work.
So could anyone tell me how I have to write the ID of the mod weapon into the Config file?
For mod weapons: - Kukri (#4453) - Diamond Dagger (#4258)
-
View User Profile
-
Send Message
Posted Jan 17, 2015@l666deicide666l
I'll try and get it sorted for the next update. No it can only be set as an int.
@jhicks32917
Thanks I'll look into it.
@sonic3342
It looks like you take damage but instead your max health is just increasing which makes it look like you're taking damage.
-
View User Profile
-
Send Message
Posted Jan 17, 2015Hello! So far, this plugin is working very well. Except, whenever I hold/equip an item that I added a lore to damages me and when I take it out of my hand, it heals me to the HP I was before.
-
View User Profile
-
Send Message
Posted Jan 16, 2015@l666deicide666l
If you go to SkillAPI's page, he is creating the compatibility you're looking for. The newest version will be able to search lore in the held weapon for a string defined on a per skill basis, meaning you could enter "Damage:" as the lore to be searched for, as that's the lore used by Item Lore Stats to add damage, then the value after that is multiplied by another value defined by the skill and added to the skill's damage. Only problem is, Item Lore Stats presently applies 100% of it's damage to SkillAPI's skills. I'm not sure if that's an issue on Item Lore Stats' end or SkillAPI's.
Though I've tried for quite awhile to get either plugin developer to develop compatibility with the other, but despite messaging both and even offering to pay for such compatibility, neither ever responded.
-
View User Profile
-
Send Message
Posted Jan 15, 2015@Supavitax: Thanks for the fast respond.
By hide i mean it would not appear in the chat after the /stats command.
Can the internal cooldown be a float?