Immer noch eine Arbeitsversion. Naja der Bot ist ja auch noch nicht fertig ;-)
Stand: 12. Juni 2022
Wozu?
Der Bot soll es möglichst einfach ermöglichen seinen Fortschritt in Ingress auszuwerten.
Dabei soll er es ermöglichen Stats auch an andere Ziele zu senden, um das Hochladen zu zig verschiedenen Stat- / Erweiterungsseiten für Ingress zu begrenzen.
Wie arbeitet der Bot
Der Bot nimmt im zugesendete Stats entgegen, wertet sie aus und Speichert sie intern in verschiedenen Speicherplätzen.
Es gibt vordefinierte Speicherplätze
Jedes Speicherplatz hat (mindestens) zwei Slots. Der Bot hält so auch die vorletzten Stats vor.
Nach dem Upload der Stats erscheinen die aktuellen Stats, wenn möglich mit den Differenzen zu vorher hochgeladene Stats (Last).
Darunter erscheinen alle aktiven Speicherplätze.
Speicherplätze mit einem grünen Hacken “✅” enthalten den aktuellen Datensatz. Mit einem Einbahnstraßenschild “⛔” enthalten ihn nicht, sind aber feste Stats, in die nicht per Hand geladen werden kann (Letzte, Tag, Monat, Jahr).
In Stats mit einem Diskettensymbol “💾” können die Stats per Hand durch Drücken des Buttons geladen werden.
Erscheint zusätzlich zum Diskettensymbol noch ein Ablagesymbol, dann landen die Daten beim Speichern ausserhalb des Bots (EBL, Sheet).
Dieses Menü kann auch durch das Kommando /save aufgerufen werden.
Config
Mit dem Befehl /config kannst Du Voreinstellungen am Bot vornehmen.
Möchtest Du eine Sprache für den Bot erstellen/ übersetzen, dann wende Dich an @janc70.
Diese Funktion wurde in “Stats verwalten” verschoben.
Upload
Du kannst dem Bot einfach Deine Gesamt (ALL TIME) Stats zusenden. Direkt über Teilen oder über die Zwischenablage.
Es ist kein extra Kommando nötig.
Es gibt aber die Möglichkeit, vor dem Upload mit dem Kommando /fullstats eine Ausgabe aller gefundenen Stats anzufordern.
Die Stats werden zum Teil automatisch, zum teil per Hand in den gewünschten Speicherplätzen abgelegt.
Zusätzlich werden (nur die benötigten) Werte auch im Userdatensatz für in unter /teams befindliche Auswertungen gespeichert.
Wenn NIA was an den Stats ändert, wird der Bot eine Warnung ausgeben, wenn möglich mit einer Beschreibung der Änderung. Dann solltest Du die Werte Deiner Stats prüfen.
Auswertung
Benutze das Kommando /stats um in die Auswertung der Stats zu gelangen.
Der Bot präsentiert Dir (nach Möglichkeit) die letzten Stats mit den Differenzen zu den vorhergehenden Stats.
Um die Sache etwas übersichtlicher zu gestalten werden nicht alle Stats ausgegeben, sondern in einem Profil ausgewählte.
Unter den Stats befinden sich zwei Reihen Buttons.
Die Obere:
Die Zweite Zeile enthält zwei Buttons zur Auswahl der Stats. Wird einer geklickt, kann man die Stats auswählen, die angezeigt werden sollen.
Teams
Die Teamfunktion soll es ermöglichen mit oder gegen andere Spieler zu spielen.
Rufe die Funktion mit dem Kommando /teams auf.
Du kommst in ein Menü, das Dir alle Teams, Deine oder die in die Du eingeladen wurdest anzeigt.
Nach Deinen Teams erscheint der Button
“➕ Neues Team erstellen”.
Er erstellt ein Team “Neues Team” und gibt Dir Administrator-Rechte.
Es gibt die Rechte “User”, “Mod” und “Administrator”. Es kann mehrere Mods geben, aber nur einen Administrator.
Im Menü eines Teams kannst Du
Ein Team kann mehrere unabhängige Auswertungen enthalten.
In den Auswertungen legt man Fest um was gespielt wird und über welchen Zeitraum. Zusätzlich kann man noch festlegen, wie es angezeigt werden soll.
Auf die Einstellungen von Auswertungen haben Mods und der Admin des Teams Zugriff. Normale User sehen nur das Ergebnis der Auswertung.
Beim erstellen einer Auswertung wird nach dem Namen gefragt. Dieser kann später geändert werden.
Danach erscheint das Auswertungsmenü:
.
In diesem Menü befindet sich als erstes eine Formel aus zwei Werten und einem Operator.
Im Kopf ist die aktuelle Formel zu sehen.
Die Werte können aus einem fest zu vergebenden Wert, einem Wert aus den Stats oder einer neuen Formel bestimmt werden. Eine neue Formel wird wie eine in Klammern stehende Berechnung in die Formel eingebunden.
Unter Operationen lassen sich sowohl die Operation selber bestimmen, es können aber auch neue Paare aus Operation und Wert in die Formel aufgenommen sowie gelöscht werden.
Besteht die Operation aus einer Funktion, nutzt diese den kompletten oberen Teil der aktuellen Formel als Ausgangswert. Der Wert nach der Funktion ist ggfls. ein zweiter Wert für die Formel.
Aktuelle Funktionen sind:
Der zweite Wert gibt die Stellen nach dem Komma an. 0: Ganzzahl, 1 eine Kommastelle, -1 ganze Zehner
Unter diesem Menüpunkt werden die Agenten eines Teams angezeigt. Je nach Einstellung der Rechte für Einladungen, kann das jeder oder nur Mods und der Admin.
Admins können den einzelnen User Mod-Rechte zu- und aberkennen sowie das Rechte auf den Export als CSV.
Ein Admin kann seine Rechte auch auf einen anderen User abgeben, wird dann selber zum Mod.
Und es können bei entsprechenden Rechten User gelöscht werden.
Um Agenten zu einem Team hinzuzufügen muss man Einladungen nutzen. Dazu kann man in diesem Menü Einladungen erstellen.
[#user#] für den Nutzer und
[#team#] für das Team personalisieren.
Mit “Einladungsnachricht erzeugen” wird ein signierter text erzeugt, der an Agents zum Beitritt ins Team gesendet werden kann.
Folgende Einstellungen bestehen:
------------------------------------------------
In diesem Menü findest Du mehrere Voreingestellte ( 👁 ) und kannst eigene Profile für die Anzeige der Stats anlegen. Diese werden in der Funktion /stats und nach dem Upload der Stats, bzw.. /save genutzt.
Als erstes werden die vom Bot voreingestellten Profile aufgelistet, kennzeichnet durch ein 👁. Diese können nicht bearbeitet, nur betrachtet werden.
Danach kommen selbst erstellte, gekennzeichnet durch 🖊. Diese können bearbeitet werden.
Ein Button, um ein neues Profil anzulegen, danach die Möglichkeit ein Profil als default festzulegen. Dieses wird in der Liste der Profile durch ein ✅ gekennzeichnet.
Danach kann noch festgelegt werden, ob bei den Werten Dezimalpunkte angezeigt werden sollen und ob alle im Profil definierten Werte, oder nur Werte bei denen sich etwas geändert hat, angezeigt werden sollen.
Als letzter Button ist die Einstellung, ob in der Statsauswahl im /stats-Dialog alle Stats angezeigt werden sollen, oder die Stats nach dem Zeitpunkt sortiert und doppelte entfernt werden sollen.
Der Bot kann die empfangenen Daten automatisch an die EBL (Enlightened Bundesliga) weiterleiten.
Dazu benötigst Du von der EBL Settings Seite den “API Token”, dass Du im Bot unter
/config - EBL - API-Token eingeben musst.
In diesem Menü kannst Du auch festlegen, ob Stats, die Du an den Bot sendest automatisch an EBL gesendet werden und den Zeitraum dafür eingrenzen.
Ab jetzt bekommst Du bei den Speicherslots nach dem senden der Stats auch einen Slot für die EBL angezeigt, je nach Einstellung sind die Daten schon an EBL gesendet.
Nach dem Senden an EBL bekommst Du eine Info Nachricht in der Form
“✅ EBL Upload OK, 189937AP
⚠️ Prüfe die Werte auf https://ebl.world/stats
Wertungs AP: 489937AP”.
Die AP hinter “EBL Upload OK” sind die AP zwischen den einzelnen Uploads an EBL.
Die Wertungs AP sind die AP, die von EBL pro Tag gewertet werden sollten.
Zusätzlich gibt es noch “EBL-Profil”, zu anzeigen einiger Daten Deines EBL-Profils und “EBL-Scoreboard”, das Dir Deine Letzten Plätze für Tages, Wochen und Monatswertung anzeigt.
Wenn Du möchtest, kannst Du alle von Dir an den Bot gesendeten Werte in einem Sheet erfassen.
Der Bot speichert die Daten einfach Zeilenweise in das Sheet ohne irgendwelche Auswertungen. Jeder Wert eine Spalte, mit Kopfzeile. Die Spalten richten sich dabei nach der Botinternen Indexierung (https://gitlab.com/jan.clauss/ingress-export-telegram).
Die Daten können dann mit den Sheet Funktionen aufbereitet werden.
Um diese Funktion einzurichten, gehe nach /config - GoogleSheet.
Erstelle ein leeres GoogleSheet und gib dem Bot Schreibrechte auf das Sheet (verwende dazu die Emailadresse, die im Menü hinter Bot-GoogleMail steht.
Wähle im Bot “Spreadsheet Link” und kopiere den Link des Sheets aus der Adresszeile, oder mit den Sharing-Optionen des Sheets in die Eingabe.
Wenn Du möchtest, kannst Du noch den Namen eines Sheets im Googlesheet angeben (“Sheet Name”). Ist dieser nicht angegeben, schreibt der Bot in das aktive (erste) Sheet.
Es kann auch noch ein Zeitraum angegeben werden, in dem der Bot nach dem letzten schreiben keine neue Daten in das Sheet schreibt. Von Hand ist das dann immer noch möglich.
Das Menü bietet Dir auch an, alle aktuellen Stats in die Kopfzeile zu schreiben. Die Stats werden anhand des internen Index des Bots im Sheet abgelegt. Das vermeidet u.A. Probleme, wenn NIA mal wieder die Namen der Stats ändert.
Spalten, die bei Dir leer sind, Du nicht benötigst, kannst Du ausblenden. Bitte nicht löschen!
Es ist eine große Lücke zwischen den Standard-Stats und den Event-Stats. Das ist absicht, es kommen bestimmt noch mehr Stats mit der Zeit.
Wenn Du möchtest, kannst Du mit ‘Agent-Stats Import’ Deine Daten aus agent-stats.com importieren. Rufe dazu den Menüpunkt auf.
Gehe dann auf der Agentstats-Seite auf Exportieren, Speicher dann die komplette Seite. In Desktop Browsern rechte Maustaste und im Kontekt-Menü ‘Seite speichern’, im Crome für Android findest Du im Menü einen kleinen Pfeil nach unten, der die Seite speichert.
Sende die heruntergeladene Datei an den Bot.
Er wird diese zuerst in ein JSON (Datenformat) umwandeln, und dann in das Sheet schreiben.
Der Bot hängt alle Daten hinten an das Sheet an und schreibt die Kopfzeile im Sheet neu.
Im GoogleSheet Menü findest Du dann eine Funktion ‘Sheet nach Zeit sortieren’, die die Daten an die richtige Stelle sortiert.
Beim Import aus Agent-Stats kommen leider keine Daten zu Level, Agentname oder Agentfaction. Daher werden der Agentname und die Agentfaction auf Deine aktuellen Daten gesetzt, der Level bleibt leer. Letzteren kannst Du mit ‘Level ergänzen’ eintragen lassen. Hier werden allerdings nur die AP zur Berechnung benutzt, keine Badges. Es werden nur leere Zellen neu berechnet.
Sendest Du einen Text mit Geo-Links (Intel, Ingress, Google oder Apple) an den Bot, wird er diese durch Google oder Apple Links ersetzen. Unter /config - “Intel-Links übersetzen in Google-Links” kannst Du durch Anklicken des Menü-Eintrags auswählen in welches Format er wandeln soll.
Sendest Du nur einen Link, bekommst Du eine Liste der Position in Intel-, Google und Apple-Format.
Bild senden
Die Teams können je nach Einstellung Bilder empfangen und an einen eingestellten Empfänger weiterleiten.
Sende ein Bild an den Bot und er wird Dir die Teams zur Auswahl auflisten, die Bilder annehmen. Hier hast Du auch noch die Möglichkeit abzubrechen, wenn es ein Versehen war.
AP Werte
Befehl: /ap
Hier werden die AP aufgelistet, die es für verschiedene Aktionen gibt. Ist gerade ein Event aktiv und der Name hinterlegt, wird dieser mit angezeigt.
Wird eine Zeitangabe mit Übergeben, so werden die AP-Werte für diesen Zeitpunkt berechnet.
AP-Events
Befehl /apevents
Es werden im Bot erfasste, kommende AP-Events aufgelistet. Mit dem Parameter all werden alle im Bot erfassten Events aufgelistet, auch vergangene.
Exact AP
Befehl: /exactap
Möchtest Du auf einen bestimmten AP-Wert kommen, dann kannst Du diese Funktion als Hilfe nutzen.
Nach dem Aufruf bekommst Du ein Menü mit Ziel AP und verschiedenen Aktionen angezeigt.
Setze mit “Ziel AP” den Wert, den Du erreichen möchtest.
Die verschiedenen Aktionen kannst Du auch auf 0 oder einen anderen Wert fest einstellen. Dann erscheint ein 📌 mit dem Wert im Menü.
Erscheint ein ⛔ mit dem Wert 0, dann wurde der gleiche AP-Wert schon bei einer anderen Aktion genutzt und dieser aus der Berechnung ausgeschlossen. Das beschleunigt die Berechnung deutlich.
Möchtest Du unbedingt diese Aktion benutzen, so setze die andere Aktion auf einen Festen wert.
Der Eingestellte Wert von /exactap wird automatisch auch in die Zielwerte (/config) übernommen und so nach dem Statsupload angezeigt.