README.md

July 27, 2026 · View on GitHub

Legends-Of-Heroes

A production-ready open-source multiplayer game framework built with ET 8.x, Unity 2022.3, and .NET 10.

English | 简体中文

This project is a front-end and back-end game framework built on the ET framework. It ships a basic hot-update pipeline and a relatively complete combat system (an ECS-based skill + Buff system is already in place; the skill editor / behavior-tree editor are still under development). Legends-Of-Heroes uses state synchronization: all collision detection, skill, and AI logic runs on the server.

Legends-Of-Heroes demo video (click to play)

📺 Click the image above to watch the demo video. The raw MP4 lives at Document/loh.mp4 — GitHub renders it as an inline player when you open the file directly.

📐 Architecture Diagram

Legends-Of-Heroes is layered as a classic ET-style ECS + Actor architecture. The diagram below shows the relationship between the server process, the Unity client, the shared Model / Hotfix assemblies, and the third-party ecosystem that plugs into them.

                         ┌─────────────────────────────────────────────┐
                         │                   CLIENT                     │
                         │            Unity 2022.3.62f3                 │
                         │  ┌─────────────────────────────────────────┐ │
                         │  │  UI Layer: EUI (UGUI) / YIUI            │ │
                         │  │  Joystick · Camera Follow · Debugger    │ │
                         │  ├─────────────────────────────────────────┤ │
                         │  │  HybridCLR (hot-update)                 │ │
                         │  │  YooAsset 3.0 (assets / bundles)        │ │
                         │  ├─────────────────────────────────────────┤ │
                         │  │  ModelView  ·  HotfixView  (client ECS) │ │
                         │  └───────────────────┬─────────────────────┘ │
                         └──────────────────────┼──────────────────────┘
                                                │  TCP / KCP / WebSocket
                                                │  state-sync + position broadcast
                         ┌──────────────────────┼──────────────────────┐
                         │                      ▼                       │
                         │                 SERVER PROCESS                │
                         │                  .NET 10                      │
                         │  ┌─────────────────────────────────────────┐ │
                         │  │  Actor Location · Message Routing        │ │
                         │  │  (login · lobby · room · map)            │ │
                         │  ├─────────────────────────────────────────┤ │
                         │  │  Gameplay ECS                            │ │
                         │  │  Skill · Buff · Timeline · Collision     │ │
                         │  │  Behavior Tree · AOI · Move · Lockstep   │ │
                         │  ├─────────────────────────────────────────┤ │
                         │  │  Model  ·  Hotfix  (server ECS)          │ │
                         │  ├─────────────────────────────────────────┤ │
                         │  │  DB · Redis · Config (Luban)             │ │
                         │  └─────────────────────────────────────────┘ │
                         └─────────────────────────────────────────────┘
                              ▲                                   ▲
                              │                                   │
                ┌─────────────┴──────────┐          ┌─────────────┴────────────┐
                │   SHARED ASSEMBLIES    │          │    TOOLING / AI WORKFLOW │
                │  cn.etetet.* packages  │          │  AIBridge CLI · UnityMCP │
                │  (Model / Hotfix)      │          │  AI Agents (pluggable)   │
                └────────────────────────┘          └──────────────────────────┘

Layer Overview

LayerResponsibilityKey Packages
Server (.NET 10)Game logic, AI, collision, networking, persistencecore, actorlocation, netinner, statesync, skill, spell, behaviortree, collision, aoi, db
Client (Unity 2022.3)Rendering, input, UI, local predictioneui, yiui*, hybridclr, yooassets, move
Shared Model / HotfixECS components, systems, hot-updatable logicAll cn.etetet.* packages
ToolingBuild, codegen, AI-assisted developmentharness, unitybridge, AIBridge CLI, UnityMCP

The full module list lives under Packages/ (70+ cn.etetet.* packages). Each package follows ET's Model / ModelView / Hotfix / HotfixView assembly split for hot reload.

✨ Features

🌐 Networking

  • State synchronization — all authoritative gameplay logic runs server-side; clients render broadcasted state.
  • Actor model messaging — actorlocation + netinner provide location-transparent RPC and message routing across processes.
  • Multi-protocol transport — TCP / KCP / WebSocket supported by the ET networking layer.
  • Reconnect & session — basic disconnect-reconnect and return-to-login flow.
  • Distributed ready — servicediscovery + router for multi-process topologies (managed via .NET Aspire).

