# 示例文档:随身仓库插件

# 1、功能描述

​ 1)点击界面入口可打开随身仓库。(作为本需求的示例,入口可通过官方的主菜单插件打开即可) ​ 2)仓库的列数固定为7,行数可动态适配,最多32行,超出显示的部分通过翻页或滚动实现。 ​ 3)随身仓库的界面示意,可参考下图。 ​ a、配置为初始行的仓库格子,状态是已解锁。其余格子是上锁状态。 ​ b、点击任意上锁状态的格子,弹出二次确认弹窗,弹窗内容通过本行解锁提示配置获取。 ​ c、上述弹窗选择确认,但物品、货币不足的情况下,用官方插件neteaseAlert进行弹窗提示“解锁所需物品或货币不足!” ​ d、上述弹窗选择确认且物品、货币足够的情况下,扣除响应物品、货币并开启下一行格子。用官方插件neteaseAlert进行弹窗 ​ 提示“成功解锁第%s行仓库格子”

# 2、配置说明

​ 1)随身仓库初始行数,最小值是0。 ​ 2)随身仓库最大行数。 ​ 3)非初始行的解锁消耗:支持物品+货币两种形式,其中货币需要将官方的经济插件作为前置。若解锁配置设为 -1,则由开发者根据自己写的判断进行解锁。 ​ 配置说明举例: ​ 初始行数 0 ​ 最大行数 10 ​ 解锁配置 [行数区间]:(货币dough_id,货币数量,[(物品1identifier:aux,物品数量1),(物品2identifier:aux,物品数量2),...],"本行解锁提示")

# 3、API需求

​ 1)服务端API:某uid玩家打开随身仓库。 ​ 2)服务端API:设置某uid玩家随身仓库解锁多少行。(假如当前已解锁3行,调用这个API,解锁行数设为3,则第4~6行进行解锁) ​ 3)服务端API:查询某uid玩家随身仓库已解锁的行数。 ​ 4)服务端API:删除仓库中某一格的物品。 ​ 5)服务端API:删除仓库中所有的物品。

# 4、事件需求

​ 1)服务端事件:点击任意上锁状态格子时抛出,参数包含:玩家uid、 ​ 2)服务端事件:成功解锁时抛出,参数包含:玩家uid、当前解锁的行数集合

# 5、运营指令

​ 1)某uid玩家打开随身仓库。 ​ 2)设置某uid玩家随身仓库解锁多少行。 ​ 3)查询某uid玩家随身仓库已解锁的行数。 ​ 4)设置某uid玩家随身仓库上锁多少行。原来已解锁格子中的物品,设为上锁状态后将无法放入但可以取出,直到重新解锁。 ​ 5)删除仓库中某一格的物品。 ​ 6)删除仓库中所有的物品。

示例文档:随身仓库插件

1、功能描述

2、配置说明

3、API需求

4、事件需求

5、运营指令