Mirai框架qq机器人教程 新版
Mirai框架qq机器人教程 新版
前言
本教程实为mirai的mirai-console插件教程
用到的概念有
mcl
- 指mirai-console-loader,mirai-console官方启动器
mirai
- mirai 是一个在全平台下运行,提供 QQ Android 协议支持的高效率机器人库,根据AGPLv3
开源
资料列表
以下为一些官方资料
mirai官方github库
mirai-console官方github库
mirai-console-loader(mcl)官方启动器官方github库
这三者的关系可以参考这里
官方实例
另,以下是一些资源:
笔者整理的mirai-console插件kotlin版实例
笔者备份的mirai启动器
1.准备
i. 配置java环境
下载mcl所需要的是>=1.8版本的openjdk,openjdk15下载地址,下载教程参考搜索引擎
最好用openjdk而不是甲骨文(Oracle)的jdk,原因
ii. 配置IDE
推荐IDEA吧,其他的也可以,主要是IDEA挺好用的
可以选择安装的官方插件:
Mirai Console IntelliJ 提供错误检查等功能
Kotlin Jvm Blocking Bridge 帮助 Java 用户调用 Kotlin suspend 函数
详细参考官方文档
iii. 下载mirai-console-loader(mcl)作为启动器
官方地址
教程同见官方说明
可能的报错:
java.lang.NoSuchMethodError: net.mamoe.mirai.utils.MiraiLogger$Companion.setDefaultLoggerCreator(Lkotlin/jvm/functions/Function1;)V
把你的config.json换成解决方法里面的环境异常
2.创建mirai-console插件项目
i. 下载
使用插件创建的是旧版的框架,mcl和mirai现已不支持旧版框架
从官方实例或者笔者整理的mirai-console插件kotlin版实例中下载最新版的框架到本地,然后用IDE打开文件夹,然后gradle依赖在下载里面都写清楚了
ii. 个性化项目
- 在
src/main/resources/plugin.yml
里改插件信息和入口点 - 在
settings.gradle.kts
里改生成的插件.jar名称 - 用
RunMiraikt
这个配置可以在ide里运行,不用复制到mcl或其他启动器 - 用
buildPlugin
这个任务可以生成.jar插件 - 在
src/main/kotlin/PluginMain
主类内也可以修改插件信息
3. 部分文件结构解析
插件实例代码
mirai-example-kotlin
│ build.gradle.kts gradle依赖列表
│ settings.gradle.kts gradle设置
│
├─.gradle gradle缓存目录
├─.idea idea项目配置缓存位置
├─.run
│ RunMiraiKt.run.xml IDE中运行任务配置,即RunMiraiKt源文件
│
├─gradle grdle文件
│
├─run RunMiraiKt默认运行目录
│
└─src
├─main
│ ├─kotlin
│ │ PluginMain.kt 插件主类
│ │
│ └─resources
│ │ plugin.yml 插件信息配置
│
└─test
└─kotlin
RunMirai.kt RunMiraiKt任务配置
4.插件代码解析
i.所有在以下代码中要引入的库
//插件信息
import net.mamoe.mirai.console.plugin.jvm.JvmPluginDescription
//主类继承
import net.mamoe.mirai.console.plugin.jvm.KotlinPlugin
//机器人被拉进群的事件
import net.mamoe.mirai.event.events.BotInvitedJoinGroupRequestEvent
//收到好友信息事件
import net.mamoe.mirai.event.events.FriendMessageEvent
//收到群消息事件
import net.mamoe.mirai.event.events.GroupMessageEvent
//新好友申请事件
import net.mamoe.mirai.event.events.NewFriendRequestEvent
//日志组件(logger)发控制台信息函数
import net.mamoe.mirai.utils.info
//消息(messageChain)中的图片类型
import net.mamoe.mirai.message.data.Image
//消息(messageChain)中的纯文本类型
import net.mamoe.mirai.message.data.PlainText
//监听器
import net.mamoe.mirai.event.Listener
//监听范围
import net.mamoe.mirai.event.globalEventChannel
//协程范围?
import kotlin.coroutines.EmptyCoroutineContext
监听和事件参考官方文档
ii.构建主类
object PluginMain : KotlinPlugin(
JvmPluginDescription(
id = "org.example.mirai-example",
version = "0.1.0"
)
) {
}
其中,kotlinPlugin
指继承plugin父类,JvmPluginDescription
指声明插件消息和版本
iii.覆盖插件启用函数
override fun onEnable() {
//或logger.info("xxx")
logger.info { "Plugin loaded" }
}
用kotlin关键字override
实现插件启用函数,然后用logger.info()
进行日志输出,其中logger
是kotlinPlugin
类内成员,除了.info()
还有.warning()
输出警告和.error()
输出报错
iv.监听事件
用subscribeAlways<>{}
这个函数在onEnable
函数中开启监听
globalEventChannel().subscribeAlways(
GroupMessageEvent::class,
EmptyCoroutineContext,
Listener.ConcurrencyKind.CONCURRENT
) {
//群消息
if (message.contentToString().startsWith("复读")) {
group.sendMessage(message.contentToString().replace("复读", ""))
}
if (message.contentToString() == "hi") {
group.sendMessage("hi")
}
message.forEach {
//循环每个元素在消息里
if (it is Image) {
//如果消息这一部分是图片
}
if (it is PlainText) {
//如果消息这一部分是纯文本
}
}
}
globalEventChannel().subscribeAlways(
FriendMessageEvent::class,
EmptyCoroutineContext,
Listener.ConcurrencyKind.CONCURRENT
) {
//好友信息
}
globalEventChannel().subscribeAlways(
NewFriendRequestEvent::class,
EmptyCoroutineContext,
Listener.ConcurrencyKind.CONCURRENT
) {
//自动同意好友申请
accept()
}
globalEventChannel().subscribeAlways(
BotInvitedJoinGroupRequestEvent::class,
EmptyCoroutineContext,
Listener.ConcurrencyKind.CONCURRENT
) {
//自动同意加群申请
accept()
}
v. 全部代码
这些代码是笔者整理的mirai-console插件kotlin版实例中的内容
package org.example.mirai.plugin
import net.mamoe.mirai.console.plugin.jvm.JvmPluginDescription
import net.mamoe.mirai.console.plugin.jvm.KotlinPlugin
import net.mamoe.mirai.event.Listener
import net.mamoe.mirai.event.events.BotInvitedJoinGroupRequestEvent
import net.mamoe.mirai.event.events.FriendMessageEvent
import net.mamoe.mirai.event.events.GroupMessageEvent
import net.mamoe.mirai.event.events.NewFriendRequestEvent
import net.mamoe.mirai.event.globalEventChannel
import net.mamoe.mirai.utils.info
import net.mamoe.mirai.message.data.Image
import net.mamoe.mirai.message.data.PlainText
import kotlin.coroutines.EmptyCoroutineContext
/*
在src/main/resources/plugin.yml里改插件信息和入口点
在settings.gradle.kts里改生成的插件.jar名称
用runmiraikt这个配置可以在ide里运行,不用复制到mcl或其他启动器
*/
object PluginMain : KotlinPlugin(
JvmPluginDescription(
id = "org.example.mirai-example",
version = "0.1.0"
)
) {
override fun onEnable() {
logger.info { "Plugin loaded" }
//配置文件目录 "${dataFolder.absolutePath}/"
globalEventChannel().subscribeAlways(
GroupMessageEvent::class,
EmptyCoroutineContext,
Listener.ConcurrencyKind.CONCURRENT
) {
//群消息
if (message.contentToString().startsWith("复读")) {
group.sendMessage(message.contentToString().replace("复读", ""))
}
if (message.contentToString() == "hi") {
group.sendMessage("hi")
}
message.forEach {
//循环每个元素在消息里
if (it is Image) {
//如果消息这一部分是图片
}
if (it is PlainText) {
//如果消息这一部分是纯文本
}
}
}
globalEventChannel().subscribeAlways(
FriendMessageEvent::class,
EmptyCoroutineContext,
Listener.ConcurrencyKind.CONCURRENT
) {
//好友信息
}
globalEventChannel().subscribeAlways(
NewFriendRequestEvent::class,
EmptyCoroutineContext,
Listener.ConcurrencyKind.CONCURRENT
) {
//自动同意好友申请
accept()
}
globalEventChannel().subscribeAlways(
BotInvitedJoinGroupRequestEvent::class,
EmptyCoroutineContext,
Listener.ConcurrencyKind.CONCURRENT
) {
//自动同意加群申请
accept()
}
}
}
vi. gradle部分代码
plugins {
val kotlinVersion = "1.4.21"
kotlin("jvm") version kotlinVersion
kotlin("plugin.serialization") version kotlinVersion
id("net.mamoe.mirai-console") version "2.0-M2"
}
group = "org.example"
version = "0.1.0"
repositories {
//国内镜像源
maven { url =uri("https://mirrors.huaweicloud.com/repository/maven") }
maven { url =uri("https://maven.aliyun.com/nexus/content/repositories/jcenter")}
maven { url =uri("https://dl.bintray.com/kotlin/kotlin-eap")}
mavenLocal()
mavenCentral()
jcenter()
maven("https://dl.bintray.com/kotlin/kotlin-eap")
}
dependencies{
implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.4.21")
}
其中2.0-M2
是目前最新开发版本,请自行通过官方文档选择版本
5. 在IDE内运行
i. 更改MiraiRunKt配置
把/src/test/kotlin/RunMirai.kt
中的qq号和密码改成你的
如果在根目录下没有run文件夹,则可能报错,新建一个就好了
ii.运行MiraiRunKt任务
如果任务报错先配置任务
然后配置登录配置
6. 生成插件并运行
i. 生成插件
用IDE中gradle的buldplugin
任务可以在buid/mirai/
下生成一个.jar插件文件
ii.在mcl中运行
把这个.jar文件放到mcl的plugin文件夹下,然后用cmd或者直接打开mcl.cmd运行
有什么评论区问,以后再补充
相关qq群 1044565129
-END-
Mirai框架qq机器人教程 新版的更多相关文章
- Mirai框架qq机器人教程
Mirai框架qq机器人教程 0.前言 1. 安装Java 2.安装Mirai启动器 3.下载IDEA或其他编译器 4.创建mirai-console插件项目 4.1 通过git创建 4.2 通过插件 ...
- Python+mirai开发QQ机器人起步教程(2021.9.9测试有效)
参考:开发 mirai QQ机器人起步教程_叹之-CSDN博客_mirai python 本篇文章参考了以上博客,并对其中的失效内容和版本匹配问题进行了补充修改,实测能够成功运行.部分步骤的运行截图见 ...
- 使用 GO-CQHttp或mirai框架 搭建QQ的机器人
我的博客 Go-CQHttp搭建QQ机器人 官方文档在这-->ATRU官方文档 Go-CQHttp + Atri 使用Linux系统部署 需求 服务器一台/带有Linux的机器 Python环境 ...
- Mirai qq机器人 c++版sdk(即用c++写mirai)
Mirai机器人c++版 前言 类似教程 本文git,gitee地址 c++开发mirai 原理 大概流程 实现 如何使用 注意事项 常见错误 前言 改分支版本以及过时,暂时不再维护 请看最新版kot ...
- 体验 QQ机器人C# SDK 1.X 特性总结
主要特性 依赖注入 框架本身采用 Autofac 作为依赖注入框架.进行插件开发时,必然会使用到该框架.建议开发者阅读官方文档熟悉其用法.https://autofac.readthedocs.io/ ...
- 使用C# 开始第一个QQ机器人
本示例将会使用”嘤鹉学舌”这个小插件的实现来演示如何使用Newbe.Mahua实现第一个机器人插件. 插件功能 自动将发送者的消息回发给发送人,嘤鹉(Parrot,其实是说嘤嘤嘤怪)学舌. 开发环境要 ...
- NoneBot+酷Q,打造QQ机器人
NoneBot 是一个基于 酷Q 的 Python 异步 QQ 机器人框架,它会对 QQ 机器人收到的消息进行解析和处理,并以插件化的形式,分发给消息所对应的命令处理器和自然语言处理器,来完成具体的功 ...
- 第一讲 从头开始做一个web qq 机器人,第一步获取smart qq二维码
新手教程: 前言:最近在看了一下很久很久以前做的qq机器人失效了,最近也在换工作目前还在职,时间很挺宽裕的.就决定从新搞一个web qq机器人 PC的协议解析出来有点费时间以后再做. 准备工作: 编译 ...
- 基于WebQQ3.0协议写一个QQ机器人
最近公司需要做个qq机器人获取qq好友列表,并且能够自动向选定的qq好友定时发送消息.没有头绪,硬着头皮上 甘甜的心情瞬间变得苦涩了 哇 多捞吆 1.WEBQQ3.0登陆协议 进入WEBQQ, htt ...
随机推荐
- Java 8 中的方法引用,轻松减少代码量,提升可读性!
1. 引言 Java8中最受广大开发中喜欢的变化之一是因为引入了 lambda 表达式,因为这些表达式允许我们放弃匿名类,从而大大减少了样板代码,并提高了可读性. 方法引用是lambda表达式的一种特 ...
- 数据结构与算法——图(游戏中的自动寻路-A*算法)
在复杂的 3D 游戏环境中如何能使非玩家控制角色准确实现自动寻路功能成为了 3D 游戏开 发技术中一大研究热点.其中 A*算法得到了大量的运用,A*算法较之传统的路径规划算法,实时性更高.灵活性更强, ...
- mysql全备、增量备份脚本
1.mysql全量备份及定时删除备份文件脚本 #!/bin/bash v_user="root" v_password="mysql" backup_date ...
- Unity 黑暗之光 笔记 第一章
第一章 设计游戏开始进入场景 1.设置相机视野同步 选中要调整的相机 GameObject - Align With View(快捷键 Ctrl + Shift + F)
- 统计文件行数,推荐使用LineNumberReader
一.主题: 读取文本文件最大行数性能比较:lineNumberReader > Files.lines 二.code 1 @Test 2 public void testLineReader() ...
- 【Unity】Unity中AR Foundation的使用
前段时间通过Unity 3d打包测试对比ARCore与ARKit环境探针的效果的过程中,在Google AR Core官网下载到了ARCore for Unity SDK,但是在苹果官网却没有找到AR ...
- js上 三、数据类型
3.1.什么是数据类型 a. 什么是数据类型? 想从生活中出发: 考验智商的时刻到了: 1(只)+1(只)=1(双) 3(天)+4(天)=1(周) 5(月)+7(月)=1(年) 4(时)+9(时)=1 ...
- 深度学习炼丹术 —— Taoye不讲码德,又水文了,居然写感知器这么简单的内容
手撕机器学习系列文章就暂时更新到此吧,目前已经完成了支持向量机SVM.决策树.KNN.贝叶斯.线性回归.Logistic回归,其他算法还请允许Taoye在这里先赊个账,后期有机会有时间再给大家补上. ...
- 容器编排系统k8s之Service资源
前文我们了解了k8s上的DemonSet.Job和CronJob控制器的相关话题,回顾请参考:https://www.cnblogs.com/qiuhom-1874/p/14157306.html:今 ...
- Docker 在搭建私有仓库配置镜像时候报错
今天搞私有镜像报了个错 ,看了,好久原来是 多了个空格 服务失败,因为控制进程退出时带有错误代码.参见"systemctl状态docker".详细信息参见"服务" ...