Setup

This page assumes you have an existing MonoGame project. This can be an empty project or an existing game.

At the time of this writing Gum + MonoGame has been tested on a variety of platforms including DesktopGL, DirectX, and mobile. It has also been used with Nez and Kni. If your particular platform is not supported please contact us on Discord and we will do our best to add support.

Adding Gum NuGet Packages

1. Open your MonoGame project in your preferred IDE.

2. Add the Gum.MonoGame NuGet package

   

   Add Gum.MonoGame NuGet Package to your project

Initializing Gum

To initialize Gum, modify your Game project (such as Game1.cs) so that it includes the following calls:

protected override void Initialize()
{
    MonoGameGum.GumService.Default.Initialize(this.GraphicsDevice);
    base.Initialize();
}

protected override void Update(GameTime gameTime)
{
    MonoGameGum.GumService.Default.Update(this, gameTime);
    base.Update(gameTime);
}

protected override void Draw(GameTime gameTime)
{
    GraphicsDevice.Clear(Color.CornflowerBlue);
    MonoGameGum.GumService.Default.Draw();
    base.Draw(gameTime);
}

Testing Gum

To test that you have successfully added Gum to the project, modify your Initialize method:

protected override void Initialize()
{
    MonoGameGum.GumService.Default.Initialize(this.GraphicsDevice);

    var rectangle = new ColoredRectangleRuntime();
    rectangle.Width = 100;
    rectangle.Height = 100;
    rectangle.Color = Color.White;
    rectangle.AddToManagers(SystemManagers.Default, null);

    base.Initialize();
}

White ColoredRectangleRuntime in game

If everything is initialized correctly, you should see a white rectangle at the top-left of the screen.

Loading Gum Projects

This page shows the minimum code needed to get Gum up and running in your project. If you want to load a Gum project created in the Gum tool, see the Loading a Gum Project page.

Downloading the Gum Tool

The Gum tool can be used to create Gum projects which can be loaded into your MonoGame project. To download and run the Gum tool, see the Setup page.