Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
cocos2d for iPhone
branch: master-v2

This branch is 3894 commits ahead, 8036 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-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

Something went wrong with that request. Please try again.