MiraiMC：让你的服务器登录QQ机器人

DreamVoid

MiraiMC —— 适用于Minecraft服务端的QQ机器人插件

介绍 什么是 MiraiMC？ MiraiMC 是一个基于 Mirai 的 Bukkit 插件，能够让你在Minecraft服务器上使用 Mirai QQ 机器人程序，同时提供一些 API 帮助开发者简单的调用机器人接口为自己的插件实现多样的功能。 特性 支持多个机器人同时登录 支持启动服务端后自动登录 兼容 Mirai 目录结构，方便快速迁移 插件级别的 QQ 绑定，提供最方便的管理 可拓展程度高，带有完善的接口 支持HTTP API工作模式，连接到MCL多插件共用一个机器人（实验性特性） 开发者不断整活新功能，尽可能提供帮助 还有更多……等待你的发掘！ 开始使用 服主 如果你是服主，正在被接入 QQ 机器人所困扰（尤其是 Linux 和面板服），那么只需要下载本插件即可方便快捷的接入并使用 QQ 机器人且无需使用额外的软件。 请按下面的步骤开始使用 MiraiMC： 下载插件，并将插件文件放入 plugins 文件夹 下载基于 MiraiMC 开发的其他插件（如果有的话），并将这些插件放入 plugins 文件夹 启动服务端（如果尚未启动）或使用诸如PlugMan的插件加载插件 使用指令“/mirai login <账号> <密码>”登录你的机器人账号（可执行多次以登录多个机器人） 如果你同时使用了基于MiraiMC开发的插件，请在这些插件的配置文件中调整有关 MiraiMC 的配置 享受优雅的 QQ 机器人服务！ 可以在这里找到更为详细的使用教程：https://wiki.miraimc.dreamvoid.ml/ 插件开发者 如果你是插件开发者，正在考虑让自己的插件能够对接QQ机器人，那么只需要使用本插件提供的API即可方便快捷的实现需求而无需让服主进行额外的配置。 你可以简单的使用MiraiMC开发模板来开始开发一个全新的插件 你也可以为现有插件引入 MiraiMC，只需按照以下步骤即可接入 MiraiMC： 将下面的代码复制到 pom.xml 的 dependencies 项或直接将插件 jar 文件作为外部库导入 <dependency>     <groupId>io.github.dreamvoid</groupId>     <artifactId>MiraiMC-Integration</artifactId>     <!--请确保版本为Github上的最新版本-->     <version>1.6</version>     <scope>provided</scope> </dependency> 复制代码 参照 Javadoc或MiraiMC 开发模板编写相关的代码 发布你的插件 可以在这里找到更为详细的开发教程：https://wiki.miraimc.dreamvoid.ml/ 常见问题 1. 为什么总会莫名其妙的出现这样或那样的报错？ 请尽量避免使用Forge服务端（如Catserver、Loliserver、Mohist、Arclight之类的支持安装mod的Bukkit服务端），这类服务端通常会修改插件的工作方式以“兼容”mod或原版游戏的工作。我不再帮助解决因使用上述服务端导致的任何问题，请自行联系相关服务端作者解决兼容性问题。 如果你没有使用Forge服务端，则可以通过将服务端日志文件回复给置顶楼层或者前往Github Issue Tracker提交问题。 2. 为什么我开的Issue/Pull Request被直接关闭了？ ①你没有按照要求开Issue，我不会花费时间去理解不按模板提交的issue。②你的Issue在之前已经有人提过了，为了处理效率不接受两个相同问题的Issue。③你在Gitee等其他Git平台提交了PR，除了Github外，所有Git平台都是Github的镜像，都从Github拉取代码，因此不接受其他Git平台的PR。 3. 为什么出现报错“JCE cannot authenticate the provider BC” 此问题不影响正常使用，可直接忽略。如果你不想看见这个报错，请阅读此链接给出的解决方案，如无效或者你无法理解解决方案，请确保你使用的是未被修改过的Java。我推荐使用Azul Zulu。另外，有报告称出现此问题的用户使用了OpenJ9，如果你正在使用，可尝试更换Hotspot版本。 4. 我看其他同类机器人插件都说Linux/面板服不能登录，让我去下载这个或那个软件，我要怎么用你这个插件？ MiraiMC已经完全重写登录验证流程，不会存在其他不完善插件的问题。当你登录机器人账号时，插件会引导你完成登录验证。请放心在Linux等无图形界面的系统环境使用。 指令与权限 指令 命令 描述 权限 /mirai MiraiMC 机器人主命令 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 sendfgroupmessage <账号> <群号> <消息> 向指定群发送消息 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号> 为玩家和QQ号添加绑定 miraimc.command.miraimc.bind /miraimc bind getplayer <玩家名> 获取指定玩家名绑定的QQ号 miraimc.command.miraimc.bind /miraimc bind getqq <QQ号> 获取指定QQ号绑定的玩家名 miraimc.command.miraimc.bind /miraimc bind removeplayer <玩家名> 删除一个玩家的绑定 miraimc.command.miraimc.bind /miraimc bind removeqq <QQ号> 删除一个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 配置文件 受限于排版格式，请移步此处查看完整的配置文件说明：https://wiki.miraimc.dreamvoid.ml/docs/configure-file PlaceholderAPI 变量 请先运行命令/papi ecloud download miraimc，然后才能使用以下变量。 %miraimc_counts% - 存在的机器人数量 %miraimc_isonline_<bot>% - 指定机器人是否在线 %miraimc_nick_<bot>% - 指定机器人昵称 %miraimc_friendcounts_<bot>% - 指定机器人好友数量 %miraimc_groupcounts_<bot>% - 指定机器人群数量 %miraimc_bindqq% - 当前玩家绑定的 QQ 号 %miraimc_bindqq_<player/uuid>% - 指定玩家绑定的 QQ 号 %miraimc_bindname_<qq>% - 指定 QQ 绑定的玩家 UUID %miraimc_binduuid_<qq>% - 指定 QQ 绑定的玩家名 使用 MiraiMC 的插件 Link2QQ：将QQ与Minecraft账号绑定！ Chat2QQ：与QQ群的玩家畅快聊天！ Whitelist4QQ：在QQ群内自助申请Minecraft白名单！ QQConnect：简单易用的服务器互通机器人插件 AntiaddictionByQQ：通过绑定QQ查询的防沉迷插件 MiraiMCAutoReply：高度自定义自动回复插件 MiraiMCConsole：Q群管理服务器后台插件 这里可以是你的插件！（请私信告诉我） 已知 Bug 如果你遇到任何 Bug，请通过在 Github 上提交 issue的方式进行反馈，我将在之后进行功能补充和完善。 在非图形界面环境下登录带设备锁或验证码的账号时无法完成验证 （1.3 已修复） 极少数情况可能出现插件载入、机器人登录问题 （1.3 已修复） 在BungeeCord使用时无法使用自动登录机器人功能 （1.4、1.5 已修复） BungeeCord和Sponge的自动登录机器人无法添加账号 兼容性报告 以下资源已确认不支持 MiraiMC。你可以点击这里查看更多信息。 Cauldron 下载 正式版：，测试版： 为帖子评分解锁下载地址支持我继续开发（评分人气不消耗自己的人气） 本帖使用下载地址回复可见功能，回复前请先点我阅读相关版规 如果你想不违反版规又想立刻下载到插件，你可以复制下面这段话直接回复避免违反版规 MiraiMC 真棒，是一款很优秀的插件！ 复制代码 游客，如果您要查看本帖隐藏内容请回复 开源 Github：https://github.com/DreamVoid/MiraiMC Gitee：https://gitee.com/dreamvoid/MiraiMC 更多帮助&外部链接 插件帮助手册：https://wiki.miraimc.dreamvoid.ml/ 插件Javadoc开发文档：https://docs.miraimc.dreamvoid.ml/ 致谢 感谢以下人员/项目为 MiraiMC 提供的支持： mamoe/mirai：高效率 QQ 机器人支持库，MiraiMC 的根本 lucko/helper：强大的 Bukkit 插件开发帮手，为 MiraiMC 提供动态加载 mirai 核心的解决方案 brettwooldridge/HikariCP：高效率 MySQL 连接池 bStats：Metrics 统计工具 特别感谢 JetBrains 为开源项目提供免费的 IntelliJ IDEA 等 IDE 的授权 在 Github 提供建议和反馈的每一位用户，是你们的建议和反馈让 MiraiMC 变得更好 在使用 MiraiMC 的每一个服主，你们的鼓励是我不断开发的动力 下一步的目标 牙膏要一点一点挤，显卡要一刀一刀切，PPT要一张一张放，代码要一行一行写，单个功能预计自出现在此列表起，三年内开发完毕 [√] 初步实现 CoreAPI 的基础功能 [√] 初步完善指令和权限系统 [√] 初步完善 API 接口供其他插件开发者调用 [√] 加入自动登录机器人的功能（1.2实现） [√] 添加剩余未添加的Mirai事件（1.2实现） [√] 支持 BungeeCord（1.3实现） [√] 重写登录流程以适应 Bukkit（和未来支持的 Bungee，甚至 Sponge）（1.3实现） [√] 完全兼容 mirai console 的结构供已在使用mirai的服主使用 [√] 支持 Sponge（1.5实现） [√] 支持 PlaceholderAPI（1.5实现） [√] 引入 Mirai-Http-API 模式来连接到mirai-console（1.6实现） [√] 支持 Velocity（1.6实现） [  ] 像 mirai console 一样加载 mirai console 插件（遥遥无期，欢迎PR） 本插件所用代码部分来自其他开源或闭源(已授权)作品 更新日志 可移步 Github 发布页面查看更为完整的更新日志：https://github.com/DreamVoid/MiraiMC/releases 1.5 -> 1.6 主代码 新增 发送消息命令支持空格与换行符 #60 减小插件体积 为消息事件增加回复和发送消息方法 增加方法 isBotMuted getBotMuteTimeRemaining #67 Mirai 版本升级为 2.9.2 所有**实例增加 isImageEmoji 方法 所有图片上传成功事件增加 isEmoji 方法 支持读取和修改群匿名聊天开关 为**实例增加 sendMusicShare 方法 添加HTTP API支持 添加新的Exception用于流程控制 添加新的配置文件项 为所有好友事件增加getFriend()方法 为所有群事件增加getGroup()方法 为所有群员事件增加getMember()方法 为所有临时会话事件增加getMember()方法 MiraiBot 增加方法 getAsFriend() 为HTTP API模式下的事件增加发送消息 为HTPP API模式下的事件增加方法getType() 代码细节优化 优化和修复 修复潜在的 Log4J 漏洞 修复需要引入依赖时不应该压缩导致插件无法正常使用的问题 调整自动登录协议选择流程 优化自动登录保存流程 登录机器人命令支持动态选择协议 代码细节优化 更新Javadoc 更正编码问题 更改命令的工作方式以兼容HTTP API 修复“一行有多条语句”问题 修复 Misplaced default in switch statement 修复 Avoid using finalizer method. 修复 All overloaded methods should be placed next to each other. 修复 switch without "default" clause. 优化报错提示 Bukkit 优化和修复 拆分命令类 调整Forge服务端的启动提示 Bungee 优化和修复 修复自动登录问题 Nukkit 优化和修复 优化命令工作方式（感谢 @lt-name ） 修复日志问题 Sponge 优化和修复 修复自动登录问题 Velocity 新增 增加Velocity支持 优化和修复 修复Velocity登录机器人命令线程不执行的Bug 1.5.1 主代码 优化和修复 改用 shade 方式打包插件 修复自动检查更新的异常 修复 Maven 中央仓库没有 Sponge 相关接口 更改所有事件中 getMessage() 的工作方式 Sponge 优化和修复 修复版本号问题 1.5 主代码 新增 为事件增加撤回方法 增加自动更新Mirai核心库 配置文件增加指定Mirai核心版本 配置文件增加指定Maven仓库地址 添加友好报错功能（同时添加配置文件） 减小插件文件体积 修复插件启动时报错 加入自动检查更新 MiraiBot 添加方法 getNick() MiraiBot 添加方法 getID() MiraiBot 添加方法 getFriendList() MiraiBot 添加方法 getGroupList() MiraiBot 添加方法 getStrangersList() 为事件方法getMessage()添加提示信息 优化和修复 完善出错机制避免出错时继续执行不该执行的代码 修改部分功能的工作方式 优化报错提示 优化使用指令操作插件时的提示 移除不兼容的方法 完善外部加载Mirai核心 更新开发时使用的Mirai核心 优化插件报错提示 完善依赖下载流程 maven仓库地址自动转换http到https 修复捕获报错问题 修复“参数化类的原始使用” 修复“方法只调用它的超级” 代码细节优化 更新Javadoc Bukkit 新增 添加PlaceholderAPI变量 优化和修复 启动不兼容的服务端时向后台发送警告 修正plugin.yml笔误 Bungee 新增 内置SQLite-jdbc库 优化和修复 修复过时的方法 移除不必要的异常捕获 修复不自动下载Mirai核心问题 Nukkit 新增 支持NukkitX 重写Logger 增加Metrics 优化和修复 修改API号 自动登录保存文件添加报错捕获 Sponge 新增 支持Sponge 重写Logger 增加Metrics 增加Mirai事件监听 优化和修复 修复特定情况下加载插件崩溃问题 修复配置加载问题 修正Logger类的笔误 修复配置加载报错问题 修改bStats警告到中文 字数过多，先前版本的更新日志可前往Github查看。

