Бот для команд

Инструкция по настройке:

Для работы бота, необходимо провести настройку в .env файле Что обычно хранится в .env

• Токен Telegram-бота

• Пароли

• API-ключи

• Адреса серверов

• Другие секретные данные

Проверка подписки пользователей на чаты

В боте реализована обязательная проверка подписки пользователя на указанные чаты/каналы. Пока пользователь не подписан, он не сможет пользоваться ботом.

За это отвечают последние три параметра в файле .env:

REQUIRED_CHAT_ID=
REQUIRED_NEWS_CHANNEL_ID=
REQUIRED_DEPOSITS_CHANNEL_ID=

Как это работает

1. При запуске команды или взаимодействии с ботом:

   • Бот проверяет, подписан ли пользователь на указанные чаты/каналы

2. Если пользователь не подписан хотя бы на один из них:

   • Бот сообщает об этом

   • Предлагает перейти и подписаться

3. После подписки пользователь получает доступ к функционалу бота

Описание параметров

REQUIRED_CHAT_ID

ID основного чата / группы, на которую пользователь должен быть подписан.

Пример:

REQUIRED_CHAT_ID=-1001234567890

REQUIRED_NEWS_CHANNEL_ID

ID новостного канала, обязательного для подписки.

Используется, например, для:

• Объявлений

• Обновлений

• Новостей проекта

REQUIRED_DEPOSITS_CHANNEL_ID

ID канала, связанного с:

• Депозитами

Как отключить проверку подписки

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

Пример — проверка отключена полностью:

REQUIRED_CHAT_ID=
REQUIRED_NEWS_CHANNEL_ID=
REQUIRED_DEPOSITS_CHANNEL_ID=

Пример — проверка только одного канала:

REQUIRED_CHAT_ID=-1001234567890
REQUIRED_NEWS_CHANNEL_ID=
REQUIRED_DEPOSITS_CHANNEL_ID=

Зачем нужна эта проверка

• 📢 Увеличение подписчиков в важных каналах

• 🔐 Ограничение доступа к боту

• 📊 Контроль аудитории

• ⚙️ Гибкая настройка через .env без изменения кода

Важно

• Бот должен быть администратором во всех проверяемых чатах и каналах

• Иначе он не сможет проверить статус подписки пользователя

Почему бот распространяется через Git, а не ZIP-архивом

Мы распространяем проект через Git-репозиторий, а не в виде ZIP-архива, потому что это более удобное, безопасное и профессиональное решение как для разработчиков, так и для пользователей.

2. Удобные обновления проекта

С Git пользователь может обновить бота одной командой:

git pull

При использовании ZIP-архивов:

• Нужно каждый раз скачивать новый архив

• Вручную заменять файлы

• Есть риск потерять свои настройки или базу данных

Git позволяет:

• Получать только изменения

• Сохранять локальные данные

• Обновляться быстро и безопасно

3. История изменений и прозрачность

Git хранит:

• Полную историю изменений

• Информацию, что именно и зачем было изменено

• Версии и релизы

Это позволяет:

• Понимать, какие функции были добавлены

• Быстро находить ошибки

• Откатываться к стабильной версии

ZIP-архив этого не даёт — это просто «снимок» проекта.

5. Масштабируемость и развитие проекта

Git изначально рассчитан на:

• Долгосрочную поддержку

• Добавление новых функций

• Работу нескольких разработчиков

ZIP-архивы подходят только для:

• Одноразовых решений

• Проектов без обновлений

Наш бот — живой проект, который развивается, поэтому Git — правильный выбор.

Кратко

Мы используем Git вместо ZIP, потому что это:

• 🔐 Безопаснее

• 🔄 Удобнее для обновлений

• 🧠 Понятнее для поддержки

• 📈 Лучше подходит для развития проекта

Файл .env — общая конфигурация бота

Файл .env содержит все настройки бота, которые:

• Могут отличаться на разных серверах

• Не должны храниться в коде

• Можно менять без редактирования исходников

Бот читает этот файл при запуске и использует значения для своей работы.

---

Основные параметры бота

BOT_TOKEN

Токен Telegram-бота, полученный у @BotFather.

BOT_TOKEN=your_bot_token_here

🔐 Критически важный параметр Никогда не публикуйте токен — любой, кто его узнает, получит полный контроль над ботом.

---

ADMIN_IDS

Список Telegram ID администраторов бота.

ADMIN_IDS=123456789,987654321

Используется для:

• Доступа к админ-командам

• Управления ботом

• Модерации и служебных функций

Можно указать один или несколько ID через запятую.

---

Каналы и группы бота

Эти параметры указывают, куда бот отправляет сообщения.

REQUESTS_CHANNEL_ID

Канал или группа для:

• Заявок на регистрацию воркера

---

TICKETS_CHANNEL_ID

Канал для:

• Тикетов в поддержку со стороны воркера

---

PROFITS_CHANNEL_ID

Канал для:

• Депозитов

---

SUPPORT_GROUP_ID

ID группы поддержки, где:

• Общаются пользователи

• Работают администраторы или модераторы

---

📌 Важно: Бот должен быть добавлен в эти чаты и иметь нужные права.

