<div align="center"> <h1> MiraiMC </h1> (https://img.shields.io/github/v/release/DreamVoid/MiraiMC?style=flat-square )](https://github.com/DreamVoid/MiraiMC/releases/latest) (https://www.codefactor.io/Content/badges/A.svg)](https://www.codefactor.io/repository/github/dreamvoid/miraimc) (https://img.shields.io/github/actions/workflow/status/DreamVoid/MiraiMC/maven.yml?style=flat-square)](https://github.com/DreamVoid/MiraiMC/actions/workflows/maven.yml?query=is%3Asuccess) !(https://img.shields.io/github/downloads/DreamVoid/MiraiMC/total?style=flat-square) </div> --- MiraiMC is a (https://github.com/mamoe/mirai) bot for Minecraft servers > Mirai is a high-performance multi-platform library, as well as a framework, providing protocol support for Tencent QQ.<br> > Mirai is designed to handle all sorts of messaging works that can be automatically done by bots in a perfect way.<br> > Tencent QQ: A modern messaging software used by all Chinese netizens. ## Features * Support Bukkit/Sponge servers. * Support BungeeCord/Velocity proxies. * Optimized for GUI-less OS such as Linux * Dynamically load dependent libraries to minimize file size. ## Getting Started (Server) 1. Download MiraiMC from "Featured versions" part. Then install it like installing other plugins. 2. Configure any plugins' that depend on MiraiMC (if any) and login to your bot account A more detailed tutorial can be found here: https://docs.miraimc.dreamvoid.me/ ## Getting Started (Plugin Developer) * It is simple to develop a new MiriMC-based plugin by using template: - (https://github.com/MiraiMC/MiraiMC-Template) - (https://github.com/MiraiMC/MiraiMC-Template-Gradle-KotlinDSL) * MiraiMC javadoc here: https://jd.miraimc.dreamvoid.me * Detailed development tutorial here: https://docs.miraimc.dreamvoid.me/ ### Dependency #### Maven ``` <dependency> <groupId>io.github.dreamvoid</groupId> <artifactId>MiraiMC-Integration</artifactId> <version>1.9</version> <scope>provided</scope> </dependency> ``` #### Gradle ``` implementation 'io.github.dreamvoid:MiraiMC-Integration:1.9' ``` ## Commands and permissions ### Commands | Command | Description | Permissions | | ---- | --- | ---- | | /mirai | MiraiMC Robot Command | miraimc.command.mirai | | /mirai login <account> <password> \ | Log in to a robot (you can execute this command multiple times to log in to multiple robots) | miraimc.command.mirai.login | | /mirai logout <account> | Log out and close a bot | miraimc.command.mirai.logout | | /mirai list | List currently online bots | miraimc.command.mirai.list | | /mirai sendfriendmessage <account> <friend> <message> | Send a message to a specified friend | miraimc.command.mirai.sendfriendmessage | | /mirai sendfriendnudge <account> <friend> | Send a stamp to a specified friend | miraimc.command.mirai.sendfriendnudge | | /mirai sendgroupmessage <account> <group> <message> | Send a message to the specified group | miraimc.command.mirai.sendgroupmessage | | /mirai checkonline <account> | Check if the specified robot is online | miraimc.command.mirai.checkonline | | /mirai autologin add <account> <password> \ | Add an autologin robot account | miraimc.command.mirai.autologin | | /mirai autologin remove <account> | Remove an autologin bot account | miraimc.command.mirai.autologin | | /mirai autologin list | View autologin robot account list | miraimc.command.mirai.autologin | | /miraimc | MiraiMC Plugin Command | miraimc.command.miraimc | | /miraimc bind add <player> <QQ> | Add binding for player and QQ number | miraimc.command.miraimc.bind | | /miraimc bind getplayer <player> | Get the QQ number bound to the specified player name | miraimc.command.miraimc.bind | | /miraimc bind getqq <QQ> | Get the player name bound to the specified QQ number | miraimc.command.miraimc.bind | | /miraimc bind removeplayer <player> | Removes a player's bind | miraimc.command.miraimc.bind | | /miraimc bind removeqq <QQ> | Delete the binding of a QQ number | miraimc.command.miraimc.bind | | /miraimc reload | Reload configuration file | miraimc.command.miraimc.reload | ### Permissions | Permission Node | Description | Default | | ------- | ---- | ---- | | miraimc.command.mirai | Allow use of `/mirai` | OP | | miraimc.command.mirai.* | Allow all subcommands of `/mirai` | OP | | miraimc.command.mirai.login | Allow `/mirai login` | OP | | miraimc.command.mirai.logout | Allow `/mirai logout` | OP | | miraimc.command.mirai.list | Allow `/mirai list` | OP | | miraimc.command.mirai.sendfriendmessage | Allow `/mirai sendfriendmessage` | OP | | miraimc.command.mirai.sendfriendnudge | Allow `/mirai sendfriendnudge` | OP | | miraimc.command.mirai.sendgroupmessage | Allow `/mirai sendgroupmessage` | OP | | miraimc.command.mirai.checkonline | Allow `/mirai checkonline` | OP | | miraimc.command.mirai.autologin | Allow `/mirai autologin` | OP |