SadConsole 10.9.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package SadConsole --version 10.9.0
                    


                    

                
NuGet\Install-Package SadConsole -Version 10.9.0
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" Version="10.9.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="SadConsole" Version="10.9.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="SadConsole" />
                    


                            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 --version 10.9.0
                    


                    

                
#r "nuget: SadConsole, 10.9.0"
#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@10.9.0
#: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&version=10.9.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=SadConsole&version=10.9.0
                    


                            Install as a Cake Tool

SadConsole Logo

Chat on discord NuGet CI Tests

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 change log.

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
  • 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

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 (10)

Showing the top 5 NuGet packages that depend on SadConsole:

Package Downloads
SadConsole.Host.MonoGame

A graphics hosting library for SadConsole that targets MonoGame.
SadConsole.Extended

A library of common classes that extend SadConsole with new controls, windows, and more.
SadConsole.Host.SFML

A graphics hosting library for SadConsole that targets SFML.
SadConsole.GoRogueHelpers

A helper library for SadConsole games built with GoRogue.
TheSadRogue.Integration

An official integration library for using GoRogue and SadConsole together to create a roguelike.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on SadConsole:

Repository Stars
Thraka/SadConsole
A .NET ascii/ansi console engine written in C# for MonoGame and SFML. Create your own text roguelike (or other) games!
Version Downloads Last Updated
10.9.0 38 3/29/2026
10.8.0 615 1/19/2026
10.8.0-debug 163 1/19/2026
10.7.0 681 11/15/2025
10.7.0-debug 238 11/15/2025
10.6.0 1,554 8/9/2025
10.6.0-debug 245 8/9/2025
10.5.0 2,589 12/7/2024
10.5.0-debug 284 12/7/2024
10.4.2 425 10/24/2024
10.4.2-debug 206 10/24/2024
10.4.1 1,603 6/13/2024
10.4.1-debug 308 6/13/2024
10.4.0 1,667 3/31/2024
10.4.0-debug 339 3/31/2024
10.0.3 842 3/14/2024
10.0.3-debug 414 3/14/2024
10.0.2 1,796 11/10/2023
10.0.2-debug 1,005 11/10/2023
0.0.1-test 32 3/29/2026
Loading failed

- GitHub publishing moved to tag-triggered workflows.
- Added experimental RowFontSurface with per-row fonts and sizes.
- SadFonts can load old VGA-style binary font files.
- Added new terminal parser (SadConsole.TerminalConsole).
- Overhauled ImGui integration; debug and raw ImGui now ship together.
- Added SFML support for ImGui integration.
- Fade now respects RemoveOnFinished (default true).
- Added FadeOut and FadeIn transitions.
- SFML upgraded to 3.x with rewritten, faster sprite batcher.
- Converted solution files from SLN to SLNX.