$ show focus-creative-games/luban
Luban is a game configuration solution that transforms structured data (Excel, JSON, YAML, Lua, XML, etc.) into strongly-typed code and serialized data for multiple target languages (C#, Java, Go, C++, Rust, Python, TypeScript, Lua, etc.) and data formats (binary, JSON, protobuf, flatbuffers, msgpack, BSON, etc.). It is implemented as a .NET 8 console application with a plugin-based pipeline architecture: schema loading → data loading → validation → code generation → data export. The core engine (Luban.Core) provides extensible interfaces for custom loaders, validators, code targets, and data targets, all discovered via assembly attributes. Code generation uses Scriban templates with language-specific extensions, and data serialization employs a custom compact binary protocol (ByteBuf). The tool is widely used in game development for managing configuration data across engines like Unity, Unreal, Godot, and Cocos.
The LLM identified 4 files worth highlighting for reuse:
A compact binary serialization buffer with variable-length integer encoding, support for common types (int, long, float, string, byte arrays, geometry types like Vector2/3/4, Quaternion, Matrix4x4), and a thread-local pool for efficient reuse. It is self-contained and could be extracted as a standalone utility for any project needing efficient binary serialization.
A set of isolated formatters implementing INamingConventionFormatter for PascalCase, camelCase, snake_case, UPPER_CASE, and none. Each is a single-purpose class with no internal dependencies, making them directly reusable in any code generation or transformation tool that needs consistent naming.
A generic plugin manager that discovers and instantiates behaviours (loaders, validators, code targets, etc.) via assembly-level attributes and priority ordering. It provides a clean, reflection-based registration pattern that can be reused in any application requiring extensible plugin architecture without a DI container.
A base class for implementing the visitor pattern on a type hierarchy (TType). It provides default delegation for nullable and collection wrappers, allowing concrete visitors to focus only on specific types. This pattern is reusable for any type system that needs extensible operations (serialization, validation, transformation).