Mirai

欢迎来到 mirai 开发文档。

本文面向要进行开发的用户。对于只使用现成插件的用户,请阅读 用户手册

Mirai 生态概览

Mirai VuePress 文档open in new window

社区 SDK

mirai 官方提供 Kotlin/Java 等 JVM 平台语言开发支持 。如果不熟悉这些语言,请使用以下社区 SDK:

要使用这些社区 SDK 需要先配置 Mirai Console,可以使用 一键安装open in new window (32位,带 HTTP 插件),也可以阅读 用户手册 进行个性化安装。

你可以使用一个或多个语言来开发插件,而且在自己开发的同时也可以使用下载的插件

原生接口

这些接口直接在 JVM 上实现,不需要中间件,拥有更佳的性能。

技术维护者及项目地址
Kotlin ScriptingiTXTech/mirai-ktsopen in new window
C++Nambers/MiraiCPopen in new window
JavaScriptiTXTech/mirai-jsopen in new window
酷 Q DLL 插件iTXTech/mirai-nativeopen in new window

HTTP 接口

目前有两个 HTTP 协议插件。使用 HTTP 协议插件可以支持更多编程语言和技术。

名称实现维护者及项目地址
Mirai HttpMirai 标准mamoe/mirai-api-httpopen in new window
OneBot HttpOneBotopen in new window 标准yyuueexxiinngg/onebot-kotlinopen in new window

下表列举基于 Mirai HTTP 插件实现对一些编程语言支持的项目列表。要使用它们,你需要在 Mirai Console 安装 mirai-api-httpopen in new window(如果使用上面的一键安装则不需要额外操作)。

语言和技术维护者及项目地址
C#Executor-Cheng/mirai-CSharpopen in new window
C#Hyperaiopen in new window
C#Coloryr/ColorMiraiopen in new window
C#AhpxChina/Mirai.Netopen in new window
C#Cyl18/Chaldeneopen in new window
C#Miyakowww/CocoaFramework2open in new window
C++cyanray/mirai-cppopen in new window
C++Chlorie/miraippopen in new window
GDScriptXwdit/RainyBot-Coreopen in new window
GoLogiase/gomiraiopen in new window
JavaScript / Node.jsRedBeanN/node-miraiopen in new window
JavaScript / Node.jsdrinkal/Mirai-jsopen in new window
JavaScript / TypeScriptYunYouJun/mirai-tsopen in new window
JavaScript / TypeScriptnepsyn/miraipieopen in new window
JuliaMiraiBots.jlopen in new window
PHPnkxingxh/miraiezopen in new window
PythonAliceBotopen in new window
PythonAriadneopen in new window
PythonAvillaopen in new window
PythoneasyMiraiopen in new window
PythonEdovesopen in new window
PythonElainaopen in new window
PythonNoneBotopen in new window
Pythonjerrita/saayaopen in new window
PythonYiriMiraiopen in new window
PythonExcaive/miraicleopen in new window
RubyShimogawa/rubiraiopen in new window
RustHoshinoTented/mirai-rsopen in new window
易语言only52607/e-miraiopen in new window
易语言Novices666/mirai-eplopen in new window

按字母顺序排序,排序不代表排名
* 想在这里添加你的项目?欢迎提交 PRopen in new window 。*

特别地,有一些 SDK 直接基于 mirai-core 开发,不需要 mirai-consoleopen in new window

使用 Mirai

Mirai 原生支持 Java、Kotlin 等 JVM 平台编程语言。

要使用 Mirai,可以使用 mirai-core 作为一个依赖库获得机器人功能,也可以为 mirai-console 开发插件。

生态详情可阅读:Mirai 生态概览

JVM 平台 mirai-core 开发

本节介绍使用 Java、Kotlin 等 JVM 平台编程语言使用 mirai-core 作为一个依赖库获得机器人功能。 这通常适用于你在开发一个其他应用程序而需要使用机器人功能的情况。

  1. JVM 环境和开发准备工作
  2. 配置 mirai-core 项目依赖
  3. 阅读 mirai-core 文档

如果你希望先体验 mirai 的机器人功能,可克隆 mirai-hello-worldopen in new window 并在 IDE 内运行其中 Kotlin 或 Java 入口点 main

JVM 平台 mirai-console 插件开发

本节介绍使用 Java、Kotlin 等 JVM 平台编程语言基于 mirai-core,开发可于 mirai-console 加载的插件来提供机器人功能。 这通常适用于你为了开发一个机器人程序的情况。开发 mirai-console 插件既可以单独使用,也可以使用来自社区的其他插件。

  1. JVM 环境和开发准备工作

  2. 配置 mirai-console 插件项目

  3. 阅读 mirai-core 文档
    mirai-core 文档可让你了解如何使用 Bot 功能。

  4. 阅读 mirai-console 文档 mirai-console 文档可让你了解 mirai-console 的一些系统。

多平台 mirai-core 开发

本节介绍使用 Kotlin 使用 mirai-core 开发 Kotlin 多平台open in new window 应用程序。

  1. JVM 环境和开发准备工作
  2. 配置 mirai-core 多平台项目依赖
  3. 阅读 mirai-core 文档

发布项目

欢迎各类基于 mirai 开发的开源项目在论坛发布。

文档

mirai 在 GitHub 托管的文档可让你简要了解各个系统。

mirai 的源码内注释十分详细,包含各种实践示例。

mirai-core 文档

请在 CoreAPI.md 阅读 JVM 平台的 mirai-core 开发文档。

mirai-core API KDoc

可在 https://kdoc.mirai.mamoe.net/open in new window 查看基于源码内注释生成的 KDoc(类似 JavaDoc)。 但更建议使用 IntelliJ IDEA 等 IDE 在开发时查询源码内注释。

mirai-console 文档

请在 mirai-console/docs 阅读 mirai-console 开发文档。