Get started

This guide will give you the steps to install MonoGame, get a basic project setup, and build an output that you can publish.

Install

  1. Get the .NET 6.0 SDK.
    • Test that dotnet is installed correctly:
    dotnet --version
    
  2. Get the MonoGame templates:
    dotnet new --install MonoGame.Templates.CSharp
    

Create a new game

Replace MyGame with your game’s name in the following two command:

dotnet new mgdesktopgl -o MyGame
cd MyGame

Run

dotnet run

Publish

You can publish on Windows, Mac, and Linux using:

dotnet publish -c Release -r win-x64 -o artifacts/windows --self-contained
dotnet publish -c Release -r osx-x64 -o artifacts/osx --self-contained
dotnet publish -c Release -r linux-x64 -o artifacts/linux --self-contained

You’ll find the output in:

artifacts/windows
artifacts/osx
artifacts/linux

You can zip those folders to share your game.

Read more

You can read more getting started info from the official MonoGame docs.


Now that you have a project, the next step is to setup a development environment. Developing with Visual Studio Code.

Edit this page on GitHub