# Cocos2d-x

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.

Repository: https://github.com/cocos2d/cocos2d-x
Canonical: https://ross.abutalabs.com/products/cocos2d-x
Homepage: https://www.cocos.com/en/cocos2d-x
Language: C++
License Family: other
Topics: cocos2d, cocos2d-x, game-engine, c-plus-plus, lua, metal, android, ios, linx, windows, game-development, gamedev
Last push: 2025-05-09T03:36:03+00:00
Link (homepage): https://www.cocos.com/en/cocos2d-x
Link (site_page): https://docs.cocos.com/creator/manual/en
Link (site_page): https://www.cocos.com/en/about

## Health v2 (maintenance only)
Score: 41/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 20, release rhythm 35, longevity 100
- inputs: {"age_days": 5767, "days_push": 481, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 19162, forks 7053 (observed 2026-08-28T04:11:27.488776+00:00)

## What it is
Cocos2d-x is an open-source, cross-platform C++ framework for building 2D games and graphical applications, with Lua and JavaScript bindings. It runs on iOS, Android, Windows, macOS, Linux, and HTML5, and serves as the foundation for Cocos Creator 1.x and 2.x.

## Use cases
- build a 2d mobile game for ios and android
- cross-platform 2d game engine in c++
- make an html5 game with javascript
- 2d game engine with lua scripting and hot updates
- create interactive books or graphical demos
- 2d physics game using box2d or chipmunk
- skeletal animation game engine with spine support

## When to choose
- you need a mature, lightweight 2D engine with C++, Lua, or JavaScript APIs
- you target mobile and desktop platforms plus HTML5 from one codebase
- you want hot-updatable games via Lua/JavaScript scripting
- you need built-in physics, tilemaps, particles, and skeletal animation

## When to avoid
- you need a full 3D engine or modern editor-driven workflow (use Cocos Creator 3.x or Unity)
- you want a large plugin ecosystem or commercial-grade support guarantees
- you require a permissive license - the repo lists no standard license, so review terms before commercial use

## Facets
- artifact type: framework
- maturity: maintenance
- function: game-engine, graphics, animation, audio-processing, gui
- domain: graphics, cross-platform, mobile-development
- platform: windows, cpp, lua
- tags: 2d-games, opengl-es, metal, html5, spine, box2d, chipmunk, tilemaps, particle-system, cocos-creator, game-development, ios, android, macos, linux, web-server

## Member repositories
- cocos2d/cocos2d-x (main) score 41
- cocos2d/cocos2d-html5 (sdk) score 32
- cocos2d/cocos2d-js (sdk) score 35

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:27.488776+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:00:25.029921+00:00, confidence not recorded.
  - readme: https://github.com/cocos2d/cocos2d-x (fetched 2026-08-28T04:11:27.488776+00:00, sha 24e655f618bd)
  - homepage: https://www.cocos.com/en/cocos2d-x (fetched 2026-08-29T07:59:10.384143+00:00, sha fcfa7e5e1857)
  - site_page: https://docs.cocos.com/creator/manual/en (fetched 2026-08-29T07:59:10.387591+00:00, sha 36416a1437e8)
  - site_page: https://www.cocos.com/en/about (fetched 2026-08-29T07:59:10.390255+00:00, sha a03d36a04ff4)
- Data as of 2026-08-30T08:39:29.467469+00:00.