Skip to content

插件变量

LyLookAt 通过 PlaceholderAPI 提供变量,变量标识符为 lla。这些变量用于读取当前 LyLookAt 界面正在查看的目标玩家。

前置要求

变量功能依赖 PlaceholderAPI。PlaceholderAPI 未安装、未启用,或 lla 扩展注册失败时,LyLookAt 变量不会生效。

插件注册的内部变量扩展会在 PlaceholderAPI 重载后保留,无需单独下载对应的变量扩展。

变量列表

变量说明
%lla_lookat_name%返回当前被查看目标玩家的名称。
%lla_lookat_变量名%以目标玩家作为解析对象,读取指定的 PlaceholderAPI 变量。

目标玩家变量

%lla_lookat_变量名% 会移除 lla_lookat_ 前缀,将剩余内容重新组成一个 PlaceholderAPI 变量,再以当前目标玩家的身份解析。

例如:

text
%lla_lookat_player_level%

实际读取的是目标玩家的:

text
%player_level%

因此,若服务器中存在以下 PlaceholderAPI 变量:

text
%player_name%
%player_level%

则可以通过 LyLookAt 读取当前目标玩家的数据:

LyLookAt 变量实际解析的目标变量
%lla_lookat_player_name%%player_name%
%lla_lookat_player_level%%player_level%

可用的具体变量取决于服务器已安装的插件及 PlaceholderAPI 扩展。LyLookAt 只负责将变量解析对象切换为当前被查看的目标玩家,不会自行提供 player_level 等外部变量。

变量作用范围

LyLookAt 会在玩家打开查看界面时记录以下信息:

  • 查看界面的玩家。
  • 当前被查看的目标玩家。
  • 当前打开的界面配置。

lla 变量依赖这份界面状态。玩家关闭 LyLookAt 界面后,对应状态会被移除,此时变量没有可读取的目标玩家。

出现以下情况时,变量返回空文本:

  • 变量解析时没有玩家上下文。
  • 当前玩家没有有效的 LyLookAt 查看状态。
  • LyLookAt 无法确定当前正在查看的目标玩家。

如果使用了 lookat_namelookat_ 之外的未知变量名称,插件会返回红色的“错误”文本。

在界面中的变量区别

界面标题、默认物品名称和 Lore 会直接以被查看的目标玩家作为 PlaceholderAPI 解析对象。因此,在 LyLookAt 的 GUI 配置中通常可以直接使用:

text
%player_name%
%player_level%

%lla_lookat_变量名% 更适合在其他支持 PlaceholderAPI 的位置读取当前 LyLookAt 界面的目标玩家数据。无论变量显示在何处,都必须先存在有效的 LyLookAt 查看状态。