Skip to content

Installation des AO Master Discord-Bots

Diese Seite führt einen Owner (oder ein Staff-Mitglied mit der Berechtigung Manage Integrations) durch die Einrichtung des AO Master Bots auf einem Discord-Server. Insgesamt sind es zwei Phasen: ein Discord-Login-Bildschirm, der den Bot zu deinem Server hinzufügt, und ein kurzer Slash-Command-Assistent, der den Bot mit deiner AO Master Gilde verknüpft und einen privaten Einstellungs-Kanal erstellt.

Voraussetzungen

  • Du bist der Owner des Discord-Servers oder hast dort die Discord-Berechtigung Manage Server.
  • Du hast bereits deine AO Master Gilde im Web erstellt (Schnellstart — Owner) — das ist die Gilde, mit der dieser Bot gekoppelt wird. Falls nicht, siehe die Alternative „Create New" in §4 unten.
  • Etwa 5 Minuten.

Schritt 1 — Öffne den Button „Invite Bot" im Web

Öffne AO Master, klicke auf deine Gilde in der Seitenleiste und gehe dann zu Management → Discord Integration. Solange der Bot noch nicht verknüpft ist, zeigt die Seite eine zentrierte Karte Not paired yet mit drei nummerierten Schritten.

AO Master Web — Minion Test Gilde, Discord Integration Kanal in der Seitenleiste unter MANAGEMENT ausgewählt. Hauptbereich zeigt eine zentrierte Karte „Not paired yet" mit drei nummerierten Schritten: (1) Lade den Bot auf deinen Discord-Server ein mit einem blauen Invite Bot Button, (2) Führe /guild pair auf deinem Discord-Server aus mit einem Hinweis, dass der kurze Assistent einen Einstellungs-Kanal erstellt, (3) Komme auf diese Seite zurück, um Rollen-Pairings + Mitglieder-Kanäle zu sehen.

Klicke auf den blauen Button Invite Bot in Schritt 1. Er öffnet einen neuen Browser-Tab auf Discords Autorisierungsseite.


Schritt 2 — Autorisiere den Bot in Discord

Die Discord-Autorisierungsseite fordert dich auf, den Server auszuwählen, dem der Bot hinzugefügt werden soll.

Discord-Autorisierungsseite. Die Karte in der Mitte zeigt das AO Master App-Symbol neben dem Discord-Avatar eines Benutzers, Überschrift „AO Master wants to access your Discord account", eine Zeile „Signed in as zilo · Not you?", drei Berechtigungs-Zeilen (✓ Add a bot to a server, ✓ Create commands, ✗ Solve a mystery with Scooby and the gang), ein Server-Dropdown auf „Minion Test" gesetzt, ein Hinweis „This requires you to have Manage Server permission in the server", sowie Cancel- und Continue-Buttons unten.

Wähle deinen Server aus dem Dropdown Add to server und klicke dann auf Continue.

„Solve a mystery with Scooby and the gang"?

Das ist eine Platzhalter-Zeile, die Discord auf jede Autorisierungsseite setzt, um dich daran zu erinnern, welche Berechtigungen NICHT angefordert werden. Sie ist harmlos — Discords spielerische Art zu sagen „die App hat danach nicht gefragt."

Discord zeigt dann die genauen Berechtigungen, die dem Bot auf deinem Server gewährt werden.

Zweite Discord-Autorisierungsseite. Gleiches Karten-Layout, Überschrift „AO Master wants to access your Discord account" erneut, dann „Confirm that you want to grant AO Master the following permissions on Minion Test:" mit einer einzelnen angehakten Zeile „✓ Administrator". Darunter: ein kleiner Hinweis auf die Datenschutzrichtlinie des Entwicklers, der Bot ist seit dem 8. April 2026 aktiv, wird in 6 Servern genutzt, und „This application cannot read your messages or send messages as you." Buttons: Back + Authorize.

Der Bot bittet um die Administrator-Berechtigung. Damit kann er seine eigene Kategorie und Kanäle erstellen, Rollenzuweisungen verwalten, um Web ↔ Discord synchron zu halten, und in Kanäle posten, die ihm gehören. Klicke auf Authorize.

