欢迎来到 mirai 开发文档。
本文面向要进行开发的用户。对于只使用现成插件的用户,请阅读 用户手册。
mirai 官方提供 Kotlin/Java 等 JVM 平台语言开发支持 。如果不熟悉这些语言,请使用以下社区 SDK:
要使用这些社区 SDK 需要先配置 Mirai Console,可以使用 一键安装 (32位,带 HTTP 插件),也可以阅读 用户手册 进行个性化安装。
你可以使用一个或多个语言来开发插件,而且在自己开发的同时也可以使用下载的插件。
这些接口直接在 JVM 上实现,不需要中间件,拥有更佳的性能。
技术 | 维护者及项目地址 |
---|---|
Kotlin Scripting |
iTXTech/mirai-kts |
C++ |
Nambers/MiraiCP |
JavaScript |
iTXTech/mirai-js |
酷 Q DLL 插件 | iTXTech/mirai-native |
目前有两个 HTTP 协议插件。使用 HTTP 协议插件可以支持更多编程语言和技术。
- Mirai HTTP 由 Mirai 开发团队提供第一级支持,目前多数 SDK 都基于它;
- OneBot 标准则兼容酷Q协议,可以让基于酷Q HTTP 插件的项目在 Mirai 平台运行。
名称 | 实现 | 维护者及项目地址 |
---|---|---|
Mirai Http | Mirai 标准 | mamoe/mirai-api-http |
OneBot Http | OneBot 标准 | yyuueexxiinngg/onebot-kotlin |
下表列举基于 Mirai HTTP
插件实现对一些编程语言支持的项目列表。要使用它们,你需要在 Mirai Console 安装 mirai-api-http
(如果使用上面的一键安装则不需要额外操作)。
语言和技术 | 维护者及项目地址 |
---|---|
C# |
Executor-Cheng/mirai-CSharp |
C# |
Hyperai |
C# |
Coloryr/ColorMirai |
C# |
AhpxChina/Mirai.Net |
C# |
Miyakowww/CocoaFramework2 |
C++ |
cyanray/mirai-cpp |
C++ |
Chlorie/miraipp |
GDScript |
Xwdit/RainyBot-Core |
Go |
Logiase/gomirai |
JavaScript / Node.js |
RedBeanN/node-mirai |
JavaScript / Node.js |
drinkal/Mirai-js |
JavaScript / TypeScript |
YunYouJun/mirai-ts |
JavaScript / TypeScript |
nepsyn/miraipie |
Julia |
MiraiBots.jl |
PHP |
nkxingxh/miraiez |
Python |
Ariadne |
Python |
Avilla |
Python |
Edoves |
Python |
Elaina |
Python |
NoneBot |
Python |
jerrita/saaya |
Python |
YiriMirai |
Python |
Excaive/miraicle |
Ruby |
Shimogawa/rubirai |
Rust |
HoshinoTented/mirai-rs |
易语言 |
only52607/e-mirai |
按字母顺序排序,排序不代表排名
* 想在这里添加你的项目?欢迎提交 PR 。*
特别地,有一些 SDK 直接基于 mirai-core 开发,不需要 mirai-console
:
Lua
: lua-mirai
Mirai 原生支持 Java、Kotlin 等 JVM 平台编程语言。
要使用 Mirai,可以使用 mirai-core 作为一个依赖库获得机器人功能,也可以为 mirai-console 开发插件。
生态详情可阅读:Mirai 生态概览。
本节介绍使用 Java、Kotlin 等 JVM 平台编程语言使用 mirai-core 作为一个依赖库获得机器人功能。 这通常适用于你在开发一个其他应用程序而需要使用机器人功能的情况。
如果你希望先体验 mirai 的机器人功能,可克隆 mirai-hello-world 并在 IDE 内运行其中 Kotlin 或 Java 入口点
main
。
本节介绍使用 Java、Kotlin 等 JVM 平台编程语言基于 mirai-core,开发可于 mirai-console 加载的插件来提供机器人功能。 这通常适用于你为了开发一个机器人程序的情况。开发 mirai-console 插件既可以单独使用,也可以使用来自社区的其他插件。
-
阅读 mirai-core 文档
mirai-core 文档可让你了解如何使用 Bot 功能。 -
阅读 mirai-console 文档 mirai-console 文档可让你了解 mirai-console 的一些系统。
欢迎各类基于 mirai 开发的开源项目在论坛发布。
请在 CoreAPI.md 阅读 JVM 平台的 mirai-core 开发文档。
可在 https://kdoc.mirai.mamoe.net/ 查看 KDoc(类似 JavaDoc)。但更建议使用 IntelliJ IDEA 等 IDE 在开发时查询源码内文档。
请在 mirai-console/docs 阅读 mirai-console 开发文档。