Cross-platform 2D Game Engine
English | 中文
Documentation · API Reference · Download Editor · Examples
Just need ECS? The core ECS framework
@esengine/ecs-frameworkcan be used standalone with Cocos Creator, Laya, or any JS engine. View ECS Documentation
ESEngine is a cross-platform 2D game engine built from the ground up with modern web technologies. It provides a comprehensive toolset that enables developers to focus on creating games rather than building infrastructure.
Export your games to multiple platforms including web browsers, WeChat Mini Games, and other mini-game platforms from a single codebase.
| Feature | Description |
|---|---|
| ECS Architecture | Data-driven Entity-Component-System pattern for flexible and cache-friendly game logic |
| High-Performance Rendering | Rust/WebAssembly 2D renderer with automatic sprite batching and WebGL 2.0 backend |
| Visual Editor | Cross-platform desktop editor built with Tauri for scene management and asset workflows |
| Modular Design | Import only what you need - each feature is a standalone package |
| Multi-Platform Export | Deploy to Web, WeChat Mini Games, and more from one codebase |
| Physics Integration | 2D physics powered by Rapier with editor visualization |
| Visual Scripting | Behavior trees and blueprint system for designers |
- Runtime: TypeScript, Rust, WebAssembly
- Renderer: WebGL 2.0, WGPU (planned)
- Editor: Tauri, React, Zustand
- Physics: Rapier2D
- Build: pnpm, Turborepo, Rollup
ESEngine is free and open source under the MIT License. No royalties, no strings attached.
npm install @esengine/ecs-frameworkDownload pre-built binaries from the Releases page (Windows, macOS).
import { Core, Scene, Entity, Component, EntitySystem, Matcher, Time, ECSComponent, ECSSystem } from '@esengine/ecs-framework'; @ECSComponent('Position') class Position extends Component { x = 0; y = 0; } @ECSComponent('Velocity') class Velocity extends Component { dx = 0; dy = 0; } @ECSSystem('Movement') class MovementSystem extends EntitySystem { constructor() { super(Matcher.all(Position, Velocity)); } protected process(entities: readonly Entity[]): void { for (const entity of entities) { const pos = entity.getComponent(Position); const vel = entity.getComponent(Velocity); pos.x += vel.dx * Time.deltaTime; pos.y += vel.dy * Time.deltaTime; } } } // Initialize Core.create(); const scene = new Scene(); scene.addSystem(new MovementSystem()); const player = scene.createEntity('Player'); player.addComponent(new Position()); player.addComponent(new Velocity()); Core.setScene(scene); // Game loop function gameLoop(currentTime: number) { Core.update(currentTime / 1000); requestAnimationFrame(gameLoop); } requestAnimationFrame(gameLoop);ESEngine is organized as a monorepo with modular packages.
| Package | Description |
|---|---|
@esengine/ecs-framework | Core ECS framework with entity management, component system, and queries |
@esengine/math | Vector, matrix, and mathematical utilities |
@esengine/engine | Rust/WASM 2D renderer |
@esengine/engine-core | Engine module system and lifecycle management |
| Package | Description |
|---|---|
@esengine/sprite | 2D sprite rendering and animation |
@esengine/tilemap | Tile-based map rendering |
@esengine/physics-rapier2d | 2D physics simulation (Rapier) |
@esengine/behavior-tree | Behavior tree AI system |
@esengine/blueprint | Visual scripting runtime |
@esengine/camera | Camera control and management |
@esengine/audio | Audio playback |
@esengine/ui | UI components |
@esengine/material-system | Material and shader system |
@esengine/asset-system | Asset loading and management |
| Package | Description |
|---|---|
@esengine/sprite-editor | Sprite inspector and tools |
@esengine/tilemap-editor | Visual tilemap editor |
@esengine/physics-rapier2d-editor | Physics collider visualization |
@esengine/behavior-tree-editor | Visual behavior tree editor |
@esengine/blueprint-editor | Visual scripting editor |
@esengine/material-editor | Material editor |
| Package | Description |
|---|---|
@esengine/platform-common | Platform abstraction interfaces |
@esengine/platform-web | Web browser runtime |
@esengine/platform-wechat | WeChat Mini Game runtime |
The ESEngine Editor is a cross-platform desktop application built with Tauri and React.
- Scene hierarchy and entity management
- Component inspector with custom property editors
- Asset browser with drag-and-drop
- Tilemap editor with paint and fill tools
- Behavior tree visual editor
- Blueprint visual scripting
- Material and shader editing
- Built-in performance profiler
- Localization (English, Chinese)
| Platform | Runtime | Editor |
|---|---|---|
| Web Browser | ✓ | - |
| Windows | - | ✓ |
| macOS | - | ✓ |
| WeChat Mini Game | In Progress | - |
| Playable Ads | Planned | - |
| Android | Planned | - |
| iOS | Planned | - |
- Node.js 18+
- pnpm 10+
- Rust toolchain (for WASM renderer)
- wasm-pack
git clone https://github.com/esengine/esengine.git cd esengine pnpm install pnpm build # Optional: Build WASM renderer pnpm build:wasmcd packages/editor-app pnpm tauri:devesengine/ ├── packages/ │ ├── core/ # ECS Framework (@esengine/ecs-framework) │ ├── math/ # Math library (@esengine/math) │ ├── engine-core/ # Engine lifecycle management │ ├── sprite/ # 2D sprite rendering │ ├── tilemap/ # Tilemap system │ ├── physics-rapier2d/ # Physics engine │ ├── behavior-tree/ # AI behavior trees │ ├── editor-app/ # Desktop editor (Tauri) │ └── ... # Other modules ├── docs/ # Documentation source ├── examples/ # Example projects ├── scripts/ # Build utilities └── thirdparty/ # Third-party dependencies Looking for ECS source code? The ECS framework is in
packages/core/
- GitHub Issues - Bug reports and feature requests
- GitHub Discussions - Questions and ideas
Contributions are welcome. Please read the contributing guidelines before submitting a pull request.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
ESEngine is licensed under the MIT License.
Made with ❤️ by the ESEngine team