Spiele & APIs

Beschreibung

Benutzerhandbuch

Binden Sie die APIs Ihrer Spiele an Ihren Server an: Ihre Mitglieder verknüpfen ihr Konto, rufen ihre Statistiken ab, verfolgen den Status der Spielserver und vergleichen sich in einer Rangliste. 23 Spiele werden einsatzbereit mitgeliefert, und Sie können selbst weitere ergänzen.

Was es tut

• Erlaubt jedem Mitglied, sein Spielkonto mit dem Server zu verknüpfen.
• Zeigt auf Anfrage Spielerstatistiken an.
• Veröffentlicht den Status der Server eines Spiels in einer laufend aktualisierten Nachricht und kann einen Sprachkanal als Zähler umbenennen.
• Verbreitet automatisch die Neuigkeiten eines Spiels in einem Kanal.
• Erstellt eine Rangliste der Mitglieder, die ihr Konto verknüpft haben.
• Bietet eine Suche in den Datenbanken bestimmter Spiele.
• Ein Konstruktor erlaubt es, jede API anzubinden, die JSON zurückgibt — ohne Code zu schreiben.

Schnellstart (Admin)

1. Öffnen Sie das Dashboard, Modul Spiele & APIs, Tab Katalog.
2. Suchen Sie Ihr Spiel und klicken Sie auf Aktivieren. Die Einstellungen des Spiels öffnen sich sofort.
3. Ist das Spiel mit „Schlüssel erforderlich" markiert, fügen Sie Ihren API-Schlüssel in die Karte API-Schlüssel ein. Erscheint der Hinweis „TennoCore-Schlüssel", ist bereits ein Schlüssel vorhanden und Sie müssen nichts tun.
4. Aktivieren Sie gegebenenfalls die Automatisierungen: Neuigkeiten, Status, Rangliste — jede erfordert einen Kanal und ein Intervall.
5. Nutzen Sie die Schaltfläche Testen, um zu prüfen, ob die API antwortet, und dann Speichern.
6. Machen Sie Ihre Mitglieder auf /game list aufmerksam: Dort sehen sie die verfügbaren Spiele und verknüpfen ihr Konto mit /game link.

Befehle

Alle Befehle stehen allen Mitgliedern zur Verfügung und antworten privat, wenn es um eine Kontoverknüpfung geht.

Befehl	Beschreibung
/game list	Listet die auf dem Server aktivierten Spiele auf, mit den jeweiligen Fähigkeiten.
/game link	Öffnet ein Formular, um Ihr Konto mit dem gewählten Spiel zu verknüpfen.
/game unlink	Löscht die Verknüpfung Ihres Kontos für dieses Spiel.
/game stats	Zeigt die Statistiken eines Mitglieds an (standardmäßig Ihre eigenen).
/game status	Zeigt den Status der Server des Spiels an.
/game lookup	Sucht einen Eintrag in der Datenbank des Spiels.
/game leaderboard	Erstellt eine Rangliste der Mitglieder des Servers, die ihr Konto verknüpft haben.

Mit dem Bot gelieferte Spiele

23 Konnektoren werden mitgeliefert. Jeder bietet eine oder mehrere Fähigkeiten: Spielerstatistiken, Serverstatus, Neuigkeiten, Suche.

Spiel	Fähigkeiten	API-Schlüssel
Apex Legends	Spielerstatistiken	Erforderlich
Brawl Stars	Spielerstatistiken	Erforderlich
Chess.com	Spielerstatistiken	Nein
Clash Royale	Spielerstatistiken	Erforderlich
Destiny 2	Spielerstatistiken	Erforderlich
Epic Games – Kostenlose Spiele	Neuigkeiten	Nein
Fortnite	Spielerstatistiken	Erforderlich
Free-To-Game – F2P-Veröffentlichungen	Neuigkeiten, Suche	Nein
Genshin Impact	Spielerstatistiken	Nein
Hypixel (Minecraft)	Spielerstatistiken	Erforderlich
League of Legends	Spielerstatistiken, Serverstatus	Erforderlich
Lichess	Spielerstatistiken	Nein
Minecraft – Spieler	Spielerstatistiken	Nein
Minecraft – Server	Serverstatus	Nein
osu!	Spielerstatistiken	Erforderlich
Pokédex (PokéAPI)	Suche	Nein
RAWG – Spieledatenbank	Suche, Neuigkeiten	Erforderlich
Roblox	Spielerstatistiken	Nein
Status (generische Statuspage)	Serverstatus	Nein
Steam – News zu einem Spiel	Neuigkeiten	Nein
Steam – Profil	Spielerstatistiken	Erforderlich
Valorant	Spielerstatistiken	Erforderlich
Warframe – Welt	Serverstatus, Neuigkeiten	Nein

Einstellungen im Dashboard

Das Modul besteht aus fünf Tabs.

