Discord бот для MTA:SA сервера

Многофункциональный Discord бот для управления и мониторинга MTA:SA сервера.

⚠️⚠️ ВНИМАНИЕ ⚠️⚠️

ОБЯЗАТЕЛЬНО ПЕРЕД ЗАПУСКОМ ЗАПРЕТИТЕ ИСПОЛЬЗОВАТЬ КОМАНДЫ БОТА ВСЕМ! ИНАЧЕ ЛЮБОЙ СМОЖЕТ СДЕЛАТЬ ЧТО УГОДНО

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

📊 Мониторинг сервера

• Отображение статуса сервера в Discord
• Просмотр количества игроков
• Список игроков с никами
• Всё в реальном времени в отдельном канале

⚖️ Административные функции

• Система выговоров/варнов в Discord (с ведением динамической таблицы)
• Управление базой данных:
  • Выдача админских прав
  • Управление скинами игроков
  • Контроль игровой валюты
• Подключение к серверу по SSH для удалённого управления
• Включение/отключение сервера (требуется запуск через screen)
• Создание промокодов

👥 Управление игроками

• Поиск информации об игроке по ID или никнейму
• Система репутации
• Управление вторыми аккаунтами (возможны баги)
• Уведомления о новых регистрациях

🗳️ Интерактивные функции

• Голосования (реализовано до появления встроенной функции в Discord)
• И другие полезные возможности

🚀 Установка и настройка

Предварительные требования

• Установленный Python 3.x
• Доступ к Discord серверу с правами администратора
• Discord сервер с созданными необходимыми каналами
• Бот должен быть запущен на том же хосте, что и сервер!
• Соответственно VDS/VPS сервер

Создайте дискорд бота

• Создайте бота на сайте https://discord.com/developers/applications
• Добавьте его на сервер
• ОТКЛЮЧИТЕ ДОСТУП К КОМАНДАМ БОТА НА СЕРВЕРЕ!
• Дайте возможность просматривать сообщения
• Введите токен бота в конфиг файл

Пошаговая установка

1. Создайте новую директорию для бота на том же хосте, что и сервер, например /bot
2. Скопируйте файлы бота в созданную директорию

Конфигурация

1. Откройте файл /misc/env.py и укажите токен вашего Discord бота:

   TOKEN = "ваш_токен_бота"

   • Примечание: Можно использовать переменные окружения (раскомментируйте строку 7)*

2. Настройте основные параметры в файле /misc/config.py:

   • Укажите ID сервера, на котором будет запущен бот
   • Создайте и укажите ID необходимых каналов Discord сервера
   • Настройте данные от Базы данных, SSH, IP сервера
   • Измените другие параметры согласно комментариям в файле

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

   • Перейдите в папку с ботом командой cd /bot
   • Установите зависимости командой pip install -r requirements.txt

🏃 Запуск бота

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

1. Создайте новый screen сеанс: screen -S bot

2. Перейдите в директорию с ботом: cd /bot

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

4. Для выхода из screen сеанса нажмите Ctrl+A затем D

5. Для повторного подключения к сеансу: screen -x bot

🤝 Поддержка

Если вы обнаружили ошибки или хотите предложить улучшения, создайте issue в репозитории проекта или напишите мне в дискорд.