Was du brauchst
- Einen Discord-Server, auf dem du die Berechtigung
Server verwaltenhast (normalerweise der Besitzer oder ein Admin). - Ein bereits erstelltes TopV-Serverprofil — /setup-server falls du noch keines hast.
- Etwa 2 Minuten. Die Einrichtung erfolgt in einem Durchgang.
Bot zu deinem Discord hinzufügen
Klicke auf den Button. Discord öffnet eine Berechtigungsanfrage — akzeptiere sie. Der Bot landet mit minimalen Rechten auf deinem Server (Mitglieder und Rollen lesen, Nachrichten im gewählten Kanal senden). Mehr nicht.


Bot mit deinem TopV-Server verknüpfen
In einem beliebigen Textkanal eingeben:
/topv-link
TopV8 commandsDiscord fragt nach dem Slug deines Profils — der Teil der URL nach topv.gg/servers/. Beispiel: Wenn dein Profil unter topv.gg/servers/saga-rp ist, tippe saga-rp.

https://topv.gg/servers/saga-rp
Auto-Sync alle 6 Std.
/topv-sync für sofortigen Resync.Staff- und Roliste-Rollen auswählen
So weiß der Bot, wer im Team und wer Roleplayer ist. Öffne dein TopV-Dashboard:
Dashboard öffnenGeh zur Bearbeitungsseite deines Servers, scrolle zum Abschnitt Discord-Rollen und hake die gewünschten Rollen ab.
- Staff-Rollen — Admins, Mods und Team. Erscheinen auf deinem Profil mit Avatar + Rollen-Badge, automatisch synchronisiert.
- Roliste-Rollen — jedes Mitglied mit dieser Rolle erhält ein eigenes TopV-Profil (Charakter, Projekte, Trophäen, Bewertungen). Lebenslang.
Discord Roles
Pick the Discord roles that represent your staff team and your players (rolistes). Staff will appear on your public profile, and rolistes will automatically get a player profile on TopV.
Benachrichtigungskanal wählen
Lege fest, wo der Bot postet: Sync-Ergebnisse, neue Trophäen, neue Bewertungen, Weekly Spotlight Erinnerungen. Führe aus:
/topv-channel #dein-kanal
/topv-channelchannel:
Pro-Tipp: Wähle einen privaten Staff-Only-Kanal — die meisten Nachrichten sind für dich und dein Team, nicht für die Community.
Trophäensystem aktivieren
Dieser Schritt ist optional. Wenn deine Community großartige RP-Momente belohnen können soll:
/topv-trophy-setup
Der Bot fragt, welche Kanäle für /eval geeignet sind und welche Rollen es nutzen können (typischerweise Staff + Senior-Rolistes). Anti-Missbrauch eingebaut:
- Cooldown zwischen zwei /eval desselben Autors.
- Tageslimit pro Bewerter (Anti-Flood).
- Rollen-Gating — nur konfigurierte Rollen können /eval nutzen.
- Vollständiges Audit-Log: jeder Trophy-Punkt ist auf Bewerter und Kanal zurückverfolgbar.
Sobald aktiv, kann jedes Mitglied mit der richtigen Rolle eingeben: /eval @player in einem berechtigten Kanal. Der Punkt zählt für das TopV-Ranking des Spielers.
TopV8 commands
IppoJinEvoVerse Académie | FAused/eval

Bewerter: IppoJin · EvoVerse Académie | FAAlle Slash-Befehle
/topv-linkVerknüpft diese Discord-Guild mit deinem TopV-Serverprofil.
/topv-syncErzwingt eine Staff- und Roliste-Resync. Nach Rollenänderungen nützlich.
/topv-statusZeigt Verifizierungsstatus, verknüpften TopV-Slug, letzte Sync.
/topv-channelWähle den Kanal für Sync, Trophäen, Bewertungen und Weekly Spotlight Erinnerungen.
/topv-trophy-setupKonfiguriert Trophäen-Kanäle und berechtigte Rollen für /eval. Optional.
/eval @playerVergibt einen Trophäenpunkt an einen Roleplayer. Nur in konfigurierten Kanälen.
/topv-helpZeigt alle Befehle und eine Übersicht des RP-Trophäensystems.
/topv-unlinkEntfernt die Verknüpfung zwischen Guild und TopV-Profil.
Berechtigungen & Datenschutz
Was der Bot KANN
- Mitgliederliste lesen (Privileged GUILD_MEMBERS Intent — von Discord genehmigt).
- Rollen-Zuweisungen lesen (nur Lesen), um Staff und Rolistes zu identifizieren.
- Nachrichten im mit /topv-channel festgelegten Kanal senden.
- Slash-Befehle in zugänglichen Kanälen abhören.
Was der Bot NICHT kann
- Mitglieder bannen, kicken oder timeouten.
- Kanäle erstellen, bearbeiten oder löschen.
- Rollen ändern — nur Lesezugriff.
- DMs an Mitglieder senden.
- Nachrichteninhalte lesen (kein MESSAGE_CONTENT Intent).
Fehlerbehebung & FAQ
›/topv-link sagt 'Nicht autorisiert'
Dein Discord-Konto ist nicht Besitzer des TopV-Profils. Melde dich mit dem richtigen Discord-Konto an oder übertrage zuerst den Besitz via /dashboard.
›Staff-Liste erscheint nicht auf meinem Profil
Markiere mindestens eine Rolle als 'Staff' im Dashboard und führe /topv-sync aus. Falls leer, prüfe ob der Bot diese Rollen sieht (Position über dem Bot).
›Roliste-Profile werden nicht erstellt
Gleiche Logik — markiere mindestens eine Rolle als 'Roliste' und führe /topv-sync aus. Mitglieder brauchen mindestens eine dieser Rollen. Profile in Sekunden erstellt.
›/eval sagt der Kanal ist nicht berechtigt
Führe /topv-trophy-setup erneut aus und füge den aktuellen Kanal zur berechtigten Liste hinzu. Punkte zählen nur aus explizit genehmigten Kanälen.
›Kann ich den Bot später deinstallieren?
Ja, jederzeit. Führe zuerst /topv-unlink aus (damit dein Profil weiß, dass die Guild nicht mehr verbunden ist), dann kicke den Bot. Es werden keine Daten über den Verifizierungsdatensatz hinaus aufbewahrt.
›Kostet es etwas?
Nein. Der Bot ist und bleibt kostenlos. Kein damit verbundener Upsell. Premium-TopV-Pläne existieren (Sichtbarkeit in Rankings, Weekly Spotlight, etc.), sind aber völlig unabhängig vom Bot.

