{"id":13534263,"url":"https://github.com/egret-labs/egret-core","last_synced_at":"2025-05-14T01:06:37.779Z","repository":{"id":38709618,"uuid":"16772886","full_name":"egret-labs/egret-core","owner":"egret-labs","description":"Egret is a brand new open mobile game and application engine which allows you to quickly build mobile games and apps on Android,iOS and Windows.","archived":false,"fork":false,"pushed_at":"2022-07-20T07:18:32.000Z","size":105144,"stargazers_count":3961,"open_issues_count":53,"forks_count":800,"subscribers_count":280,"default_branch":"master","last_synced_at":"2025-04-11T22:18:57.224Z","etag":null,"topics":["egret","game-engine","html5-canvas","html5-game","javascript","typescript","webgl"],"latest_commit_sha":null,"homepage":"http://www.egret.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/egret-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-02-12T16:08:03.000Z","updated_at":"2025-04-09T14:24:56.000Z","dependencies_parsed_at":"2022-07-10T22:16:09.069Z","dependency_job_id":null,"html_url":"https://github.com/egret-labs/egret-core","commit_stats":null,"previous_names":[],"tags_count":152,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egret-labs%2Fegret-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egret-labs%2Fegret-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egret-labs%2Fegret-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egret-labs%2Fegret-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/egret-labs","download_url":"https://codeload.github.com/egret-labs/egret-core/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253678811,"owners_count":21946314,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["egret","game-engine","html5-canvas","html5-game","javascript","typescript","webgl"],"created_at":"2024-08-01T07:01:29.111Z","updated_at":"2025-05-14T01:06:32.766Z","avatar_url":"https://github.com/egret-labs.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Libraries"],"sub_categories":["JavaScript"],"readme":"\u003cp align=\"center\"\u003e\r\n    \u003cimg src=\"./docs/img/egret_logo.jpg\"\r\n         height=\"130\"\u003e\r\n\u003c/p\u003e\r\n\u003cp align=\"center\"\u003e\r\n    \u003ca href=\"https://github.com/egret-labs/egret-core/network\"\u003e\r\n        \u003cimg src=\"https://img.shields.io/github/forks/egret-labs/egret-core.svg\"\r\n             alt=\"forks\"\u003e\r\n    \u003c/a\u003e\r\n    \u003ca href=\"https://github.com/egret-labs/egret-core/stargazers\"\u003e\r\n        \u003cimg src=\"https://img.shields.io/github/stars/egret-labs/egret-core.svg\"\r\n             alt=\"stars\"\u003e\r\n    \u003c/a\u003e\r\n    \u003ca href=\"https://github.com/egret-labs/egret-core\"\u003e\r\n        \u003cimg src=\"https://img.shields.io/badge/version-5.4.1-green.svg\"\r\n             alt=\"version\"\u003e\r\n    \u003c/a\u003e\r\n    \u003ca href=\"./LICENSE.md\"\u003e\r\n        \u003cimg src=\"https://img.shields.io/badge/license-New%20BSD-blue.svg\"\r\n             alt=\"license\"\u003e\r\n    \u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n[EN](README.md) / [CN](README_CN.md)\r\n\r\n# Egret Engine\r\n\r\nThe Egret Engine is a HTML5 game engine. It provides modules to handle common game development tasks such as 2D and 3D rendering, GUI systems, and audio and resource management. The Egret engine is flexible and suitable for 2D or 3D projects. It allows developers to work without worrying about low-level browser impelementation, HTML5 performance, or fragmentation issues.\r\n\r\n## Platform Coverage \r\n\r\n### Mobile\r\n\r\n![](https://img.shields.io/badge/iOS-8.0%2B-lightgrey.svg)\r\n![](https://img.shields.io/badge/Android-4.0%2B-brightgreen.svg)\r\n![](https://img.shields.io/badge/Windows%20Phone-8-orange.svg)\r\n\r\n### PC\r\n\r\n![](https://img.shields.io/badge/Chrome--brightgreen.svg)\r\n![](https://img.shields.io/badge/Safari--yellow.svg)\r\n![](https://img.shields.io/badge/FireFox--orange.svg)\r\n![](https://img.shields.io/badge/Edge--red.svg)\r\n![](https://img.shields.io/badge/IE-9+-blue.svg)\r\n\r\n# Installation\r\n\r\nTo Install the Egret Engine:\r\n\r\n* [Download](https://egret.com/products) the Egret Engine Manager.\r\n\r\n* Then, follow the [installation and deployment instructions](http://developer.egret.com/cn/github/egret-docs/Engine2D/projectConfig/installation/index.html) \r\n\r\nOnce installation is complete, Egret's engine and tools are easy to manage.\r\n\r\n# Getting Started\r\n\r\n#### TypeScript\r\n\r\nEgret projects are developed using TypeScript, which is a superset of JavaScript. Please refer to the TypeScript manual for more information. The Egret API and ActionScript3 (AS3) are very similar. It will be easy to get started with Egret if you are familiar with AS3.\r\n\r\n#### Create a project by command line\r\n\r\nUse following command to create a default game object:\r\n\r\n    egret create HelloWorld\r\n\r\nYou may also add parameters if required: Use `empty` | `game` | `gui` | `eui` to specify different projects. \r\n\r\nAfter running this command, you should now see a folder called 'HelloWorld'.\r\n\r\n#### Write your first line of code\r\n\r\nBy default, the entry point for an Egret game projects is src / Main.ts. To make write the first line of code for your project, find the createGameScene () function, and add console.log (\"Hello World\");\r\n\r\nAfter making your changes, the code should now look like this:\r\n\r\n    private createGameScene():void {\r\n            // log\r\n            console.log(\"Hello World\");\r\n            var sky:egret.Bitmap = this.createBitmapByName(\"bgImage\");\r\n            this.addChild(sky);\r\n            var stageW:number = this.stage.stageWidth;\r\n            var stageH:number = this.stage.stageHeight;\r\n            sky.width = stageW;\r\n            sky.height = stageH;\r\n            //...\r\n        }\r\n\r\nHere, we've called `console.log(\"log content that we'd like to display\")`. This will display our log message in the browser's developer tool.\r\n\r\n    We recommend using Chrome to debug the Egret project.\r\n\r\nUse the following command to build Egret projects:\r\n\r\n    egret build\r\n\r\nUse the following command to run Egret projects:\r\n\r\n    egret startserver\r\n\r\n![](./docs/img/console.png)\r\n\r\nFor more information, please refer to the Learning Module documentation.\r\n\r\n# Demos\r\n\r\nTower Defence Demo\r\n![](./docs/img/3d_demo_1.png)\r\nClick [here](http://developer.egret.com/cn/article/index/id/1074) for online experience.\u003cbr/\u003e\r\n\r\nClick [here](http://developer.egret.com/cn/list/example/id/190) for more 2D/3D demos.\u003cbr/\u003e\r\n\r\n# Show Case\r\n\r\nClick here to see [Show Case](https://egret.com/case)\u003cbr/\u003e\r\n\r\n# Learn\r\n\r\n* Access [Doc](http://developer.egret.com/cn/github/egret-docs/Engine2D/index.html?home=1) to get Engine document\r\n* Access [Example](http://developer.egret.com/cn/example/egret2d/index.html#010-disp-basic) to learn demo source code\r\n* Access [API](http://developer.egret.com/cn/apidoc/) to get API document\r\n* Access [Video](http://developer.egret.com/cn/list/video/) to get videos\r\n* Access [Community](http://bbs.egret.com/portal.php) to communicate with other developers\r\n\r\n# Tools\r\n\r\n* Access [Egret Engine](http://www.egret.com/products/engine.html) to get Egret Engine launcher\r\n* Access [Egret Wing](http://www.egret.com/products/wing.html) to get Egret IDE\r\n* Access [Dragonbones Pro](http://dragonbones.com/cn/index.html) to get DragonBones\r\n* Access [Moew Tools](http://www.egret.com/products)\r\n\r\n# Third Party Library\r\n\r\n* Use [base64texture](https://github.com/egret-labs/egret-game-library/tree/master/base64texture) to convert base64 String to egert Texture\r\n* Use [dcagent](https://github.com/egret-labs/egret-game-library/tree/master/dcagent) DataEye SDK for Egret\r\n* Use [ecs](https://github.com/egret-labs/egret-game-library/tree/master/ecs) component system\r\n* Use [euiextension](https://github.com/egret-labs/egret-game-library/tree/master/euiextension) EUI extension\r\n* Use [gesture](https://github.com/egret-labs/egret-game-library/tree/master/gesture) Gesture library\r\n* Use [keyboard](https://github.com/egret-labs/egret-game-library/tree/master/keyboard) Keyboard event listener\r\n* Use [Greensock](https://github.com/egret-labs/egret-game-library/tree/master/greensock) Greensock animation library\r\n* Use [jszip](https://github.com/egret-labs/egret-game-library/tree/master/jszip) jszip Compression library\r\n* Use [md5](https://github.com/egret-labs/egret-game-library/tree/master/md5) A simple MD5 Library\r\n* Use [mouse](https://github.com/egret-labs/egret-game-library/tree/master/mouse) PC mouse support library\r\n* Use [particle](https://github.com/egret-labs/egret-game-library/tree/master/particle) particle system\r\n* Use [physics](https://github.com/egret-labs/egret-game-library/tree/master/physics) p2Physics engine，current version 0.7.0\r\n* Use [socket](https://github.com/egret-labs/egret-game-library/tree/master/socket.io) socket.io\r\n* Use [tiled](https://github.com/egret-labs/egret-game-library/tree/master/tiled) tiledmap support library\r\n* Use [weixinapi](https://github.com/egret-labs/egret-game-library/tree/master/weixinapi) WeChat API\r\n* More third party libraries please visit [here](https://github.com/egret-labs/egret-game-library) \r\n\r\n# Contributing\r\n\r\nAsking a question is the first step to participating in an open-source community. You can report Egret issues [here](https://github.com/egret-labs/egret-core/issues).\r\nIt is recommended that issues be discussed in the [official community portal](http://bbs.egret.com/portal.php), as it can help with solving problems efficiently.\r\n\r\n# License\r\n\r\nThis content is released under the (https://opensource.org/licenses/BSD-2-Clause) BSD License.\r\n\r\n![](https://img.shields.io/badge/license-New%20BSD-blue.svg)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fegret-labs%2Fegret-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fegret-labs%2Fegret-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fegret-labs%2Fegret-core/lists"}