本文使用《署名—非商业性使用—相同方式共享 4.0 协议国际版》（CC BY-NC-SA 4.0）进行授权
https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.zh-Hans

Dice的用户里可能有部分是Mirai用户或者希望转移到Mirai的用户，同时想保留dice的体验，这篇教程就是告诉你们怎样才能做到这一点。

一、什么是mirai？

• Mirai 是一个在全平台下运行，提供 QQ Android 支持的高效率机器人库，使用Kotlin编写，在Windows和Linux目前基于jvm运行。

• Mirai-Console 是Mirai的服务端之一，也是目前最常用的服务端程序，本次要使用的Mirai-Native正是基于它来运行的。

• Mirai-Native 是一个支持所有 stdcall 方式导出方法的 DLL 与 Mirai 交互Mirai-Console插件，可支持Dice！和部分CoolQ插件在Mirai平台运行。

• MiraiOK 是一个以golang编写的新Mirai一键包，全平台可用，但只支持启动pure控制台界面，不支持graphical图形界面。

二、要准备的工具

请直接从这里下载整合包，不推荐手动部署 Mirai下载帖

1. 方便的快速部署工具——MiraiOK(已失效，请使用整合包内程序),这里采用的是i386版本。（amd64不可用）

2. 加载dice!的必须Mirai插件——Mirai-Native （2020/8/3换源为自制版本）

3. Dice的dll和json文件，请浏览论坛其他页面下载。

三、搭建步骤

1. 在你需要运行mirai的目录下新建一个目录丢MiraiOK_windows_i386.exe，然后点击运行，让他生成文件。当出现 [Mirai ...] "login qq号 qq密码 " 来登录一个BOT 的时候，就表示启动完成了，可以关掉进行下一步了。

2. 将 mirai-native-x.x.x.jar 放入 Mirai 的 plugins 文件夹中，再启动一次，让它在 plugins 目录下生成 Mirainative 文件夹。成功后关闭mirai，进入该文件夹。

例如 C:/user/administrator/desktop/mirai/plugins/MiraiNative

4. 进入MiraiNative文件夹下的plugins文件夹，将dice!的dll和不带注释的json一起丢进去。两个文件文件名一定要相同！！！

5. 再次打开Mirai，这时候，登录你的bot账号，根据屏幕显示来进行登录验证，成功后，dice应该就可以正常使用了。

如果没启用，请在任务栏寻找流泪猫猫头右键，找到插件管理 -> Dice! -> 启用点击一下，就可以启用Dice!了。之后的正常设置与CoolQ无异。

6.重要：如果dice和其他native插件，例如萌化自定义一起用，出现无法读取配置，master模式丢失的情况，请将位于mirai根目录下的DiceData[qq号]文件夹移动到mirai根目录\\jre\\bin\\目录下。即mirai\\jre\\bin\\DiceDataxxxx

四、Mirai 已知问题(非Dice!问题)

1. 登录有时会卡死(java.lang.NegativeArraySizeException)

2. 邀请加群可能会报错java.util.NoSuchElementException: group 群号

3. getStrangerInfo不一定好用(表现为昵称获取失败)

4. 所有PermissionDeniedError(包括Dice!内部的权限错误)(只是Mirai反应迟钝)

5. 邀请机器人一次有可能产生两次邀请事件(反正问题不大）

6. 打开GUI会阻塞线程，导致无法处理命令。

7. 无法获取被踢出事件（自动封禁不可用）

8. 如果有其他客户端登录同一账号，会经常弹出Mirai登录的提示

9. 某些情况下收不到好友私聊消息

如有其他问题请在评论区留言。