Skip to content

Ally-Flow auf Discord

Die Ally-Pipeline ist der kanonische Weg für jemanden aus einer Partner-Gilde, sich als Ally auf Discord zu bewerben. Sie ist das strukturelle Gegenstück zum Enlist-Flow — ein Bewerber-Klick öffnet ein privates Review-Ticket, ein Reviewer führt einen kurzen Wizard aus, um zu überprüfen, als welcher Charakter sie sich bewerben, und ein Archiv-Transkript landet beim Schließen in einem Forum.

Diese Seite geht die gesamte Pipeline aus der Perspektive jeder Rolle durch — Owner richtet sie ein, Ally-Bewerber klickt den Button, Reviewer führt die Slash-Befehle aus. Der Aufbau spiegelt Enlist sehr genau; der Abschnitt Unterschiede gegenüber Enlist am Ende erklärt, was Ally-spezifisch ist.

Voraussetzungen

  • Der Bot ist mit deiner AO Master Gilde verbunden — siehe Installieren + verbinden.
  • Deine Gilde ist auf dem Pro-Tier oder höher (die Alliance-Pipeline ist Tier-gebunden).
  • Die Person, die die Einrichtung vornimmt, ist entweder der Discord-Server-Besitzer oder hat die Manage Integrations-Berechtigung in AO Master.
  • Eine Discord-Rolle existiert, die als „Reviewer" fungiert — jeder mit dieser Rolle kann auf Tickets reagieren. Erstelle sie zuerst in Discord, wenn du noch keine hast.

1. Owner — den Ally Hub einrichten

Der Ally Hub wird vom selben #⚙️-guild-settings-Channel wie Enlist aus bereitgestellt. Die angepinnte Guild Settings-Nachricht hat jetzt vier Buttons in der ersten Zeile: [🔍 View Config] [🎯 Manage Enlist] [💰 Manage Regear] [🤝 Enable Ally].

Klicke auf den grünen 🤝 Enable Ally-Button. Ein ephemeres Panel erscheint mit dem Status „Not set up" und einem einzigen arbeitenden Button — ⚙ Setup.

Setup-Wizard (2 Schritte)

Der Wizard hat dieselbe Form wie der Enlist-Setup (gleiches 2-Schritt-Muster, dokumentiert auf Enlist-Flow):

  1. Reviewer Discord-Rollen wählen — Mehrfachauswahl-Dropdown deiner Server-Discord-Rollen mit Live-Mitgliederzahlen. Der Wizard lehnt @everyone und verwaltete Bot-Rollen ab. Jeder mit einer der gewählten Rollen sieht Ally-Tickets und darf /ally review / /ally reject / /ally done ausführen.
  2. Bestätigen — kurze Bestätigungskarte, die auflistet, was erstellt wird: #🤝-ally-here-Channel + 🤝 Ally-Kategorie sowie den angepinnten [Apply as Ally]-Button. Klicke auf ✅ Confirm.

Nach ~5 Sekunden rendert das Panel zum vollständigen Manage Ally-Dashboard neu.

Manage Ally Dashboard

Das Post-Setup-Panel spiegelt das Manage Enlist-Dashboard mit den Ally-spezifischen Extras unten. Buttons umfassen:

  • ⚙ Reconfigure — Recruiter-Rollen-Auswahl erneut ausführen.
  • ? Edit Questions — Bewerbungsfragen ändern, die Ally-Bewerber gefragt werden. (Geteilter Editor; dieselben Fragen erscheinen auch auf der Web-/ally/<code>-Seite.)
  • 📝 Edit Template / ✏️ Edit Ally Message / ✏️ Edit Ticket Message / ✏️ Edit Ally Button — angepinnten Nachrichtentext, die Willkommensnachricht in jedem Ticket, das Button-Label anpassen.
  • 📋 Map Ally Channel / 📂 Map Ticket Category — angepinnten Button oder neue Tickets auf vorhandene Discord-Channels / Kategorien anstelle der automatisch erstellten zeigen.
  • 🚫 Pause Ally — keine neuen Bewerber mehr annehmen, aber laufende Tickets offen lassen.
  • 🔄 Refresh Pinned — die angepinnte [Apply as Ally]-Nachricht in #🤝-ally-here neu rendern.
  • 🎮 Auto-Name: OFF / ON — das Discord-Nickname-Umbenennen bei Genehmigung umschalten (standardmäßig AN).
  • 🔧 Rebuild — jeden ausstehenden Ally-Bewerber automatisch ablehnen + den #🤝-ally-here-Channel und die 🤝 Ally-Kategorie löschen + frisch neu erstellen. Reviewer-Rollen + Nachrichten-Anpassungen bleiben erhalten.
  • 🗑 Disable Ally — die gesamte Ally-Discord-seitige Konfiguration löschen. Die Discord-Channels bleiben, werden aber unverwaltet. Reversibel durch erneutes Ausführen des Setups.

