MiraiMC

A mirai bot for Minecraft servers.

von
6.1K Downloads
bukkitbungeecordfoliaforgepaperpurpurspigotspongevelocitywaterfalllibrarymanagement
Server mit dieser Mod mieten

Über diese Mod

MiraiMC

GitHub release
CodeFactor
GitHub Actions CI
GitHub all releases


MiraiMC is a mirai bot for Minecraft servers

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.

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)

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 [protocol] Log in to a robot (you can execute this command multiple times to log in to multiple robots) miraimc.command.mirai.login
/mirai logout Log out and close a bot miraimc.command.mirai.logout
/mirai list List currently online bots miraimc.command.mirai.list
/mirai sendfriendmessage Send a message to a specified friend miraimc.command.mirai.sendfriendmessage
/mirai sendfriendnudge Send a stamp to a specified friend miraimc.command.mirai.sendfriendnudge
/mirai sendgroupmessage Send a message to the specified group miraimc.command.mirai.sendgroupmessage
/mirai checkonline Check if the specified robot is online miraimc.command.mirai.checkonline
/mirai autologin add [protocol] Add an autologin robot account miraimc.command.mirai.autologin
/mirai autologin remove 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 Add binding for player and QQ number miraimc.command.miraimc.bind
/miraimc bind getplayer Get the QQ number bound to the specified player name miraimc.command.miraimc.bind
/miraimc bind getqq Get the player name bound to the specified QQ number miraimc.command.miraimc.bind
/miraimc bind removeplayer Removes a player's bind miraimc.command.miraimc.bind
/miraimc bind removeqq 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
miraimc.command.miraimc Allow use of /miraimc OP
miraimc.command.miraimc.* Allow all subcommands of /miraimc OP
miraimc.command.miraimc.bind Allow /miraimc bind and subcommands OP
miraimc.command.miraimc.reload Allow /miraimc reload OP

LICENSE

GNU Affero General Public License v3.0

Acknowledgments

Thanks to the following people/teams/projects for their contributions to MiraiMC!

  • mamoe/mirai: Powerful QQ robot support library, the core and foundation of MiraiMC.
  • lucko/helper: Provide MiraiMC with a solution to dynamically load the mirai core.
  • brettwooldridge/HikariCP: An efficient SQL connection pool, providing database connection solutions for MiraiMC.
  • LT_Name: Optimized a lot of Nukkit code for MiraiMC, also provided a lot of help for MiraiMC.
  • You.

DreamVoid and MiraiMC, made with ❤.

This file is a translated version of the original file, and some semantics may differ from the original file.

Verfügbare Versionen

1.9.2release
MC 1.0, 1.1, 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.3, 1.3.1, 1.3.2, 1.4, 1.4.2, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.5, 1.5.1, 1.5.2, 1.6, 1.6.1, 1.6.2, 1.6.4, 1.7, 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8velocity
11. August 2025
1.9.2release
MC 1.0, 1.1, 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.3, 1.3.1, 1.3.2, 1.4, 1.4.2, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.5, 1.5.1, 1.5.2, 1.6, 1.6.1, 1.6.2, 1.6.4, 1.7, 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8sponge
11. August 2025
1.9.2release
MC 1.0, 1.1, 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.3, 1.3.1, 1.3.2, 1.4, 1.4.2, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.5, 1.5.1, 1.5.2, 1.6, 1.6.1, 1.6.2, 1.6.4, 1.7, 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bungeecord, waterfall
11. August 2025
1.9.2release
MC 1.0, 1.1, 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.3, 1.3.1, 1.3.2, 1.4, 1.4.2, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.5, 1.5.1, 1.5.2, 1.6, 1.6.1, 1.6.2, 1.6.4, 1.7, 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, folia, paper, purpur, spigot
11. August 2025
1.9.1release
MC 1.0, 1.1, 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.3.1, 1.3.2, 1.4.2, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.5.1, 1.5.2, 1.6.1, 1.6.2, 1.6.4, 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7bukkit, bungeecord, folia, paper, purpur, spigot, sponge, velocity, waterfall
16. Juli 2025

MiraiMC auf dem Server installieren

1

Server bestellen

Bestelle einen Minecraft Java Server mit mindestens 3 GB RAM (4 GB empfohlen).

2

bukkit Loader setzen

Wähle im Panel unter "Egg" den bukkit-Loader und die passende Minecraft-Version (1.21.11).

3

Mod installieren

Öffne den Mod-Browser im Dashboard und suche nach "MiraiMC". Klicke "Installieren" – fertig! Alternativ: Lade die .jar via SFTP in den /mods Ordner.

Kompatibilität

Mod-Loader

bukkitbungeecordfoliaforgepaperpurpurspigotspongevelocitywaterfall

Minecraft-Versionen

1.21.11, 1.21.10, 1.21.9 (+104 weitere)

Server-seitig

Nicht unterstützt

Empfohlener RAM

4 GB(min. 3 GB)

Häufige Fragen

MiraiMC Server crasht beim Start – was tun?

Häufigste Ursache: falsche bukkit-Version oder zu wenig RAM. Prüfe im Server-Log (latest.log), ob ein "OutOfMemoryError" oder "Mixin"-Fehler auftritt. Bei Mado Hosting: Stelle sicher, dass mindestens 3 GB RAM zugewiesen sind und der Loader zur Mod-Version passt (1.21.11). Über das Panel kannst du den Loader mit einem Klick wechseln.

Ist MiraiMC mit bukkit und bungeecord und folia und forge und paper und purpur und spigot und sponge und velocity und waterfall kompatibel?

MiraiMC unterstützt offiziell bukkit, bungeecord, folia, forge, paper, purpur, spigot, sponge, velocity, waterfall für Minecraft 1.21.11, 1.21.10, 1.21.9. Im Mado Dashboard werden inkompatible Loader-Kombinationen automatisch erkannt.

Server laggt mit MiraiMC – wie optimiere ich die Performance?

Empfohlener RAM: 4 GB (+1 GB pro 8 Spieler). Prüfe mit /spark profiler, ob MiraiMC den meisten Tick-Time verbraucht. Häufige Fixes: Server-View-Distance auf 8-10 reduzieren, bei Forge "performant" oder "starlight" als Zusatz-Mod installieren. Bei Mado Hosting läuft dein Server auf NVMe-SSDs mit dedizierten CPU-Kernen für minimale Latenz.

Modded Server mieten

Installiere MiraiMC mit nur einem Klick auf deinem Server.

Empfohlener RAM
4 GBab €5.2/Monat
Min. 3 GB | +1 GB pro 8 Spieler
Jetzt Server erstellen
1-Klick Mod Installation
NVMe SSD Speicher
DDoS-Schutz inklusive

Details

Lizenz
GNU Affero General Public License v3.0 or later
Server-seitig
Nicht unterstützt

Unterstützte Versionen

1.21.111.21.101.21.91.21.81.21.71.21.61.21.51.21.41.21.31.21.2+97 mehr