Luban策划开源工具

一、Luban游戏配置解决方案，是一个强大、易用、优雅、稳定的游戏配置解决方案。它设计目标为满足从小型到超大型游戏项目的简单到复杂的游戏配置工作流需求。luban标准化了游戏配置开发工作流，可以极大提升策划和程序的工作效率。

二、核心特性：

1 丰富的源数据格式。支持excel族(csv,xls,xlsx,xlsm)、json、xml、yaml、lua等；

2 丰富的导出格式。 支持生成binary、json、bson、xml、lua、yaml等格式数据；

3 支持多种的语言。支持生成c#、java、go、cpp、lua、python、typescript 等语言代码。

4 支持所有主流的游戏引擎和平台。支持Unity、Unreal、Cocos2x、Godot、微信小游戏等

5 良好的跨平台能力。能在Win,Linux,Mac平台良好运行。

三、Luban的项目集成和使用。

1 首先下载源码，网址为 https://github.com/focus-creative-games/luban_examples 

2 解压源码，进入目录，项目“Csharp_Unity_bin_or_json”是Luban工具专为Unity准备的工程示例，我们可以参考这个项目进行开发。

拷贝文件夹LubanLib到我们的Unity工程项目中，如下 

这部分代码是Luban的加载部分，用于策划操作的Excel导出的json数据文件的加载。

3 配置Excel及工具的使用

在工程项目“Assets”同级目录建立luban工具及配置的顶层文件夹“LubanTool”，里面将luban的Excel文件生成jsong的工具“Luban.ClientServer”拷贝这里，然后同级的再建立个“Edu”文件夹，用于存放策划的Excel配置文件。

    4 “Edu”文件夹：查看脚本工具“gen_code_json.bat”的代码，如下，结合项目进行讲解

set WORKSPACE=..

“Luban.ClientServer.exe”工具是excel生成json文件的工具

set GEN_CLIENT=%WORKSPACE%\Luban.ClientServer\Luban.ClientServer.exe

set WORKROOT=%WORKSPACE%\%WORKSPACE%

%GEN_CLIENT% -j cfg --^

 -d Defines\__root__.xml ^

下面这行“Datas”设置为输入目录，一些excel项目配置信息和项目的excel策划数据

 --input_data_dir Datas ^

下面是指定从excel策划脚本生成json数据的位置及名称

 --output_code_dir %WORKROOT%\Assets\Resources\Common\Scripts\Data\EduGen ^

 --output_data_dir %WORKROOT%\Assets\Resources\Common\Scripts\Data\EduGenJSON ^

 --gen_types code_cs_unity_json,data_json ^

 -s all

pause

4 脚本“gen_code_json.bat”生成数据：双击“gen_code_json.bat”脚本，“Datas”文件夹中的excel配置信息“ConfigExecle.xlsx” 就会生成到“Assets\Resources\Common\Scripts\Data\EduGenJSON”目录中“EduDataJson.json”文件和“Assets\Resources\Common\Scripts\Data\EduGen”目录中类数据文件。

5 代码测试：源码“DataManager.cs”中查看测试代码

6 unity中生成的信息

更详细的使用大家可以上它的官网进一步的学习，这里只是一条龙的例子学习，帮您快速入门。