3d-prints

一个开放、社区驱动的数据集，包含桌面游戏及其3D可打印配件。An open, community-driven dataset comprising tabletop games and their 3D-printable accessories.

原始信息汇总

数据集概述

该数据集是一个开放、社区驱动的数据集，将桌游与3D打印配件（升级件、收纳盒、内衬、指示物和玩家辅助工具）进行映射，数据来源于多个主流3D打印平台。

数据来源

• 桌游数据来源于 BoardGameGeek
• 3D打印列表来源于 Printables、MakerWorld、Thingiverse、Cults3D 等平台
• 数据集由桌游爱好者和3D打印爱好者通过社区贡献、评审和修正持续改进

核心内容

数据集以 NDJSON 格式存储，每个表对应一个文件，每行一个JSON对象。manifest.json 包含行数和生成时间戳。

• games.jsonl — 桌游信息：名称、年份、BGG ID、Meepleprint页面链接
• game_relationships.jsonl — 游戏之间的扩展、重制、整合和编译关系
• prints.jsonl — 3D打印列表：标题、来源、链接、作者和互动统计
• print_variants.jsonl / print_variant_plates.jsonl — 重量、打印时间、板数和耗材使用
• sources.jsonl / categories.jsonl — 平台和打印类别的参考表
• print_category.jsonl — 每个打印分配的类别
• game_print.jsonl — 游戏与打印之间的链接，包含 match_confidence 评分

game_print.jsonl 中包含满足默认置信度阈值的匹配。match_confidence 数值越高，表示桌游与打印列表之间的匹配越强。

使用说明

• 数据集仅作为索引，不托管或重新分发3D打印文件、描述或图像
• 每条打印记录包含元数据和指向原始列表的链接
• 提供 API访问 方式，可通过Meepleprint注册免费API密钥获取实时数据

贡献方式

• 单次添加或修正：通过Meepleprint各游戏页面上的“Submit a print”按钮提交
• 大规模更改：对新的来源平台、批量修正或schema变更提交Pull Request
• 由于JSONL文件由Meepleprint实时目录生成，建议描述底层修正而非直接编辑生成文件

更新与许可

• 数据集定期从Meepleprint实时目录重新生成，manifest.json 中包含最新的 generated_at 时间戳
• 采用 Open Database License v1.0 许可，署名和来源许可信息见 ATTRIBUTION.md
• 使用数据时需注明出处并链接回本仓库；如有前端界面，需展示仓库中的 open-bg-data-logo 图片并使其链接到本仓库

搜集汇总

数据集介绍

构建方式

该数据集以开放协作模式构建，旨在映射桌游与3D打印配件之间的关联。数据源于BoardGameGeek平台收录的桌游信息，并与Printables、MakerWorld、Thingiverse、Cults3D等主流3D打印平台上的打印列表进行匹配。整个数据集以NDJSON格式存储，每个表对应一个文件，每行包含一个JSON对象，便于机器读取与处理。核心表game_print.jsonl通过match_confidence评分记录游戏与打印之间的关联强度，默认阈值确保了匹配的可靠性。此外，数据集通过社区贡献、审查与修正机制持续更新，由Meepleprint实时目录生成，确保数据的时效性与完整性。

特点

该数据集的核心特色在于其索引性质而非镜像存储，它不直接托管或分发3D打印文件，而是提供每个打印记录的元数据及原始链接，有效规避了版权问题。数据结构设计严谨，涵盖游戏、打印、变体、类别、来源等多维度信息，支持复杂查询与关联分析。match_confidence评分体系赋予了数据较强的可调性，研究者可根据需求自定义阈值以获取更精确的匹配结果。通过games.jsonl与game_relationships.jsonl，数据不仅记录了游戏本身，还揭示了扩展、重制等复杂关系网络，为桌游生态的深度分析提供了丰富素材。

使用方法

使用者可通过两种方式获取数据：一是直接下载NDJSON格式的原始文件，适用于离线分析与批量处理；二是通过Meepleprint平台注册获取免费API密钥，实现实时数据访问，便于动态应用集成。在数据处理中，可利用game_print.jsonl的match_confidence字段进行灵活过滤，以适配不同精度的研究需求。对于社区贡献者，既可通过Meepleprint网站提交单次打印或修正，也可通过Pull Request进行批量修改或架构调整，但需注意直接编辑生成的JSONL文件并非最佳实践，而应描述底层修正以便维护数据一致性。数据遵循Open Database License v1.0，使用时需注明出处并链接回仓库，以支持项目持续发展。

背景与挑战

背景概述

3d-prints数据集诞生于数字制造与桌面游戏文化交融的时代，由Meepleprint团队于2026年创建，旨在填补桌游爱好者与3D打印资源之间的鸿沟。该数据集基于BoardGameGeek的桌游信息，系统映射了Printables、MakerWorld、Thingiverse、Cults3D等主流3D打印平台上的升级件、收纳盒、指示物等配件，构建了一个开源的、社区驱动的索引。其核心研究问题在于验证能否通过结构化数据，为任意桌游快速定位其可打印的扩展资源，从而提升玩家体验。该数据集不仅支撑了Meepleprint平台，更因开放许可和持续更新机制，成为连接桌游社区与3D打印生态的关键数据基础设施，对推动个性化桌游配件的发现与共享具有显著影响力。

当前挑战

该数据集面临的挑战首先源于领域问题的复杂性：桌游与3D打印配件的匹配涉及语义理解的模糊性，例如同一游戏的不同版本或扩展需精确关联，而打印件标题中的非标准化命名常导致误匹配，数据集中通过match_confidence分数进行阈值筛选，但仍需用户按需调整。构建过程中的挑战尤为突出，包括跨平台数据抓取的异构性，需从多个来源整合元数据与互动统计；数据更新与维护依赖社区贡献，需建立高效审核流程以确保质量；同时，版权与许可问题要求每一条记录均需追溯至原平台，遵循ODbL许可及来源声明。此外，数据集以NDJSON格式分表存储，维护多表间的一致性及实时更新时的同步，也是持续存在技术难点。

常用场景

经典使用场景

该数据集构建了桌游与3D打印配件之间的结构化映射体系，覆盖游戏本体、扩展、重制及整合关系，并整合了来自Printables、MakerWorld等主流平台的打印条目元数据。研究者可借助其基于NDJSON格式的高效数据接口，进行大规模跨平台信息检索、匹配置信度阈值分析，以及桌游生态系统的量化图谱构建，为数字制造与桌游文化交叉领域提供了标准化的数据基准。

实际应用

在应用层面，该数据集直接驱动Meepleprint等工具，使用户能够按游戏查询可用的3D打印升级件、收纳盒及玩家辅助工具，从而显著提升桌游玩家的定制化体验。同时，其数据服务接口及开源许可协议为开发者提供了便捷的数据接入途径，支持在电商推荐、内容聚合及打印管理系统中嵌入智能匹配功能，促进了3D打印社区与桌游产业的生态融合与价值共创。

衍生相关工作

该数据集的核心设计启发了多项衍生工作，包括基于匹配置信度的智能推荐算法研究，以及跨平台打印资源的语义对齐与知识图谱构建。其开源更新机制和社区贡献模式为后续的数据清洗、版本控制及质量评估方法提供了参照范例。此外，数据集中蕴含的游戏关系网络为社交网络分析和群体创作行为研究提供了丰富素材，相关成果有望反哺数据集本身的完善，形成数据驱动的研究闭环。