常见问题

插件支持哪些 Minecraft 版本？

配置中的 minecraft-version 只支持以下两个值：

配置值	对应版本
1.7.10	Minecraft 1.7.10
1.12.2	Minecraft 1.12.2

插件会根据该配置选择对应版本的符文数据处理实现。配置值不是 1.7.10 时，会使用 1.12.2 的实现。

如何打开符文界面？

插件注册了以下两个命令别名：

命令	说明
/lr open	玩家打开符文界面
/lyfw open	玩家打开符文界面

该功能需要插件验证完成后才会显示并生效。命令只能由玩家执行，控制台无法打开玩家界面。

为什么输入命令后没有打开界面？

按以下顺序检查：

1. 执行者是否为玩家，而不是控制台。
2. 插件是否已经完成验证。
3. 当前使用的命令是否为 /lr open 或 /lyfw open。
4. 是否使用了正确的子命令拼写。

插件验证完成前，命令帮助中不会显示打开界面的指令。

如何重载配置？

使用以下命令重载 plugins/LyRune/config.yml：

命令	执行要求
/lr reload	需要管理员权限，即执行者必须为 OP
/lyfw reload	需要管理员权限，即执行者必须为 OP

重载成功后会发送“重载成功”提示。配置重载不会改变当前已经打开的界面状态，建议关闭后重新打开界面确认显示效果。

为什么装备放进去后不能刻印？

符文界面中的装备槽只接受包含 unload-rune-lore 对应整行文本的物品。

默认配置为：

unload-rune-lore: '&6可刻印符文'

检查以下内容：

• 装备描述中是否存在完全匹配的一整行文本。
• 颜色代码是否与配置一致。
• 物品是否为单个物品，不能直接操作数量大于 1 的装备堆。
• 当前装备是否已经放入界面的装备槽。
• 目标符文槽位是否已经解锁。

装备首次被识别时，插件会移除 unload-rune-lore 对应文本，并根据 rune-lore 重新生成符文统计信息。

为什么鼠标上的物品不是符文？

符文物品必须包含 rune-item-lore 对应的整行 Lore 文本。

默认配置为：

rune-item-lore: '&7符文'

插件会逐行检查符文 Lore，并进行忽略大小写的匹配。检查以下内容：

• Lore 中是否存在单独一行 符文 标识。
• 颜色代码是否与配置一致。
• 标识是否被合并到其他文字中。
• 鼠标拿起的是否确实是符文物品，而不是普通装备或材料。

为什么点击槽位后不能解锁？

解锁下一个槽位时，插件会读取 unlock-config 中对应槽位区间的 condition。所有条件都满足后，才会扣除资源并解锁槽位。

默认配置中的条件类型如下：

条件前缀	作用	需要的前置
papi:{...}	使用 PlaceholderAPI 变量进行条件判断	PlaceholderAPI
permission:{...}	检查玩家权限	无额外插件
item:{...}	检查背包内指定名称的物品和数量	无额外插件
eco:{...}	检查并扣除经济余额	Vault 及可用的经济服务
point:{...}	检查并扣除点券	PlayerPoints

例如：

unlock-config:
  1-5:
    condition:
      - 'papi:{%player_level% > 0}'
      - 'item:{&6符文破印石#<slot>}'
      - 'eco:{ (%player_level%+<slot>) * 5 }'

常见原因包括：

• 当前槽位不在任何 unlock-config 区间内。
• papi:{...} 条件计算结果为假。
• 玩家没有 permission:{...} 指定的权限。
• 背包中没有足够数量且名称完全匹配的物品。
• Vault 没有成功连接经济服务。
• PlayerPoints 没有安装或没有正常启用。
• 条件中的变量没有被 PlaceholderAPI 替换。
• 公式或 <slot> 替换后的表达式无法计算。

当配置没有覆盖下一个槽位时，插件会将其视为无法继续解锁，而不是自动生成更高等级的槽位。

