插件变量

LyPet 通过 PlaceholderAPI 注册变量扩展，用于读取玩家当前召唤宠物的实体信息。服务器需要安装并启用 PlaceholderAPI；PlaceholderAPI 未启用时，LyPet 不会注册该扩展。

变量列表

变量	返回内容
%lycw_uuid%	当前宠物实体的 UUID
%lycw_name%	当前宠物实体的显示名称

返回规则

• 变量必须在玩家上下文中解析。
• 玩家对象为空时，变量返回空文本。
• 玩家未完成 LyPet 玩家缓存初始化时，变量返回空文本。
• 玩家没有召唤宠物时，变量返回空文本。
• 宠物实体不存在时，变量返回空文本。
• %lycw_uuid% 返回当前宠物实体的标准 UUID 文本。
• %lycw_name% 返回当前宠物实体的显示名称。
• 宠物显示名称可能包含颜色代码。
• 宠物隐藏后，宠物实体会被删除，两个变量均返回空文本。
• 未定义的 lycw 子变量返回红色错误文本 §c错误。

PlaceholderAPI 扩展信息

项目	内容
扩展标识	lycw
完整变量格式	%lycw_<变量名>%
已注册变量	uuid、name
注册条件	PlaceholderAPI 已安装并启用
是否需要单独安装扩展	不需要，由 LyPet 启动时自动注册
玩家无可用宠物时的返回值	空文本
未知变量的返回值	§c错误

变量解析示例

%lycw_uuid%
%lycw_name%

变量由 PlaceholderAPI 解析，LyPet 只读取当前玩家缓存中的宠物实体信息，不读取宠物配置文件中的 id 或 identity 作为变量返回值。