MiraiMC

MiraiMC - это плагин для серверов Minecraft, который позволяет подключить бота на базе библиотеки Mirai для работы с китайским мессенджером Tencent QQ. Если вы администрируете сервер и хотите автоматизировать общение с игроками, рассылать уведомления или управлять сервером прямо из чата - этот плагин вам пригодится.

Mirai - это высокопроизводительная мультиплатформенная библиотека, которая обеспечивает поддержку протоколов Tencent QQ. По сути, это фреймворк для создания ботов, которые могут выполнять любые задачи автоматически: от приветствия новых игроков до сложных команд управления.

Что умеет MiraiMC

Плагин поддерживает Bukkit/Sponge сервера, а также прокси BungeeCord и Velocity. Оптимизирован для работы на системах без графического интерфейса - например, на Linux серверах. Динамически подгружает зависимые библиотеки, чтобы не раздувать размер файла.

Как установить

1. Скачайте MiraiMC из раздела "Featured versions" и установите как обычный плагин.
2. Настройте плагины, которые зависят от MiraiMC (если такие есть), и войдите в аккаунт бота.

Более подробный туториал есть в документации по ссылке: https://docs.miraimc.dreamvoid.me/

Для разработчиков

Если хотите написать свой плагин на основе MiraiMC - есть готовые шаблоны для Maven и Gradle KotlinDSL. Javadoc доступен по адресу: https://jd.miraimc.dreamvoid.me

Подключение зависимости

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'

Команды и права доступа

Команды

Команда	Описание	Права
/mirai	Главная команда бота	miraimc.command.mirai
/mirai login <аккаунт> <пароль> [протокол]	Войти в аккаунт бота (можно несколько раз для нескольких ботов)	miraimc.command.mirai.login
/mirai logout <аккаунт>	Выйти и отключить бота	miraimc.command.mirai.logout
/mirai list	Показать список онлайн-ботов	miraimc.command.mirai.list
/mirai sendfriendmessage <аккаунт> <друг> <сообщение>	Отправить сообщение другу	miraimc.command.mirai.sendfriendmessage
/mirai sendfriendnudge <аккаунт> <друг>	Отправить "тык" другу	miraimc.command.mirai.sendfriendnudge
/mirai sendgroupmessage <аккаунт> <группа> <сообщение>	Отправить сообщение в группу	miraimc.command.mirai.sendgroupmessage
/mirai checkonline <аккаунт>	Проверить, онлайн ли бот	miraimc.command.mirai.checkonline
/mirai autologin add <аккаунт> <пароль> [протокол]	Добавить аккаунт для автовхода	miraimc.command.mirai.autologin
/mirai autologin remove <аккаунт>	Удалить аккаунт автовхода	miraimc.command.mirai.autologin
/mirai autologin list	Список аккаунтов автовхода	miraimc.command.mirai.autologin
/miraimc	Команда плагина MiraiMC	miraimc.command.miraimc
/miraimc bind add <игрок>	Привязать игрока к QQ-номеру	miraimc.command.miraimc.bind
/miraimc bind getplayer <игрок>	Получить QQ по нику игрока	miraimc.command.miraimc.bind
/miraimc bind getqq	Получить ник по QQ-номеру	miraimc.command.miraimc.bind
/miraimc bind removeplayer <игрок>	Удалить привязку игрока	miraimc.command.miraimc.bind
/miraimc bind removeqq	Удалить привязку QQ-номера	miraimc.command.miraimc.bind
/miraimc reload	Перезагрузить конфиг	miraimc.command.miraimc.reload

Права доступа

Узел прав	Описание	По умолчанию
miraimc.command.mirai	Разрешить использование /mirai	OP
miraimc.command.mirai.*	Все подкоманды /mirai	OP
miraimc.command.mirai.login	Разрешить /mirai login	OP
miraimc.command.mirai.logout	Разрешить /mirai logout	OP
miraimc.command.mirai.list	Разрешить /mirai list	OP
miraimc.command.mirai.sendfriendmessage	Разрешить /mirai sendfriendmessage	OP
miraimc.command.mirai.sendfriendnudge	Разрешить /mirai sendfriendnudge	OP
miraimc.command.mirai.sendgroupmessage	Разрешить /mirai sendgroupmessage	OP
miraimc.command.mirai.checkonline	Разрешить /mirai checkonline	OP
miraimc.command.mirai.autologin	Разрешить /mirai autologin	OP
miraimc.command.miraimc	Разрешить использование /miraimc	OP
miraimc.command.miraimc.*	Все подкоманды /miraimc	OP
miraimc.command.miraimc.bind	Разрешить /miraimc bind и подкоманды	OP
miraimc.command.miraimc.reload	Разрешить /miraimc reload	OP

Лицензия

GNU Affero General Public License v3.0