• Katalog — alle verfügbaren Spiele, filterbar nach Kategorie oder Name. Jede Karte nennt die Fähigkeiten des Spiels und ob ein Schlüssel benötigt wird. Schaltflächen Aktivieren, Duplizieren (um von einem bestehenden Konnektor auszugehen) und ein Link zur Dokumentation der API.
• Meine Spiele — die auf diesem Server aktivierten Spiele: Status, aktive Automatisierungen, Anzahl der verknüpften Konten, Herkunft des Schlüssels, letzter aufgetretener Zwischenfall. Die Schaltfläche Konfigurieren öffnet die Einstellungen:
  • Allgemein: Spiel aktiv oder pausiert und Rolle, die dem Mitglied bei der Kontoverknüpfung automatisch zugewiesen wird.
  • API-Schlüssel: Ihr Schlüssel, verschlüsselt gespeichert und niemals wieder angezeigt. Lassen Sie das Feld leer, um nichts zu ändern.
  • Konnektor-Parameter: die spielspezifischen Einstellungen (Steam-Anwendungs-ID, Region …).
  • Neuigkeiten: Kanal, Intervall (5 bis 1440 Minuten, standardmäßig 30) und optionale Erwähnung einer Rolle.
  • Status: Kanal des Panels, Intervall (standardmäßig 10 Minuten) und Sprachkanal als Zähler mit der zu verwendenden Namensvorlage.
  • Rangliste: Kanal, Intervall (standardmäßig 60 Minuten) und Hinweis auf die maßgebliche Statistik.
  • Jede Automatisierung verfügt über eine Schaltfläche Jetzt veröffentlichen.
• Konstruktor — Erstellung eines eigenen Konnektors: allgemeine Informationen, Authentifizierung, vom Mitglied abgefragte Felder, Aufrufschritte und Beschreibung der zu erzeugenden Nachricht. Ein Prüfstand führt einen echten Aufruf aus und zeigt die Baumstruktur der Antwort: Klicken Sie auf einen Wert, um dessen Pfad zu kopieren und in der Anzeige weiterzuverwenden.
• Spieler — alle verknüpften Konten des Servers, mit der Möglichkeit, die Verknüpfung eines Mitglieds zu lösen.
• Protokoll — die letzten 50 ausgehenden Aufrufe an die APIs, mit Dauer, Ergebnis und Fehlerdetails.

Gut zu wissen

• Ein Spiel muss aktiviert sein, um zu existieren. Die Autovervollständigung der Befehle bietet nur aktivierte Spiele an und davon nur die, die mit dem verwendeten Befehl kompatibel sind: Ein Spiel, das nur Neuigkeiten liefert, erscheint nicht in /game stats.
• Die Verknüpfung wird sofort geprüft. /game link löst einen echten Aufruf an die API aus: Wird das Konto nicht gefunden, wird nichts gespeichert und das Mitglied erhält den vom Spiel gemeldeten Fehler. Ein verknüpftes Konto ist also immer ein funktionierendes Konto.
• Das Verknüpfungsformular ist auf 5 Felder begrenzt — eine von Discord vorgegebene Grenze.
• API-Schlüssel im Hybridmodus: Ihr Schlüssel hat immer Vorrang; andernfalls wird der globale TennoCore-Schlüssel verwendet, sofern vorhanden. Ihren eigenen anzugeben verschafft Ihnen Ihr eigenes Kontingent. Ein gespeicherter Schlüssel wird in der Oberfläche nie wieder angezeigt.
• Kontingente: Jeder Konnektor legt sein Aufruflimit fest (in der Regel 30 pro Minute und Server). Darüber hinaus antwortet der Bot, dass eine Minute abgewartet werden muss. Die Antworten werden einige Minuten zwischengespeichert, was wiederholte Anfragen abfedert.
• Rangliste: Es werden höchstens 40 verknüpfte Konten abgefragt und die ersten 20 angezeigt. Die Aufrufe sind bewusst zeitlich gestreckt, um das Kontingent des Servers nicht zu erschöpfen — sehen Sie ein großzügiges Intervall vor, wenn viele Mitglieder verknüpft sind. Die Rangliste bleibt leer, wenn der Konnektor keine maßgebliche Statistik definiert.
• Erster Durchlauf eines Neuigkeiten-Feeds: Es wird nichts veröffentlicht, der Bot erfasst lediglich den bestehenden Verlauf. Das ist beabsichtigt, um den Kanal nicht zu überschwemmen. Die Veröffentlichungen beginnen mit dem nächsten Durchlauf.
• Sprachkanal als Zähler: Discord erlaubt nur 2 Umbenennungen pro 10 Minuten. Ein zu kurzes Intervall wird von Discord stillschweigend ignoriert.
• /game list zeigt höchstens 25 Spiele an, die Autovervollständigung 25 Vorschläge.
• Ein Spiel zu entfernen löscht seine Einstellungen und den Verlauf der Neuigkeiten, behält aber die verknüpften Konten der Mitglieder.
• Die Nachrichten des Moduls nutzen das neue Anzeigeformat von Discord: Jedes Feld belegt seine eigene Zeile, es gibt keine Spaltendarstellung.
• Eigene Konnektoren: Die aufgerufenen Adressen müssen auf eine öffentliche API zeigen. Jede interne oder private Adresse wird aus Sicherheitsgründen abgelehnt.
• Das Aufrufprotokoll wird 7 Tage aufbewahrt.
• Das Modul steht in der Kategorie „In Entwicklung" des Dashboards: Seine Oberfläche kann sich noch ändern.