Administrator ist weitreichend — das ist Absicht

Discord bietet keine feiner abgestuften Berechtigungen für Bots, die ihre eigene Kanalstruktur verwalten müssen. Der Bot liest nicht deine Nachrichten und sendet nicht Nachrichten in deinem Namen (Discord zeigt beide Garantien direkt auf der Autorisierungsseite an). Wenn du den Bot lieber von einem Server fernhalten möchtest, führe dort einfach /guild pair nicht aus — siehe Unpair am Ende dieser Seite.

Ein Erfolgs-Bildschirm bestätigt, dass der Bot beigetreten ist.

Letzter Discord-Bildschirm mit einem grünen Häkchen-Symbol, Überschrift „Success!", Text „AO Master has been authorized and added to Minion Test." und einem Footer „You may now close this window or tab."

Schließe den Tab. Wechsle zurück zu Discord selbst.


Schritt 3 — Führe /guild pair aus

Tippe in einem beliebigen Textkanal auf deinem Discord-Server /guild pair. Discord zeigt ein Autocomplete-Dropdown — wähle den hervorgehobenen Eintrag.

Discord-Nachrichten-Editor mit getipptem „/guild pair". Ein „COMMANDS MATCHING /GUILD PAIR" Dropdown schwebt über dem Editor mit einem einzelnen Eintrag: AO Master Bot-Symbol, „/guild pair" Befehlsname, Beschreibung „Pair this Discord server with your AO Master guild" und einem „AO Master" Tag rechts.

Drücke Enter. Der Bot antwortet mit einer privaten Assistenten-Nachricht, die nur du sehen kannst.

„Only you can see this"

Jeder Schritt des Assistenten ist unten mit Only you can see this · Dismiss message markiert — Discords Art zu sagen, dass die Nachricht privat für die Person ist, die den Slash-Command ausgeführt hat. Niemand sonst auf dem Server sieht die Buttons, die Dropdowns oder deine Antworten.


Schritt 4 — Wähle eine Sprache

Der erste Bildschirm des Assistenten fragt, in welcher Sprache der Bot ab jetzt antworten soll.

Antwort des Bot-Assistenten (privat). Überschrift „🛡 Welcome to AO Master Setup". Text: „Pick your preferred language. Slash-command replies will use it from here on. Pick from the dropdown to change, or click Continue to keep the default." Ein Dropdown zeigt „🇬🇧 English" (eingeklappt). Buttons: Continue → English (lila) + Cancel.

Das Dropdown ist standardmäßig auf die Sprache deines Discord-Clients eingestellt. Um etwas anderes zu wählen, öffne es — der Bot unterstützt 15 Sprachen.

Gleicher Assistent, Dropdown ausgeklappt. Die obersten 5 Einträge sind sichtbar: 🇬🇧 English (angehakt), 🇩🇪 Deutsch, 🇪🇸 Español, 🇫🇷 Français, 🇮🇹 Italiano. Ein Scrollbalken rechts zeigt weitere Sprachen darunter.

Wähle die Sprache und klicke dann auf Continue → (das Button-Label aktualisiert sich mit deiner Wahl). Du kannst sie später über die Web-Einstellungen ändern.


Schritt 5 — Wähle, welche AO Master Gilde gekoppelt wird

Wenn du bereits AO Master Gilden im Web besitzt, listet der nächste Bildschirm sie auf und lässt dich diesen Discord-Server mit einer davon koppeln. (Falls du noch keine hast, kannst du hier direkt eine erstellen — siehe Hinweis-Box unten.)

Antwort des Bot-Assistenten. Überschrift „Pick your AO Master guild". Unterzeile „Language: 🇬🇧 English". Text: „You have access to 5 AO Master guild(s) that aren't paired anywhere yet (as owner or with Manage Integrations). Pick one to pair to this Discord server, or Create New to start fresh." Ein Dropdown mit der Beschriftung „Pick a guild — or create new". Buttons: 🔙 Back + Cancel.

Öffne das Dropdown. Jede Zeile zeigt den Namen der AO Master Gilde plus ihre Albion-Gilden-ID und Region.