---

Работа с базой данных (ТОЛЬКО SQLITE)

DATABASE_PATH

Путь к файлу базы данных.

DATABASE_PATH=data/bot.db

Позволяет:

• Хранить данные пользователей

• Сохранять настройки

• Не терять информацию между перезапусками

Можно изменить путь при необходимости (например, на сервере).

---

Внешний API / Worker

Эти параметры отвечают за подключение бота к нашей панели.

WORKER_API_KEY

API-ключ для авторизации бота в нашем сервисе.

WORKER_API_KEY=7a54c309-4add-49e2-9b49-1b80b17563d1

WORKER_WS_URL

WebSocket-адрес сервиса.

WORKER_WS_URL=wss://luxardgambling.com/api/v1/ws

Используется для:

Real-time событий

• Постоянного соеденения

WORKER_HTTP_URL

HTTP API адрес сервиса.

WORKER_HTTP_URL=https://luxardgambling.com/api/v1

Используется для:

• Получения и отправки данных с нашей панели

Сылки в меню «Информация»

Эти параметры используются для кнопок и меню внутри бота.

Примеры:

INFO_FAQ_URL=https://example.com/faq
INFO_NEWS_URL=https://example.com/news
INFO_MANUALS_URL=https://example.com/manuals
INFO_RULES_URL=https://example.com/rules
INFO_CHATS_URL=https://t.me/team_chat
INFO_DEPOSITS_URL=https://t.me/deposits

Используются для:

• FAQ

• Новостей

• Инструкций

• Правил

• Чатов

• Депозитной информации

Контакты администраторов

ADMIN_TS_CONTACT

Основной контакт администратора.

ADMIN_TS_CONTACT=@admin1

---

ADMIN_MODERATOR_CONTACT

Контакт модератора или второго администратора.

ADMIN_MODERATOR_CONTACT=@admin2

Показываются пользователям:

• В поддержке

• В справке

• При ошибках или вопросах

Установка бота на Linux-сервер (через SSH с Windows)

В этом разделе показано, как подключиться к Linux-серверу с Windows по SSH и установить бота LUXARD team bot.

---

Что понадобится

• Windows 10 / 11

• Доступ к Linux-серверу:

  • IP-адрес

  • Имя пользователя (обычно root или ubuntu)

  • Пароль или SSH-ключ

• Установленный Telegram-бот и токен (из @BotFather)

---

Шаг 1. Подключение к серверу по SSH (Windows)

Вариант 1. Через Windows Terminal / PowerShell (рекомендуется)

В Windows уже встроен SSH-клиент.

1. Откройте Windows Terminal или PowerShell

2. Выполните команду:

ssh user@SERVER_IP

Пример:

ssh [email protected]

1. Подтвердите подключение (yes)

2. Введите пароль от сервера

Вариант 2. Через PuTTY (если привыкли)

1. Скачайте PuTTY

2. В поле Host Name укажите IP сервера

3. Нажмите Open

4. Введите логин и пароль

После успешного входа вы увидите терминал Linux — значит, подключение прошло успешно ✅

Шаг 2. Подготовка сервера (ubuntu server)

Обновим систему и установим нужные пакеты:

apt update && apt upgrade -y
apt install -y git python3 python3-pip python3-venv

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

git clone https://codeberg.org/swag_messiah/Luxard_Team_Bot
cd wassup

Шаг 4. Создание виртуального окружения

python3 -m venv venv
source venv/bin/activate

После активации вы увидите (venv) в начале строки.]

Шаг 5. Установка зависимостей

pip install -r requirements.txt

Бот установит все необходимые библиотеки.

Шаг 6. Настройка .env

Создаём файл окружения на основе примера:

cp .env.example .env
nano .env

Заполните необходимые параметры:

• BOT_TOKEN

• ADMIN_IDS

• ID каналов и групп

• API и Worker-адреса

• Пути и ссылки

⚠️ Важно

• .env не загружается в Git

• Каждый сервер имеет свой .env

• Никогда не публикуйте реальные токены

Шаг 7. Запуск бота

python main.py

Если ошибок нет — бот запущен 🚀 Он сразу появится онлайн в Telegram.

(Опционально) Запуск в фоне

Для постоянной работы рекомендуется использовать:

• screen

• tmux

• или systemd

Пример с screen:

screen -S luxard-bot
python main.py

Отключиться:

Ctrl + A → D

Кратко о боте Luxard Team Bot

Luxard Team Bot — это Telegram-бот для команды, который предоставляет:

Основные возможности

• 👤 Роли: кандидат, воркер, саппорт, админ

• 📩 Заявки и тикеты

• 🎯 Домены и промокоды

• 🤝 Наставники и рефералы

• 🔔 Модерационные и сервисные каналы

• 🔌 WebSocket-события (депозиты, саппорт)

Бот интегрируется с внутренним API и используется как единая точка управления командой.

Итог

Вы:

• Подключились к серверу по SSH с Windows

• Установили Python и зависимости

• Скачали бота через Git

• Настроили .env

• Запустили бота

• Вы молодец!🎉

🎉 Установка завершена.