Jede Einstellung kann auch auf dem Web unter #Discord Integration → Integrations → Ally bearbeitet werden (siehe Discord-Integration). Änderungen synchronisieren sich beide Wege in Echtzeit.


2. Ally-Bewerber — auf [Apply as Ally] klicken

Für alle außerhalb der Gilde ist der einzige Channel, den sie in der 🤝 Ally-Kategorie sehen können, #🤝-ally-here. Die angepinnte Nachricht hat den [Apply as Ally]-Button (oder dein benutzerdefiniertes Label).

Wenn ein Bewerber auf den Button klickt:

  1. Der Bot erstellt einen privaten Channel, benannt nach der Ticket-Channel-Name-Vorlage (Standard 🤝-ally-<discord-benutzername>). Nur der Bewerber + Reviewer-Rollen können ihn sehen.
  2. Der Bot postet die Willkommensnachricht oben im Ticket — das angepasste Intro der Gastgeber-Gilde + alle Bewerbungsfragen, die die Gastgeber-Gilde eingestellt hat.
  3. Der Bot antwortet mit einem ephemeren Hinweis, der den Bewerber auffordert, die Fragen im Ticket zu beantworten.

Der Bewerber tippt seine Antworten als reguläre Discord-Nachrichten. Reviewer sehen diese Nachrichten im Ticket; die Antworten werden nicht in der AO-Master-Datenbank gespeichert (sie leben nur im Discord-Transkript).


3. Reviewer — /ally review, /ally reject, /ally done

Drei Slash-Befehle decken die gesamte Reviewer-Seite ab. Alle drei sind auf die in dem Manage Ally-Panel eingestellten Reviewer-Rollen beschränkt.

/ally review

Führe es innerhalb eines Ally-Ticket-Channels aus. Öffnet einen Wizard:

  1. Charakter aus der Allianz auswählen — ein Dropdown, das Charaktere aus deinen Allianz-Partnern auflistet. Der Bewerber erklärt, als welchen Charakter er sich bewirbt; die Auswahl ist auf Allianz-Partner-Gilden beschränkt, damit ein Reviewer nicht versehentlich jemanden aus einer Nicht-Partner-Gilde genehmigen kann.
  2. Bestätigen — eine Zusammenfassungskarte zeigt den gewählten Charakter + ihre Heimat-Partner-Gilde (live von der Albion-API aufgelöst). Klicke auf ✅ Confirm.

