插件变量

LyCard 的 PlaceholderAPI 变量标识为 lykp。安装并启用 PlaceholderAPI 后，才能解析以下变量。

这些变量会根据当前解析变量的玩家读取卡牌收集数据，可用于卡牌介绍、共鸣介绍、菜单文本、公告指令以及其它支持 PlaceholderAPI 的位置。

卡牌收集状态

变量	返回内容
`%lykp_state:<卡牌id>%`	玩家拥有指定卡牌时返回 `status-format-collect` 的配置内容；未拥有时返回 `status-format-not-collect` 的配置内容。

参数	说明
`卡牌id`	卡组配置中 `card` 节点下的卡牌 ID，例如 `朱雀`、`白虎`、`青龙`、`玄武`。

示例：

text

%lykp_state:朱雀%

默认配置中的返回内容为：

yaml

status-format-collect: '&a√'
status-format-not-collect: '&c×'

实际显示颜色会按照 Minecraft 颜色代码解析为游戏内颜色。

变量	返回内容
`%lykp_resonance:<卡组id>:<共鸣id>%`	指定卡组内的指定共鸣所需卡牌全部收集时返回 `1`，否则返回 `0`。

参数	说明
`卡组id`	卡组配置顶层的 `id`，例如 `四圣`。
`共鸣id`	卡组 `resonance` 节点下的共鸣节点名，例如 `水火双圣`、`龙争虎斗`。

示例：

text

%lykp_resonance:四圣:水火双圣%

在 四圣 卡组中，水火双圣 需要同时收集 朱雀 和 玄武，两张卡牌都已收集时返回 1，缺少任意一张时返回 0。

卡牌收集状态变量不会直接固定返回 √ 或 ×，而是读取插件配置中的以下键：

配置键	用途	默认值
`status-format-collect`	玩家已收集卡牌时的显示内容	`&a√`
`status-format-not-collect`	玩家未收集卡牌时的显示内容	`&c×`

示例：

yaml

status-format-collect: '&a√'
status-format-not-collect: '&c×'

修改配置后，需要通过插件重载使新的显示内容生效。

变量读取的是 LyCard 当前加载的玩家卡牌数据。玩家数据可以使用本地 YAML 文件保存，也可以根据 mysql.enable 配置切换为 MySQL 存储。

启用 MySQL 存储时，必须安装 LyMySQLCore，并确保数据库连接成功；否则玩家数据无法正常加载，相关卡牌收集状态和共鸣状态功能不会正常生效。