Skip to content


Subversion checkout URL

You can clone with
Download ZIP
cocos2d for iOS and OS X, built using Objective-C
Objective-C C C++ M Other
Pull request Compare This branch is 6119 commits ahead, 6120 commits behind cocos2d:master.
Latest commit 4872b81 @Birkemose Birkemose Update
Former-commit-id: 966cb4c
Failed to load latest commit information.
Chipmunk7-ios.xcodeproj Fixes for running unit tests on 64 bit.
Resources-Mac Updated icons
Resources-iPad/Images Resources: PNG images have a 72 dpi
Resources Update
UnitTests [CCPhysicsBody eachArbiter:] fix and unit tests.
cocos2d-ios.approj/targets/cocos2d Adding Release.overrides.json which sets up the correct header paths …
cocos2d-ios.xcodeproj Fixing warnings for 64 bit builds.
cocos2d-osx.xcodeproj Replacing sub-sub-projects for Chipmunk with targets.
cocos2d-tests-ios.xcodeproj Rendering tests.
cocos2d-tests-osx.xcodeproj OSX warnings
cocos2d-ui-tests Adding a simple CCRenderTexture test
cocos2d-ui Merge pull request #512 from chrene/CCScrollViewDelegate
cocos2d.xcworkspace CCLayout contentSize now immediately reflects changes to layout
cocos2d [CCPhysicsBody eachArbiter:] fix and unit tests.
external More 64 bit fixes.
installer Installer Updates
templates Updated iOS templates
tests Revert "Fix imports to get the performance tests compiling."
tools Update
.gitattributes Added -merge too to .gitattributes
.gitignore Installer updates
.gitmodules Changed the url of Chipmunk submodule to https (using git doesn’t wor…
AUTHORS Updated iOS templates
CHANGELOG V3.0.0 release stuff
Default-568h@2x.png Added Touch tests for Mac and iOS
Icon.png Opdated artwork
LICENSE_Box2D.txt Adds licenses from the JS Bindings projects
LICENSE_CCBReader.txt Adds licenses from the JS Bindings projects
LICENSE_Chipmunk.txt Adds licenses from the JS Bindings projects
LICENSE_CocosDenshion.txt Adds licenses from the JS Bindings projects
LICENSE_JRSwizzle.txt Adds licenses from the JS Bindings projects
LICENSE_Kazmath.txt Adds licenses from the JS Bindings projects
LICENSE_SpiderMonkey.txt Adds licenses from the JS Bindings projects
LICENSE_artwork.txt Fixes issue #1268
LICENSE_cocos2d.txt updated license
LICENSE_jsbindings.txt Adds licenses from the JS Bindings projects
LICENSE_libpng.txt Adds licenses from the JS Bindings projects Update
RELEASE TODO.txt Updated installer version
RELEASE_NOTES V3.0.0 release stuff
VERSION Adds version number
doxygen.config Adds predefined in doxygen.config
doxygen.footer added doxygen footer Updated installer version

cocos2d for iPhone

cocos2d for iPhone is a framework for building 2D games, demos, and other graphical/interactive applications for iPod Touch, iPhone, iPad and Mac OS X. It is based on the cocos2d design, but instead of using Python it uses Objective-C.

cocos2d for iPhone is:

  • Fast
  • Free
  • Easy to use
  • Community Supported

Templates Installation

  1. Download the code from Github

  2. Run the install script by executing ./ in Terminal
    (for more help and usage execute ./ -h)

    $ cd cocos2d-iphone # change directory to cocos2d-iphone
    $ ./  # execute the template installer script
  3. And then open Xcode → New → New Project → cocos2d v3.x


  • 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.
    • Composable actions: Sequence, Spawn, Repeat, Reverse
    • Ease Actions: Exp, Sin, Cubic, Elastic, etc.
    • Misc actions: CallFunc, OrbitCamera, Follow, Tween
  • Basic menus and buttons
  • Integrated with Chipmunk physics engine
  • Particle system
  • 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 iOS
  • Touch/Mouse/Keyboard on Mac
  • Sound Engine support (CocosDenshion library) based on OpenAL
  • Integrated Slow motion/Fast forward
  • Fast textures: PVR compressed and uncompressed textures
  • Point based: RetinaDisplay mode compatible
  • Language: Objective-C
  • Open Source Commercial Friendly: Compatible with open and closed source projects
  • OpenGL ES 2.0 (iOS) / OpenGL 2.1 (Mac) based

Build Requirements

Mac OS X 10.6 (or newer), Xcode 4.2 (or newer)

Runtime Requirements

  • iOS 5.0 or newer for iOS games
  • Snow Leopard (v10.6) or newer for Mac games

Running Tests

  1. Select the test you want from Xcode Scheme chooser

  2. Then click on Xcode → Product → Run

Contributing to the Project

Did you find a bug? Do you have feature request? Do you want to merge a feature?


Download from Github

$ git clone git://
$ cd cocos2d-iphone
$ git checkout develop-v3
$ git submodule update --init
Something went wrong with that request. Please try again.