WikiTrivia:把Wikipedia变成卡牌的时间线问答游戏——完整项目总览与3分钟快速上手
WikiTrivia:把Wikipedia变成卡牌的时间线问答游戏——完整项目总览与3分钟快速上手
WikiTrivia 是一个开源的时间线卡牌问答游戏:它从 Wikipedia 和 Wikidata 抓取真实条目,做成一张张卡牌,你需要凭常识把它们按年代先后顺序拖放到时间线上。数据驱动、纯前端静态部署、支持拖拽动画,是学习 Next.js 单页游戏开发的一个优质小项目。
玩法介绍:时间线卡牌游戏怎么玩?
WikiTrivia 的核心玩法只有一句话:把卡片按时间先后顺序放到时间线上。
具体规则如下:
- 🃏 抽卡作答:游戏会连续发出带图片和简介的卡片(例如某个国家、某位人物、某个发明),不直接显示年份,你需要把它插入下方时间线的正确位置;
- ❤️ 3 条生命:放错位置会扣一颗心,放错卡片会被高亮提示你离正确位置有多远;
- 🔥 连击计分:连续答对会累积 Streak(连击),游戏结束前会实时刷新保存在浏览器本地的最佳纪录;
- 🏅 奖牌结算:结束后按连击数颁发奖牌——20 连以上金牌 🥇、10 连以上银牌 🥈、1 连以上铜牌 🥉,还可以一键复制成绩去分享。
卡片会刻意避开年份差距过小的干扰项,并且随机跳过约一半的"人物类"卡片,保证每一局都有可玩性和挑战性。
3分钟快速上手:本地运行 WikiTrivia
项目是纯静态网站,无需后端和数据库,准备好 Node.js 环境后三步即可跑起来:
第 1 步:克隆仓库
git clone https://gitcode.com/gh_mirrors/wi/wikitrivia
第 2 步:安装依赖
npm install
第 3 步:启动开发服务器
npm run dev
然后访问 http://localhost:3000/ 即可开始游戏。
如果你想要一个可部署的静态版本,执行 npm run build 会生成到 out 目录,再用 npm start 运行。由于 next.config.js 中开启了 output: "export",这个 out 目录可以丢到任意静态托管服务上,零成本部署。
完整项目总览:代码结构与技术栈
WikiTrivia 基于 Next.js 14 + React 18 + TypeScript 构建,拖拽交互由 react-beautiful-dnd 实现,动画使用 react-spring,样式为 SCSS 模块化方案。
wikitrivia/
├── components/ # 游戏界面组件(核心逻辑都在这里)
│ ├── game.tsx # 入口:加载数据、管理游戏状态
│ ├── board.tsx # 棋盘:拖拽、判分、扣血
│ ├── hearts.tsx # 生命值(三颗心)
│ ├── game-over.tsx # 结算与奖牌
│ ├── instructions.tsx # 开局说明页
│ └── ... # 卡片区、计分、加载态等
├── lib/ # 纯逻辑层
│ ├── create-state.ts # 初始化牌局(3 条命、起手卡)
│ ├── items.ts # 抽卡策略与判对错算法
│ ├── image.ts # 拼接 Wikimedia Commons 图片地址
│ └── bad-cards.ts # 已知坏数据黑名单
├── types/ # TypeScript 类型定义
├── pages/ # Next.js 页面(仅首页 + 应用壳)
├── public/
│ └── items.json # 全部卡牌数据(约 3.2MB)
└── styles/ # 各组件对应的 SCSS 模块
卡牌数据是怎么来的?
所有卡片数据来自 Wikidata 和 Wikipedia,集中存放在 public/items.json(JSON Lines 格式,每行一张卡)。每张卡包含标签、简介、年份、图片名、Wikidata ID 等字段(定义见 types/item.ts),卡片图片则按文件名实时拼接 Wikimedia Commons 中。
数据加载时会在 components/game.tsx 中做一轮清洗:
- 过滤掉标签或简介中直接泄露年份的卡片(答案会自曝);
- 过滤掉简介含"xx世纪"等模糊时间词的卡片;
- 过滤掉社区反馈过的坏数据卡片,黑名单维护在 lib/bad-cards.ts。
抽卡与判分:两个核心算法
智能抽卡(lib/items.ts 中的 getRandomItem)把年份切成三个大区间(公元前 1000 年以前、1000–1800 年、1800 年至今),每次随机选一个区间再抽卡,并用 tooClose 函数排除与已出卡片年份过近的选项——开局前 10 张卡甚至要求至少相差几十年,避免"背年份"式作答。
判分(同文件中的 checkCorrect)非常直接:把已出卡片加上新卡按年份排序,看新卡应处的下标是否等于你放置的下标,不相等则记为放错,并返回偏差 delta 用于高亮提示。
一局的状态结构很简单,见 types/game.ts:牌堆 deck、已出卡片 played、下一张 next、再下一张 nextButOne(用于提前预加载图片)、生命值 lives(初始 3,见 lib/create-state.ts)和放错卡片标记 badlyPlaced。拖拽与状态流转全部在 components/board.tsx 中完成,最高分则通过 localStorage 持久化。
FAQ:常见问题
- 数据来自哪里? 全部来自 Wikidata / Wikipedia,由作者单独的爬虫项目抓取后整理成
items.json。 - 玩到一张说不通的卡片怎么办? 确实存在少量数据质量不佳的卡片,可通过仓库的 issue / discussion 反馈,作者会将其加入黑名单并从游戏中移除。
小结
WikiTrivia 用极小的代码量演示了完整的前端游戏闭环:静态数据加载、状态管理、拖拽交互、动画反馈、本地最高分持久化。如果你想找一个易读易改的 Next.js 小项目练手(比如换一套数据源、加排行榜、改成中文卡片),它是一个非常合适的起点。