1.9k GitHub stars and counting — cocos2d/cocos2d-js is a C++ project TopGit is tracking across repositories on the platform. cocos2d-x for JS
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
*** 2/27/2016 - This repository is no longer active. Cocos2d-JS was merged with Cocos2d-x starting at version 3.7.
*** please go here
Cocos2d-JS
Cocos2d-JS is Cocos2d-x engine's JavaScript version that includes Cocos2d-html5 and Cocos2d-x JavaScript Bindings. It equips your game with cross-browser and cross-platform abilities, accompanied by full Cocos2d-x features and simplified JavaScript friendly APIs.
Cocos2d-JS reinvented workflows for all platforms in v3.0, it provides a consistent development experience for whichever platform you want to distribute to, no matter web and native. "Code once, run everywhere" is incredibly easy and natural in Cocos2d-JS. With one single JavaScript code base, you can run your game on all web browsers and native platforms including Mac OS, Windows, iOS and Android. This will bring your game great opportunities in almost all channels of distribution. On the other hand, if you are only interested in casual games on the web, you can embed directly in your web page the Cocos2d-JS Lite Version which is extremely easy to use and light as a feather.
Furthermore, JavaScript friendly APIs make your game development experience a breeze - easy to code, test and distribute. In the meantime, Cocos2d-JS v3.0 is super powerful along with all these cool new features: Editors Support, Assets Manager, Object Pool, JS to Objective-C/JAVA reflection, etc.
Workflows
Cross platforms developers can use Cocos Console to create projects, boost their development with web version engine and deploy games onto all native platforms and all browsers with Cocos Console.
Casual web game developers can download the Lite Version and start to develop just like using other web frameworks (e.g. jQuery).
Downloads
Cocos2d-JS v3.0 Full Version
Cocos2d-JS v3.0 Lite Version
Online API reference
Downloadable API Reference
Online demos
MoonWarriors
Testcase
Documentations
Getting Started with Cocos2d-JS
Cocos2d-JS release notes
About Cocos2d family
Cocos2d-JS v3.0 uses Cocos2d-x 3.2 final as base of JSB solution
Cocos2d-JS v3.0 is compatible with Cocos Code IDE v1.0.0 RC2+
Cocos2d-JS v3.0 is compatible with Cocos Studio v1.2 - v2.0
With any problems you might have, our communities are happy to help:
Online forum
Document root
Github repository
How to Start a New Game
Download the code from Cocos2d download site
Run setup.py
Run the cocos script
Example:
$ cd cocos2d-js
$ ./setup.py
$ source FILE_TO_SAVE_SYSTEM_VARIABLE
$ cocos new MyGame -l js -d /directory/to/project
$ cd /directory/to/project/MyGame
###Run the project under the game directory
Run Cocos2d-html5 project with a Websever:
cocos run -p web
Compile and run project in Cocos2d-JSB :
cocos compile -p ios|mac|android|win32|web
cocos run -p ios|mac|android|win32|web
You may need to provide your Android NDK, Android SDK and ANT's paths during the setup. Note that this tool is developed with python, so you will need python (32bit) 2.7.5 or later installed on your machine (but it doesn't support Python3). Please refer to Cocos Console document.
And if you have any doubt about the usage, please use -h with any command to have some help messages.
You can also use prebuilt Xcode or Visual Studio projects which are located in Game/frameworks/runtime-src/proj.xxx
##Folder structure of new project
frameworks
cocos2d-html5 : Cocos2d-JS html5 engine source
js-bindings : JSB engine source (include Cocos2d-x and JSB)
runtime-src : IDE projects (Android, iOS, Mac OS, Win32)
publish : Published apps
runtime : Debug app files
tools : JS Bindings generator
res : Your game resource folder for images, sounds, etc
src : The source code folder to place your game's js files
main.js : The entrance of your game logic
index.html : The web page for hosting your game in web server
##Built-in Projects
There are two prebuilt projects in Cocos2d-JS repo:
Test cases, located in samples/js-tests
cd samples/js-tests
run -p ios|mac|android|win32|web
Game sample : Moon Warriors, located in samples/js-moonwarriors
cd samples/js-moonwarriors
run -p ios|mac|android|win32|web
And they share the same project files which are located in build folder, there are Xcode and Visual Studio projects.
##Main features
Support All modern browsers and native platforms
Scene management (workflow)
Transitions between scenes
Sprites and Sprite Sheets
Effects: Lens, Ripple, Waves, Liquid, etc.
Actions (behaviours):
Trasformation Actions: Move, Rotate, Scale, Fade, Tint, etc.
TopGit's last sync did not record any GitHub topics for cocos2d/cocos2d-js. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on cocos2d/cocos2d-js?
The most recent commit recorded on cocos2d/cocos2d-js was 1.8 years ago, based on the GitHub push timestamp. The repository has 472 forks — one of the better signals of community interest.
Is cocos2d/cocos2d-js open source?
Yes — cocos2d/cocos2d-js ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/cocos2d/cocos2d-js.
What license does cocos2d/cocos2d-js use?
cocos2d/cocos2d-js is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where can I see cocos2d/cocos2d-js in action?
The project maintains a homepage at http://www.cocos2d-x.org. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about cocos2d/cocos2d-js?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/cocos2d/cocos2d-js is the definitive source.
Read full README in the tab above.
Is cocos2d-js worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of cocos2d-js.