🤖 AI Agents

  • Pluggable AI workflow hooks for AI-assisted development (see Packages/cn.etetet.harness/).
  • Designed to integrate with external AI agents / MCP-compatible tooling for codegen, debugging, and content authoring.

🌳 Behavior Tree

  • In-engine behavior tree editor for authoring NPC / enemy AI.
  • Node library exposed via the btree / btnode / btreedemo packages.

et-bt

⚔️ Skill System

  • ECS-based skill framework supporting active & passive abilities.
  • Server-authoritative casting, targeting, and cooldowns.
  • A demo active skill is wired into the Ball Battle demo.

💥 Buff System

  • Composable buff/effect pipeline integrated with the skill and timeline systems.
  • Stack rules, duration management, and modifier application all server-side.

📊 Luban

  • Configuration powered by Luban — multi-platform, type-safe, code-generated configs.
  • Workflow integrated into the harness build pipeline (et-luban / et-excel).

📦 YooAsset

  • Asset bundling, loading, and hot-update via YooAsset 3.0.
  • Combined with HybridCLR for full code + asset hot-update.

🔌 UnityMCP

  • MCP-compatible bridge for editor automation (compile, refresh, log retrieval, prefab/scene ops).
  • See AGENTS.md for the AIBridge / UnityMCP / UnityBridge channel priority.

🎮 More

  • HybridCLR — C# hot-update with check & download flow.
  • Box2DSharp — 2D physics / bullet collision.
  • EUI / YIUI — UGUI frameworks adapted for ET.
  • AOI — interest management for large worlds.
  • Lockstep / TrueSync — deterministic sync primitives.
  • One-click build — menu ET/Build/..., tested on Win/Android.

🗺️ Roadmap

StatusItem
🚧Timeline skill editor integrated with the combat system
✅Behavior tree editor + combat (behavior tree shipped)
🚧Game lobby & matchmaking — up to 20 players per room
✅Skill framework (active/passive) + Buff system
✅Timeline skill event system
✅Bullet collision system (Box2DSharp)
✅HybridCLR + YooAsset hot-update pipeline
✅One-click build (Win/Android)
🚧2D MOBA mode (stretch goal)
🔜More per-module video walkthroughs

Legend: ✅ shipped · 🚧 in progress / planned · 🔜 future

📋 Requirements

  • Unity: 2022.3.62f3
  • IDE: Visual Studio 2022 or Rider 2023
  • .NET SDK: 10.0
  • OS: Windows (primary); some tooling may not run on macOS/Linux.

🚀 Quick Start

  1. Clone 
    git clone https://github.com/FlameskyDexive/Legends-Of-Heroes.git
cd Legends-Of-Heroes
  2. Open the project in Unity 2022.3.62f3 and let it import.
  3. Follow the run guide under the Book/ directory (1.1Running Guide.md).

GitHub slow or blocked in your region? Mirror available on Gitee: Legends-Of-Heroes.

🤝 Contributing

Contributions are welcome — bug reports, feature ideas, docs, and PRs are all appreciated. Please read CONTRIBUTING.md before opening a pull request.

Quick links: open issues · CONTRIBUTING.md · Code of Conduct

If you find the project useful, a ⭐ in the top-right corner goes a long way!

📺 Video Walkthrough

A single demo video has been recorded so far — Hands-on / Build & Matchmaking. More videos covering the design rationale and usage of each module will follow.

🙏 Special Thanks

Thanks to JetBrains for providing licenses!

JetBrains Logo

🔗 Friends & Credits

Fantasy — A high-performance .NET networking framework supporting mainstream protocols, with separated front-end and back-end.

UniJoystick — A universal UGUI-based joystick component.

X-ET7 — A fork of ET7 integrating FGUI + YooAsset + Luban.

NKGMobaBasedOnET — Yanyu's open-source MOBA case, heavily modified from ET5.X.

XAsset — A highly efficient, easy-to-use, and powerful asset management system (build / load / hot-update).

ETPro — An enhanced ET based on ET6.0, shipping its own skill system, UI framework, and seamless large-world mirroring.

📄 License

This project is licensed under the MIT License.

⭐ Star History

Star History Chart