Zum Hauptinhalt springen

Bots auf SCNX

Diese Dokumente beinhalten anwendbare Hilfen für den Eigenen Bot und den Modmail Bot - wenn du diese Bots einstellen willst, befolge bitte den mit dem eigenen Bot loslegen oder den mit dem Modmail-Bot loslegen Artikel.

Fehlerbehebung​

Die Schritte, um Fehler zu beheben, sind bei den beiden Bots unterschiedlich. Bitte schaue dir den passenden Abschnitt an:

Die Grundlagen​

Jeder Bot auf SCNX ist ein eigener Prozess, der auf einem echten Server ausgeführt wird. Du kannst den Status im Bot-Status-Panel von deinem Modmail- oder Eigenen-Bot- Dashboard einsehen.

Hier ist ein Beispiel von einem eigenen Bot-Status-Panel:

Wie du sehen kannst, gibt es hier bereits einige Möglichkeiten. Hier sind die wichtigsten Informationen über das Panel:

  • Der Tag und das Profilbild deines Bots (nur sichtbar, wenn dein Bot online ist). Um das Profil deines Bots zu verändern, klicke auf dieses oder befolge diesen Artikel.
  • "Konfiguration neuladen": Wenn du deine Konfiguration neulädst, wird dein Bot alle ausstehenden Änderungen an Konfigurationsdateien übernehmen (auch Modul-Änderungen) ohne dass der Bot offline geht. Generell solltest du lieber die Konfiguration neuladen, als den Bot neuzustarten.
  • "Bot neustarten": Dies wird den Prozess deines Bots neustarten. Dies wird eventuell einige Minuten in Anspruch nehmen, zusätzlich wird der Bot für eine kurze Zeit offline sein, in welcher der Bot nicht erreichbar sein wird. Du solltest deinen Bot nur neustarten, wenn du dazu aufgefordert wirst, seltsame Fehler auftreten oder du ein Update durchführen willst.
  • "Bot anhalten": Dies wird den Prozess deines Bots beenden. Er wird nicht auf Discord erreichbar sein. Es kann bis zu 5 Minuten dauern, bis der Bot in Discord als offline angezeigt wird.
  • "Log" / "Fehler-Log": In diesen Log-Dateien wird dein Bot dokumentieren, was er macht und wird die Gründe von Fehlern und Problemen aufschreiben. Unser Team (und technische Experten) benötigen diese Logs, um eventuelle Probleme zu analysieren und dir eine Lösung vorzuschlagen - oder, falls es Fehler im Bot selbst sind, diese zu reparieren. Eventuell wirst du gefragt, die Logs zu teilen.
  • Sprache: Das ist die (menschliche) Sprache die dein Bot für alle Standardkonfigurationswerte und Nachrichten, die nicht konfiguriert werden können, nutzt. Der Modmail kann in manchen Fällen die Sprache des ausführenden Nutzer benutzen, statt der hier eingestellten Sprache. Du kannst jederzeit die Sprache deines Bots ändern.
  • Server: Dies ist der physische Server - auch Bot-Host genannt - auf dem dein Bot betrieben wird. Du kannst den Bot-Host wechseln, wenn du möchtest.
  • Branch (nur beim eigenen Bot verfügbar): Der aktuelle Zweig (englisch "branch") ist eine Version deines eigenen Bots auf einer anderen Programmier-Basis. Du solltest es diesen bei "v3" (Stabile Version) belassen, aber wenn du willst, kannst du auch zu dem "Beta"-Branch wechseln (das ist die öffentliche Beta; kann aber instabil sein).
  • Version (nur bei eigenen Bots sichtbar): Dies ist die aktuelle Version des Codes deines Bots. Abhängig von deiner Version wird dein Bot eventuell neue Funktionen nicht nutzen können. Wenn deine Version nicht aktuell ist, wird eine Warnung angezeigt. Dein Modmail-Bot wird immer automatisch auf den neusten Stand aktualisiert. Erfahre mehr über Updates & Versionen.
  • RAM / CPU: Dies wird direkt unter dem "Online"-Status angezeigt. Du kannst sie ohne Sorgen ignorieren, sie zeigen nur die RAM / CPU Nutzung deines Bots an. Diese sind irrelevant, da SCNX automatisch deinen Bot optimiert, falls dein Bot zu viel RAM frisst als er tun sollte.

