# tuyoogame/huatuo

huatuo是一个特性完整、零成本、高性能、低内存的近乎完美的Unity全平台原生c#热更方案。 Huatuo is a fully featured, zero-cost, high-performance, low-memory solution for Unity's all-platform native c# hotfix

Repository: https://github.com/tuyoogame/huatuo
Canonical: https://ross.abutalabs.com/products/huatuo
Language: C++
License: MIT
License Family: permissive
Topics: unity, hotfix, hotupdate, il2cpp, csharp, ilruntime, lua, slua, tolua, xlua, puerts, unlua, update, hot-fix, hot-update, unreal, injectfix
Last push: 2023-02-16T03:17:00+00:00

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

## Adoption (not part of the score)
Stars 2344, forks 381 (observed 2026-08-28T04:06:39.639407+00:00)

## What it is
Huatuo is a native C# hot-update solution for Unity that extends the il2cpp AOT runtime into an 'AOT + Interpreter' hybrid runtime, enabling dynamic assembly loading on all platforms including iOS and consoles. It implements a high-performance register interpreter and differential hybrid DLL technology so hot-updated code runs at near-native AOT performance with zero learning cost.

## Use cases
- hot update c# code in unity games on ios without jit
- fix bugs in shipped unity game without app store review
- load c# assemblies dynamically in il2cpp builds
- run hot-updated game logic at near-native performance
- avoid lua-based scripting limitations in unity projects
- support reflection and inheritance across hot-update and AOT code

## When to choose
- you need full C# feature support (reflection, multithreading, async) in hot-update code
- you want near-zero learning cost and no adapters or code generation
- you target iOS or consoles where JIT is restricted
- performance and memory of hot-updated code matter

## When to avoid
- your project uses mono backend instead of il2cpp
- you need a simple scripting layer and can accept lua or other VM tradeoffs
- you require long-term vendor support - the project appears no longer actively maintained

## Facets
- artifact type: library
- maturity: maintenance
- function: interpreter, compiler
- domain: programming-languages, cross-platform
- platform: cpp, game-engine
- tags: unity, il2cpp, hot-update, csharp, aot-interpreter, hybrid-runtime, differential-hybrid-dll, game-hotfix, game-development, android, ios

## Member repositories
- tuyoogame/huatuo (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:39.639407+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-30T02:37:13.219303+00:00, confidence not recorded.
  - readme: https://github.com/tuyoogame/huatuo (fetched 2026-08-28T04:06:39.639407+00:00, sha c331963c133d)
- Data as of 2026-08-30T08:39:29.467469+00:00.
