Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 16 days 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 (8 months ago)
- Default Branch: main
- Last Pushed: 2024-08-20T00:22:28.000Z (5 months ago)
- Last Synced: 2024-11-05T12:17:59.031Z (2 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.