ItemsLore是一款功能强大的Minecraft Bukkit/Spigot服务器插件，可以自动为物品添加丰富多彩的Lore信息。通过该插件，玩家可以轻松查看物品的耐久度、获取时间、获取者和来源等信息，增强游戏体验。
物品可能同时匹配多个Lore池，具体匹配逻辑如下：
- 首先会加载
ALL池（如果存在），这是所有物品通用的基础池 - 然后，根据物品类型加载特定池：
- 根据物品材质名称匹配，例如
NETHERITE_SWORD会匹配NETHERITE池 - 根据物品类型函数匹配，例如武器会匹配
WEAPON池，工具会匹配TOOL池
- 根据物品材质名称匹配，例如
例如对于下界合金剑，会依次加载以下Lore池：
ALL- 通用属性NETHERITE- 下界合金特有属性WEAPON- 武器类特有属性
这种设计允许物品拥有更丰富的属性组合，属性越特殊的物品可以获得更多样化的描述。
- 自动添加Lore: 当玩家获取物品时自动添加各种实用信息
- 耐久度显示: 显示物品当前耐久和最大耐久，并使用动态颜色直观展示
- 时间记录: 记录物品获取的具体时间
- 来源追踪: 记录物品的来源（例如合成、挖掘、击杀等）
- 随机属性: 根据物品类型随机生成特殊属性描述，支持权重和唯一性
- 模板系统: 通过灵活的模板系统自定义不同类型物品的Lore格式
- 权限控制: 详细的权限设置，确保功能安全可控
- 完整的命令: 提供丰富的命令和Tab补全支持
- 变量支持: 在Lore中支持使用变量，如玩家名称、时间、物品材质等
- 概率系统: 精细控制随机Lore的生成概率
- MythicMobs支持: 支持显示自定义怪物的名称作为物品来源
- Lore处理模式: 可配置已有Lore的处理方式（追加/覆盖/忽略）
- 多种监听事件: 支持多种物品获取方式，包括怪物掉落、附魔、铁砧等
- 指定玩家添加: 管理员可通过命令为指定玩家的物品添加Lore
该插件提供了高度可定制的配置选项：
- 自定义Lore模板，支持不同物品类型使用不同模板
- 完全可自定义的分隔线样式和信息格式
- 随机Lore池可根据物品类型进行配置
- 支持自定义符号和颜色
- 每种物品类型可设置不同的随机Lore生成概率
- 唯一性Lore确保特定类型的描述不会重复出现
- 可配置已有Lore的处理模式（追加/覆盖/忽略）
- 从发布页面下载最新版本的插件JAR文件
- 将下载的JAR文件放入服务器的
plugins文件夹中 - 重启服务器或使用插件管理器加载插件
- 插件将自动创建配置文件，您可以根据需要进行自定义
/itemslore reload- 重新加载插件配置/itemslore clear- 清除手中物品的所有Lore/itemslore random- 为手中物品添加随机Lore/itemslore template list- 查看所有可用模板/itemslore template info <模板名>- 查看指定模板的详细信息/itemslore template apply <模板名>- 将指定模板应用到手中物品/itemslore mode- 查看当前Lore处理模式/itemslore mode <APPEND|OVERWRITE|IGNORE>- 设置Lore处理模式/itemslore give <玩家名> [来源]- 给指定玩家的手持物品添加随机Lore/itemslore help- 显示帮助信息
itemslore.use- 允许使用基本命令（默认所有玩家）itemslore.reload- 允许重载插件配置（默认OP）itemslore.clear- 允许清除物品Loreitemslore.random- 允许应用随机Loreitemslore.template- 允许使用模板相关命令itemslore.mode- 允许查看和设置Lore处理模式itemslore.give- 允许给指定玩家的手持物品添加随机Lore
插件支持三种处理已有Lore的模式：
APPEND- 在已有Lore后添加新的Lore（默认）OVERWRITE- 覆盖已有LoreIGNORE- 忽略已有Lore的物品（不处理）
随机Lore支持多种配置方式：
-
基础格式：
["文本内容", 权重]- 例如：
["&8⚔ &c锋利:&r &f锋利无比，可轻易切断钢铁", 5] - 权重越高，该Lore被选中的概率越大
- 例如：
-
唯一性Lore：
["文本内容", 权重, true]或["UNIQUE:文本内容", 权重]- 例如：
["UNIQUE:&8⚔ &c命运:&r &f在%ilore_player%手中有着非凡力量", 2] - 唯一性Lore确保同一类型的描述在一个物品上只会出现一次
- 例如：
-
固定Lore：
["文本内容", 权重, 唯一性, true]或["FIXED:文本内容", 权重]- 例如：
["FIXED:&8✧ &e品质评级:&r &f传说装备", 1] - 固定Lore总是会出现，不受概率和数量限制影响
- 例如：
-
变量支持：Lore文本中可使用变量
- 例如：
"&8✧ &e传说:&r &f这件物品在%ilore_player%手中逐渐展现其力量" - 支持的变量包括：
%ilore_player%,%ilore_time%,%material_name%等
- 例如：
ItemsLore通过预设的变量前缀设计，避免与其他插件产生变量冲突。同时支持以下插件的集成：
- PlaceholderAPI - 支持使用各种变量
- Vault - 支持经济相关信息
- MMOItems - 支持MMOItems物品属性
- MythicMobs - 支持显示自定义怪物名称作为来源
- Multiverse-Core - 支持多世界信息
# 已有Lore的物品处理方式
existing-lore:
# 处理模式：APPEND(追加) / OVERWRITE(覆盖) / IGNORE(忽略)
mode: "APPEND"
# 是否在添加新Lore前添加分隔线（仅在APPEND模式下生效）
add-separator: true
# 分隔线样式
separator-style: "&8&m· · · · · · · · · · · · · · · · · · · ·"
# 自定义Lore模板示例
templates:
weapon:
enabled: true
item-types:
- "SWORD"
- "BOW"
content:
- "%ilore_top_separator%"
- ""
- "&c&l⚔ 武器属性"
- "%ilore_durability%"
- ""
- "&8[ &c随机武器特性 &8]"
- "%ilore_random_lore%"
- ""
- "%ilore_info_separator%"
- ""
- "%ilore_time%"
- "%ilore_player%"
- "%ilore_source%"
- ""
- "%ilore_bottom_separator%"
# 随机Lore配置示例
random-lore:
enabled: true
amount:
min: 1
max: 3
# 固定Lore是否计入随机Lore数量
fixed-count-as-random: false
# 唯一Lore是否计入随机数量
unique-count-as-random: true
chances:
global: 100
types:
WEAPON: 80
NETHERITE: 95
pools:
WEAPON:
- ["&8⚔ &c锋利:&r &f锋利无比，可轻易切断钢铁", 5]
- ["UNIQUE:&8⚔ &c命运:&r &f在%ilore_player%得到它的那一刻，命运之轮开始转动", 2]
NETHERITE:
- ["FIXED:&8🔥 &d材质类型:&r &f下界合金制品", 1.0]
- ["&8🔥 &d炽热:&r &f触碰时能感受到来自下界的温度", 0.3]当装备一个下界合金剑时，可能会显示如下信息：
⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤
⚔ 武器属性
❖ 耐久: 2031/2032
🔥 材质类型: 下界合金制品
⚔ 锋利: 锋利无比，可轻易切断钢铁
🔥 炽热: 触碰时能感受到来自下界的温度
⚔ 命运: 在xiaoyue得到它的那一刻，命运之轮开始转动
· · · · · · · · · · · · · · · · · · · ·
◈ 获取时间: 2023-05-20 18:49
✦ 获取者: xiaoyue
✧ 来源: 击杀 末影龙
⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤⏤
- 添加物品Lore处理模式（追加/覆盖/忽略）
- 增加MythicMobs自定义怪物名称支持
- 添加更多物品监听事件（附魔、经验修补等）
- 新增指令：给指定玩家的物品添加Lore
- 优化物品来源识别逻辑
- 改进随机Lore池的加载机制
- 添加唯一性Lore支持
- 优化随机Lore的变量处理
- 改进权重系统，使Lore随机更加合理
- 为随机Lore添加类别识别，避免同类型重复
- 优化随机lore数量算法逻辑
- 初始版本发布
- 添加基本物品信息功能
- 实现模板系统
- 添加随机Lore生成功能
如果您在使用过程中遇到任何问题，可以通过以下方式联系我们：
- 在GitHub上提交Issue
- 加入我们的QQ群: 123456789
本项目采用 MIT 许可证 发布。
感谢使用 ItemsLore 插件！希望它能为您的服务器增添乐趣和便利。