Lore Attributes
This plugin is no longer in active development by me (Nighteyes604). LordPhrozen has picked it up and you can continue to receive updates here: http://dev.bukkit.org/bukkit-plugins/lore-attrubites-revival/
This plugin allows players to increase affect their stats (health, damage, regen, and attack speed) based on the lore of their items. All lore also applies to mobs - so you challenge your players by giving mobs better stats!
Note: This plugin does not add lore to items, it just reads the lore and affects the player based on it.
Lore Stats
Currently lore can be applied to: attack damage, attack speed, health, health regeneration, dodge chance, critical chance, critical damage, life steal, armor, and even a restriction of items based on permissions!
Read the sections below to see how to boost the stats of your items.
Damage
Damage boosting can be applied to items in one of two ways - a random range, or a fixed increase.
"+5 Damage" on an item will increase damage dealt by 5 "2-6 Damage" on an item will set the player's damage to be a minimum of 2, maximum of 6.
Damage looks at the sum of all items equipped, and the item in the player's hand. Every range applied to an item is summed together, and then boosts are applied afterwards.
Example:
- Helm: 2-3 Damage, Chest: +5 Damage, Sword: 5-10 Damage
- Overall Damage: 12-18
Health
Max health can be increased by fixed values and can be applied to any item the player has equipped.
+50 Health will increase the player's health by 50.
This action just sets the max health, not current health. If the player removes boosting armor and would have more health than their new max, their health will be lowered to their new max.
Regeneration
Health regeneration can be increased by fixed values and can be applied to any item the player has equipped.
+50 Regen will increase their regeneration by 50.
Regeneration boosts are applied when health would typically be regenerated - the player is satiated / has a high food bar.
Attack Speed
Attack speed can be limited / increased and can be applied to any item the player has equipped, and the item in the player's hand.
+2 Attack Speed will increase the player's attack speed by 2.
All player's have a default attack speed of 1, and the "cooldown" between attacks is determined by "base-delay" in the config / attack speed, in seconds.
Example:
- Sword: +1 Attack Speed. Base-Delay in config: 2
- Attack Speed: Can deal damage once per second (2 / 2 = 1)
Attacks faster than the player's cooldown time will display the message in the config. If the message is set to "none" nothing will display. To use attack speed as a lore, it must be enabled in the config. It is disabled by default.
Dodge
A player can gain a % chance to dodge damage taken from another entity. The dodge attribute can be applied to any equipment the player is wearing, and the item in the player's hand.
Example: +5% Evasion will increase the chance to dodge damage from another living entity (such as monster or another player) by 5% (players start at 0%).
Critical Chance and Critical Damage
On dealing damage to another player or entity, players can be given a chance to have a critical attack - which deals critical damage. Players will need both the critical chance lore and the critical damage lore for crits to be noticable.
Example: +5% Critical Chance +10 Critical Damage
Means the player will deal an extra 10 damage on average 5% of the time.
Life Steal
Life steal lore gives players and monsters the ability to heal when they attack. Anyone with the life steal attribute will heal a maximum of their life steal bonus or the damage dealt, whichever is smaller.
Example: +10 Life Steal Any attacks done by this player will heal the attack damage, up to a maximum of 10.
Armor
Armor lore adds defensive traits to the player or monster, and reduces damage done by other entities based on the armor value.
Example: +10 Armor Any damage this player would have taken from another player or monster will be reduced by 10.
Item Restrictions
You can use item restrictions to prevent players from using certain items based on their permissions! Restrictions are checked for players only (so mobs are safe), and are checked: on inventory close, when they try to shoot a bow or damage another entity, and when they craft.
Players trying to equip a restricted armor piece will find the armor moves to their inventory when they close the screen. If their inventory is full it will be dropped at their feet.
Players trying to shoot a bow or deal damage with an item that is restricted will find they deal no damage (though arrows will still be used when trying to shoot a bow).
Players trying to craft using a restricted item will find they're unable to and the items will be reverted. The MineCraft client briefly lets the player think the item has been crafted, but it will change back.
Anytime a player tries to use a restricted item, if enabled the plugin will send them the message from the config. %itemname% will be replaced with the item name that is restricted.
The default permissions to use are "loreattributes." + whatever the restriction is in the lore. The default keyword in the configuration is "type", and the keyword will need to be followed with a colon (:).
Example: Type: Thief Player will need the "loreattributes.thief" permission.
Type: Super.Thief Player will need the "loreattributes.super.thief" permission.
When does Lore get applied?
- Health - Applied on login, closing inventory, respawn, targeting (for mobs).
- Damage, life steal, attack speed, critical chance, critical damage - Applied on attack.
- Regen - Applied when player would normally regenerate health.
- Item Restriction - Checked on inventory close, shooting bow / attacking, and crafting
- Dodge, Armor - Applied on taking damage from another player or mob
How do I change the keywords the plugin is searching for to apply lore attributes?
In the configuration file, under each type of lore there is a "keyword" attribute. The plugin will search for the keyword (with a few other conditions, such as + or % based on the type of lore it is).
Dodge and critical chance require a % sign after the value.
Can I stack multiple lore / have other words in my lore?
Yes!
The plugin will search the entire lore for the particular strings mentioned above, but will only apply the first of each type.
Example:
- Sword: "+50 Health, +2 Attack Speed this sword will never let you down!" would apply +50 health, +2 attack speed.
- Sword: "+50 Health +500 Health you'll be OP with this" would only apply +50 health.
Permissions
Permissions are used dynamically based on the item restrictions you add to items, as mentioned above. There are no other restrictions in this plugin - anyone that can use the item that has lore will have the lore applied to them.
Commands
/hp - Players can type this to find out their current health, and maximum health. /lorestats - Players can type this to list all of the lore that is applied to them.
Plugin Integration
PermissionsHealth
- This plugin can build off of health defined from PermissionsHealth. Just enable "permissionshealth" under integration in the config.yml.
Misellaneous
- Thank you to davidilite for the inspiration behind this plugin!
Upcoming Features
- Heroes integration
- Command to view all lore attributes applied (possible revision of formatting or colors - any suggestions?
- Support for negative values
Any chance we can have arrows with + damage on them work from dispensers for traps ? :]
since they become useless once players have 50 hp...
Seriously... on my server there is a bug with this plugin... my users complains about it and I'm suffering it since I re-launched my server (A week ago)
When hunger bar starts to decrease mi PJ "takes damage" but no damage is deal. It is annoying because you need to be eating all the time... I found that it only happens if you wear an armor with health flag. I've flags traducted to spanish (+3 Health => +3 Vida) and I'm running your latest version and Spigot #837
I will thank you very much if you could check that... I could disable this plugin but it is a good feature...
Additional info:
/lorestats: I get "3 regeneracion 5 vida"
There isn't errors on console, "all works correctly", my only error is this but it only involves lorecraft and it occours sometimes: http://pastebin.com/3N8wCZmL
@thc001
Just wanted to confirm this issue. Checked to see if i missed an earlier comment but doesn't look like it was there.
Basically when I (or any non op / permissions user) put on an armor item with the restriction keyword in the lore, you can rapid fire the inventory button and duplicate as much as you can until it is falling off your character after your inventory maxes.
Nothing critical in the logs outside of the False<restriction permission> shows to everyone on the server, not just the user. Basically just seems to not be removing the armor from the armor slot after it has been created back inside their inventory. I remember something with diamond boots being slightly different behavior from the other pieces. I can test it in a bit if it would mean anything to you.
But.... regardless of the above, this plugin is amazing!!!
@prorockband
Yup this is possible, I'll add it to the upcoming features bit!
@Jalau
Can you give me the specifics, or a screenshot? I need to see the lore exactly so I can replicate please.
Clicking F5 for see the Heroes integration. That plugin will finish my MMO system.
The option 1-5 Damage for example is still bugged, +5_Damage works but the - methog will return a random damage worth between 1 and 10000 or higher, if i do /lorestats it's sometimes 500 Damage, then 12 Damage etc. Please fix this!
@nighteyes604
Hey this may be kinda of a personal suggestion, but I was wondering if it be possible to add a config option on which worlds the stats would be applied. My reason for this is that I own a server and I love this plugin and have many uses for it in my section of my server. But my problem is that I don't want to ruin peoples ability to PVP in the main world because of that's stats. So the solution is that the stats would only be applied in the RPG world i have and wont be applied in the normal world. Hope I can hear back from you soon on what you think.
- Prorockband
@nighteyes604
When I use /lorestats I get this:
regeneracion 4 vida 5 (Regen and health, because i traducted words) It only occours when my hunger bar is starting to decrease. When hunger bar reaches the middle it stops the "damage"
Thanks for the new update!!
It fixed armor and evasion and its SUPER EFFECTIVE!!
But I do find some other problem
Its the restriction.
First, when the player try to equip the restricted armor without the required permission, they can actually equip it on the armor slot and appear on the character after closing the inventory. I didn't test whether the lore or the armor value is effective or not. The actual problem is they DUPLICATE one more armor in their inventory. Duplicating armor is s disaster!! (Tested: Lore is effective. eg. +100 Health do add the health even without restriction permission)
The display-message is bugged also. After setting it to false, when try to use restricted armor/weapon would show a message "false" to ALL PLAYER on the server. Even on the console their are "false". I will include a picture to make it clearer. The Picture
Ps. From the picture you can also notice there are a lot of iron chestplate. Well they are all duplicated with the duplication bug. :(
These problems make the whole restriction part cannot use. :(
@Shelmak
What lore do you have? Please type /lorestats so I can try to replicate, I don't experience this issue. Are you on the latest version and most recent bukkit?
Umm, this is a bug? When my hunger bar decreases I receive "Damage" but my hp dont decrease. My hunger bar is not empty, when I start to take hunger my PJ says "chack" "chack", same sound as a mob hitting me. I dont know how to say that, I'm spanish, sorry.
@WhyHaveALife
I really like how this plugin works.. I am not going to endlessly jump plugins to get the features I want. How about suggesting features to make this plugin better.
@mr_jacks_1
MythicDrops is planning an integration with Lore Attributes and MythicDrops has the ability to set sets. It may prove useful to use MythicDrops
@TimeBeater
"i know i don't add lore to items" .... "but how can you make config file so it adds lore to items"
What the hell?
mr_jacks_1 isn't "adding stats to items" he is showing an example config that would add a new feature to the plugin.
You still don't get it do you ....
This plugin does NOTHING on its own. I would call it more of an API... You will never see anything happen without some other plugin which can add the lines of text for lore ("add stats")
Suggestion: Set Bonuses.
Set(2) +5 Armor
Set(4) +10 Health
if its not able to be dynamically gathered. in a yml is fine too.
then the plugin would look for the lore
set 5arm
set 10hp
@TimeBeater
Note: This plugin does not add lore to items, it just reads the lore and affects the player based on it.
It's right there at the top of the page.
@TimeBeater
lore is added with another plugin like lores
pls add move speed, decimals & jump height.
In doing some theory crafting I was wondering if attack speed supported decimals. Your example config shows only integers.
You also state that players have a default speed of 1. So I do hope you support decimals. I can't test until later. :x