Mirai框架qq机器人教程

Mirai框架qq机器人教程

• 0.前言
• 1. 安装Java
• 2.安装Mirai启动器
• 3.下载IDEA或其他编译器
• 4.创建mirai-console插件项目
• • 4.1 通过git创建
  • 4.2 通过插件创建项目
• 5.解决代码报错
• 6. miraiOK结构
• 7.mirai 旧版kotlin代码例子解析
• 8.官方开发文档
• 9. 一个简单的kotlin例子
• 10. 用gradle生成插件文件（.jar）
• 11.在mirai中已有的一些插件
• 一些tips

本教程代码部分已经过时，为2.0-M1版！！！
请阅读新版2.0-M2版的教程
或
官方的框架教程 官方启动器教程

0.前言

目前mirai项目官方已经停止维护并且好像删库了？ 但是由于其开源性质，有很多clone的库在github上
c++版github地址:点我

kotlin版github地址:点我

c++版教程csdn:点我
温馨提示：请勿使用qq机器人做非法的事情

1. 安装Java

最低1.8，推荐15
推荐下载openjdk而不是甲骨文的，不然mirai-console-loader会报错

自行百度(以后如果有时间回来补教程)
记得配置环境变量
如何检测成功安装: 按Win+R>输入cmd 然后回车-> 输入java -version

2.安装Mirai启动器

mirai目前启动器有2个(详情)

1. MiraiOk是一个安装MiraiOK的一键安装包
   最新官方及全版本Github下载地址（里面readme.md里面有下载整合包地址）(最近github下载好像提速了，我就不另外传到国内网盘了，如有需要评论区说）
2. 推荐用mirai-console-loader

本文作者windows版本备份(使用旧框架的miraiok和新框架的mirai-console-loader)

3.下载IDEA或其他编译器

从搜索引擎搜索官网进去下载
或者用其他编辑器也可以

4.创建mirai-console插件项目

该插件可以让你快速生成mirai项目
Step1: 在IDEA中按快捷键ctrl+alt+s或者点击File->Setting
Step2: 找到里面的Plugin
Step3: 在Marketplace里面搜索Mirai和Kotlin 安装

但是，笔者在IDEA 2020.2版本中无法安装插件或新建项目没mirai的项目，如果有这种情况，有3种解决方法

1. 到笔者的库下载生成好的项目，并自己修改信息(旧版的kotlin框架)

2. 感谢网友提醒，这种情况下也可以手动下载插件然后导入插件从而安装
   github下载地址

3. 用官方提供的例子(新的kotlin框架)

4.1 通过git创建

如果是用github上的项目创建，那就从github上下载，然后用IDE打开整个文件夹就好了

4.2 通过插件创建项目

Step1 就像正常创建项目一样,File->New->Project

Step2 选mirai-console，这里随便填（不知道的尽量不改，推荐语言kotlin，博主搞了半天的java版还是没用）然后next

Step3 两个id随便写，包管理器建议这样配置，然后next

Step4 随意

5.解决代码报错

如图 创建项目好后会呈现这样子

这个时候你们的代码会报错，显示找不到包，这是gradle依赖出问题了
请自行到上方有写的作者储存库里复制build.gradle的内容并忽略以下内容
Step1 打开build.gradle
添加和删除如图，其他不变

implementation(“net.mamoe:mirai-core-qqandroid:1.1.3”)
compile fileTree(dir:’/jars/’,includes: [’*.jar’])

Step2 在根目录下创建jars文件夹，如图

Step3 把miraiok下的content下的第一个.jar文件复制到jars文件夹下，如图

然后就解决了。

6. miraiOK结构

从上往下依次是
开发SDK（也就是依赖库）
jre1.8.0_252 也就是java运行环境
不知道干什么的空文件夹
运行日志
插件目录（gradle生成jar后复制到这）
不知道干什么的空文件，应该是控制版本
不知道干什么的xml文件
配置文件
虚拟设备信息（qq协议用）
一个库
主程序（点击运行机器人）

7.mirai 旧版kotlin代码例子解析

reply即为回复方法，如
"HI" reply("X")
与

if(message.toString()=="HI")reply("X")

一个道理

8.官方开发文档

Github点击查看
码云点击查看

9. 一个简单的kotlin例子

github查看地址
码云

10. 用gradle生成插件文件（.jar）

Step1 点击侧边栏的gradle

Step2 双击jar任务

Step3 在lib目录下找到.jar文件
Step4 把这个jar文件复制到miraiok的plugins目录下
ps：这个文件夹是运行后生成的

Step5 运行mirai

11.在mirai中已有的一些插件

不能确定能不能用
Github跳转
码云

一些tips

• 在MiraiOK的文件夹下的config.txt可以设置自动登录
  
• 在plugin.xml可以改项目信息
  

有什么评论区问，以后再补充
应该没有人和我一样半夜2点写教程吧(笑

此外 可以来找我机器人玩啊(qq号:481784853)
相关群 1044565129

-End-