用kotlin/java构建一个Mirai插件 • Eritque Arcus

前言

构建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官方论坛官方demo mirai在线api文档

另，以下是一些资源: 笔者整理的mirai-console插件实例包含kt和java)

可能遇到的问题

MiraiOK已经没用了，用mcl(网址在上面)
最好用openjdk不过甲骨文的jdk好像也可以(建议用openjdk, 解释在下面)
根据issue#959目前邀请机器人进200+人的群都不会触发事件
插件id必须为类包格式(xxx.xxx.xxx)
有的时候收不到机器人的信息是因为被tx风控了换号或多发几次以及多挂(可以去论坛看看)
建议看一遍官方文档虽然有点乱
如果遇到问题，可以去mirai论坛上问
如果要在mcl内改登录协议，在login命令后加参数或在config/console/autologin.yml里面设置自动登录命令和登录的协议
mcl登录报错环境异常，参考论坛解决方案
改了入口点包路径需要到resources\META-INF\services\net.mamoe.mirai.console.plugin.jvm.JvmPlugin改成对应的类包路径

1.准备

i. 配置java环境

下载mcl所需要的是>=11版本的openjdk，openjdk下载地址，下载教程参考搜索引擎

最好用openjdk而不是甲骨文(Oracle)的jdk，原因

ii. 配置IDE

推荐IDEA吧，其他的也可以，主要是IDEA挺好用的可以选择安装的官方插件: Mirai Console IntelliJ 提供错误检查等功能 Kotlin Jvm Blocking Bridge 帮助 Java 用户调用 Kotlin suspend 函数详细参考官方文档

iii. 下载mirai-console-loader(mcl)作为启动器

官方地址教程同见官方说明

其他启动器

目前也出了其他启动器，查看这里

2.创建mirai-console插件项目

i. 下载

从官方实例或笔者整理的mirai-console插件实例中下载最新版的框架到本地，然后用IDE打开文件夹
使用插件生成，详细查看官网

ii. 个性化项目

在settings.gradle.kts里改生成的插件.jar名称也就是项目名称, 或者在build.gradle.kts里面获取shadowjar任务改如:

1
tasks {
2
    afterEvaluate {
3
        named<net.mamoe.mirai.console.gradle.BuildMiraiPluginTask>("buildPlugin") {
4
            archiveBaseName.set("name")
5
            archiveClassifier.set("")
6
            archiveVersion.set(version)
7
        }
8
    }
9
}

用RunMiraikt这个文件(在test文件夹下)可以在ide里运行，不用复制到mcl或其他启动器
用buildPlugin这个gradle任务可以生成.jar插件
在src/main/kotlin/PluginMain主类内可以修改插件信息(mcl用)
最好修改PluginMain.kt或JavaPluginMain.java的包名避免插件载入冲突,然后在resources\META-INF\services\net.mamoe.mirai.console.plugin.jvm.JvmPlugin中更改类包名到你改后的名，路径见下面

3. 文件夹结构解析

插件实例代码文件结构

1
│  build.gradle.kts gradle依赖列表
2
│  settings.gradle.kts gradle设置
3
│
4
├─.run
5
│      RunMiraiKt.run.xml IDE中运行任务配置，即RunMiraiKt源文件
6
│
7
├─run RunMiraiKt默认运行目录
8
│
9
└─src
10
    ├─main
11
    │  ├─kotlin
12
    │  │      PluginMain.kt  kotlin插件主类
13
    │  ├─Java
14
    │  │      JavaPluginMain.java java插件主类
15
  │  │
16
  │  ├─resources\META-INF\services
17
  │  │     net.mamoe.mirai.console.plugin.jvm.JvmPlugin Mirai加载的主类
18
    └─test
19
        └─kotlin
20
                RunMirai.kt RunMiraiKt任务配置

4.kotlin插件代码解析

代码以github上的代码为准，可能会有更新

i.所有在以下代码中要引入的库

1
//插件信息
2
import net.mamoe.mirai.console.plugin.jvm.JvmPluginDescription
3
//主类继承
4
import net.mamoe.mirai.console.plugin.jvm.KotlinPlugin
5
//机器人被拉进群的事件
6
import net.mamoe.mirai.event.events.BotInvitedJoinGroupRequestEvent
7
//收到好友信息事件
8
import net.mamoe.mirai.event.events.FriendMessageEvent
9
//收到群消息事件
10
import net.mamoe.mirai.event.events.GroupMessageEvent
11
//新好友申请事件
12
import net.mamoe.mirai.event.events.NewFriendRequestEvent
13
//日志组件(logger)发控制台信息函数
14
import net.mamoe.mirai.utils.info
15
//消息(messageChain)中的图片类型
16
import net.mamoe.mirai.message.data.Image
17
//消息(messageChain)中的纯文本类型
18
import net.mamoe.mirai.message.data.PlainText
19
//监听器
20
import net.mamoe.mirai.event.Listener
21
//监听范围
22
import net.mamoe.mirai.event.globalEventChannel
23
//协程范围?
24
import kotlin.coroutines.EmptyCoroutineContext

