# focus-creative-games/luban

luban是一个强大、易用、优雅、稳定的游戏配置解决方案。luban is a powerful, easy-to-use, elegant and stable game configuration solution.

Repository: https://github.com/focus-creative-games/luban
Canonical: https://ross.abutalabs.com/products/focus-creative-games-luban
Homepage: https://code-philosophy.com/
Language: C#
License: MIT
License Family: permissive
Topics: excel, csv, json, xml, cocos2d-x, yaml, protobuf, flatbuffers, game, unity, lua, config, xlsx2json, godot, msgpack, xls2json, xls2lua, xlsx2lua, hybridclr, datatable
Last push: 2026-08-15T03:02:14+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 97, longevity 100
- inputs: {"age_days": 2142, "days_push": 18, "days_rel": 23, "gap_med": 21, "n_releases_24m": 24}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4548, forks 731 (observed 2026-08-28T04:08:53.267446+00:00)

## What it is
Luban is a powerful, stable game configuration pipeline tool that reads data from Excel/CSV/JSON/XML/YAML/Lua sources and generates typed code and export data for many languages and engines. It supports rich type systems with OOP inheritance, data validation, localization, and mainstream message formats like protobuf, flatbuffers, and msgpack.

## Use cases
- convert excel game config tables to  or lua
- generate typed config code for unity from spreadsheets
- validate game data references and resource paths
- export game configuration to protobuf or flatbuffers
- manage localization strings for game projects
- support hot-update config loading with hybridclr or xlua
- build complex nested gameplay data like skill trees from excel

## When to choose
- building games on Unity, Unreal, Godot, or Cocos2d-x that need structured config pipelines
- designers work in Excel but programmers need typed, validated config code
- you need multi-language code generation from a single config source
- your project needs localization and data validation built into the config workflow

## When to avoid
- non-game projects needing only simple one-off format conversion
- teams wanting a GUI-only tool with no pipeline customization
- projects whose config needs are fully covered by a simple  loader

## Facets
- artifact type: cli-tool
- maturity: active
- function: serialization, data-generation, developer-tools, parser
- domain: developer-tools, files
- platform: windows, cross-platform, game-engine, cli
- tags: game-config, excel-to-, xlsx2, data-pipeline, localization, hot-update, protobuf, flatbuffers, msgpack, unity, unreal, godot, cocos2d-x, code-generation, game-development, automation, linux, macos

## Member repositories
- focus-creative-games/luban (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:53.267446+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:20:05.697912+00:00, confidence not recorded.
  - readme: https://github.com/focus-creative-games/luban (fetched 2026-08-28T04:08:53.267446+00:00, sha f53d4cc50959)
  - homepage: https://code-philosophy.com/ (fetched 2026-08-29T09:05:39.740204+00:00, sha 0e79fa1e2a7a)
- Data as of 2026-08-30T08:39:29.467469+00:00.