Bot-Updates​

  • Wir veröffentlichen regelmäßig Updates für Discord-Bots - wir fassen meist mehrere Funktionen in einem Update für die stabile Version zusammen. Für die Öffentliche Beta gibt es viele Veröffentlichungen mit weniger Änderungen pro Veröffentlichung, manchmal mehrere an einem Tag.
  • Dein Bot wird eine Nachricht in deinen Bot-Log-Channel (falls eingestellt) senden, wenn ein neues Update verfügbar ist.
  • Wir kündigen jedes Update auf unserem Discord-Server an und senden einen Link zu einem Änderungsbericht.
  • Du findest alle Änderungsberichte in deinem Bot-Dashboard und auf unserer Änderungsberichte-Seite.
  • Um die neuste Version des Bots zu nutzen, starte den Bot ganz einfach in deinem Bot-Dashboard neu. Updates Updates sind immer kostenlos.
  • Du wirst keine neuen Funktionen nutzen können, wenn dein Bot nicht auf der aktuellsten Version ist, bis du deinen Bot auf die neuste Version bringst.

Teilnahme an der öffentlichen Beta​

Bevor du die öffentliche Beta verwendest, beachte bitte:

  • Die öffentliche Beta kann instabil sein. Das bedeutet, dass es passieren kann, dass dein Bot abstürzt oder neue Funktionen nicht korrekt funktionieren.
  • Manche neue Funktionen in der Beta sind noch nicht übersetzt. Das bedeutet, dass dein Bot eventuell Englisch spricht, anstatt deine voreingestellte Sprache.
  • Da du die öffentliche Beta jederzeit verlassen kannst, kann es sein, dass dein Bot kaputt geht wenn die Beta-Version eine höhere Veröffentlichungsnummer als die ältere Version hat. Darüber hinaus könnten Konfigurationsdateien nach dem Zurückschalten beschädigt sein und müssen zurückgesetzt werden, was zu Datenverlust führt.

So kannst du die eigene Bot Beta verwenden:

  1. Öffne das Bot-Dashboard.
  2. In dem Status-Panel, klicke auf "Wechseln" dann auf "Branch"-Einstellungen.
  3. Wähle "Öffentliche Beta (kann instabil sein)" aus.
  4. Bestätige die Änderung, indem du auf "Speichern" klickst.
  5. Um Benachrichtigungen über die Veröffentlichung von neuen Beta-Version auf unserem Discord zu erhalten, aktiviere die Beta-Kanäle in #beta.

So kannst du die Beta-Version deaktivieren:

  1. Öffne das Bot-Dashboard.
  2. Klicke in dem Status-Panel auf "Ändern" dann auf "Branch"-Einstellung.
  3. Wähle "Stabile Version (empfohlen)" aus.
  4. Bestätige die Änderung, indem du auf "Speichern" klickst.

Den Bot-Host wechseln​

Der Bot-Host ist der physische Server, auf dem dein Bot läuft. Wir bieten viele rund um die Welt verteilte Bot-Hosts an. So kannst du den Bot-Host wechseln:

  1. Öffne das Modmail- oder das eigene Bot- Dashboard.
  2. Klicke als Nächstes auf "Wechseln" in dem "Status" Bereich.
  3. Wähle den Bot-Host aus, auf den du Wechseln willst.
  4. Klicke auf "Bestätigen".
Was ist der Unterschied zwischen dem "Premium" und den anderen Bot-Hosts?
  • Die meisten premium Bot-Hosts liegen in Nord Amerika und haben eine schnellere Verbindung zu der Infrastruktur von Discord.
  • Die Infrastruktur von Premium-Hosts haben höhere Zuverlässigkeit, höhere Bandbreite und mehr.
  • Jedem Bot auf Premium Bot-Hosts werden mehr Ressourcen zugewiesen.
  • Premium Bot-Hosts können doppelt so viele Backups speichern und lagern sie wo anders als die anderen Bot-Hosts.
Welcher Bot-Host ist der beste? / Welchen Bot-Host sollte ich nehmen?

Letzten Endes ist es egal (bis auf die Premium-Server). Jeder Bot-Host ist dafür da, Bots wie deinen, zu hosten. Wir haben hohe Standards bei den Bot-Hosts und können versichern, dass alle das gleiche Erlebnis bieten. Eventuell werden wir deinen Bot zwischen den Bot-Hosts verschieben, wenn du keinen bezahlten Plan hast, um Ressourcen zu sparen.

