README.md

December 15, 2023 · View on GitHub

dotnet-console-games

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	0
Rock Paper Scissors	0
Dice Game	0	^{*Community Contribution}
Flash Cards	0
Quick Draw	1
Tug Of War	1
Whack A Mole	1
Tic Tac Toe	1
Simon	1
Roll And Move	1
Beep Pad	1	^{Only Supported On Windows OS}
Draw	1
Tower Of Hanoi	1
Clicker	1
Hangman	2
Lights Out	2
Wordle	2
Memory	2
Connect 4	2
Minesweeper	2
Wumpus World	2
Rythm	2
Type	2
Drive	2
Sliding Puzzle	2
Snake	3
Word Search	3
Hurdles	3
Pong	3
Flappy Bird	3
Oligopoly	3	^{*Community Contribution}
Reversi	3
Darts	3
Yahtzee	4
Tanks	4
Helicopter	4
2048	4
Sudoku	4
Mancala	4
Bound	4
Tents	4
Battleship	4
Checkers	4	^{*Community Contribution}
Duck Hunt	5	^{*Community Contribution}
Blackjack	5
Fighter	5
Maze	5
PacMan	5
Gravity	5
Tetris	5	^{*Community Contribution}
Shmup	5	^{Only Supported On Windows OS}
Role Playing Game	6
Console Monsters	7	^{*Community Collaboration} ^{Work In Progress}
First Person Shooter	8	^{Only Supported On Windows OS}

^{*Weight: A relative rating for how advanced the source code is.}
^{*Community Contribution: 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:

^{Hosted On GitHub Pages}

Local Setup

Clone the repository or download the repository and unzip the contents. dotnet-console-games should build with any .NET build process, such as one of the following:

Visual Studio _[Expand]

Install Visual Studio if not already installed.

Open the dotnet-console-games.slnf file in Visual Studio.

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.

Visual Studio Code _[Expand]

Install the .NET SDK if not already installed.

Install Visual Studio Code if not already installed.

Open the root folder of the repository in Visual Studio Code.

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]

Install the .NET SDK if not already installed.

Run the games using the dotnet run --project <PROJECT> command where <PROJECT> 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# _{August 1, 2020}

dotnet Console Games Tips And Tricks _{April 7, 2022}

Get Involved

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

Have any questions? Start a new discussion.

Find a bug or have a suggestion? Open an issue.

Want to chat with the developer(s)? Join the discord server.

Want to contribute? Look for open issues you can help with.

_{Supported by the}