📚 Hilfe & Support für CactusBot
Hier findest du alle Informationen, um CactusBot erfolgreich zu nutzen. Von der ersten Einrichtung bis zu fortgeschrittenen Features.
🚀 Erste Schritte mit CactusBot
Bot zu Discord hinzufügen
Klicke auf den Button unten, um CactusBot zu deinem Discord Server hinzuzufügen:
Bot zu Discord hinzufügenDu benötigst Administrator-Berechtigungen auf dem Discord Server.
Datenbank einrichten
CactusBot benötigt eine MySQL oder MariaDB Datenbank. Diese musst du selbst bereitstellen.
/setup_database host=datenbank.de port=3306
database=deine_datenbank
user=dein_benutzer
password=dein_passwort
Die Daten werden ausschließlich in deiner eigenen Datenbank gespeichert!
Server hinzufügen
Füge deine ersten Minecraft Server hinzu:
/addserver name="Mein Server" ip="server.de"
port=25565 version="1.20.4"
description="Ein toller Minecraft Server"
Voting aktivieren
Richte das Voting-System für deine Community ein:
/autopost_setup channel=#server-voting
post_type=top_daily
Deine Community kann jetzt täglich für Server voten!
⌨️ Komplette Befehlsübersicht
📋 Setup & Einrichtung
| Befehl | Beschreibung | Beispiel |
|---|---|---|
/setup_database |
Datenbank-Verbindung einrichten | /setup_database host:localhost database:minecraft |
/db_status |
Datenbank-Status prüfen | /db_status |
🌐 Server Management
| Befehl | Beschreibung | Beispiel |
|---|---|---|
/addserver |
Server hinzufügen | /addserver name:"SkyBlock" ip:play.skyblock.de |
/servers |
Alle Server anzeigen | /servers page:2 |
/serverinfo |
Server-Details anzeigen | /serverinfo 42 |
/search |
Server suchen | /search SkyBlock |
🗳️ Voting System
| Befehl | Beschreibung | Beispiel |
|---|---|---|
/vote |
Für Server voten | /vote 42 |
/top |
Top Server anzeigen | /top |
/myvotes |
Eigene Votes anzeigen | /myvotes |
/random |
Zufälligen Server vorschlagen | /random |
/autopost_setup |
Auto-Posts einrichten | /autopost_setup #channel new_server |
⚙️ Admin Befehle
| Befehl | Beschreibung | Beispiel |
|---|---|---|
/settings |
Admin Dashboard öffnen | /settings |
/set_admin_role |
Admin-Rolle festlegen | /set_admin_role role:@Admin |
/server_verify |
Server verifizieren | /server_verify 42 |
/server_feature |
Server hervorheben | /server_feature 42 |
/server_delete |
Server löschen | /server_delete 42 |
📊 Info & Statistiken
| Befehl | Beschreibung | Beispiel |
|---|---|---|
/stats |
Statistiken anzeigen | /stats |
/ping |
Latenz testen | /ping |
/status |
Detaillierten Status anzeigen | /status |
/invite |
Einladungslink erstellen | /invite |
/help |
Hilfe anzeigen | /help |
🎯 Befehle richtig nutzen
- Tippe
/in Discord um alle Befehle zu sehen - Verwende Tab zum Auto-Vervollständigen
- Füge Anführungszeichen für Texte mit Leerzeichen hinzu:
name:"Mein Server" - Nutze help nach jedem Befehl für Details:
/addserver help
🔧 Problembehandlung
❌ Bot antwortet nicht
Mögliche Ursachen:
- Bot hat keine Berechtigungen
- Discord API Probleme
- Bot ist offline
Lösung:
- Prüfe Bot-Berechtigungen
- Nutze
/pingzum Testen - Prüfe Discord Status
💾 Datenbank-Fehler
Mögliche Ursachen:
- Falsche Zugangsdaten
- Firewall blockiert Verbindung
- Datenbank-Server offline
Lösung:
- Mit
/db_statusprüfen - Zugangsdaten überprüfen
- Port 3306 freigeben
- Datenbank-Hoster kontaktieren
⌨️ Commands nicht sichtbar
Mögliche Ursachen:
- Commands nicht gesynct
- Cache Probleme
- Discord Bug
Lösung:
- Discord neustarten
- Server wechseln und zurück
/reload(Owner only)- 24h warten (Discord Cache)
🐌 Langsame Performance
Mögliche Ursachen:
- Hohe Discord Latenz
- Langsame Datenbank
- Viele Server gleichzeitig
Lösung:
/pingfür Latenz testen- Datenbank optimieren
- Keine massenhaften Aktionen
🔒 Keine Berechtigung
Problem:
Du kannst keine Admin-Befehle nutzen.
Lösung:
- Der Server Owner muss dir die Rolle zuweisen.
- Befehl:
/set_admin_role @DeineRolle - Oder du benötigst "Administrator" Rechte in Discord.
🚨 Notfall-Kontakt
Wenn nichts mehr geht:
- Bot neu einladen: Alten Bot entfernen und neu hinzufügen
- Datenbank-Cache leeren: MySQL Query:
FLUSH TABLES; - Support kontaktieren: mail@ten3.dev
Bitte beschreibe dein Problem genau und füge Screenshots bei.
❓ Häufige Fragen (FAQ)
🤔 Ist CactusBot kostenlos?
Ja, 100% kostenlos! CactusBot ist dauerhaft kostenfrei. Du bezahlst nur für deine eigene Datenbank (falls du keinen kostenlosen Hosting-Service nutzt).
🔐 Wo werden meine Daten gespeichert?
In deiner eigenen Datenbank! CactusBot speichert keine Daten auf seinen Servern. Alle Daten (Server, Votes, Statistiken) werden ausschließlich in der von dir bereitgestellten MySQL/MariaDB Datenbank gespeichert.
🌐 Welche Datenbank wird benötigt?
MySQL oder MariaDB mit mindestens Version 5.7. Die Datenbank muss über das Internet erreichbar sein (für Discord Cloud). Du kannst kostenlose Hosting-Angebote nutzen oder deine eigene Datenbank hosten.
📊 Wie viele Server kann ich hinzufügen?
Unbegrenzt! Es gibt keine Beschränkung für die Anzahl der Server. Die Leistung hängt nur von deiner Datenbank ab.
⚙️ Welche Berechtigungen benötigt der Bot?
Minimale Berechtigungen: Nachrichten lesen/senden, Embed-Links, Slash Commands. Für alle Features empfehlen wir Administrator-Berechtigungen.
🖥️ Was ist das Admin Dashboard?
Das Dashboard ist ein interaktives Menü, das du mit /settings öffnest. Hier kannst
du bequem Einstellungen vornehmen, den Status prüfen und Hilfestellungen erhalten, ohne Befehle
tippen zu müssen.
🤔 Kann ich den Bot auch ohne eigene Website nutzen?
Ja! Der Bot funktioniert komplett eigenständig. Du brauchst nur eine Datenbank. Eine Website ist optional, wenn du z.B. deine Serverliste auch im Web anzeigen möchtest.
🔄 Wie oft kann man voten?
Einmal alle 24 Stunden pro Server. Jeder Nutzer kann jeden Tag für jeden Server einmal voten. Das Voting-Reset erfolgt um 0:00 Uhr (UTC).
📈 Werden Statistiken gespeichert?
Ja, in deiner Datenbank. Alle Statistiken (Votes, Views, Server-Status) werden in deiner Datenbank gespeichert und können von dir exportiert oder analysiert werden.
🔗 Gibt es eine API?
In Entwicklung. Eine REST API für die Integration in Websites und Apps ist geplant. Aktuell ist der vollständige Funktionsumfang nur über Discord verfügbar.
👨💻 Wer entwickelt CactusBot?
CactusBot wird von ten3 DEV HUB (Oskar Balthasar & Nicolas P. Acker) entwickelt. Wir sind erfahrene Discord Bot Entwickler mit Fokus auf Minecraft-Communities.