cocos2d/cocos2d-x — 19.2k★ on GitHub (C++). Cocos2d-x is a suite of open-source, cross-platform, game-development tools utilized by millions of developers across the globe. Its core has evolved to serve as the foundation for Cocos Creator 1.x & 2.x.
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.
cocos2d-x is a multi-platform framework for building 2d games, interactive books, demos and other graphical applications.
It is based on cocos2d-iphone, but instead of using Objective-C, it uses C++.
It works on iOS, Android, macOS, Windows and Linux.
Integrated with physics engines: Box2d and Chipmunk
Particle system
Skeleton Animations: Spine and Armature support
Fonts:
Fast font rendering using Fixed and Variable width fonts
Support for .ttf fonts
Tile Map support: Orthogonal, Isometric and Hexagonal
Parallax scrolling
Motion Streak
Render To Texture
Touch/Accelerometer on mobile devices
Touch/Mouse/Keyboard on desktop
Sound Engine support
Integrated Slow motion/Fast forward
Fast and compressed textures: PVR compressed and uncompressed textures, ETC1 compressed textures, and more
Resolution Independent
Language: C++, with Lua and JavaScript bindings
Open Source Commercial Friendly(MIT): Compatible with open and closed source projects
OpenGL ES 2.0 (mobile) / OpenGL 2.1 (desktop) / metal(macos and iOS) based
Build Requirements
Mac OS X 10.7+, Xcode 8+
or Ubuntu 14.04+, CMake 3.1+
or Windows 7+, VS 2015
Python 2.7.5+(NOT Python 3)
NDK r16+ is required to build Android games
Android Studio 3.0.0+ to build Android games(tested with 3.0.0)
JRE or JDK 1.6+ is required for web publishing
Runtime Requirements
iOS 8.0+ for iPhone / iPad games
Android 3.0.0+ for Android
OS X v10.9+ for Mac games
Windows 7+ for Win games
Environment Setup
Should set up environment before starting a new game or running tests
$ cd cocos2d-x
$ ./setup.py
$ source FILE_TO_SAVE_SYSTEM_VARIABLE
Should invoke this script if using linux system
$ cd cocos2d-x
$ ./install-linux-deps.sh
Running Tests
$ cd cocos2d-x
$ mkdir build
$ cd build
$ cocos run --proj-dir .. -p [mac|win32|android|linux|ios]
How to start a new game
$ cd cocos2d-x
$ ./setup.py
$ source FILE_TO_SAVE_SYSTEM_VARIABLE
$ cocos new MyGame -p com.your_company.mygame -l cpp -d NEW_PROJECTS_DIR
$ cd NEW_PROJECTS_DIR/MyGame
$ mkdir build
$ cd build
$ cocos run --proj-dir .. -p [mac|win32|android|linux|ios]
You can also create a Lua project with -l lua.
Using IDE
If need to debug program, then it is more convinent to use IDE to run and debug it. All platforms other than Android can use CMake to generate corresponding project file. Can refer to Detail CMake Guide for detail information.
For Android, the Android Studio project file lies in PROJECT_DIR/proj.android. Can just use Android Studio to import the exsting project file.
Learning Resources
Programmers Guide
Android Fundamentals
Games From Scratch
Make School Tutorials
Spreading the word!
You can help us spread the word about cocos2d-x! We would surely appreciate it!
Twitter: @CocosEngine
Facebook: https://www.facebook.com/CocosEngine
YouTube: https://www.youtube.com/cocosengine
Weibo: @Cocos引擎
bilibili: https://space.bilibili.com/491120849
Where to get help
English Forums
中文社区
Bug Tracker
API Reference.
Latest Release Note
Changelog
Discord Channel
cpp-tests project. This project is our basis for testing. Use this project to
learn how we implement the functionality of the engine. This project is located in
cocos2d-x_root/build.
Contributing to the Project
Cocos2d-x is licensed under the MIT License. We welcome participation!
Did you find a bug? Do you have feature request? Do you want to merge a feature?
contributing to cocos2d-x
Embrace the Future: Switch to Cocos Creator for a Better Experience
Cocos Creator is the new generation of Cocos game engine with a full featured editor and content creation friendly workflow. It supports all major platforms allowing games to be quickly released for the web, iOS, Android, Windows, Mac, and various mini-game platforms. Millions of developers have built 2D / 3D experiences, from hardcore games to web instant entertainment. A pure JavaScript-developed engine runtime is available on the web and mini-game platforms for better performance and smaller packages. On other native platforms, C++ is used to implement the underlying framework, providing greater operational efficiency. The engine is completely open source, and retains the advantages of Cocos2d-x which includes high performance, customizability, ease for debugging, easy to learn, and small package size.
Therefore, we no longer recommend new users to start with Cocos2d-x. Instead, please use the brand-new Cocos Creator for project development to enjoy the best editor and 3D support.
The most recent commit recorded on cocos2d/cocos2d-x was 1.5 years ago, based on the GitHub push timestamp. The repository has 7.0k forks — one of the better signals of community interest.
How does cocos2d/cocos2d-x compare to other Mobile projects?
cocos2d/cocos2d-x is tracked by TopGit in the Mobile category, with 19.2k GitHub stars and written in C++. Browse the Mobile topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does cocos2d/cocos2d-x have?
cocos2d/cocos2d-x has 19.2k GitHub stars — refresh the page for the live number, or check github.com/cocos2d/cocos2d-x. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is cocos2d/cocos2d-x open source?
TopGit's metadata for cocos2d/cocos2d-x does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What is cocos2d/cocos2d-x?
cocos2d/cocos2d-x (cocos2d/cocos2d-x) is a C++ project on GitHub. From the project's own README: Cocos2d-x is a suite of open-source, cross-platform, game-development tools utilized by millions of developers across the globe. Its core has evolved to serve as the foundation for Cocos Creator 1.x & 2.x.
Where do I read more about cocos2d/cocos2d-x?
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-x is the definitive source.
Read full README in the tab above.
Curious whether cocos2d-x is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about cocos2d-x.