Xyaneon.Games.Cards 1.2.0

.NET Standard 2.0
NuGet\Install-Package Xyaneon.Games.Cards -Version 1.2.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.
dotnet add package Xyaneon.Games.Cards --version 1.2.0
<PackageReference Include="Xyaneon.Games.Cards" Version="1.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Xyaneon.Games.Cards --version 1.2.0
#r "nuget: Xyaneon.Games.Cards, 1.2.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Xyaneon.Games.Cards as a Cake Addin
#addin nuget:?package=Xyaneon.Games.Cards&version=1.2.0

// Install Xyaneon.Games.Cards as a Cake Tool
#tool nuget:?package=Xyaneon.Games.Cards&version=1.2.0


License NuGet Nuget downloads .NET

Package Icon

A .NET Standard 2.0 library for playing cards (standard and custom), draw piles and shuffling.


To use this library, you must first install the NuGet package for it, then add the following using statement at the top of each C# source file where you plan on using it:

using Xyaneon.Games.Cards;

The two most important classes in this library are Card and DrawPile<TCard>. If you are implementing your own custom card game application using this library, then your custom card class should inherit from the Card class, and you should supply that subclass type as the generic type parameter for your DrawPile<TCard> instances.

For example, you would declare your custom MyCard class as follows:

using Xyaneon.Games.Cards;

public class MyCard : Card
    // Your code here.

...and then set up a draw pile like so:

var myDrawPile = new DrawPile<MyCard>();

Note that draw piles are considered to be face-down by default. If you have a face-up pile of cards (for e.g., a discard pile), then you have to specify it in the constructor using the isFaceUp optional parameter:

var myDrawPile = new DrawPile<MyCard>(true);

After the draw pile is created, you can do several things with it, including:

// Count the number of cards in the draw pile.
int cardCount = myDrawPile.Cards.Count;

// Draw a card. An InvalidOperationException will be thrown if the pile is
// empty.
MyCard drawnCard = myDrawPile.Draw();

// Draw three cards (or at least as many as we can if there are fewer).
IEnumerable<MyCard> drawnCards = myDrawPile.DrawAtMost(3);

// Place a card on top of the draw pile.
var cardToPlaceOnTop = new MyCard();

// Shuffle the draw pile using the default shuffling algorithm.

// Shuffle the draw pile using a custom shuffling algorithm you implemented.
IShuffleAlgorithm<MyCard> algorithm = new MyShuffleAlgorithm();

// Shuffle one draw pile into another.
DrawPile<MyCard> other = myObject.YourMethodToGetAnotherDrawPile();
myDrawPile.ShuffleIn(other); // other is now empty, with its contents added to myDrawPile.

For a full list of the available properties and methods, see the source code for the DrawPile<TCard> class.

For an example usage of these classes, see the standard 52-card implementation provided with this library under the Xyaneon.Games.Cards.StandardPlayingCards namespace. This is also provided for your convenience if you want to implement a card game which uses the standard 52-card deck.


This library is free and open-source software provided under the MIT license. Please see the LICENSE.txt file for details.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Xyaneon.Games.Cards:

Package Downloads

A .NET Standard metapackage for card and board game functionality and components, such as dice and cards.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.0 100 7/2/2022
1.1.0 86 6/5/2022
1.0.0 84 5/29/2022
0.4.0 490 12/5/2019
0.3.0 448 2/10/2019
0.2.0 428 2/9/2019
0.1.1 450 2/3/2019
0.1.0 431 2/2/2019