koishi-plugin-sc2arcade-search

提供星际争霸2游戏大厅相关查询功能的 Koishi 插件，支持房间状态查询、战绩查询、地图绑定等功能。

✨ 功能特性

• 🎮 实时查询游戏大厅房间状态
• 📊 玩家战绩/场次统计查询
• 🔗 用户与游戏句柄绑定系统（支持多句柄）
• 🔄 句柄切换功能
• 🗺️ 群组地图绑定功能
• ⚡ 支持代理服务器配置
• 🔒 敏感词过滤功能
• 🌐 区域服务器支持（US/EU/KR/CN）

📦 安装

npm install koishi-plugin-sc2arcade-search

⚙️ 配置项

proxyAgent: 'http://your-proxy-server:port' // 代理服务器地址（为空则不使用）
sensitiveword: true //是否启用敏感词过滤功能，默认开启

📋 命令列表

👤 玩家相关

| 命令 | 功能描述 | 示例 | |------------------------------|----------------------------|-----------------------------------| | 绑定 [句柄] | 绑定游戏句柄 | /绑定 1-S2-1-123456 | | 解绑 [序号] | 解绑指定句柄 | /解绑 2 | | 句柄 [@用户] | 查询绑定信息 | /句柄 @小明 | | 切换 [序号] | 切换当前使用的句柄 | /切换 1 | | 战绩 [@用户] | 查询最近20场战绩 | /战绩 @小明 | | 场数 [@用户] | 查询游戏场次排行 | /场数 | | 查询 [句柄] | 查询句柄绑定状态 | /查询 1-S2-1-123456 |

🌐 房间相关

| 命令 | 功能描述 | 示例 | |------------------------------|----------------------------|-----------------------------------| | 大厅 [区域ID] | 查询指定区域大厅房间 | /大厅 KR | | 房间 | 查询群组绑定地图的等待房间 | /房间 | | 历史房间 | 查询已开始的房间历史 | /历史房间 | | 场数排行 | 查询群组地图玩家场次排行 | /场数排行 |

👥 群组管理

| 命令 | 权限 | 功能描述 | |------------------------------|-----|---------------------| | 绑定地图 | 3 | 绑定群组地图 | | 解绑地图 | 3 | 解除群组地图绑定 | | 更新日志 | - | 查看群组地图更新历史 |

💻 使用示例

# 绑定多个游戏句柄
/绑定 1-S2-1-123456
> ✅ 您已成功绑定游戏句柄并设为当前使用

/绑定 3-S2-1-7870885
> ✅ 您已成功绑定游戏句柄

# 查看绑定句柄
/句柄
> 您绑定的游戏句柄：
> 1. [US] 1-S2-1-123456 (当前使用)
> 2. [KR] 3-S2-1-7870885

# 切换句柄
/切换 2
> ✅ 已切换到句柄：[KR] 3-S2-1-7870885

# 查询大厅房间
/大厅 KR
> [KR]游戏大厅房间列表：
> 1. 地图: 沙漠风暴, 人数: 3/8
> 2. 地图: 星际酒馆, 人数: 6/8

# 查询战绩
/战绩
> 对局记录：
> 1. 地图: 沙漠风暴, 结果: 胜利
> 2. 地图: 星际酒馆, 结果: 失败

⚠️ 注意事项

• 🔌 代理配置：需要配置有效的代理服务器地址（部分地区需要）
• 🔤 句柄格式：严格遵循 区域ID-S2-服务器ID-档案ID 格式
• 🚫 敏感词过滤：玩家名称会自动进行敏感词过滤处理
• 💾 数据缓存：绑定信息默认存储在数据库，重启后保留
• 🔄 多句柄支持：每个用户可以绑定多个游戏句柄，但一个句柄只能被一个用户绑定
• ⭐ 活跃句柄：战绩和场数查询使用当前活跃句柄

📃 更新日志

✨ 1.2.4

• 新增一个配置项

✨ 1.2.3

• 新增一个配置项
• 优化代码

✨ 1.2.1 & 1.2.2

• 优化文字输出和描述

✨ 1.2.0

• 新增多句柄绑定功能
• 添加句柄切换功能
• 优化句柄显示格式（添加区域标识）
• 更新数据库结构支持多句柄

✨ 1.1.22

• 使用新的敏感词检测API，提高检测率
• 新增一个配置项

✨ 1.1.20

• 优化数据库表

✨ 1.1.19

• 添加了引用回复

✨ 1.1.16 & 1.1.17 & 1.1.18

• 修改部分文字描述
• 删除几处不合理的emoji表情

✨ 1.1.14 & 1.1.15

• 修改部分文字描述

✨ 1.1.12 & 1.1.13

• 优化了敏感词API检测
• 添加了游戏大厅玩家名称缓存数据库

✨ 1.1.11

• 删除几处不合理的emoji表情

✨ 1.1.8

• 优化了[@用户]的代码逻辑

✨ 1.1.7

• 修改了几处emoji表情

✨ 1.1.6

• 更新readme.md
• 优化代码

✨ 1.1.0

• 上传正式版

📄 License

本项目采用 MIT 许可证。