Skip to content
master
Go to file
Code

Readme.md

Cocos2D-XNA

Cocos2D-XNA is the premier 2D game development engine based upon the wildly popular and successful Cocos2D-X engine. With Cocos2D-XNA, the game developer can create fantastic games with rich user experiences without the tremendous cost of a proprietary game library. MIT licensed, and open source hosted at github.com, this framework gives developers total power and control over every aspect of their game. Cocos2D-XNA has been used to deploy games to nearly every type of device in use today using XNA from Microsoft or MonoGame. Now the power of XNA and the depth of Cocos2d are at every game developers reach, taking their creative genius to over 95% of the computing devices on the planet.

Cocos2D-XNA : Reach To Infinity!

License

This work is copyrighted by the Cocos2D-XNA group. This copyright is non-transferrable and resides solely with the authors of this intellectual work product. Any use of this work, in whole or in part, is subject to the License found in the LicenseAndCredit.txt file found in this repository. Jurisdiction for any and all copyright claims, and rights therein, shall reside in the United States of America, and the State of California.

Download and Run

Code on GitHub

To obtain the code you will need a git client. Either command line or graphical.

Using the git command line you will need to clone the git repository.

$ git clone https://github.com/Cocos2DXNA/cocos2d-xna.git

Wait until the clone has finished.

You should see something similar to the following:

Cloning into 'cocos2d-xna'...
remote: Counting objects: 20553, done.
remote: Compressing objects: 100% (7677/7677), done.
remote: Total 20553 (delta 14127), reused 18870 (delta 12446)
Receiving objects: 100% (20553/20553), 100.83 MiB | 634 KiB/s, done.
Resolving deltas: 100% (14127/14127), done.
Checking out files: 100% (4130/4130), done.

To support Android, iOS, and other platforms, you must have a version of MonoGame (develop branch) version 3.0 available. The MonoGame repository is a submodule of the Cocos2D-XNA project that all the solutions reference.

To initialise and update the required MonoGame submodules that we reference you will need to do the following:

Change into the cocos2d-xna directory to issue the following submodule commands.

$ git submodule init

Output from above command:

Submodule 'MonoGame' (https://github.com/Cocos2DXNA/MonoGame.git) registered for path 'MonoGame'
Submodule 'tools/ouya' (https://github.com/slygamer/ouya-csharp.git) registered for path 'tools/ouya'

You will then want to update the actual submodules:

$ git submodule update

Output from above command:

Cloning into 'MonoGame'...
remote: Counting objects: 32905, done.
remote: Compressing objects: 100% (10011/10011), done.
remote: Total 32905 (delta 24991), reused 29779 (delta 22574)
Receiving objects: 100% (32905/32905), 33.33 MiB | 305 KiB/s, done.
Resolving deltas: 100% (24991/24991), done.
Submodule path 'MonoGame': checked out 'bd6518a33c91c43a46f14aa68bdc854c08e6bc2a'
Cloning into 'tools/ouya'...
remote: Counting objects: 249, done.
remote: Compressing objects: 100% (139/139), done.
remote: Total 249 (delta 100), reused 231 (delta 86)
Receiving objects: 100% (249/249), 2.88 MiB | 620 KiB/s, done.
Resolving deltas: 100% (100/100), done.
Submodule path 'tools/ouya': checked out '5f712a4b3845bad2974b30bc0c243eb503812ea9'

MonoGame has it's own external dependencies so we will also need to obtain those as well.

$ cd MonoGame

$ git submodule init

$ git submodule update ThirdParty/Dependencies

Notice above that we only need the ThirdParty/Dependencies to actually build Cocos2D-XNA. Also make sure that you are on the develop branch of MonoGame and the master branch of Dependencies.

You now have everything you need to start start developing with Cocos2D-XNA

Templates for Visual Studio

To make things as easy as possible we also provide templates for Visual Studio.

There is a tutorial on Finding and Installing the templates

Templates for Xamarin Studio

We are working hard on getting these out.

Getting Started

Test Bed

We have created solutions for all the supported platforms that serves as our TestBed for each platform.

You can find those in the tests directory

cocos2d-xna.Tests.Android.sln	
cocos2d-xna.Tests.Ouya.sln	
cocos2d-xna.Tests.Windows.sln	
cocos2d-xna.Tests.Windows8.sln	
cocos2d-xna.Tests.WindowsDX.sln	
cocos2d-xna.Tests.WindowsGL.sln	
cocos2d-xna.Tests.WindowsPhone.sln	
cocos2d-xna.Tests.WindowsPhone7.sln	
cocos2d-xna.Tests.iOS.sln	

Samples

Xamarin's Angry Ninjas sample application. We worked hard on converting that cocos2d-iphone game over to Cocos2D-XNA. Take a look at how it deploys raw assets and utilizes box2d.

Additional samples will be forthcoming as we find time to add more for you.

You can’t perform that action at this time.