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
If you guys go open source at any time, I would enjoy poking around and contributing some code here and there.
@nighteyes604
on review.. on my server there are too many unbalanced items in players hands. if you could fix the color codes that would be great.
Also no donate button in the post above?
The restriction message appeared as 'true[type]' or 'false[type]'
I'm uploading version 1.2.1 tonight that fixes some bugs with armor and evasion.
While it's under approval, you can download the plugin here:
Development builds of this project can be acquired at the provided link belowr. These builds have not been approved by the BukkitDev staff. Use them at your own risk.
Edit: Removed link, v 1.2.1 is approved.
Hm. Strange. I've been messing around a little and evasion is not working.
@mr_jacks_1
I am experiencing these same issues. +100% Evasion (shown in lorestats) is allowing me to be hit. Also, with +100 Armor on a sword (again in lorestats) I still take damage but now deal none in return.
@nighteyes604
Finding out the bug was allows me to fix it on my end, a fix would be nice. but a known issue would suffice for other people.
Ive done little testing with armor/evasion as i am not at home. my first thought was why am i not doing any damage to any mob.. then i tested on unarmored zombies.
When i get more time i will do more testing for you.
Thanks for your Great Works so far!
@Descendant788 read http://dev.bukkit.org/server-mods/lore-attributes/#w-item-restrictions
also
lore-attributes does not make any item it just apply the mechanics if the lore is there. and for my plugin LoreCraft reason i didn't add this "items can be group specific" is because there is actually a good amount of plugins out there that already do that just 1 type would be http://dev.bukkit.org/server-mods/armorperms/
I have a suggestion for an update.
Could you make so items can be group specific?
Example:
Any armor that has a group name on it, only that group may wear the armor.
Oh wow a lot of comments, let me try to reply:
@Shelmak
I haven't tested with special characters, but as long as the character can go in the yml and be on the lore in game it should work...
@mr_jacks_1
Glad you figured it out! Sorry the plugin doesn't sort out the colors correctly, do you need a fix for this or does Shelmak's solution work?
@BoyDerAmBlockChillt
I would like to support partial health but I don't think minecraft or bukkit do. If I damage someone for .1 or add .1 health I'll have to look into how it handles that.
@thc001
@mr_jacks_1
This is... interesting. I tested it using armor / evasion and it worked for me, /lorestats says you have the evasion stat? I tested with +100 armor and nothing could deal damage to me, then I tested with +100% evasion and nothing could hit me. I tried +50% evasion and it hit me every now and then. I'll test dealing damage with a +armor on and try it.
Maybe it's the type of mob? Can you try a different one or a player?
@tarahere81
Weird since the plugin seems to pick up those special characters (like the damage post with the extra 7 in front). I'll work on adding formatting too.
@mr_jacks_1
It's not a solution but... If you obtain that weapon by give command you can add a _ that game read as space...
Or... if you use Lorecraft add a simple space after &7. It is a temporality solution...
I have a question, I'm not on my computer right now, will that plugin crash if I use Ñ letter? I wish to put 2-6 Daño.
That letter isn't on english language and some plugins doesn't support special characters.
In regards to my stone sword having outrageous damage... I figured it out.
As I use grey for my stats, &7. It is appending the 7 to the front of the damage.
So 8-10 is actually 78-10
and 10-12 was 710-12
Thanks for /lorestats it made chasing this issue that much easier!
@BoyDerAmBlockChillt
I don't see the purpose of decimal places in player health. I also don't understand how 1 life steal could be overpowered. I am testing against my custom mobs with 5 life steal and I'm getting my butt kicked.
Maybe in a more vanilla server then 1 lifesteal would be strong. But in that case, anyone with diamond gear is just as OP.
Please add +0.X possibility. Because if Lifesteal is 1 it's kinda overpowered!
@thc001
I am seeing the same results. If i have + armor my hits do nothing on mobs
Leather tunic
+10 Armor
punching with fist zero damage on unarmored zombie
same armor with a 2-3 damage iron sword hit for 1-2 damage
Strange. My dodge and armor wont work
Nighty:
How do I make it so the keyboards have to be in bold ? :(
I tried:
and regular dodge worked
@Jalau
Haha glad it's out, yeah negative numbers will be soon (I think).
Yeah, finnaly! How about the option, as i already told, to set the damage of a weapong with numbers with a +/- infront so if there is a +/- infront it will global add or remove damage if there is just 2-7 damage, the weapon will do 2-7 damage and the 2-7 damage will not be added to other items. That would be really amazing!
It's through! Finally. Love it.
@rmh4209
Yeah of course, I'm always willing to help out. If you need anything (advice, api, etc.) let me know.
To everyone else: Yeah still waiting for approval, I have no idea why it's taking so long. I guess developers were busy over the weekend.