y0lo/overwatch_bot

Fork 0

Files

T

y0lo 7d64b8a0a2 fix merge conficts

2026-10-09 20:25:21 +08:00

5.2 KiB

Raw Permalink Blame History

AstrBOT 守望先锋国际服查询插件

作者其实是个小白来的，部分由ai创建

注意,部分使用steam启动的玩家无法被查询

🎮 守望先锋·归来国际服查询插件

📦 安装方法

方法一：通过AstrBot插件市场

打开AstrBot WebUI
进入插件管理
搜索 "astrbot_plugin_owcx"
点击安装

方法二：手动安装

cd AstrBot/data/plugins
git clone https://github.com/TZYCeng/astrbot_plugin_owcx.git

安装依赖

pip install -r requirements.txt

重启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。

5.2 KiB Raw Permalink Blame History Unescape Escape