Update Monogame 3.8.4

This article explains how to update your MonoGame project to the version 3.8.4.

In order to update your MonoGame project from the version 3.8.0 to the version 3.8.4, follow this step-by-step guide.

1. Upgrade to .NET 8.0

First, migrate your C# project from .NET Core 3.1 to .NET 8.0. If you haven’t done this yet, see this post for a step-by-step guide.

2. MonoGame NuGet packages

Remove the out-of-date packages:

dotnet remove package MonoGame.Framework.DesktopGL
dotnet remove package MonoGame.Content.Builder.Task

Install the 3.8.4 version of MonoGame:

dotnet add package MonoGame.Framework.DesktopGL --version 3.8.4
dotnet add package MonoGame.Content.Builder.Task --version 3.8.4

3. MGCB and MGCB Editor

When migrating from 3.8.0, uninstall the global versions of the MGCB tools:

dotnet tool uninstall dotnet-mgcb -g
dotnet tool uninstall dotnet-2mgfx -g
dotnet tool uninstall dotnet-mgcb-editor -g

Do not run the dotnet tool install on 3.8.4.

In your .config folder, update or create a dotnet-tools.json file. Update its content to use 3.8.4 tools:

{
  "version": 1,
  "isRoot": true,
  "tools": {
    "dotnet-mgcb": {
      "version": "3.8.4",
      "commands": [
        "mgcb"
      ]
    },
    "dotnet-mgcb-editor": {
      "version": "3.8.4",
      "commands": [
        "mgcb-editor"
      ]
    },
    "dotnet-mgcb-editor-linux": {
      "version": "3.8.4",
      "commands": [
        "mgcb-editor-linux"
      ]
    },
    "dotnet-mgcb-editor-windows": {
      "version": "3.8.4",
      "commands": [
        "mgcb-editor-windows"
      ]
    },
    "dotnet-mgcb-editor-mac": {
      "version": "3.8.4",
      "commands": [
        "mgcb-editor-mac"
      ]
    }
  }
}