Gleicher Assistent, Dropdown ausgeklappt mit Einträgen: CHILIZ (ASIA), Minion Test (ASIA), GOBLINS (ASIA), QuickStart Demo (ASIA) — jeweils mit ihrer Albion-ID darunter — plus einer letzten Zeile „+ Create New AO Master Guild" mit dem Hinweis „Search Albion to pair a fresh guild record."

Wähle die Gilde, die dieser Discord-Server steuern soll.

Create New — alternativer Weg

Falls du noch keine passende AO Master Gilde hast, klicke stattdessen auf + Create New AO Master Guild. Der Assistent verzweigt in einen Regions-Picker, dann ein Suchfeld, in das du den Namen deiner Albion-Gilde eintippst; der Bot ruft Albions Live-API auf, findet die Gilde und erstellt den AO Master Datensatz + koppelt diesen Discord-Server in einem Schritt. Du wirst automatisch zum AO Master Owner.

Der Weg „Create New" fügt zwei zusätzliche Assistenten-Bildschirme hinzu, landet aber bei derselben Confirm-Karte in §6 unten — der Rest der Installation ist identisch.


Schritt 6 — Bestätige die Kopplung

Bevor etwas Unwiderrufliches passiert, zeigt der Bot einen Bestätigungs-Bildschirm mit allem, was er gleich tun wird.

Antwort des Bot-Assistenten. Überschrift „Confirm re-pair". Unterzeile „Language: 🇬🇧 English". Drei Felder: Discord-Server: Minion Test. AO Master Gilde: 🛡 Minion Test. Albion ID + Region darunter. Kursive Notiz: „On confirm: this Discord server is paired to the existing AO Master guild record, a #⚙️-guild-settings channel appears here under a new 🛡 AO Master category, and your existing guild data (silver bank, lockers, war roles, members, regear history) is reused as-is." Buttons: ✅ Confirm + pair (grün) + 🔙 Pick another + Cancel.

Lies die Zeile, die mit „On confirm:" beginnt — sie listet wörtlich alles auf, was gleich passiert.

  • Eine neue 🛡 AO Master Kategorie erscheint auf deinem Discord-Server.
  • Ein einzelner #⚙️-guild-settings Kanal landet darin.
  • Die Web-Seite beginnt, dem Bot zu vertrauen, dass er Rollenzuweisungen spiegelt + Nachrichten an diesen Discord-Server liefert.
  • Deine bestehenden AO Master Daten (silver Bank-Salden, lockers, war roles, Mitgliederliste, regear-Historie) bleiben unverändert — die Kopplung verbindet nur die Leitungen, sie setzt nichts zurück.

Klicke auf ✅ Confirm + pair, sobald du bereit bist. Ein kurzer Lade-Bildschirm erscheint, während der Bot alles wegschreibt.

Antwort des Bot-Assistenten. Einzeilig mit Sanduhr-Symbol: „Pairing this Discord server to your existing guild and creating channels…" Darunter: „Only you can see this · Dismiss message".


Schritt 7 — Koppele die Member-Rolle

Sobald die Kopplung steht, wechselt der Assistent direkt in das Rollen-Mapping. Der erste Schritt ist Pflicht: Wähle aus, welche Discord-Rolle deine regulären Mitglieder repräsentiert.

Antwort des Bot-Assistenten. Überschrift „Pair Member role". Text: „Pick the Discord role + web role that represent your regular members — everyone joins with this role by default. The web role you pick will be saved as the guild's default member role (visible later in Guild Settings → Roles → Default member role)." Status-Zeile: „🔍 Available — 3 Discord role(s), 1 web role(s)". Zwei Dropdowns („Pick a Discord role" + „Pick a web role"). Buttons: 🔗 Pair Member role (grün) + Cancel.

Öffne das Dropdown Pick a Discord role und wähle die Rolle, die neue Mitglieder auf Discord bekommen sollen. Der Bot listet jede zuweisbare Rolle auf deinem Discord-Server auf — meist heißt sie etwas wie „Member" oder „@everyone".

Gleicher Assistent, Discord-Rollen-Dropdown ausgeklappt zeigt drei Discord-Server-Rollen: Admin, Guest, Member (Member ist angehakt).

