指南
bot的所有指令帮助文档都在代码内可以查到。当bot正常运行时,向bot发送/help <command>
可以查询到对应指令的帮助文档。
KP
bot需要在群聊中进行游戏,如果要开始游戏,将bot拉入群。
在群内发送指令/addkp
,就可以将您自己设置为KP。这之后如果需要撤销自己的KP,发送指令/delkp
。
管理员可以使用/transferkp
强制转移KP权限。
查询更多内容,请向bot发送以下指令:
(/help addkp)
(/help delkp)
(/help transferkp)
卡片
bot可以存储角色卡的数据。玩家使用/newcard
创建新角色卡并绑定至群,或者使用/addcard
直接添加一张卡片。卡片具有一个非负整数id
作为唯一识别的标志。
卡片可以被转移至别的群/changegroup
、别的玩家/cardtransfer
,也可以更换喜欢的id/changeid
。
可以用/trynewcard
来尝试以下如何建卡,建立的卡会被绑定至一个无效群,无法使用并且随时可以删除。
玩家在一个群内最多只有一张卡,如果有多个群则每个群可以有一张卡。KP可以在一个群拥有多张角色卡(一般是NPC),可以用于与玩家对抗、合作等。
如果玩家或KP拥有多张卡,使用指令修改角色卡的属性时(例如姓名,背景故事,性别等),请先使用/switch
切换操作中的卡。
show
开头的系列指令用于显示卡片信息、技能表、职业表。
/show
可以显示自己当前操作中(用/switch
切换)的卡基本信息。/show card
可以查看整张卡片。/show STR
可以查看STR属性的值。/showcard <id>
可以查看对应id的卡片的信息(如果有权限的话),/showcard <id> (card)/(attr)
功能完全类似于/show (card)/(attr)
。
其他show
开头系列指令的详细说明请向bot发送/help <command>
进行查阅。
发送/createcardhelp
可以获得建立新卡流程的提示。
当游戏开始时,该群内所有卡片会被复制一份,这一副本被称为游戏内的卡,游戏中的修改只会作用在游戏内的卡上,这时若玩家修改姓名等属性,将只能修改到游戏外的卡上。当游戏暂停并继续时,这些游戏外修改的属性才会被写入游戏内。
当游戏正常结束,而不是被中途放弃时,游戏内的卡片会覆盖掉游戏外的对应卡片,并将控制权转移给KP。当游戏被中途放弃之时,游戏内的卡片将会被全部删除,游戏中造成的修改不会覆盖到游戏外的卡,也不会被转移控制权。
查询卡片相关的详细操作,请向bot发送以下指令:
(/help addcard)
(/help additem)
(/help addskill)
(/help cardtransfer)
(/help changegroup)
(/help changeid)
(/help choosedec)
(/help copygroup)
(/help delcard)
(/help discard)
(/help getid)
(/help newcard)
(/help randombkg)
(/help renewcard)
(/help setage)
(/help setasset)
(/help setbkg)
(/help setjob)
(/help setname)
(/help setsex)
(/help show)
(/help showcard)
(/help showids)
(/help showjoblist)
(/help showkp)
(/help showmycards)
(/help showskilllist)
(/help switch)
(/help switchgamecard)
(/help trynewcard)
游戏
KP可以使用/setrule
设置游戏的部分规则,这个操作应该在第一名玩家车卡直接完成。可以使用/showrule
查看规则。
KP使用/startgame
开始游戏,这时会对群内玩家的卡片做一次检查,判断卡片是否缺少什么必填项。如果有缺失,则无法开始游戏。
如果想跳过这一检查,使用/start ignore
。
/startgame
执行成功后,群内即会产生角色卡的游戏内副本。
KP使用/pausegame
暂停游戏,此时游戏会暂时被隐藏,无法进行sancheck,HP扣除等操作。使用/continuegame
或者/startgame
继续该游戏。
KP使用/abortgame
放弃一场游戏,会导致所有游戏内的修改被丢弃。
KP使用/endgame
正常结束游戏,游戏内的卡片会覆盖游戏外的卡片,且控制权会被转移给KP。
KP可以使用/modify
修改群内任意卡片(包括游戏内、游戏外)的除群、id、玩家id以外的任何信息,具体如何使用,请向bot发送/help modify
查询。
进行游戏
在游戏进行中时,可以使用/roll
进行检定。
/roll STR
:力量检定;/roll 侦查
:侦查检定。不需要设置难度等级,会自动显示。
KP要使用NPC或怪物卡片过骰子时,需要先使用/switchgamecard
在拥有的卡片之间切换。
如果需要给下一个骰子设置一个临时的检定修正,或者给玩家的某项检定设置持续生效的检定修正,请使用/tempcheck
。
进行sancheck时,使用/sancheck success/fail
。例如/sancheck 0/1d6
即可进行一次成功减0,失败减1d6的sancheck。
KP使用/hp
可以修改玩家的HP。/hp +(1d3+1d2)
可以回复(1d3+1d2)
点HP,/hp 10
可以将HP设置为10。
KP使用/kill
,/mad
撕卡。/recover
使角色从重伤状态恢复。
查询游戏相关的详细操作,请向bot发送以下指令:
(/help abortgame)
(/help continuegame)
(/help endgame)
(/help hp)
(/help kill)
(/help mad)
(/help modify)
(/help pausegame)
(/help recover)
(/help startgame)
管理
除了游戏的功能以外,bot还提供了一些方便的功能。
/delmsg (number)
删除/delmsg
这条指令上面的number条消息,并同时删除/delmsg
这条消息。在私聊时可以用来清理对话框。在群聊时使用需要bot以及使用者都是管理员,可以清理多余的消息。删除速度会比较慢,请耐心等待,不要重复使用该指令。
/getid
可以获取本群、本玩家的唯一识别id。
/link
生成本群的邀请链接,并私聊发送给使用指令者(需要管理员权限)。
/msgid
获取消息的message id,这是消息在群内的唯一识别id。
(/help delmsg)
(/help getid)
(/help link)
(/help msgid)
BOT拥有者
作为拥有者,对bot有最高的管理权限。
/reload
bot的拥有者可以使用,对应的人是config.ini
中的ADMIN_ID
。在bot出现问题时,可以重新读取全部数据。(如果发生了无法解决的问题,请联系作者)
/bot <arg>
对bot的直接操作。
/bot check
对数据进行一次检查。如果没有发现问题,没有除了该指令执行提示之外的消息返回。
/bot stop
终止python进程,请务必用这种方式终止本bot。终止前会先进行文件写入保存数据。
/bot restart
相当于/reload
。
/bot exec (r) <code>
请谨慎使用。将会执行一段python代码。如果代码前有参数r
,则代码执行的返回值会输出给用户。没有参数r
则只会提示执行成功与否。