SadConsole 9.0.0-alpha8

This is a prerelease version of SadConsole.
There is a newer version of this package available.
See the version list below for details.
dotnet add package SadConsole --version 9.0.0-alpha8
                    
NuGet\Install-Package SadConsole -Version 9.0.0-alpha8
                    
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="9.0.0-alpha8" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SadConsole" Version="9.0.0-alpha8" />
                    
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 9.0.0-alpha8
                    
#r "nuget: SadConsole, 9.0.0-alpha8"
                    
#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@9.0.0-alpha8
                    
#: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=9.0.0-alpha8&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=SadConsole&version=9.0.0-alpha8&prerelease
                    
Install as a Cake Tool
  • Fixed a lot of LayeredScreenSurface bugs.
  • SFML: Renamed Renderers.LayeredScreenObject to Renderers.LayeredScreenSurface
  • Removed TintBeforeDrawCall. Not a good design.
  • Added SadConsole.Instructions.AnimatedValue to animate a value over a duration.
  • Updated SadConsole.Instructions.FadeTextSurfaceTint to use AnimatedValue.
  • Renderers.ScreenSurfaceRenderer has an Opaqueness setting to render a console surface transparent.
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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 was computed.  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 was computed.  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. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 is compatible. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.

SadConsole.Host.MonoGame