解锁条件中的 <slot> 是什么？

<slot> 表示当前正在解锁的槽位编号，从 1 开始。

它可以用于以下位置：

• show-lore 中的显示文本。
• condition 中的物品数量。
• condition 中的经济数量。
• condition 中的点券数量。
• 需要进行四则运算的表达式。

例如：

condition:
  - 'item:{&6符文破印石#<slot>}'
  - 'eco:{ (%player_level%+<slot>) * 5 }'

插件会先替换变量和槽位编号，再计算尖括号中的四则运算表达式。

为什么解锁槽位时物品没有被扣除？

插件只有在所有解锁条件检查通过后，才会扣除条件中指定的物品、金币或点券。只要任意条件不满足，解锁不会成功，也不会扣除资源。

背包物品需要满足以下要求：

• 物品具有显示名称。
• 显示名称与 item:{...} 中的名称完全匹配。
• 数量达到条件要求。

例如，下面的条件检查显示名称为 &6符文破印石 的物品：

- 'item:{&6符文破印石#<slot>}'

为什么使用 eco:{...} 后无法解锁？

eco:{...} 使用 Vault 经济服务检查余额并扣除金币。请检查：

1. Vault 是否已安装并成功连接经济插件。
2. 控制台启动信息中是否显示 Vault 已启动。
3. 玩家余额是否满足公式计算后的金额。
4. 公式中的 PlaceholderAPI 变量是否能返回数字。

仅安装 Vault 但没有可用的经济服务时，经济条件无法正常工作。

为什么使用 point:{...} 后无法解锁？

point:{...} 使用 PlayerPoints 检查玩家点券并在解锁成功后扣除点券。

请检查：

• PlayerPoints 是否已安装并启用。
• point:{...} 中的表达式是否能计算为数字。
• 玩家点券余额是否足够。

为什么符文等级限制没有生效？

符文等级限制由以下两个配置项控制：

rune-level-key: '&f符文等级'
rune-level-placeholder: '%player_level%'

插件会在符文 Lore 中查找包含 rune-level-key 的行，并从该行提取数字。例如，配置为 &f符文等级 时，符文 Lore 需要包含类似 §f符文等级 10 的文本。

检查以下内容：

• rune-level-key 是否能匹配符文 Lore。
• 匹配行中是否包含等级数字。
• rune-level-placeholder 是否返回有效数字。
• PlaceholderAPI 是否已安装并启用。
• 玩家等级是否达到符文要求。

如果 rune-level-key 为空字符串，插件不会启用符文等级检查。

为什么符文属性没有汇总？

属性汇总由 statistics-lore-key 控制。插件会检查已刻印符文的 Lore：只要某一行包含配置中的关键词，就会从该行提取数字并进行累加。

默认配置示例：

statistics-lore-key:
  '物理伤害': '&f物理伤害 +{value}'

检查以下内容：

• 符文属性行是否包含 statistics-lore-key 中的关键词。
• 属性数字是否出现在匹配行中。
• 关键词是否配置在 statistics-lore-key 下，而不是配置在其他位置。
• 符文是否已经成功刻印到装备上。

插件只会提取匹配行中的第一个数字。没有数字的匹配行不会计入统计。汇总结果会按 0.00 格式显示。

为什么装备 Lore 中没有显示已刻印符文？

已刻印符文列表由以下配置控制：

enable-show-slot: true
show-slot-format: '&7已刻印 >> &6{rune}'

检查：

• enable-show-slot 是否为 true。
• rune-lore 中是否包含 {show_slot}。
• 装备上是否确实存在已经刻印的符文。

只有在 rune-lore 中配置 {show_slot}，并且 enable-show-slot 为 true 时，插件才会将已刻印符文名称写入装备 Lore。

为什么装备上的符文数量显示不正确？

符文数量显示由 rune-lore 中的 {now} 和 {max} 占位符生成：

