Rollenportale

Beschreibung

Benutzerhandbuch

Veröffentlichen Sie eine Nachricht mit einer Schaltfläche: Wer klickt, erhält eine oder mehrere Rollen — vorausgesetzt, er besitzt bereits die von Ihnen verlangten Rollen. Ideal, um den Zugang zu einem geschützten Bereich nach einem ersten Schritt zu öffnen.

Was es tut

• Veröffentlicht einen individuellen Embed mit einer Schaltfläche im Kanal Ihrer Wahl.
• Prüft die erforderlichen Rollen, bevor irgendetwas gewährt wird.
• Weist die zu vergebenden Rollen mit einem Klick zu, ohne Eingriff des Staffs.
• Antwortet privat im Kanal (kurzzeitige Nachricht): Weder Erfolg noch Ablehnung stören die Unterhaltung.
• Die Schaltfläche bleibt dauerhaft aktiv: Sie funktioniert auch nach einem Neustart des Bots.

Dieses Modul ist nicht AutoRole, Role Gate oder RoleRoster

Vier Module befassen sich mit Rollen, mit klar unterschiedlichen Aufgaben:

Modul	Prinzip
Rollenportale	Eine bedingte Schaltfläche: wenn Sie die Rollen A und B haben, dann erhalten Sie die Rolle C.
AutoRole	Panels mit Auswahlmenüs, aus denen sich jeder frei bedient und wieder abwählen kann, was er genommen hat. Keine Bedingung.
Role Gate	Rollen, die beim Beitritt automatisch vergeben werden, Rollentausch und Entzug von Rollen bei abwesenden Mitgliedern. Kein Klick.
RoleRoster	Ein Verzeichnis: zeigt die Liste der Mitglieder einer Rolle an. Vergibt nichts.

Kurz gesagt: Das Portal ist das einzige der vier, das eine Bedingung stellt, bevor es eine Rolle gewährt.

Schnellstart (Admin)

1. Öffnen Sie das Dashboard → Kategorie Tools & Staff → Sichere Portale.
2. Klicken Sie auf Neues Portal.
3. Vergeben Sie einen internen Namen (er erscheint nicht auf Discord) und wählen Sie den Zielkanal.
4. Geben Sie die zu vergebenden Rollen an — das ist verpflichtend — und, falls nötig, die erforderlichen Rollen.
5. Passen Sie Embed und Schaltfläche an und speichern Sie.
6. Klicken Sie in der Liste auf das Sendesymbol, um das Panel im Kanal zu veröffentlichen.

Befehle

Dieses Modul hat keine Discord-Befehle: Alles wird über das Dashboard konfiguriert, und die Mitglieder nutzen nur die Schaltfläche des Panels.

Einstellungen im Dashboard

Die Liste der Portale zeigt für jedes den Namen, den Kanal, die erforderlichen und die vergebenen Rollen, mit drei Aktionen: Panel veröffentlichen, bearbeiten, löschen.

Das Konfigurationsfenster fasst vier Blöcke zusammen:

• Grundangaben: interner Name (verpflichtend) und Zielkanal (verpflichtend).
• Bedingungen & Gewinne:
  • Erforderliche Rollen — optional. Wenn Sie dieses Feld leer lassen, kann jeder klicken.
  • Zu vergebende Rollen — verpflichtend, eine oder mehrere Rollen.
• Erscheinungsbild (Embed): Titel, Beschreibung und Farbe.
• Schaltfläche: angezeigter Text und Emoji (mit Emoji-Auswahl).

Die Anzahl der Portale ist für einen Server ohne Premium auf 1 begrenzt (Standardwert, vom TennoCore-Team anpassbar).

Gut zu wissen

• Der Bot benötigt die Berechtigung Rollen verwalten, und seine Rolle muss oberhalb der Rollen stehen, die er vergeben soll. Andernfalls erhält das Mitglied eine Fehlermeldung, die auf die Hierarchie hinweist.
• Die erforderlichen Rollen werden mit UND geprüft: Das Mitglied muss alle aufgeführten Rollen besitzen. Fehlen ihm welche, nennt der Bot genau, welche.
• Ein Mitglied, das alle Rollen des Portals bereits besitzt, erhält lediglich einen Hinweis, ohne weitere Wirkung.
• Das Portal entzieht niemals eine Rolle. Für eine Umschaltfunktion (nehmen / zurückgeben) verwenden Sie AutoRole.
• Ein Portal zu ändern verändert nicht die bereits veröffentlichte Nachricht: Text, Farbe und Beschriftung der Schaltfläche bleiben die ursprünglichen. Veröffentlichen Sie das Panel erneut, um eine aktuelle Nachricht zu erhalten, und löschen Sie dann die alte.
• Lassen Sie nicht mehrere Exemplare desselben Portals im Server: Nach einem Neustart des Bots wird nur die letzte veröffentlichte Nachricht wieder aktiviert, die älteren Schaltflächen werden wirkungslos.
• Ein Portal im Dashboard zu löschen löscht nicht die auf Discord gepostete Nachricht: Die Schaltfläche bleibt sichtbar, aber ohne Wirkung. Löschen Sie die Nachricht von Hand.
• Der Kanal muss ein Kanal sein, in dem der Bot schreiben darf; wurde der Kanal zwischenzeitlich gelöscht, scheitert die Veröffentlichung.
• Die Portale funktionieren auch mit einem eigenen Bot: Die Schaltfläche wird von Ihrem Bot bedient, wenn TennoCore nicht auf dem Server ist.