Dominoz

Dominoz is a simple Python-based Dominoes game consisting of a server and a client. It allows multiple players to connect, create lobbies, chat, and play Dominoes in ASCII format (also called CLI).

Here is the new Dominoz itch.io page

Features

• Server-client architecture
• Multiple lobbies supported
• Create, join, and leave lobbies
• Start games with 2–6 players per lobby
• ASCII-based Dominoes gameplay
• Chat with other players during your turn
• Player stats and levels tracked

Server list

• Propose servers on issues or dm simonko_11015

Public server:

Make sure your using the corect port, if none is below just tipe the 5555 deafult.

New official server!

dominoz.tailfe3e5f.ts.net

Installation

1. Clone the repository:

git clone https://github.com/Simonko-912/Dominoz.git
cd Dominoz

2. (Optional) Create a Python virtual environment:

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows

3. Install dependencies (only standard library is needed):

# No external libraries required
# Only Python 3.x is needed

Usage

Server

python server.py

• Follow the prompts to set server name, max players per lobby, max lobbies, and default difficulty.
• The server listens on port 5555 by default.

Client

python client.py

• Enter the server IP and port.
• Choose a username.
• Use commands to browse lobbies, create or join lobbies, play tiles, pass, chat, and quit.

Commands (Client)

• list → List server and lobby info
• create → Create a new lobby
• join <lobby_id> → Join an existing lobby
• leave → Leave current lobby
• start → Start the game (host only)
• status → Get current lobby/game status
• move <a> <b> <side> [chat] → Play a tile
• pass [chat] → Pass your turn
• quit → Quit the client

System Requirements

• Minimum:

• CPU: Any 32 bit or 64 bit cpu that can run a os that python supports.
• RAM: Atleast ~16 mb of free ram.
• GPU: Your system's minimum.
• Storage: Atleast ~50kb free for the python files and atleast ~7mb for the .exe
• Python 3.8.*

• Recommended:

• CPU: I5 6th gen
• RAM: 4 gb ram
• GPU: Intel HD graphics
• Storage: 100mb recomended
• Latest python

License

This project is dual-licensed under Apache 2.0 and GPLv3. You can choose either license for your use.

Contributing

Feel free to fork the project, open issues, or submit pull requests.
Suggestions for new features, bug fixes, or optimizations are welcome.