离渊系列插件Wiki

插件变量 ​

LyArmourersWardrobe 的 PlaceholderAPI 变量标识为 law。安装并启用 PlaceholderAPI 后，变量会由插件自动注册，可用于 DragonCore、计分板、菜单、聊天文本以及其他支持 PlaceholderAPI 的插件。

所有变量都需要指定一名已加载 LyArmourersWardrobe 数据的玩家。玩家数据不存在或变量没有玩家上下文时，插件返回空文本。

状态变量 ​

变量返回值说明
%law_status_时装ID%已拥有、未拥有、剩余秒数查询玩家是否拥有指定时装。永久拥有返回 已拥有，未拥有返回 未拥有，正在试穿返回剩余时间，例如 45秒。

时装ID 是 plugins/LyArmourersWardrobe/armourers 目录内注册的时装顶层键，同时也是 DragonArmourers 中的时装 ID。

试穿时间已经结束但尚未完成到期清理时，该变量可能短暂返回 0秒。试穿到期后，时装会从玩家拥有列表和相关预设中移除。

拥有数量 ​

变量返回值说明
%law_owned_类型%整数玩家永久拥有的指定类型时装数量。
%law_owned_all%整数玩家永久拥有的全部时装数量。

拥有数量只统计永久时装，不统计正在试穿的限时时装。指定类型的时装还必须存在于当前已注册的时装配置中，才能计入数量。

时装总数 ​

变量返回值说明
%law_total_类型%整数当前已注册的指定类型时装总数。
%law_total_all%整数当前已注册的全部时装总数。

总数取自插件已经载入的时装配置，与玩家是否拥有这些时装无关。无法被 DragonArmourers 识别类型或注册失败的时装不会计入总数。

当前穿戴 ​

变量返回值说明
%law_id_类型%时装 ID 或空文本返回玩家当前时装预设中，指定类型槽位记录的时装 ID。没有穿戴或类型无效时返回空文本。
%law_name_类型%时装名称或空文本返回玩家当前时装预设中，指定类型时装的配置名称。没有穿戴、类型无效或时装未注册时返回空文本。
%law_hide_类型%true、false 或空文本返回当前时装预设中指定类型的隐藏状态。类型无效时返回空文本。

当前穿戴变量读取玩家正在使用的时装预设。插件内置 5 个预设，切换预设后，这些变量会读取新预设保存的穿戴与隐藏状态。

%law_id_类型% 和 %law_name_类型% 返回的是预设槽位记录，不会因为该部位被隐藏而变为空文本。需要判断实际隐藏状态时，应同时读取 %law_hide_类型%。

类型参数 ​

变量中的 类型 可替换为以下值：

类型部位可用于拥有数量可用于时装总数可用于当前穿戴与隐藏
sword武器是是是
bow弓箭是是是
outfit套装是是是
wings翅膀是是是
head帽子是是是
chest上衣是是是
legs裤子是是是
feet鞋子是是是
all全部类型仅 %law_owned_all%仅 %law_total_all%否

类型参数不区分大小写，但建议统一使用表格中的小写值。类型显示名称可以通过 config.yml 的 display-type 配置修改，不会改变变量中使用的英文类型参数。

返回规则 ​

情况返回结果
没有玩家上下文空文本
玩家数据尚未载入空文本
%law_status_时装ID% 查询永久时装已拥有
%law_status_时装ID% 查询试穿时装剩余秒数，例如 45秒
%law_status_时装ID% 查询未拥有时装未拥有
%law_owned_无效类型%0
%law_total_无效类型%0
%law_id_无效类型%空文本
%law_name_无效类型%空文本
%law_hide_无效类型%空文本
使用了未支持的 law 变量§c错误

变量示例 ​

变量可能返回含义
%law_status_离渊时装示例%已拥有玩家永久拥有该时装。
%law_status_离渊时装示例%38秒玩家正在试穿该时装，剩余约 38 秒。
%law_status_离渊时装示例%未拥有玩家没有永久拥有或试穿该时装。
%law_owned_all%12玩家永久拥有 12 件时装。
%law_owned_wings%2玩家永久拥有 2 件翅膀时装。
%law_total_wings%5插件当前注册了 5 件翅膀时装。
%law_id_head%离渊时装示例当前预设的头部槽位记录了该时装 ID。
%law_name_head%§6离渊时装示例当前头部时装的配置名称，可能包含颜色代码。
%law_hide_wings%false当前预设没有隐藏翅膀部位。

注意事项 ​

  • PlaceholderAPI 是变量功能的可选前置。未安装或未启用 PlaceholderAPI 时，LyArmourersWardrobe 不会注册 law 变量。
  • 玩家必须已经完成 LyArmourersWardrobe 数据加载，否则变量返回空文本。服务器或数据库尚未初始化完成时，不应依赖变量结果。
  • %law_owned_类型% 与 %law_owned_all% 只统计永久拥有的时装，试穿时装不计入收集数量。
  • %law_total_类型% 与 %law_total_all% 统计当前成功注册的时装。修改时装文件后，需要重载插件才能刷新注册数据。
  • %law_name_类型% 返回时装配置中的 name，其中 & 颜色代码会在载入时转换为 §。
  • %law_hide_类型% 表示当前预设保存的隐藏状态，不表示该类型是否已穿戴时装。即使槽位为空，也可能返回 true。
  • 数据使用 MySQL 存储时，必须安装 LyMySQLCore，并确保数据库成功连接后，玩家数据及相关变量功能才能正常生效。数据库未连接完成时，插件会阻止玩家进入服务器。