# 🤖 Merlina Discord Bot – Benutzer-Handbuch
## 📋 Übersicht
**Merlina** ist ein vielseitiger Discord Bot für DACH Warzone Server, der verschiedene nützliche Features für Gaming-Communities bietet.
—
## ✨ Hauptfunktionen
### 🎤 Voice Channel Management
– **Automatische temporäre Channels** – Betritt einen „Erstelle Channel“ und erhalte deinen eigenen Voice Channel
– **Channel Owner System** – Verwalte deinen Channel mit speziellen Berechtigungen
– **Interactive Controls** – Buttons für einfache Channel-Verwaltung
– **Game Mode System** – Markiere deinen Channel mit Spielmodi (BR, MP, DMZ, etc.)
### 🚨 Moderation & Sicherheit
– **User Report System** – Melde problematische Benutzer über Rechtsklick
– **Context Menus** – Schnelle Aktionen per Rechtsklick auf Benutzer
– **Automatische Logs** – Alle Interaktionen werden für Moderatoren gespeichert
### 🎵 Sound System
– **MP3 Playback** – Spiele Sounds direkt in Voice Channels ab
– **Voice Chat Integration** – Benachrichtigungen erscheinen im Voice Channel Chat
### 🔗 Server Integration
– **Website Links** – Schneller Zugriff auf wichtige Community-Links
– **Multi-Server Support** – Unterschiedliche Konfigurationen pro Server
—
## 📱 Verfügbare Commands
### 🎮 Allgemeine Commands
| Command | Beschreibung | Beispiel |
|———|————–|———-|
| `/hallo` | Freundliche Begrüßung | `/hallo` |
| `/würfel [seiten]` | Würfelt eine Zahl (Standard: 6-seitig) | `/würfel 20` |
| `/münze` | Wirft eine Münze (Kopf/Zahl) | `/münze` |
| `/zufallszahl [min] [max]` | Generiert Zufallszahl | `/zufallszahl 1 100` |
| `/umfrage [frage]` | Erstellt Ja/Nein-Umfrage mit Reaktionen | `/umfrage Sollen wir heute Abend spielen?` |
### 📊 Server & Benutzer Info
| Command | Beschreibung | Beispiel |
|———|————–|———-|
| `/serverinfo` | Zeigt Server-Statistiken | `/serverinfo` |
| `/avatar [benutzer]` | Zeigt Avatar eines Benutzers | `/avatar @username` |
| `/benutzerinfo [benutzer]` | Detaillierte Benutzerinformationen | `/benutzerinfo @username` |
### ⏰ Timer & Tools
| Command | Beschreibung | Beispiel |
|———|————–|———-|
| `/timer [sekunden]` | Startet Timer mit Sound-Benachrichtigung | `/timer 300` |
| `/stop` | Stoppt aktuell spielende Musik | `/stop` |
### 🎵 Sound System
| Command | Beschreibung | Verwendung |
|———|————–|————|
| `/sound` | Zeigt verfügbare MP3-Dateien in Dropdown | Musst in Voice Channel sein |
**Funktionsweise:**
1. Betritt einen Voice Channel
2. Verwende `/sound`
3. Wähle MP3-Datei aus Dropdown
4. Sound wird im Voice Channel abgespielt
### 🔗 Server-Links
| Command | Beschreibung | Verwendung |
|———|————–|————|
| `/links` | Zeigt wichtige Server-Links mit Buttons | Klick auf Buttons für direkte Links |
—
## 🎤 Voice Channel System
### 🏗️ Temporäre Channels
**Automatische Erstellung:**
1. Betritt einen **“➕ Erstelle Channel“**
2. Ein neuer temporärer Channel wird automatisch erstellt
3. Du wirst automatisch in deinen neuen Channel bewegt
4. Du erhältst Owner-Rechte für diesen Channel
**Channel-Namen Format:**
– Standard: `[Dein Name]’s Channel`
– Nach Umbenennung: `[Dein Name] – [Dein Wunschtext]`
– Mit Game Mode: `[BR] [Dein Name] – [Dein Wunschtext]`
### 🎛️ Channel-Verwaltung
**Als Channel Owner verfügbare Aktionen:**
#### 📋 Über `/voice` Commands:
– `/voice info` – Channel-Informationen mit Buttons
– `/voice kick benutzer:@user` – Benutzer kicken
– `/voice mute benutzer:@user` – Benutzer stummschalten
– `/voice unmute benutzer:@user` – Stummschaltung aufheben
– `/voice rename wert:Neuer Name` – Channel umbenennen
– `/voice limit wert:5` – Benutzer-Limit setzen (0 = kein Limit)
– `/voice transfer benutzer:@user` – Owner-Rechte übertragen
#### 🎛️ Über Interactive Buttons:
Die Verwaltungsbuttons erscheinen automatisch in deinem Voice Channel oder einem passenden Text Channel:
| Button | Funktion |
|——–|———-|
| 👢 **Kick User** | Benutzer aus Channel entfernen |
| 🔇 **Mute User** | Benutzer stummschalten |
| 🔊 **Unmute User** | Stummschaltung aufheben |
| 👑 **Transfer Owner** | Owner-Rechte an anderen Benutzer übertragen |
| ✏️ **Rename** | Channel umbenennen |
| 👥 **Set Limit** | Benutzer-Limit festlegen |
| 🎮 **Game Mode** | Spielmodus zum Channel-Namen hinzufügen |
| 🗑️ **Delete Channel** | Channel sofort löschen |
### 🎮 Game Mode System
**Verfügbare Modi:**
– **BR** – Battle Royale
– **MP** – Multiplayer
– **Rebirth** – Rebirth Modus
– **Ranked** – Ranked Spiele
– **Beutegeld** – Beutegeld Modus
– **DMZ** – DMZ Modus
– **🚫 Entfernen** – Game Mode aus Namen entfernen
**Funktionsweise:**
1. Klick auf 🎮 **Game Mode** Button
2. Wähle Modus aus Dropdown
3. Channel-Name wird automatisch angepasst
4. Benutzer-Limit wird auf 5 gesetzt (für Squad-Spiele optimiert)
—
## 🚨 Report System
### 📱 Benutzer melden
**Über Rechtsklick (Context Menu):**
1. **Rechtsklick** auf problematischen Benutzer
2. Wähle **“🚨 Benutzer melden“**
3. Fülle Formular aus (mindestens 30 Zeichen)
4. Report wird an Moderatoren gesendet
**Report-Informationen:**
– Gemeldeter Benutzer (Name, ID, Mention)
– Melder-Informationen
– Grund der Meldung
– Server & Channel Details
– Zeitstempel
– Mitgliedschaftsdauer
### 👤 Benutzer-Info
**Schnelle Benutzer-Informationen:**
1. **Rechtsklick** auf Benutzer
2. Wähle **“👤 Benutzer Info“**
3. Erhalte detaillierte Informationen
**Angezeigte Informationen:**
– Grunddaten (Name, ID, Status)
– Beitrittsdatum & Server-Zeit
– Rollen & Berechtigungen
– Voice Channel Status
– Account-Alter
—
## 🎯 Tipps & Best Practices
### ✅ Voice Channel Etikette
– **Nutze Game Modes** für bessere Organisation
– **Setze sinnvolle Limits** (meist 4-5 für Squads)
– **Benenne Channels aussagekräftig** (z.B. „Bruce – Ranked Duo“)
– **Übertrage Owner-Rechte** wenn du den Channel verlässt
### 🔧 Troubleshooting
**Voice Channel Buttons reagieren nicht:**
– Prüfe ob du der Channel Owner bist
– Buttons haben 30-Minuten Timeout
– Verwende `/voice info` für neue Buttons
**Sound funktioniert nicht:**
– Stelle sicher, dass du in einem Voice Channel bist
– Bot benötigt Voice-Berechtigung
– Prüfe ob andere Musik/Sounds laufen
**Report wurde nicht gesendet:**
– Administratoren müssen Bot-Berechtigungen prüfen
– Report-Channel muss konfiguriert sein
### 🎮 Gaming-Optimierung
**Für Warzone Squads:**
1. Verwende **“➕ BR create“** oder **“➕ MP create“** Channels
2. Setze Game Mode entsprechend
3. Stelle Limit auf 4 (Squad-Größe)
4. Benenne Channel nach Spielmodus
**Für größere Gruppen:**
1. Nutze **“➕ Erstelle Channel“**
2. Erhöhe Benutzer-Limit entsprechend
3. Verwende aussagekräftige Namen
—
## 🔧 Server-spezifische Features
Jeder Server kann unterschiedliche Konfigurationen haben:
– **Verschiedene Create-Channels** pro Server
– **Angepasste Website-Links**
– **Server-spezifische Sound-Dateien**
– **Individuelle Report-Channels**
—
## 📞 Support & Hilfe
Bei Problemen oder Fragen:
1. **Verwende `/voice info`** für Channel-Probleme
2. **Kontaktiere Server-Administratoren** für Konfigurationsprobleme
3. **Prüfe Bot-Berechtigungen** bei Funktionsproblemen
—
*Merlina Bot – Entwickelt für DACH Warzone Gaming Communities* 🎮