Von top.gg umziehen oder doppelt listen

Vorweg: Es ist kein Entweder-oder

Ein Listing bei uns ersetzt dein top.gg-Listing nicht, und es muss das auch nicht. Beide laufen problemlos parallel: eigene Seite, eigene Votes, eigene Webhooks. Was du in zwanzig Minuten Arbeit bekommst, ist eine zweite Anlaufstelle, die für deinen Bot-Namen bei Google gefunden werden kann, ein Serververlauf mit Zahlen aus Discords eigenem App Directory und in der Anfangszeit die Founding-Konditionen für die ersten Entwickler.

Wichtig für die Einordnung: Deine Beschreibung, deine Bilder, deine Texte gehören dir, egal wo sie gerade stehen. Du darfst sie selbstverständlich auch bei uns verwenden.

Schritt 1: Beschreibung übernehmen

Öffne dein bestehendes Listing, kopiere deine Langbeschreibung als Markdown und füge sie im Einreichungsformular ein. Überschriften, Listen und Links funktionieren; rohes HTML und Skripte werden entfernt, das ist bei uns strenger als anderswo.

Zwei Dinge sind bei uns anders. Erstens gibt es zwei Sprachfassungen, Deutsch und Englisch. Du musst nicht beide pflegen: Fehlt eine, zeigen wir die vorhandene mit einem dezenten Hinweis. Eine deutsche Fassung lohnt sich trotzdem, denn deutsche Suchbegriffe sind der Grund, warum viele Besucher überhaupt hier landen. Zweitens ist die Kurzbeschreibung auf 160 Zeichen begrenzt und erscheint in Suchergebnissen und auf Karten. Ein Satz, der sagt, was der Bot tut, schlägt jede Aufzählung.

Schritt 2: Befehle importieren statt abtippen

Discord gibt dir deine eigene Befehlsliste als JSON. Ein Aufruf mit deinem Bot-Token genügt, und das Formular übernimmt die komplette Liste, Unterbefehle inklusive. Wie der Aufruf aussieht, steht mit Beispielen in elf Sprachen auf der Seite Befehle importieren. Abtippen musst du nichts.

Schritt 3: Server-Count automatisch melden

Nach der Freigabe bekommst du im Dashboard einen API-Schlüssel. Dein Bot meldet seine Serverzahl mit einem einzigen Request:

POST https://topbot.gg/api/v1/bots/{application-id}/stats
Authorization: Bearer {api-key}
Content-Type: application/json

{ "serverCount": 1234 }

Wenn dein Bot schon eine Funktion hat, die Stats an dein bestehendes Listing schickt, ist das derselbe Handgriff mit anderer Adresse. Die vollständige API-Dokumentation enthält Beispiele in JavaScript und Python.

Unabhängig davon holen wir uns täglich die Serverzahl aus Discords App Directory, sofern dein Bot dort gelistet ist. Sie füllt deine sichtbare Serverzahl, solange du selbst nichts meldest; eigene Meldungen haben Vorrang. Den Verlaufsgraphen auf deiner Bot-Seite schaltest du im Dashboard zu, wenn du ihn zeigen willst.

Schritt 4: Vote-Webhook danebenlegen

Vote-Belohnungen funktionieren bei uns über denselben Mechanismus, den du kennst: Du hinterlegst im Dashboard eine URL und ein Secret, wir schicken bei jeder Stimme einen POST. Die Signatur ist ein HMAC-SHA256 über Zeitstempel und Body, fehlgeschlagene Zustellungen werden mit wachsendem Abstand wiederholt, und jedes Ergebnis steht im Zustellprotokoll im Dashboard, inklusive Test-Knopf.

Der Payload ist nicht identisch mit dem, was andere Verzeichnisse schicken, aber er ist klein und dokumentiert. In der Praxis ist es ein zweiter Endpoint neben deinem bestehenden Vote-Handler, kein Umbau. Alternativ nimmst du einen Discord-Kanal-Webhook als Ziel. Dann landet jede Stimme als Embed in deinem Server, ganz ohne Code.

Schritt 5: Badge ins README

Im Dashboard findest du fertige Copy-Snippets für Badges mit Serverzahl, Votes oder Bewertung, als HTML und Markdown, funktionierend in hellem und dunklem GitHub-Theme. Dazu gibt es den Serververlauf als einbettbares SVG-Widget für Website oder README.

Was nicht geht

Wir übernehmen keine Votes, Bewertungen oder Ränge von anderen Plattformen. Die Zahlen hier starten bei null und sind dafür echt. Und dein Bot durchläuft vor der Veröffentlichung eine Prüfung durch einen Menschen, in der Regel innerhalb von 72 Stunden. Was dabei geprüft wird, steht auf der Entwicklerseite.