PJSK猜卡插件使用说明

1. 插件功能简介

本插件是使用《プロジェクトセカイ カラフルステージ！ feat. 初音ミク》/《世界计划 多彩舞台》/《初音未来 缤纷舞台》a.k.a. PJSK经过少量修改的卡面资源制作的猜卡面游戏。插件会随机展示一张经过模糊处理的角色卡牌图片，并给出少量提示，玩家需要在规定时间内根据图片和提示猜出正确的卡牌ID。

插件内置了积分排行榜、每日游戏次数限制、游戏冷却等功能。

注意：本插件所有必需的图片和数据资源均托管在我的服务器，并已经默认配置，不需要下载（日后可能会上传资源下载供本地使用），资源截止至日服v5.4.0版本

2. 指令列表

游戏指令

• 猜卡 / 猜卡面 / guess / gc: 开始一轮完全随机的猜卡游戏。
• 猜卡 [角色名]: 猜指定角色的卡面。昵称或缩写（如 mfy）。
  • 示例: 猜卡 miku

数据与帮助

• 猜卡帮助: 显示本帮助信息。
• 猜卡排行榜 / gcrank / gctop: 查看猜卡总分排行榜。
• 猜卡分数 / gcscore: 查看自己的猜卡数据统计。

管理员指令

• 重置猜卡次数 / resetgl [用户ID]: 重置指定用户（或自己）的每日游戏次数。
  • 示例: 重置猜卡次数 123456789 (重置指定QQ号的次数) 或 重置猜卡次数 (重置自己的次数)。

3. 插件配置说明

插件的配置由机器人管理员通过 AstrBot 框架提供的 WebUI 界面进行修改。以下是可配置的选项说明：

{
  "group_whitelist": [],
  "super_users": [],
  "answer_timeout": 300,
  "daily_play_limit": 10,
  "game_cooldown_seconds": 60,
  "max_guess_attempts": 10
}

• group_whitelist (列表): 群聊白名单。只有在此列表中的群号才能使用本插件。若列表为空 []，则对所有群聊生效。
• super_users (列表): 管理员QQ号列表。
• answer_timeout (整数): 每轮游戏的回答超时时间（秒）。
• daily_play_limit (整数): 每个用户每天可以发起游戏的最大次数。
• game_cooldown_seconds (整数): 游戏结束后的冷却时间（秒）。
• max_guess_attempts (整数): 每轮游戏中，所有玩家总共可以尝试回答的次数上限。