监听和事件参考官方文档

ii.构建主类

1
object PluginMain : KotlinPlugin(
2
    JvmPluginDescription(
3
        id = "org.example.mirai-example",
4
        version = "0.1.0"
5
    )
6
) {
7
}

其中，kotlinPlugin指继承plugin父类，JvmPluginDescription指声明插件消息和版本

iii.覆盖插件启用函数

1
override fun onEnable() {
2
    //或logger.info("xxx")作用一样
3
  logger.info { "Plugin loaded" }
4
}

用kotlin关键字override实现插件启用函数，然后用logger.info()进行日志输出，其中logger是kotlinPlugin类内成员，除了.info()还有.warning()输出警告和.error()输出报错

iv.监听事件

用 subscribeAlways<>{}这个函数在onEnable函数中开启监听(还可以subscribe或subscribeOnce见mirai文档)

1
    globalEventChannel().subscribeAlways<GroupMessageEvent>{
2
            //群消息
3
            if (message.contentToString().startsWith("复读")) {
4
                group.sendMessage(message.contentToString().replace("复读", ""))
5
            }
6
            if (message.contentToString() == "hi") {
7
                group.sendMessage("hi")
8
            }
9
            message.forEach {
10
                //循环每个元素在消息里
11
                if (it is Image) {
12
                    //如果消息这一部分是图片
13
                }
14
                if (it is PlainText) {
15
                    //如果消息这一部分是纯文本
16
                }
17
            }
18
        }
19
        globalEventChannel().subscribeAlways<FriendMessageEvent>{
20
            //好友信息
21
        }
22
        globalEventChannel().subscribeAlways<NewFriendRequestEvent>{
23
            //自动同意好友申请
24
            accept()
25
        }
26
        globalEventChannel().subscribeAlways<BotInvitedJoinGroupRequestEvent>{
27
            //自动同意加群申请
28
            accept()
29
        }

v. 全部代码

这些代码是笔者整理的mirai-console插件kotlin版实例中的内容

1
package org.example.mirai.plugin
2

3
import net.mamoe.mirai.console.plugin.jvm.JvmPluginDescription
4
import net.mamoe.mirai.console.plugin.jvm.KotlinPlugin
5
import net.mamoe.mirai.event.Listener
6
import net.mamoe.mirai.event.events.BotInvitedJoinGroupRequestEvent
7
import net.mamoe.mirai.event.events.FriendMessageEvent
8
import net.mamoe.mirai.event.events.GroupMessageEvent
9
import net.mamoe.mirai.event.events.NewFriendRequestEvent
10
import net.mamoe.mirai.event.globalEventChannel
11
import net.mamoe.mirai.message.code.MiraiCode
12
import net.mamoe.mirai.utils.info
13
import net.mamoe.mirai.message.data.Image
14
import net.mamoe.mirai.message.data.Image.Key.queryUrl
15
import net.mamoe.mirai.message.data.PlainText
16

17
/*
18
使用kotlin版请把
19
src/main/resources/META-INF.services/net.mamoe.mirai.console.plugin.jvm.JvmPlugin
20
文件内容改成"org.example.mirai.plugin.PluginMain"也就是当前主类
21
使用kt可以把java文件夹删除不会对项目有影响
22

23
在settings.gradle.kts里改生成的插件.jar名称
24
build.gradle.kts里改依赖库和插件版本
25
在主类下的JvmPluginDescription改插件名称，id和版本
26
用runmiraikt这个配置可以在ide里运行，不用复制到mcl或其他启动器
27
 */
28

29
object PluginMain : KotlinPlugin(
30
    JvmPluginDescription(
31
        id = "org.example.mirai-example",
32
        name = "插件示例",
33
        version = "0.1.0"
34
    )
35
) {
36
    override fun onEnable() {
37
        logger.info { "Plugin loaded" }
38
        //配置文件目录 "${dataFolder.absolutePath}/"
39

40
        globalEventChannel().subscribeAlways<GroupMessageEvent>{
41
            //群消息
42
            group.sendMessage("\uD83D\uDE03")
43
        }
44
        globalEventChannel().subscribeAlways<FriendMessageEvent>{
45
            //好友信息
46
            sender.sendMessage("hi")
47
        }
48
        globalEventChannel().subscribeAlways<NewFriendRequestEvent>{
49
            //自动同意好友申请
50
            accept()
51
        }
52
        globalEventChannel().subscribeAlways<BotInvitedJoinGroupRequestEvent>{
53
            //自动同意加群申请
54
            accept()
55
        }
56
    }
57
}

