70 lines
5.2 KiB
Markdown
70 lines
5.2 KiB
Markdown
# AstrBOT 守望先锋国际服查询插件
|
||
作者其实是个小白来的，部分由ai创建
|
||
# 注意,部分使用steam启动的玩家无法被查询
|
||
|
||
🎮 **守望先锋·归来国际服查询插件**
|
||
|
||
[](https://github.com/TZYCeng/astrbot_plugin_owcx)
|
||
[](https://www.python.org/)
|
||
[](https://github.com/AstrBotDevs/AstrBot)
|
||
[](https://opensource.org/licenses/MIT)
|
||
|
||
|
||
## 📦 安装方法
|
||
### 方法一：通过AstrBot插件市场
|
||
1. 打开AstrBot WebUI
|
||
2. 进入插件管理
|
||
3. 搜索 "astrbot_plugin_owcx"
|
||
4. 点击安装
|
||
### 方法二：手动安装
|
||
1. 下载插件文件到AstrBot的插件目录
|
||
```bash
|
||
cd AstrBot/data/plugins
|
||
git clone https://github.com/TZYCeng/astrbot_plugin_owcx.git
|
||
```
|
||
2. 安装依赖
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
3. 重启AstrBot
|
||
|
||
## 使用方法
|
||
### owsummary
|
||
查询玩家摘要信息（头像、竞技段位等）。 用法: /owsummary [玩家ID] 示例: /owsummary TeKrop#2217 或 /owsummary 同志有程#3156 说明: 玩家ID支持直接输入 #，插件会自动处理；省略 ID 则查询绑定的账号（使用绑定平台）
|
||
### owstats
|
||
查询玩家统计概览（胜率、KDA等）。 用法: /owstats [玩家ID] [游戏模式] 游戏模式: 快速、竞技（默认） 示例: /owstats TeKrop#2217 竞技 说明: 省略 ID 则查询绑定的账号
|
||
### owcareer
|
||
查询玩家生涯统计（按英雄详细数据）。 用法: /owcareer [玩家ID] <游戏模式> [英雄名] 游戏模式: 快速、竞技 英雄名: 可选，支持中文（如 源氏、安娜）或英文（如 genji, ana） 示例: /owcareer TeKrop#2217 竞技 /owcareer TeKrop#2217 竞技 源氏 /owcareer 竞技 源氏 (已绑定ID后)
|
||
### owhero
|
||
查询英雄详细信息（含该英雄在当前配置地区/平台/模式下的全服胜率与选取率）。 用法: /owhero <英雄名> 英雄名支持中文（如 源氏、安娜）或英文（如 genji, ana） 示例: /owhero 源氏, /owhero ana
|
||
### owherostats
|
||
查询全服英雄胜率/选取率排行榜（按地区服务器统计，展示全部英雄）。 用法: /owherostats [角色] [地区] 角色: 坦克、输出、支援（可选） 地区: 亚服(asia)、美服(americas)、欧服(europe)，不填则使用配置中的默认地区 平台与游戏模式使用配置文件中的默认值 示例: /owherostats /owherostats 输出 /owherostats 支援 欧服
|
||
### owbind
|
||
绑定 Overwatch ID 到当前 QQ 号，可选择平台（PC端/主机端），每个 QQ 号可绑定多个账号（数量上限见配置 max_binds_per_user，默认 3 个），新绑定的账号自动成为默认查询账号。 用法: /owbind <玩家ID> [平台] 平台: pc(电脑端)、console(主机端)，不填则使用配置中的默认平台 示例: /owbind TeKrop#2217 或 /owbind TeKrop#2217 主机 说明: 旧版本绑定数据自动迁移，无需手动处理
|
||
### owunbind
|
||
解绑当前 QQ 号绑定的 Overwatch ID。 用法: /owunbind [玩家ID] 说明: 不填玩家ID时解绑当前默认查询账号；解绑默认账号后自动切换到剩余账号
|
||
### owbinds
|
||
查看当前 QQ 号绑定的所有 Overwatch 账号（含平台与默认标记）。 用法: /owbinds
|
||
### owdefault
|
||
设置默认查询的 Overwatch 账号，快捷指令省略 ID 时将查询该账号。 用法: /owdefault <玩家ID> 示例: /owdefault TeKrop#2217
|
||
### owme
|
||
快捷查询默认绑定账号的摘要信息。 用法: /owme 说明: 需要先使用 /owbind 绑定，多账号时查询 /owdefault 设置的账号
|
||
|
||
|
||
## ⚙️ 配置说明
|
||
在 AstrBot WebUI 的插件配置中可设置以下选项：
|
||
- **默认查询的游戏模式**: 竞技比赛 / 快速游戏
|
||
- **默认查询的平台**: pc / console（未绑定平台或绑定时未选择平台时使用）
|
||
- **默认查询的地区服务器** (`default_region`): asia(亚服) / americas(美服) / europe(欧服)，用于 /owherostats 等按地区统计的查询
|
||
- **每QQ号绑定上限** (`max_binds_per_user`): 每个 QQ 号最多可绑定的 Overwatch 账号数量，默认 3
|
||
- **图片渲染开关** (`enable_image_render`): 开启后（默认开启），/owsummary、/owstats、/owcareer、/owme、/owherostats 的查询结果会渲染为卡片图片；渲染失败自动回退文字；临时图片每小时自动清理，Docker 内如无中文字体请关闭或挂载 `fonts/font.ttf`
|
||
- **报错展示开关** (`show_api_error`): 开启后，查询出错时机器人会把 API 返回的具体报错（含建议重试等待时间）回复给查询者；无论开关与否，完整报错与堆栈都会记录在控制台 debug 日志中
|
||
- **API 服务地址** (`api_base_url`): OverFast API 地址，默认官方 `https://overfast-api.tekrop.fr`；自建服务（如 Docker 部署开源 OverFast）填入自建地址即可，非法值自动回退官方
|
||
- 图片渲染依赖 Pillow：`pip install Pillow>=9.0.0`（已在 requirements.txt 中）
|
||
- 如系统缺少中文字体导致渲染文字异常，可在插件目录下新建 `fonts` 文件夹并放入任意中文字体文件（命名为 `font.ttf` 或 `font.ttc`）
|
||
|
||
## 📕 更新日志
|
||
|
||
版本更新记录已迁移至 [CHANGELOG.md](CHANGELOG.md)。
|
||
|