Bei Bestätigung:

  • Die Ally-Zeile wird zu #Allies auf der AO Master Web-Seite hinzugefügt (Status: Linked).
  • Der Bot fügt dem Discord-Konto des Bewerbers die AO Ally-Rolle hinzu (automatisch erstellt beim ersten Aktivieren von Ally; farblich passend zum konfigurierten Ally Role chip).
  • Wenn ein Partner-Rollen-Mapping für die gewählte Heimatgilde existiert, vergibt der Bot auch diese Rolle (z. B. bekommt ein Bewerber aus „Cozy Chilipi" sowohl AO Ally + eine Cozy-Chilipi-Rolle).
  • Wenn Auto-Name AN ist, benennt der Bot den Discord-Nickname des Bewerbers passend zum gewählten Albion-Charakter um.

/ally reject

Führe es aus, wo Reviewer posten können (typischerweise innerhalb des Tickets). Verwendung:

/ally reject user:@<bewerber> reason:<optionaler grund>
  • Die ausstehende Beitrittsanfrage des Bewerbers wechselt zu Rejected.
  • Der Bot sendet dem Bewerber eine DM mit dem Grund (oder einem Standard-Grund, wenn du ihn weggelassen hast).
  • Das Ticket wird sofort geschlossen; das Transkript wird NICHT archiviert (Ablehnungs-Schließungen überspringen das Archiv-Forum absichtlich — abgelehnte Tickets sind Rauschen).

/ally done

Führe es innerhalb des Tickets aus, NACHDEM /ally review den Bewerber genehmigt hat. Zwei Dinge passieren:

  1. Das vollständige Ticket-Gespräch wird gespiegelt — mit Original-Autorennamen + Avataren + jeder angehängten Datei — in einen privaten Forum-Thread innerhalb des 🗄-ally-archive-Forum-Channels. Das Forum + der Webhook, den der Bot zum Posten verwendet, werden automatisch beim ersten Mal erstellt, wenn /ally done ausgeführt wird (eine Gilde, die nie archiviert, trägt kein leeres Forum mit sich).
  2. Der Ticket-Channel wird gelöscht.

Der Archiv-Thread-Titel entspricht dem Ticket-Channel-Namen, damit Reviewer das Forum später nach Benutzernamen durchsuchen können.


4. Unterschiede gegenüber Enlist

Die beiden Flows teilen das strukturelle Grundgerüst, aber Ally hat einige Besonderheiten, die es auf der Enlist-Seite nicht gibt:

AspektEnlistAlly
Tier-GateFree Tier und höherPro Tier und höher
Charakter-AuswahlFreitext-Suche in AlbionAllianz-Roster-Auswahl (auf Partner-Gilden beschränkt)
Rollenvergabe bei GenehmigungDiscord-Rolle aus Mapping-TabelleAO Ally universelle Rolle + optionale Partner-Rolle basierend auf Heimatgilde
Visueller Marker im WebReguläre AO Master RolleAlly Role chip (Label + Farbe)
Roster-Channel im Web#Members#Allies
Defections-CronentfälltTägliche Prüfung; wechselt Status zu Left alliance, wenn die Heimatgilde des Ally die Allianz verlässt — siehe Ally Role Sync
Slash-Befehle/enlist review, /enlist reject, /enlist done/ally review, /ally reject, /ally done
Angepinnter Channel Standard#📋-enlist-here#🤝-ally-here
Ticket-Channel-Präfix🎯-enlist-…🤝-ally-…
Archiv-Forumapply-archive🗄-ally-archive

Alles, was nicht in der Tabelle steht, funktioniert genauso — gleiche Setup-Wizard-Form, gleiches Panel-Layout, gleicher Archiv-Transkript-Flow, gleiche Pause / Rebuild / Disable-Semantiken.


5. Wenn das Alliance-Feature „gehalten" wird

Alliance ist Tier-gebunden auf Pro. Wenn deine Gilde vom Pro-Tier auf einen niedrigeren Tier fällt (Abonnement abläuft, Downgrade), tritt die Pipeline in den Hold-Modus:

  • Der 🤝 Enable Ally-Button auf #⚙️-guild-settings wird durch einen ausgegrauten [🔒 Alliance — Pro tier needed]-Zustand ersetzt.
  • Bestehende Ally-Tickets bleiben offen, aber keine neuen Bewerber können sich bewerben.
  • Der Defections-Cron pausiert (dein Roster dreht sich nicht, nur weil du einen Tier gefallen bist).
  • Bestehende Allies behalten ihre AO Ally-Rolle und Roster-Zeile.

Die Wiederherstellung des Pro-Tiers schaltet die Pipeline automatisch wieder auf aktiv — kein erneutes Setup nötig.


6. Web-seitiger Spiegel

Jede Einstellung im Manage Ally Discord-Panel lebt auch unter #Discord Integration → Integrations → Ally im Web (siehe Discord-Integration). Die Cross-Surface-Einstellungen (Receive new applicants Toggle, Custom apply questions, Ally Role chip) liegen auf Settings → Recruitment (Ally äußerer Tab) und werden auch auf der Discord-Integration Ally-Unterseite unter einer Related settings-Karte angezeigt.

Wähle die Oberfläche, die gerade bequemer ist — sie synchronisieren sich in Echtzeit über denselben Channel.