✨ LoreAttributesRecoded 插件介绍

LoreAttributesRecoded 是一款 Minecraft 插件，允许玩家通过物品的 Lore（描述）来影响自身属性。该插件同样适用于怪物，你可以通过赋予怪物更好的属性来挑战玩家。

📌 功能特性

• 允许 Lore 应用于：攻击伤害、生命值、生命恢复、闪避几率、暴击几率、暴击伤害、生命偷取、护甲、亡灵杀手、节肢杀手、防御（吸收）、坚不可摧、经验限制以及基于权限的物品限制。
• 种族限制，Lore 甚至可以赋予玩家特定的药水效果！

🛠️ 配置

⚙️ config.yml

# ----------------------------------- #
#   LoreAttributesRecoded // Thana      #
# ----------------------------------- #

offhand-attributes-enabled: true # enable offhand attributes?

gems:
  enable-drag-drop: true # can players socket through the inventory?
  slot: '&3< &aFree Gem Slot &3>'
  socketed: '&3« &d&lSocketed: &a%gem% &3»'
  plain: '&3« &d&lSocketed: &a &3»'
  prefix: '« Socketed: '
  suffix: ' »'
  keyword: Socketed
  material: EMERALD,DIAMOND
  unsocket-message: '&c» &7Which slot''s gem would you like to destroy? &o(Max %gems_max%)'
  unsocket-success: '&c» &7Gem destroyed.'
  unsocket-invalid-number: '&4&c» &7Unsocketing cancelled, max slots was %gems_max%'
  unsocket-cancel: '&c» &7Unsocketing cancelled'

unsocket-item:
  display-name: '&6Unsocket Token'
  material: LEGACY_BLAZE_POWDER
  durability: 0
  lore:
  - '&eUse this in an anvil to unsocket a gem'
  - '&4WARNING: &cThe gem will be destroyed!'
  item-flags:
  - HIDE_ATTRIBUTES

lore:
  durability:
    keyword: durability
  health:
    enabled: true # may LAR modify health?
    base-health: 20 # base health for all players
    keyword: Health
  regen:
    keyword: Regen
  damage:
    keyword: Damage
  dodge:
    sound: ITEM_ARMOR_EQUIP_NETHERITE
    keyword: Evasion
  critical-chance:
    keyword: Critical Chance
  critical-damage:
    sound: ITEM_ARMOR_EQUIP_NETHERITE
    keyword: Critical Damage
  life-steal:
    keyword: Life Steal
  armor:
    keyword: Armor
  restriction:
    keyword: type
    display-message: false
    message: You can't use the %itemname%
  smite:
    keyword: Smite
  bane:
    keyword: Bane
  defense:
    keyword: Absorption
  unbreakable:
    keyword: unbreakable

📜 属性效果

⚔️ 伤害 (Damage)

可以通过两种方式增加物品的伤害：随机范围或固定增加。

• "+5 Damage"：增加 5 点伤害。
• "2-6 Damage"：将玩家的伤害设置为最低 2 点，最高 6 点。

伤害值是所有装备物品和手中物品的总和。每个应用于物品的范围值都会被加在一起，然后再应用增益效果。

❤️ 生命值 (Health)

可以通过固定值增加最大生命值，并可应用于玩家装备的任何物品。

• "+50 Health"：将玩家的生命值上限增加 50。

这个动作只是设置最大生命值，而不是当前生命值。如果玩家移除增加生命值的装备，并且生命值高于新的最大值，他们的生命值将降低到新的最大值。

❗ 尚未与 SkillAPI 兼容！

🔄 生命恢复 (Regeneration)

可以通过固定值增加生命恢复，并可应用于玩家装备的任何物品。

• "+50 Regen"：将生命恢复速度提高 50。

生命恢复增益效果在生命值自然恢复时应用（玩家饱食度高/食物条高）。

🛡️ 闪避 (Dodge)

玩家可以获得一定几率躲避来自其他实体的伤害。闪避属性可以应用于玩家佩戴的任何装备和手中的物品。

• "+5% Evasion"：将躲避来自其他生物（如怪物或其他玩家）伤害的几率提高 5%（玩家初始值为 0%）。

