37 lines
2.0 KiB
Markdown
37 lines
2.0 KiB
Markdown
# 插件编写——需求篇
|
||
|
||
在开始编写插件之前，我们需要首先明确插件需要什么功能，具体细节是什么样的以及各种用于二次开发的API需求和事件需求。
|
||
|
||
在接下来的篇幅中，将以抽奖插件为例，按照流程制作一个完整的插件。
|
||
|
||
## 插件需求
|
||
|
||
每日进行1期抽奖，每位玩家可随机领取3个不同的号码，号码取值是1~10000，领完为止。每日20：00开奖，通过邮件（官方neteaseAnnounced插件）告知中奖玩家并发放奖励。
|
||
|
||
## 细节需求
|
||
|
||
- 玩家可在game服或lobby服，输入cp1领取号码，成功领取后，用官方neteaseAlert插件提示“本次领取的号码是%s”
|
||
- 奖励号码每日开奖后重置，玩家可重新领取。
|
||
- 若超过当日可领取的上限：3，输入cp1领取时，用官方neteaseAlert插件提示“今日领取的号码已超过上限”
|
||
- 每日开奖时间之前（上一天的20：01~当天20：00），输入cp2可查询已领取的号码。
|
||
- 官方neteaseAlert插件提示已领取的号码情况“今日已领取%s（数量）个号码：%s、%s、%s”
|
||
- 从1~10000中随机抽取5个号码作为本期中奖号码。
|
||
- 中奖的邮件提示：本期中奖号码：%s、%s、%s、%s、%s。恭喜你，在本期抽奖活动中中奖，请再接再厉。邮件附件内容：黑曜石*5
|
||
- 没中奖的邮件提示：本期中奖号码：%s、%s、%s、%s、%s。很遗憾，在本期抽奖活动中未能中奖，请继续努力。邮件附件内容：铁锭*3
|
||
- 当天没有领取任何号码的玩家无需发放邮件。
|
||
|
||
## API需求
|
||
|
||
- 给指定玩家随机获得1个号码（必须是本期活动没有获得过的，如果没有号码则返回-1)
|
||
- 返回玩家已获取的号码数量
|
||
- 返回玩家已获取的号码列表
|
||
- 重置某个玩家的号码
|
||
- 重置所有号码
|
||
- 执行发奖，返回获奖的号码列表以及获奖玩家列表
|
||
|
||
## 事件需求
|
||
|
||
- 发奖时刻之前触发——返回中奖号码，可修改中奖号码
|
||
- 发奖时刻之后触发——返回中奖号码与中奖玩家
|
||
|