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, 8332 commits behind cocos2d:v3.5.0.
Latest commit 4872b81 Mar 8, 2014 @Birkemose Birkemose Update README.md
Former-commit-id: 966cb4c
Permalink
Failed to load latest commit information.
Chipmunk7-ios.xcodeproj Fixes for running unit tests on 64 bit. Feb 13, 2014
Resources-Mac Updated icons Jan 13, 2014
Resources-iPad/Images Resources: PNG images have a 72 dpi Jan 22, 2011
Resources Update README.md Mar 8, 2014
UnitTests [CCPhysicsBody eachArbiter:] fix and unit tests. Mar 8, 2014
cocos2d-ios.approj/targets/cocos2d Adding Release.overrides.json which sets up the correct header paths … Dec 18, 2013
cocos2d-ios.xcodeproj Fixing warnings for 64 bit builds. Feb 7, 2014
cocos2d-osx.xcodeproj Replacing sub-sub-projects for Chipmunk with targets. Jan 8, 2014
cocos2d-tests-ios.xcodeproj Rendering tests. Feb 24, 2014
cocos2d-tests-osx.xcodeproj OSX warnings Jan 11, 2014
cocos2d-ui-tests Adding a simple CCRenderTexture test Mar 4, 2014
cocos2d-ui Merge pull request #512 from chrene/CCScrollViewDelegate Feb 25, 2014
cocos2d.xcworkspace CCLayout contentSize now immediately reflects changes to layout Jan 27, 2014
cocos2d [CCPhysicsBody eachArbiter:] fix and unit tests. Mar 8, 2014
external More 64 bit fixes. Feb 10, 2014
installer
templates Updated iOS templates Mar 4, 2014
tests Revert "Fix imports to get the performance tests compiling." Dec 17, 2013
tools Update README.md Mar 8, 2014
.gitattributes Added -merge too to .gitattributes Feb 24, 2012
.gitignore Installer updates Jan 12, 2014
.gitmodules
AUTHORS Updated iOS templates Mar 4, 2014
CHANGELOG V3.0.0 release stuff Mar 3, 2014
DONORS Updated DONORS Oct 19, 2012
Default-568h@2x.png Added Touch tests for Mac and iOS Sep 5, 2013
Icon.png Opdated artwork Jan 13, 2014
LICENSE_Box2D.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_CCBReader.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_Chipmunk.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_CocosDenshion.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_JRSwizzle.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_Kazmath.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_SpiderMonkey.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_artwork.txt Fixes issue #1268 Dec 30, 2011
LICENSE_cocos2d.txt updated license Oct 12, 2012
LICENSE_jsbindings.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_libpng.txt Adds licenses from the JS Bindings projects Sep 6, 2012
README.md Update README.md Mar 8, 2014
RELEASE TODO.txt Updated installer version Mar 4, 2014
RELEASE_NOTES V3.0.0 release stuff Mar 3, 2014
VERSION Adds version number Feb 27, 2014
doxygen.config Adds predefined in doxygen.config Nov 14, 2012
doxygen.footer added doxygen footer Mar 18, 2010
install.sh Updated installer version Mar 4, 2014

README.md

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 ./install.sh in Terminal
    (for more help and usage execute ./install.sh -h)

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

Features

  • 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?

Forum

Download from Github

$ git clone git://github.com/cocos2d/cocos2d-iphone.git
$ cd cocos2d-iphone
$ git checkout develop-v3
$ git submodule update --init