136 lines
3.5 KiB
Markdown
136 lines
3.5 KiB
Markdown
# Discord Multi Bot (Music / Manage / Notify)
|
|
|
|
TypeScript 기반 디스코드 봇 템플릿입니다. 음악 재생은 Lavalink(Shoukaku)로 동작합니다.
|
|
|
|
## Stack
|
|
- TypeScript + Node.js 20+
|
|
- discord.js v14
|
|
- PostgreSQL + Prisma
|
|
- Redis + BullMQ
|
|
- Lavalink + Shoukaku
|
|
|
|
## 1) 환경 변수
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
`.env` 예시:
|
|
```env
|
|
DISCORD_TOKEN=...
|
|
DISCORD_CLIENT_ID=...
|
|
DISCORD_GUILD_ID=... # 개발/테스트 서버 ID
|
|
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/discord_multibot
|
|
REDIS_URL=redis://localhost:6379/1
|
|
LAVALINK_NODE_NAME=local
|
|
LAVALINK_HOST=127.0.0.1
|
|
LAVALINK_PORT=2333
|
|
LAVALINK_PASSWORD=youshallnotpass
|
|
LAVALINK_SECURE=false
|
|
LOG_LEVEL=info
|
|
```
|
|
|
|
## 2) PostgreSQL 준비
|
|
예시:
|
|
```bash
|
|
docker run -d \
|
|
--name discord-postgres \
|
|
-e POSTGRES_USER=postgres \
|
|
-e POSTGRES_PASSWORD=postgres \
|
|
-e POSTGRES_DB=discord_multibot \
|
|
-p 5432:5432 \
|
|
-v discord_postgres_data:/var/lib/postgresql/data \
|
|
postgres:16
|
|
```
|
|
|
|
## 3) Lavalink 준비 (Docker)
|
|
프로젝트 루트에서:
|
|
```bash
|
|
docker compose -f docker-compose.lavalink.yml up -d
|
|
```
|
|
|
|
상태 확인:
|
|
```bash
|
|
docker logs -f discord-lavalink
|
|
```
|
|
|
|
## 4) 의존성/DB 초기화
|
|
```bash
|
|
npm install
|
|
npm run prisma:generate
|
|
npm run prisma:push
|
|
```
|
|
|
|
## 5) 실행
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
정상 로그 예시:
|
|
- `Guild commands registered`
|
|
- `Bot ready`
|
|
|
|
## 명령어
|
|
### Music (Lavalink)
|
|
- `/play query:<검색어 또는 유튜브 URL>`
|
|
- `/queue`
|
|
- `/skip`
|
|
- `/stop`
|
|
|
|
### Manage
|
|
- `/warn user:<user> reason:<string>`
|
|
- `/warnings user:<user>`
|
|
|
|
### Notify
|
|
- `/notify_schedule channel:<channel> cron:<expr> message:<text>`
|
|
- `/notify_list`
|
|
- `/notify_disable rule_id:<id>`
|
|
|
|
### News
|
|
- `/news query:<optional>`
|
|
|
|
### Summarize (Google AI Studio)
|
|
- `/summarize url:<url> mode:<auto|fast|quality>`
|
|
|
|
### Translate
|
|
- `/translate text:<text> source:<optional> target:<optional>`
|
|
- 우선순위: `DeepL API` -> `deepl-cli(web)` -> `Google Web v2`
|
|
|
|
## 실제 사용 예시
|
|
1. 봇과 사용자 모두 같은 음성 채널 입장
|
|
2. 텍스트 채널에서:
|
|
- `/play query:아이유 밤편지`
|
|
- `/play query:https://www.youtube.com/watch?v=...`
|
|
3. 제어:
|
|
- `/queue` (대기열 확인)
|
|
- `/skip` (다음 곡)
|
|
- `/stop` (정지 + 음성채널 퇴장)
|
|
|
|
4. 접두사 명령:
|
|
- `!play <검색어 또는 URL>`
|
|
- `!queue`
|
|
- `!skip`
|
|
- `!stop`
|
|
- `!뉴스 [키워드]`
|
|
- `!news [keyword]`
|
|
- `!요약 <url> [auto|fast|quality]`
|
|
- `!summarize <url> [auto|fast|quality]`
|
|
- `!번역 [source->target] <텍스트>` (기본 `auto->ko`)
|
|
- `!translate [source->target] <text>`
|
|
- `!ani "제목"` (gds_dviewer 애니 검색)
|
|
- `!영화 "제목"` / `!movie "title"` (gds_dviewer 영화 검색)
|
|
|
|
## 참고
|
|
- `REDIS_URL`이 없으면 BullMQ 워커는 비활성화됩니다.
|
|
- YouTube 재생 안정성은 Lavalink 서버 상태/플러그인에 영향받습니다.
|
|
- 요약 기능은 `GEMINI_API_KEY`가 필요합니다.
|
|
- 번역 기능은 `DEEPL_API_KEY`가 없으면 `deepl-cli`를 먼저 시도하고, 실패 시 `Google Web v2`를 사용합니다.
|
|
- `deepl-cli` 테스트용 설정:
|
|
- `DEEPL_CLI_BIN=deepl`
|
|
- `DEEPL_CLI_TIMEOUT_MS=45000`
|
|
- pyenv 사용 시 예시: `DEEPL_CLI_BIN=/Users/yommi/.pyenv/versions/3.11.0/envs/FF_3.11/bin/deepl`
|
|
- `!ani` 기능 환경 변수:
|
|
- `GDS_DVIEWER_BASE_URL=http://127.0.0.1:9099/gds_dviewer/normal/explorer`
|
|
- `GDS_DVIEWER_API_KEY=...`
|
|
- `GDS_DVIEWER_SOURCE_ID=0`
|
|
- `EXTERNAL_VIDEO_PLAYER_URL=https://your-domain/player/external_video_player.html` (Discord 노출 URL 분리용, 권장)
|