💥 暴击几率 & 暴击伤害 (Critical Chance & Critical Damage)

在对其他玩家或实体造成伤害时，玩家有机会触发暴击，造成额外伤害。玩家需要同时拥有暴击几率和暴击伤害才能使暴击效果明显。

• "+5% Critical Chance"
• "+10 Critical Damage"

意味着玩家有 5% 的几率造成额外 10 点伤害。

🩸 生命偷取 (Life Steal)

生命偷取允许玩家和怪物在攻击时恢复生命值。拥有生命偷取属性的单位将恢复生命偷取加成值或造成的伤害值，以较小者为准。

• "+10 Life Steal"：任何攻击都会恢复攻击伤害，最高为 10 点。

🕷️ 节肢杀手 (Bane)

攻击蜘蛛、洞穴蜘蛛、蠹虫或末影螨时，节肢杀手 Lore 会生效。

• "+10 Bane"：每次玩家攻击上述生物之一时，会对该生物施加 x 秒的缓慢 5 效果，并对其造成额外的 y 点伤害。

x = 20 * (1 + level * 0.5)

y = level * 2.5

💀 亡灵杀手 (Smite)

攻击骷髅、僵尸、猪灵僵尸或凋灵时，亡灵杀手 Lore 会生效。

• "+10 Smite"：每次玩家攻击上述生物之一时，会对该生物造成额外的 x 点伤害。

x = level * 2.5

🛡️ 护甲 (Armor)

护甲 Lore 为玩家或怪物增加防御特性，并根据护甲值减少其他实体造成的伤害。

• "+10 Armor"：玩家受到的来自其他玩家或怪物的任何伤害将减少 10 点。

🔨 坚不可摧 (Unbreakable)

使物品坚不可摧（无限耐久度）并隐藏属性。Lore 会保留。

💎 宝石 (Gems)

在 config.yml 中，你可以指定一种材料作为宝石。默认为绿宝石。

gems:
    enable-drag-drop: true
    slot: '&3< &aFree Gem Slot &3>'
    socketed: '&3« &d&lSocketed: &a%gem% &3»'
    plain: '&3« &d&lSocketed: &a &3»'
    prefix: '« Socketed: '
    suffix: ' »'
    keyword: Socketed
    material: EMERALD,DIAMOND

• enable-drag-drop：如果设置为 true，你可以将宝石拖到带有空插槽的物品上，类似于通过铁砧镶嵌宝石。
• slot：如果物品恰好具有此 Lore，则等于 1 个宝石插槽。如果一个物品有 3 次这个 Lore，它有 3 个宝石插槽，并且可以镶嵌 3 个宝石。
• socketed：镶嵌宝石时，将使用此格式。%gem% 是宝石本身的占位符（例如：+3 生命值）
• plain：与 socketed 相同，但没有 %gem%，确保将其他所有内容保留在那里！
• prefix：%gem% 前面的内容
• suffix：%gem% 后面的内容
• keyword：如果插件在物品的 Lore 中找到此关键字，它会将其注册为已镶嵌
• material：你的宝石的材料。默认为绿宝石和钻石

首先，我们需要创建一个宝石。名称和 Lore 可以随意设置。

创建物品后，你需要确保宝石的 Lore 中包含一个 Lore 属性和值，如下所示：

要将宝石应用于物品，你需要使用铁砧。

如果物品没有宝石插槽，则无法镶嵌宝石。可以使用 /lar gems addslot 命令来添加插槽。

将物品放在第一个插槽（例如武器），将宝石放在第二个插槽。

将宝石插入第二个插槽后，结果如下：

在本例中，剑现在镶嵌了 +4 伤害。就这么简单！

✨ 物品的被动效果

被动效果的工作方式非常简单：

添加一些 Lore，并保持正确的格式！

例如，要为使用该剑的攻击者添加一个被动中毒效果，只需添加 "Passive: Poison" 作为 Lore，通过命令 /lore add Passive: Poison。（是的，它支持任何颜色代码！）

现在当玩家用它击中另一个玩家时，有 10% 的几率对敌人施加 5 秒钟的毒药效果！（很快将可以配置！）

当前支持的药水效果：

