https://github.com/kelvinleandro/shellstation

A 2-player CLI "videogame" built with Python using sockets for real-time multiplayer gameplay.
https://github.com/kelvinleandro/shellstation

2-player 2-players-game checkers chess chess-game cli connect-four connect4 draughts python python-3 python3 socket socket-programming sockets tic-tac-toe tic-tac-toe-multiplayer tic-tac-toe-python tictactoe

Last synced: 10 months ago
JSON representation

A 2-player CLI "videogame" built with Python using sockets for real-time multiplayer gameplay.

• Host: GitHub
• URL: https://github.com/kelvinleandro/shellstation
• Owner: kelvinleandro
• License: mit
• Created: 2024-05-01T00:11:34.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-08-20T00:22:28.000Z (over 1 year ago)
• Last Synced: 2025-02-14T22:45:58.534Z (12 months ago)
• Topics: 2-player, 2-players-game, checkers, chess, chess-game, cli, connect-four, connect4, draughts, python, python-3, python3, socket, socket-programming, sockets, tic-tac-toe, tic-tac-toe-multiplayer, tic-tac-toe-python, tictactoe
• Language: Python
• Homepage:
• Size: 114 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ShellStation

ShellStation is a command-line game suite. It allows users to select and play games through an interactive menu, directly via command-line arguments, or run automated tests/matches for each game.

## Previews

![shellstation menu](img/menu.png)

![chess](img/chess.png) ![draughts](img/draughts.png) ![tictactoe](img/tictactoe.png) ![connect four](img/connect4.png) ![hangman](img/hangman.png) ![battleship](img/battleship.png)

## Features

- **Interactive Game Selection**: Users can choose which game to play through a simple command-line menu.

- **Direct Game Launch**: Users have the option to directly start a game using command-line arguments.

- **Automated Tests**: Users can run automated matches for each game using command-line arguments.

- **Extensible**: Adding new games is as straightforward as updating the `ShellStation` class and adding the game files.

## Prerequisites

Before running ShellStation, ensure you have Python installed on your system. The games are built with Python 3.11.

## Installation

1. Clone the repository:

    ```bash

    git clone https://github.com/kelvinleandro/shellstation

    ```

2. Change to the project directory:

    ```bash

    cd shellstation

    ```

3. Install the required libraries:

    ```bash

    pip install -r requirements.txt

    ```

## Usage

To start ShellStation in interactive mode:

```bash

python shellstation.py

```

To directly start a specific game:

```bash

python shellstation.py -g chess

```

The game will ask you to specify a host and port. For example, you can enter:

```bash

localhost 9999

```

To run automated tests for a specific game:

```bash

python shellstation.py -t chess

```

### Available commands

- `-g`, `--game`: Start with the specified game. Options: battleship, chess, connect4, draughts, hangman, tictactoe.

- `-t`, `--test`: Run the specified test. Options: battleship, chess, connect4, draughts, hangman, tictactoe.

## Tests

`test` folder contains simulated matches for each game using `pyautogui`.

To run the automated matches:

```bash

python shellstation.py -t GAME_OPTION

```

## License

This project is licensed under the MIT License - see the LICENSE file for details.