欢迎访问 Dice! 文档

基础命令

注意

本文档只针对 Dice V3 版本,某些内容可能不适用于旧版本

注意

由于版本差异及开启模块差异,具体骰子表现不一定与下列完全相同

普通掷骰-.r命令:

用法:

.r [掷骰表达式] [掷骰原因]

简介:

投掷掷骰表达式并返回其结果

说明:
  • 掷骰表达式应为XdY的格式,其中X代表骰子个数,Y代表骰子面数,如.r 3d6
  • 如省略X则默认为1,省略Y则默认为使用.set设置的掷骰默认面数(未设定则为100)
  • 此外,掷骰表达式中可以包含加(+)减(-)乘(*×xX)除(/÷)以及乘方(^)运算,如.r 3d6×5+12
  • 可以用括号指定运算优先级
  • 因此,默认情况下,.r d则为投掷1D100。可以省略空格写成.rd
  • 跑DND的朋友可以使用.set 20命令更改默认骰为D20,这样就可以使用.rd+3投掷D20+3了
特殊用法:
  1. COC奖励骰和惩罚骰分别为b+个数和p+个数,省略个数默认为1,如.rb或.rp3
  2. Fudge/Fate骰为个数+f或df,不写个数默认为4,如.rf或.r10df(暂未实现)

COC人物作成-.coc命令

用法:

.cocX N(其中X和N均可缺省)

简介:

依据COC第X版规则进行N次调查员人物作成

说明:
  • X取6或7 为作成人物卡所依据的coc规则版本(6版或7版)
  • X的缺省值为7,即直接使用.coc N(.coc 5)命令时,Kokona将自动为您进行N(5)次依据coc第七版规则的调查员人物作成
  • N取作成的对应人物卡数量
  • N的缺省值取1,即直接使用.coc6(.coc7)命令时,Kokona将自动为您进行一次依据coc第六(七)版规则的调查员人物作成
  • 当X和N均省略时,即直接使用.coc命令时,Dice!将自动为您进行一次依据coc第七版规则的调查员人物作成

小技巧

  • 如果要进行6次依据coc第七版规则的人物作成,请使用.coc 6 (在coc和6之间有空格)(或.coc7 6)
  • 如果要进行1次依据coc第六版规则的人物作成,请使用.coc6 (在coc和6之间没有空格)

详细版COC人物作成-.cocXd命令

用法:

.cocXd(其中X可以省略)

简介:

依据COC第X版进行一次人物作成并将人物作成详细显示(包括背景,适用于NPC生成等)

说明:
  • X取6或7 为作成人物卡所依据的coc规则版本(6版或7版)
  • X的缺省值为7,即直接使用.cocd命令时,Dice!将自动为您进行一次依据coc第七版规则的详细调查员人物作成

小技巧

在.cocXd命令后再加数字不会进行多次作成

DND英雄作成-.dnd命令

用法:

.dnd N(其中N可缺省)

简介:

依据DND规则进行N次英雄作成

说明:
  • N取作成的对应人物卡数量
  • N的缺省值取1,即直接使用.dnd命令时,将自动进行一次DND英雄作成

默认骰设置-.set命令

用法:

.set N (N缺省为100)

简介:

将本群/讨论组/私聊会话默认骰设置更改为N

说明:
  • 更改之后,在此群/讨论组/私聊会话中不输入骰子面数则默认面数为N
  • 未设置过则默认为100

小技巧

DND群可以使用.set 20将默认骰改成D20

注意

在群中此命令需要由群主/管理员执行

注意

请注意本命令效果与V2不同

机器人控制-.bot命令

用法:

.bot [on/off] [机器人QQ/QQ后四位]

简介:

启用/关闭机器人/显示机器人信息

说明:
  • 直接使用.bot来获取机器人编译信息
  • 使用.bot on开启机器人, .bot off关闭机器人
  • 如群内有多个机器人,可以使用在最后添加机器人QQ号/QQ后四位的方式指定其中一个进行开启/关闭

小技巧

也可以@机器人来指定某个机器人

全局昵称控制-.n命令

用法:

.n [昵称]

简介:

设置全局昵称

说明:
  • 不输入昵称即为删除昵称,否则即为设置昵称

注意

昵称显示优先级为: 群/讨论组昵称>全局昵称>群名片>昵称

群/讨论组昵称控制-.nn命令

用法:

.nn [昵称]

简介:

设置群/讨论组内昵称(私聊使用则同.n,为设置全局昵称)

说明:
  • 不输入昵称即为删除昵称,否则即为设置昵称

注意

昵称显示优先级为: 群/讨论组昵称>全局昵称>群名片>昵称

