🛠 配置文件
此页介绍了 MiraiMC 的配置文件节点，及如何正确的调整这些配置
对于编辑软件，我推荐使用 Visual Studio Code，我不推荐使用 Notepad++ 反华软件
配置节点
general
插件的主要配置
allow-bStats- 默认值：
true - 描述：允许插件使用 bStats 记录插件使用情况
- 建议值：
true
- 默认值：
check-update- 默认值：
true - 描述：允许插件从 MiraiMC API 检查最新版本
- 建议值：
true
- 默认值：
disable-safe-warning-message- 默认值：
false - 描述：关闭启动插件时的非开源安全警告信息
- 建议值：
true/false
- 默认值：
mirai-working-dir- 默认值：
default - 描述：Mirai 的工作目录，有关 Mirai 机器人的数据都会存放在这个文件夹。如果此项为 default，则目录为
/plugins/MiraiMC/MiraiBot - 建议值：如果你已在使用 Mirai 机器人，请将此项改为 Mirai 机器人的根目录
- ℹ提示： 通常，Mirai 机器人的根目录中包含
bots、config、plugins等文件夹
- 默认值：
add-properties- 默认值：
true - 描述：自动添加各类 mirai 必要参数
- 建议值：
true
- 默认值：
mirai-core-version- 默认值：
stable - 描述： 使用的 mirai 核心版本，如果不存在将自动下载。设为
latest则使用最新版本，设为stable则使用作者测试后的稳定版本。 - 建议值：
stable
- 默认值：
maven-repo-url- 默认值：
https://repo.huaweicloud.com/repository/maven/ - 描述： Maven 仓库地址。用于下载 Mirai 核心等依赖。
- 建议值：国外用户可使用 maven 中央仓库地址
https://repo1.maven.org/maven2/，国内用户可使用镜像站。
- 默认值：
enable-http-api- 默认值：
false - 描述：启用 HTTP-API 功能，允许添加 HTTP-API 模式下的机器人。
- 建议值：如果需要通过 mirai-api-http 连接到 MCL 等第三方 mirai 机器人，请设为
true，否则保持为false - ℹ提示： 要了解如何使用 HTTP-API 功能，请点击这里
此项将在未来移动到http-api父项。
- 默认值：
auto-open-qrcode-file- 默认值：
false - 描述：允许自动运行命令行
explorer 图片路径通过系统方式打开二维码登录图片。（仅 Windows） - 建议值：如果能够保证系统安全性，不担心恶意程序通过此功能执行任意代码，可设为
true，否则请保持false
- 默认值：
log-events- 默认值：
true - 描述：向后台输出机器人日志
- 建议值：如果你有很多机器人并且这些机器人有很多的群和好友，请将此项设为
false避免后台刷屏 - ℹ提示： 与
bot.disable-bot-logs不同，此项控制的是插件以事件监听的形式记录日志
- 默认值：
bot
Mirai 机器人相关的配置
disable-network-logs- 默认值：
false - 描述：关闭机器人的网络日志输出
- 建议值：如果你需要登录很多机器人，且这些机器人没有登录问题，请将此项设为
true避免刷屏。不建议开发者设为true。
- 默认值：
disable-bot-logs- 默认值：
false - 描述：关闭机器人的日志
- 建议值：如果你有很多机器人，请将此项设为
true避免后台刷屏。不建议开发者设为true。
- 默认值：
use-minecraft-logger
此部分控制 Mirai Core 是否使用 Minecraft 服务端日志系统bot-logs- 默认值：
true - 描述：使用 Minecraft 的日志系统接管机器人日志
- 建议值：
true
- 默认值：
network-logs- 默认值：
true - 描述：使用 Minecraft 的日志系统接管机器网络人日志
- 建议值：
true
- 默认值：
contact-cache
此部分控制 Mirai 机器人的缓存机制，不建议普通用户修改enable-friend-list-cache- 默认值：
false - 描述：开启好友列表缓存
- 建议值：
false
- 默认值：
enable-group-member-list-cache- 默认值：
false - 描述：开启群成员列表缓存
- 建议值：
false
- 默认值：
save-interval-millis- 默认值：
60000 - 描述：有更新时的保存时间间隔，单位为毫秒
- 建议值：
60000
- 默认值：
- ℹ提示： Mirai 在启动时会拉取全部好友列表和群成员列表。当账号拥有过多群时登录可能缓慢，开启列表缓存会大幅加速登录过程。
- ⚠警告： Mirai 自动根据事件更新列表，并在每次登录时与服务器校验缓存有效性，但有时候可能发生意外情况导致列表没有同步。 建议在测试环境使用缓存，而在正式环境关闭缓存（默认关闭缓存）。
register-encrypt-service- 默认值：
false - 描述：注册 MiraiMC 自有的第三方签名服务对接工具，通常用于解决机器人登录失败或发出的消息不可见等问题。
- 建议值：如果你遇到了机器人登录失败或发出的消息不可见，可尝试设为
true并指定一个签名服务器。如果你安装了其他开发者提供的签名服务插件，请保持此项为false避免冲突。 - ⚠警告： 第三方签名服务可能会泄露 QQ 敏感信息，因此请注意对接公共服务的安全性或自行搭建签名服务。
- 默认值：
update-protocol-version- 默认值：
false - 描述：启动插件时更新协议版本，通常用于解决机器人登录失败或发出的消息不可见等问题。此项通常与
register-encrypt-service项搭配使用。 - 建议值：
true
- 默认值：
database
控制插件的数据库连接
type- 默认值：
sqlite - 描述：控制插件应该连接到哪种类型的数据库。可用的类型：
sqlite,mysql
- 默认值：
settings
此部分控制数据库连接的相关配置sqlite
此部分控制 SQLite 数据库的连接path- 默认值：
%plugin_folder%/database.db - 描述：SQLite 数据库保存位置。
%plugin_folder%代表插件目录。
- 默认值：
mysql
此部分控制 MySQL 数据库的连接address- 描述：数据库地址
username- 描述：数据库用户名
password- 描述：用户名对应的密码
parameters- 默认值：
?useSSL=false - 描述：添加在 JDBC 地址后的连接参数。
- 默认值：
pool
此部分控制 HikariCP 的相关配置- ℹ提示： 通常情况下，默认值已经可以满足插件的使用
connectionTimeout- 默认值：
30000 - 描述：以毫秒为单位。连接超时时间，超过此时间则中断连接并抛出错误。最小值 250 ms。
- 默认值：
idleTimeout- 默认值：
600000 - 描述：以毫秒为单位。一个连接闲置多久时才会断开。当
minimumIdle小于maximumPoolSize才生效。最小值为 10000 ms，0表示禁用该功能。
- 默认值：
maxLifetime- 默认值：
1800000 - 描述：以毫秒为单位。当一个连接存活了足够久，HikariCP 将会在它空闲时把它抛弃。最小值为 30000 ms，0 表示禁用该功能。
- 默认值：
maximumPoolSize- 默认值：
15 - 描述：池中最多容纳多少连接（包括空闲的和在用的）。HikariCP 默认为 10，插件默认为 15。
- 默认值：
keepaliveTime- 默认值：
0 - 描述：多久检查一次连接的活性。默认不启用，最小值为 30000 ms，必须小于
maxLifetime。
- 默认值：
minimumIdle- 默认值：
5 - 描述：池中至少要有多少空闲连接。当空闲连接小于
minimumIdle，总连接小于maximumPoolSize时，将新增连接，HikariCP 默认等于maximumPoolSize。
- 默认值：
http-api
控制 HTTP-API 连接信息
url- 描述：HTTP-API 服务器连接地址
message-fetch
此部分控制插件向第三方 Mirai 机器人获取信息的配置interval- 默认值：
10 - 描述：获取机器人消息的间隔，单位：tick（0.05秒）
- 建议值：
10
- 默认值：
count- 默认值：
10 - 描述：单次获取的消息数量，不要过大或过小。
- 建议值：
10
- 默认值：