Skip to content

Latest commit

 

History

History
100 lines (60 loc) · 4.68 KB

UserManual.md

File metadata and controls

100 lines (60 loc) · 4.68 KB
Raw

Mirai - UserManual

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

启动 Mirai

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

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

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

使用图形界面版本

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

使用纯控制台版本

安装

可以使用脚本 自动安装 32 位带 HTTP 插件的版本，也可以使用安装器个性化安装：

  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 即可。其他插件一般都有特殊说明如何使用，请参考它们的说明。

推荐安装的插件

  • chat-command: 不安装此环境不能在聊天环境中执行命令
  • LuckPerms-Mirai (社区): 易用的高级高效率权限组插件, 适合权限分配模型比较复杂的情况
  • mirai-api-http：提供 HTTP 支持，允许使用其他编程语言的插件

使用控制台指令

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

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

一些常用指令介绍在这里。

解决问题

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