54 lines
2.6 KiB
Markdown
54 lines
2.6 KiB
Markdown
## 示例文档：随身仓库插件
|
||
|
||
### 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）删除仓库中所有的物品。 |