# 文件配置
>[info] 核心`1.4.1`版本之后添加。
>[success] 核心`1.8.0`版本后增加注解配置,并开始推荐使用文件配置与注解配置
除了使用代码的方式进行配置以外,我提供了使用文件配置的方式。
配置文件目前仅可使用`properties`类型的文件。
此章节介绍的是在所有的组件内全部通用的配置。对于配置的解释,组件之间是存在不同的,且每个组件的配置内容也不是相同的。
此处列举的配置内容,是在所有的组件之间通用的配置,而额外的、组件内部提供的配置请查阅对应组件的文档说明。
<br>
## **配置内容**
```properties
################################
##
### 核心所提供的公共配置, 一般情况下在不同的组件之间,不会存在变化
。
## 下述配置信息中,1.7.x以下版本的'core' 前缀需要替换为 'simple.robot.conf'
## 下述配置信息中,1.12.x及以上版本,尽量在前缀上标注 'simbot'
################################
# 服务器的IP地址,一般代表为上报地址
# 此属性核心1.8.0后弃用
# core.ip=127.0.0.1
# 本机的QQ号,是否需要配置与组件相关。
# 此属性核心1.8.0后弃用
# core.localQQCode=
# 本机的QQ昵称,是否需要配置与组件相关。
# 此属性核心1.8.0后弃用
# core.localQQNick=
# 使用的编码格式,默认为UTF-8
core.encode=UTF-8
# 或 (1.12+) simbot.core.encode=UTF-8
# 酷Q根路径的配置,默认为null。
core.cqPath=
# 或 (1.12+) simbot.core.cqPath=
# 需要进行的包扫描路径,默认为空,即扫描启动器根路径
core.scannerPackage=
# 或 (1.12+) simbot.core.scannerPackage=
# 监听函数返回值的选择器,默认为选择第一个出现的Break监听。
# 参数是SelectType这个枚举类型的name
core.resultSelectType=FIRST_BREAK
# 或 (1.12+) simbot.core.resultSelectType=FIRST_BREAK
# 核心池的大小。默认根据CPU核心数计算最佳线程数量
core.threadPool.corePoolSize=
# 或 (1.12+) simbot.core.threadPool.corePoolSize=
# 线程池初始化的阻塞系数,用来在未手动配置的情况下决定最终的线程池线程数量。
core.threadPool.blockingFactor=0.0
# 或 (1.12+) simbot.core.threadPool.blockingFactor=0.0
# 线程池最大线程数, 默认为corePoolSize的2倍
core.threadPool.maximumPoolSize=
# 或 (1.12+) simbot.core.threadPool.maximumPoolSize=
# 表示线程没有任务执行时最多保持多久时间会终止。
core.threadPool.keepAliveTime=5
# 或 (1.12+) simbot.core.threadPool.keepAliveTime=5
# 参数keepAliveTime的时间单位
core.threadPool.timeUnit=MILLISECONDS
# 或 (1.12+) simbot.core.threadPool.timeUnit=MILLISECONDS
# 一个阻塞队列,用来存储等待执行的任务。
core.threadPool.workQueue=java.util.concurrent.LinkedBlockingQueue
# 或 (1.12+) simbot.core.threadPool.workQueue=java.util.concurrent.LinkedBlockingQueue
# 志等级, 默认为info级别
core.logLevel=INFO
# 或 (1.12+) simbot.core.logLevel=INFO
######## 核心v1.7.0更新 ########
# 使用的信息语言。默认为系统当前语言。
core.language=zh_CN
# 或 (1.12+) simbot.core.language=zh_CN
######## 核心v1.8.0更新 ########
# 起始状态所注册的bot账号列表,格式:{code}:{path},{code}:{path}, 其中{code}可以是空的。
# 一组账号与地址使用冒号分割,多组信息使用逗号分割
# 如果为空,则默认注册一个本地ip地址::http://127.0.0.1:5700
# 例:11111111:http://127.0.0.1:8080,2222222:http://192.168.0.1:7777
# 例:11111111:http://127.0.0.1:8080,:http://192.168.0.1:7777
core.bots=:http://127.0.0.1:5700
# 或 (1.12+) simbot.core.bots=:http://127.0.0.1:5700
######## 核心v1.8.1更新 ########
# 是否启用版本检测,默认为true
core.checkVersion=true
# 或 (1.12+) simbot.core.checkVersion=true
######## 核心v1.12.0更新 ########
# 是否在接收到监听的时候检测此bot的账号的注册状态。
simbot.core.botCheck=true
```
## 配置Properties
核心`1.12.1`之后追加了一个类`ConfigProperties`,当你使用配置文件启动的时候,此类中的内容即为你配置文件中的内容。你可以通过自动注入得到这个类。
```java
@Depend
private ConfigProperties configProperties;
```
## **如何使用**
核心提供了一种App接口的实现,用于使组件向使用者提供配置文件的读取功能。而每个组件的实现方式都可能是不同的。(至少接口的名称是不同的)
**核心1.8.0之后,可直接配合注解配置的形式启动。**
~~**简而言之,具体的读取方式请查阅对应组件的配置说明。**~~
- 前言
- 简单介绍
- 我该如何阅读文档
- 视频教程
- 安装与使用
- 开源协议
- 免责&捐助
- 注意事项
- 版本命名规则简介
- 主要功能版本历史
- 功能指引
- 通用API与功能
- 国际化语言
- 异常
- 消息监听
- @Listen
- @OnListen模板
- @Filter
- 消息参数截取
- @Spare
- @Constr
- @Ignore
- @ListenBreak
- @ListenBreakPlugin
- @ListenBody
- 监听响应
- 成功判定与返回值
- 监听上下文
- 动态参数
- 监听消息API
- 异步监听 @Async
- 限流监听 @Limit
- 自定义Http送信器
- 枚举与类型
- 送信器
- SENDER
- SETTER
- GETTER
- 返回值
- 其他位置
- 日志与日志拦截
- 异常处理
- 依赖注入
- 自定义依赖获取
- 批量依赖载入
- 注意事项
- 常量
- 定时任务
- 自定义过滤
- 拦截器
- 拦截器总定义
- 上下文对象总定义
- 监听消息拦截
- 送信器拦截
- 监听函数拦截
- CAT码
- CQ码
- CQCode
- CQ码工具类
- CQ扩展工具类
- AppendList拼接链
- 高级内容
- 阻断机制
- 截断机制
- 自定义枚举类型
- 枚举工厂
- byName注解
- 自定义注解
- 配置
- 文件配置
- 注解配置
- 参数配置
- 多配置
- 多账号
- 自定义账号管理器
- 小心!
- 核心版本与组件如何升级核心
- 核心版本迭代指南
- 核心
- 更新日志
- jar包与依赖
- 监听消息类结构图
- 快速启动
- 模组与扩展
- 模组开发
- 现有模组
- 通用模组-延时任务
- 通用模组-CQ码工具
- 转义器
- CQ码操作工具类
- CQ码模板-CodeTemplate
- CQ码载体-KQCode
- CQ码构建器
- MQ码工具类
- 通用模组-redis-bot管理器
- 通用模组-Debugger
- Debugger-common模块
- Debugger-server模块
- Debugger-client模块
- 通用模组-钉钉机器人
- 组件-Mirai(JVM)
- 快速开始(1.13+)
- springboot-starter
- 注意事项
- 配置
- 额外的内容
- 快速回复
- 额外监听
- CQ码解析
- 组件-酷Q(QQ)-CQ HTTP API(基本失效)
- 快速开始(推荐)
- 快速开始(1.7.x以下,不推荐)
- 快速开始(Springboot启动器)
- 启动器、启动接口与配置类
- 配置
- 文件配置
- 注意事项
- 更新日志
- 额外的内容
- 自定义额外监听
- CQ送信器
- 元事件
- 监听消息类结构图
- 组件-酷Q(QQ)-JCQ(失效)
- 快速开始
- 更新日志
- 额外的内容
- JCQ日志
- 配置
- 注意事项
- 监听消息类结构图
- 组件-酷Q(QQ)-HTTP TO CQ(失效)
- 快速开始(核心1.7.x及以下)
- 启动器、启动接口与配置类
- 配置
- 文件配置
- 注意事项
- 更新日志
- 监听消息类结构图
- 组件-酷Q(QQ)-LEMOC (失效)
- 快速开始(核心1.7.x及以下)
- 配置
- 注意事项
- 更新日志
- 监听消息类结构图
- Springboot快速启动器
- 常见问题汇总
- BUG反馈
- 更新计划总览