Chat-Bot (Discord und Telegram)

Der Chat-Bot verbindet Lords Bot mit deinem eigenen Discord- oder Telegram-Bot. Aus dem Chat heraus kannst du sehen, welche Accounts online sind, Accounts starten und anhalten, Logs und einen Screenshot abrufen und Benachrichtigungen bekommen, zum Beispiel über einen abgelaufenen Access Key. Gildenmitglieder können außerdem die Gildenbank aus dem Chat nutzen.

So funktioniert es #

1. Erstelle deinen eigenen Bot auf Discord oder Telegram und kopiere seinen Token.
2. Verbinde ihn: Füge den Token in Lords Bot ein und klicke auf Verbinden (Connect).
3. Wähle deinen Chat: Schick !set in den Kanal oder die Gruppe, die du nutzen willst. Damit wirst du Admin des Chat-Bots.
4. Nutze ihn: Steuere deine Accounts mit Befehlen, bekomm Benachrichtigungen und lass deine Gilde die Bank aus dem Chat nutzen.

Den Chat-Bot einrichten #

Öffne im Hauptfenster Einstellungen > Optionen > Weitere Einstellungen (Settings > Options > Other Settings) und geh zum Tab Chat Bot. Folge dann den Schritten für Discord oder Telegram.

Discord #

1. Geh auf https://discord.com/developers/applications und erstelle eine neue Application.
2. Öffne die Seite Bot der Application und kopiere den Token des Bots. Halte den Token geheim.
3. Schalte auf derselben Seite den Message Content Intent ein. Lords Bot braucht ihn, um Befehle zu lesen. Speichere deine Änderungen. Ist sie aus, stoppt Lords Bot mit einem Fehler, der dir sagt, sie einzuschalten.
4. Füge in Lords Bot den Token bei Bot-Token: (Bot Token:) ein, wähle Discord und klicke auf Verbinden.
5. Wenn der Status Discord verbunden (Discord Connected) zeigt, klicke auf Füge Bot zu Discord (Add Bot to Discord) und füge den Bot zu deinem Server hinzu.

Tipp: Wenn Discord meldet, dass die Integration „requires code grant“, geh zurück ins Developer Portal und schalte die Option OAuth2 Code Grant für deinen Bot aus.

Telegram #

1. Öffne https://t.me/BotFather in Telegram und schick /newbot.
2. Wähle einen Namen und dann einen Benutzernamen, der auf bot endet. BotFather schickt dir den Token des Bots.
3. Schick /setprivacy an BotFather, wähle deinen Bot und dann Disable. So kann der Bot in Gruppen Nachrichten lesen, die mit ! anfangen.
4. Füge in Lords Bot den Token bei Bot-Token: ein, wähle Telegram und klicke auf Verbinden.
5. Wenn der Status Telegram verbunden (Telegram Connected) zeigt, klicke auf Füge Bot zu Telegram (Add Bot to Telegram) und füge den Bot zu deiner Gruppe hinzu.

Nur bei Telegram kannst du Nutze Proxy? (Use Proxy?) anhaken und einen deiner Proxies für die Verbindung des Chat-Bots wählen.

Deinen Chat zuweisen #

Befehle funktionieren erst, wenn du den Bot mit einem Chat verknüpft hast:

1. Schick im Discord-Kanal oder in der Telegram-Gruppe, die du nutzen willst, !set (oder /set).
2. Der Bot antwortet Gruppe erfolgreich zugewiesen! (Group assigned successfully!)

Der Chat, in dem du set geschickt hast, ist jetzt der Chat des Chat-Bots, und du bist sein Admin. Nur der Admin kann die Chat-Bot-Befehle nutzen, und nur in diesem Chat. Auf Discord erscheinen die Befehle nach set auch als Slash-Befehle auf diesem Server.

Der Admin des Chat-Bots (wer set geschickt hat) ist nicht dasselbe wie die autorisierten Nutzer einer Gildenbank. Die werden für jede Bank auf ihrem Tab Autorisierte Nutzer (Authorized Users) eingetragen.

