SadConsole 10.7.0

.NET 8.0

dotnet add package SadConsole --version 10.7.0

NuGet\Install-Package SadConsole -Version 10.7.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.7.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="SadConsole" Version="10.7.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.7.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: SadConsole, 10.7.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.7.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.7.0
                    

                            Install as a Cake Addin

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

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

SadConsole Logo

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

Cleaned up various warnings and XML comments.
[Core] BlinkChar supports starting on or off now.
[Core] Fix crash when resizing a surface with a smaller height and same width while the clear flag is set.
[Core] ScreenObject positioning can be scaled by an amount, such as a font size or any other size.
[Core] SadFont.ToString now returns the font name.
[Core] AnimatedScreenObject.ResyncFrameSizes method added correctly set the size of a new frame to the first frame in the animation.
[Core] When splashscreen closes, call update on new the new Screen. Fixes a bug with ControlsHost not drawing the first state of controls.
[UI] Fixed a long-standing bug with CompositeControl where visual focus wasn't removed from a child control when the mouse moved out of the window.
[Extended] Added the config builder extension PopupGlyphPicker.
[SFML] Upgraded to the latest SFML.Net version.
[FNA] Upgraded to FNA 25.11.

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.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Coroutine (>= 2.1.5)
- Newtonsoft.Json (>= 13.0.4)
- TheSadRogue.Primitives (>= 1.6.0)
net8.0
- Coroutine (>= 2.1.5)
- Newtonsoft.Json (>= 13.0.4)
- TheSadRogue.Primitives (>= 1.6.0)
net9.0
- Coroutine (>= 2.1.5)
- Newtonsoft.Json (>= 13.0.4)
- TheSadRogue.Primitives (>= 1.6.0)

NuGet packages (8)

Showing the top 5 NuGet packages that depend on SadConsole:

Package	Downloads
SadConsole.Extended A library of common classes that extend SadConsole with new controls, windows, and more.	30.1K
SadConsole.Host.MonoGame A graphics hosting library for SadConsole that targets MonoGame.	29.5K
SadConsole.Host.SFML A graphics hosting library for SadConsole that targets SFML.	20.6K
SadConsole.GoRogueHelpers A helper library for SadConsole games built with GoRogue.	9.3K
TheSadRogue.Integration An official integration library for using GoRogue and SadConsole together to create a roguelike.	6.6K

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!	1.3K

