符文 LyRune

LyRune 是一个为装备增加符文刻印玩法的 Minecraft 插件。装备需要带有指定识别 Lore，玩家可以在符文界面中放入装备，解锁符文槽位，再将符合条件的符文刻印到装备上。

符文刻印后，符文会写入装备数据，并根据配置统计符文 Lore 中的属性数值；装备 Lore 还可以显示已刻印符文数量、最大槽位、符文名称和属性统计结果。

插件信息

项目	内容
插件名	LyRune
插件版本	1.0.8
作者	Liyuan
配置支持版本	1.7.10、1.12.2
配置文件	config.yml

依赖

插件在 plugin.yml 中声明了以下软依赖：

依赖	用途
ProtocolLib	符文物品序列化与读取
PlayerPoints	槽位解锁中的点券条件与扣除
Vault	槽位解锁中的金币条件与扣除
PlaceholderAPI	槽位条件、Lore 和符文等级变量解析

软依赖未启动时，插件仍会尝试加载，但对应功能可能无法正常使用。使用金币条件必须确保 Vault 已连接经济插件；使用点券条件必须确保 PlayerPoints 已启动；使用 PlaceholderAPI 变量或条件必须确保 PlaceholderAPI 已启动。

玩法

1. 为装备添加配置中的装备识别 Lore，使其成为可刻印装备。
2. 通过 /lr open 或 /lyfw open 打开符文刻印界面。
3. 将可刻印装备放入界面中央的装备槽位。
4. 点击未解锁的符文槽位，按照界面显示的条件解锁槽位。
5. 手持符合识别条件的符文，点击已解锁的空槽位进行刻印。
6. 如需拆卸符文，手持配置中的拆卸工具点击已刻印槽位；是否返还符文由配置决定。

符文刻印和拆卸会同步更新装备 Lore 中的槽位数量、符文名称和属性统计内容。关闭界面时，装备槽位中的装备会返回玩家背包。

功能

功能	说明
装备识别	装备包含指定整行 Lore 后，才会被识别为可刻印装备。
符文识别	符文包含指定整行 Lore 后，才会被识别为可刻印符文。
符文刻印	手持符文点击已解锁的空槽位，将符文写入装备并扣除手中的一个符文。
槽位解锁	支持按槽位区间设置解锁条件、显示 Lore 和消耗内容。
条件判断	支持 PlaceholderAPI 条件、权限、背包物品、点券和金币条件。
动态计算	条件中的 <slot> 和尖括号表达式可以参与数值计算，支持加、减、乘、除和括号。
符文拆卸	可设置是否必须手持指定拆卸工具，并可设置是否返还被拆卸的符文。
属性统计	从已刻印符文的 Lore 中查找指定关键词并累计数值，生成装备属性统计 Lore。
等级限制	符文 Lore 包含等级关键词时，可以通过 PlaceholderAPI 变量判断玩家等级是否满足要求。
多页槽位	界面每页显示 27 个符文槽位，并提供上一页和下一页按钮。
版本适配	根据 minecraft-version 选择 1.7.10 或 1.12.2 的物品数据处理实现。

界面行为

符文界面为 54 格容器，主要区域如下：

区域	作用
中央装备槽位	放置待刻印装备。
第 3 至第 5 行	显示当前页面的符文槽位、已刻印符文和待解锁槽位。
左下角按钮	返回上一页。
右下角按钮	进入下一页。
其他填充区域	使用配置中的填充物品和边框物品进行装饰或阻挡操作。

界面会阻止拖动物品、Shift 点击和未处理的容器操作。关闭界面时，中央装备槽位中的装备会返回玩家背包。

指令

主命令：/lr、/lyfw

指令	说明	使用限制
/lr	显示当前可用的插件指令提示。	仅管理员身份可查看帮助。
/lr reload	重载 config.yml。	仅管理员身份可执行。
/lr open	打开符文刻印界面。	需要由玩家执行；完整界面指令在插件验证完成后提供。
/lyfw	显示当前可用的插件指令提示。	仅管理员身份可查看帮助。
/lyfw reload	重载 config.yml。	仅管理员身份可执行。
/lyfw open	打开符文刻印界面。	需要由玩家执行；完整界面指令在插件验证完成后提供。

插件项目只在 plugin.yml 中声明了 lr 和 lyfw 两个命令，没有声明独立的权限节点。重载和帮助判断使用的是管理员身份检查。

数据与 Lore

插件会将符文槽位上限和已刻印符文写入装备数据中：

• 槽位上限使用 LyRuneSlotMax 保存。
• 已刻印符文使用 LyRune 保存，并按槽位编号记录。
• 装备首次识别时，会根据 unload-rune-lore 判断是否可以开始刻印。
• 刻印、解锁或拆卸后，会重新生成配置中的 rune-lore 内容。
• 生成的内部标记会被用于识别和更新统计 Lore，不建议随意修改相关标记文本。

配置与规则

页面	内容
配置说明	config.yml 的基础字段、界面、消息、Lore 和解锁配置。
符文规则	装备识别、符文识别、槽位解锁、条件类型、拆卸和属性统计规则。
常见问题	依赖、配置和界面操作相关的排查说明。
更新日志	文档更新记录。