IFS Portal Hunt Bot
Als erstes fügst Du den Bot zur Gruppe, in der die Portale gemeldet werden hinzu.
Da der Bot bestimmte Limits für den Zugriff auf Telegram und GoogleSheets hat. Musst Du einen Botadmin anschreiben um den Bot für Deinen Chat frei zu schalten.
Melde Dich dazu direkt am Bot an und gib den Befehl /botadmins ein.
Wähle einen Admin aus der erhaltenen Liste und schreibe ihn an.
Nach dem Freischalten des Bots sollten sich alle Admins des Telegram-Chats, die den Bot bedienen wollen auch direkt am Bot anmelden.
Wenn Du im Chat das Kommando /ops eingibst, wird der Bot die Admins mit den privat angemeldeten Usern abgleichen und ihnen MOD-Rechte auf Euren Chat im Bot geben.
Nun kann die ganze Einrichtung des Bots für Euren Chat im privaten Chat mit dem Bot erfolgen.
Verwende das Kommando /config um den Bot einzurichten.
Die Bekommst eine Auswahl von Einstellungsmöglichkeiten.
Die ersten beiden Punkte
sind die Einstellungen für Dich.
Benutze den Punkt
Gib erneut /config ein.
Unter dem Button “Chat wählen” erscheint nun ein Button mit dem Namen Deines Chats.
Benutze ihn, um in die Chat-Konfiguration zu gelangen.
Hier findest Du folgende Buttons:
! Nach dem Auswählen des Buttons, kann es einen Moment dauern, bis das Menü kommt, wenn der Bot aus Google Sheets den Sheetnamen abfragt.
Im Kopf des Menüs ist der Sheetname, oder -- zu sehen. Darunter die e-mail des Google-Accounts, den der Bot für den Zugriff auf das Sheet nutzt.
Gib diesem Account bitte Schreibrechte auf das Sheet.
Danach kopierst Du den Link aus der Adresszeile des Sheets, oder den Freigabelink aus dem “Freigeben”-Dialog des Sheets in die Zwischenablage.
Drücke den Button “Link des Sheets” und sende den Link aus der Zwischenablage an den Bot.
Danach sollte im Kopf des Menüs der Name des Sheets stehen.
Hinter dem Button Sheet-Namen verbergen sich verschiedene Möglichkeiten, die einzelnen Seiten des Sheets zu benennen. Klicke diesen Button so oft, bis Dein Favorit zu sehen ist.
(Der Befehl /names zeigt Dir alle Namen an.)
Mit dem Kommando /renamesheets kannst Du die Sheets im Portalhuntsheet entsprechend der Einstellungen umbenennen.
Datenbereich (range) sollte normal passen, das ist der Bereich in den Sheets, in den die Portale eingetragen werden. Beginnend mit der Nummer des Portals, bis zum Link.
(4 Spalten).
Damit ist die Sheet-Konfiguration abgeschlossen.
Der Bot kann mit https://webportals.myingress.net zusammenarbeiten, um den aktuellen Fortschritt des Puzzles anzuzeigen. Um das Puzzle zuzuordnen, ist die Fevgames ID nötig.
Nutze den Button “von Fevgames abrufen”, um die aktuelle Fevgames ID einzutragen und die FS-Daten von Fevgames abzurufen.
Ist eine ID vergeben, wird der Bot den Fortschritt bei /readsheet und beim Eintragen der Portale durch die MODs an myingress.net senden, dort wird die Darstellung des Bildes entsprechend angepasst.
Bitte nutze /readsheet erst, wenn Du die Bildanzahl im Sheet korrekt eingetragen hast.
Nutze auch die Informationen auf https://webportals.myingress.net
Der Button “Image Upload” leitet Dich zu der Seite, auf der Du das PortalHunt Image eintragen kannst.
“Image Web Portal” ist der Link des Portalbildes.
Es kann übersichtlicher sein, wenn der Bot die Nachrichten der Nutzer löscht, wenn diese vom Bot erkannt und mit dem Bearbeitungsstatus ausgegeben werden.
Klicke diesen Button, um die Funktion zu aktivieren, bzw. zu deaktivieren.
Zum löschen der Nachrichten im Chat benötigt der Bot das “Recht zum löschen von Nachrichten”. Sollte er es nicht haben, wird er die MODs im Chat daran erinnern.
Möchtest Du dem Bot das Recht nicht geben, so deaktiviere diese Funktion.
Nutzer sind ungeduldig, damit sie nicht vor dem eigentlichen FS die Queue (Abzuarbeitende Portal Meldungen) füllen, kannst Du hier einen Zeitpunkt einstellen, vor dem die Portal-Meldungen ignoriert werden.
Ist diese Funktion aktiv, wird der Bot von Usern gesendete Portalvorschläge direkt in das Sheet eintragen, sofern noch kein anderes Portal eingetragen ist.
Somit bekommen die MODs nur noch benachrichtigungen, wenn Portaländerungen anstehen.
Normal sendet der Bot nur beim ersten Portal in der Queue eine Nachricht. Wird diese übersehen, sendet der Bot ab dem eingestellten Alter eines Eintrags bei jedem Portal eine Nachricht.
Das wird alle nicht bearbeiteten Portalmeldungen aus der Queue löschen. Kann nützlich sein, sollte aber mit Bedacht genutzt werden.
Sobald Du die Daten für die Suche hast, solltest Du sie in das Sheet eintragen (Anzahl Spalten und die jeweilige Anzahl Bilder.
Beim FS müssen die Agents nichts anderes tun, als die gefundenen Portale in die Gruppe zu posten.
Dazu müssen sie allerdings ein paar Regeln beachten:
Der Bot erwartet die Koordinaten (A-1, K-9, B4, C6), den Intel-Link und den Namen des Portals.
Es gibt mehrere Möglichkeiten die Portale zu melden.
Als Trennung zwischen den Werten kann ein oder mehrere Leerzeichen und Zeilenumbrüche dienen. Keine Kommas oder Semikolon.
Immer wenn das erste Portal in die Queue geschrieben wird, werden die MODs darüber informiert.
“Neue Portale... testhuntbot - /next”
Die Meldung “Neue Portale…”, der Name des Chats in dem diese sind und der Befehl “/next” zum abarbeiten.
Gib /next ein.
Nun bekommst Du das nächste ab zu arbeitende Portal und darüber eine Info, wie viele Portale in der Queue sind.
Du hast die Möglichkeit das Portal
Danach bekommst Du, und der Eintrag im Chat den Status vermerkt.
Sind noch Portale in der Queue, bekommst Du sofort das nächste angezeigt. Ansonsten die Meldung “Keine offenen Portale”
Der Bot kann Dir mehrere Informationen zum Fortschritt der Suche liefern. Dazu ist es unbedingt nötig, die Anzahl Spalten und Portale pro Spalte in das Sheet zu erfassen.
Danach kann mit /readsheet der aktuelle Status aus dem Sheet in den internen Speicher des Bots gelesen werden. Der Bot wird diesen dann automatisch ergänzen. Im Idealfall ist /readsheet daher nur einmal nötig.
Danach kann mit dem Befehlen
Botadmins haben noch ein Extra-Menü, das sie über /chats aufrufen können.
Darin erhalten sie eine Liste aller Chats, mit denen der Bot verbunden ist, verbunden war.
In den Einzelnen Chats können sie die Chats Freischalten, Deaktivieren und Blockieren.
In deaktivierten Chats reagiert der Bot noch auf /help, in Blockierten Chats reagiert er nur noch auf Befehle der Bot Admins, soweit sie in den Chats sind.
Der Button Admins listet die Admins des Chats auf. Sofern hier eine leere Liste erscheint, ist der Bot warscheinlich aus dem Chat geschmissen worden.
Sofern der Chat nicht aktiv ist, erscheint auch noch ein Button zum löschen des Chats aus dem Bot.
Der Bot wird dann den Chat verlassen und alle Daten des Chats aus den Datenbanken entfernen.
Die Befehle zum Aktivieren, Deaktivieren und Blockieren der Chats kann der Bot Admin auch direkt in den Chats mit
ausführen.