离渊系列插件Wiki

插件变量 ​

LyLootsWareHouse 提供 PlaceholderAPI 变量，可读取玩家的战利品数量、当前仓库和当前页数。

使用本页变量前，服务器必须安装并正常启用 PlaceholderAPI。插件检测到 PlaceholderAPI 后会自动注册变量扩展，变量标识符为 llwh，无需单独下载扩展。

变量列表 ​

变量返回内容
%llwh_物品id%玩家拥有的指定战利品数量
%llwh_file%玩家当前打开的仓库页数
%llwh_warehouse%玩家当前打开的仓库 ID
%llwh_slot_amount:仓库id:槽位id%指定仓库中指定顺序位置对应物品的数量
%llwh_now_amount:槽位id%当前仓库、当前页面中指定展示槽位对应物品的数量

指定物品数量 ​

格式：

text
%llwh_物品id%

将 物品id 替换为 config.yml 中 warehouse.仓库ID.item 列表内已经成功加载的物品 ID。

用法返回内容
%llwh_材料1%玩家拥有的 材料1 数量
%llwh_材料2%玩家拥有的 材料2 数量

物品 ID 必须与仓库配置中的内容完全一致。玩家没有该物品时返回 0。

当前仓库状态 ​

变量玩家已打开仓库时玩家未打开仓库时
%llwh_file%返回当前页数，从 1 开始返回 1
%llwh_warehouse%返回当前仓库的配置 ID返回空字符串

关闭仓库界面后，当前页数状态会被清除。%llwh_warehouse% 仅适合在玩家正在使用仓库界面时读取。

指定仓库槽位数量 ​

格式：

text
%llwh_slot_amount:仓库id:槽位id%

该变量按照指定仓库 item 列表的加载顺序查找物品，再返回玩家拥有的数量。

参数说明
仓库idwarehouse 下的仓库配置键
槽位id物品在该仓库完整物品列表中的顺序编号，从 0 开始

例如以下配置：

yaml
warehouse:
  分页1:
    item:
      - '材料1'
      - '材料2'
      - '材料3'

对应关系如下：

用法对应物品
%llwh_slot_amount:分页1:0%材料1
%llwh_slot_amount:分页1:1%材料2
%llwh_slot_amount:分页1:2%材料3

slot_amount 使用仓库完整物品列表的顺序编号，不会根据玩家当前打开的页面进行偏移。指定仓库不存在、槽位没有对应物品或参数无法解析时返回 0。

当前页面槽位数量 ​

格式：

text
%llwh_now_amount:槽位id%

该变量会结合玩家当前打开的仓库和页数计算物品位置。每页最多展示 45 个仓库物品，槽位编号从 0 开始。

槽位范围说明
0 至 44当前页面的仓库物品展示区域
45 至 53翻页按钮和填充区域，不应作为物品槽位使用

实际查询位置按照以下规则计算：

text
(当前页数 - 1) × 45 + 槽位id
用法返回内容
%llwh_now_amount:0%当前页第一个展示物品的数量
%llwh_now_amount:3%当前页第四个展示物品的数量
%llwh_now_amount:44%当前页最后一个展示物品的数量

例如玩家位于第 2 页时，%llwh_now_amount:0% 查询的是仓库完整物品列表中编号为 45 的物品。

玩家没有打开仓库、槽位没有对应物品或参数无法解析时返回 0。该变量适合放在仓库 GUI 的名称、描述或其他支持 PlaceholderAPI 的界面内容中。

返回规则 ​

情况返回结果
玩家没有指定战利品0
指定物品已配置并成功加载返回玩家拥有的数量
%llwh_file% 没有当前界面状态1
%llwh_warehouse% 没有当前界面状态空字符串
槽位不存在或没有对应物品0
PlaceholderAPI 请求没有提供玩家对象空字符串
使用了无法识别的变量格式返回红色的“错误”文本

战利品数量使用长整数保存，变量返回的是完整数字文本，不受普通物品堆叠上限限制。

注意事项 ​

  • 变量只能读取已经在 warehouse 配置中成功加载的物品。
  • 槽位顺序与仓库 item 列表顺序一致，从 0 开始编号。
  • 单页仓库展示区域固定为前 45 个槽位。
  • %llwh_now_amount:槽位id% 依赖玩家当前打开的仓库和页数，不适合在普通聊天、计分板等长期显示位置中直接代表固定物品。
  • %llwh_slot_amount:仓库id:槽位id% 不依赖玩家当前打开的仓库，适合读取固定仓库位置。
  • 修改仓库物品列表顺序后，基于槽位编号的变量会指向新的对应物品。需要长期稳定读取时，优先使用 %llwh_物品id%。
  • 仓库条件只控制玩家是否可以通过对应仓库进行存取，不会改变变量按物品 ID 读取玩家数量的方式。