Skip to content

MonoGame on Windows 8 Quick Start

tomspilman edited this page Jul 6, 2012 · 5 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 working from a git repo go to the ProjectTemplates\VisualStudio11.MonoGame.2.5\VS11MGWindowsMetroTemplate folder and zip only the content of that folder. It is important that the zip when unzipped only includes the content and not the folder itself or VisualStudio will not see the template.

Copy the zip to your Documents\Visual Studio 11\Templates\ProjectTemplates\Visual C# folder and restart VisualStudio11.

New Project

Open VisualStudio11 and create a new "MonoGame Metro Application For Windows" C# project.

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.

Clone this wiki locally