Luban is a game configuration solution that converts data from multiple source formats into code and serialized data for game engines and platforms.
Luban addresses the problem of managing complex game configuration workflows across different data sources and target languages. It accepts configuration data from Excel files, CSV, JSON, XML, YAML, and Lua, then generates code and serialized output in formats including binary, JSON, BSON, XML, Lua, and YAML. The tool supports object-oriented type inheritance, allowing developers to express complex gameplay data structures like behavior trees, skills, and dungeon configurations. It includes validation features such as reference checking, resource path validation, and range constraints. The generated code avoids reflection, making it compatible with code obfuscation and protection tools.
Luban suits projects using Unity, Unreal, Cocos2d-x, Godot, or other mainstream game engines, and supports hot-update solutions including HybridCLR, ILRuntime, and Lua variants. It generates code for C#, Java, Go, C++, Lua, Python, JavaScript, TypeScript, Rust, PHP, Erlang, and Godot. The tool runs on Windows, Linux, and macOS. Developers evaluating adoption should note that Luban provides AI-native capabilities including official Agent skills, machine-readable schema output, a command-line Agent interface, and an MCP server for IDE integration, enabling automated table management and validation through AI agents.
The project maintains active development with regular updates and includes built-in xUnit integration tests. Documentation covers installation, usage guides, and AI support features. Example projects are available to demonstrate implementation patterns across different game engine contexts.
