Перейти к содержимому
Mineforgian

MiraiMC

A mirai bot for Minecraft servers.

6K загрузок17 подписчиковAGPL-3.0-or-laterbukkitbungeecordfoliaforgepaperpurpurspigotspongevelocitywaterfall

Обновлён 31 декабря 2025 г. · опубликован 24 июля 2023 г.

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.

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
23-VelocityАльфа1.21.8, 1.21.9, 1.21.10, 1.21.11velocity31 декабря 2025 г..jar (237 КБ)
23-SpongeАльфа1.21.8, 1.21.9, 1.21.10, 1.21.11sponge31 декабря 2025 г..jar (241 КБ)
23-BungeeАльфа1.21.8, 1.21.9, 1.21.10, 1.21.11bungeecord, waterfall31 декабря 2025 г..jar (224 КБ)
23-BukkitАльфа1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot31 декабря 2025 г..jar (233 КБ)
22-VelocityРелиз1.21.5, 1.21.6, 1.21.7, 1.21.8velocity11 августа 2025 г..jar (233 КБ)
22-SpongeРелиз1.21.5, 1.21.6, 1.21.7, 1.21.8sponge11 августа 2025 г..jar (237 КБ)
22-BungeeРелиз1.21.5, 1.21.6, 1.21.7, 1.21.8bungeecord, waterfall11 августа 2025 г..jar (220 КБ)
22-BukkitРелиз1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, folia, paper, purpur, spigot11 августа 2025 г..jar (230 КБ)
21Релиз1.21.4, 1.21.5, 1.21.6, 1.21.7bukkit, bungeecord, folia, paper, purpur, spigot, sponge, velocity, waterfall16 июля 2025 г..jar (229 КБ)
20Релиз1.21.1, 1.21.2, 1.21.3, 1.21.4bukkit, bungeecord, folia, forge, paper, purpur, spigot, sponge, velocity, waterfall19 января 2025 г..jar (229 КБ)
19Бета1.21.1, 1.21.2, 1.21.3, 1.21.4bukkit, bungeecord, folia, paper, purpur, spigot, sponge, velocity, waterfall19 января 2025 г..jar (229 КБ)
18Бета1.21.1, 1.21.2, 1.21.3, 1.21.4bukkit, bungeecord, folia, paper, purpur, spigot, sponge, velocity, waterfall4 января 2025 г..jar (229 КБ)
17-VelocityАльфа1.20.5, 1.20.6, 1.21, 1.21.1velocity17 октября 2024 г..jar (269 КБ)
17-SpongeАльфа1.16.2, 1.16.3, 1.16.4, 1.16.5sponge17 октября 2024 г..jar (273 КБ)
17-BungeeАльфа1.20.5, 1.20.6, 1.21, 1.21.1bungeecord, waterfall17 октября 2024 г..jar (255 КБ)

Показаны последние 15 из 36 версий. Все версии — на Modrinth.

Ченджлог

23-VelocityАльфа1.21.9, 1.21.10, 1.21.11 · 31 декабря 2025 г.

这是一个预发布版本，部分功能仍在测试，请及时反馈在本版本发现的问题。

致服主：

  • 此版本开始使用 Java 17，低于 Java 17 将无法加载本插件。
  • 此版本更改了许多 API 方法，如果你正在使用依赖 MiraiMC 的插件，建议等待插件开发者更新后再升级版本。

致开发者：

  • 此版本开始使用 Java 17，如果正在使用低于 Java 17 进行开发，请提升版本到 Java 17。
  • 由于 Maven 中央仓库政策更新，无法将 pom.xml 中包含 SNAPSHOT 版本依赖的构件上传到中央仓库，受此影响，Bukkit、Nukkit 和 Velocity 平台的构件从此版本开始不会上传到中央仓库。如需继续使用中央仓库构件，请改为使用 MiraiMC-Integration，或者使用 JitPack。

更新日志

主代码

新增

  • Java 版本提升至 17
  • 为 HTTP 下载添加超时

优化和修复

  • 将控制台显示的文本语言改为中文
  • 优化SQLite数据库优化连接
  • 修复数据库连接泄漏问题
  • 优化WebAPI获取逻辑
  • 更新上游依赖版本
  • 代码细节优化

