LoreAttributesRecoded・Create Custom Items! - LoreAttributesRecoded・自定义装备升级

LoreAttributesRecoded 是一款允许玩家通过物品描述（Lore）来增强角色属性的插件。所有属性加成同样适用于怪物，这意味着你可以通过赋予怪物更强的属性来挑战玩家！

💡核心功能

• 属性加成：通过物品 Lore 直接提升玩家的各项属性。
• 怪物增强：Lore 属性同样对怪物生效，可创建更具挑战性的敌人。
• 宝石镶嵌：支持将带有属性的宝石镶嵌到装备中。
• 物品限制：可基于权限或等级限制物品的使用。
• 被动效果：物品 Lore 可赋予玩家攻击时触发的药水效果。

支持的属性类型

插件目前支持通过 Lore 调整以下属性

• 攻击伤害
• 生命值
• 生命恢复
• 闪避几率
• 暴击几率
• 暴击伤害
• 生命偷取
• 护甲
• 亡灵杀手（Smite）
• 节肢杀手（Bane）
• 防御（伤害吸收）
• 无法破坏（Unbreakable）
• 经验等级限制
• 基于权限的物品限制
• 基于种族的限制（即将推出）
• 药水效果（新增）

🎮属性详解

攻击伤害

有两种应用方式

• 固定值：例如 +5 Damage，增加 5 点伤害。
• 随机范围：例如 2-6 Damage，将玩家的伤害设定在 2 到 6 之间。

伤害计算会累加玩家所有已装备物品和手持物品的加成。所有范围值先求和，然后再应用固定值加成。

生命值

例如 +50 Health，将玩家的最大生命值提高 50 点。此操作仅设置最大生命值，而非当前生命值。如果玩家移除了加成装备导致当前生命值超过新的上限，生命值将被降低至新上限。

> 注意：目前与 SkillAPI 不兼容。

生命恢复

例如 +50 Regen，将生命恢复值提高 50 点。恢复加成在玩家自然恢复生命时（饱食度高时）生效。

闪避

例如 +5% Evasion，使玩家有 5% 的几率闪避来自其他生物（怪物或其他玩家）的伤害。玩家初始闪避几率为 0%。

暴击几率与暴击伤害

玩家攻击时有几率造成暴击，造成额外伤害。需要同时拥有暴击几率和暴击伤害 Lore 才能生效。

• +5% Critical Chance：5% 暴击几率。
• +10 Critical Damage：10 点暴击伤害。

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

生命偷取

例如 +10 Life Steal，玩家攻击时将恢复生命值，恢复量为造成的伤害值，但不超过 10 点。

节肢杀手（Bane）

当攻击蜘蛛、洞穴蜘蛛、蠹虫或末影螨时生效。

例如 +10 Bane，每次攻击上述生物时，会对其施加缓慢 V 效果并造成额外伤害。

• 持续时间（秒）：20 (1 + 等级 0.5)
• 额外伤害：等级 * 2.5

亡灵杀手（Smite）

当攻击骷髅、僵尸、僵尸猪灵或凋灵时生效。

例如 +10 Smite，每次攻击上述亡灵生物时，会造成额外伤害。

• 额外伤害：等级 * 2.5

护甲

例如 +10 Armor，减少玩家受到来自其他玩家或怪物的 10 点伤害。

无法破坏（Unbreakable）

使物品变得无法破坏（无限耐久度）并隐藏属性。Lore 会保留。

🔧宝石镶嵌系统

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

配置项说明

gems:
  enable-drag-drop: true # 是否允许通过拖拽镶嵌宝石？
  slot: '&3< &aFree Gem Slot &3>' # 表示宝石槽的 Lore 文本
  socketed: '&3« &d&lSocketed: &a%gem% &3»' # 镶嵌后的 Lore 格式，%gem% 为宝石属性占位符
  plain: '&3« &d&lSocketed: &a &3»' # 同 socketed，但不包含 %gem%
  prefix: '« Socketed: ' # 镶嵌文本前缀
  suffix: ' »' # 镶嵌文本后缀
  keyword: Socketed # 识别物品已镶嵌的关键词
  material: EMERALD,DIAMOND # 宝石的材料类型

使用方法

• 创建宝石：制作一个物品，其 Lore 中包含一条属性值，例如 +4 Damage。
• 添加宝石槽：对目标物品使用命令 /lar gems addslot，为其添加宝石槽 Lore。物品必须有宝石槽才能镶嵌。
• 镶嵌宝石：在铁砧中，第一格放入待镶嵌物品，第二格放入宝石。合成后，物品将获得镶嵌属性。

✨被动效果与物品限制

被动药水效果

在物品 Lore 中添加 Passive: <效果名> 即可赋予攻击时触发的被动效果。

• 格式：例如 /lore add Passive: Poison
• 效果：玩家用此物品攻击时，有 10% 几率使敌人中毒 5 秒（具体几率与时间即将可配置）。
• 当前支持的效果：缓慢、虚弱、挖掘疲劳、发光、失明、凋零、中毒。

物品限制

可防止玩家基于权限使用特定物品。限制仅对玩家生效，在以下情况检查：关闭背包时、尝试射箭或攻击时、合成时。

• 触发行为：

- 尝试装备受限制的盔甲：关闭界面后，盔甲会移回背包或掉落。

- 尝试使用受限制的弓或武器：无法造成伤害（射箭仍会消耗箭矢）。

- 尝试用受限制的物品合成：合成会失败，物品会退回。

• 提示信息：如果启用，插件会发送配置中的提示信息给玩家。%itemname% 会被替换为受限制的物品名。

权限格式

默认权限节点为 loreattributes. + Lore 中限制类型后的内容。

配置中的默认关键词是 type，关键词后需要跟冒号。

• 示例 Lore：Type: Thief
• 所需权限：loreattributes.thief
• 示例 Lore：Type: Super.Thief
• 所需权限：loreattributes.super.thief

❓常见问题

如何修改插件识别属性 Lore 的关键词？

在配置文件 config.yml 中，每种 Lore 类型下都有一个 keyword 属性。插件将搜索此关键词（根据类型，可能还需要配合 + 或 % 等符号）。

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

我可以在 Lore 中堆叠多个属性或添加其他文字吗？

可以，但是：插件会搜索整个 Lore 来寻找上述特定字符串，但每种类型只应用第一个找到的属性。

• 示例 1（生效）：

- `+50 Health`

- `+2 Armor`

- 效果：应用 +50 生命值和 +2 护甲。

• 示例 2（不叠加）：

- `+50 Health`

- `+500 Health`

- 效果：只应用 +50 生命值（第一个）。

权限是如何工作的？

权限主要动态用于上述的物品限制系统。除此之外，本插件没有其他使用限制——任何能够使用带有 Lore 物品的玩家，都会获得该 Lore 的属性加成。

⭐命令与权限

命令

• 主命令：/loreattributesrecoded 或 /lar 或 /la
• 添加宝石槽：/lar gems addslot

权限节点摘要

• loreattributes.mod.* - 所有修改权限（OP 默认）
• loreattributes.reload - 重载插件配置（OP 默认）
• lores.admin - 所有 Lore 管理权限（OP 默认）
• lores.color. 与 lores.format. - 允许在 Lore 中使用特定颜色或格式代码
• loreattributes.<自定义类型> - 动态生成的物品使用权限（如 loreattributes.thief）

详细的权限树请参考插件文档中的 Permissions 部分。