Catan-data/dataset
GitHub: Catan-data/dataset
公开的大规模匿名卡坦游戏数据集，解决高质量博弈数据稀缺问题。
Stars: 11 | Forks: 4
# 游戏数据 - 公开数据集
该数据集包含 **43,947 场游戏**（在线卡坦），已匿名化处理，供研究和分析使用。
## 下载
**[从发布页下载 games.tar.gz](https://github.com/Catan-data/dataset/releases/latest)**
```
# 提取数据
tar -xzf games.tar.gz
# 这将创建一个包含 43,947 个 JSON 文件（约 6.9GB 未压缩）的 'games/' 文件夹
```
## 数据集概览
- **总游戏数**：43,947 场四人游戏
- **总玩家数**：约 175,000 个玩家实例
- **游戏模式**：标准四人卡坦
- **数据格式**：JSON 文件（每场游戏一个文件）
## 数据结构
每个游戏文件包含：
```
{
"data": {
"playerUserStates": [...], // Player info (anonymized)
"playOrder": [2, 5, 3, 1], // Turn order by player color
"gameSettings": {...}, // Game configuration
"eventHistory": {
"events": [...], // All game events
"endGameState": {...}, // Final game state with winner
"totalTurnCount": 69, // Game length
"initialState": {...} // Starting board state
}
}
}
```
## 关键数据字段
### 玩家颜色
玩家通过颜色编号标识：
- 1 = 蓝色
- 2 = 红色
- 3 = 橙色
- 4 = 棕色（罕见）
- 5 = 白色
### 事件类型（位于 `gameLogState`）
事件存储在 `stateChange.gameLogState` 中，字段为 `text.type`：
| 类型 | 描述 |
|------|------|
| 4 | 建造（定居点/道路/城市） |
| 11 | 掷骰获得的资源 |
| 14 | 与银行交易 |
| 15 | 与玩家交易 |
| 20 | 使用发展卡 |
| 22 | 购买发展卡 |
| 45 | 宣布游戏胜利者 |
| 49 | 移动强盗 |
| 55 | 丢弃卡牌（掷出 7） |
| 86 | 强盗效果 |
### 发展卡枚举（`cardEnum`，类型 20）
| 枚举值 | 卡牌 |
|--------|------|
| 10, 11 | 骑士 |
| 12 | 垄断卡 |
| 13 | 胜利点卡 |
| 14 | 道路建设卡 |
| 15 | 丰饶年卡 |
### 资源枚举
| 枚举值 | 资源 |
|--------|------|
| 1 | 砖块 |
| 2 | 羊毛 |
| 3 | 谷物 |
| 4 | 矿石 |
| 5 | 木材 |
### 棋盘坐标
- **六边形格**：`(x, y)` 坐标
- **角落**：`(x, y, z)`，其中 z=0 表示“上”角，z=1 表示“下”角
- **边**：`tileEdgeStates` 中的边 ID
### 游戏结束状态
胜利者信息位于 `data.eventHistory.endGameState.players`：
```
{
"players": {
"2": {
"rank": 1,
"color": 2,
"winningPlayer": true,
"victoryPoints": {
"0": 3, // Settlements
"1": 2, // Cities
"2": 1, // Largest Army (2 VP)
"3": 1, // Longest Road (2 VP)
"4": 1 // VP cards
}
}
}
}
```
## 骰子点数概率（Pip 值）
标准卡坦骰子点数分布：
| 数字 | 点数 |
|------|------|
| 2, 12 | 1 |
| 3, 11 | 2 |
| 4, 10 | 3 |
| 5, 9 | 4 |
| 6, 8 | 5 |
| 7 | -（强盗） |
## 隐私声明
本数据集已 **匿名化** 处理：
- ❌ 无用户名
- ❌ 无用户 ID
- ❌ 无国家代码
- ✅ 保留玩家颜色
- ✅ 保留所有游戏事件
- ✅ 保留棋盘状态
## 许可证
本数据集仅限 **研究和教育用途**。
## 引用
若使用该数据集，请引用：
```
MR. MUCHO BUCHO Game Data (2025)
43,947 anonymized 4-player Catan games
https://github.com/Catan-data/dataset
```
标签：43, 4 player, 947 场游戏, BSD, Catan, Homebrew安装, JSON, 代码示例, 公共资源, 四人对战, 在线游戏, 开发卡, 开源数据, 数据分析, 数据挖掘, 桌游, 游戏事件, 游戏回放, 游戏数据, 游戏日志, 游戏模式, 玩家行为, 研究分析, 研究数据, 资源交易, 逆向工具