Skip to content

Setup MonoGame Dev Environment with Visual Studio Code

In this article I will discuss how to setup MonoGame development environment without Visual Studio 2019, instead use any other simple text editor or Visual Studio Code.

MonoGame is community driven open source Game library build upon Microsoft’s XNA framework. MonoGame and XNA are used in many famous games like Stardew valley, Terraria, etc.

In this article I will show how we can setup development environment for MonoGame with VS Code, without using Microsoft’s Visual Studio 2019.

Visual Studio is my favourite IDE, and I love it lot, best in its class for .Net developers, but very heavy IDE and there may be cases when you don’t want to overload your system and want to use light weight editor like Visual Studio Code.

So, Let’s start.

I am using windows 10 operating system for this tutorial. We will perform following steps:

  • Install .Net SDK (.Net 6)
  • Install Visual Studio Code
  • Install MonoGame templates
  • Setup MGCB editor
  • Create First Application
  • Run the project

Step 1: Install .Net SDK

.Net SDK is the primary requirement for MonoGame. This can be installed from .Net official page. As of writing this article, .Net 6 is the latest version, and we are going to use this.

After installing it, to verify if its installed correctly, run below command in terminal/command line.


And you will get something like below:

Check .Net install

Another way is to run below command which shows the installed version:

dotnet --version

Which shows below result:

C:\Users\Siddharth>dotnet --version

Step 2: Install Visual Studio Code

Although you can use any text editor of your choice, but Visual Studio Code is a very popular free code editor, built on open source. It has also a very nice C# extension which gives pretty good intellisense.

You can download Visual Studio code from here.

Step 3: Install MonoGame templates

MonoGame templates give you very easy way to generate MonoGame projects.

You can install it by running below command:

dotnet new --install MonoGame.Templates.CSharp

And after that you can see something like below, which indicates successful installation.

MonoGame templates installed successfully
MonoGame templates installed successfully

Step 4: Setup MGCB editor

MGCB editor is a tool that helps to build content (Sprites, Images, Audio, Fonts etc.) of the game.

Execute below command to install MGCB editor:

dotnet tool install --global dotnet-mgcb-editor

And result should be:

Result of installing MGCB editor

After that you will need to run below command, so that when you will try to open .mgcb file, it will open it directly in MGCB editor.

mgcb-editor --register

Note: If you get error in running above command, something like below image, then you will need to install the .Net 3.1 desktop application runtime, because as of writing this article (MonoGame is 3.8.0 version) MGCB requires only .Net 3.1.

MGCB editor register editor due to .Net desktop runtime dependency

You can fix by installing .Net Runtime 3.1 and .Net Desktop Runtime 3.1.0. You will need to install both of them. You can install from this link: .Net 3.1 runtime and Desktop runtime.

Install .Net 3.1 desktop runtime for MonoGame MGCB editor

Step 5: Create First Application

Now its time to create our first application and testing, to check if all things are working fine or not. Run below command at any preferred location:

dotnet new mgdesktopgl -o TestGame

This will create a folder named TestGame and inside you will find the source code of the game generated by MonoGame.

Step 6: Run the project

Now lets run it.

Ensure you are inside the source code location, if not run below command to go inside:

cd TestGame

Run below command:

dotnet run

It should show an empty window.

Happy coding.

One Comment

  1. Victor Victor

    You saved me

Leave a Reply

Your email address will not be published.