SadConsole.Debug.MonoGame 10.8.0-debug

This is a prerelease version of SadConsole.Debug.MonoGame.
There is a newer version of this package available.
See the version list below for details.
dotnet add package SadConsole.Debug.MonoGame --version 10.8.0-debug
                    
NuGet\Install-Package SadConsole.Debug.MonoGame -Version 10.8.0-debug
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SadConsole.Debug.MonoGame" Version="10.8.0-debug" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SadConsole.Debug.MonoGame" Version="10.8.0-debug" />
                    
Directory.Packages.props
<PackageReference Include="SadConsole.Debug.MonoGame" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SadConsole.Debug.MonoGame --version 10.8.0-debug
                    
#r "nuget: SadConsole.Debug.MonoGame, 10.8.0-debug"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SadConsole.Debug.MonoGame@10.8.0-debug
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SadConsole.Debug.MonoGame&version=10.8.0-debug&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=SadConsole.Debug.MonoGame&version=10.8.0-debug&prerelease
                    
Install as a Cake Tool

SadConsole Logo

Chat on discord NuGet

SadConsole is a C#-based .NET cross-platform terminal, ascii, console, game engine. It simulates these types of programs and with it you can make ascii-styled games for modern platforms. At its heart, SadConsole is really a giant tile-based game engine. However, its object model is conceptually similar to a traditional console app.

While SadConsole is a generic library that doesn't provide any rendering capabilities, "host" libraries are provided that add renderers to SadConsole. The two hosts provided by this library are for SadConsole.Host.MonoGame and SadConsole.Host.SFML. When adding a host library to your project, you don't need to reference the base SadConsole package. If you use MonoGame, you'll also need to add a rendering NuGet package, such as MonoGame.Framework.DesktopGL.

SadConsole currently targets .NET 8, .NET 9, and .NET 10

For the latest changes in this release, see the notes below

Features

Here are some of the features SadConsole supports:

  • Show any number of consoles of any size.
  • Uses graphical tile-based images to build out an ASCII-character font with support for more than 256 characters.
  • Fonts are simply sprite sheet tilesets tied to ascii codes, you can use full graphical tiles if you want.
  • Use more than one font file. However, each console is restricted to a single font.
  • Full GUI system for interactive controls such as list boxes, buttons, and text fields.
  • Importers for DOS ANSI files, TheDraw text fonts, RexPaint, and Playscii.
  • Animated consoles and instruction system to chain commands together.
  • String encoding system for colors and effects while printing.
  • Entity support for drawing thousands of movable objects on the screen
  • Translating images to text-blocks.
  • Keyboard and mouse support.
  • Highly customizable framework.
String display and parsing

string pic

GUI library

GUI library pic

Scrolling

scrolling console

Latest changes

  • [Core] ColoredGlyph deserialization correctly handles decorators.
  • [Core] LayeredSurface layers can be hidden now.
  • [Controls] Rendering controls on a surface with a viewport now correctly handles mouse input and drawing of the controls.
  • [Core] AnimatedValue was sending the finished event before it was completed.
  • [Core] AnimatedScreenSurface didn't set the new frame sizes when deserialized.
  • [Core] ITitle moved from debug library to core.
  • [Host] Hosts have new logic for converting images into surfaces.
  • [MonoGame] Render steps now use local spritebatches, which can help with memory allocation in some cases.
  • [Core] Entities now have IHasLayer from the primitives library which matches the ZIndex property.
  • [Core] Entities expose the IHasID interface now.
  • [Core] EntityManager correctly handles animated entity visibility.
  • [UI] ListBox and ComboBox have generic versions now.
  • [UI] ComboBox Placement of the dropdown is correctly kept on the screen.
  • [Core] Changing Game.Instance.DefaultFont and DefaultFontSize now update all objects on the screen with the new defaults when they use the defaults.
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
10.8.0 89 1/19/2026
10.8.0-debug 77 1/19/2026
10.7.0 168 11/15/2025
10.7.0-debug 156 11/15/2025
10.6.0 198 8/9/2025
10.6.0-debug 153 8/9/2025
10.5.0 383 12/7/2024
10.5.0-debug 163 12/7/2024

Initial release