cocos2d for iPhone
Switch branches/tags
release-2.1-beta2 release-2.1-beta release-2.0.0-alpha release-2.0 release-2.0-rc2 release-2.0-rc1 release-2.0-rc0 release-2.0-rc0a release-2.0-beta2 release-2.0-beta release-1.1 release-1.1-beta2 release-1.1-beta2b release-1.1-beta2a release-1.1-beta release-1.0.1 release-1.0.1-reorderSprite release-1.0.0 release-1.0.0-reorderSprite release-1.0.0-rc3 release-1.0.0-rc3-reorderSprite release-1.0.0-rc2 release-1.0.0-rc2-reorderSprite release-1.0.0-rc release-1.0.0-rc-reorder-sprite release-1.0.0-beta release-1.0.0-beta-reorder-sprite release-0.99.5 release-0.99.5-rc1 release-0.99.5-rc0 release-0.99.5-beta3 release-0.99.5-beta2 release-0.99.5-beta release-0.99.4 release-0.99.4-rc3 release-0.99.4-rc2 release-0.99.4-rc release-0.99.4-beta release-0.99.3 release-0.99.3-rc release-0.99.2 release-0.99.1 release-0.99.1-rc release-0.99.0 release-0.99.0-rc release-0.99.0-final release-0.9.0-beta2 release-0.9.0-beta release-0.9.0-alpha release-0.8.2 release-0.8.2-rc1 release-0.8.2-rc0 release-0.8.2-beta release-0.8.1 release-0.8.1-rc release-0.8.1-beta release-0.8 release-0.8-rc release-0.8-beta release-0.7.3 release-0.7.2 release-0.7.2-rc release-0.7.1 release-0.7.0 release-0.7-rc release-0.7-beta2 release-0.6.3 release-0.6.2 release-0.6.1 release-0.6.0 release-0.5.3 release-0.5.2 release-0.5.1 release-0.5.0 release-0.4.3 release-0.4.2 release-0.4.0 release-0.3.3 release-0.3.2 release-0.3.1 release-0.3 release-0.2.1 release-0.2 release-0.1 gorillas-140 cocos2d-iphone-1.1-beta3 cocos2d-iphone-0.99.2-rc Release_1.1
Nothing to show
Pull request Compare This branch is 3894 commits ahead, 8334 commits behind cocos2d:v3.5.0.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
CocosDenshion
Resources-Mac
Resources-iPad/Images
Resources
cocos2d-framework
cocos2d-ios.xcodeproj
cocos2d-mac.xcodeproj
cocos2d.xcworkspace
cocos2d
external
templates
tests
tools
.gitattributes
.gitignore
AUTHORS
CHANGELOG
DONORS
LICENSE_Box2D.txt
LICENSE_Chipmunk.txt
LICENSE_CocosDenshion.txt
LICENSE_Kazmath.txt
LICENSE_artwork.txt
LICENSE_cocos2d.txt
LICENSE_libpng.txt
README.md
RELEASE_NOTES
doxygen.config
doxygen.footer
install-templates.sh

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

How to start a new game

  1. Download the code from Github or from cocos2d download site

  2. Run the install-templates.sh script

Example:

$ cd cocos2d-iphone
$ ./install-templates.sh -f
  1. And then open Xcode -> New -> New Project -> cocos2d v2.x

Main 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 physics engines: Box2d and Chipmunk
  • 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 4.0 or newer for iOS games
  • Snow Leopard (v10.6) or newer for Mac games

How to run the tests

Select the test you want from Xcode Scheme chooser.

Then click on Xcode -> Product -> Run

How to contribute to the project

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

Forum