MonoGame Content Builder

By: MonoGame Foundation Nov 6, 2025

The new Content Builder Project is one the hottest things coming in preview in the MonoGame 3.8.5 release, aiming to greatly simplify asset management for MonoGame projects (removing the need for a separate DotNet tool, goodbye MGCB-Editor) and enable more advanced features related to the management and compilation for MonoGame projects.

Check out the recent Code Time stream where this was discussed

The MonoGame team showcased the new Content Builder project, highlighting why it is critical to use some form of curated asset management when building your content for multiple platforms, highlighting the complexities in platform targetting and how the Content Pipeline greatly simplifies asset maintenance and delivery.

More incoming

Content is getting a specific focus for 3.8.5, so expect more advanced guidance for managing content, especially if you want to target consoles. We plan to expose all the fundamental issues the team encounter when porting other projects to Console and beyond.

Watch on:

Short on time? check out the recent Shorts we produced!

If you do not have the spare 1+ hours to see everything, we have also produced several shorts to "get you there quicker" (then you can watch the full video when you have time):

Documentation - Newly released

As of the weekend of 11/09 - we have just published the early release of the new Content Builder Project documentation.

develop release only

The latest release of the new Content Builder Project is only available in the latest 3.8.5-develop releases, starting from 3.8.5-develop-13.

See the instructions here for how to install the preview project templates and update your project to use 3.8.5-develop (preview) releases.

This guide will walk you through all the current workings of the new Content Builder Project solution and how it can greatly improve your asset management with MonoGame projects, including:

  1. What is the ContentBuilder?
  2. Getting Started
  3. Understanding ContentBuilderParams
  4. Creating Your ContentCollection
  5. Including and Excluding Content
  6. Working with Importers and Processors

Subject to change

This documentation is a work in progress and subject to change.

While every effort will be made during the 3.8.5 preview to keep this documentation up to date, check back often for reference and log issues for corrections to assist the team in its development.

Support

  • Financially - several tiers and options available for GitHub, PayPal and Patreon.
  • The MonoGame Store - MonoGame branded gear and merchandise.

Get Involved

  • Code, we accept Pull Requests.
  • Help in the Community discord and beyond (we also love blog posts).
  • Bounties, Fix bugs and add features faster as well as get paid for your work :)

Onwards and Upwards

The MonoGame Foundation team