rune-lore:
  - '&6已刻印 &a{now}/{max} &6个符文'
  - '&6符文属性统计:'
  - '{attribute}'

其中：

占位符	含义
{now}	当前已经刻印的符文数量
{max}	当前装备已解锁的槽位数量
{attribute}	根据 statistics-lore-key 汇总后的属性
{show_slot}	根据 show-slot-format 生成的已刻印符文列表

修改 rune-lore 时，不要删除插件用于识别动态 Lore 的内部标记，否则后续刷新、刻印或拆卸时可能无法正确替换动态内容。

拆卸符文为什么无法操作？

拆卸功能由以下配置控制：

disassemble-need-item-enable: true
disassemble-item-name: '&6符文蜕印石'

当 disassemble-need-item-enable 为 true 时，鼠标上必须拿着名称与 disassemble-item-name 完全匹配的拆卸道具。

检查以下内容：

• 目标槽位中是否存在已经刻印的符文。
• 鼠标上是否拿着拆卸道具。
• 拆卸道具显示名称和颜色是否完全匹配。
• 配置中的 disassemble-need-item-enable 是否开启。

拆卸道具名称使用物品显示名称判断，不是根据物品材质判断。

拆卸符文为什么没有返还？

拆卸是否返还原符文由 disassemble-return-rune 控制：

disassemble-return-rune: true

配置值	结果
true	拆卸成功后将符文放回玩家背包
false	拆卸成功后不返还符文物品

当 disassemble-need-item-enable 为 true 时，拆卸成功后还会消耗鼠标上的一个拆卸道具。

为什么拆卸时提示需要拆卸工具？

当目标槽位有符文、disassemble-need-item-enable 为 true，并且鼠标为空时，插件会提示需要拆卸工具。

请使用显示名称与以下配置完全匹配的物品：

disassemble-item-name: '&6符文蜕印石'

如果鼠标上拿着其他物品，插件会判断该物品不是拆卸工具。

为什么关闭界面后装备没有留在界面中？

关闭符文界面时，插件会自动将装备槽中的物品放回玩家背包。装备位于界面中的第 4 号槽位，关闭界面后会被取出并加入背包。

如果玩家背包空间不足，建议在关闭界面前确认背包有空位。

为什么界面中的槽位无法拖动或 shift 点击？

插件会限制符文界面的库存操作：

• 拖动物品会被取消。
• shift 点击会被取消。
• 除装备槽和符文槽外的界面区域不能直接操作。
• 未解锁的槽位不能直接放入符文。

请使用鼠标拿起装备、符文或拆卸工具，再点击对应位置进行操作。

为什么上一页或下一页按钮没有反应？

界面每页显示 27 个符文槽位。只有在装备已经被识别，并且存在对应的槽位数据时，分页按钮才会切换页面。

检查以下内容：

• 装备是否包含 unload-rune-lore 对应整行文本。
• 装备是否已经放入界面装备槽。
• 是否已经解锁足够多的槽位。
• unlock-config 是否配置了后续槽位区间。

没有后续槽位或没有对应解锁配置时，下一页不会继续生成可用槽位。

为什么启动时显示前置未启动？

插件会在启动时检查以下插件：

插件	主要用途
ProtocolLib	物品数据序列化与读取
PlayerPoints	point:{...} 点券条件
Vault	eco:{...} 经济条件
PlaceholderAPI	变量替换、等级限制和 papi:{...} 条件

这些插件在 plugin.yml 中声明为软依赖。未安装时，插件本体可能仍会启动，但使用对应功能时需要安装并成功启用相关前置。

为什么修改配置后效果没有变化？

请确认修改的是插件实际读取的文件：

plugins/LyRune/config.yml

然后使用以下任一命令重载：

/lr reload
/lyfw reload

执行重载需要 OP。涉及界面标题、按钮、槽位显示或装备 Lore 的配置，建议重载后关闭并重新打开符文界面确认。