MiraiMC
适用于Minecraft服务器的Mirai机器人
介绍
MiraiMC 是一个基于Mirai的Bukkit插件，能够让你在Minecraft服务器上使用Mirai QQ机器人程序，同时提供一些API帮助开发者简单的调用机器人接口为自己的插件实现多样的功能。
下载
- 稳定版本
- Github 发布页
- Gitee 发布页（中国）
- MCBBS（中国）
- Nukkit（中国）
- 开发版本
开始使用
服主
如果你是服主，正在被接入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>
<version>1.6</version>
<scope>provided</scope>
</dependency>
- 参照Javadoc或MiraiMC开发模板编写相关的代码
- 发布你的插件
可以在这里找到更为详细的开发教程：https://wiki.miraimc.dreamvoid.ml/
指令和权限
指令
| 命令 | 描述 | 权限 |
|---|---|---|
| /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 |
已知问题
- Velocity无法使用自动登录
下一步的目标
- 初步实现CoreAPI的基础功能
- 初步完善指令和权限系统
- 初步完善API接口供其他插件开发者调用
- 加入自动登录机器人的功能
- 添加剩余未添加的Mirai事件
- 重写登录流程以适应Bukkit（和未来支持的Bungee，甚至Sponge）
- 支持BungeeCord
- 完全兼容mirai console的结构供已在使用mirai的服主使用
- 支持Sponge
- 支持NukkitX
- 支持PlaceholderAPI
- 引入Mirai-Http-API模式来连接到mirai-console
- 像mirai console一样加载mirai console插件（遥遥无期，欢迎PR）