Zum Hauptinhalt springen
Discord Sync hält deinen Discord-Server mit SquadVault-Spielern und -Teams abgestimmt. Organisations-Admins richten das ein, wenn Discord im Tarif enthalten ist. Die Seite Discord folgt dem üblichen SquadVault-Layout: Status (Bot, Guild, Sync-Readiness), dann Arbeit (Verbindung → Mapping → Sync), dann Insights (Lücken wie unmapped Teams).
Discord-Seite mit Bot-Verbindung und Sync-Status

Discord — Verbindung und Sync-Readiness

Discord verbinden

1

Bot einladen

Öffne Discord unter Verbindungen in der Seitenleiste und lade den SquadVault-Bot auf deinen Server ein.
2

Server verbinden

Wähle den Discord-Server, den du mit dieser Organisation verknüpfen willst.
3

Rollen zuordnen

Ordne Discord-Rollen Spielern, Staff und Teams zu, damit die Mitgliedschaft konsistent bleibt.
4

Sync

Starte einen Sync (oder zuerst einen Dry Run) und setze optional einen Log-Channel für Sync-Aktivität.

Spieler- vs. Staff-Rollen

  • Spieler-Rollen legen Spieler an bzw. archivieren sie, wenn Mitglieder diese Discord-Rollen bekommen oder verlieren.
  • Staff-Rollen machen dasselbe für org-weite Staff-Einträge (siehe Staff in der Seitenleiste). Jemand kann Spieler und Staff zugleich sein.
  • Discord-Staff-Sync ist nicht dasselbe wie Team-Staff (Coach/Analyst am Team). Team-Staff bleibt die separate Zuweisung von Organisationsmitgliedern zu einem Team.

Spieler mit Discord verknüpfen

Im Spielerprofil Discord-Konto verknüpfen, damit Role Sync stimmt. Discord-User-IDs müssen innerhalb der Organisation eindeutig sein.

Tryout-Bewerbungen

Wenn jemand eine gemappte Spielerrolle in Discord erhält, legt Sync den SquadVault-Spieler an oder stellt ihn wieder her. Liegt in derselben Organisation eine offene Tryout-Bewerbung mit derselben Discord-User-ID vor (pending, reviewing oder shortlisted), wird diese Bewerbung automatisch als angenommen markiert und mit dem Spieler verknüpft. Flows auf tryout.accepted laufen weiterhin.

Teamlisten

Mit Pro oder Elite öffnest du Teamlisten unter Arbeitsbereich in der Seitenleiste:
  1. Gestalte eine Roster-Nachricht mit Blöcken (Header, Captain, Spieler, MMR, Footer).
  2. Wähle Embed oder normale Nachricht, Teams und einen Discord-Channel.
  3. Stelle Automatische Aktualisierung ein: sofort bei Roster-Änderungen, nach Zeitplan (Presets oder erweiterter Cron) oder nur manuell. Neue Zeitpläne nutzen die Zeitzone der Organisation.
  4. Speichern & veröffentlichen — SquadVault bearbeitet dieselben Discord-Nachrichten, wenn die Liste aktualisiert wird.
Unter Erweitert kannst du optional ein Headerbild hochladen. SquadVault postet es als eigene Discord-Nachricht vor den Roster-Nachrichten. Du kannst wählen, ob es als Discord-Embed oder als normale Nachricht mit Bild-URL gesendet wird. Bild entfernen und erneut veröffentlichen löscht die Header-Nachricht. Ranks erscheinen, wenn die passende Integration für das Team-Spiel verfügbar ist — sonst bleiben die Spielernamen: Discord zuerst auf der Discord-Seite verbinden. Mit freigeschalteten Ranks kannst du dort Discord-Custom-Emojis den Tiers zuordnen (Tabs für Rocket League, Valorant und League). Teamlisten zeigen dann {{rankEmoji}} bzw. den Toggle „Rank-Emoji“. In den Built-in-Blöcken (Captain / Spieler) ist die Rank-Zeile zusätzlich zum Tracker-Profil verlinkt, wenn eine URL verfügbar ist. In den Listen-Einstellungen kannst du Spieler zusätzlich nach Metric sortieren (höchste oder niedrigste zuerst) statt nach Rolle.

Custom-Text-Variablen

