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.
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.
// Install SadConsole as a Cake Addin
#addin nuget:?package=SadConsole&version=9.0.0-alpha5&prerelease

// Install SadConsole as a Cake Tool
#tool nuget:?package=SadConsole&version=9.0.0-alpha5&prerelease
  • 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. 
.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
SadCanvas

A canvas class that works with SadConsole and MonoGame host.

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.

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 XNA. Create your own text roguelike (or other) games!
Version Downloads Last updated
10.4.0 268 3/31/2024
10.4.0-debug 143 3/31/2024
10.0.3 314 3/14/2024
10.0.3-debug 200 3/14/2024
10.0.2 1,434 11/10/2023
10.0.2-debug 831 11/10/2023
10.0.1 717 11/10/2023
10.0.1-debug 687 11/10/2023
10.0.0 1,462 10/29/2023
10.0.0-debug 939 10/29/2023
10.0.0-beta3-debug 1,049 10/14/2023
10.0.0-beta3 988 10/14/2023
10.0.0-beta2-debug 999 10/11/2023
10.0.0-beta2 1,013 10/11/2023
10.0.0-beta1-debug 1,025 10/11/2023
10.0.0-beta1 1,041 10/11/2023
10.0.0-alpha4-debug 1,317 8/26/2023
10.0.0-alpha4 1,246 8/26/2023
10.0.0-alpha3-debug 1,168 8/26/2023
10.0.0-alpha3 1,182 8/26/2023
10.0.0-alpha2-debug 1,546 6/18/2023
10.0.0-alpha2 1,330 6/18/2023
10.0.0-alpha1-debug 1,433 6/4/2023
9.2.2 4,794 1/22/2022
9.2.2-debug 1,144 1/22/2022
9.2.1 2,373 1/4/2022
9.2.0 3,200 12/31/2021
9.2.0-debug 1,059 12/31/2021
9.1.1 5,091 8/7/2021
9.1.1-debug 1,240 8/7/2021
9.1.0 2,022 7/6/2021
9.1.0-debug 1,234 7/6/2021
9.0.0 4,456 6/6/2021
9.0.0-debug 1,212 6/6/2021
9.0.0-beta4 1,885 1/15/2021
9.0.0-beta3 1,993 12/19/2020
9.0.0-beta2 1,516 10/9/2020
9.0.0-beta1 1,637 8/1/2020
9.0.0-alpha9 1,653 7/25/2020
9.0.0-alpha8 1,362 7/13/2020
9.0.0-alpha7 1,665 7/11/2020
9.0.0-alpha6 1,707 5/28/2020
9.0.0-alpha5 1,508 5/26/2020
9.0.0-alpha4 1,384 5/1/2020
9.0.0-alpha3 1,544 5/1/2020
9.0.0-alpha2 1,473 3/14/2020
9.0.0-alpha1 1,825 1/26/2020
8.99.3 3,626 8/15/2020
8.99.3-debug 1,426 8/15/2020
8.99.2 1,743 7/14/2020
8.99.2-debug 1,381 7/14/2020
8.99.1 2,368 4/11/2020
8.99.1-debug 1,388 4/11/2020
8.99.0 2,407 11/27/2019
8.99.0-debug 1,386 11/27/2019
8.9.1 3,737 11/5/2019
8.9.1-debug 1,375 11/5/2019
8.9.0 2,121 9/7/2019
8.9.0-debug 1,571 9/7/2019
8.8.1 2,957 7/28/2019
8.8.1-debug 1,552 7/28/2019
8.8.0 2,306 7/27/2019
8.8.0-debug 1,497 7/27/2019
8.7.1 1,873 6/22/2019
8.7.1-debug 1,552 6/22/2019
8.7.0 1,732 6/22/2019
8.7.0-debug 1,573 6/22/2019
8.6.0 1,993 4/14/2019
8.6.0-debug 1,579 4/14/2019
8.5.0 1,900 4/2/2019
8.5.0-debug 1,605 4/2/2019
8.4.1 1,858 3/19/2019
8.4.1-debug 1,638 3/19/2019
8.4.0 1,725 3/17/2019
8.4.0-debug 1,574 3/17/2019
8.3.0 1,819 3/10/2019
8.3.0-debug 1,567 3/10/2019
8.2.0 1,861 3/2/2019
8.2.0-debug 1,640 3/2/2019
8.1.0 1,823 2/28/2019
8.1.0-debug 1,563 2/28/2019
8.0.0 1,907 2/24/2019
8.0.0-pre5 1,610 2/19/2019
8.0.0-pre4 1,649 1/31/2019
8.0.0-pre2 1,692 12/30/2018
8.0.0-pre1 1,658 12/30/2018
7.3.0 1,980 12/29/2018
7.2.0 2,062 11/20/2018
7.1.0 2,105 10/19/2018
7.0.4 2,054 9/8/2018
7.0.3 1,919 9/8/2018
7.0.2 2,248 8/31/2018
7.0.0 2,028 8/29/2018
7.0.0-pre1 1,740 8/22/2018
6.5.0 2,216 6/12/2018
6.4.11 2,263 4/13/2018
6.4.11-pre1 2,066 4/6/2018
6.4.10 2,227 3/18/2018
6.4.9 2,179 3/18/2018
6.4.8 2,147 3/18/2018
6.4.7 2,214 3/16/2018
6.4.6 2,423 2/14/2018
6.4.5 2,237 2/3/2018
6.4.3 2,215 11/14/2017
6.4.2 2,309 8/11/2017
6.4.1 2,125 8/10/2017
6.4.0 2,209 7/25/2017
6.3.0 2,229 6/9/2017
6.2.2 2,234 5/20/2017
6.2.1 2,341 4/23/2017
6.2.0 2,157 4/22/2017
6.1.4 2,155 4/17/2017
6.1.3 2,850 4/3/2017
6.1.2 2,124 4/1/2017
6.1.1 2,090 4/1/2017
6.1.0 2,103 3/31/2017
6.0.1 2,224 3/19/2017
6.0.0 2,032 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();