Planning-System¶
Das Planning-System ist die Discord-seitige Brücke zum Off-Planner auf tw-utils.net. Zusätzlich zur Website haben die Spieler auch über den tw-utils Discordbot die Möglichkeit Adelsgeschlechter zu melden, Abschickzeiten einzutragen und Herkunftsdörfer auszuplanen. Die Stammesführung kann im Gegenzug die fertig erstellten Angriffspläne verteilen. Zusätzlich können die Leader auch von unterwegs über Discord Einsicht in die Planung nehmen.
Voraussetzung verifizierter TW-Account
Ohne verknüpften Account können die Eingabe-Buttons und der Download-Button im Plan-Verteilungs-Kanal nicht genutzt werden.
1. Kanäle des Moduls¶
Nach der Installation legt der Bot die Kategorie 🪓 PLANNING-SYSTEM mit vier Basis-Kanälen an:
#⚫-queries— Meldungs-Kanal für Spieler (AG-Meldungen, Abschickzeiten, Off-Ausschlüsse)#⚫-plan-distribution— Spieler können sich hier Ihren persönlichen Angriffsplan herunterladen#⚫-leaderview-planinfo— Leader können hier Einsicht in die geplanten Befehle nehmen#⚫-nuke-replacement— ermöglicht das strukturierte Suchen nach Ersatz-Offs
2. AG-Meldungen¶
Im #⚫-queries-Kanal findest Du unterhalb des Queries-Embeds drei farblich markierte Buttons: Snob Report, Launch Times und Off-Exclusion.
Per Klick auf Snob Report öffnet sich ein ephemerales Sub-Menü mit den Buttons Add, Show und Delete.
Über den Add-Button startest Du eine neue AG-Meldung. Zunächst wählst Du im Dropdown den verifizierten TW-Account aus, für den die Meldung gelten soll.
Anschließend öffnet sich das AG-Meldungs-Modal, in dem Du die Details der Meldung einträgst.
Nach erfolgreichem Absenden bestätigt der Bot Deine Meldung mit einer kurzen ephemeralen Erfolgsmeldung.
Über den Show-Button kannst Du Dir alle bereits gemeldeten AGs für den ausgewählten Account anzeigen lassen.
Über den Delete-Button kannst Du eine konkrete AG-Meldung wieder löschen.
3. Abschickzeiten¶
Per Klick auf Launch Times öffnet sich analog ein ephemerales Sub-Menü mit den Buttons Add, Show und Delete.
Über den Add-Button startest Du eine neue Abschickzeit-Meldung. Zunächst wählst Du im Dropdown den verifizierten TW-Account aus, für den die Zeit gelten soll.
Anschließend öffnet sich das Abschickzeiten-Modal, in dem Du Dein verfügbares Zeitfenster einträgst.
Über den Show-Button kannst Du Dir alle bereits hinterlegten Zeitfenster für den ausgewählten Account anzeigen lassen. Über den Delete-Button kannst Du ein konkretes Zeitfenster wieder löschen.
4. Off-Ausschluss¶
Per Klick auf Off-Exclusion öffnet sich das Sub-Menü mit den Buttons Add, Show und Delete.
Über den Add-Button startest Du eine neue Off-Ausschluss-Meldung. Zunächst wählst Du im Dropdown den verifizierten TW-Account aus, für den der Ausschluss gelten soll.
Anschließend öffnet sich das Off-Ausschluss-Modal, in dem Du die Herkunfts-Dörfer einträgst, die der Planer für Dich nicht als Off-Quelle nutzen soll.
Über den Show-Button kannst Du Dir alle bereits hinterlegten Off-Ausschlüsse für den ausgewählten Account anzeigen lassen. Über den Delete-Button kannst Du einen konkreten Eintrag wieder löschen.
5. Admin-Funktionen¶
Unterhalb der Spieler-Buttons stehen im #⚫-queries-Kanal zwei zusätzliche Admin-Buttons zur Verfügung.
Mit Admin: Delete All lassen sich alle AG-Meldungen, Abschickzeiten und Off-Ausschluss-Einträge auf dem gesamten Server löschen. Das ist vor allem dann sinnvoll, wenn die Stammes-Führung mit einer komplett neuen Planung starten und alle Alt-Daten der Spieler aus den drei Abfrage-Bereichen zurücksetzen möchte. Vor der Ausführung erscheint eine Bestätigungs-Abfrage mit den Buttons Confirm und Cancel, sodass nichts versehentlich gelöscht wird.
Über den Admin: Export-Button kannst Du alle aktuell vorliegenden Meldungen als Datei exportieren — praktisch, um die gesammelten Eingaben z. B. außerhalb von Discord in der Stammes-Führung weiterzuverarbeiten.
Wer darf Admin-Funktionen nutzen?
Die Buttons Admin: Delete All und Admin: Export können nur User mit der Rolle TWU-Mod oder Discord-Administrator-Rechten ausführen. Für normale Mitglieder sind diese Buttons zwar sichtbar, aber ein Klick wird vom Bot mit einer Berechtigungs-Fehlermeldung abgelehnt.
6. Plan-Verteilung¶
Im #⚫-plan-distribution-Kanal findest Du unterhalb des Plan Distribution-Embeds den Button Download.
Klick auf Download: Der Bot prüft die verknüpften TW-Accounts des Spielers und schickt ihm seine Angriffspläne zum Download per Discord-DM zu.
Plan-Download per DM
Damit der Bot die Pläne zustellen kann, müssen Direktnachrichten vom Bot in den Discord-Einstellungen erlaubt sein. Andernfalls erscheint eine ephemerale Fehlermeldung im Kanal mit dem Hinweis, die DMs zu aktivieren.
7. Plan-Informationen¶
Im #⚫-leaderview-planinfo-Kanal findest Du unterhalb des Plan Information-Embeds den Button Retrieve Plan Information.
Per Klick auf Retrieve Plan Information öffnet sich das Modal Plan Information. Trage dort im Feld Coordinate die gewünschte Zielkoordinate im Format XXX|YYY ein und schicke das Modal ab, um die geplanten Befehle für dieses Dorf anzeigen zu lassen.
Der Bot rendert daraufhin direkt im Kanal eine Übersicht aller aktuell geplanten Befehle aus allen aktiven Plan-Containern für die angegebene Koordinate.
Die detailliertere Ansicht zeigt zusätzlich die einzelnen Befehle mit Herkunfts-Dorf, Spieler, Befehlstyp sowie Abschick- und Ankunftszeit — damit kannst Du auf einen Blick erkennen, welche Spieler welchen Befehl auf das Ziel-Dorf vorbereiten.
Sichtbarkeit Leaderview-PlanInfo
Der #⚫-leaderview-planinfo-Kanal ist standardmäßig nur für User mit der Rolle TWU-Mod sichtbar. Normale Mitglieder sehen den Kanal nicht — Plan-Informationen bleiben damit innerhalb der Stammes-Führung.
8. Off-Ersatz¶
Im #⚫-nuke-replacement-Kanal findest Du oben unter dem Nuke-Replacement-Embed fünf Verwaltungs-Buttons; darunter listen zwei Status-Embeds (NOT DONE und DONE) den aktuellen Stand aller Ersatz-Anfragen auf.
Über den Button Request Nuke-replacement stellst Du eine neue Ersatz-Anfrage, wenn Du einen geplanten Off nicht selbst losschicken kannst und einen Stammeskollegen suchst, der das übernimmt.
Per Klick öffnet sich das Anfrage-Modal mit Eingabefeldern für die Zielkoordinate, den gewünschten Abschickzeitpunkt und die Off-Größe (Angabe als Axt- und LKav-Anzahl).
Nach dem Abschicken wird die Anfrage im Embed unter NOT DONE einsortiert, sodass alle Stammesmitglieder sehen, wo noch Ersatz gesucht wird.
Mit dem Button I want to replace a Nuke übernimmst Du eine bestehende offene Anfrage.
Per Klick öffnet sich zunächst ein Dropdown, in dem Du die konkrete Anfrage auswählst, die Du übernehmen möchtest.
Danach folgt ein Eingabefeld, in dem Du den eigenen verifizierten Account einträgst, mit dem Du die Übernahme leistest.
Nach erfolgreicher Übernahme wandert die Anfrage in den DONE-Bereich des Embeds, damit für alle ersichtlich ist, dass ein Ersatz gefunden wurde.
Über den Button Withdraw replacement kannst Du eine bereits zugesagte Übernahme wieder zurückziehen; die Anfrage geht dann zurück in den NOT DONE-Bereich.
Über den Button Delete Request kannst Du eine eigene Anfrage komplett löschen, sobald sie nicht mehr gebraucht wird.
Mit Admin: Delete all requests lassen sich schließlich alle Off-Ersatz-Anfragen auf einen Schlag löschen; vor dem Löschen erscheint eine Bestätigungs-Abfrage.
Wer darf Off-Ersatz-Anfragen löschen?
Eine einzelne Anfrage kann nur der Ersteller selbst oder ein User mit der Rolle TWU-Mod über Delete Request löschen. Der Button Admin: Delete all requests zum gesammelten Löschen aller Anfragen steht ausschließlich Usern mit der Rolle TWU-Mod oder Discord-Administrator-Rechten zur Verfügung.