• 骰主手册

For Ver.3.1.18(1028)

世界是属于每一个人的。要创造一个充满逻辑并尊重每一个人的世界。 ——《Новый Элемент Расселения》A.D.1960 Москва

有关基础搭建的指引请参考【教程】手把手教你搭建青果骰

DIXE(OLIVADICE)

前言

“骰子机器人”的本质,是一个通过或非官方(QQ)协议以及工具,或官方(Telegram、开黑啦等)开放平台接口,实现的一个部分或者全部由骰子机器人软件及其控制的普通用户账号或特殊账号的集合体,而“骰子”一词则,将该集合体的目标功能,限定为服务发生于这些场景的跑团中,提供模拟掷骰的功能以及其他与跑团相关的功能。 所以,将跑团骰子机器人与娱乐机器人等同的观点是完全错误的,如果出现了这类混淆视听的观点,请确认他们所说的是不是“骰娘”这类意义更加丰富的词,而非“骰子”。

插件模块

基于OlivOS的插件机制,新版的青果骰进行了模块化设计,实现了多个插件模块的协同合作,你可以通过安装这些模块来快速的组合功能。

OlivaDiceCore | 核心模块

OlivaDiceCore是整个骰子的核心模块,它提供了所有必须的骰子功能以及基础的管理支持,几乎所有的其它模块都依赖这个模块。

OlivaDiceJoy | 娱乐模块

OlivaDiceJoy提供了一些无关紧要的娱乐功能,它们或许是与跑团关系不大、或许只是一些历史原因遗留下来的传统,总之,这些在野蛮生长时期被或是由于开发者无知、或是作为恶性竞争手段、或是用户呼声较大但对于跑团而言意义不明的,被添加进来的小功能,都会被放入这个模块。

OlivaDiceLogger | 日志模块

OlivaDiceLogger提供了跑团日志记录器,它可以在跑团过程中对日志进行记录,并由结果生成跑团日志,与在线的跑团日志渲染器进行联动、或发送日志邮件。

OlivaDiceMaster | 大师模块

OlivaDiceMaster提供了更高级的骰主管理功能,其中的功能可能不是必须的,但是却是强大的,这些功能包括但不限于更新和安装新的模块。

OlivaDiceOdyssey | 高阶模块

OlivaDiceOdyssey提供了一些涉及第三方合作的功能,它们或许是调用了第三方数据库,要么是涉及版权授权,又或者是单纯的过于依赖网络,总之这些功能由于第三方的参与很可能无法由插件开发者保证可靠性,但仍然很强大。例如魔都模组功能。

用户策略

用户记录

.uinfo 查询自己的用户记录 .uinfo user 查询自己的用户记录 .uinfo group 查询本群的群记录 .uinfo host 查询本频道的记录 .uinfo user [id] 查询对应的用户记录 .uinfo group [id] 查询对应的群记录 .uinfo host [id] 查询对应频道的记录

以下功能需要OlivaDiceMaster 大师模块

.trust [user/group/host] [id] 对某个[用户/多人聊天/频道]设置信任等级 .trustlevel [user/group/host] [id] 对某个[用户/多人聊天/频道]设置信任等级 .trustrank [user/group/host] [id] 对某个[用户/多人聊天/频道]设置信任评分

需要注意,当前将信任等级设置为0时,将不会被信任。 需要注意,当前将信任等级设置为>=2时,将会被信任为白名单。

管理指令

Master绑定/解绑

Master是骰子的控制者,每个骰娘同时可以有多个Master。Master可以控制骰子的发言和行为,并个性化大量配置。 在插件启动时将会显示有关骰子认主指令的具体提示,每完成一次认主,口令将会刷新。 形如:

完成认主后将会有明确提示 .master [验证口令] 骰子认主 .master master (del) [ID] 添加(删除)骰主

通知窗口

.master notice (del) [群号] 添加(删除)通知群

被作为通知窗口的群会在有邀请时受到邀请请求或通知,如果需要手动验证,则会提供相关指令提示

心跳上报

.master pulse [TOKEN] 添加心跳TOKEN .master pulse del [URL/TOKEN] 删除心跳配置 .master pulse [URL] [TOKEN] 添加第三方心跳TOKEN

更多有关心跳上报的信息请参考心跳系统

远程控制

.master exit [群组ID] 远程退出特定群 .master remote [on/off] [群组ID] 远程在群中停用 .master remote host [on/off] [频道ID] 远程在频道中停用 .master remote host default [on/off] [频道ID] 远程在频道中默认关闭

远程控制提供了一种不需要骰主加入相关多人聊天场所即可操作对应场所这些开关的状态的方法

