已弃用

该文档现已弃用，新的文档正在编写中，敬请期待
https://wiki.mrxiaom.top/mirai

旧文档 Github: MrXiaoM/mirai-docs
旧文档地址: https://mirai-docs.doomteam.fun/
一切内容以 Github 为准
希望论坛字数限制够放得下文档
如果你想实时收到更新通知，请点击右边第二个 铃铛按钮 来关注本贴

mirai-docs

面向初学者 的 mirai 非官方帮助文档

在本文档中，我将会按照顺序一步一步地教学，就像打怪升级一样

目前正在编写和整理中，敬请期待

注: 初学者 指 new miraier，刚接触 mirai 的人

观前须知

请先阅读《提问的智慧 (How To Ask Questions The Smart Way)》以确保你在遇到简单的问题时能够 STFW (到网上搜索) 以及 RTFM (读软件给出的帮助手册) 来解决问题而不是去问别人占用别人的时间，如果你的问题能搜索得到，那你得到的回复很可能是别人搜索了然后发你的，

鲁迅曾经说过：“无端空耗别人的时间其实是无异于谋财害命的。”

所以在没到网上搜索之前不要提问！不要提问！不要提问！

在遇到网上搜索/读手册解决不了 (前提是要读过，要实践过确实不行) 再去以正确的方式提问，比如提供尽可能完整的信息，包括但不限于系统版本/所使用的软件或组件版本/进行的详细操作/输出日志或者弹出信息等等，而不是你问在吗，别人回答在，你问问题，别人找你要信息，你发信息，别人觉得信息不够推断不出来你的问题然后再进一步找你要信息…… 直接一步到位把信息提供全面难道不好吗？

如果你有问题，可以在本仓库 发布 issue (没有 Github 账号？点这里注册)。

也可以向我的邮箱 coolxiaom95@gmail.com 发送邮件求助，

或者加我的QQ 2431208142 (我没设加好友验证，申请添加好友之后请直接说明来意和详细描述问题)。

不管是在哪个渠道联系我，我看到你的消息之后将会在我空闲时尽快回复。

确认你的水平

在查阅这份文档之前，请确保你已掌握 kotlin 或者 java 两门语言中的其中一门

如果你已掌握一门语言并能使用这门语言进行网络操作，很抱歉目前我没有对这方面的研究，你可以去查看官方文档

如果你是完全不会编程的人类，你只需要查阅用户文档

如果你不是人类…… 能看得懂简体中文并能理解句子的意思的话大概也可以看得懂吧

开始吧

适合不会编程的新手: 用户文档

如果你还不会如何安装和登录机器人，也请查阅用户文档

使用 kotlin 或 java 来编写 mirai 衍生软件: 开发文档

使用其他语言来编写 mirai 衍生软件: 暂无文档，建议查阅官方文档

在这个文档发布之前，已经有很多前辈编写了 mirai-api-http 或者 onebot-kotlin 的其他语言实现，你可以在 mirai 官方开发文档 找到相应语言的社区SDK以便快速开始开发

如果你对更新 BlocklyMirai 有兴趣，可以查看 BlocklyMirai 帮助文档

更新

不定期更新，如果你有意愿更新文档，PRs welcome

赞助

本文档不接受赞助。

如果你喜欢这个文档并有意资助，开发组比我更需要赞助，请重定向到 【官方公告】关于论坛赞助/资金流向公示/可持续发展等

计划

• 开发文档以循循渐进的形式写，从部署到登录到事件到消息等等
• 不使用社区 SDK 的非 jvm 语言与 mirai-api-http 交互教程。因为社区 SDK 太多了很难讲明白 XD
• 考虑到 GitBook 日常前端崩溃，所以在本文档基本上完成之后，会在 MiraiForum 技术交流板块发一贴来备份以方便难以访问 Github 的用户查阅

@imldy 其实这个地方的 xwx 是乱写的（
在这段的前面我告诉在文档阅读者，之后消息通道都会用 channel 代替了，然后下面这里给出了替换的示例，那个地方没加粗，好像在粗读的时候很难看到，以后改

@ihers 看源码输出的是静态图片

java.io.FileNotFoundException: config.json (Permission denied)

请检查mcl是否有权限访问文件，必要时使用 sudo sh ./mcl
另外，日志中多处提到“please check the network.”，请检查你的网络是否正常，防火墙有没有拦截 mcl 下载文件

提醒一下，文档已经更新了，但可能存在一些错漏，如果有什么疑问或者改进建议请提出，我会尽我能力去解决

@hollismeynell 不知道，如果升级到 2.8.0 还不行的话，建议提出issue或者到漏洞反馈区发帖

@hollismeynell 暂无接口

@hollismeynell

ExternalResource res = ExternalResource.create(xxx);
group.getFilesRoot().upload(res);
res.close();

话说 resId 有什么用吗，不是很懂
它不给你公开你不会反射去获取或赋值吗 XD

@ls148478 可能是你给“综合讨论”或者“使用交流”板块点了 Subscribe 的缘故吧，或者关注了这个帖子

@insistjun666 我怎么知道

我又没被风控过，我是听过被风控过的人的经验

自己试。能开mc服就要有自主能动性 这个词不是这么用的吧 XD

@insistjun666 https://aq.qq.com/

@insistjun666 你试试不就知道了，我又没被风控过，我是听过被风控过的人的经验