# oops-plugin-excel-to-json

**Repository Path**: dgflash/oops-plugin-excel-to-json

## Basic Information

- **Project Name**: oops-plugin-excel-to-json
- **Description**: oops-plugin-excel-to-json 是基于 Cocos Creator 3.x 开发的Excel转Json格式的插件，同时会根据表格中的字段生成数据结构TypeScript代码。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 30
- **Forks**: 43
- **Created**: 2022-07-26
- **Last Updated**: 2025-05-30

## Categories & Tags

**Categories**: excel-utils

**Tags**: CocosCreator, TypeScript

## README

### 游戏配置数据生成 + 数据对象代码生成器插件
![Cocos Creator 3.x 配套游戏配置数据生成 + 数据对象代码生成器插件](https://gitee.com/dgflash/oops-plugin-excel-to-json/raw/master/doc/1.png)

### Cocos Creator 3.x 配置Excel文件目录、配置Json数据输出目录、配置脚本输出目录
![Cocos Creator 3.x 配置Excel文件目录、配置Json数据输出目录、配置脚本输出目录](https://gitee.com/dgflash/oops-plugin-excel-to-json/raw/master/doc/2.png)


### Cocos Creator 3.x 扩展 -> Oops-Framework Excel To Json
![Cocos Creator 3.x 扩展 -> Oops-Framework Excel To Json](https://gitee.com/dgflash/oops-plugin-excel-to-json/raw/master/doc/3.png)

### Cocos Creator 3.x 生成数据资源与脚本资源
![Cocos Creator 3.x 生成数据资源与脚本资源，减少编码工作](https://gitee.com/dgflash/oops-plugin-excel-to-json/raw/master/doc/4.png)

工具指向策划配置表目录后，每次更新配置时，一键生成数据与静态配置表代码，在项目中后期平凡维护修改时，提高开发效率。

### Excel中数据规则
- Excel中前五行为工具规则数据
- 第一行为字段中文名
- 第二行为字段英文名，会生成为json数据的字段名
- 第三行为字段数据类型，只支持number、string类型，数组和对象类型可自行扩展
- 第四行标记输出服务器数据时，是否存在这个字段"server"为显示字段，"server_no"为删除字段
- 第五行标记输出客户端数据时，是否存在这个字段"client"为显示字段，"client_no"为删除字段