# smilehao/xlua-framework

Unity游戏纯lua客户端完整框架---基于xlua，整合tolua的proto-gen-lua以及各个lua库和工具类

Repository: https://github.com/smilehao/xlua-framework
Canonical: https://ross.abutalabs.com/products/xlua-framework
Language: C++
License Family: other
Last push: 2026-03-15T02:49:11+00:00

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 72, release rhythm 35, longevity 100
- inputs: {"age_days": 3170, "days_push": 171, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1251, forks 409 (observed 2026-08-28T04:04:08.119816+00:00)

## What it is
A complete pure-Lua client framework for Unity games built on xLua, integrating proto-gen-lua and various Lua libraries and utility classes. It provides modules for UI management, coroutines, timers, AssetBundle resource management and hot updates, scene management, networking with Protobuf, and config table generation.

## Use cases
- build a Unity game client scripted entirely in Lua
- implement hot updates for a Unity game without republishing
- manage AssetBundle loading, packing, and caching in Unity
- handle Protobuf-based networking in a Unity Lua client
- generate Lua config tables from xlsx and proto files
- organize UI windows, layers, and window stacks in Unity

## When to choose
- you are building a Unity game that needs Lua-based hot-updateable client logic
- you want a full-featured Lua framework covering UI, resources, networking, and config tables out of the box
- you need xLua hotfix workflows and AssetBundle tooling integrated together

## When to avoid
- your project does not use Unity or xLua
- you prefer writing game client logic in C# without a scripting layer
- you need a production-supported framework with a license and formal maintenance guarantees

## Facets
- artifact type: framework
- maturity: active
- function: game-engine, plugin-system, serialization, middleware
- domain: gaming-tools, developer-tools
- platform: cross-platform, lua, cpp
- tags: unity, xlua, tolua, lua-framework, hot-update, assetbundle, protobuf, game-client, hotfix, game-development

## Member repositories
- smilehao/xlua-framework (main) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:08.119816+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-30T05:07:41.638465+00:00, confidence not recorded.
  - readme: https://github.com/smilehao/xlua-framework (fetched 2026-08-28T04:04:08.119816+00:00, sha 2e36030511b7)
- Data as of 2026-08-30T08:39:29.467469+00:00.