This is a quick guide on getting a base project started with Monogame. I've tried to use tools that are platform agnostic, so hopefully this will work no matter if you're on Windows, OSX, or Linux. Let's get started!

Step 1: Install Monodevelop

Monogame is built off of the Mono Project, a cross-platform development framework built off of .NET (the runtime that C# normally runs on). Monodevelop is (at the time of this writing) the de-facto development environment for Mono. That's why we'll use it for Monogame as well! You can download monodevelop here:


Step 2: Install Monogame

Next, we're going to use NuGet to download MonoGame instead of directly. NuGet is a package manager, so it will handle downloading dependencies such as MonoGame for you. It's better to use a package manager, since it tends to handle differences between operating system's for you.

To use NuGet in MonoDevelop, you need the NuGet add on. There's instructions on how to install it here:

installing nuget add-in

Step 3: Install the Monogame add-in

This is no longer documented anywhere on the monogame site, but the easiest way to create a monogame project is to download a MonoDevelop add in. You can get it off the the old monogame site here:

monogame add-in

Simple download it, and install it from the 'Manage add-ins' page (click the 'install from file' button)

Step 4: Create a Monogame Project

Once you have the add-in installed, building a new game is as simple as creating a new Solution, and using the monogame template specific to your platform.


comments powered by Disqus

About Yusuke Tsutsumi
I work at Zillow. I focus on tools and services for developer productivity, including build and testing.

My other interests include programming language design, game development, and learning languages (the non-programming ones).