Cocos2d for iOS and OS X, built using Objective-C
Objective-C C Other
Latest commit a2c963b Dec 5, 2016 @s1ddok s1ddok committed on GitHub Update README.md
Permalink
Failed to load latest commit information.
Resources-Mac Removing Kazmath Mar 28, 2014
Resources Template changes Jul 16, 2015
UnitTests Merged CCDirector headers Feb 29, 2016
cocos2d-ext Strings.ccbLang files renamed to Strings.ccblang Mar 21, 2016
cocos2d-tests.xcodeproj Mac fixes Feb 21, 2016
cocos2d-ui-tests SpriteBuilderTranslations renamed to CocosBuidlerTranslations Mar 21, 2016
cocos2d-ui Merge pull request #1372 from oxeron/develop-v3.5-ext Mar 23, 2016
cocos2d.xcodeproj Merged CCDirector headers Feb 29, 2016
cocos2d Fixes issue that caused graphics loading to fail when only using @1x May 22, 2016
cocos2dMacFramework Updates for Xcode 7.1 Dec 3, 2015
cocos2dMacFrameworkTests Fixes for AppStore Feb 23, 2015
external - updated chipmunk submodule Oct 29, 2015
tests Removing Kazmath Mar 28, 2014
tools Update project name in docs Feb 21, 2015
.gitattributes Added .gitattributes Jul 13, 2015
.gitignore no message Aug 27, 2015
.gitmodules SSZipArchive pointing to SB repo fork again. Sep 26, 2014
AUTHORS remove dummy files Feb 21, 2016
DONORS More folder cleanup Feb 21, 2016
Icon.png Opdated artwork Jan 13, 2014
LICENSE_CCBReader.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_Chipmunk.txt Updating the Chipmunk license. Apr 3, 2014
LICENSE_CocosDenshion.txt Adds licenses from the JS Bindings projects Sep 6, 2012
LICENSE_artwork.txt Fixes issue #1268 Dec 30, 2011
LICENSE_cocos2d.txt Update project name in docs Feb 21, 2015
README.md Update README.md Dec 5, 2016
cocos2d-tests-ios copy-Info.plist cocos2d-core compiles to TVOS now. Feb 12, 2016
doxygen.config Removing Kazmath Mar 28, 2014
doxygen.footer added doxygen footer Mar 18, 2010

README.md

Cocos2D-ObjC

Want pure x-platform Swift?

We experience rewrite in this repository.

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 tvOS. It is based on the Cocos2D design, but instead of using Python it uses Swift and / or Objective-C.

Cocos2D-ObjC is:

  • Fast
  • Free
  • Lightweight
  • Modular
  • Easy to use
  • Community Supported

Creating New Projects

For creating new projects you should use an official Cocos2D Installer.

Documentation

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

Important:

Version 3.5 is introduced. See release notes

Features

  • Scene management (workflow)
  • Transitions between scenes
  • Sprites and Sprite Sheets
  • Effects: Lens, Ripple, Waves, Liquid, etc. (Served as extension)
  • 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 (Served as extension)
  • Particle system (Served as extension)
  • Fonts:
    • Fast font rendering using Fixed and Variable width fonts
    • Support for .ttf fonts
  • Tile Map support: Orthogonal, Isometric and Hexagonal (Served as extension)
  • Parallax scrolling (Served as extension)
  • Motion Streak (Served as extension)
  • Render To Texture (Served as extension)
  • Touch/Accelerometer on iOS
  • Touch/Mouse/Keyboard on Mac
  • Sound Engine support based on OpenAL (Served as extension)
  • Integrated Slow motion/Fast forward
  • Fast textures: PVR compressed and uncompressed textures
  • Point based: RetinaDisplay mode compatible
  • Language: Objective-C / Swift
  • Open Source Commercial Friendly: Compatible with open and closed source projects
  • Image assets support
  • TVOS support
  • App thinning support
  • 3D touch support
  • OpenGL ES 2.0 or Metal (iOS) / OpenGL 2.1 (Mac) based

Build Requirements

Mac OS X 10.9 (or newer), Xcode 7.0 (or newer)

Runtime Requirements

  • iOS 6.0 (7.0 for Swift) 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