Ich wurde gebeten, bestimmte europäische Datenschutzrechte aufzugeben, wenn ich meinen Bot außerhalb der EU verlagere

Wenn du die Daten deines Bots außerhalb der Europäischen Union verschiebst, gilt die Datenschutz-Grundverordnung nicht mehr für deine Daten. Dies betrifft nur die Daten deines Bots, wie Leveling-Stats, Konfiguration und das eigentliche Hosting deines Bots. Bitte bedenke auch, dass Discord selbst die meisten deiner Daten auch außerhalb der EU speichert und wir nur mit vertrauenswürdigen Hosting-Anbietern mit hohen Sicherheits- und Datenschutzstandards zusammenarbeiten; Es gelten die Datenschutzgesetze des jeweiligen Landes. Dies bedeutet manchmal, dass wir deine Daten nicht vor der Nutzung und/oder Einsichtnahme durch staatliche Stellen schützen können. Da es gesetzlich vorgeschrieben ist (zumindest für unsere EU-Kunden ♥), musst du einer solchen Datenübermittlung zustimmen. Du kannst den Hosting-Standort deines Bots jederzeit wieder auf Bot-Host innerhalb der EU umstellen.

Die Bot-Sprache ändern​

Die (menschliche) Sprache wird für alle Standardtkonfigurationwerte und Nachrichten, die nicht eingestellt werden können, verwendet. Es kann vorkommen, dass der Modmail Bot nicht diese, sondern die Sprache des ausführenden Nutzers verwendet.

Info

Beachte bitte, dass du beim Wechseln der Bot-Sprache nicht bereits erstellte Dateien neu generierst - du müsstest die Datei zurücksetzen oder es selbst übersetzen.

Um die Sprache deines Bots zu ändern,

  1. Öffne das Modmail- oder das eigene Bot- Dashboard.
  2. Klicke unter "Bot-Status" bei der Sprache deines Bots auf "Wechseln".
  3. Wähle die Sprache aus, zu welcher du wechseln möchtest.
  4. Speichere die Änderungen. Dein Bot wird automatisch neustarten, um die Änderungen anzunehmen.

Die Sprache von meinem Server wird nicht unterstützt

Wir entschuldigen uns, dass deine Serversprache nicht auf SCNX verfügbar ist, aber das Scootkit Team ist sehr klein und wir haben aktuell wirklich begrenzte Resourcen und können nicht aktuell keine Unterstützung für andere Sprachen außer Englisch und Deutsch anbieten. Du kannst gerne unser Team fragen, ob du beim Überstetzen mithelfen kannst, aber verstehe bitte, dass wir nicht jede Anfrage annehmen können. Wir würden gerne jede Sprache dieser Welt unterstützen, aber aktuell müssen wir uns auf unsere momentane Zielgruppen fokusieren.

Erwähnung von SCNX entfernen​

In diesen Plänen enthalten

Nicht im Starter-Plan enthalten (für immer kostenfrei)
Not included in the Unlimited Plan (4,99 € / Monat)
Not included in the Professional Plan (7,99 € / Monat)
SCNX Pläne vergleichenSCNX Plan upgradenMehr über Preise auf SCNX erfahren
Finale Preise hängen von deiner Währung und deinem Zahlungs-Interval ab und werden dir vor dem Kauf angezeigt.

Du kannst die Fußzeile jeder Nachricht, die du auf SCNX bearbeiten kannst, anpassen. Um nicht immer manuell die Fußzeile zu ändern oder die Fußzeile von voreingestellte Nachricht, die du nicht Bearbeiten kannst, anzupassen, kannst du einen globalen Standard-Fußzeilenwert setzen.

Um das "Powered by scnx.xyz ⚡" von jedem Embed von deinem Bot zu entfernen, folge bitte diesen Schritten:

  1. Öffne die Nachrichten & Aussehen Konfigurationsdatei von der Eingebauten-Konfiguration deines Bots.
  2. Verändere den Wert des Felder "Embed-Footer" und "Embed-Footer-Image-URL" nach deinen Wünschen.
  3. Speichere die Änderungen & starte deinen Bot neu um die Änderungen anzunehmen.

Namen, das Über mich oder Profilbild meines Bot ändern​

