CocosBuilder editor
Switch branches/tags
Nothing to show
Pull request Compare This branch is 1090 commits behind cocos2d:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
CCBReader
CocosBuilder
CocosBuilderExample
Documentation
Graphics
PlugIn Exporters/Export Example
PlugIn Nodes/CCRotatingSprite
scripts
.gitattributes
.gitignore
.gitmodules
AUTHORS
CHANGELOG
LICENSE_CocosBuilder.txt
LICENSE_PSMTabBarControl.txt
LICENSE_SCEvents.txt
LICENSE_Sparkle.txt
README.md

README.md

CocosBuilder

CocosBuilder is a free tool (released under MIT-licence) for graphically laying out sprites, layers and scenes for Cocos2D iPhone and Mac. It’s ideal for quickly and accurately creating menus and other parts of the interface, but can also be used to create levels, particle systems or any other kind of Cocos2D node graphs.

It’s super easy to include the scenes you build in CocosBuilder into your project. Add the CCBReader files, then load the node graph or scene with a single line of code!

CocosBuilder allows you to patch into the generated file at any point by automatically assigning variables and custom classes for the objects that you load through the CCBReader. Objects created by CocosBuilder also plays beautifully with your existing Cocos2D code.

Example usages

Load a CCScene from a CocosBuilder project:

CCScene* scene = [CCBReader sceneWithNodeGraphFromFile:@"example.ccb"];

Load a particle system (the root node of the ccb-file needs to be a CCParticleSystem):

CCParticleSystem* particles = (CCParticleSystem*)
    [CCBReader nodeGraphFromFile:@"example-particles.ccb"];

Getting started with the source

Cocos2d is provided as a submodule to this project. To be able to compile the source code you need first check out the module. Change directory into the top (this) directory of CocosBuilder and run:

git submodule init
git submodule update

When building CocosBuilder, make sure that "CocosBuilder" is the selected target (it may be some of the plug-in targets by default).