• 缓慢
• 虚弱
• 挖掘疲劳
• 发光
• 失明
• 凋零
• 中毒

🚫 物品限制

你可以使用物品限制来阻止玩家基于其权限使用某些物品！物品限制仅针对玩家进行检查（因此怪物是安全的），并且会在以下情况下进行检查：关闭物品栏时、试图射箭或伤害其他实体时，以及制作物品时。

试图装备受限盔甲的玩家会发现盔甲在关闭屏幕时移动到他们的物品栏中。如果他们的物品栏已满，它会掉落在他们脚下。

试图射箭或使用受限物品造成伤害的玩家会发现他们没有造成任何伤害（尽管在试图射箭时仍然会使用箭）。

试图使用受限物品制作物品的玩家会发现他们无法制作，并且物品会恢复原状。Minecraft 客户端会短暂地让玩家认为该物品已被制作，但它会变回原样。

每当玩家试图使用受限物品时，如果启用，插件会发送来自配置文件的消息。%itemname% 将被替换为受限的物品名称。

默认使用的权限是 "loreattributes." + Lore 中的任何限制。配置中的默认关键字是 "type"，关键字后面需要跟一个冒号。

示例：

• Type: Thief：玩家需要 "loreattributes.thief" 权限。
• Type: Super.Thief：玩家需要 "loreattributes.super.thief" 权限。

⚙️ 如何更改插件搜索以应用 Lore 属性的关键字？

在配置文件中，每种 Lore 类型下都有一个 "keyword" 属性。插件会搜索关键字（以及一些其他条件，例如基于 Lore 类型的 + 或 %）。

闪避和暴击几率需要在值后加上 % 符号。

➕ 我可以堆叠多个 Lore / 在我的 Lore 中包含其他单词吗？

可以，但是插件会在整个 Lore 中搜索上面提到的特定字符串，但只会应用每种类型的第一个。

示例：

Chestplate:
    +50 Health
    +2 Armor
会应用 +50 生命值，+2 护甲
Chestplate:
    +50 Health
    +500 Health
只会应用 +50 生命值

🔑 权限

权限会根据你添加到物品的物品限制动态使用，如上所述。此插件没有其他限制 - 任何可以使用具有 Lore 的物品的人都会将 Lore 应用于他们。

🗝️ 权限列表

permissions:
  loreattributes.mod.*:
    default: op
    children:
      loreattributes.mod.durability: true
      loreattributes.mod.gems: true
  loreattributes.mod.durability:
    default: op
  loreattributes.mod.gems:
    default: op
  loreattributes.reload:
    default: op
  lores.lore:
    default: false
  lores.name:
    default: false
  lores.owner:
    default: false
  lores.color.0:
    default: false
  lores.color.1:
    default: false
  lores.color.2:
    default: false
  lores.color.3:
    default: false
  lores.color.4:
    default: false
  lores.color.5:
    default: false
  lores.color.6:
    default: false
  lores.color.7:
    default: false
  lores.color.8:
    default: false
  lores.color.9:
    default: false
  lores.color.a:
    default: false
  lores.color.b:
    default: false
  lores.color.c:
    default: false
  lores.color.d:
    default: false
  lores.color.e:
    default: false
  lores.color.f:
    default: false
  lores.color.l:
    default: false
  lores.color.n:
    default: false
  lores.color.o:
    default: false
  lores.color.k:
    default: false
  lores.color.m:
    default: false
  lores.color.r:
    default: false
  lores.color:
    default: false
    children:
      lores.color.0: true
      lores.color.1: true
      lores.color.2: true
      lores.color.3: true
      lores.color.4: true
      lores.color.5: true
      lores.color.6: true
      lores.color.7: true
      lores.color.8: true
      lores.color.9: true
      lores.color.a: true
      lores.color.b: true
      lores.color.c: true
      lores.color.d: true
      lores.color.e: true
      lores.color.f: true
  lores.format:
    default: false
    children:
      lores.color.l: true
      lores.color.n: true
      lores.color.o: true
      lores.color.k: true
      lores.color.m: true
  lores.admin:
    default: op
    children:
      lores.lore: true
      lores.name: true
      lores.owner: true
      lores.color: true
      lores.format: true