随机昵称生成-.nnn命令

用法:

.nnn [en/jp/cn]

简介:

随机设置一个昵称

说明:
  • 不指定en/jp/cn即从整个数据库中选取
  • 指定其中一个即从指定数据库中选取
  • en代表英语 jp代表日语 cn代表中文
  • 私聊使用则设置为全局昵称,否则设置为群/讨论组昵称

注意

昵称显示优先级为: 群/讨论组昵称>全局昵称>群名片>昵称

随机昵称生成-.name命令

用法:

.name [en/jp/cn] [个数]

简介:

随机生成指定个数个昵称

说明:
  • 不指定en/jp/cn即从整个数据库中选取
  • 指定其中一个即从指定数据库中选取
  • en代表英语 jp代表日语 cn代表中文
  • 个数最多为10

帮助-.help命令

用法:

.help [可选参数]

简介:

获取指令帮助

说明:
  • 不输入可选参数则显示默认(default)帮助信息
  • 可选参数由骰主进行设置,骰主应将可用的可选参数写入.help主页面中
  • 输入可选参数,则显示对应的帮助子界面

移除骰子-.dismiss命令

用法:

.dismiss [机器人QQ/QQ后四位]

简介:

让机器人退群/退讨论组

说明:
  • 直接踢骰子可能被列入黑名单(取决于骰主设置),使用此命令则不会
  • 如群内有多个机器人,可以使用在最后添加机器人QQ号/QQ后四位的方式指定其中一个进行开启/关闭

小技巧

也可以在最开始@机器人来指定某个机器人

进阶命令

注意

本文档只针对 Dice V3 版本,某些内容可能不适用于旧版本

注意

由于版本差异及开启模块差异,具体骰子表现不一定与下列完全相同

注意

本文档页面可能频繁更新修改

人物卡导入-.st命令:

用法一: 查看所有人物卡

用法:.st
简介:查看当前所有可用的人物卡

用法二: 导入人物卡

用法:

.st [人物卡名称--]属性名称 属性值 [属性名称] [属性值]...

简介:

设置人物卡属性

说明:
  • 此命令用于导入人物卡, 以用于rarc检定等
  • 未指定人物卡名称即向当前绑定的人物卡导入数据
  • 会覆盖当前人物卡的已有数据
  • 如果指定的人物卡不存在, 则自动新建人物卡
  • 可以一起导入多个属性, 只需在后面加上他们的属性名称和值
  • 属性值必须是整数, 且不能是负数
  • 属性和值之间可以有空格/没空格/冒号连接
  • 属性和属性之间可以有空格/没空格/"|"连接
  • 可以与用法三混用
示例:
  • .st Kokona--力量30 【把名称为Kokona的人物卡的力量属性设置为30】
  • .st 力量20敏捷30 【把当前人物卡的力量设置为20, 敏捷设置为30】

小技巧

.st命令中内置了大多数同义词, 如str和力量, 导入时只需要输入其中一个即可, 如果发现缺失的同义词请发issue或者群里提出建议

用法三: 修改人物卡

用法:

.st [人物卡名称--]属性名(+/-)属性值/骰子 [属性名(+/-)属性值/骰子]

简介:

更改人物卡已有属性

说明:
  • 属性名需要是已保存的属性, 如未保存则在默认值基础上加减, 如没有默认值则报错
  • 加减值可以是数字也可以是掷骰表达式
  • 可以一起修改多个属性, 只需在后面加上他们的属性名称和修改值
  • 可以与用法二混用
示例:
  • .st Kokona--力量+30 【把名称为Kokona的人物卡的力量属性增加30】
  • .st 力量+2d6敏捷-1d3 【把当前人物卡的力量增加2d6, 敏捷减少1d3】
  • .st 力量30敏捷-1d3 【把当前人物卡的力量设置为30, 敏捷减少1d3】

注意

力量减少2d6+2需要输入成.st 力量-2d6-2或者.st 力量-(2d6+2)

用法四: 展示人物卡

用法:

.st show [人物卡名称--]属性名称 [属性名称]...

简介:

展示人物卡属性

说明:
  • 多数用法同用法二
  • 展示全部属性可以将属性名称参数设置为all
示例:
  • .st show all 【展示当前人物卡的所有属性】
  • .st show 力量 敏捷 【展示当前人物卡的力量和敏捷属性】
  • .st show Kokona--all 【展示名为Kokona的人物卡的所有属性】
  • .st show Kokona--力量 敏捷 【展示名为Kokona的人物卡的力量和敏捷属性】

用法五: 切换人物卡

用法:

.st switch [人物卡名称]

简介:

切换到指定的人物卡

