Minecraft(我的世界)中文论坛

 找回密码
 注册(register)

!header_login!

只需一步,立刻登录

查看: 13302|回复: 356

[原创插件] MiraiMC:让你的服务器登录QQ机器人

  [复制链接]
DreamVoid 当前离线
积分
6013
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-1-30
查看详细资料
发表于 2021-6-6 21:11:00 | 显示全部楼层 |阅读模式
服务端插件
英文名称: MiraiMC QQBot
中文名称: MiraiMC QQ机器人
插件来源: 原创
适用服务端: CraftBukkit Spigot Sponge BungeeCord Paper |其它| 
插件类型: 信息 管理 前置API 
语言支持: 简体中文 English 
适用版本: 1.17.X 1.16.X 1.15.X 1.14.X 1.13.X 1.12 1.11 1.10 1.9 1.8 1.7.10 1.7.2 1.6 其他 
前置Mod|插件: [可选] PlaceholderAPI
下载地址: https://github.com/DreamVoid/MiraiMC/releases/latest
原帖地址: https://github.com/DreamVoid/MiraiMC
插件Logo: -
插件简介: 适用于Minecraft服务端的QQ机器人插件

您尚未登录,立即登录享受更好的浏览体验!

您需要 登录 才可以下载或查看,没有帐号?注册(register)

x
本帖最后由 DreamVoid 于 2021-11-14 01:47 编辑


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


介绍

什么是 MiraiMC?

MiraiMC 是一个基于 Mirai 的 Bukkit 插件,能够让你在Minecraft服务器上使用 Mirai QQ 机器人程序,同时提供一些 API 帮助开发者简单的调用机器人接口为自己的插件实现多样的功能。

特性
  • 支持多个机器人同时登录
  • 支持启动服务端后自动登录
  • 兼容 Mirai 目录结构,方便快速迁移
  • 插件级别的 QQ 绑定,提供最方便的管理
  • 可拓展程度高,带有完善的接口
  • 开发者不断整新功能,尽可能提供帮助
  • 还有更多……等待你的发掘!

开始使用

服主

如果你是服主,正在被接入 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 文件作为外部库导入
    1. <dependency>
    2.     <groupId>io.github.dreamvoid</groupId>
    3.     <artifactId>MiraiMC-Integration</artifactId>
    4.     <!--请确保版本为Github上的最新版本-->
    5.     <version>1.5</version>
    6.     <scope>provided</scope>
    7. </dependency>
    复制代码

  • 参照 JavadocMiraiMC 开发模板编写相关的代码
  • 发布你的插件
可以在这里找到更为详细的开发教程: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
/miraimcMiraiMC 插件主命令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允许使用 /miraiOP
miraimc.command.mirai.*允许使用 /mirai 的所有子命令OP
miraimc.command.mirai.login允许使用 /mirai loginOP
miraimc.command.mirai.logout允许使用 /mirai logoutOP
miraimc.command.mirai.list允许使用 /mirai listOP
miraimc.command.mirai.sendfriendmessage允许使用 /mirai sendfriendmessageOP
miraimc.command.mirai.sendfriendnudge允许使用 /mirai sendfriendnudgeOP
miraimc.command.mirai.sendgroupmessage允许使用 /mirai sendgroupmessageOP
miraimc.command.mirai.checkonline允许使用 /mirai checkonlineOP
miraimc.command.mirai.autologin允许使用 /mirai autologinOP
miraimc.command.miraimc允许使用 /miraimcOP
miraimc.command.miraimc.*允许使用 /miraimc 的所有子命令OP
miraimc.command.miraimc.bind允许使用 /miraimc bind 及下属子命令OP
miraimc.command.miraimc.reload允许使用 /miraimc reloadOP

配置文件

受限于排版格式,请移步此处查看完整的配置文件说明: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 的插件


已知 Bug

如果你遇到任何 Bug,请通过在 Github 上提交 issue的方式进行反馈,我将在之后进行功能补充和完善。

  • 在非图形界面环境下登录带设备锁或验证码的账号时无法完成验证 (1.3 已修复)
  • 极少数情况可能出现插件载入、机器人登录问题 (1.3 已修复)
  • 在BungeeCord使用时无法使用自动登录机器人功能 (1.4 已修复)
  • BungeeCord和Sponge的自动登录机器人无法添加账号

兼容性报告

以下资源已确认不支持 MiraiMC。你可以点击这里查看更多信息。
  • Cauldron

下载
正式版:,测试版:
为帖子评分解锁下载地址支持我继续开发(评分人气不消耗自己的人气)

游客,如果您要查看本帖隐藏内容请回复

开源


更多帮助&外部链接


致谢

感谢以下人员/项目为 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-pre2实现)
  • [√] 添加剩余未添加的Mirai事件(1.2全部实现)
  • [√] 支持 BungeeCord(1.3-pre1实现)
  • [√] 重写登录流程以适应 Bukkit(和未来支持的 Bungee,甚至 Sponge)(1.3-pre1实现)
  • [√] 完全兼容 mirai console 的结构供已在使用mirai的服主使用
  • [√] 支持 Sponge(1.5实现)
  • [√] 支持 PlaceholderAPI(1.5实现)
  • [  ] 引入 Mirai-Http-API 模式来连接到mirai-console(预计1.6实现)
  • [  ] 像 mirai console 一样加载 mirai console 插件(遥遥无期,欢迎PR)


