Skip to content
This repository

cocos2d for iOS and OS X, built using Objective-C

Octocat-spinner-32 Chipmunk7-ios.xcodeproj Removes warnings for iOS tests and Cocos2D sub project April 01, 2014
Octocat-spinner-32 Resources-Mac Removing Kazmath March 28, 2014
Octocat-spinner-32 Resources-iPad Removing Kazmath March 28, 2014
Octocat-spinner-32 Resources Removing Kazmath March 28, 2014
Octocat-spinner-32 UnitTests [CCPhysicsBody eachArbiter:] fix and unit tests. March 07, 2014
Octocat-spinner-32 cocos2d-ios.approj Adding Release.overrides.json which sets up the correct header paths … December 18, 2013
Octocat-spinner-32 cocos2d-ios.xcodeproj Removing some old refs from the project files April 03, 2014
Octocat-spinner-32 cocos2d-osx.xcodeproj Removing some old refs from the project files April 03, 2014
Octocat-spinner-32 cocos2d-tests-ios.xcodeproj More BMFont tests. April 02, 2014
Octocat-spinner-32 cocos2d-tests-osx.xcodeproj OSX warnings January 11, 2014
Octocat-spinner-32 cocos2d-ui-tests Mac Fix for stenciled transitions. April 08, 2014
Octocat-spinner-32 cocos2d-ui Scrollview will stop panning if touched and won't steal touch anymore. April 15, 2014
Octocat-spinner-32 cocos2d.xcworkspace CCLayout contentSize now immediately reflects changes to layout January 27, 2014
Octocat-spinner-32 cocos2d Incorrect block type in CCPhysicsNode. April 16, 2014
Octocat-spinner-32 external Removing some old files. March 28, 2014
Octocat-spinner-32 installer Merge branch 'master' into v3.0 March 28, 2014
Octocat-spinner-32 templates Removing Kazmath March 28, 2014
Octocat-spinner-32 tests Removing Kazmath March 28, 2014
Octocat-spinner-32 tools Merge branch 'master' into v3.0 March 28, 2014
Octocat-spinner-32 .gitignore Installer updates January 12, 2014
Octocat-spinner-32 .gitmodules Changed the url of Chipmunk submodule to https (using git doesn’t wor… November 13, 2013
Octocat-spinner-32 AUTHORS Updated iOS templates March 04, 2014
Octocat-spinner-32 CHANGELOG Removing Kazmath March 28, 2014
Octocat-spinner-32 DONORS Updated DONORS October 19, 2012
Octocat-spinner-32 Default-568h@2x.png Added Touch tests for Mac and iOS September 05, 2013
Octocat-spinner-32 Icon.png Opdated artwork January 13, 2014
Octocat-spinner-32 LICENSE_CCBReader.txt Adds licenses from the JS Bindings projects September 06, 2012
Octocat-spinner-32 LICENSE_Chipmunk.txt Updating the Chipmunk license. April 03, 2014
Octocat-spinner-32 LICENSE_CocosDenshion.txt Adds licenses from the JS Bindings projects September 06, 2012
Octocat-spinner-32 LICENSE_Kazmath.txt Adds licenses from the JS Bindings projects September 06, 2012
Octocat-spinner-32 LICENSE_artwork.txt Fixes issue #1268 December 30, 2011
Octocat-spinner-32 LICENSE_cocos2d.txt updated license October 12, 2012
Octocat-spinner-32 README.md Update README.md March 08, 2014
Octocat-spinner-32 RELEASE TODO.txt Updated installer version March 04, 2014
Octocat-spinner-32 RELEASE_NOTES V3.0.0 release stuff March 03, 2014
Octocat-spinner-32 VERSION Adds version number February 27, 2014
Octocat-spinner-32 doxygen.config Removing Kazmath March 28, 2014
Octocat-spinner-32 doxygen.footer added doxygen footer March 18, 2010
Octocat-spinner-32 install.sh Updated installer version March 04, 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
Something went wrong with that request. Please try again.