插件变量

LyMappingReload 通过 PlaceholderAPI 注册变量扩展，变量标识符为 lmr。需要安装并启用 PlaceholderAPI；PlaceholderAPI 未启用时，LyMappingReload 不会注册这些变量。

变量列表

变量	返回内容
%lmr_check-检测id:行数%	读取指定映射检测计算结果中的一行属性
%lmr_group-属性包id:行数%	读取指定属性包计算结果中的一行属性

行数从 1 开始。变量返回的是对应属性配置计算后的文本结果，不是原始公式。

映射检测变量

%lmr_check-检测id:行数%

其中：

参数	说明
检测id	check 配置下的检测节点名称，必须与配置中的检测 ID 完全对应
行数	要读取的属性行，从 1 开始

映射检测变量会根据玩家当前状态重新计算对应映射的属性内容，计算时会使用该检测节点的配置，包括：

• condition 条件是否满足。
• check-slot 指定的检测槽位；未配置时使用全局 plugin-slot。
• lore-get-placeholder 从物品 Lore 提取的数值变量。
• attribute 属性公式和其中的 PlaceholderAPI 变量。
• value-number 对计算结果的取整设置。
• eval-max-tag 对公式上限分隔符的设置。

示例：

%lmr_check-内裤1:1%

该变量读取 check.内裤1.attribute 计算结果的第 1 行。

属性包变量

%lmr_group-属性包id:行数%

其中：

参数	说明
属性包id	attribute-group 配置下的属性包名称，必须与配置中的属性包 ID 完全对应
行数	要读取的属性行，从 1 开始

属性包变量会根据玩家当前已添加的属性包数据计算。属性包必须已经通过 /lmr add 添加给玩家，并且尚未超过配置的持续时间；属性包过期后，该变量不再返回对应属性内容。

示例：

%lmr_group-属性包1:1%

该变量读取 attribute-group.属性包1.attribute 计算结果的第 1 行。

返回规则

情况	返回内容
检测 ID 或属性包 ID 不存在	空文本
行数小于 1	空文本
行数超过计算结果总行数	空文本
玩家对象为空	空文本
行数有效且节点存在	对应计算结果文本

变量中的 行数 对应配置中属性列表的计算结果顺序。映射检测启用多层堆叠时，计算出的属性行可能会按堆叠层数重复，因此应根据实际配置结果读取对应行。

计算结果说明

属性公式中的 PlaceholderAPI 变量会在计算时替换。例如：

attribute:
  - '攻击力: eval:{%player_level%*<v.变量>:10}'

如果配置了 Lore 数值提取变量，<v.变量> 会先替换为从指定槽位物品 Lore 中读取的数值；eval:{...} 计算完成后，变量返回最终属性文本。

属性公式使用 +、-、*、/ 和括号进行数值计算，并支持通过 eval-max-tag 配置的分隔符限制结果上限。value-number 为 true 时，计算结果按整数返回；否则按两位小数格式返回。

使用前提

• 必须安装并启用 PlaceholderAPI。
• %lmr_check-检测id:行数% 只能读取已加载的 check 映射检测节点。
• %lmr_group-属性包id:行数% 只能读取已加载的 attribute-group 属性包节点。
• 配置文件重载后，变量读取新的映射检测和属性包配置。