Luban快速上手

luban是一个强大、易用、优雅、稳定的游戏配置解决方案。它设计目标为满足从小型到超大型游戏项目的简单到复杂的游戏配置工作流需求。

luban可以处理丰富的文件类型，支持主流的语言，可以生成多种导出格式，支持丰富的数据检验功能，具有良好的跨平台能力，并且生成极快。 luban有清晰优雅的生成管线设计，支持良好的模块化和插件化，方便开发者进行二次开发。开发者很容易就能将luban适配到自己的配置格式，定制出满足项目要求的强大的配置工具。

luban标准化了游戏配置开发工作流，可以极大提升策划和程序的工作效率。

核心特性​

• 丰富的源数据格式。支持excel族(csv,xls,xlsx,xlsm)、json、xml、yaml、lua等
• 丰富的导出格式。 支持生成binary、json、bson、xml、lua、yaml等格式数据
• 增强的excel格式。可以简洁地配置出像简单列表、子结构、结构列表，以及任意复杂的深层次的嵌套结构
• 完备的类型系统。不仅能表达常见的规范行列表，由于支持OOP类型继承，能灵活优雅表达行为树、技能、剧情、副本之类复杂GamePlay数据
• 支持多种的语言。支持生成c#、java、go、cpp、lua、python、typescript 等语言代码
• 支持主流的消息方案。 protobuf(schema + binary + json)、flatbuffers(schema + json)、msgpack(binary)
• 强大的数据校验能力。ref引用检查、path资源路径、range范围检查等等
• 完善的本地化支持
• 支持所有主流的游戏引擎和平台。支持Unity、Unreal、Cocos2x、Godot、微信小游戏等
• 良好的跨平台能力。能在Win,Linux,Mac平台良好运行。
• 支持所有主流的热更新方案。hybridclr、ilruntime、{x,t,s}lua、puerts等
• 清晰优雅的生成管线，很容易在luban基础上进行二次开发，定制出适合自己项目风格的配置工具。

官方文档 介绍 | Luban (code-philosophy.com)

安装dotnet sdk 8.0或更高版本sdk

下载luban_examples项目。该项目中包含测试配置以及大量的示例项目。为方便起见，后续提及到的文件，默认都指这个项目中的文件

下载Luban工具

 注意：Luban和luban_examples要在同级目录下

打开Luban_examples --> Tools --> build-luban.bat 执行文件

执行成功

执行完会生成Luban文件

创建一个新的Unity项目

在Package Manager中安装com.code-philosophy.luban包，地址https://gitee.com/focus-creative-games/luban_unity.git 或https://github.com/focus-creative-games/luban_unity.git (或者从https://github.com/focus-creative-games/luban_unity 下载)。

在新项目的 \Assets\ 同级目录下创建一个 \Config\ 文件夹

将luban_examples-->MiniTemplate 下的所有文件以及luban_examples-->Tools-->Luban复制到Config文件夹下

使用编辑工具打开gen.bat执行文件（可以用记事本\Visual Studio Code等编辑器打开）

将一下代码覆盖到打开的gen.bat文件里边

set WORKSPACE=.
set LUBAN_DLL=%WORKSPACE%\Luban\Luban.dll
set CONF_ROOT=.

dotnet %LUBAN_DLL% ^
    -t all ^
    -c cs-simple-json ^
    -d json ^
    --conf %CONF_ROOT%\luban.conf ^
    -x outputDataDir=..\Assets\Resources ^
    -x outputCodeDir=..\Assets\Scripts 
pause

最终效果

        

luban效果演示