Bevor du weiterliest:
  • Damit dies funktioniert muss dein Bot auf SCNX online sein. Wenn dein Bot nicht auf SCNX online sein sollte, schaue bitte in die Anleitung zur Fehlerbehebung.
  • Wenn du nicht der Inhaber von dem Server bist, musst du die Trusted-Admin Berechtigung "Bot verwalten" auf dem Produkt haben, dessen Einstellungen du ändern möchtest.

So kannst du das Profil-Bild und den Nutzernamen deines Bots ändern, ohne SCNX zu verlassen:

  1. Öffne das Modmail- oder Eigener Bot- Dashboard.
  2. Als Nächstes klicke auf den Namen des Bots in deinem Bot-Status-Panel (wenn du einen der Links oben nutzt, kannst du diesen Schritte überspringen, das Pop-Out wird sich automatisch öffnen).
  3. Nun kannst du an dem Bot ändern, was du möchtest. Du wirst eine Vorschau des Profils sehen.
  4. Speichere die Änderungen.
  5. Es kann ein paar Minuten dauern, bis deine Änderungen auch auf Discord angezeigt werden, also gedulde dich bitte.

Ein Fehler erscheint, wenn ich versuche, das Profil meines Bots zu ändern
  • Bitte stelle sicher, dass dein Bot online ist und ohne Fehler läuft. Wenn dies nicht der Fall sein sollte, schaue dir bitte unsere Anleitung zur Fehlerbehebung an.
  • Manche Namen sind reserviert oder wurden bereits zu oft genutzt und können nicht für deinen Bot verwendet werden. Versuche es bitte mit einem anderen, weniger beliebten, Namen erneut.
  • Wenn du ein Profilbild für deinen Bot hochlädst, verbraucht dies deinen Nutzerspeicher. Bitte öffne das Datein-Dashboard und schaue nach ob genug Platz für dein neues Profil-Bild vorhanden ist.
  • Du (oder dein Bot) könnten rate-limitiert sein. Bitte versuche es in 1-4 Stunden erneut.
  • Du wirst den genauen Grund in dem Log deines Bots finden. Bitte teile deine Logs und versuche den Fehler darin zu finden. Wenn du ihn nicht findest, kontaktiere bitte unser Team.

Meinen Bot einladen​

Bevor du weiterliest

Dafür muss dein Bot online sein. Wenn dein Bot nicht auf SCNX online ist, öffne bitte den Abschnitt „Der Bot ist nicht auf meinem Server“ im unserem Leitfaden zur Fehlerbehebung.

Warnung

Dein Bot wird nicht auf anderen Servern funktionieren, als auf dem Server, für den der Bot erstellt wurde. Wenn du deinen Server wechseln willst, befolge bitte die Anleitung zum Übertragen von SCNX-Daten in unserem FAQ. Wenn du einen seperaten Bot für einen anderen Server erstellen möchtest, füge deinen Server zu SCNX hinzu und erstelle dann einen eigenen Bot.

  1. Öffne das Modmail- oder das eigene Bot- Dashboard.
  2. Klicke anschließend in der Bot-Statuskarte auf „Erweiterte Optionen“.
  3. Klicke auf "Invite-URL anzeigen" und klicke dann auf "Invite-URL kopieren".
  4. Klicke auf "Abbrechen".

Logs teilen​

Bevor wir loslegen, eine kurze Erklärung darüber, was Logs überhaupt sind und warum du sie teilen solltest. Jeder Bot hat seinen eigenen Prozess auf SCNX, der auf einem echten, physischen Server verwaltet wird. Während dein Bot läuft, produziert dieser Prozess solche Log-Datein. In diesen Datein dokumentiert dein Bot, alles, was was er macht und schreibt den Grund für Fehlern auf. Unser Team benötigt diese Logs. um eventuelle Probleme zu diagnostizieren und dir eine Lösung anzubieten - oder um, wenn es Fehler direkt am Bot, ist - diese zu beheben.

Info

Bot Logs zu Teilen, ist eine „Einmalige Erfassung“ davon - geteilte Logs werden nicht aktualisiert, wenn dein Bot etwas Neues dokumentiert. Die geteilten Logs werden nach 7 Tagen, nachdem du sie geteilt hast, gelöscht. Logs beinhalten meinst keine privaten Informationen, aber bitte schaue trotzdem darüber, bevor du sie veröffentlichst.

Warnung

Bitte verschwende nicht die Zeit unseres Teams, falls du einen Fehler in den Logs findest. Es ist normal, dass dein Bot manchmal Fehler dokumentiert. Wir erhalten diese automatisch, und werden diese beheben. Teile Logs bitte nur, wenn du wirklich Probleme am Bot feststellst.