Version	Downloads	Last Updated
10.7.0	292	11/15/2025
10.7.0-debug	199	11/15/2025
10.6.0	1,030	8/9/2025
10.6.0-debug	216	8/9/2025
10.5.0	2,475	12/7/2024
10.5.0-debug	240	12/7/2024
10.4.2	375	10/24/2024
10.4.2-debug	171	10/24/2024
10.4.1	1,548	6/13/2024
10.4.1-debug	270	6/13/2024
10.4.0	1,599	3/31/2024
10.4.0-debug	303	3/31/2024
10.0.3	775	3/14/2024
10.0.3-debug	378	3/14/2024
10.0.2	1,750	11/10/2023
10.0.2-debug	972	11/10/2023
10.0.1	832	11/10/2023
10.0.1-debug	796	11/10/2023
10.0.0	1,946	10/29/2023
10.0.0-debug	1,096	10/29/2023
10.0.0-beta3-debug	1,217	10/14/2023
10.0.0-beta3	1,177	10/14/2023
10.0.0-beta2-debug	1,171	10/11/2023
10.0.0-beta2	1,203	10/11/2023
10.0.0-beta1-debug	1,206	10/11/2023
10.0.0-beta1	1,236	10/11/2023
10.0.0-alpha4-debug	1,488	8/26/2023
10.0.0-alpha4	1,442	8/26/2023
10.0.0-alpha3-debug	1,352	8/26/2023
10.0.0-alpha3	1,353	8/26/2023
10.0.0-alpha2-debug	1,749	6/18/2023
10.0.0-alpha2	1,549	6/18/2023
10.0.0-alpha1-debug	1,702	6/4/2023
9.2.2	5,529	1/22/2022
9.2.2-debug	1,366	1/22/2022
9.2.1	2,664	1/4/2022
9.2.0	3,594	12/31/2021
9.2.0-debug	1,231	12/31/2021
9.1.1	6,198	8/7/2021
9.1.1-debug	1,424	8/7/2021
9.1.0	2,346	7/6/2021
9.1.0-debug	1,410	7/6/2021
9.0.0	5,039	6/6/2021
9.0.0-debug	1,417	6/6/2021
9.0.0-beta4	2,186	1/15/2021
9.0.0-beta3	2,368	12/19/2020
9.0.0-beta2	1,777	10/9/2020
9.0.0-beta1	1,888	8/1/2020
9.0.0-alpha9	1,925	7/25/2020
9.0.0-alpha8	1,578	7/13/2020
9.0.0-alpha7	2,015	7/11/2020
9.0.0-alpha6	1,999	5/28/2020
9.0.0-alpha5	1,779	5/26/2020
9.0.0-alpha4	1,589	5/1/2020
9.0.0-alpha3	1,795	5/1/2020
9.0.0-alpha2	1,707	3/14/2020
9.0.0-alpha1	2,194	1/26/2020
8.99.3	3,942	8/15/2020
8.99.3-debug	1,625	8/15/2020
8.99.2	1,967	7/14/2020
8.99.2-debug	1,579	7/14/2020
8.99.1	2,657	4/11/2020
8.99.1-debug	1,601	4/11/2020
8.99.0	2,706	11/27/2019
8.99.0-debug	1,595	11/27/2019
8.9.1	4,152	11/5/2019
8.9.1-debug	1,601	11/5/2019
8.9.0	2,492	9/7/2019
8.9.0-debug	1,917	9/7/2019
8.8.1	3,422	7/28/2019
8.8.1-debug	1,851	7/28/2019
8.8.0	2,677	7/27/2019
8.8.0-debug	1,785	7/27/2019
8.7.1	2,225	6/22/2019
8.7.1-debug	1,852	6/22/2019
8.7.0	2,068	6/22/2019
8.7.0-debug	1,894	6/22/2019
8.6.0	2,317	4/14/2019
8.6.0-debug	1,906	4/14/2019
8.5.0	2,212	4/2/2019
8.5.0-debug	1,929	4/2/2019
8.4.1	2,177	3/19/2019
8.4.1-debug	1,942	3/19/2019
8.4.0	2,060	3/17/2019
8.4.0-debug	1,927	3/17/2019
8.3.0	2,150	3/10/2019
8.3.0-debug	1,876	3/10/2019
8.2.0	2,188	3/2/2019
8.2.0-debug	1,982	3/2/2019
8.1.0	2,159	2/28/2019
8.1.0-debug	1,865	2/28/2019
8.0.0	2,273	2/24/2019
8.0.0-pre5	1,952	2/19/2019
8.0.0-pre4	1,973	1/31/2019
8.0.0-pre2	2,007	12/30/2018
8.0.0-pre1	1,957	12/30/2018
7.3.0	2,213	12/29/2018
7.2.0	2,414	11/20/2018
7.1.0	2,467	10/19/2018
7.0.4	2,412	9/8/2018
7.0.3	2,247	9/8/2018
7.0.2	2,636	8/31/2018
7.0.0	2,288	8/29/2018
7.0.0-pre1	2,088	8/22/2018
6.5.0	2,743	6/12/2018
6.4.11	2,874	4/13/2018
6.4.11-pre1	2,650	4/6/2018
6.4.10	2,835	3/18/2018
6.4.9	2,804	3/18/2018
6.4.8	2,776	3/18/2018
6.4.7	2,840	3/16/2018
6.4.6	3,082	2/14/2018
6.4.5	2,883	2/3/2018
6.4.3	2,721	11/14/2017
6.4.2	2,811	8/11/2017
6.4.1	2,631	8/10/2017
6.4.0	2,706	7/25/2017
6.3.0	2,726	6/9/2017
6.2.2	2,731	5/20/2017
6.2.1	2,828	4/23/2017
6.2.0	2,660	4/22/2017
6.1.4	2,652	4/17/2017
6.1.3	3,319	4/3/2017
6.1.2	2,629	4/1/2017
6.1.1	2,581	4/1/2017
6.1.0	2,586	3/31/2017
6.0.1	2,726	3/19/2017
6.0.0	2,424	3/18/2017

- Cleaned up various warnings and XML comments.
- `BlinkChar` supports starting on or off now.
- Fix crash when resizing a surface with a smaller height and same width while the clear flag is set.
- `ScreenObject` positioning can be scaled by an amount, such as a font size or any other size.
- `SadFont.ToString` now returns the font name.
- `AnimatedScreenObject.ResyncFrameSizes` method added correctly set the size of a new frame to the first frame in the animation.
- Fixed a long-standing bug with `CompositeControl` where visual focus wasn't removed from a child control when the mouse moved out of the window.
- When splashscreen closes, call update on new the new Screen. Fixes a bug with `ControlsHost` not drawing the first state of controls.