Screen Management

The ScreenManager helps you to split your game into multiple GameScreens with their own Dispose(), Initialize(), LoadContent(), UnloadContent(), Update(GameTime gameTime), and, Draw(GameTime gameTime) methods.

Installation

The ScreenManager and GameScreen classes are available in the MonoGame.Extended library. MonoGame.Extended is distributed via a NuGet package. You can add the NuGet package to your C# project through your IDE of choice (Visual Studio, Xamarin Studio, Rider, etc) or through the Command Line Interface (CLI) using the dotnet command.

dotnet add package MonoGame.Extended

Usage

We start by including the Screens and Transitions namespaces.

using MonoGame.Extended.Screens;
using MonoGame.Extended.Screens.Transitions;

Next, we implement our GameScreens. In this example, we use 2 GameScreens with a sprite that follows the Cursor.

Screen 1

public class MyScreen1 : GameScreen
{
private new Game1 Game => (Game1) base.Game;
private Texture2D _logo;
private SpriteFont _font;
private Vector2 _position = new Vector2(50,50);
public MyScreen1(Game1 game) : base(game) { }
public override void LoadContent()
{
base.LoadContent();
_font = Game.Content.Load<SpriteFont>("font");
_logo = Game.Content.Load<Texture2D>("logo-mge");
}
public override void Update(GameTime gameTime)
{
_position = Vector2.Lerp(_position, Mouse.GetState().Position.ToVector2(), 1f * gameTime.GetElapsedSeconds());
}
public override void Draw(GameTime gameTime)
{
Game.GraphicsDevice.Clear(new Color(16, 139, 204));
Game.SpriteBatch.Begin();
Game.SpriteBatch.DrawString(_font, nameof(MyScreen1), new Vector2(10,10), Color.White);
Game.SpriteBatch.Draw(_logo, _position, Color.White);
Game.SpriteBatch.End();
}
}

Screen 2

public class MyScreen2 : GameScreen
{
private new Game1 Game => (Game1)base.Game;
private Texture2D _logo;
private SpriteFont _font;
private Vector2 _position = new Vector2(50, 50);
public MyScreen2(Game1 game) : base(game) { }
public override void LoadContent()
{
base.LoadContent();
_font = Game.Content.Load<SpriteFont>("font");
_logo = Game.Content.Load<Texture2D>("logo-mg");
}
public override void Update(GameTime gameTime)
{
_position = Vector2.Lerp(_position, Mouse.GetState().Position.ToVector2(), 1f * gameTime.GetElapsedSeconds());
}
public override void Draw(GameTime gameTime)
{
Game.GraphicsDevice.Clear(Color.White);
Game.SpriteBatch.Begin();
Game.SpriteBatch.DrawString(_font, nameof(MyScreen2), new Vector2(10, 10), Color.Orange);
Game.SpriteBatch.Draw(_logo, _position, Color.White);
Game.SpriteBatch.End();
}
}

Next, we define our ScreenManger in our Game class.

private readonly ScreenManager _screenManager;

Which we then assign and register as GameComponent in the constructor.

_screenManager = new ScreenManager();
Components.Add(_screenManager);

Then we define the following methods to load the screens.

private void LoadScreen1()
{
_screenManager.LoadScreen(new MyScreen1(this), new FadeTransition(GraphicsDevice, Color.Black));
}
private void LoadScreen2()
{
_screenManager.LoadScreen(new MyScreen2(this), new FadeTransition(GraphicsDevice, Color.Black));
}

Which we then call from the Initialize and Update methods.

protected override void Initialize()
{
base.Initialize();
LoadScreen1();
}
protected override void Update(GameTime gameTime)
{
KeyboardState keyboardState = Keyboard.GetState();
if (keyboardState.IsKeyDown(Keys.Escape))
Exit();
if (keyboardState.IsKeyDown(Keys.D1))
{
LoadScreen1();
}
else if (keyboardState.IsKeyDown(Keys.D2))
{
LoadScreen2();
}
base.Update(gameTime);
}
Edit this page