Инструкция по настройке и запуску Telegram-бота

Требования

Для работы бота требуется:

• Python 3.10.6 (более новые версии, скорее всего, будут работать, но насчет более старых версий уверенности нет).
• pip 24.3.1 (аналогично, более новые версии должны работать).
• Библиотеки, указанные в файле requirements.txt.

Установка репозитория с GitHub

Чтобы установить проект на свой компьютер, выполните следующие шаги:

1. Убедитесь, что у вас установлен Git:

   • Если Git не установлен, скачайте и установите его с официального сайта.
   • Проверьте установку, выполнив в терминале команду:

     git --version

2. Клонируйте репозиторий:

   • Откройте терминал и перейдите в папку, куда вы хотите скопировать проект.
   • Выполните команду:

     git clone https://github.com/deexsed/getMatchIdBot

3. Перейдите в папку проекта:

   • После клонирования перейдите в папку проекта:

     cd getMatchIdBot

4. Установите зависимости:

   • Установите необходимые пакеты, выполнив команду:

     pip install -r requirements.txt

Теперь проект готов к настройке и запуску.

Регистрация бота в Telegram через BotFather

Чтобы зарегистрировать бота в Telegram, выполните следующие шаги:

1. Откройте Telegram: Запустите приложение Telegram на вашем устройстве.
2. Найдите BotFather:
   • В строке поиска введите @BotFather.
   • Выберите BotFather из списка результатов (у него будет синяя галочка, подтверждающая, что это официальный бот).
3. Запустите BotFather:
   • Нажмите кнопку «START» или введите команду /start.
4. Создайте нового бота:
   • Введите команду /newbot и отправьте её.
5. Укажите имя бота:
   • Вам будет предложено ввести имя для вашего бота. Это имя будет отображаться в чатах и контактах.
6. Придумайте уникальный юзернейм:
   • После этого вам нужно будет придумать юзернейм для бота, который должен заканчиваться на «bot» (например, MyFirstBot). Юзернейм должен состоять только из латинских букв и цифр, а также быть уникальным.
7. Получите токен:
   • После успешной регистрации BotFather предоставит вам токен API, который нужен для работы с ботом. Сохраните его в безопасном месте, так как он будет использоваться для авторизации вашего бота.

Настройка и запуск бота

Для начала работы выполните следующие шаги:

1. Настройте файл heroes.json:

   • В файле heroes.json укажите необходимых героев. Они будут отображаться у пользователя при вводе героя. В названии можно указать что угодно.
   
   Пример содержимого файла heroes.json
   
   Пример отображения героев у пользователя

2. Настройте файл config.py:

   • В файле config.py укажите токен бота, полученный от @BotFather.
   
   Пример содержимого файла config.py

3. Запустите бота:

   • Запустите файл start_bot.bat для начала работы бота.

4. Получение статистики матчей:

   • После записи первого матча в папке проекта появится файл matchStat.xlsx. В нем будут находиться все полученные номера матчей.

5. Наслаждайтесь:

   • Теперь вы можете использовать бота и наслаждаться его функционалом!

Удаление установленных пакетов

Если вы хотите удалить установленные пакеты, выполните следующую команду в терминале:

pip uninstall -y -r requirements.txt

---

Примечание: Убедитесь, что все шаги выполнены корректно, чтобы бот работал без ошибок. Если возникнут проблемы, проверьте, правильно ли вы указали токен и установили все необходимые библиотеки.