SuperAPI AI 工具集

quiz-game-mechanics

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:为 dev-quiz-battle 实现测验类游戏的核心机制与游戏逻辑,覆盖从对局创建到结算的完整流程,适用于构建多人实时答题或编程知识对战类游戏。

主要能力:

  1. 对局创建:createGame mutation 以 creatorId、language、maxRounds 为参数,生成 6 位唯一游戏码,初始状态为 waiting,记录创建者、玩家列表、当前回合与时间戳。
  2. 玩家管理:joinGame 按游戏码查找对局,仅在 waiting 状态允许加入;对局不存在或已开始会抛错。
  3. 回合推进:startNextRound 递增 currentRound,超过 maxRounds 时将状态置为 finished;否则按语言与玩家人数生成题目,状态置为 in-progress。
  4. 计分:calculateScore 按难度给定基础分(easy 10、medium 20、hard 30),答对后叠加时间奖励(最多 30 秒内每秒 +1),答错得 0 分。submitAnswer 校验答案并写入 answers 记录,返回是否正确与得分。
  5. 结算:completeGame 汇总全部答案得到各玩家总分,按分数降序确定胜者,更新状态为 finished 并写入 winnerId 与 finalScores。

使用方式:以 Convex mutation 形式实现,通过 ctx.db 读写 games、questions、answers 等表。资料只给出上述代码片段,未提供安装命令、依赖清单或运行方式,暂未提供。

边界情况:同时提交以最后提交为准;断线玩家标记为 inactive 且不计其答案;拒绝超时提交;校验所选语言与可用题目匹配;需处理同分并列。

限制:资料未说明具体部署平台、前端集成、鉴权、题目来源与平衡参数细节,仅提及可参考 Game Balance Reference 调整参数。