Bukkit

优化和修复

  • 提取私有方法

由 GitHub 生成的版本说明见下

What's Changed

Full Changelog: https://github.com/DreamVoid/MiraiMC/compare/v1.9.2...v1.10-pre1

下载说明

  • MiraiMC-Bukkit.jar - 适用于CraftBukkit（如Spigot、Paper）服务端
  • MiraiMC-Bungee.jar - 适用于BungeeCord（如WaterFall）服务端
  • MiraiMC-Nukkit.jar - 适用于NukkitX服务端
  • MiraiMC-Sponge.jar - 适用于SpongeVanilla和SpongeForge服务端
  • MiraiMC-Velocity.jar - 适用于Velocity服务端
23-SpongeАльфа1.21.9, 1.21.10, 1.21.11 · 31 декабря 2025 г.

这是一个预发布版本，部分功能仍在测试，请及时反馈在本版本发现的问题。

致服主：

  • 此版本开始使用 Java 17，低于 Java 17 将无法加载本插件。
  • 此版本更改了许多 API 方法，如果你正在使用依赖 MiraiMC 的插件，建议等待插件开发者更新后再升级版本。

致开发者：

  • 此版本开始使用 Java 17，如果正在使用低于 Java 17 进行开发，请提升版本到 Java 17。
  • 由于 Maven 中央仓库政策更新，无法将 pom.xml 中包含 SNAPSHOT 版本依赖的构件上传到中央仓库，受此影响，Bukkit、Nukkit 和 Velocity 平台的构件从此版本开始不会上传到中央仓库。如需继续使用中央仓库构件，请改为使用 MiraiMC-Integration，或者使用 JitPack。

更新日志

主代码

新增

  • Java 版本提升至 17
  • 为 HTTP 下载添加超时

优化和修复

  • 将控制台显示的文本语言改为中文
  • 优化SQLite数据库优化连接
  • 修复数据库连接泄漏问题
  • 优化WebAPI获取逻辑
  • 更新上游依赖版本
  • 代码细节优化

Bukkit

优化和修复

  • 提取私有方法

由 GitHub 生成的版本说明见下

What's Changed

Full Changelog: https://github.com/DreamVoid/MiraiMC/compare/v1.9.2...v1.10-pre1

下载说明

  • MiraiMC-Bukkit.jar - 适用于CraftBukkit（如Spigot、Paper）服务端
  • MiraiMC-Bungee.jar - 适用于BungeeCord（如WaterFall）服务端
  • MiraiMC-Nukkit.jar - 适用于NukkitX服务端
  • MiraiMC-Sponge.jar - 适用于SpongeVanilla和SpongeForge服务端
  • MiraiMC-Velocity.jar - 适用于Velocity服务端
23-BungeeАльфа1.21.9, 1.21.10, 1.21.11 · 31 декабря 2025 г.

这是一个预发布版本，部分功能仍在测试，请及时反馈在本版本发现的问题。

致服主：

  • 此版本开始使用 Java 17，低于 Java 17 将无法加载本插件。
  • 此版本更改了许多 API 方法，如果你正在使用依赖 MiraiMC 的插件，建议等待插件开发者更新后再升级版本。

致开发者：

  • 此版本开始使用 Java 17，如果正在使用低于 Java 17 进行开发，请提升版本到 Java 17。
  • 由于 Maven 中央仓库政策更新，无法将 pom.xml 中包含 SNAPSHOT 版本依赖的构件上传到中央仓库，受此影响，Bukkit、Nukkit 和 Velocity 平台的构件从此版本开始不会上传到中央仓库。如需继续使用中央仓库构件，请改为使用 MiraiMC-Integration，或者使用 JitPack。

更新日志

主代码

新增

  • Java 版本提升至 17
  • 为 HTTP 下载添加超时

优化和修复

  • 将控制台显示的文本语言改为中文
  • 优化SQLite数据库优化连接
  • 修复数据库连接泄漏问题
  • 优化WebAPI获取逻辑
  • 更新上游依赖版本
  • 代码细节优化

