🌙 Moon - Discord Voice Channel Manager

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

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

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

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

pip install -r requirements.txt

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

cp .env.example .env
# Отредактируйте .env файл своими значениями

4. Запустите бота

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 сервер, создавая идеальную атмосферу для общения, игр и работы."