説明なし

Him188 5eb2ee8711 Update mirai-core-all/build.gradle.kts 4 年 前
.github faebbde94c Do not publish on release created 4 年 前
.idea 29fb83e1f6 Add VCS root $PROJECT_DIR$/mirai-console 4 年 前
binary-compatibility-validator 430c2c59ad Support UnsupportedMessage (#1112) 4 年 前
buildSrc b7743307a7 Configure Proguard for mirai-core-all 4 年 前
ci-release-helper fb2632073b Auto release to maven central 4 年 前
docs 0723c5c568 Release version 2.5.0 4 年 前
gradle 7867294f4d Remove maven local and kotlinx jcenter repositories 4 年 前
mirai-console @ 5dc1c90ac4 0723c5c568 Release version 2.5.0 4 年 前
mirai-core 430c2c59ad Support UnsupportedMessage (#1112) 4 年 前
mirai-core-all 5eb2ee8711 Update mirai-core-all/build.gradle.kts 4 年 前
mirai-core-api 430c2c59ad Support UnsupportedMessage (#1112) 4 年 前
mirai-core-utils 0f41c225f9 Move SerialDescriptor.copy to mirai-core-utils 4 年 前
.editorconfig 9f7dec2643 Add `.editorConfig` 5 年 前
.gitignore 3fbbba9cfa Revert ".gitignore: Change `build/` to `/build/`" 4 年 前
.gitmodules fb36321953 Fix gitmodules 4 年 前
CONTRIBUTING.md 77122dd445 Update CONTRIBUTING.md 4 年 前
LICENSE adf0299c5d Original AGPLv3 5 年 前
README-eng.md a5d920146b 增加社区SDK? 4 年 前
README.md 90a1fdbb89 Update docs 4 年 前
build.gradle.kts f9353b6aef Compiled code verify (#1080) 4 年 前
gradle.properties d6bb8fa844 Target Android API 24 4 年 前
gradlew 78ae44d0e6 Add gradlew executable permission (#972) 4 年 前
gradlew.bat 78ae44d0e6 Add gradlew executable permission (#972) 4 年 前
settings.gradle.kts 7867294f4d Remove maven local and kotlinx jcenter repositories 4 年 前

README-eng.md

Mirai

Codacy Badge

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/>.