Bukkit

优化和修复

  • 提取私有方法

由 GitHub 生成的版本说明见下

What's Changed

Full Changelog: https://github.com/DreamVoid/MiraiMC/compare/v1.9.2...v1.10-pre1

下载说明

  • MiraiMC-Bukkit.jar - 适用于CraftBukkit（如Spigot、Paper）服务端
  • MiraiMC-Bungee.jar - 适用于BungeeCord（如WaterFall）服务端
  • MiraiMC-Nukkit.jar - 适用于NukkitX服务端
  • MiraiMC-Sponge.jar - 适用于SpongeVanilla和SpongeForge服务端
  • MiraiMC-Velocity.jar - 适用于Velocity服务端
23-BukkitАльфа1.21.9, 1.21.10, 1.21.11 · 31 декабря 2025 г.

这是一个预发布版本，部分功能仍在测试，请及时反馈在本版本发现的问题。

致服主：

  • 此版本开始使用 Java 17，低于 Java 17 将无法加载本插件。
  • 此版本更改了许多 API 方法，如果你正在使用依赖 MiraiMC 的插件，建议等待插件开发者更新后再升级版本。

致开发者：

  • 此版本开始使用 Java 17，如果正在使用低于 Java 17 进行开发，请提升版本到 Java 17。
  • 由于 Maven 中央仓库政策更新，无法将 pom.xml 中包含 SNAPSHOT 版本依赖的构件上传到中央仓库，受此影响，Bukkit、Nukkit 和 Velocity 平台的构件从此版本开始不会上传到中央仓库。如需继续使用中央仓库构件，请改为使用 MiraiMC-Integration，或者使用 JitPack。

更新日志

主代码

新增

  • Java 版本提升至 17
  • 为 HTTP 下载添加超时

优化和修复

  • 将控制台显示的文本语言改为中文
  • 优化SQLite数据库优化连接
  • 修复数据库连接泄漏问题
  • 优化WebAPI获取逻辑
  • 更新上游依赖版本
  • 代码细节优化

Bukkit

优化和修复

  • 提取私有方法

由 GitHub 生成的版本说明见下

What's Changed

Full Changelog: https://github.com/DreamVoid/MiraiMC/compare/v1.9.2...v1.10-pre1

下载说明

  • MiraiMC-Bukkit.jar - 适用于CraftBukkit（如Spigot、Paper）服务端
  • MiraiMC-Bungee.jar - 适用于BungeeCord（如WaterFall）服务端
  • MiraiMC-Nukkit.jar - 适用于NukkitX服务端
  • MiraiMC-Sponge.jar - 适用于SpongeVanilla和SpongeForge服务端
  • MiraiMC-Velocity.jar - 适用于Velocity服务端
22-VelocityРелиз1.21.6, 1.21.7, 1.21.8 · 11 августа 2025 г.

这是一个正式版本。此版本已经过测试确认没有大的问题，可以使用，建议所有用户和开发者都更新到此版本。

如果在本版本遇到任何问题，请提交 issue。

致服主：MiraiMC 将改用 Java 17 作为开发环境。许多插件，如 ViaVersion，已更激进的使用了 Java 21，没有合适的理由继续停留在 Java 8。请做好升级准备，尤其是 Minecraft 1.12.2 及以下版本，MiraiMC 1.10 开始将不再支持 Java 8。此版本将是最后一个支持 Java 8 的版本。

更新日志

主代码

优化和修复

  • 优化数据库加载流程

Full Changelog: https://github.com/DreamVoid/MiraiMC/compare/v1.9.1...v1.9.2

下载说明

  • MiraiMC-Bukkit.jar - 适用于 Bukkit（如 Spigot、Paper、Folia）服务端
  • MiraiMC-Bungee.jar - 适用于 BungeeCord（如 WaterFall）服务端
  • MiraiMC-Nukkit.jar - 适用于 NukkitX 服务端
  • MiraiMC-Sponge.jar - 适用于 SpongeVanilla 和 SpongeForge 服务端
  • MiraiMC-Velocity.jar - 适用于 Velocity 服务端
