Mirai 用户手册。本文面向对开发不熟悉而希望使用 Mirai 的用户。如果你要开发,请先阅读 开发文档。
使用 Mirai,一般人要启动的是 Mirai 控制台(即 Mirai Console),它可以加载插件。
Mirai 控制台现在有两个版本,插件在这两个版本的 Mirai Console 上都可以运行:
类型 | 长啥样? | 好用吗? | 怎么装? |
---|---|---|---|
纯控制台 | MCLI-1.png | 稳定,也适合服务器 | 使用纯控制台版本 |
图形界面 | MCPS-1.png | 测试版,不稳定 | 使用图形界面版本 |
前往 sonder-joker/mirai-compose 下载适合你的系统的压缩包,解压到一个文件就可以使用。
可以使用安装器来全自动安装:
- 访问 iTXTech/mcl-installer;
- 下载适合你的系统的可执行文件;
- 在一个新文件夹存放这个文件,运行它;
- 通常可以一路回车使用默认设置完成安装,安装完成后程序自动退出;
- 运行
mcl.cmd
启动,成功后会看到绿色的mirai-console started successfully
。
安装时自动下载了 Mirai Console 启动器(简称 MCL)。
启动器会帮你准备运行环境,下载和更新 Mirai 核心。你也可以使用启动器下载一些插件(见下文)。
第一次运行 mcl.cmd
时会初始化运行环境。下表说明了各个文件夹的用途。
文件夹名称 | 用途 |
---|---|
scripts |
存放启动器的脚本,一般不需要在意他们 |
plugins |
存放插件 |
data |
存放插件的数据,一般不需要在意它们 |
config |
存放插件的配置,可以打开并修改配置 |
logs |
存放运行时的日志,日志默认保留 7 天 |
可以在这里查看 MCL 详细用法
刚刚装好的 Mirai Console 是没有任何功能的。功能将由插件提供。
Mirai 官方提供两个插件:
- chat-command: 允许在聊天环境通过以 "/" 起始的消息执行指令
- mirai-api-http:提供 HTTP 支持,允许使用其他编程语言的插件
打开命令行 (Windows 系统按住Shift+鼠标右键,点击"在此处打开 PowerShell"),
可以使用 MCL 自动安装这些插件如:
./mcl --update-package net.mamoe:mirai-api-http --type plugin --channel stable
详细文档:MCL/scripts
- Mirai 官方论坛 Mirai Forum
我们还正在建设插件中心,完成后将会简化寻找插件的工作
如果是 JAR 文件的插件,放入 plugins
即可。其他插件一般都有特殊说明如何使用,请参考它们的说明。
启动 mcl.cmd
就会看到控制台。在控制台可以输入指令,按回车执行这条指令。
Mirai Console 内置一些指令,输入 ?
并回车可以查看指令列表。
一些常用指令介绍在这里。