Luban 是一款专为游戏项目设计的配置管理与代码生成工具。它面向从小型独立游戏到超大型商业项目的全流程配置需求，帮助策划与程序建立标准化、可扩展、可校验的配置工作流，显著提升协作效率与数据质量。

无论是简单的数值表、道具表，还是行为树、技能、剧情、副本等复杂 GamePlay 数据，Luban 都能以清晰的类型系统和增强的 Excel 格式优雅表达，并一键导出为运行时可用的代码与数据。

核心特点

1. 丰富的源数据格式

• 支持 Excel 族：csv、xls、xlsx、xlsm
• 支持 json、xml、yaml、lua 等常见格式
• 策划可继续用熟悉的表格工作，程序也能用结构化文本管理复杂配置

2. 增强的 Excel 配置能力

• 简洁配置简单列表、子结构、结构列表
• 支持任意复杂的深层次嵌套结构
• 让「一张表表达复杂玩法数据」成为可能，减少碎片表与手工拼接

3. 完备的类型系统（含 OOP 继承）

• 不仅能表达常规行列式配置表
• 支持 OOP 类型继承，可优雅表达行为树、技能、剧情、副本等复杂 GamePlay 数据
• 类型清晰、结构可复用，降低后期维护成本

4. 多语言代码生成 内置支持生成：

• C#、Java、Go、C++、Lua、Python
• JavaScript、TypeScript、Rust、PHP、Erlang、Godot 等

同时可通过 Protobuf 等消息方案扩展到更多语言与生态。

5. 丰富的导出格式

• 数据：binary、json、bson、xml、lua、yaml 等
• 消息方案：Protobuf（schema + binary + json）、FlatBuffers（schema + json）、MsgPack（binary）
• 可按项目需要在可读性、体积、性能之间灵活选型

6. 强大的数据校验

• ref 引用检查
• path 资源路径检查
• range 范围检查等

在导出阶段尽早发现错误，减少「进游戏才发现配错表」的成本。

7. 完善的本地化支持 面向多语言发行项目，提供完善的本地化能力，便于统一管理多语言配置与文本。

8. 引擎与热更生态友好

• 支持 Unity、Unreal、Cocos2x、Godot、微信小游戏等主流引擎/平台
• 兼容 HybridCLR、ILRuntime、xLua/tLua/sLua、Puerts 等主流热更新方案
• 生成代码不调用反射接口，兼容 Obfuz、Obfuscator、Confuser、.NET Refactor 等混淆/加固工具

9. 跨平台与高性能生成

• 可在 Windows、Linux、macOS 稳定运行
• 生成速度快，适合 CI/CD 与日常高频导表

10. 可扩展、可二次开发

• 清晰优雅的生成管线
• 良好的模块化与插件化设计
• 便于适配自定义配置格式，定制符合团队风格的配置工具链

风格与设计理念

Luban 的风格是 强大而不臃肿、规范而不僵化：

• 强大：覆盖从简单数值表到复杂 OOP 玩法数据的完整配置场景
• 易用：以 Excel 为中心，降低策划上手门槛；程序侧获得强类型、可校验、可生成的工程化结果
• 优雅：用类型系统与继承表达复杂结构，而不是靠大量特殊约定和手工脚本硬拼
• 稳定：面向商业项目长期使用，强调校验、跨平台与热更/混淆兼容
• 可扩展：管线清晰、插件友好，适合团队二次开发与定制

整体定位不是「又一个 Excel 转 JSON 小工具」，而是一套可落地的 游戏配置开发工作流标准。

适合的项目类型

非常适合：

• Unity 手游 / 端游 / 页游 / 小游戏（含微信小游戏）中需要大量配置表的项目
• 中大型商业项目：道具、关卡、活动、任务、商店、养成等多表协作
• 有复杂 GamePlay 数据的项目：技能、Buff、行为树、剧情、副本、关卡编辑数据
• 需要多端共用配置的项目（客户端 / 服务器 / 工具链统一导表）
• 使用 HybridCLR、xLua、Puerts 等热更新方案，希望配置与代码生成无缝衔接的项目
• 需要多语言本地化发行的项目
• 希望把策划配表、程序读表、校验、导出纳入 CI 的工程化团队

也适合：

• 中小型独立游戏：快速建立规范的配表流程，避免后期表结构失控
• 原型验证阶段：先用简单表起步，后续平滑扩展到复杂嵌套与继承结构
• 工具型项目 / 编辑器配套项目：需要稳定导出可读或二进制配置数据