About¶

• cocos2d-x is a multi-platform, light weight & developer-friendly C++ 2D mobile game engine, open source and released under MIT License. It is a child branch of the famous "cocos2d-iphone" project, and will keep the primary features sync with it.

• The "X" in cocos2d-x means:
  • means C++. Sometimes we write .cpp postfix as .cxx. So "X" means the project is written by C++, and offer C++ APIs
  • means CROSS. The goal of this open project is to cross multi mobile platforms

Documentations¶

Please click the tag clound or "Index by title" in the sidebar to see all documents. Here are only important and frequently asked documents listed below.

• Installation & First run
  • iphone
    • How to run HelloWorld of cocos2d-x on iPhone Emulator
    • How to run tests of cocos2d-x on iPhone Emulator
  • android
    • How to run HelloWorld on ndk r4 and r5
    • How to run test cases on android-ndk
    • How to create android project with script
  • win32
    • Cocos2d-x Application Wizard for Visual Studio User Guide
    • How to remove cocos2d-x templates

• Tutorial: How to make a cocos2d-x simple game
  • Chapter 1 - How to Create a New cocos2d-x project on multi-platforms
  • Chapter 2 - How to Add a sprite
  • Chapter 3 - How to Move a sprite
  • Chapter 4 - How to Fire some Bullets
  • Chapter 5 - How to Detect the Collisions
  • Chapter 6 - How to Play Music and Sound Effect
  • Chapter 7 - Some Icing on the Cake

• Upgrade Guide
  • How to upgrade your game from 0.7.1 to 0.7.2
  • How to upgrade your game from 0.7.2 to 0.8.0

• Features
  • Graphic
    • How does CCLabelTTF support line breaks and wrapping
    • How does cocos2d-x support multi-resolution
    • About the textures' maxsize in cocos2d-x
    • Editors for cocos2d-x Texture,Tilemap,Particle,Action,Level etc
    • Max size of textures in cocos2d-x depends on each platform
  • Audio
    • File formats supported by CocosDenshion on different platforms
  • Network
    • How to compile libcurl
  • File I/O
    • How to save/read file on different platforms
    • How does function fullPathFromRelativePath in class CCFileUtils work
  • Programming Language
    • Rules of translating objc to cpp
  • Build and Pack
    • Cocos2d-wophone中如何将资源文件打包成zip文件进行使用
    • Cocos2d-wophone支持多分辨率需要考虑的问题
    • Cocos2d-wophone游戏编译说明
    • Cocos2d-wophone资源路径详解
    • 如何使用 WOPhoneInstall 工具打包 cocos2d 游戏
    • CHN - FAQ

• Performance
  • 0.7.1
    • Performace Test of cocos2d-x 0.7.1 on iOS Devices
    • Performance Test of cocos2d-x 0.7.1 on Android Devices
    • Performance Test of cocos2d-x 0.7.1 on WoPhone Devices

DOWNLOAD¶

• Stable version (Recommend)
  • http://download.cocos2d-x.org/

• Edge version from our github repository:
  • http://github.com/cocos2d/cocos2d-x/

• Open source games by community
  • share some source during my study in cocos2d-x, based on cocos2d-0.99.4-x-0.7.1, win32, by @chris
  • cocos2d-win32 installation & Essential source code translated from <Learn iPhone & iPad Cocos2d Game Development>, based on cocos2d-0.99.4-x-0.7.1, win32, by @supersu

SUPPORT & HELP¶

• Forum: http://forum.cocos2d-x.org/
• Twitter: http://www.twitter.com/cocos2dx/
• Weibo: http://weibo/cocos2dx/
• Tencent QQ Group:
  • Group 1: 95115940 (full)
  • Group 2: 136017252 (full)
  • Group 3: 158628345
• mail: walzer (at) cocos2d-x.org

CONTRIBUTION¶

• I find a bug!
  • please kindly report the bug on our forum , post it on the right subforum for your mobile-platform. Details on how to reappear the bug will be helpful.
• I fixed a bug!
  • please fork our repository on http://github.com/cocos2d/cocos2d-x/, commit your fixed code
  • or you can post your fix code on the forum, we will commit it to github
• I would like to add a port to other platform!
  • please contact us via email/twitter/forum, etc. It's our pleasure to add a subproject on this website for you!
  • codeing style: please reference to the Google CPP StyleGuide Here's a zhCN version: Google CPP StyleGuide in zhCN

FOLLOW US¶

• Twitter: http://www.twitter.com/cocos2dx/
• Weibo: http://weibo.com/cocos2dx/