mhaylock / cocos2d-iphone

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

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

3. 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 ?

• contributing to cocos2d

Forum

• cocos2d for iphone forum