A graphics hosting library for SadConsole that targets MonoGame.

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.6.0 501 8/9/2025
10.6.0-debug 199 8/9/2025
10.5.0 2,351 12/7/2024
10.5.0-debug 222 12/7/2024
10.4.2 349 10/24/2024
10.4.2-debug 158 10/24/2024
10.4.1 1,520 6/13/2024
10.4.1-debug 252 6/13/2024
10.4.0 1,559 3/31/2024
10.4.0-debug 292 3/31/2024
10.0.3 693 3/14/2024
10.0.3-debug 344 3/14/2024
10.0.2 1,734 11/10/2023
10.0.2-debug 952 11/10/2023
10.0.1 818 11/10/2023
10.0.1-debug 779 11/10/2023
10.0.0 1,931 10/29/2023
10.0.0-debug 1,079 10/29/2023
10.0.0-beta3-debug 1,203 10/14/2023
10.0.0-beta3 1,154 10/14/2023
10.0.0-beta2-debug 1,152 10/11/2023
10.0.0-beta2 1,183 10/11/2023
10.0.0-beta1-debug 1,187 10/11/2023
10.0.0-beta1 1,217 10/11/2023
10.0.0-alpha4-debug 1,477 8/26/2023
10.0.0-alpha4 1,424 8/26/2023
10.0.0-alpha3-debug 1,337 8/26/2023
10.0.0-alpha3 1,347 8/26/2023
10.0.0-alpha2-debug 1,731 6/18/2023
10.0.0-alpha2 1,519 6/18/2023
10.0.0-alpha1-debug 1,676 6/4/2023
9.2.2 5,495 1/22/2022
9.2.2-debug 1,337 1/22/2022
9.2.1 2,635 1/4/2022
9.2.0 3,564 12/31/2021
9.2.0-debug 1,200 12/31/2021
9.1.1 6,167 8/7/2021
9.1.1-debug 1,397 8/7/2021
9.1.0 2,324 7/6/2021
9.1.0-debug 1,381 7/6/2021
9.0.0 4,994 6/6/2021
9.0.0-debug 1,389 6/6/2021
9.0.0-beta4 2,152 1/15/2021
9.0.0-beta3 2,335 12/19/2020
9.0.0-beta2 1,739 10/9/2020
9.0.0-beta1 1,860 8/1/2020
9.0.0-alpha9 1,895 7/25/2020
9.0.0-alpha8 1,546 7/13/2020
9.0.0-alpha7 1,983 7/11/2020
9.0.0-alpha6 1,966 5/28/2020
9.0.0-alpha5 1,738 5/26/2020
9.0.0-alpha4 1,557 5/1/2020
9.0.0-alpha3 1,772 5/1/2020
9.0.0-alpha2 1,675 3/14/2020
9.0.0-alpha1 2,156 1/26/2020
8.99.3 3,901 8/15/2020
8.99.3-debug 1,595 8/15/2020
8.99.2 1,931 7/14/2020
8.99.2-debug 1,547 7/14/2020
8.99.1 2,624 4/11/2020
8.99.1-debug 1,571 4/11/2020
8.99.0 2,674 11/27/2019
8.99.0-debug 1,562 11/27/2019
8.9.1 4,116 11/5/2019
8.9.1-debug 1,561 11/5/2019
8.9.0 2,431 9/7/2019 8.9.0 is deprecated because it is no longer maintained.
8.9.0-debug 1,852 9/7/2019 8.9.0-debug is deprecated because it is no longer maintained.
8.8.1 3,348 7/28/2019 8.8.1 is deprecated because it is no longer maintained.
8.8.1-debug 1,798 7/28/2019 8.8.1-debug is deprecated because it is no longer maintained.
8.8.0 2,622 7/27/2019 8.8.0 is deprecated because it is no longer maintained.
8.8.0-debug 1,740 7/27/2019 8.8.0-debug is deprecated because it is no longer maintained.
8.7.1 2,168 6/22/2019 8.7.1 is deprecated because it is no longer maintained.
8.7.1-debug 1,802 6/22/2019 8.7.1-debug is deprecated because it is no longer maintained.
8.7.0 2,005 6/22/2019 8.7.0 is deprecated because it is no longer maintained.
8.7.0-debug 1,835 6/22/2019 8.7.0-debug is deprecated because it is no longer maintained.
8.6.0 2,273 4/14/2019 8.6.0 is deprecated because it is no longer maintained.
8.6.0-debug 1,848 4/14/2019 8.6.0-debug is deprecated because it is no longer maintained.
8.5.0 2,164 4/2/2019 8.5.0 is deprecated because it is no longer maintained.
8.5.0-debug 1,875 4/2/2019 8.5.0-debug is deprecated because it is no longer maintained.
8.4.1 2,129 3/19/2019 8.4.1 is deprecated because it is no longer maintained.
8.4.1-debug 1,891 3/19/2019 8.4.1-debug is deprecated because it is no longer maintained.
8.4.0 2,001 3/17/2019 8.4.0 is deprecated because it is no longer maintained.
8.4.0-debug 1,867 3/17/2019 8.4.0-debug is deprecated because it is no longer maintained.
8.3.0 2,100 3/10/2019 8.3.0 is deprecated because it is no longer maintained.
8.3.0-debug 1,826 3/10/2019 8.3.0-debug is deprecated because it is no longer maintained.
8.2.0 2,137 3/2/2019 8.2.0 is deprecated because it is no longer maintained.
8.2.0-debug 1,915 3/2/2019 8.2.0-debug is deprecated because it is no longer maintained.
8.1.0 2,099 2/28/2019 8.1.0 is deprecated because it is no longer maintained.
8.1.0-debug 1,817 2/28/2019 8.1.0-debug is deprecated because it is no longer maintained.
8.0.0 2,210 2/24/2019 8.0.0 is deprecated because it is no longer maintained.
8.0.0-pre5 1,891 2/19/2019 8.0.0-pre5 is deprecated because it is no longer maintained.
8.0.0-pre4 1,918 1/31/2019 8.0.0-pre4 is deprecated because it is no longer maintained.
8.0.0-pre2 1,953 12/30/2018 8.0.0-pre2 is deprecated because it is no longer maintained.
8.0.0-pre1 1,912 12/30/2018 8.0.0-pre1 is deprecated because it is no longer maintained.
7.3.0 2,177 12/29/2018
7.2.0 2,361 11/20/2018 7.2.0 is deprecated because it is no longer maintained.
7.1.0 2,402 10/19/2018 7.1.0 is deprecated because it is no longer maintained.
7.0.4 2,356 9/8/2018 7.0.4 is deprecated because it is no longer maintained.
7.0.3 2,198 9/8/2018 7.0.3 is deprecated because it is no longer maintained.
7.0.2 2,581 8/31/2018 7.0.2 is deprecated because it is no longer maintained.
7.0.0 2,255 8/29/2018
7.0.0-pre1 2,034 8/22/2018 7.0.0-pre1 is deprecated because it is no longer maintained.
6.5.0 2,664 6/12/2018
6.4.11 2,780 4/13/2018 6.4.11 is deprecated because it is no longer maintained.
6.4.11-pre1 2,562 4/6/2018 6.4.11-pre1 is deprecated because it is no longer maintained.
6.4.10 2,737 3/18/2018 6.4.10 is deprecated because it is no longer maintained.
6.4.9 2,707 3/18/2018 6.4.9 is deprecated because it is no longer maintained.
6.4.8 2,675 3/18/2018 6.4.8 is deprecated because it is no longer maintained.
6.4.7 2,748 3/16/2018 6.4.7 is deprecated because it is no longer maintained.
6.4.6 2,971 2/14/2018 6.4.6 is deprecated because it is no longer maintained.
6.4.5 2,782 2/3/2018 6.4.5 is deprecated because it is no longer maintained.
6.4.3 2,639 11/14/2017 6.4.3 is deprecated because it is no longer maintained.
6.4.2 2,729 8/11/2017 6.4.2 is deprecated because it is no longer maintained.
6.4.1 2,550 8/10/2017 6.4.1 is deprecated because it is no longer maintained.
6.4.0 2,630 7/25/2017 6.4.0 is deprecated because it is no longer maintained.
6.3.0 2,649 6/9/2017 6.3.0 is deprecated because it is no longer maintained.
6.2.2 2,654 5/20/2017 6.2.2 is deprecated because it is no longer maintained.
6.2.1 2,754 4/23/2017 6.2.1 is deprecated because it is no longer maintained.
6.2.0 2,581 4/22/2017 6.2.0 is deprecated because it is no longer maintained.
6.1.4 2,568 4/17/2017 6.1.4 is deprecated because it is no longer maintained.
6.1.3 3,249 4/3/2017 6.1.3 is deprecated because it is no longer maintained.
6.1.2 2,556 4/1/2017 6.1.2 is deprecated because it is no longer maintained.
6.1.1 2,501 4/1/2017 6.1.1 is deprecated because it is no longer maintained.
6.1.0 2,512 3/31/2017 6.1.0 is deprecated because it is no longer maintained.
6.0.1 2,645 3/19/2017 6.0.1 is deprecated because it is no longer maintained.
6.0.0 2,364 3/18/2017

