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 Nov 16, 2013@MikeGold
I'll try and get an update out tonight or early tomorrow.
-
View User Profile
-
Send Message
Posted Nov 16, 2013Awesome. I'm desperate for that feature, because I've got a bunch of whiners demanding their regen. It will relief my headache.
-
View User Profile
-
Send Message
Posted Nov 16, 2013@MikeGold
Yea that's intended but I'll add a default value to regen.
-
View User Profile
-
Send Message
Posted Nov 16, 2013Well I mean without any gear on. In vanilla your HP does recover when your hunger bar is full. I might be using the 0.915 version though. I'm going to check the new one now.
Edit:
Checked the most recent version.
Still not good.
Without any armor on HP regen does not work at all. That is kind of a deal breaker for me, because the equips with stats are very rare on my server so the normal players have to regenerate HP somehow as well.
-
View User Profile
-
Send Message
Posted Nov 16, 2013@MikeGold
Have you set the tooltip correct and the amount high enough? Do they have gear with that stat on? because the regen does work for me.
@demellion
I'll have a look into that issue.
-
View User Profile
-
Send Message
Posted Nov 15, 2013@Supavitax
Found another one, maybe its only mine problem but. Level requirments for items are not checked and items are not removed if they are in 100,101,102,103 slots, which is armor slots. No login/logout action does the check action.
-
View User Profile
-
Send Message
Posted Nov 15, 2013I had a suspicion that it was because my server is running on Spigot, but I've checked it and it's not the reason.
Edit:
I thought that it could be one of my 40 plugins causing issues with your plugin, but I've removed all plugins on my test server and got the very same result.
-
View User Profile
-
Send Message
Posted Nov 15, 2013@MikeGold
I'll have a look into it to see what's wrong because I'm sure it was working.
@demellion
I'll add the option to set them to 0 to disable in the next build and I'll look into fixing the speed when switching item.
-
View User Profile
-
Send Message
Posted Nov 15, 2013One of my users just reported an issue with your plugin to me.
When your plugin is on, the HP is not regenerating at all. The food is maxed and hearts are not coming back.
I've checked my test server with and without your plugin and that is true.
Without it hearts are regenerating as ussual, with it they don't at all.
-
View User Profile
-
Send Message
Posted Nov 15, 2013@Supavitax
Also found a bit issue about 1-9 slots (hand):
Any applied Speed stat by holding an item will not dissapear even when the item is destroyed/dropped. Few ways to overlay this effect is: 1) Death 2) Changing speed with other item or potion (basic minecraft)
Armor slots apply and removes effect properly.
-
View User Profile
-
Send Message
Posted Nov 15, 2013@Supavitax
Yes, found that just awile. So still - can you give a config parameter to disable force setHealth() on any events (death, equip) and other? P.S Read before, then set.
For Heroes (and any similar):
Tip: Any damage set in your plugin Multiplies the damage set on Heroes plugin, but if you set damage from Mobs to 1 - This will do normal Heroes Plugin damage (or any other) but will disable any equipment damage
Tip 2: Setting some parameters to 1 (fall damage) disables the fall damage totally.
-
View User Profile
-
Send Message
Posted Nov 15, 2013@demellion
If you set baseHealth to 0 it will disable any updates for the +health stat as well.
-
View User Profile
-
Send Message
Posted Nov 15, 2013@Supavitax Im gonna kiss you (somehow) if you could set a parameter in a config to disable a force setHealth on respawn/firstlogin and any other action. Im having a heroes plugin which does this stuff already and i need only to gain + Health. This plugin is first, that can merge with Heroes. Please. Thanks
EDIT: OH GOD, setting Health Base value to 0 gives that HP Will never be forced, so Heroes eats this easy I've been searching this for few years already. Mate continue.
-
View User Profile
-
Send Message
Posted Nov 14, 2013@otlod
You would either need to delete your player file in the world folder or set baseHealth to 20 in the config and then log back in the server to update the player file to the default vanilla value.
-
View User Profile
-
Send Message
Posted Nov 13, 2013Something has went wrong:
After removing this plugin, there are too many player hearts. Is there a way to make it return to normal?
-
View User Profile
-
Send Message
Posted Nov 13, 2013@MikeGold
I'll have a look into the npcDamageMultiplier and the fall/lava damage is detailed in my reply below.
@Adondriel
I will eventually be changing damage from a static value to a range so the life steal will amount will change slightly on each hit.
@PanteLegacy
Not that I know of.
@MikeGold
Yea I will be adding the increased damage from lava, fire, explosions etc in the next build and all configurable from the config.
-
View User Profile
-
Send Message
Posted Nov 13, 2013Ok, I've downgraded
npcDamageMultiplier: 20
to
npcDamageMultiplier: 8.5
and the mobs are dealing the same damage as they did in vanilla.
But there is no way to increase the damage from falling/lava burn etc. (check my last comment for reference).
-
View User Profile
-
Send Message
Posted Nov 12, 2013Maybe make lifesteal amount and lifesteal% have separate stats, so that lifesteal isn't always the same amount of health?
-
View User Profile
-
Send Message
Posted Nov 12, 2013Do you have any suggestion for a plugin that can create a new ID, etc: Custom Diamond Sword to be 276:1 or something? Thanks (insert thanks here)
-
View User Profile
-
Send Message
Posted Nov 12, 2013Oh, and one more thing I've noticed. When I tried to kill myself by jumping off a big height it took me three jumps to die, while in the past I would be gone in first go (no armour/weapon equipped). Zombie kills me in 3 hits. It takes lava good 15-20 seconds to burn me (a bit too long I think). Please check that out.
npcDamageMultiplier: 20
baseHealth: 100
healthScale: 20
I want to keep current damage/armour etc. But I want my players to die from falling as well. Especially those without any armours.
Edit: Maybe you could add Environmental Damage Multiplier as well? That should sort it out.