本插件所用代码部分来自其他开源或闭源(已授权)作品


更新日志
可移步 Github 发布页面查看更为完整的更新日志:https://github.com/DreamVoid/MiraiMC/releases


评分

参与人数 20人气 +25 金粒 +68 收起 理由
佐梅 + 1 真的真的真的巨好用
口羊 + 1 MCBBS有你更精彩~
wticch + 1 高呼666!
23578951 + 1 高呼666!
猫尾233 + 1 求兼容Cauldron
远远饿了 + 2 MCBBS有你更精彩~
KoGetu37 + 1 + 5 NB哦!!
zxzpkcxcc + 10 MCBBS有你更精彩~
卢本伟牛试试 + 1 Ssssssssssssssssssss
Creeper___ + 2 MCBBS有你更精彩~
zaxxlt + 1 MCBBS有你更精彩~
LitthoX + 1 高呼666!
linken3 + 1 高呼666!
青蛙的名单 + 1 高呼666!
1317601385 + 1 还不错的插件
Silverhh + 1 + 8 高呼666!
164ebr + 2 希望早日开发出绑定QQ功能,期待你这款插件.
喜塔腊尔晴 + 2 神乎其技!6的飞起!
ObcbO + 1 + 20 期待有更多插件适配
小天吖~ + 25 加油

查看全部评分

DreamVoid 当前离线
积分
6013
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-1-30
查看详细资料
 楼主| 发表于 2021-9-25 16:50:05 | 显示全部楼层
本帖最后由 DreamVoid 于 2021-11-14 01:41 编辑

Reserved
回复

使用道具 举报

6changan6 当前离线
积分
116
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-1-6
查看详细资料
发表于 3 小时前 | 显示全部楼层
catserver服务端也可以用的吧
回复

使用道具 举报

c2813145121 当前离线
积分
114
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-9-27
查看详细资料
发表于 8 小时前 | 显示全部楼层
居然还可以这样
回复

使用道具 举报

6xiao 当前离线
积分
56
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2016-1-17
查看详细资料
发表于 8 小时前 | 显示全部楼层
感谢楼主大大大大大大大大大大大
回复

使用道具 举报

DKCJ丶_fEe7Y 当前离线
积分
816
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-11-7
查看详细资料
发表于 9 小时前 | 显示全部楼层
这个插件有用
回复

使用道具 举报

WeiQu_钻石块 当前离线
积分
839
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-4-14
查看详细资料
发表于 10 小时前 | 显示全部楼层
MCBBs有你更精彩~
回复

使用道具 举报

3339098816 当前离线
积分
48
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-4-25
查看详细资料
发表于 昨天 21:03 | 显示全部楼层
6666666666666666666
回复

使用道具 举报

南方少年吖 当前离线
积分
42
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-1-11
查看详细资料
发表于 昨天 20:50 | 显示全部楼层
支持支持
回复

使用道具 举报

tong0425 当前离线
积分
174
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2017-10-20
查看详细资料
发表于 昨天 11:17 | 显示全部楼层
谢谢分享。。。。。。。
回复

使用道具 举报

xiaolong2014 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2014-8-30
查看详细资料
发表于 前天 17:16 | 显示全部楼层
验证怎么办 链接怎么复制 控制台复制有问题
回复

使用道具 举报

君の名 当前离线
积分
303
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2016-11-1
查看详细资料
发表于 前天 16:29 来自手机 | 显示全部楼层
看上去还行,就怕一直刷屏
回复

使用道具 举报

xiaolong2014 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2014-8-30
查看详细资料
发表于 前天 16:20 | 显示全部楼层
这个插件支持catserver服务端吗
回复

使用道具 举报

duoxing666 当前离线
积分
5
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-11-20
查看详细资料
头像被屏蔽
发表于 3 天前 | 显示全部楼层
666666666666666666666666666666
回复

使用道具 举报

暗月灵舞 当前离线
积分
50
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-8-1
查看详细资料
发表于 3 天前 | 显示全部楼层
支持下顺便试试
回复

使用道具 举报

幸会秋川 当前离线
积分
1014
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2021-11-13
查看详细资料
发表于 3 天前 | 显示全部楼层
有没有人做一个扩展 在QQ上消费金币购买游戏里的物品吗 还是离线状态,然后QQ也可以查出物品清单
回复

使用道具 举报

Bunny_i 当前离线
积分
383
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2018-10-5
查看详细资料
发表于 3 天前 | 显示全部楼层
支持一下,我去二次开发一下看看
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 注册(register)

本版积分规则

Archiver|小黑屋|Mcbbs.net ( 京ICP备15023768号-1 ) | 京公网安备 11010502037624号 | 手机版

GMT+8, 2021-11-27 23:32 , Processed in 0.085452 second(s), Total 34, Slave 33 queries, Release: Build.2021.11.26 1022, Gzip On, Redis On.

"Minecraft"以及"我的世界"为Mojang Synergies AB的商标 本站与Mojang以及微软公司没有从属关系

© 2010-2020 我的世界中文论坛 版权所有 本站原创图文内容版权属于原创作者,未经许可不得转载

快速回复 返回顶部 返回列表