So kannst du die Bot Logs teilen:

  1. Öffne das Modmail- oder das eigene Bot- Dashboard.
  2. Als Nächstes klicke auf "Mehr Optionen" in deinem Bot-Status-Panel.
  3. Klicke auf "Teile deine Bot-Logs" und danach auf "Logs teilen". Dein Bot-Host wird nun die Logs auf paste.scootkit.net hochladen, dies kann ein paar Sekunden dauern.
  4. Kopiere beide Log-URLs (Log und Fehler-Log) und sende beide an unser Team. Wenn du technische Erfahrung hast, kannst eventuell Fehler durch die Logs selbst beheben.

Den Bot-Token ändern​

Gefahr

Du kannst deinen Bot Token nur in deinem Bot Dashboard ändern. Sende niemals deinen Token an einem anderen Nutzer, Trusted-Admin oder einen unserer Teammitglieder. Behandele deinen Token wie ein Passwort - Nutzer mit dem Zugriff auf deinen Token können Änderungen an deinem Bot und Server vornehmen.

Warnung
  • Du musst der Besitzer des Servers sein, um den Bot-Token zu ändern.
  • Das Ändern deines Bot Tokens wird keine Probleme lösen. Bitte nutze die Anleitung zur Fehlerbehebung, um Fehler zu erkennen und zu beheben.
  • Wenn du den Namen oder das Profilbild deines Bots ändern willst, folge dieser Anleitung.
  • Das Wechseln des Bot-Tokens kann neue Fehler produzieren. Vermeide deswegen bitte das Wechseln des Tokens.

Du kannst den Bot Token ändern, ohne deinen Bot von SCNX löschen zu müssen. Befolge dazu bitte folgende Schritte:

  1. Öffne das Discord Developer Panel und erhalte einen neuen Token: Als Erstes wählst du die "Application" aus, dann gehst du auf die "Bot"-Seite und klickst auf "Generate new token", und kopierst ihn.
  2. Öffne das Modmail- oder das eigene Bot- Dashboard.
  3. Klicke auf "Mehr Optionen" in dem "Status"-Panel von deinem Bot.
  4. Klicke auf "Bot-Token ändern".
  5. Füge deinen neuen Bot-Token ein und bestätige die Änderung, indem du auf "Token ändern" klickst.
  6. Dein Bot Token wird gespeichert und dein Bot wird neu gestartet, um die Änderungen zu speichern.

Falls dein Bot danach nicht mehr Funktionieren sollte, befolge bitte die Anleitung zur Fehlerbehebung.

Bot Löschen​

Gefahr

Wenn du deinen Bot löschst, wird dies nicht nur für immer die Bot Konfiguration löschen, sondern wird auch alle Daten löschen (wie Level von Nutzern oder Ticket-Daten).

Warnung
  • Du musst der Inhaber des Servers sein, um den Bot zu löschen.
  • Löschen des Bots wird höchstwahrscheinlich keine Probleme lösen. Bitte nutze die Anleitung zur Fehlerbehebung, um Fehler zu diagnostizieren und zu beheben.
  • Wenn du den Nutzernamen oder das Profilbild deines Bots ändern willst, folge dieser Anleitung.

Es tut uns leid, dass du SCNX verlassen willst - wenn du Probleme mit SCNX hast, helfen wir dir gerne auf unserem Discord.

Um deinen Bot (für immer) zu löschen, folge dieser Anleitung:

  1. Öffne das Modmail- oder das eigene Bot- Dashboard.
  2. Als Nächstes, klicke auf "Mehr Optionen" in dem Bot-Status-Panel.
  3. Wähle "Bot löschen" aus.
  4. Du wirst aufgefordert, einen Grund für die Löschung anzugeben (du musst ihn nicht näher erläutern). Als Nächstes starte deine Anfrage mit dem „Bot-Löschanfrage initiieren“-Knopf.
  5. Du wirst eine PN erhalten, um deine Löschanfrage zu bestätigen. Nutze den Knopf unterhalb der Nachricht, um die Datenlöschung durchzuführen.
  6. Nach der Bestätigung löscht unser System deinen Bot von SCNX. Dies kann 1–5 Minuten dauern.
  7. Du wirst eine Bestätigung erhalten, sobald wir deinen Bot aus SCNX gelöscht haben.