说明:
  • 切换后st,sc,en,ra,rc等命令将默认使用此人物卡
  • 即使人物卡不存在, 切换也会成功(方便接下来可能的导入等)
  • 在不同的群中可以切换至不同的人物卡
  • 不指定人物卡名称则会切换到default人物卡
示例:
  • .st switch Kokona 【切换到名为Kokona的人物卡】
  • .st switch 【切换到default人物卡】

小技巧

未绑定到任何人物卡时, 默认使用default人物卡

小技巧

在群/讨论组中.nn或者私聊中.n时, 如果设置的昵称同已有的人物卡则会在此会话中自动切换到此人物卡

用法六: 删除属性

用法:

.st del [人物卡名称--]属性名称 [属性名称]...

简介:

删除指定的人物卡属性

说明:
  • 多数用法同用法二
  • 最后一个属性被删除时, 人物卡即自动删除
  • 属性名称为all时,同删除人物卡
示例:
  • .st del 力量 敏捷 【删除当前人物卡的力量和敏捷属性】
  • .st del Kokona--力量 敏捷 【删除名为Kokona的人物卡的力量和敏捷属性】
  • .st del Kokona--all 【删除名为Kokona的人物卡】

用法七: 删除人物卡

用法:

.st clr 人物卡名称

简介:

删除指定的人物卡

说明:
  • 人物卡中的所有信息都会被清空
  • 不指定人物卡名称则删除当前人物卡
示例:
  • .st clr 【删除当前人物卡】
  • .st clr Kokona 【删除名为Kokona的人物卡】

判定掷骰-.ra/rc命令

注意

.ra和.rc命令现在效果相同

用法:

.ra/rc[h][p/b数字] [属性] [属性值] [掷骰原因]

简介:

投掷骰子并判定成功失败

说明:
  • 指定h即为暗骰
  • 默认掷骰D100, 指定p+数字或b+数字即带惩罚骰/奖励骰(不输入数字默认1个, 数字仅可为1-3)
  • 指定属性值时, 使用属性值进行判定
  • 未指定属性值但指定属性时, 从当前人物卡中提取属性值进行判定, 人物卡无此属性即使用默认值, 无默认值即报错
  • 不指定属性且不指定属性值即报错
示例:
  • .ra 80 【进行成功率为80的D100判定】
  • .ra 力量80 【力量为80, 进行D100判定】
  • .ra 力量 【从人物卡中获取力量值, 进行D100判定】
  • .rah 力量 【从人物卡中获取力量值, 进行D100暗骰判定】
  • .rahp2 力量 【从人物卡中获取力量值, 进行带有两个惩罚骰的暗骰判定】

成功规则设置-.setcoc命令

用法:

.setcoc [规则序号]

简介:

设置.ra/rc命令的成功判定规则

说明:
  • 不指定规则序号即为0
  • 私聊使用则适用于私聊会话, 讨论组与群中使用适用于所有该讨论组成员/该群群员

注意

在群中此命令需要由群主/管理员执行

常见问题

注意

本文档只针对 Dice V3 版本,某些内容可能不适用于旧版本

    • Q: 有的时候机器人不回复? (或只有群里回复/只有私聊回复等)
      • A: 首先确认机器人已经开启(.bot on),如果问题未解决,检查日志(酷Q-右键-日志),如果日志中有发送记录,则可以确认是账号被腾讯限制(消息被当作垃圾信息拦截了),没有明确的解决方法,可以尝试等待几天/挂几天QQ等
    • Q: 如何申请一个机器人?
      • A: Dice!官方目前没有公开的机器人,我们推荐自己按照搭建说明搭建一个自己的进行使用,如果没有能力,请联系其他机器人master(而不是官方群)咨询使用他人公开机器人的问题。
    • Q: 使用骰子时遇到了报错/疑似bug?
      • A: 请确认使用的是非修改版的Dice! V3且报错信息显示的错误来自Dice!模块。这种情况下请在官方群/Github反馈,十分感谢
    • Q: 想要参与开发?
      • A: 欢迎任何有兴趣的人参与开发,可以直接发PR
    • Q: 有功能建议?
      • A: 可以在群中或Issue中提出,但不一定会被采纳

注意

本文档只针对 Dice V3 版本,某些内容可能不适用于旧版本

注意

由于版本差异及开启模块差异,具体骰子表现不一定与下列完全相同

前言

Dice! 是采用C++17开发, 基于 酷Q 的QQ掷骰机器人

本文档介绍了此应用程序的使用/搭建方法,下载/了解其他信息请访问 主页

联系开发者请加QQ群941980833或624807593 (只负责开发相关,不负责具体机器人维护)