SadConsole 9.0.0-alpha5

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-alpha5
                    
NuGet\Install-Package SadConsole -Version 9.0.0-alpha5
                    
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-alpha5" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SadConsole" Version="9.0.0-alpha5" />
                    
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-alpha5
                    
#r "nuget: SadConsole, 9.0.0-alpha5"
                    
#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-alpha5
                    
#: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-alpha5&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=SadConsole&version=9.0.0-alpha5&prerelease
                    
Install as a Cake Tool
  • Moved SadConsole.Global into the GameHost.
  • Rewrote the UI control framework, removing the need for ControlsConsole. Any console can now add the UI.ControlHost component and support controls.
    • ControlsConsole still exists as a simple way to automatically add the ControlHost.
  • Settings now expose the defaults for UseKeyboard and UseMouse for screen objects.
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 was computed. 
.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 270 8/9/2025
10.6.0-debug 111 8/9/2025
10.5.0 1,873 12/7/2024
10.5.0-debug 147 12/7/2024
10.4.2 311 10/24/2024
10.4.2-debug 132 10/24/2024
10.4.1 1,460 6/13/2024
10.4.1-debug 196 6/13/2024
10.4.0 1,478 3/31/2024
10.4.0-debug 240 3/31/2024
10.0.3 575 3/14/2024
10.0.3-debug 292 3/14/2024
10.0.2 1,642 11/10/2023
10.0.2-debug 907 11/10/2023
10.0.1 790 11/10/2023
10.0.1-debug 751 11/10/2023
10.0.0 1,865 10/29/2023
10.0.0-debug 1,014 10/29/2023
10.0.0-beta3-debug 1,138 10/14/2023
10.0.0-beta3 1,095 10/14/2023
10.0.0-beta2-debug 1,093 10/11/2023
10.0.0-beta2 1,121 10/11/2023
10.0.0-beta1-debug 1,126 10/11/2023
10.0.0-beta1 1,152 10/11/2023
10.0.0-alpha4-debug 1,418 8/26/2023
10.0.0-alpha4 1,353 8/26/2023
10.0.0-alpha3-debug 1,272 8/26/2023
10.0.0-alpha3 1,283 8/26/2023
10.0.0-alpha2-debug 1,663 6/18/2023
10.0.0-alpha2 1,454 6/18/2023
10.0.0-alpha1-debug 1,571 6/4/2023
9.2.2 5,280 1/22/2022
9.2.2-debug 1,282 1/22/2022
9.2.1 2,548 1/4/2022
9.2.0 3,423 12/31/2021
9.2.0-debug 1,163 12/31/2021
9.1.1 5,906 8/7/2021
9.1.1-debug 1,358 8/7/2021
9.1.0 2,226 7/6/2021
9.1.0-debug 1,342 7/6/2021
9.0.0 4,767 6/6/2021
9.0.0-debug 1,350 6/6/2021
9.0.0-beta4 2,058 1/15/2021
9.0.0-beta3 2,244 12/19/2020
9.0.0-beta2 1,671 10/9/2020
9.0.0-beta1 1,792 8/1/2020
9.0.0-alpha9 1,803 7/25/2020
9.0.0-alpha8 1,509 7/13/2020
9.0.0-alpha7 1,845 7/11/2020
9.0.0-alpha6 1,885 5/28/2020
9.0.0-alpha5 1,663 5/26/2020
9.0.0-alpha4 1,520 5/1/2020
9.0.0-alpha3 1,705 5/1/2020
9.0.0-alpha2 1,637 3/14/2020
9.0.0-alpha1 2,041 1/26/2020
8.99.3 3,868 8/15/2020
8.99.3-debug 1,555 8/15/2020
8.99.2 1,891 7/14/2020
8.99.2-debug 1,511 7/14/2020
8.99.1 2,581 4/11/2020
8.99.1-debug 1,523 4/11/2020
8.99.0 2,632 11/27/2019
8.99.0-debug 1,523 11/27/2019
8.9.1 4,001 11/5/2019
8.9.1-debug 1,521 11/5/2019
8.9.0 2,383 9/7/2019 8.9.0 is deprecated because it is no longer maintained.
8.9.0-debug 1,803 9/7/2019 8.9.0-debug is deprecated because it is no longer maintained.
8.8.1 3,245 7/28/2019 8.8.1 is deprecated because it is no longer maintained.
8.8.1-debug 1,756 7/28/2019 8.8.1-debug is deprecated because it is no longer maintained.
8.8.0 2,550 7/27/2019 8.8.0 is deprecated because it is no longer maintained.
8.8.0-debug 1,698 7/27/2019 8.8.0-debug is deprecated because it is no longer maintained.
8.7.1 2,116 6/22/2019 8.7.1 is deprecated because it is no longer maintained.
8.7.1-debug 1,761 6/22/2019 8.7.1-debug is deprecated because it is no longer maintained.
8.7.0 1,952 6/22/2019 8.7.0 is deprecated because it is no longer maintained.
8.7.0-debug 1,788 6/22/2019 8.7.0-debug is deprecated because it is no longer maintained.
8.6.0 2,231 4/14/2019 8.6.0 is deprecated because it is no longer maintained.
8.6.0-debug 1,800 4/14/2019 8.6.0-debug is deprecated because it is no longer maintained.
8.5.0 2,122 4/2/2019 8.5.0 is deprecated because it is no longer maintained.
8.5.0-debug 1,814 4/2/2019 8.5.0-debug is deprecated because it is no longer maintained.
8.4.1 2,085 3/19/2019 8.4.1 is deprecated because it is no longer maintained.
8.4.1-debug 1,849 3/19/2019 8.4.1-debug is deprecated because it is no longer maintained.
8.4.0 1,950 3/17/2019 8.4.0 is deprecated because it is no longer maintained.
8.4.0-debug 1,820 3/17/2019 8.4.0-debug is deprecated because it is no longer maintained.
8.3.0 2,055 3/10/2019 8.3.0 is deprecated because it is no longer maintained.
8.3.0-debug 1,779 3/10/2019 8.3.0-debug is deprecated because it is no longer maintained.
8.2.0 2,086 3/2/2019 8.2.0 is deprecated because it is no longer maintained.
8.2.0-debug 1,868 3/2/2019 8.2.0-debug is deprecated because it is no longer maintained.
8.1.0 2,049 2/28/2019 8.1.0 is deprecated because it is no longer maintained.
8.1.0-debug 1,772 2/28/2019 8.1.0-debug is deprecated because it is no longer maintained.
8.0.0 2,157 2/24/2019 8.0.0 is deprecated because it is no longer maintained.
8.0.0-pre5 1,840 2/19/2019 8.0.0-pre5 is deprecated because it is no longer maintained.
8.0.0-pre4 1,867 1/31/2019 8.0.0-pre4 is deprecated because it is no longer maintained.
8.0.0-pre2 1,911 12/30/2018 8.0.0-pre2 is deprecated because it is no longer maintained.
8.0.0-pre1 1,871 12/30/2018 8.0.0-pre1 is deprecated because it is no longer maintained.
7.3.0 2,133 12/29/2018
7.2.0 2,311 11/20/2018 7.2.0 is deprecated because it is no longer maintained.
7.1.0 2,351 10/19/2018 7.1.0 is deprecated because it is no longer maintained.
7.0.4 2,300 9/8/2018 7.0.4 is deprecated because it is no longer maintained.
7.0.3 2,155 9/8/2018 7.0.3 is deprecated because it is no longer maintained.
7.0.2 2,530 8/31/2018 7.0.2 is deprecated because it is no longer maintained.
7.0.0 2,215 8/29/2018
7.0.0-pre1 1,987 8/22/2018 7.0.0-pre1 is deprecated because it is no longer maintained.
6.5.0 2,600 6/12/2018
6.4.11 2,721 4/13/2018 6.4.11 is deprecated because it is no longer maintained.
6.4.11-pre1 2,503 4/6/2018 6.4.11-pre1 is deprecated because it is no longer maintained.
6.4.10 2,678 3/18/2018 6.4.10 is deprecated because it is no longer maintained.
6.4.9 2,638 3/18/2018 6.4.9 is deprecated because it is no longer maintained.
6.4.8 2,611 3/18/2018 6.4.8 is deprecated because it is no longer maintained.
6.4.7 2,689 3/16/2018 6.4.7 is deprecated because it is no longer maintained.
6.4.6 2,905 2/14/2018 6.4.6 is deprecated because it is no longer maintained.
6.4.5 2,713 2/3/2018 6.4.5 is deprecated because it is no longer maintained.
6.4.3 2,579 11/14/2017 6.4.3 is deprecated because it is no longer maintained.
6.4.2 2,668 8/11/2017 6.4.2 is deprecated because it is no longer maintained.
6.4.1 2,490 8/10/2017 6.4.1 is deprecated because it is no longer maintained.
6.4.0 2,571 7/25/2017 6.4.0 is deprecated because it is no longer maintained.
6.3.0 2,585 6/9/2017 6.3.0 is deprecated because it is no longer maintained.
6.2.2 2,597 5/20/2017 6.2.2 is deprecated because it is no longer maintained.
6.2.1 2,701 4/23/2017 6.2.1 is deprecated because it is no longer maintained.
6.2.0 2,519 4/22/2017 6.2.0 is deprecated because it is no longer maintained.
6.1.4 2,512 4/17/2017 6.1.4 is deprecated because it is no longer maintained.
6.1.3 3,198 4/3/2017 6.1.3 is deprecated because it is no longer maintained.
6.1.2 2,498 4/1/2017 6.1.2 is deprecated because it is no longer maintained.
6.1.1 2,440 4/1/2017 6.1.1 is deprecated because it is no longer maintained.
6.1.0 2,456 3/31/2017 6.1.0 is deprecated because it is no longer maintained.
6.0.1 2,575 3/19/2017 6.0.1 is deprecated because it is no longer maintained.
6.0.0 2,311 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 seperate 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();