# 飞行棋

**Repository Path**: pega/feixingqi

## Basic Information

- **Project Name**: 飞行棋
- **Description**: 可以自定义棋盘及棋盘内容的飞行棋代，支持默认棋盘、上传自定义的json格式棋盘
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-22
- **Last Updated**: 2025-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### `npm start`
启动项目

### `npm run build`
打包发布版本

# 自定义棋盘配置说明

## 配置文件格式

棋盘配置使用JSON格式，包含两个主要部分：

### 1. boardLayout (棋盘布局)
二维数组，定义棋盘的形状和格子排列：
- 数字：格子编号
- "E"：空格子

### 2. squareData (格子数据)
对象，定义每个格子的属性：

```json
{
  "格子编号": {
    "type": "格子类型",
    "title": "格子标题",
    "icon": "图标",
    "description": "描述",
    "data": { "额外数据" }
  }
}
```

## 格子类型

### 基本类型
- `"start"`: 起点格子
- `"normal"`: 普通格子
- `"event"`: 事件格子
- `"end"`: 终点格子（必须有至少一个）

### 传送类型
- `"teleport"`: 传送门格子
  ```json
  {
    "type": "teleport",
    "title": "传送门",
    "icon": "🌀",
    "description": "传送到其他位置",
    "data": { "targetSquare": 目标格子编号 }
  }
  ```

## 示例配置

最小配置示例：
```json
{
  "boardLayout": [
    [0, 1, 2],
    ["E", "E", 3],
    ["E", 5, 4 ]
  ],
  "squareData": {
    "0": { "type": "start", "title": "起点", "icon": "🏁", "description": "开始" },
    "1": { "type": "normal", "title": "路径", "icon": "🛤️", "description": "前进" },
    "2": { "type": "normal", "title": "转角", "icon": "↩️", "description": "转弯" },
    "3": { "type": "event", "title": "事件", "icon": "❓", "description": "随机事件" },
    "4": { "type": "normal", "title": "路径", "icon": "🛤️", "description": "继续" },
    "5": { "type": "end", "title": "终点", "icon": "🎯", "description": "完成！" }
  }
}
```

## 配置规则

1. **布局中的每个数字格子都必须在squareData中定义**
2. **必须包含至少一个type为"end"的终点格子**
3. **传送门的目标格子必须存在且有效**
4. **格子编号建议从0开始连续编号**

## 使用方法

1. 点击"显示配置选项"按钮
2. 点击"下载示例配置"获取参考模板
3. 编辑JSON文件创建自定义棋盘
4. 点击"上传自定义棋盘"选择你的JSON文件
5. 系统会自动验证并加载新配置

## 注意事项

- JSON文件必须格式正确
- 建议先下载示例配置作为模板
- 上传前可以使用JSON验证工具检查格式
- 如果加载失败，可以重置为默认配置