Skip to content

MonoGame on Windows 8 Quick Start

Krelix edited this page Nov 24, 2012 · 6 revisions

Setup MonoGame3

Install Packages

There are currently no installation packages for MonoGame 3.x

Github

If you plan to contribute back to MonoGame or you want to work with pre-released versions you should work from a fork of the develop3d repository:

https://github.com/mono/MonoGame/tree/develop3d

You will find the instructions here on how to fork a repo and clone a local copy.

Be sure to update the submodules in your local repo to get the 3rd-party libs and samples:

git submodule init
git submodule update

Project Templates

If you used an install package the templates for VisualStudio were added for you.

If you are using Visual Studio 2012 (or if you're using the Express edition, make sure it is the Express for Windows 8 edition) and you are working from the Github repository, you will find the templates for Windows 8 in ProjectTemplate\VisualStudio2012. Copy those files to Documents\Visual Studio 2012\Templates\ProjectTemplates\Visual C#\MonoGame (if the MonoGame folder doesn't exist, create it). Once this is done, fire up Visual Studio 2012 and you should find the three templates that allow you to develop for Windows 8.

New Project

Open Visual Studio 2012, select Visual C# and you should see three MonoGame projects, two for the Windows 8 store and one for Windows Phone 8.

If you're working from a local clone of the MonoGame repository then be sure to add the MonoGame.Framework/MonoGame.Framework.Windows8.csproj to your solution and add references to the sharpdx metro assemblies to it, so that it can be built and referenced from your game project.

You should now be able to build and run the new game app.

Porting A Project

At this time the process to port an existing XNA project to MonoGame is manual. We suggest creating a new template project with the same name and either adding the files and settings manually or using a diff tool to merge them.