22-SpongeРелиз1.21.6, 1.21.7, 1.21.8 · 11 августа 2025 г.

这是一个正式版本。此版本已经过测试确认没有大的问题，可以使用，建议所有用户和开发者都更新到此版本。

如果在本版本遇到任何问题，请提交 issue。

致服主：MiraiMC 将改用 Java 17 作为开发环境。许多插件，如 ViaVersion，已更激进的使用了 Java 21，没有合适的理由继续停留在 Java 8。请做好升级准备，尤其是 Minecraft 1.12.2 及以下版本，MiraiMC 1.10 开始将不再支持 Java 8。此版本将是最后一个支持 Java 8 的版本。

更新日志

主代码

优化和修复

  • 优化数据库加载流程

Full Changelog: https://github.com/DreamVoid/MiraiMC/compare/v1.9.1...v1.9.2

下载说明

  • MiraiMC-Bukkit.jar - 适用于 Bukkit（如 Spigot、Paper、Folia）服务端
  • MiraiMC-Bungee.jar - 适用于 BungeeCord（如 WaterFall）服务端
  • MiraiMC-Nukkit.jar - 适用于 NukkitX 服务端
  • MiraiMC-Sponge.jar - 适用于 SpongeVanilla 和 SpongeForge 服务端
  • MiraiMC-Velocity.jar - 适用于 Velocity 服务端
22-BungeeРелиз1.21.6, 1.21.7, 1.21.8 · 11 августа 2025 г.

这是一个正式版本。此版本已经过测试确认没有大的问题，可以使用，建议所有用户和开发者都更新到此版本。

如果在本版本遇到任何问题，请提交 issue。

致服主：MiraiMC 将改用 Java 17 作为开发环境。许多插件，如 ViaVersion，已更激进的使用了 Java 21，没有合适的理由继续停留在 Java 8。请做好升级准备，尤其是 Minecraft 1.12.2 及以下版本，MiraiMC 1.10 开始将不再支持 Java 8。此版本将是最后一个支持 Java 8 的版本。

更新日志

主代码

优化和修复

  • 优化数据库加载流程

Full Changelog: https://github.com/DreamVoid/MiraiMC/compare/v1.9.1...v1.9.2

下载说明

  • MiraiMC-Bukkit.jar - 适用于 Bukkit（如 Spigot、Paper、Folia）服务端
  • MiraiMC-Bungee.jar - 适用于 BungeeCord（如 WaterFall）服务端
  • MiraiMC-Nukkit.jar - 适用于 NukkitX 服务端
  • MiraiMC-Sponge.jar - 适用于 SpongeVanilla 和 SpongeForge 服务端
  • MiraiMC-Velocity.jar - 适用于 Velocity 服务端
22-BukkitРелиз1.21.6, 1.21.7, 1.21.8 · 11 августа 2025 г.

这是一个正式版本。此版本已经过测试确认没有大的问题，可以使用，建议所有用户和开发者都更新到此版本。

如果在本版本遇到任何问题，请提交 issue。

致服主：MiraiMC 将改用 Java 17 作为开发环境。许多插件，如 ViaVersion，已更激进的使用了 Java 21，没有合适的理由继续停留在 Java 8。请做好升级准备，尤其是 Minecraft 1.12.2 及以下版本，MiraiMC 1.10 开始将不再支持 Java 8。此版本将是最后一个支持 Java 8 的版本。

更新日志

主代码

优化和修复

  • 优化数据库加载流程

Full Changelog: https://github.com/DreamVoid/MiraiMC/compare/v1.9.1...v1.9.2

下载说明

  • MiraiMC-Bukkit.jar - 适用于 Bukkit（如 Spigot、Paper、Folia）服务端
  • MiraiMC-Bungee.jar - 适用于 BungeeCord（如 WaterFall）服务端
  • MiraiMC-Nukkit.jar - 适用于 NukkitX 服务端
  • MiraiMC-Sponge.jar - 适用于 SpongeVanilla 和 SpongeForge 服务端
  • MiraiMC-Velocity.jar - 适用于 Velocity 服务端

Полная история изменений — на Modrinth.

Комментарии

Загружаем…