Mit dem Block Eigener Text baust du freie Zeilen. Platzhalter: {{path}}. Filter wie | upper funktionieren wie in Flows. Die Variablennamen sind für alle Games gleich — die Werte füllen sich je nach Team-Spiel (z. B. ist {{mmr}} MMR, RR oder LP). Im Loop: {{ping}} (Discord-Mention), {{name}}, {{nationality}}, {{rankEmoji}}, {{rank}}, {{mmr}} (Metric-Zahl), {{metricUnit}} (MMR / RR / LP), {{mode}} (Playlist / Queue), {{role}}, {{line}} (formatierte Rank-Zeile aus den Rank-Details, inkl. Emoji wenn gemappt), {{tracker}} (Discord-Markdown [Tracker](url)), {{trackerUrl}} (raw URL), {{isCaptain}}. Beispiel:

Mitglieder aus Discord einladen

Staff kann jemanden direkt aus Discord in die SquadVault-Organisation einladen:
  1. Rechtsklick auf den User.
  2. Apps öffnen.
  3. Zu SquadVault einladen wählen.
Der Bot schickt den Join-Link per DM. Auf der Seite mit Discord anmelden — die Discord-E-Mail muss nicht zur Einladung passen. Blockiert Discord die DM (Privatsphäre), steht der Link in der Command-Antwort, damit Staff ihn teilen kann. Es gilt dieselbe Staff-Freigabe wie bei /org und /team. Die Einladung erzeugt die Rolle member; die Rolle kann danach in SquadVault geändert werden.

Discord-Events

Aktiviere Discord-Events synchronisieren in den Discord-Einstellungen, um die geplanten Events deines Servers mit dem Kalender zu verbinden. Der Sync ist standardmäßig aus und funktioniert in beide Richtungen:
  • Discord → SquadVault: In Discord erstellte Events erscheinen im Kalender als organisationsweite Discord-Event-Termine. Änderungen in Discord werden übernommen; wird das Event in Discord abgesagt oder gelöscht, verschwindet es aus dem Kalender.
  • SquadVault → Discord: Erstelle einen Termin vom Typ Discord-Event, und SquadVault legt ihn auf deinem Server an. Änderungen aktualisieren das Discord-Event; Löschen oder ein anderer Typ entfernt es aus Discord.
Wähle beim Termin den Ort in Discord:
  • Link zu SquadVault (Standard) — ein externes Discord-Event, das auf den Termin in SquadVault verlinkt.
  • Ein Sprach- oder Stage-Kanal — das Event findet in diesem Kanal statt. Die Auswahl zeigt nur Kanäle, die der Bot tatsächlich öffnen kann.
Nur geteilte Einzeltermine in der Zukunft werden an Discord gesendet. Persönliche Termine und Serien bleiben in SquadVault.

Bot-Berechtigungen

Der Event-Sync braucht die Bot-Berechtigungen Events erstellen und Events verwalten. Stage-Events brauchen zusätzlich Kanäle verwalten, Mitglieder stummschalten und Mitglieder verschieben. Bots, die vor dem Event-Sync eingeladen wurden, haben diese meist nicht. Fehlen Berechtigungen, zeigen die Discord-Seite und das Dashboard eine Warnung mit Berechtigungen aktualisieren. Autorisiere den Bot einmal über diesen Link neu — er bleibt auf deinem Server und behält alle Einstellungen. Lehnt Discord ein Event ab, speichert SquadVault es trotzdem, zeigt einen Hinweis und postet den Fehler in den Log-Channel, falls einer gesetzt ist.

Tipps

  • Vor dem ersten Live-Sync auf einem großen Server einen Dry Run nutzen.
  • SquadVault als Quelle der Wahrheit für Roster-Änderungen behalten, dann nach außen syncen.
  • Discord-Einstellungen auf Admins beschränken, damit Mappings nicht versehentlich geändert werden.
  • Anlegen, Ändern, Publish und Refresh von Teamlisten erscheinen unter Discord im Audit Log.
  • Rollenvergabe und Willkommensnachrichten mit Flows automatisieren.
  • Gesamt-Health der Verbindungen unter Integrationen prüfen.
Discord Sync setzt Discord in deinem Tarif voraus. Teamlisten brauchen das Feature team_liste (Pro / Elite). Siehe Abrechnung, falls die Seite gesperrt ist.