vi. gradle部分代码

1
plugins {
2
    val kotlinVersion = "1.4.30"
3
    kotlin("jvm") version kotlinVersion
4
    kotlin("plugin.serialization") version kotlinVersion
5
    id("net.mamoe.mirai-console") version "2.3.2"
6
}
7

8
group = "org.example"
9
version = "0.1.0"
10

11
repositories {
12
    jcenter()
13
    //国内镜像源
14
    //华为云
15
    maven { url =uri("https://mirrors.huaweicloud.com/repository/maven") }
16
    //阿里云
17
    maven { url =uri("https://maven.aliyun.com/nexus/content/repositories/jcenter")}
18
    //mirai-console的仓库
19
    maven {url = uri("https://dl.bintray.com/him188moe/mirai")}
20
    //滑动模块的仓库
21
    // maven { url = uri("https://dl.bintray.com/karlatemp/misc") }
22
    mavenLocal()
23
    mavenCentral()
24
}
25
dependencies{
26
    //在IDE内运行的mcl添加滑块模块，请参考https://github.com/project-mirai/mirai-login-solver-selenium把版本更新为最新
27
    //runtimeOnly("net.mamoe:mirai-login-solver-selenium:1.0-dev-15")
28
}

其中2.3.2是目前最新开发版本，请自行通过官方文档选择版本并更改更改版本

5. Java插件代码解析

i. 在下面代码中要引入的库

1
import net.mamoe.mirai.console.plugin.jvm.JavaPlugin;
2
//继承对象
3
import net.mamoe.mirai.console.plugin.jvm.JvmPluginDescriptionBuilder;
4
//构造插件信息
5
import net.mamoe.mirai.event.GlobalEventChannel;
6
//全局监听通道
7
import net.mamoe.mirai.event.events.FriendMessageEvent;
8
//好友信息事件
9
import net.mamoe.mirai.event.events.GroupMessageEvent;
10
//群消息事件

ii. 构建主类

构建mirai插件的主类也就是入口点，必须要继承JavaPlugin

1
public final class JavaPluginMain extends JavaPlugin {
2
    public static final JavaPluginMain INSTANCE = new JavaPluginMain();
3
    private JavaPluginMain() {
4
        super(new JvmPluginDescriptionBuilder("org.example.mirai-example", "0.1.0")
5
                .info("EG")
6
                .build());
7
    }
8
    }

其中JvmPluginDescriptionBuilder的声明插件信息

iii. 覆盖插件启用函数

1
@Override
2
    public void onEnable() {
3
        getLogger().info("日志");
4
     }

用getLogger()获取日志对象，然后用.info()发送普通日志

iv. 监听事件

1
GlobalEventChannel.INSTANCE.subscribeAlways(GroupMessageEvent.class, g -> {
2
            //监听群消息
3
            getLogger().info(g.getMessage().contentToString());
4

5
        });
6
        GlobalEventChannel.INSTANCE.subscribeAlways(FriendMessageEvent.class, f -> {
7
            //监听好友消息
8
            getLogger().info(f.getMessage().contentToString());
9
        });

v. 全部代码

1
package org.example.mirai.plugin;
2

3
import net.mamoe.mirai.console.plugin.jvm.JavaPlugin;
4
import net.mamoe.mirai.console.plugin.jvm.JvmPluginDescriptionBuilder;
5
import net.mamoe.mirai.event.GlobalEventChannel;
6
import net.mamoe.mirai.event.events.FriendMessageEvent;
7
import net.mamoe.mirai.event.events.GroupMessageEvent;
8

9
public final class JavaPluginMain extends JavaPlugin {
10
    public static final JavaPluginMain INSTANCE = new JavaPluginMain();
11
    private JavaPluginMain() {
12
        super(new JvmPluginDescriptionBuilder("org.example.mirai-example", "0.1.0")
13
                .info("EG")
14
                .build());
15
    }
16

17
    @Override
18
    public void onEnable() {
19
        getLogger().info("日志");
20

21
        GlobalEventChannel.INSTANCE.subscribeAlways(GroupMessageEvent.class, g -> {
22
            //监听群消息
23
            getLogger().info(g.getMessage().contentToString());
24

25
        });
26
        GlobalEventChannel.INSTANCE.subscribeAlways(FriendMessageEvent.class, f -> {
27
            //监听好友消息
28
            getLogger().info(f.getMessage().contentToString());
29
        });
30
    }
31
}