AmanoTeam/UnuRobot
4
0
Fork 0
mirror of https://github.com/AmanoTeam/UnuRobot.git synced 2025-12-14 20:27:44 -03:00
Code Issues Projects Releases Packages Wiki Activity
A Telegram bot that lets you play Mau Mau (UNO) via inline queries, now rebuilt from scratch with the powerful Hydrogram Telegram bot library for improved performance and functionality.
47 commits 7 branches 0 tags 7.7 MiB
Find a file
Exact
Rian Felipe Celestrino eed72829f0 feat: Renomear cartas de "draw_four" para "draw_gfour" no arquivo nomercy.json
2024-12-12 15:18:38 -03:00
cards feat: Renomear cartas de "draw_four" para "draw_gfour" no arquivo nomercy.json 2024-12-12 15:18:38 -03:00
locales feat: Add draw one card feature and enhance game model with developer and bluff states 2024-12-12 13:57:06 -03:00
unu feat: Add draw one card feature and enhance game model with developer and bluff states 2024-12-12 13:57:06 -03:00
.editorconfig add editorconfig config 2024-06-06 20:39:41 -03:00
.gitignore chore: Add cache.pkl to .gitignore and implement caching in __main__.py 2024-06-12 12:15:38 -03:00
config-example.py add minimum_players and timeout 2024-06-12 11:51:44 -03:00
LICENCE docs: Update README with detailed bot features and usage instructions; 2024-12-12 15:15:24 -03:00
pyproject.toml add pyproject.toml and apply ruff lints 2024-06-06 21:02:54 -03:00
README.rst docs: Update README with detailed bot features and usage instructions; 2024-12-12 15:15:24 -03:00

README.rst

Unu

A Telegram bot for playing the UNO cards game

Description

image

Unu is a Telegram bot that allows users to play the famous UNO card game directly in the chat. The bot manages the game, distributes the cards, and enforces the rules, providing a fun and interactive experience.

Features

  • Creation of game rooms
  • Automatic card distribution
  • Turn management
  • Enforcement of UNO game rules
  • Support for Telegram commands to interact with the bot

How to use

  • Add the bot t.me/unurobot to your Telegram chat
  • Create a game room with the command /new
  • Wait for other players to join the room via the button or the command /join
  • Start the game with the command /start or via the button
  • Have fun playing UNO!
  • If you want to customize the game such as cards and rules, use the command /settings

How to run the bot locally

  • Clone the repository using the command git clone https://github.com/AmanoTeam/UnuRobot.git
  • Create a virtual environment with the command python -m venv venv
  • Activate the virtual environment with the command source venv/bin/activate
  • Install the dependencies with the command pip install .
  • Copy the config-example.py file to config.py and edit the environment variables
  • Run the bot with the command python -m unu

Contributions

Contributions are welcome! Feel free to open an issue or submit a pull request.

License

This project is licensed under the MIT license. See the LICENSE file for more information.