Skip to content

MonoGo-Engine/MonoGo

Repository files navigation

Banner

Welcome to MonoGo!

Version NuGet

A cross-platform C# 2D game engine built on top of MonoGame.

Setup

Automatic

The easiest and recommended way to start using the engine is by installing the Visual Studio templates:

  • dotnet new install MonoGo.Templates

Manual

You can also add the packages manually:

  • dotnet add package MonoGo.Engine
  • dotnet add package MonoGo.Engine.DesktopGL or dotnet add package MonoGo.Engine.WindowsDX

Modules

Install optional modules depending on your project needs:


AI & Agent Support (AGENTS.md)

If you are using AI coding assistants (like Cursor, GitHub Copilot, or CLI agents) to work with or contribute to MonoGo, please point them to the AGENTS.md file located in the root directory. This file contains crucial architectural rules, code style guidelines, and mandatory reference implementations specifically tailored for LLMs to ensure they write idiomatic MonoGo engine code.


Features

  • Graphics pipeline and automated batch/vertex buffer management.
  • Easy sprite sheet animations.
  • Texture packing.
  • Sprite groups and dynamic graphics loading.
  • Input management with GamePad support.
  • Timers, alarms, cameras, and state machines.
  • Coroutines.
  • Hybrid Entity-Component (EC) architecture.
  • Scene system with layers.
  • GameDev-focused math library.
  • Lightweight collision detection.
  • Integrated post-processing management (includes Bloom & Color Grading effects).
  • Powerful particle effect system.
  • Extensive GUI system.
  • Enhanced content management.
  • FMOD audio support (as a standalone library).

Sample Project

The included sample project contains many more demos, but here are a few impressions to get you started:

Color Picker Tiled PostFX

Credits

For license information please take a look at the License.txt file.

Now Have Fun with MonoGo!

Banner