Um den Chat-Bot in einen anderen Chat umzuziehen, schick /cleargroup im aktuellen Chat oder klicke auf dem Tab Chat Bot auf Lösche Daten (Clear Data), und schick dann set im neuen Chat.

Weitere Buttons auf dem Tab Chat Bot #

Element	Was es macht
Verbindung trennen (Disconnect)	Trennt die Verbindung des Chat-Bots.
Loganzeige (View Log)	Zeigt das Verbindungslog des Chat-Bots. Sieh dort nach, wenn der Status Etwas ist schief gelaufen, bitte Log kontrollieren (Something went wrong, check log) sagt.
Lösche Daten	Vergisst den zugewiesenen Chat und den Admin.
Neue Versionen im Chat melden (Post new versions in chat)	Postet die neue Versionsnummer einmal im Chat, wenn ein Update erschienen ist. Standard: an.
Infofeld	Zeigt die Chat-ID (Chat ID), die Admin-ID (Admin ID) und auf Discord die Gilden ID (Guild ID, dein Server).

Kann sich der Chat-Bot nicht verbinden, versucht er es nach 15 Sekunden erneut und wartet dann jedes Mal länger, bis zu alle 5 Minuten. Ein falscher Token oder eine ausgeschaltete Message Content Intent bei Discord stoppt ihn stattdessen mit einem Fehler.

Befehle #

Nur der Admin des Chat-Bots kann diese nutzen, in dem Chat, der mit set festgelegt wurde. Befehle können mit /, ! oder , anfangen. Auf Discord sind sie auch Slash-Befehle, und das Account-Feld schlägt beim Tippen Account-Namen vor.

Auf Discord sehen nur Servermitglieder mit der Berechtigung Server verwalten (Manage Server) die Slash-Befehle. Um sie einer anderen Rolle zu zeigen, öffne Servereinstellungen > Integrationen (Server Settings > Integrations), wähle deinen Bot und erlaube diese Rolle. Das Account-Feld findet jeden Teil eines Namens oder den Anfang einer IGG ID und zeigt, ob der Account läuft. Kann ein Befehl nicht benutzt werden, siehst nur du die Antwort.

Auf Telegram tippst du auf die /-Menütaste neben dem Nachrichtenfeld, um einen Befehl zu wählen. Sendest du /start, /stop, /restart, /info, /log oder /shortlog ohne Account, antwortet der Bot mit einer Schaltfläche pro Account; tippe auf eine, um den Befehl für diesen Account auszuführen.

Wenn jemand anderes als der Admin einen Befehl nutzt, antwortet der Bot Du bist nicht autorisiert diesen Befehl zu verwenden (You are not authorized to use that command). In jedem anderen Chat antwortet er Admin Kommandos können nur in dem Chat genutzt werden, in dem /Set benutzt wurde. (Admin Commands can only be used in the chat where: /Set was used.) Die Ausnahme ist /setcastle, das der Admin in jedem Chat nutzen kann, in dem der Bot ist.

Gildenbank im Chat #

Die Gildenbank kann Befehle in jedem Discord-Kanal und jeder Telegram-Gruppe beantworten, in denen dein Chat-Bot ist, nicht nur im Admin-Chat. Wiederhole diese Schritte für jede Bank.

Eine Bank zu einem Chat hinzufügen (Admin) #

Schick im Gruppenchat /setcastle und danach den Namen oder die IGG ID des Bank-Accounts, zum Beispiel /setcastle MyBank. Der Bot antwortet Account wurde Chat zugewiesen (Account Assigned to Chat). Um sie wieder zu entfernen, schick /unsetcastle MyBank im Admin-Chat des Chat-Bots.

Als Bank-Nutzer registrieren (jeder Spieler) #

Jeder Spieler verknüpft seinen Discord- oder Telegram-Account einmal mit seinem Namen im Spiel:

1. Schick im Gruppenchat einen Bank-Befehl wie !bal. (Nutze das Präfix der Bank, falls es nicht mehr ! ist.)
2. Der Bot antwortet mit Bitte sende der Bank: (Please send the bank:) und einem Befehl wie !reguser 123456789.
3. Schick genau diesen Befehl im Spiel an die Bank, im Gildenchat oder per Post. Die Bank antwortet Messenger Account registriert (Social account registered).
4. Schick !bal noch einmal im Gruppenchat. Du bekommst dein Guthaben.

Jetzt kannst du jeden Bank-Befehl, den dein Rang erlaubt, aus dem Chat nutzen. Um die Verknüpfung aufzuheben, schick !unreguser im Spiel an die Bank. Die vollständige Liste findest du unter Gildenbank-Befehle.

Hinweis: Chat-Bot-Befehle werden zuerst gelesen. Ein Bank-Befehl mit demselben Namen wie ein Chat-Bot-Befehl, zum Beispiel !stop, wird im Chat als Chat-Bot-Befehl behandelt. Schick solche Bank-Befehle stattdessen im Spiel.

Account-Benachrichtigungen #

Der Chat-Bot kann Account-Benachrichtigungen im Admin-Chat posten. Schalte sie pro Account ein: Öffne das Fenster des Accounts und geh zu Einstellungen > Allgemein > Erweitert (Settings > General > Advanced), dann zur Gruppe Chat Bot. Mit Globale Einstellungen oder einer Vorlage stellst du viele Accounts auf einmal ein.

Option	Was sie postet
Sende Status in Chatbot (Post Status in Chatbot)	Schaltet die Chat-Bot-Benachrichtigungen für diesen Account ein.
Ablauf Access Key (Access Key Expiry)	Wenn der Access Key abläuft, erneuert wird oder nicht erneuert werden kann.
Änderung des Verbindungsstatus (Connection Status Change)	Wenn der Account offline geht (einmal pro Ausfall), wenn er wieder da ist, und bei der ersten Verbindung, nachdem du ihn gestartet hast.
Erst nach offline seit (Min.) (Only after offline for (min))	Über 0 wartet der Bot so viele Minuten, bevor er postet, dass der Account offline ist; eine Wiederverbindung in dieser Zeit postet nichts. 0 postet sofort.
Andere Anmeldung (Other Login)	Wenn sich jemand anderes in den Account einloggt.
Status Zeitplan (Schedule Status)	Wenn eine Zeitplan-Pause beginnt und endet, und wenn sich der Account während einer Pause einloggt, um seine Aufgaben zu prüfen.
Rss-Limit fast erreicht (Nearing RSS limit)	Wenn Nahrung, Stein, Holz, Erz oder Gold 4 Milliarden erreicht, nahe am Limit des Spiels.
Eingehende Sammlungen / Angriffe melden (Post incoming rallies / attacks)	Wenn ein Sammlungsangriff oder Angriff auf die Burg zukommt, mit Markierung des Admins. Eine Meldung pro Angriff: Die nächste kommt erst, wenn der Wachturm wieder frei ist.
Statistik hochladen (Upload Stats)	Postet die Statistik-Berichte, die dieser Account speichert (Geschenk-Statistiken, Gildenliste und Gildenfest-Statistiken, eingeschaltet auf der Gilden-Seite), als Dateien in den Chat, in dem dieser Account mit /setcastle hinzugefügt wurde. Bis du das tust, wird nichts gepostet. Ist es an, lädt auch der Bank-Befehl !stats all aus diesem Chat den Bericht als Datei hoch. Globale Einstellungen und Vorlagen ändern das nicht: Schalte es in jedem Account ein.

Solange Sende Status in Chatbot an ist, werden manche Benachrichtigungen immer gepostet, zum Beispiel wenn der Account gebannt oder gesperrt wird oder wenn dein Account-Limit erreicht ist.

Benachrichtigungen, die gleichzeitig kommen, werden als eine Nachricht gesendet. Haben mehrere Accounts dieselbe Benachrichtigung, wird sie einmal gepostet, mit den Accounts darunter aufgelistet.