https://github.com/jasonxudeveloper/jengine

The solution that allows unity games to update in runtime. 使Unity开发的游戏支持热更新的解决方案。
https://github.com/jasonxudeveloper/jengine

csharp framework game gameframework hot-update hotfix hotupdate ilruntime unity unity-3d unity-framework unity2d unity3d unity3d-framework unity3d-hotfix unity3d-plugin

Last synced: 23 days ago
JSON representation

The solution that allows unity games to update in runtime. 使Unity开发的游戏支持热更新的解决方案。

• Host: GitHub
• URL: https://github.com/jasonxudeveloper/jengine
• Owner: JasonXuDeveloper
• License: mit
• Created: 2020-07-14T01:09:16.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-10-31T12:07:27.000Z (over 1 year ago)
• Last Synced: 2025-04-03T14:42:08.787Z (11 months ago)
• Topics: csharp, framework, game, gameframework, hot-update, hotfix, hotupdate, ilruntime, unity, unity-3d, unity-framework, unity2d, unity3d, unity3d-framework, unity3d-hotfix, unity3d-plugin
• Language: C#
• Homepage: https://docs.xgamedev.net/
• Size: 97.8 MB
• Stars: 2,053
• Watchers: 40
• Forks: 334
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGE.md
  • License: LICENSE

Awesome Lists containing this project

README

          