以下功能需要OlivaDiceMaster 大师模块

.group clear [天数] 查找超过对应天数未触发的多人聊天 .group clear do [天数] 清理超过对应天数未触发的多人聊天

需要注意,加入白名单的群将不会被该指令清除。

修改配置项

.master [配置项] [配置值] 修改配置项

修改配置项可以更广泛的调整骰子机器人的全局配置

配置项目表

  • OlivaDiceCore 核心模块

关键词
默认状态
说明

BelieveOlivaDicelist

0

控制是否拉取OlivaDicelist

autoAcceptFriendAdd

1

自动同意好友添加请求

autoAcceptGroupAdd

1

自动同意群邀请

messageFliterMode

0

事件过滤器 1时屏蔽普通群消息 2时屏蔽频道消息 3时屏蔽所有多人窗口消息

disableReplyPrivate

0

禁用私聊

pulseInterval

300

心跳上报频率,通常不需要调整

userConfigCount

100

用户记录刷写循环计数器,通常不需要调整

globalEnable

1

当前版本无用,通常不需要调整

messageSplitGate

650

分页门限,超过此长度的文本将被分页处理

messageSplitPageLimit

10

分页上限,超过此数量的页面将不再被发送

messageSplitDelay

1000

分页延迟,每个分页间将会等待如此长时间再次发送,单位为毫秒

  • OlivaDiceJoy 娱乐模块

关键词
默认状态
说明

joyPokeMode

0

控制戳一戳的返回内容 0返回默认版本号 1进行一次默认骰掷骰 2进行一次今日人品查询

远程更新

.system restart 重载所有模块

以下功能需要OlivaDiceMaster 大师模块

这些指令可以用于远程更新插件 .oopm update 自动检查并更新全部插件 .oopm update [插件名称] 更新特定插件 .oopm show [插件名称] 检查插件更新状态 .oopm list 查看所有可选模块 .oopm get [插件名称] 获取对应的可选模块

反馈发送

以下功能需要OlivaDiceMaster 大师模块

  • 对于普通用户 .send [反馈消息] 发送反馈消息给Master

  • 对于骰主 .send [回复消息] 发送消息到当前窗口 .send (user/group) [ID] [回复消息] 发送消息到指定窗口

个性化定制

配置文件

骰子可以由一系列配置文件进行直接定制,所有配置文件都在plugin/data/OlivaDice路径下,在该路径下会有不同名为账号哈希的目录以及一个unity目录,这分别对应每个账号各自的配置以及公用配置,其下配置文件如下,注明默认即为修改、重载时写入、定时刷写、初始化时读取

  • OlivaDiceCore 核心模块

文件路径
说明
读写时机

console/customReply.json

自定义回复词

默认

console/switch.json

自定义配置项

默认

console/helpdocDefault.json

自定义帮助文档

默认

extend/deckclassic

扩展牌堆

默认

extend/helpdoc

扩展帮助文档

默认

pcCard

自定义配置项

默认

user

用户记录

默认

  • OlivaDiceLogger 日志模块

文件路径
说明
读写时机

logger

日志记录文件

默认

扩展牌堆

扩展牌堆可以扩展draw指令可抽取的牌堆种类,扩展牌堆应当放置于extend/deckclassic路径下,其本质为格式如下的json文本文件

自定义帮助文档

.helpdoc [帮助名称] [帮助内容] 设置帮助文档 .helpdoc [帮助名称] 删除帮助文档

这些指令可以调整帮助文档的词条内容,或是增加新的帮助文档,亦或是删除帮助文档,此外,你还可以通过扩展文件进行扩展。

扩展帮助文档

扩展帮助文档应当放置于extend/helpdoc路径下,其本质为格式如下的json文本文件

自定义回复词

.str[配置项] [配置值] 修改对应的自定义配置 .str[配置项] 查看对应的自定义配置

本核心内置了一套str回复词配置工具,可以通过以上指令进行骰子回复词的配置,例如: 使用 [.strPcSkillCheckFailed 哈哈,失败,哈哈] 即可将检定失败回复词进行设置。

需要特别指出的是,.help指令回复的内容不属于自定义回复的范畴,而是属于自定义帮助文档,其内容与help default一致,可以通过helpdoc指令进行设置

自定义回复表

以下为可以用于console/customReply.json文件的内容,其键值对关系也可以用于上文所提到的str指令设置

  • OlivaDiceCore 核心模块

  • OlivaDiceJoy 娱乐模块

  • OlivaDiceLogger 日志模块

  • OlivaDiceMaster 大师模块

  • OlivaDiceOdyssey 高阶模块

Last updated

Was this helpful?