Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/salif/cli-games

Games in the terminal
https://github.com/salif/cli-games

cli-game cli-games console console-game console-games game games hacktoberfest hacktoberfest-accepted hacktoberfest2024 hangman maze-escape maze-game rock-paper-scissors snake-game terminal terminal-game terminal-games tic-tac-toe tictactoe

Last synced: 6 days ago
JSON representation

Games in the terminal

Awesome Lists containing this project

README

        

# CLI Games

> Games in the terminal

[![Run on Repl.it](https://repl.it/badge/github/salif/cli-games)](https://repl.it/@AllAwesome497/cli-games)

CLI Games is a community-driven collection of games that could be run in your terminal! Currently this project has many games including,
- Hangman
- Maze Escape
- Text Adventures
- Tic-Tac-Toe
- Rock, Paper, Scissors

*And more in the future!*

## How to Install?

Installation is very simple.

```bash
#Clone the repo
git clone https://github.com/salif/cli-games.git
cd cli-games
#install the dependences for the games (for Unix systems and Lunix)
bash install-games.sh
```

## How to Play?

### for Windows

After cloning, run `dir` to get a list of available directories of games. Then navigate to your favourite game using the `cd` command

**Eg:** `cd Hangman`

Read the **README** file in the respective directory to get more instruction about installation and playing.
Most of the games support different languages (including `node-js` and `python`) and the choice is yours!

### for Unix/Linux

just type
```bash
bash games.sh
```
and select the game by the number or 'e' for exit. If a game has a JS and Python version, you can choose which one you prefer you to play

## Contributing

Want to contribute this project? We are happy to accept your contributions! You can do the following to contribute us

- Making / Implementing suggestions and new features
- Creating / Fixing bug reports
- Improving the performance
- [Creating new games](#creating-new-games)
- Spreading the word!

### Creating new games

Before creating a new game, please check if it is available already, or somebody is working on creating that game. Then make sure to create a new issue to make sure others are OK with it. If you got approval for your suggestion, then move one! Code your game and create a PR with the new changes. We'll be happy to introduce your new game :smile:

**This project is driven on community basis. So we are happy to accept your contributions a lot!**