A lot of structual changes to split out rendering from SadConsole. You now need to add SadConsole.Host.MonoGame
or SadConsole.Host SFML to your project.

Major changes:

- Object model has changed a lot. Console types no longer inherit from CellSurface and are based on a few different base
classes and interfaces implemented through ScreenObject. Everything in SadConsole is now a ScreenObject.

- Console.Surface represents the cell surface of the console. Extension methods are provided so that you can use
Console.Print and related methods. If you coding inside a Console instance though, the extension methods only work if
you qualify the call with this.Print.

- Font/FontMaster are now merged into a single type: Font.

- Font sizes are always represented in an X,Y value now, and are separate from the font itself. This means every
console has a Font and FontSize property now instead of a single Font property.

- All UI objects were moved into the SadConsole.UI namespace.

- The theme system was overhauled (and mostly backported to SadConsole v8).

- A lot of misc name changes, swapping out where it specified Console and substituting ScreenObject. For example,
SadConsole.Input.MouseConsoleState is now SadConsole.Input.MouseScreenObjectState

- SadConsole.Global had a lot of changes and not longer exists. Properties from Global are now available on SadConsole.GameHost.Instance.

- SadConsole.GameHost.Instance.Screen is the root console displayed on the screen to which all other objects are attached to. It is a console
and you cannot change this. It makes it simpler for new users. To disable it, disable the renderer: SadConsole.GameHost.Instance.Screen.Renderer = null.
Objects added to the Children collection will still work; SadConsole will not bother drawing the root console itself.

- ControlConsole no longer provides the logic for the GUI system. This was migrated to a new component: ControlHost. The host can be added to any console
you want to be able to display controls. The ControlsConsole type remains for ease of use. It now provides a ControlHostComponent property with direct
access to the component instance automatically added to the console.

- Entity is no longer a Console but a ScreenObject.

- App creation is slightly different with a few names migrated and events for draw/update callbacks

 SadConsole.Game.Create(80, 25);
 SadConsole.Game.Instance.OnStart = Init;
 SadConsole.Game.Instance.FrameUpdate += Instance_FrameUpdate;
 SadConsole.Game.Instance.Run();
 SadConsole.Game.Instance.Dispose();