暫無描述

Karlatemp 1261ebfd89 FS 3 年之前
.github 75dc7ad5d6 Use JDK 17 on actions 3 年之前
.idea c9fe87d7f7 Remove submodule mirai-console 3 年之前
.run 76e2b6c64c Redesign packet recording 4 年之前
binary-compatibility-validator 6103628801 Remove __broadcastJava 3 年之前
buildSrc dc02b88bb6 mock 3 年之前
ci-release-helper f90320bd2b Snapshots publishing (#1465) 4 年之前
docs 478d246547 Update docs [no ci] 3 年之前
gradle f8bd475740 Use Gradle 7.3.1 3 年之前
logging b2d6baff4a Update docs for logging adapters 4 年之前
mirai-bom bca536b107 Fix publishing; fix #1733 3 年之前
mirai-console 7099244414 Fix `/login` without passwd 3 年之前
mirai-core 55fe85473a Remove unused variables 3 年之前
mirai-core-all 7faf630454 Update kotlin-jvm-blocking-bridge to 2.0.0-160.2 3 年之前
mirai-core-api 6103628801 Remove __broadcastJava 3 年之前
mirai-core-mock 1261ebfd89 FS 3 年之前
mirai-core-utils dc02b88bb6 mock 3 年之前
mirai-dokka d10d20302e Dokka (#1708) 3 年之前
.editorconfig 8799d653e6 Add `.editorconfig` for an unified style, use official Kotlin code style 4 年之前
.gitattributes ad1d75687a Update `.gitattributes` 3 年之前
.gitignore 8663978d65 Add `RecordingNoticeProcessor` 4 年之前
CONTRIBUTING.md d8e0136b8b Update CONTRIBUTING.md: add more details on building project 3 年之前
LICENSE adf0299c5d Original AGPLv3 5 年之前
README-eng.md aa98a10d12 Migrate references in docs 3 年之前
README.md 1f04ec83df Remove MavenCentral badge 3 年之前
build.gradle.kts 7faf630454 Update kotlin-jvm-blocking-bridge to 2.0.0-160.2 3 年之前
gradle.properties c0e885bc24 Set systemProp.use.maven.local to false 3 年之前
gradlew 78ae44d0e6 Add gradlew executable permission (#972) 4 年之前
gradlew.bat 78ae44d0e6 Add gradlew executable permission (#972) 4 年之前
settings.gradle.kts 6386c0d2c2 mock 3 年之前

README-eng.md

Mirai

Mirai is a high-performance multi-platform library, as well as a framework, providing protocol support for Tencent QQ.

Mirai is designed to handle all sorts of messaging works that can be automatically done by bots in a perfect way.

Tencent QQ: A modern messaging software used by all Chinese netizens.

Start

Development documentdocs

Use as a framework

Mirai is able to run as a plugin-supported framework.
The community, (with mirai-console) that allows developers to share their plugins, and for users to install plugins quickly, is building in progress.

  • JVM languages like Java or Kotlin: Make Jar plugin for mirai-console directly and share with other developers through the plugin center.
  • Kotlin Scriptmirai-kts supports plugins using Kotlin Scripts (kts)(OpenJDK 8+ only,except Android
  • Native languages like C, C++mirai-native supports plugins from CoolQ (Windows JREx86 only / with Wine)
  • JavaScriptmirai-js supports plugins using JavaScript and inter-operate with mirai on JVM directly.
  • Any language:Use HTTP API from mirai-api-http

Though only Jar plugins are supported officially, language bridges that are maintained by the community can connect with your knowledge.:

  • Python: python-mirai A Bot framework based on mirai-api-http.
  • JavaScript(Node.js): node-mirai The Node.js SDK for mirai.
  • Go: gomirai The GoLang SDK for mirai.
  • Mozilla Rhino: mirai-rhinojs-sdk The Mozilla Rhino (JavaScript) SDK for mirai.
  • Lua: lua-mirai The Lua SDK for mirai-core, supporting Java extensions that act as a bridge between Java and native Lua.
  • C++: miraiCP A C++ SDK using the JNI technique to connect the Mirai.
  • C++: mirai-cpp A simple C++ SDK using mirai-api-http for ALL platforms.
  • C++: miraipp A sophisticated, modern mapping for mirai-http-api to C++, providing development documents.
  • Rust: mirai-rs The Rust mapping for mirai-http-api.
  • TypeScript: mirai-ts TypeScript SDK comes with a declaration file, has good code hints, and can also be used as a JavaScript SDK.

Use as a library

You can install mirai as a library into your project.

Import with Gradle

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

repositories{
  jcenter()
}

Then add dependency to dependencies block, following:
If your project is a multiplatform project, you need to add dependencies for each platform respectively.
If your project is not a multiplatform project, add the platform-specific dependency only.

Replace VERSION with the newest version, say Download

jvm

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

common

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

android

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

Import with Maven

<repositories>
    <repository>
        <id>jcenter</id>
        <url>https://jcenter.bintray.com/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>net.mamoe</groupId>
        <artifactId>mirai-core-qqandroid</artifactId>
        <version>0.23.0</version> <!-- Replace to the newest -->
    </dependency>
</dependencies>

Contribution

All kinds of contributions are welcomed.
If you hold an interest in helping us implementing Mirai on JS, iOS or Native platforms, please email us support@mamoe.net.
If you meet any problem or have any questions, feel free to file an issue. Our goal is to make Mirai easy to use.

Acknowledgements

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

License

Copyright (C) 2019-2021 Mamoe Technologies and mirai contributors

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.