![JEngine](https://socialify.git.ci/JasonXuDeveloper/JEngine/image?font=JetBrains+Mono&forks=1&issues=1&logo=https%3A%2F%2Fjengine.xgamedev.net%2Flogo.png&name=1&owner=1&pulls=1&stargazers=1&theme=Auto)

[![Version](https://img.shields.io/github/v/release/JasonXuDeveloper/JEngine)](https://github.com/JasonXuDeveloper/JEngine/releases) [![Tests](https://github.com/JasonXuDeveloper/JEngine/actions/workflows/pr-tests.yml/badge.svg)](https://github.com/JasonXuDeveloper/JEngine/actions/workflows/pr-tests.yml) [![License](https://img.shields.io/github/license/JasonXuDeveloper/JEngine)](https://github.com/JasonXuDeveloper/JEngine/blob/master/LICENSE) [![Last Commit](https://img.shields.io/github/last-commit/JasonXuDeveloper/JEngine)](https://github.com/JasonXuDeveloper/JEngine/commits) [![Top Language](https://img.shields.io/github/languages/top/JasonXuDeveloper/JEngine)](https://github.com/JasonXuDeveloper/JEngine) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FJasonXuDeveloper%2FJEngine.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FJasonXuDeveloper%2FJEngine) [![CodeFactor](https://www.codefactor.io/repository/github/jasonxudeveloper/jengine/badge)](https://www.codefactor.io/repository/github/jasonxudeveloper/jengine) [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/JasonXuDeveloper/JEngine/badge)](https://securityscorecards.dev/viewer/?uri=github.com/JasonXuDeveloper/JEngine) [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11830/badge)](https://www.bestpractices.dev/projects/11830) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/JasonXuDeveloper/JEngine)

**An out-of-the-box Unity framework for hot updatable games**

[Documentation](https://jengine.xgamedev.net/) | [中文文档](https://github.com/JasonXuDeveloper/JEngine/blob/master/README_zh_cn.md)



## Why JEngine?

- **Lightweight** - Only core package (few files) required; add optional packages as needed

- **One-Click Build** - JEngine Panel builds code + assets with obfuscation in one click

- **10x+ Performance** - HybridCLR outperforms ILRuntime/Lua hot update solutions

- **Zero/Minimal GC** - UniTask (GC-free async) + Nino (high-performance serialization)

- **All Platforms** - iOS, Android, Windows, macOS, WebGL, WeChat, Douyin, Alipay, TapTap

- **Secure Updates** - Obfuscate hot update DLL + encrypt resources (assets & DLL/PDB) with XOR/AES/ChaCha20

- **AI-Accelerated** - Intelligent AI [seamlessly integrated](.claude-plugin/), deeply understands JEngine to boost productivity

- **Commercial Ready** - Production-proven by individuals and enterprise teams

## Overview

JEngine is a Unity framework that enables **runtime hot updates** for games. Designed for both beginners and professionals, it provides secure, high-performance features out of the box.

## Quick Start

### Requirements

- **Unity 2022.3+**

### Branch Information

| Branch | Status | Description |

|--------|---------|-------------|

| `master` | **Recommended** | Latest stable version with the most powerful features |

| `0.8.x` | Legacy | Most popular 2023 version (no longer maintained) |

| `0.7.x` | Legacy | Most popular 2022 version (no longer maintained) |

| `0.6.x` | Legacy | Complete with full documentation (no longer maintained) |

| `0.5.x` | Legacy | Used by some commercial projects (no longer maintained) |

## Packages

### Official Packages

| Package | Type | Coverage | Description |

|---------|------|----------|-------------|

| **JEngine.Core** | Required | N/A | Hot update support with secure, high-performance features |

| **JEngine.Util** | Optional | [![Util Coverage](https://codecov.io/gh/JasonXuDeveloper/JEngine/branch/master/graph/badge.svg?flag=util)](https://codecov.io/gh/JasonXuDeveloper/JEngine) | Utility classes including JAction and JObjectPool |

| **JEngine.UI** | Optional | [![UI Coverage](https://codecov.io/gh/JasonXuDeveloper/JEngine/branch/master/graph/badge.svg?flag=ui)](https://codecov.io/gh/JasonXuDeveloper/JEngine) | UI utilities for both runtime and editor |

**JEngine.Util Features:**

- **JAction** - Zero-GC chainable async task framework with fluent API, object pooling, delays, conditions, and loops

- **JObjectPool** - Thread-safe, lock-free generic object pooling using CAS operations

**JEngine.UI Features:**

- **MessageBox** - Zero-allocation async prompt system with UniTask integration and object pooling for runtime UI

- **Editor UI** - Shadcn-inspired modern UI Toolkit framework with theming support and Bootstrap/Panel UI integration

### Third-Party Packages

| Package | Description | Link |

|---------|-------------|------|

| **MetaJUI** | Customized UI framework for JEngine | [Repository](https://github.com/Meta404Dev/MetaJUI) |

| **MetaExcelDataTool** | Excel table guide tool | [Repository](https://github.com/Meta404Dev/MetaExcelDataTool) |

## Dependencies

| Dependency | Description | Repository |

|------------|-------------|------------|

| **Obfuz** | Code obfuscation | [GitHub](https://github.com/focus-creative-games/obfuz) |

| **HybridCLR** | Runtime code execution | [GitHub](https://github.com/focus-creative-games/hybridclr) |

| **YooAssets** | Runtime resource updates | [GitHub](https://github.com/tuyoogame/YooAsset) |

## 🎉 Latest Features (v1.1.5)

- **ui**: add JContainer component with max-width constraints ([#613](https://github.com/JasonXuDeveloper/JEngine/pull/613))

[📋 View Complete Changelog](CHANGE.md)

## Project Statistics

[![Stargazers over time](https://starchart.cc/JasonXuDeveloper/JEngine.svg)](https://starchart.cc/JasonXuDeveloper/JEngine)

## Showcase

> If your project uses JEngine, feel free to contact the author - we'd be happy to showcase your work here!

|  |  |  |  |

| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |

| 
[Alice's Dream Space](https://www.taptap.com/app/224117)
 | 
[Grinding Panic](https://www.taptap.com/app/225175)
 | 
[Harvest Leeks](https://www.taptap.com/app/232558)
 | 
[MingMing Match](https://www.taptap.com/app/233988)
 |

|  |  |  |  |

| 
[Rabbit Restaurant](https://www.taptap.com/app/235127)
 | 
[Cangyuan World](https://www.9game.cn/hongmengshijie/)
 | 
[Kz Spirit](https://www.taptap.com/app/238569)
 | 
[Boundless Cinema](https://apps.apple.com/us/app/id1506237271)
 |


## Contributors



## Recommendations

Check out these other excellent Unity frameworks:

- [IFramework](https://github.com/OnClick9927/IFramework) - Simple Unity Tools

- [QFramework](https://github.com/liangxiegame/QFramework) - Your first K.I.S.S Unity 3D Framework

- [TEngine](https://github.com/ALEXTANGXIAO/TEngine) - Unity framework solution

- [BundleMaster](https://github.com/mister91jiao/BundleMaster) - Unity resource loading master

- [Nino](https://github.com/JasonXuDeveloper/Nino) - Ultimate high-performance binary serialization library for C#.

---



**If JEngine helps you, please give it a Star!**