自动从 BoardGameGeek 下载收藏及元数据,生成 SQLite 数据库
GameCache — Python 游戏站模板
作者 EmilStenstrom
将BoardGameGeek收藏转为可搜索的GitHub Pages网站,支持筛选与自动更新。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
补采画面存在空白、加载或排版异常,当前保留可用的原始预览。
目前有 1 张原始预览,可打开完整图片查看设计细节。
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
支持按玩家人数、时长、复杂度、分类等多维度筛选
通过 GitHub Pages 免费托管,无需自建服务器
提供脚本自动化获取 BGG token、验证配置、生成数据库
可选启用 GitHub Actions 每小时自动同步收藏
项目以 GitHub Template 形式发布,便于一键复制部署
模板详细介绍
GameCache 是一个面向桌游爱好者的开源模板,核心功能是把你在 BoardGameGeek 上的收藏自动转换为一个可搜索的静态网站。它通过 Python 脚本从 BGG 拉取游戏数据,生成 SQLite 数据库,并借助 GitHub Pages 免费托管,最终呈现一个带筛选功能的目录型页面。项目结构清晰,配置集中在 config.ini 文件中,适合希望快速展示个人桌游库的玩家。
网站支持按玩家人数、游戏时长、复杂度、分类等维度筛选,并展示 BGG 上的评分、描述、机制等详细信息。整个流程高度自动化:从获取 BGG API token、生成数据库到上传 GitHub Release,均有脚本辅助,还支持通过 GitHub Actions 设置每小时自动同步收藏。对于拥有一定桌游数量、希望建立个人展示页面的用户,这是一个实用且低成本的解决方案。
需要注意的是,该模板依赖 GitHub 和 BGG 账号,且要求本地安装 Python 3.8-3.12 环境。首次运行需 5-15 分钟下载数据,GitHub Pages 激活也有延迟。项目处于活跃维护状态,但 BGG API 政策变动可能影响 token 获取方式,建议部署前查看最新 README 或 issues。
适合你的项目吗?
适用场景
- 个人桌游收藏展示与分享
- 桌游爱好者建立轻量级个人网站
- 学习 Python 脚本与 GitHub Pages 集成的示例项目
适合人群
- 拥有 BoardGameGeek 账号且收藏公开的桌游玩家
- 熟悉 GitHub 基本操作和命令行,愿意阅读文档的用户
- 希望低成本维护个人网站、且不介意依赖第三方平台的人
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
部署前需在 config.ini 中填写 BGG 用户名和 GitHub 仓库信息,并运行 setup_bgg_token.py 获取 API token。
- 2
确保 Python 版本在 3.8-3.12 之间,否则可能需要重新生成依赖文件。
- 3
GitHub Pages 需在仓库设置中手动启用,且仓库必须为公开。
- 4
首次生成数据库耗时较长,建议先运行 validate_setup.py 检查配置。
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可证允许免费使用、修改、分发和商业使用,仅需保留版权与许可声明。README中提及的Meeple图标为CC4署名许可,需单独遵守。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明和许可声明于所有副本或实质部分
- Meeple图标需按CC4 Attribution要求署名
额外费用与待核对事项
- BoardGameGeek API数据的使用受其自身条款约束,未在文档中确认
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
Meeple icon (CC4 Attribution): https://icon-icons.com/icon/meeple/38522#256
README 原文
https://github.com/EmilStenstrom/gamecache/licensehttps://github.com/EmilStenstrom/gamecache/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料一般 · 69 / 100
- 技术栈
- Python · JavaScript
- 网站类型
- 游戏站 · 目录
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-08-31
- 截图检查日期
- 未记录
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Python。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

2048
2048 是一个风靡全球的数字合并益智游戏的开源网页实现,最初由 Gabriele Cirulli 开发,基于 1024 和 Saming 的 2048 克隆而来。
JavaScript · 游戏站

flexboxfroggy
Flexbox Froggy 是一个通过游戏化方式学习 CSS Flexbox 的开源项目,由 Thomas Park 创建并维护。
JavaScript · 游戏站

server survival
Server Survival 是一个将云架构知识融入游戏机制的 3D 模拟项目。 你扮演云架构师,通过搭建和扩展基础设施来应对流量增长、DDoS 攻击与预算限制。
Three.js · 游戏站

HexGL
HexGL 是一个开源的未来风格 HTML5 竞速游戏项目,由 BKcore 开发,源码托管在 GitHub,并提供了可直接游玩的在线演示。
JavaScript · 游戏站

vimmaster
vimmaster 是一个通过游戏化方式学习 Vim 命令的开源网页项目,提供了真实的在线演示。 它的核心结构包括一个模拟编辑器环境,玩家在其中完成短小精悍的课程,通过积累经验值、连击和徽章来获得成就感。
JavaScript · 游戏站

pacman
这是一个经典吃豆人游戏的网页版实现,由 passer-by.com 制作并开源。
JavaScript · 游戏站
