mirai

Mirai

Coroutine-based open-source multiplatform library of QQ protocol.
Some of the protocol came from the other open-source projects.

The development is only for learning, DO NOT use it for illegal purposes.

UpdateLog

You can inspect supported protocols at Project
and logs of updates at UpdateLog

Use as a library

You can install mirai as a library into your project.

Mirai is only published on jcenter, therefore please ensure you have the jcenter() repository in your build.gradle, like:

repositories{
  jcenter()
}

If your project is a multiplatform project, you should add dependencies for each platform respectively.
If your project is not a multiplatform project, you just need to add the platform-specific dependency.

VERSION should be replaced with the newest version, say
Mirai is still under experimental stage, it is suggested to keep the version newest.

common

implementation("net.mamoe:mirai-core-common:VERSION")

jvm

implementation("net.mamoe:mirai-core-jvm:VERSION")

android

implementation("net.mamoe:mirai-core-android:VERSION")

Try

On JVM or Android

Mirai is now available to work.

val bot = Bot(qqId, password).alsoLogin()
bot.subscribeMessages {
  "Hello" reply "World!"
  "profile" reply { sender.queryProfile() }
  contains("img"){ File(imagePath).send() }
}
bot.subscribeAlways<MemberPermissionChangedEvent> {
  if (it.kind == BECOME_OPERATOR)
    reply("${it.member.id} has become a operator")
}

1. Clone this GitHub project
2. Import as Gradle project
3. Run demo main functions: mirai-demo

Contribution

Any kinds of contribution is welcomed. If you hold a interest in helping us implementing Mirai on JS, iOS or Native platforms, please email me Him188@mamoe.net If you meet any problem or have any questions, be free to open a issue. Our goal is to make Mirai easy to use.

Requirements

Kotlin 1.3.61

On JVM: Java 6
On Android: SDK 15

Using java

Q: Can I use Mirai without Kotlin?
A: Calling from java is not yet supported. Coroutines, extensions and inlines, which are difficult to use from Java, are generally used in Mirai. Therefore you should have the skill of Kotlin before you use Mirai.

Libraries used

Mirai uses these open-source libraries.

• kotlin-stdlib
• kotlinx-coroutines
• kotlinx-io
• kotlin-reflect
• pcap4j
• atomicfu
• ktor
• klock
• tornadofx
• javafx
• kotlinx-serialization

Acknowledgement

Thanks to JetBrains for allocating free open-source licences for IDEs such as IntelliJ IDEA.