🤖 TeleTube - Telegram Бот-Симулятор Блогера 🎮

TeleTube — это увлекательный Telegram-бот, где вы можете примерить на себя роль популярного "TeleTube" блогера! 🚀 Публикуйте "видео", набирайте подписчиков, зарабатывайте внутриигровую валюту, открывайте достижения, соревнуйтесь с друзьями и станьте настоящей звездой TeleTube!

---

✨ Ключевые Особенности

• 🎬 Публикация "видео": Создавайте виртуальный контент и делитесь им.
• 📈 Динамичный рост: Получайте (или теряйте 😥) подписчиков в зависимости от "популярности" вашего видео.
• 🔑 Влияние ключевых слов: Успех видео зависит от удачно подобранных слов в названии.
• ⏳ Система кулдауна: Новые видео можно публиковать через определенные промежутки времени.
• 🔔 Уведомления: Бот напомнит, когда кулдаун завершится (если функция активна).
• 🎲 Случайные события: Неожиданные события могут повлиять на вашу следующую публикацию.
• 💰 Игровая валюта (TeleCoin): Зарабатывайте валюту за активность и достижения.
• 🛍️ Магазин улучшений: Тратьте TeleCoin на полезные бусты и предметы.
• 🎁 Ежедневный бонус и стрики: Получайте награды за регулярный вход в игру.
• 🏆 Система достижений: Открывайте ачивки за различные успехи в игре.
• 📊 Таблицы лидеров: Соревнуйтесь с другими игроками (текстовая и графическая версии).
• 👤 Детальный профиль: Отслеживайте свой прогресс, статистику и активные события.
• ⚙️ Гибкая настройка: Множество параметров бота настраиваются через файл .env.
• 📢 Проверка подписки на канал: Опциональная возможность требовать подписку на указанный Telegram-канал для использования бота.
• 🛠️ Админ-панель: Команды для создателя бота для управления игрой и пользователями.

---

🚀 Как Начать?

Требования

• Python 3.8 или выше.
• pip (менеджер пакетов Python).
• Аккаунт Telegram и предварительно созданный бот через @BotFather.

Установка

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

   git clone https://github.com/ReNothingg/TeleTube
   cd TeleTube

2. Создайте и активируйте виртуальное окружение (настоятельно рекомендуется):

   • Для Unix/macOS:

     python3 -m venv venv
     source venv/bin/activate

   • Для Windows:

     python -m venv venv
     .\venv\Scripts\activate

3. Установите все необходимые зависимости:

   pip install -r requirements.txt

4. Настройте конфигурацию бота:

   • Скопируйте файл .env.example в новый файл .env:

     cp .env.example .env

     (Для Windows: copy .env.example .env)
   • Откройте файл .env в вашем любимом текстовом редакторе и внимательно заполните все значения согласно комментариям в файле. Как минимум, вам нужно указать BOT_TOKEN и ваш CREATOR_ID.

5. (Опционально) Настройте ключевые слова:

   • Отредактируйте файл keywords.txt, добавив или изменив ключевые слова, которые будут влиять на популярность видео. Каждое слово должно быть на новой строке.

Запуск Бота

После завершения установки и настройки, запустите бота из корневой папки проекта:

python main.py

---

🤖 Команды Бота

Основные Команды:

• /start - Начать взаимодействие с ботом, первичная регистрация.
• /addvideo <название видео> - Опубликовать новое "видео". (Псевдонимы: /video, /new, /publish и др.)
  • Пример: /addvideo Самое смешное видео 2077 года
• /myprofile - Посмотреть свой текущий статус, баланс валюты, статистику.
• /shop - Открыть магазин для покупки улучшений и бустов.
• /daily - Получить ежедневный бонус и проверить свой стрик.
• /achievements - Посмотреть список своих достижений.
• /leaderboard или /lp - Показать текстовый топ игроков.
• /leaderboardpic или /lppic - Показать графический топ игроков.
• /help - Показать это справочное сообщение со списком команд и описанием механик.

🔐 Админские Команды (Доступны только для CREATOR_ID):

• /CHEATaddsub <ID или @username> <количество> - Изменить количество подписчиков пользователю.
• /CHEATaddcoins <ID или @username> <количество> - Изменить баланс валюты пользователю.
• /CHEATgiveach <ID или @username> <ID_достижения> - Выдать указанное достижение пользователю.
• /CHEATDeleteDatabase - Удалить файл базы данных (будет создан заново при следующем взаимодействии).
• /botstats - Показать общую статистику по боту (количество пользователей, видео, валюты и т.д.).
• /disablesub - отключить проверку подписки.
• /enablesub <канал> - включить проверку подписки.

---

⚙️ Конфигурация и Данные

• .env: Ваш главный конфигурационный файл. Содержит все настройки бота, от токена до игровых параметров. Никогда не добавляйте этот файл в публичные репозитории! (Он уже есть в .gitignore).
• keywords.txt: Список ключевых слов, которые влияют на популярность "видео". Вы можете свободно редактировать этот файл.
• database.json (или имя, указанное в DATABASE_FILE в .env): Файл, в котором хранятся все данные пользователей (прогресс, валюта, достижения и т.д.). Создается и обновляется автоматически. Регулярно делайте его резервные копии.
• leaderboard_pic.png: Временный файл, который создается при генерации графического лидерборда. Удаляется автоматически после отправки.

---

🛠️ Возможные Улучшения и Планы

• Более сложные и разнообразные случайные события.
• Персистентные уведомления о завершении кулдауна (даже после перезапуска бота).
• Система гильдий или команд.
• Глобальные события, влияющие на всех игроков.
• Интернационализация (поддержка нескольких языков).

---

🤝 Вклад в Проект

Если у вас есть идеи по улучшению, новые предложения по функциям или вы нашли ошибку, пожалуйста, не стесняйтесь создавать Issue или Pull Request в этом репозитории. Любой вклад приветствуется!

---

📄 Лицензия

Этот проект распространяется под лицензией MIT. Подробную информацию вы найдете в файле LICENSE.

---

Сделано с ❤️ и Python!