插件变量

LyCamp 可通过 PlaceholderAPI 注册变量标识符 lyzy。变量格式为 %lyzy_变量名%。

PlaceholderAPI 未安装或未正常启动时，LyCamp 不会注册这些变量。变量读取依赖玩家数据已经加载；玩家数据尚未加载时，变量返回空文本。

数据存储

如果启用 MySQL 存储，必须安装 LyMySQLCore，并且 LyMySQLCore 已成功连接数据库后，玩家数据加载与保存相关功能才会生效。数据库未连接时，玩家无法正常进入服务器完成 LyCamp 初始化。

变量列表

变量	返回内容	说明
`%lyzy_camp%`	当前阵营名称；无阵营时返回 `placeholder.no-camp`	玩家当前加入的阵营
`%lyzy_tag%`	当前称号；无阵营、阵营不存在或累计声望未命中称号区间时返回 `placeholder.no-tag`	根据玩家累计声望匹配当前阵营的称号区间
`%lyzy_max_cumulative_prestige%`	数字	当前阵营配置中的累计声望上限；无阵营或阵营不存在时返回 `0`
`%lyzy_cumulative_prestige%`	数字	玩家累计声望；无阵营或阵营不存在时返回 `0`
`%lyzy_now_prestige%`	数字	玩家当前可用声望；无阵营或阵营不存在时返回 `0`
`%lyzy_today_prestige%`	数字	玩家今日剩余可获得的声望；无阵营或阵营不存在时返回 `0`
`%lyzy_max_today_prestige%`	数字	玩家今日可获得的声望上限；无阵营或阵营不存在时返回 `0`
`%lyzy_first_kill%`	`placeholder.has-first-kill` 或 `placeholder.not-first-kill` 对应的文本	今日首杀状态

未注册的变量名不会返回空文本，而是返回红色错误文本 §c错误。

%lyzy_camp% 直接返回玩家当前阵营的配置名称。玩家退出阵营后，返回 placeholder.no-camp 配置的文本。

%lyzy_tag% 根据玩家的累计声望，在当前阵营的 prestige 区间中匹配称号。例如，累计声望必须同时满足区间的最小值和最大值，才会返回该区间的 tag。

玩家退出阵营时，当前声望、累计声望和今日声望都会清零，因此相关变量会按无阵营状态返回。

每日声望上限默认按 1000 点计算。阵营配置中的 every-day-max-get-prestage-value 可以使用 default 和权限节点分别设置上限，变量会返回玩家可匹配到的最高上限。

%lyzy_first_kill% 根据玩家的最近一次首杀时间判断当前日期是否已经完成首杀：

判断日期使用服务器默认时区。

以下配置位于插件 config.yml 的 placeholder 节点：

yaml

placeholder:
  no-camp: '&7无阵营'
  no-tag: '&7无称号'
  has-first-kill: '&a今日首杀未完成'
  not-first-kill: '&c今日首杀已完成'

配置中的 & 颜色代码会转换为 Minecraft 颜色代码后返回。

修改配置后，可由管理员执行 /lyzy reload 重载插件配置和变量设置。

变量读取的是玩家当前已加载的数据。LyCamp 保存以下与变量相关的玩家数据：

未加载玩家数据时，所有变量请求都会返回空文本。玩家数据正常加载后，变量才会返回对应内容。

配置节点	作用
`placeholder.no-camp`	无阵营时的返回文本
`placeholder.no-tag`	无称号时的返回文本
`placeholder.has-first-kill`	今日首杀未完成时的返回文本
`placeholder.not-first-kill`	今日首杀已完成时的返回文本
`camp.<阵营>.prestige`	累计声望区间、称号和称号属性
`camp.<阵营>.every-day-max-get-prestage-value`	每日可获得声望上限及权限上限