https://github.com/notacat1/moon
Moon is an intelligent Discord voice channel manager that automatically creates temporary voice rooms when users join lobby channels. It provides seamless room management with custom names, user limits, and privacy controls, creating dynamic voice spaces for communities, gaming, and meetings.
https://github.com/notacat1/moon
automation automation-bot community-tools discord-automation discord-bot discord-py discord-utility gaming python room-management temporary-rooms voice-channels voice-chat voice-manager voice-space
Last synced: 8 months ago
JSON representation
Moon is an intelligent Discord voice channel manager that automatically creates temporary voice rooms when users join lobby channels. It provides seamless room management with custom names, user limits, and privacy controls, creating dynamic voice spaces for communities, gaming, and meetings.
- Host: GitHub
- URL: https://github.com/notacat1/moon
- Owner: NotACat1
- License: mit
- Created: 2025-08-30T13:17:23.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-08-31T14:50:49.000Z (9 months ago)
- Last Synced: 2025-08-31T16:27:41.913Z (9 months ago)
- Topics: automation, automation-bot, community-tools, discord-automation, discord-bot, discord-py, discord-utility, gaming, python, room-management, temporary-rooms, voice-channels, voice-chat, voice-manager, voice-space
- Language: Python
- Homepage:
- Size: 17.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌙 Moon - Discord Voice Channel Manager
[](https://python.org)
[](https://discordpy.readthedocs.io)
[](LICENSE)
[](https://pep8.org)
_Создавайте уютные пространства для общения под лунным светом_ 🌙
## ✨ Возможности
Moon превращает ваш Discord сервер в динамичную экосистему голосовых комнат:
### 🎮 Автоматическое создание комнат
- **5 типов лобби**: Допросная, Митинг, Игры, Кинозал, Переговорная
- **Интеллектуальные шаблоны**: Умные названия с эмодзи
- **Мгновенное перемещение**: Автоматический переход в созданную комнату
### ⚙️ Полный контроль над комнатой
```bash
/setname 🏷️ Изменить название (1-50 символов)
/setlimit 👥 Установить лимит участников (0-99)
/private 🔒 Приватный/публичный режим
/ping 📊 Проверить статус бота
/help 📚 Получить помощь
```
### 🛡️ Система безопасности
- **Авто-очистка**: Пустые комнаты удаляются автоматически
- **Права доступа**: Гранулярный контроль permissions
- **Анти-баг**: Защита от ошибок и race conditions
## 🚀 Быстрый старт
### Предварительные требования
- Python 3.8+
- Discord сервер с правами администратора
- [Discord Application](https://discord.com/developers/applications)
### Установка за 5 минут
1. **Клонируйте репозиторий**
```bash
git clone https://github.com/NotACat1/MOON.git
cd MOON
```
2. **Установите зависимости**
```bash
pip install -r requirements.txt
```
3. **Настройте конфигурацию**
```bash
cp .env.example .env
# Отредактируйте .env файл своими значениями
```
4. **Запустите бота**
```bash
python main.py
```
## ⚙️ Конфигурация
### Получение Discord ID
1. Включите **Режим разработчика** в Discord
2. Правый клик на канале/категории → "Копировать ID"
### Пример .env файла
```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
```
### Необходимые права бота
```json
{
"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`:
```python
ROOM_NAME_TEMPLATE = {
"допросная": "⛓️ Допросная | {user}",
"митинг": "🏛️ Митинг | {user}",
"игры": "🎮 Игровая | {user}",
"кинозал": "🍿 Кинозал | {user}",
"переговорная": "💬 Переговорная | {user}"
}
```
### Создание своих типов комнат
1. Добавьте лобби-канал в Discord
2. Создайте категорию для комнат
3. Обновите конфигурацию в `.env`
## 🔧 Команды разработчика
### Запуск в режиме разработки
```bash
DEBUG=true python main.py
```
### Установка в виртуальном окружении
```bash
python -m venv venv
source venv/bin/activate # Linux/Mac
# или
venv\Scripts\activate # Windows
```
### Форматирование кода
```bash
pip install black
black .
```
## 🌟 Преимущества Moon
### 🎯 Для администраторов
- **Снижение нагрузки**: Автоматическое управление каналами
- **Чистый сервер**: Самоочищающаяся система
- **Гибкость**: Легкая кастомизация под нужды сервера
### 👥 Для пользователей
- **Интуитивность**: Простые команды с автодополнением
- **Контроль**: Полная власть над своей комнатой
- **Приватность**: Гибкие настройки доступа
### 🛡️ Для разработчиков
- **Чистый код**: PEP8, типизация, документация
- **Масштабируемость**: Модульная архитектура
- **Надежность**: Обработка ошибок и логирование
## 📜 Лицензия
Этот проект распространяется под лицензией MIT. Подробнее см. в файле [LICENSE](LICENSE).
## 🌙 Почему Moon?
> _"Так же как луна освещает ночное небо, Moon освещает ваш Discord сервер, создавая идеальную атмосферу для общения, игр и работы."_