Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/dotnet/dotnet-console-games

Game examples implemented as .NET console applications primarily for providing education and inspiration. :)
https://github.com/dotnet/dotnet-console-games

2048 blazor cli-game console-game csharp dotnet examples flappy-bird game games hangman ideas maze minesweeper pacman rpg snake sudoku terminal-game wordle

Last synced: 3 months ago
JSON representation

Game examples implemented as .NET console applications primarily for providing education and inspiration. :)

Lists

README

        




dotnet-console-games


GitHub repo
Language C#
Target Framework
Discord
License
Towel


Game examples implemented as .NET console applications primarily for providing education and inspiration. :)

> **Recommendation**

> Play the games, pick a game you like, and try to code the game yourself from scratch.

|Game|\*_Weight_|Notes                                                                      |
|:-|:-|:-|
|[Guess A Number](Projects/Guess%20A%20Number)|0|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Guess%20A%20Number) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Guess%20A%20Number%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Rock Paper Scissors](Projects/Rock%20Paper%20Scissors)|0|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Rock%20Paper%20Scissors) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Rock%20Paper%20Scissors%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Dice Game](Projects/Dice%20Game)|0|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Dice%20Game) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Dice%20Game%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
*_[Community Contribution](https://github.com/dotnet/dotnet-console-games/pull/31)_|
|[Flash Cards](Projects/Flash%20Cards)|0|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Flash%20Cards) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Flash%20Cards%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Quick Draw](Projects/Quick%20Draw)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Quick%20Draw) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Quick%20Draw%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Tug Of War](Projects/Tug%20Of%20War)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Tug%20Of%20War) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Tug%20Of%20War%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Whack A Mole](Projects/Whack%20A%20Mole)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Whack%20A%20Mole) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Whack%20A%20Mole%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Tic Tac Toe](Projects/Tic%20Tac%20Toe)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Tic%20Tac%20Toe) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Tic%20Tac%20Toe%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Simon](Projects/Simon)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Simon) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Simon%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Roll And Move](Projects/Roll%20And%20Move)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Roll%20And%20Move) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Roll%20And%20Move%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Beep Pad](Projects/Beep%20Pad)|1|[![Status](https://github.com/dotnet/dotnet-console-games/workflows/Beep%20Pad%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
[![Warning](https://raw.githubusercontent.com/dotnet/dotnet-console-games/main/.github/resources/warning-icon.svg)](#) _Only Supported On Windows OS_|
|[Draw](Projects/Draw)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Draw) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Draw%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Tower Of Hanoi](Projects/Tower%20Of%20Hanoi)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Tower%20Of%20Hanoi) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Tower%20Of%20Hanoi%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Clicker](Projects/Clicker)|1|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Clicker) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Clicker%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Hangman](Projects/Hangman)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Hangman) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Hangman%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Lights Out](Projects/Lights%20Out)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Lights%20Out) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Lights%20Out%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Wordle](Projects/Wordle)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Wordle) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Wordle%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Memory](Projects/Memory)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Memory) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Memory%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Connect 4](Projects/Connect%204)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Connect%204) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Connect%204%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Minesweeper](Projects/Minesweeper)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Minesweeper) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Minesweeper%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Wumpus World](Projects/Wumpus%20World)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Wumpus%20World) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Wumpus%20World%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Rythm](Projects/Rythm)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Rythm) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Rythm%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Type](Projects/Type)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Type) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Type%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Drive](Projects/Drive)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Drive) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Drive%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Sliding Puzzle](Projects/Sliding%20Puzzle)|2|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Sliding%20Puzzle) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Sliding%20Puzzle%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Snake](Projects/Snake)|3|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Snake) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Snake%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Word Search](Projects/Word%20Search)|3|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Word%20Search) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Word%20Search%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Hurdles](Projects/Hurdles)|3|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Hurdles) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Hurdles%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Pong](Projects/Pong)|3|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Pong) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Pong%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Flappy Bird](Projects/Flappy%20Bird)|3|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Flappy%20Bird) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Flappy%20Bird%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Oligopoly](Projects/Oligopoly)|3|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Oligopoly) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Oligopoly%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
*_[Community Contribution](https://github.com/dotnet/dotnet-console-games/pull/72)_|
|[Reversi](Projects/Reversi)|3|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Reversi) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Reversi%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Darts](Projects/Darts)|3|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Darts) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Darts%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Yahtzee](Projects/Yahtzee)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Yahtzee) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Yahtzee%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Tanks](Projects/Tanks)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Tanks) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Tanks%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Helicopter](Projects/Helicopter)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Helicopter) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Helicopter%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[2048](Projects/2048)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/2048) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/2048%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Sudoku](Projects/Sudoku)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Sudoku) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Sudoku%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Mancala](Projects/Mancala)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Mancala) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Mancala%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Bound](Projects/Bound)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Bound) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Bound%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Tents](Projects/Tents)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Tents) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Tents%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Battleship](Projects/Battleship)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Battleship) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Battleship%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Checkers](Projects/Checkers)|4|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Checkers) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Checkers%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
*_[Community Contribution](https://github.com/dotnet/dotnet-console-games/pull/40)_|
|[Duck Hunt](Projects/Duck%20Hunt)|5|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Duck%20Hunt) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Duck%20Hunt%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
*_[Community Contribution](https://github.com/dotnet/dotnet-console-games/pull/39)_|
|[Blackjack](Projects/Blackjack)|5|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Blackjack) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Blackjack%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Fighter](Projects/Fighter)|5|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Fighter) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Fighter%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Maze](Projects/Maze)|5|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Maze) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Maze%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[PacMan](Projects/PacMan)|5|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/PacMan) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/PacMan%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Gravity](Projects/Gravity)|5|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Gravity) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Gravity%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Tetris](Projects/Tetris)|5|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Tetris) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Tetris%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
*_[Community Contribution](https://github.com/dotnet/dotnet-console-games/pull/89)_|
|[Shmup](Projects/Shmup)|5|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Shmup) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Shmup%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
[![Warning](https://raw.githubusercontent.com/dotnet/dotnet-console-games/main/.github/resources/warning-icon.svg)](#) _Only Supported On Windows OS_|
|[Role Playing Game](Projects/Role%20Playing%20Game)|6|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Role%20Playing%20Game) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Role%20Playing%20Game%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)|
|[Console Monsters](Projects/Console%20Monsters)|7|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/Console%20Monsters) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/Console%20Monsters%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
*_Community Collaboration_
[![Warning](https://raw.githubusercontent.com/dotnet/dotnet-console-games/main/.github/resources/warning-icon.svg)](#) _Work In Progress_|
|[First Person Shooter](Projects/First%20Person%20Shooter)|8|[![Play Now](.github/resources/play-badge.svg)](https://dotnet.github.io/dotnet-console-games/First%20Person%20Shooter) [![Status](https://github.com/dotnet/dotnet-console-games/workflows/First%20Person%20Shooter%20Build/badge.svg)](https://github.com/dotnet/dotnet-console-games/actions)
[![Warning](https://raw.githubusercontent.com/dotnet/dotnet-console-games/main/.github/resources/warning-icon.svg)](#) _Only Supported On Windows OS_|

\*_**Weight**: A relative rating for how advanced the source code is._


\*_**[Community Contribution](https://github.com/dotnet/dotnet-console-games/issues?q=label%3A%22community+contribution%22)**: Special thanks to everyone who contributed games!_


\*_**Community Collaboration**: Games where multiple members of the community participated in the development!_


You can play the games in your browser:



Play Now



Hosted On GitHub Pages

## Local Setup

[Clone the repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) or [download the repository](https://github.com/dotnet/dotnet-console-games/archive/main.zip) and unzip the contents. `dotnet-console-games` should build with any .NET build process, such as one of the following:

Visual Studio [Expand]

> 1. Install [Visual Studio](https://visualstudio.microsoft.com/) if not already installed.
>
> 2. Open the [![File](.github/resources/file-16.svg)](#) **`dotnet-console-games.slnf`** file in Visual Studio.
>
> 3. Run the games with the `Debug`->`Start Debugging` (default hotkey `F5`) option in the menu strip. You can switch games by right clicking the projects in the solution explorer and using the `Set as Startup Project` option.
>
> **Note** This is optional, but [here are some settings you can change in Visual Studio](https://gist.github.com/ZacharyPatten/693f35653f6c21fbe6c85444792e524b).

Visual Studio Code [Expand]

> 1. Install the [.NET SDK](https://dotnet.microsoft.com/download) if not already installed.
>
> 2. Install [Visual Studio Code](https://visualstudio.microsoft.com/) if not already installed.
>
> 3. Open the [![Directory](.github/resources/file-directory-16.svg)](#) **`root folder`** of the repository in Visual Studio Code.
>
> 4. Run the games using the `Start Debugging` green triangle button (default hotkey `F5`) in the `Run and Debug` tab. You can switch games in the drop down next to the `Start Debugging` button.
>
> **Note** The following files are included in the repository:
> - `.vscode/extensions.json` recommends Vistual Studio Code extension dependencies
> - `.vscode/launch.json` includes the configurations for debugging the examples
> - `.vscode/settings.json` automatically applies settings to the workspace
> - `.vscode/tasks.json` includes the commands to build the projects
>
> **Note** You will be prompted to install the necessary Visual Studio Code extensions when you open the folder:
> - **ms-dotnettools.csharp** C# support

Command Line [Expand]

> 1. Install the [.NET SDK](https://dotnet.microsoft.com/download) if not already installed.
>
> 2. Run the games using the [`dotnet run --project ` command](https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-run) where `` is the file path to one of the `.csproj` files. For example, running the `dotnet run --project Projects/Drive/Drive.csproj` command from the root of the repository will run the `Drive` game.

## Relevant Articles

[Beginner's Guide To Console Input In C#](https://github.com/ZacharyPatten/ZacharyPatten/blob/main/Articles/2020-08-01.md) August 1, 2020

[dotnet Console Games Tips And Tricks](https://github.com/ZacharyPatten/ZacharyPatten/blob/main/Articles/2022-04-07.md) April 7, 2022

## Get Involved

Want to show support? You can star the github repository.

Have any questions? [Start a new discussion](https://github.com/dotnet/dotnet-console-games/discussions/new).

Find a bug or have a suggestion? [Open an issue](https://github.com/dotnet/dotnet-console-games/issues/new).

Want to chat with the developer(s)? [Join the discord server](https://discord.gg/4XbQbwF).

Want to contribute? [Look for open issues you can help with](https://github.com/dotnet/dotnet-console-games/issues).




Supported by the