📚 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

1

Bot zu Discord hinzufügen

Klicke auf den Button unten, um CactusBot zu deinem Discord Server hinzuzufügen:

Bot zu Discord hinzufügen

Du benötigst Administrator-Berechtigungen auf dem Discord Server.

2

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!

3

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"
4

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:

  1. Prüfe Bot-Berechtigungen
  2. Nutze /ping zum Testen
  3. Prüfe Discord Status

💾 Datenbank-Fehler

Mögliche Ursachen:

  • Falsche Zugangsdaten
  • Firewall blockiert Verbindung
  • Datenbank-Server offline

Lösung:

  1. Mit /db_status prüfen
  2. Zugangsdaten überprüfen
  3. Port 3306 freigeben
  4. Datenbank-Hoster kontaktieren

⌨️ Commands nicht sichtbar

Mögliche Ursachen:

  • Commands nicht gesynct
  • Cache Probleme
  • Discord Bug

Lösung:

  1. Discord neustarten
  2. Server wechseln und zurück
  3. /reload (Owner only)
  4. 24h warten (Discord Cache)

🐌 Langsame Performance

Mögliche Ursachen:

  • Hohe Discord Latenz
  • Langsame Datenbank
  • Viele Server gleichzeitig

Lösung:

  1. /ping für Latenz testen
  2. Datenbank optimieren
  3. Keine massenhaften Aktionen

🔒 Keine Berechtigung

Problem:

Du kannst keine Admin-Befehle nutzen.

Lösung:

  1. Der Server Owner muss dir die Rolle zuweisen.
  2. Befehl: /set_admin_role @DeineRolle
  3. Oder du benötigst "Administrator" Rechte in Discord.

🚨 Notfall-Kontakt

Wenn nichts mehr geht:

  1. Bot neu einladen: Alten Bot entfernen und neu hinzufügen
  2. Datenbank-Cache leeren: MySQL Query: FLUSH TABLES;
  3. 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.

❓ Noch Fragen?

Wir helfen gerne weiter!