Telegram bot to play Mau with your friends in telegram chats
Find a file
2025-10-17 16:43:22 +04:00
.github Add dependabot 2025-05-25 13:08:22 +04:00
assets Add Readme 2025-05-26 00:05:03 +04:00
mautg Chore: Fix some type errors 2025-10-17 16:43:22 +04:00
.env.dist Move source from mauno repo 2025-05-25 13:03:19 +04:00
.gitignore Initial commit 2025-04-29 10:35:46 +04:00
.python-version Init uv 2025-05-25 13:01:52 +04:00
CODE_OF_CONDUCT.md Add code of conduc file 2025-05-25 13:09:13 +04:00
LICENSE Initial commit 2025-04-29 10:35:46 +04:00
pyproject.toml Remove fastapi+uvicorn from dependecies 2025-10-17 16:36:10 +04:00
README.md Add Readme 2025-05-26 00:05:03 +04:00
uv.lock Remove fastapi+uvicorn from dependecies 2025-10-17 16:36:10 +04:00

Mau;tg

License Bot version Python version Docs GitHub stars Ruff

Mau;tg - Telegram бот для совместной игры в mau с друзьями в групповых чатах.

Немного особенностей:

  • 🎮 Легко научиться играть
  • 🍓 Много необычных и весёлых игровых правил
  • Система Лобби
  • 🌟 Несколько вариантов колод
  • 📝 Журнал игровых событий
  • 🃏 Красивые нарисованные карточки

Бот использует inline query клавиатуру для карт. Будьте готовы что после игры остаётся море сообщений в чате. Зато это же так весело!

Начинаем играть

Telegram

Если вы заинтересованы, то давайте же сыграем вместе!

Поиграть с нами можно здесь: @mau_room.

Вот ссылочка на основного бота: @mili_maubot. Ещё можете подписаться на канал Salormoon, чтобы следить за обновлениями проекта и прочими новостями команды.

Всё что нужно знать для начала игры:

  1. Добавляем бота в чат с друзьями
  2. Вводим /game для создания нового лобби
  3. Когда все игроки присоединились, нажимаем начать (/start_game)
  4. Весело играем партию
  5. Ошалеваем от количества сообщений и безудержного веселья
  6. Создаём ещё одну комнатку и повторяем с 3 шага

Ознакомиться с полным списком команд вы можете в меню бота. На самом деле основных команд не так уж и много.

Поднимаем своего бота

Разумеется благодаря открытому коду вы можете запустить своего бота. Для работы с зависимостями и виртуальным окружением используется uv.

  1. Клонируем репозиторий:
git clone https://github.com/miroqru/mau-tg
  1. Устанавливаем зависимости:
uv sync
  1. Копируем файл с настройками .env.dist в .env
  2. Вставляем в файл токен от бота
  3. Запускаем бота:
uv run -m maubot

Ах да, ещё вам потребуется включить inline mode для вашего бота и обязательно выставить inline feedback на 100%. Сделать это в BotFather. Без этого, отправленные вами карты не будут обрабатываться ботом.

Переход на mauren

Mauren - это новый клиент для доступа к серверу Mau. Новый сервер добавляет больше игровых возможностей и делает API более стабильный чем прямое использование движка.

Поддержка проекта

Мы будем очень рады, если вы поддержите развитие проекта. Есть несколько способов как вы можете это сделать:

  • Оставить звёздочку в репозитории.
  • Играть вместе с друзьями в Mau.
  • Участвовать в бета-тестировании новых функций.
  • Предлагать свои собственные идеи.
  • Сообщать о найденных багах или даже предлагать их решение.
  • Сделать форк проекта.

Подробности в документации

Нам бы очень хотелось создать лучшего бота для весёлой совместной игры с друзьями!