Skip to content

Latest commit

 

History

History
201 lines (142 loc) · 6.44 KB

README.md

File metadata and controls

201 lines (142 loc) · 6.44 KB

🌙 Moon - Discord Voice Channel Manager

Python Discord.py License Code Style

Создавайте уютные пространства для общения под лунным светом 🌙

✨ Возможности

Moon превращает ваш Discord сервер в динамичную экосистему голосовых комнат:

🎮 Автоматическое создание комнат

  • 5 типов лобби: Допросная, Митинг, Игры, Кинозал, Переговорная
  • Интеллектуальные шаблоны: Умные названия с эмодзи
  • Мгновенное перемещение: Автоматический переход в созданную комнату

⚙️ Полный контроль над комнатой

/setname 🏷️  Изменить название (1-50 символов)
/setlimit 👥  Установить лимит участников (0-99)
/private 🔒  Приватный/публичный режим
/ping 📊  Проверить статус бота
/help 📚  Получить помощь

🛡️ Система безопасности

  • Авто-очистка: Пустые комнаты удаляются автоматически
  • Права доступа: Гранулярный контроль permissions
  • Анти-баг: Защита от ошибок и race conditions

🚀 Быстрый старт

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

  • Python 3.8+
  • Discord сервер с правами администратора
  • Discord Application

Установка за 5 минут

  1. Клонируйте репозиторий
git clone https://github.com/NotACat1/MOON.git
cd MOON
  1. Установите зависимости
pip install -r requirements.txt
  1. Настройте конфигурацию
cp .env.example .env
# Отредактируйте .env файл своими значениями
  1. Запустите бота
python main.py

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

Получение Discord ID

  1. Включите Режим разработчика в Discord
  2. Правый клик на канале/категории → "Копировать ID"

Пример .env файла

DISCORD_TOKEN=your_super_secret_bot_token_here

# Лобби-каналы
LOBBY_INTEGRATION_ID=123456789012345678
LOBBY_MEETING_ID=123456789012345679
LOBBY_GAMES_ID=123456789012345680
LOBBY_MOVIES_ID=123456789012345681
LOBBY_OTHER_ID=123456789012345682

# Категории
CATEGORY_INTEGRATION_ID=123456789012345683
CATEGORY_MEETING_ID=123456789012345684
CATEGORY_GAMES_ID=123456789012345685
CATEGORY_MOVIES_ID=123456789012345686
CATEGORY_OTHER_ID=123456789012345687

Необходимые права бота

{
	"Manage Channels": true,
	"Manage Roles": true,
	"Move Members": true,
	"Connect": true,
	"View Channels": true
}

🏗️ Архитектура проекта

moon-bot/
├── cogs/
│   ├── commands.py          # 📝 Команды управления
│   └── voice_manager.py     # 🎤 Управление голосовыми каналами
├── config/
│   └── settings.py          # ⚙️ Конфигурация
├── .env.example             # 🏗️ Пример конфигурации
├── requirements.txt         # 📦 Зависимости
└── main.py                  # 🚀 Точка входа

🎨 Кастомизация

Изменение шаблонов названий

Отредактируйте в config/settings.py:

ROOM_NAME_TEMPLATE = {
    "допросная": "⛓️ Допросная | {user}",
    "митинг": "🏛️ Митинг | {user}",
    "игры": "🎮 Игровая | {user}",
    "кинозал": "🍿 Кинозал | {user}",
    "переговорная": "💬 Переговорная | {user}"
}

Создание своих типов комнат

  1. Добавьте лобби-канал в Discord
  2. Создайте категорию для комнат
  3. Обновите конфигурацию в .env

🔧 Команды разработчика

Запуск в режиме разработки

DEBUG=true python main.py

Установка в виртуальном окружении

python -m venv venv
source venv/bin/activate  # Linux/Mac
# или
venv\Scripts\activate     # Windows

Форматирование кода

pip install black
black .

🌟 Преимущества Moon

🎯 Для администраторов

  • Снижение нагрузки: Автоматическое управление каналами
  • Чистый сервер: Самоочищающаяся система
  • Гибкость: Легкая кастомизация под нужды сервера

👥 Для пользователей

  • Интуитивность: Простые команды с автодополнением
  • Контроль: Полная власть над своей комнатой
  • Приватность: Гибкие настройки доступа

🛡️ Для разработчиков

  • Чистый код: PEP8, типизация, документация
  • Масштабируемость: Модульная архитектура
  • Надежность: Обработка ошибок и логирование

📜 Лицензия

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

🌙 Почему Moon?

"Так же как луна освещает ночное небо, Moon освещает ваш Discord сервер, создавая идеальную атмосферу для общения, игр и работы."