Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
cocos2d for iPhone

This branch is 3422 commits ahead, 8075 commits behind cocos2d:v3.4

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
CocosDenshion
Resources-Mac
Resources-iPad/Images
Resources
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_Kazmath.txt
LICENSE_artwork.txt
LICENSE_cocos2d.txt
LICENSE_cocosdenshion.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: iPhone4 + RetinaDisplay mode compatible
  • Language: objective-c
  • Open Source: 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

Something went wrong with that request. Please try again.