Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Cocos2d for iOS and OS X, built using Objective-C
Objective-C C Other
Failed to load latest commit information.
Chipmunk7-ios.xcodeproj Personal settings removed
Resources-Mac Removing Kazmath
Resources-iPad/Images Removing Kazmath
Resources Template changes
UnitTests Add performance based node tests
cocos2d-demo Renaming
cocos2d-template.xcodeproj Personal settings removed
cocos2d-template Basic settings
cocos2d-tests-android Remove stale BridgeKit3 references
cocos2d-tests.xcodeproj Personal settings removed
cocos2d-ui-tests CCEffectStereo - Experiment with red-cyan anaglyph 3D
cocos2d-ui Demo finished
cocos2d.xcodeproj Personal settings removed
cocos2d Release version
cocos2dMacFramework Fixes for AppStore
cocos2dMacFrameworkTests Fixes for AppStore
external Updates SSZip
migration no message
pong-objc/Images.xcassets Renaming
templates Prepared for release
tests Removing Kazmath
tools Update project name in docs
.gitattributes Added .gitattributes
.gitignore no message
.gitmodules SSZipArchive pointing to SB repo fork again.
API-Index.md Update project name in docs
AUTHORS Update project name in docs
CHANGELOG Removing Kazmath
DONORS Updated DONORS
File Changes.txt This will be difficult
Icon.png Opdated artwork
LICENSE_CCBReader.txt Adds licenses from the JS Bindings projects
LICENSE_Chipmunk.txt Updating the Chipmunk license.
LICENSE_CocosDenshion.txt Adds licenses from the JS Bindings projects
LICENSE_artwork.txt Fixes issue #1268
LICENSE_cocos2d.txt Update project name in docs
README.md Update README.md
RELEASE TODO.txt Updated installer version
RELEASE_NOTES V3.0.0 release stuff
VERSION Updated version
doxygen.config Removing Kazmath
doxygen.footer added doxygen footer
install.sh Minor template fixes

README.md

Cocos2D-ObjC

PLEASE READ BEFORE POSTING AN ISSUE!
If in doubt, please post questions and comments in the forum
The Official Forum

This way, more users can learn from your experince.

Please note, that the official site has moved. Please update your bookmarks
The Official Site
The Official Forum

Cocos2D-ObjC is a framework for building 2D games, demos, and other graphical/interactive applications for iOS, Mac and Android. It is based on the Cocos2D design, but instead of using Python it uses Swift and / or Objective-C.

Cocos2D-ObjC is:

  • Fast
  • Free
  • Easy to use
  • Community Supported

Creating New Projects

We are in the process of adding a stand alone installer to Cocos2D-Objc. A temporary template can be found here

An alternative approach, is to use SpriteBuilder:

New Cocos2D projects can be created with SpriteBuilder. SpriteBuilder is, just like Cocos2D, free and open source. You can get SpriteBuilder from spritebuilder.com or from the Mac App Store. Projects created using SpriteBuilder contains the complete Cocos2D source code, and after the project has been created using SpriteBuilder is optional.

SpriteBuilder also allows you to update the Cocos2D version in your project, to newest version, making it trivial to always keep you project updated to latest Cocos2D version.

You can find the full Cocos2D documentation and user guide at our documentation page.

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 6.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

Forum

Download from Github

$ git clone --recursive https://github.com/cocos2d/cocos2d-objc.git
$ cd cocos2d-objc
Something went wrong with that request. Please try again.