ColorMirai

一个基于Mirai 的机器人框架

官方QQ群：571239090

索引列表

• 构建说明
• 启动
  • 无法登录
• 插件连接
  • Socket数据包
• 示例
• 使用ColorMirai的插件

构建说明

需要JAVA11环境

不提供二进制文件，请自行构建

运行环境看你的构建环境

构建不了可以去群里找人要

请根据自己的系统先安装JDK11并且设置好环境变量

• 安装git
• 右键打开git bash
  输入下面的指令（如果慢的话, 可能需要梯子等工具辅助下载）

git clone https://github.com/Coloryr/ColorMirai.git
cd ColorMirai
./gradlew shadowJar

在BUILD SUCCESSFUL之后, 你会在以下路径找到一个jar文件

build/libs/ColorMirai-2.0-SNAPSHOT-all.jar

启动

1. 启动ColorMirai，必须使用JAVA11及以上

java -jar ColorMirai-2.X-SNAPSHOT-all.jar

首次启动后, 会生成info.json和MainConfig.json文件
info.json是设备名称，不需要特别设置
MainConfig.json是配置文件

2. 默认配置

MainConfig.json

{
    "MaxList": 100000,
    "Pack": true,
    "Port": 23333,
    "QQs": [
        {
            "QQ": 1234567890,
            "Password": "qwe123456789"
        }
    ],
    "Type": 0,
    "escapeSelf": true
}

• MaxList：最大消息列表
• Pack：是否发送心跳包
• Port：启动的端口
• QQs : QQ账号列表 (可以添加多个)
  • QQ：登录的QQ号
  • Password：QQ号密码
• Type：登录的方式
• 目前支持两种协议:
  • 安卓 [0]
  • 手表 [1]
• escapeSelf：是否跳过自己机器人的信息

设置完成后再次启动ColorMirai，出现[INFO] Socket已启动: 23333 说明机器人已成功启动

无法登录临时解决

1. 将协议切换成手表 [1]
2. 登录成功后, 下次登录可以选择安卓 [0]

插件连接

插件第一次连接需要发送json注册包

{
  "Name": "test",
  "Reg": [49,50,51]
}

• Name：插件名字
• Reg：监听的包

注意：所有包必须带ID，否则无法识别，只有标注（事件）的包才会被监听

数据包

大部分数据包是一串JSON字符串+数据包ID构成
但是发送图片和发送语音用的是FormData格式

注：经测试Server 2008存在数据包断包和丢包的现象，请切换到Server 2019使用

以字符串的方式看
{...}[ID]
以byte[]的方式看
123,...,125,[ID]

[ID]对应数据包的ID

目前重要的ID：

0 插件开始连接
49 [机器人]收到群消息（事件）
50 [机器人]收到群临时会话消息（事件）
51 [机器人]收到朋友消息（事件）

52 [插件]发送群消息
53 [插件]发送私聊消息
54 [插件]发送好友消息

60 心跳包

61 [插件]发送图片到群
62 [插件]发送图片到私聊
63 [插件]发送图片到朋友

只有正确的发包，才能处理
更多包请看PackDo.java
每个包需要发送的数据都在/Pack路径下的java
标注为[机器人]是框架发给插件的
标注为[插件]是插件发送给框架的

目前的示例代码

C#
JAVA
示例代码不包含Main函数，可以作为库用

使用ColorMirai的插件

Minecraft_QQ_Gui/Cmd
GitHubPush

懒得写了（jiushi）