该Excel导数据工具内置在我写的在线RPG地图编辑器内,可在线使用。
地图编辑器地址
Cocos Creator | EasyMapEditor_v2_0_1
Excel导数据工具位置如下截图
在上面界面截图种,点击那个浏览按钮,选一个Excel文件,文件只支持xlsx格式,然后点击“导出数据”或“导出脚本”,会弹一个系统文件目录选择窗,选择一个保存目录就自动导出了。数据支持json和xml,脚本支持ts,d.ts,c#,java。如果还需要其它脚本的或其它格式的数据导出可联系作者,工具上有作者的联系方式。
Excel配置规则
一、基本规则
如上面截图所述,Excel数据配置规则一共分为4行。
1、第一行是字段描述,生成脚本类时,这行描述会添加到脚本字段备注里。
2、第二行是字段名,生成数据后根据字段名读取对应的字段数据。可以不填,不填不会导出,之后做Excel文档表单的纯描述数据。
3、第三行是字段类型,类型对应C#的类型,包括数值型:byte,short,ushort,int,uint,long,ulong,float,double。布尔型:bool。字符串型:string。如果不填默认是string
4、第四行开始是数据行,表单格可以不填,数值型字段不填默认是0,布尔型字段不填默认是false,字符串类型不填默认是""
导出时会以表单名做为文件名导出,比如上面截图的表单名为Player,所以导出的数据和脚本都命名为Player。如下图:
二、高级配置规则
这个工具不止只能导出一个表单数据,还可以多表单数据导出,表单之间可以做逻辑关联。
如下截图
如上截图,表单命名分为4大类:
1、“使用说明”,“SheetDesc”,这两个名称是纯备注和描述用的,随便写,不会被导出。
2、关键字定义表,命名为“keywordDefine”或“关键字定义表”二选一,是用来给某些关键字做类似于宏定义一样的功能,供给其它表用,并且这个表会被导出枚举脚本。比如这个表把 “人”定义成 “1”,那么其它数据表的数值字段填“人”,导出数据时都被转换成“1”。
3、表单定义表,命名为“SheetDefine”或“表单定义表”二选一,是用来给某些表名重定义的,一些表单使用了中文命名,但是导出数据和脚本时希望用英文,这个表单定义表就起这个作用。比如:命名了个“玩家”的表单,但是希望导出数据和脚本时又被命名为“Player”,那就在表单定义表里把“玩家”映射为“Player”。
4、除了上面3种表单的预定命名名称外的其它所有命名的表都是数据表。
三、关键字定义表的作用。
如下截图:
在关键字定义表,配置有关键字名“男性”和“女性”并且对应值为“1”和“2”,所有在Role表里给int型字段填“男性”和“女性”,导出数据时会被转换成“1”和“2”。
这样做的好处是,对玩家性别直接填“1”和“2”可读性差,不看规则很难指定“1”和“2”分别代表什么,面对海量配置数据直接填数值很容易填错,如果改成中文名就一目了然了,可大大减少配置错误。
四、表单定义表的作用
表单定义表就是给表单名做重定义,如果有重定义,导出数据表和脚本时就用重定义名称导出,如果没有重定义就用原名。重定义的好处是,游戏表用英文命名可读性差,比如表单命名为“Item”,一些英文不好的策划就不懂啥意思了,名称改成“道具表”就清晰了,但是开发者要的数据和脚本的规范一般是英文名,所有在表单定义表给这个“道具表”重定义为“item”就可以了。如下图。
五、表单合并导出
这个是表单定义表的延申功能,把几个表单的表单映射名都命名为相同的名字,这样就可以合并成一个文件导出了。比如我地图编辑器案例里的商店表。如下图:
下图中,有几个商店配置表单,在表单定义表内全部映射为同一个名字,所以所有表单都会合并为同一个表导出,合并的好处是资源是资源统一管理统一加载。对了这几个商店表单的字段名都是一样的。
六、快速配置Excel数据
可以在工具界面上点击“下载Excel模板文件”按钮,模板文件上把使用案例都添加有了,在这个模板文件上改成你的游戏配置数据会更快捷。
这个数据导出工具不限于只做这个地图编辑器项目,做其它游戏项目也是通用的。
如果对游戏地图编辑器感兴趣,可以看一下我另一个详细介绍这个编辑器的贴子。
"RPG在线地图编辑器”迎来大更新,功能更加强大,能轻松搞定RPG或SLG游戏 - Creator 3.x - Cocos中文社区