Öffne dann das Dropdown Pick a web role. Wenn du gerade deine AO Master Gilde erstellt hast, wartet dort eine voreingestellte Rolle — die Standard-Member-Rolle.

Gleicher Assistent, Web-Rollen-Dropdown ausgeklappt zeigt eine Option: ⭐ Member (angehakt).

Wähle beide aus und klicke auf 🔗 Pair Member role. Die gewählte Web-Rolle wird zur Standard-Member-Rolle der Gilde — wer später über Discord (per Enlist-Ticket) beitritt, landet automatisch auf beiden Seiten im richtigen Slot.


Schritt 8 — Koppele weitere Rollen (optional)

Nachdem die Member-Kopplung steht, bietet der Bot einen optionalen Zusatz-Durchlauf an, um in einem Rutsch weitere Rollen-Paare zu verdrahten.

Antwort des Bot-Assistenten. Überschrift „Pair other roles (optional)". Text: „✅ Member role paired. Add more role pairs below if you want, or click Done to move on to channel visibility." Status: „📊 Paired so far: 1" und „🔍 Available — 2 Discord role(s), 0 web role(s)". Zwei Dropdowns. Buttons: ➕ Add pair + ✅ Done — finalise (1 paired) + Cancel.

Überspringe diesen Schritt, falls du noch nichts weiter zu koppeln hast — ein Klick auf ✅ Done — finalise geht weiter. Du kannst jederzeit über den Web-Tab Discord Integration → Roles zurückkommen und weitere Paare hinzufügen.


Schritt 9 — Wähle die Kanal-Sichtbarkeit

Die letzte Entscheidung: Welche Discord-Rollen können die neue 🛡 AO Master Kategorie sehen.

Antwort des Bot-Assistenten. Überschrift „🔓 Pick channel visibility". Text: „✅ 1 role pair(s) saved. The visibility you pick here applies to the whole 🛡 AO Master category — #⚙️-guild-settings plus any future channels added under it inherit automatically. You can change the role list later in Discord by editing the category permissions." Zwei Hinweise: ⚠️ „Important: Discord visibility is just 'who can see the channel'. Each button inside is still gated by web permissions — a user without the right web role / permission will see the UI but the action will be rejected." 💡 „Heuristic suggestion: @Member (paired with web role 'Member')". Ein Dropdown zur Auswahl von Discord-Rollen. Buttons: 🔒 Owner-only (just me) + Cancel.

Zwei Hinweise auf diesem Bildschirm verdienen besondere Aufmerksamkeit:

  • Sichtbarkeit ≠ Berechtigung. Eine Discord-Rolle den Kanal sehen zu lassen ist etwas anderes, als ihr zu erlauben, die Buttons darin zu benutzen. Die Buttons sind durch Web-Berechtigungen geschützt (eingestellt unter Settings → Roles → Permissions). Sichtbarkeit zu gewähren entscheidet nur, wer den Kanal in seiner Kanalliste finden kann.
  • Owner-only ist eine schnelle „Erstmal nur für mich, bis ich alles eingerichtet habe"-Option. Du kannst später erweitern, indem du die Kategorie-Berechtigungen direkt in Discord bearbeitest.

Öffne das Dropdown, um jede Discord-Rolle auf deinem Server zu sehen.

Gleicher Assistent, Dropdown ausgeklappt. Vier Discord-Rollen mit Mitgliederzahlen aufgelistet: 🔴 Admin (2 members), 🔵 AO Master (1 member), 🟡 Guest (0), 🟢 Member (0). Jede Zeile hat rechts ein leeres Kontrollkästchen.

Hake eine oder mehrere Rollen an. Das Dropdown unterstützt Mehrfachauswahl — gewählte Rollen erscheinen als entfernbare Chips unter dem Dropdown.

Gleicher Assistent, Zeile Admin angehakt. Unter dem Dropdown ist ein Chip „Admin x" sichtbar.

Die AO Master Rolle

Du wirst einen Eintrag AO Master im Dropdown bemerken — das ist die Rolle, die Discord beim Beitritt des Bots automatisch für ihn erstellt hat. Der Bot nutzt sie intern, um Sichtbarkeitsregeln zu umgehen; du musst sie nicht (und solltest sie nicht) anhaken.

