使用篇 /01/ 部署使用环境


下载所需环境

要运行 mirai,最好在你的系统中安装一个 jdk11,你可以使用搜索引擎搜索关键词寻找相关资源,也可以使用本文推荐的几个 jdk 中的其中一个。

如果你的计算机中已安装 java,需要安装以下内容时,强烈建议下载 zip 或 tar 包并找一个你记得的、没有中文路径的、稳定不改名的地方解压,并记下安装路径。

注意

Windows 用户请留意,本文已默认你在 ''文件夹选项 → 查看'' 中关闭 ''隐藏已知文件类型的扩展名'',请在开始前检查你是否已关闭该选项。

镜像源说明

注意,本文将大量使用来自 Github 的链接,由于中国大陆的网络环境问题,大部分人可能无法访问 Github,如果你无法访问 Github,可将链接中的 github.com 替换为 kgithub.com 以使用 KGithubopen in new window 的镜像服务,这些在之后的文章将不会再被提起。

选择启动方式

mirai 有多种启动方式,本文只介绍两种控制台启动方式。另外,如果你没有错误处理能力,请不要使用当前仍不稳定的图形界面版本 mirai-compose!

提示

你只需要从以下两种方法中任选一种即可。

方法一:使用启动器MCL

使用 MCL 可以一键更新各个组件,非常方便。 首先,到 https://github.com/itxtech/mirai-console-loader/releases 下载 mcl-版本.zip 并找一个目录进行解压,该目录之后将在本文中使用 $root 来代替。

提示

记住,本文中的 $root 均代表你的 mirai 所在目录。

Windows 用户打开 mcl.cmd 即可打开 MCL,Linux 用户执行 ./mcl 即可打开 MCL,非常方便。 Linux 用户若权限不足,执行 chmod 777 ./mcl 即可修改权限

提示

请你注意: MCL 全称 mirai-console-loader,是 mirai-console 的加载器,它与 mirai-console 完全不是同一个东西

当技术人员询问你使用的 mirai 版本时,通常是指你的 mirai-console 版本,而不是 MCL 的版本!如果技术人员向你询问你的 mirai 版本或 MCL 版本,请查阅检查版本

打开 MCL 闪退

如果你一打开 MCL 就闪退,这种情况大多发生于 Windows,请检查你是否已安装 jdk11 或更高版本。 如果已安装,请定位并复制你 jdk11 的 java.exe 的绝对路径,它在你 jdk 的安装目录的 bin 文件夹下,希望你还记得。 如果你不会定位你的 java.exe 绝对路径,可以请教你身边的程序员朋友。

然后使用记事本或其他文本编辑器打开 mcl.cmd,在第二行你可以看到如下代码

set JAVA_BINARY=xxxx

将其改为

set JAVA_BINARY="你刚刚复制的java.exe绝对路径"

请直接复制这段代码来修改,'''不要忘记保留双引号''',修改后保存文件再打开 mcl.cmd 即可

打开 MCL 无法下载文件

如果你打开 MCL 就报类似下方的红字,或许你需要更换下载源,操作方法详见 MiraiForumopen in new window红字.jpg

成功

你可以转跳到「完成」部分了

注意

注意:若您使用旧版CMD窗口,控制台中使用鼠标左键选择一片区域,则此控制台内运行的程序会暂停。

这可能会导致运行中的bot掉线。解决这个问题的方法是使用windows terminal或在旧版窗口中右键解除暂停状态

方法二:使用启动脚本

随便找一个你记得的目录,该目录之后将在本站的其它教程中使用 $root 来代替。

提示

记住,本文中的 $root 均代表你的 mirai 所在目录。

到 Maven Central 下载以下依赖库。

选择版本,点击 Browse,点击以 -all.jar 结尾的链接 (通常是第一个) 来下载。
除最后一个以外,其余的版本必须相同。

$root 文件夹新建 content 文件夹,把你刚刚下载的 jar 包复制进去,在 $root 文件夹创建脚本文件:

Windows 用户

创建 mirai.bat 脚本文件,用记事本打开,复制粘贴如下内容

@echo off
title Mirai Console Terminal
java -cp ./content/* net.mamoe.mirai.console.terminal.MiraiConsoleTerminalLoader
pause

打开 mirai.bat 即可运行 mirai

Linux/macOS 用户

创建 mirai.sh 脚本文件,写入如下内容

java -cp "$CLASSPATH:./content/*" net.mamoe.mirai.console.terminal.MiraiConsoleTerminalLoader

在终端执行 sh ./mirai.sh 即可运行 mirai
若权限不足,执行 chmod 777 ./mirai.sh 即可修改权限

成功

你可以转跳到「完成」部分了

检查版本

若你的 mirai-console 已在运行中,可执行命令 /status 来获取当前 mirai-console 的版本、插件列表、运行信息等,执行命令的结果如图所示。当技术人员向你询问你的 mirai 版本信息时,可执行此命令,将结果截图并发送给该技术人员。

mirai-console_status.jpg

以下是不执行命令的获取版本方法图示。再次强调,mirai 版本一般是指 mirai-console 版本而不是 MCL 版本。

mirai-console_版本图示.jpgmcl_版本图示.jpg

关闭 mirai

很多人有直接关闭命令窗口来关闭 mirai 的习惯,这其实与断开电脑的电源来关机是等价的,这可能会导致数据无法保存甚至因为保存错误导致数据丢失。所以,我们应当使用正确的方式关闭 mirai。

正确的关闭方式是使用快捷键 Ctrl+C 或者输入命令 stop

完成

至此,你已经部署好 mirai 使用环境了,接下来,进行最麻烦的登录吧!

使用篇 /02/ 在控制台登录