DreamVoid

我已关闭主题帖回复通知，如有意见建议请回复本楼，或者去 Github Issue Tracker 提出。
反馈插件无法使用请带上服务器日志去开 issue，否则我无法解决，也不会回复你。

szzz666

支持pnx吗

Mrxiaozhu

牛的，哈哈哈支持！

老笛罚

很好的插件爱来自瓷器

ndifferent

MiraiMC 真棒，是一款很优秀的插件！

FR丶

MiraiMC 真棒，是一款很优秀的插件！

1965984121

真别说，还挺方便

你是人间盛世颜

MiraiMC 真棒，是一款很优秀的插件！

ShanZhe杉者

MiraiMC 真棒，是一款很优秀的插件！

q1030290917

Unexpected exception while parsing console command "mirai"
org.bukkit.command.CommandException: Cannot execute command 'mirai' in plugin MiraiMC v1.6.1 - plugin is disabled.
        at org.bukkit.command.PluginCommand.execute(PluginCommand.java:37) ~[patched_1.16.5.jar:git-Paper-794]
        at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:159) ~[patched_1.16.5.jar:git-Paper-794]
        at org.bukkit.craftbukkit.v1_16_R3.CraftServer.dispatchCommand(CraftServer.java:826) ~[patched_1.16.5.jar:git-Paper-794]
        at org.bukkit.craftbukkit.v1_16_R3.CraftServer.dispatchServerCommand(CraftServer.java:788) ~[patched_1.16.5.jar:git-Paper-794]
        at net.minecraft.server.v1_16_R3.DedicatedServer.handleCommandQueue(DedicatedServer.java:470) ~[patched_1.16.5.jar:git-Paper-794]
        at net.minecraft.server.v1_16_R3.DedicatedServer.b(DedicatedServer.java:437) ~[patched_1.16.5.jar:git-Paper-794]
        at net.minecraft.server.v1_16_R3.MinecraftServer.a(MinecraftServer.java:1347) ~[patched_1.16.5.jar:git-Paper-794]
        at net.minecraft.server.v1_16_R3.MinecraftServer.w(MinecraftServer.java:1135) ~[patched_1.16.5.jar:git-Paper-794]
        at net.minecraft.server.v1_16_R3.MinecraftServer.lambda$a$0(MinecraftServer.java:291) ~[patched_1.16.5.jar:git-Paper-794]
        at java.lang.Thread.run(Thread.java:834) [?:?]

MC火山君

MCBBS有你更精彩~

HEDT

优秀的插件，我很需要他

饭桶游戏吖

可以的 刚好用得上 支持一下

彭承宇1234567

MiraiMC 真棒，是一款很优秀的插件！

允诺Ynl

MiraiMC 真棒，是一款很优秀的插件！

qa811217

MiraiMC 真棒，是一款很优秀的插件！