Sobald du deine Auswahl abschließt, beendet der Assistent die Einrichtung.


Schritt 10 — Fertig

Antwort des Bot-Assistenten, finale Karte. Überschrift „🎉 Setup complete!" Stichpunkte: 🛡 Role pairs saved. 💬 Created 🛡 AO Master category with #⚙️-guild-settings inside. 🔓 Visibility: @Admin + you. Future channels added under the category inherit this visibility. Gefolgt von einem „Next steps:" Abschnitt mit drei Stichpunkten — öffne #⚙️-guild-settings, um Enlist zu aktivieren oder andere Features einzustellen; bearbeite Rollen-Paare auf dem Web-Tab Discord Integration → Roles; ändere die Sichtbarkeit später per Rechtsklick auf die AO Master Kategorie und Bearbeiten der Berechtigungen.

Deine Seitenleiste hat nun eine frische 🛡 AO Master Kategorie mit #⚙️-guild-settings darin.

Discord-Seitenleiste von Minion Test. Oben: eingebaute Events + Server Boosts. Dann #welcome (aktuell ausgewählt — die Setup-complete-Ephemeral ist noch in seinem Nachrichten-Panel sichtbar). Unten: eine neue 🛡 AO Master Kategorie, ausgeklappt, mit einem Kind-Kanal #⚙️-guild-settings. Das Hauptpanel rechts zeigt die Setup-complete-Karte aus dem vorigen Screenshot.

Das war's — der Bot ist live. Ab hier:

  • Öffne #⚙️-guild-settings, um Enlist-Tickets zu aktivieren, Rollen-Sync zu konfigurieren und die anderen Discord-seitigen Features einzustellen. Die angepinnte Nachricht in diesem Kanal ist deine zentrale Steuerzentrale; die Seite Kanal-Übersicht führt durch alles darauf.
  • Zurück im Web zeigt Discord Integration jetzt einen grünen Active-Status mit Rollen-Pairings, Mitglieder-Kanälen und dem Live-Verbindungsstand.

Nach der Installation — was kommt als Nächstes

Du willst…Wohin
Enlist-Tickets aktivieren, damit Bewerber per Discord beitreten können#⚙️-guild-settings → Button Enable Enlist (siehe Enlist-Ablauf)
Ally-Pipeline aktivieren, damit Partner-Gilden-Mitglieder sich als Allies bewerben können#⚙️-guild-settings → Button Ally aktivieren (siehe Ally-Ablauf) — Pro Tier
Regear-Request-Posts in Discord aktivieren#⚙️-guild-settings → Button Enable Regear
Weitere Rollen verknüpfenWeb-Tab Discord Integration → Roles
war roles auf Discord-Rollen mappenWeb-Tab Discord Integration → War Roles
Partner-Gilde-Discord-Rollen für Ally-Genehmigungen mappenWeb-Tab Discord Integration → Ally → Partner-Discord-Rollen
Discord-Rollen hinzufügen oder entfernen, die die Kategorie sehenRechtsklick auf 🛡 AO Master Kategorie in Discord → Edit Category → Permissions
Jeden Kanal + Button sehen, den der Bot erstelltKanal-Übersicht
Deinen Albion-Charakter verknüpfenFühre /whoami in einem beliebigen AO Master Kanal aus und folge dann dem Link-Prompt

Unpair

Falls du den Bot je von einem Discord-Server entfernen möchtest:

  1. Öffne im Web Discord Integration → Settings → Unpair.
  2. Tippe UNPAIR zur Bestätigung.

Der Bot löscht seine 🛡 AO Master Kategorie und Kanäle in Discord, entfernt Rollen-Zuordnungen und leert das Mitglieder-Kanal-Verzeichnis. Deine AO Master Gildendaten (Mitglieder, Rollen, Banken, regear-Historie) bleiben erhalten — nur die Discord-seitige Verkabelung wird gekappt. Du kannst jederzeit erneut koppeln, indem du /guild pair auf einem neuen (oder demselben) Discord-Server ausführst.