Skip to content

Latest commit

 

History

History
95 lines (56 loc) · 4.1 KB

UserManual.md

File metadata and controls

95 lines (56 loc) · 4.1 KB

Mirai - UserManual

Mirai 用户手册。本文面向对开发不熟悉而希望使用 Mirai 的用户。如果你要开发,请先阅读 开发文档

启动 Mirai

使用 Mirai,一般人要启动的是 Mirai 控制台(即 Mirai Console),它可以加载插件。

Mirai 控制台现在有两个版本,插件在这两个版本的 Mirai Console 上都可以运行:

类型 长啥样? 好用吗? 怎么装?
纯控制台 MCLI-1.png 稳定,也适合服务器 使用纯控制台版本
图形界面 MCPS-1.png 测试版,不稳定 使用图形界面版本

使用图形界面版本

前往 sonder-joker/mirai-compose 下载适合你的系统的压缩包,解压到一个文件就可以使用。

使用纯控制台版本

安装

可以使用安装器来全自动安装:

  1. 访问 iTXTech/mcl-installer
  2. 下载适合你的系统的可执行文件;
  3. 在一个新文件夹存放这个文件,运行它;
  4. 通常可以一路回车使用默认设置完成安装,安装完成后程序自动退出;
  5. 运行 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

在哪找社区插件

我们还正在建设插件中心,完成后将会简化寻找插件的工作

如何安装社区插件

如果是 JAR 文件的插件,放入 plugins 即可。其他插件一般都有特殊说明如何使用,请参考它们的说明。

使用控制台指令

启动 mcl.cmd 就会看到控制台。在控制台可以输入指令,按回车执行这条指令。

Mirai Console 内置一些指令,输入 ? 并回车可以查看指令列表。

一些常用指令介绍在这里

解决问题

如果遇到使用问题或想提建议,可以在 issues 发表。也可以在论坛交流想法。