ModsFinder
MI

MiraiMC

by DreamVoid

MiraiMC connects a Minecraft server to the Mirai bot framework, letting a server run a QQ bot account from inside the game.

ForgeGNU Affero General Public License v3.0 or laterOpen source1.0 – 1.21.11

What it does

The library lets Minecraft servers talk to a Mirai bot, a high-performance multi-platform framework with support for the Tencent QQ protocol. Plugins that depend on MiraiMC log a bot account in through it, so the bot account is configured once and shared across plugins.

MiraiMC is published as a Forge build and also runs on Paper, Spigot, Bukkit, Purpur, Folia, Sponge, Velocity, BungeeCord and Waterfall. Its dependencies are loaded dynamically, which keeps the file small. Files cover 1.0 – 1.21.11, and 107 release versions are listed, with snapshot builds published as well.

Key features

  1. Mirai bot integration

    Connects a Minecraft server to a Mirai bot so the server can exchange messages with QQ.

  2. Cross-platform server support

    Works on Bukkit, Spigot, Sponge, Paper and proxies such as BungeeCord and Velocity.

  3. Dynamic library loading

    Dependent libraries are loaded at runtime, which keeps the size of the file small.

  4. Plugin template

    A template lets developers build new MiraiMC-based plugins with less setup.

Compatibility

Latest build for each game version and loader.

1.21.x5 of 5 versions with builds
1.21.420
1.21.320
1.21.220
1.21.120
1.2120
1.20.x7 of 7 versions with builds
1.20.620
1.20.520
1.20.420
1.20.320
1.20.220
1.20.120
1.2020
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
1.13.x3 of 3 versions with builds
1.12.x3 of 3 versions with builds
1.11.x3 of 3 versions with builds
1.10.x3 of 3 versions with builds
ReleaseBetaAlphaNot available

This mod also publishes snapshot builds. Snapshots are not shown in the matrix.

43 older game versions (1.0 – 1.9.4) not shown. All files on Modrinth

Questions

Does a plugin need MiraiMC to use a bot account?

Yes. Plugins that depend on MiraiMC log the bot account in through it, so the login is set up in MiraiMC's configuration.

Can MiraiMC run on a proxy server?

Yes. The mod supports BungeeCord and Velocity proxies in addition to regular game servers.

Is MiraiMC free to modify?

MiraiMC is open source under the GNU Affero General Public License v3.0 or later, and its source code is publicly available.

In the catalog

MiraiMC is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 19,862 mods support Minecraft 1.21.11.

Library mods3,514Forge modsMods for 1.21.1119,862

Similar mods

Cloth Config API1.14 – 26.3YetAnotherConfigLib (YACL)1.19 – 26.3Architectury API1.16.5 – 26.3Just Enough Items (JEI)1.8 – 26.3Geckolib1.12.2 – 26.3Forge Config API Port1.16 – 26.3

What the author says

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. Thanks to the following people/teams/projects for their contributions to MiraiMC!
DreamVoid, on the Modrinth page

Official listing

Owner
DreamVoid
Published
2023-07-24
Updated on Modrinth
2025-12-31
Facts verified
2026-10-15

Tags

LibraryManagementMagicUtility
Open on ModrinthCompare