# 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 Scripting	iTXTech/mirai-kts open in new window
C++	Nambers/MiraiCP open in new window
JavaScript	iTXTech/mirai-js open in new window
酷 Q DLL 插件	iTXTech/mirai-native open in new window

# HTTP 接口

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

• Mirai HTTP open in new window 由 Mirai 开发团队提供第一级支持，目前多数 SDK 都基于它；
• OneBot open in new window 标准则兼容酷Q协议，可以让基于酷Q HTTP 插件的项目在 Mirai 平台运行。

名称	实现	维护者及项目地址
Mirai Http	Mirai 标准	mamoe/mirai-api-http open in new window
OneBot Http	OneBot open in new window 标准	yyuueexxiinngg/onebot-kotlin open in new window

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

语言和技术	维护者及项目地址
C#	Executor-Cheng/mirai-CSharp open in new window
C#	Hyperai open in new window
C#	Coloryr/ColorMirai open in new window
C#	AhpxChina/Mirai.Net open in new window
C#	Cyl18/Chaldene open in new window
C#	Miyakowww/CocoaFramework2 open in new window
C#	yuansicloud/Abp.Mirai open in new window
C++	cyanray/mirai-cpp open in new window
C++	Chlorie/miraipp open in new window
C++	Numendacil/cpp-mirai-client open in new window
GDScript	Xwdit/RainyBot-Core open in new window
Go	Logiase/gomirai open in new window
JavaScript / Node.js	RedBeanN/node-mirai open in new window
JavaScript / Node.js	drinkal/Mirai-js open in new window
JavaScript / TypeScript	YunYouJun/mirai-ts open in new window
JavaScript / TypeScript	nepsyn/miraipie open in new window
Julia	MiraiBots.jl open in new window
PHP	MiraiEz open in new window
PHP	MR-XieXuan/MiraiTravel open in new window
Python	AliceBot open in new window
Python	Ariadne open in new window
Python	Avilla open in new window
Python	easyMirai open in new window
Python	Edoves open in new window
Python	Elaina open in new window
Python	NoneBot open in new window
Python	jerrita/saaya open in new window
Python	YiriMirai open in new window
Python	Excaive/miraicle open in new window
Ruby	Shimogawa/rubirai open in new window
Rust	HoshinoTented/mirai-rs open in new window
易语言	only52607/e-mirai open in new window
易语言	Novices666/mirai-epl open in new window

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

特别地，有一些 SDK 直接基于 mirai-core 开发，不需要 mirai-console open in new window ：

• Lua : lua-mirai open 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-world open 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 开发的开源项目在论坛发布。

• 在论坛发布 open in new window

# 文档

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 开发文档。