tw-utils Doku¶
Willkommen zur Dokumentation von tw-utils.
FAQ¶
Erste Schritte & Account¶
Wie verknüpfe ich meinen DS-Account?
Wechsle in eurem Stammes-Discord in den Kanal #⚫-bot-config und klicke auf Account-Verification. Der Bot führt dich durch den Wizard: Spielername eingeben, Code in dein Ingame-Profil eintragen, mit dem Verify-Button bestätigen.
Brauche ich einen Account — geht es auch ohne Discord?
Nein, der Discord-Login ist der einzige Weg auf die Website; ein Registrierungs- oder Passwortformular gibt es nicht. tw-utils fragt bei Discord keine E-Mail-Adresse ab — übernommen werden nur deine Discord-ID, dein Name und dein Avatar.
Mein Verifizierungs-Code funktioniert nicht — was kann ich tun?
Der Code TWU-VERIFY-XXXXXX ist 15 Minuten gültig und erlaubt 3 Versuche; danach startest du den Wizard einfach neu. Der Bot liest deine öffentliche Profilseite — das Profil muss also gespeichert sein, bevor du auf Verify klickst. Nach erfolgreicher Prüfung darfst du den Code wieder aus dem Profil entfernen.
Kann ich mehrere Ingame-Accounts verknüpfen (Dual, Sitter)?
Ja. Pro Server und Welt kannst du beliebig viele Accounts verknüpfen — alle Melde-Dialoge zeigen dir dann ein Auswahlmenü, für welchen Account du meldest. Umgekehrt dürfen auch mehrere Discord-Nutzer an demselben Ingame-Account hängen.
Was passiert mit meinen Daten, wenn ich den Discord-Server verlasse?
Gelöscht wird alles Persönliche: deine Account-Verknüpfungen, deine tw-utils-Rollen, offene Verifizierungen, die Benachrichtigungs-Einstellungen für diesen Server und der API-Key dieses Servers.
Erhalten bleibt, was dem Stamm gehört: AG-Meldungen, Abschickzeiten, Off-Ausschlüsse, Bunker-Berichte und Truppenzahlen. Dort verschwindet lediglich die Zuordnung zu deinem Discord-Konto — die Daten selbst bleiben für die Planung nutzbar.
Welt, Zeiten & Datenaktualität¶
Warum zeigt tw-utils andere Uhrzeiten an als meine Systemuhr?
Alle Zeiten laufen grundsätzlich in der Zeitzone der gewählten Spielwelt, nie in deiner Browser- oder Systemzeit. Die Welt bestimmt über ihren Markt (de/ch/en) die Zeitzone; wechselst du oben die Welt, stellen sich alle Anzeigen sofort um. Das gilt auch für alles, was du eingibst — Abschick- und Ankunftszeiten sind immer Serverzeit.
Wie aktuell sind die Dorf- und Spielerdaten?
Die Weltdaten sind ein stündlich aktualisierter Datenstand. Frisch gegründete oder eroberte Dörfer, Umbenennungen und Stammeswechsel können deshalb bis zu einer Stunde fehlen — das ist auch der häufigste Grund, warum eine Verifizierung „Account nicht gefunden" meldet. Spieler- und Stammesnamen in bereits gespeicherten Plänen werden beim nächsten Datenlauf automatisch nachgezogen.
Wir stellen im Bot die Welt um — was passiert dann?
Ein Weltwechsel ist ein vollständiger Reset des Servers, kein einfacher Umschalter. Der Bot löscht zuerst die Kanäle und Kategorien aller installierten Module und leert danach sämtliche Serverdaten: Container und Pläne, Truppen, laufende Befehle, alle Account-Verknüpfungen, alle vergebenen tw-utils-Rollen, Umfragen, die Konfigurationen von Bunker-, Sitting- und Such-System sowie alle API-Keys.
Danach müssen sich alle Mitglieder neu verifizieren, die Rollen neu vergeben und die Module neu installiert werden. Dasselbe passiert, wenn der Bot vom Server entfernt wird.
Meine Welt fehlt in der Auswahl — oder der Bot kennt sie nicht.
Wählbar sind nur Welten, die tw-utils bereits in seinen Weltdaten führt. Eine brandneue Welt erscheint deshalb erst nach dem nächsten Datenlauf. Geschlossene Welten verschwinden umgekehrt aus dem Dropdown — die dort gespeicherten Pläne bleiben aber erhalten und gehen nicht verloren.
Rollen & Berechtigungen¶
Wie erhalte ich als Stammesführung Zugriff auf den Leader-View?
In zwei Schritten: (1) Verknüpfe deinen Tribalwars-Account im #⚫-bot-config-Kanal über Account-Verification. (2) Du brauchst eine tw-utils-Rolle. Gibt es auf dem Server schon einen TWU-Leader, vergibt der sie dir direkt im Leader-View unter Mitglieder → Verwalten. Ist noch niemand Leader, ernennt ein Discord-Admin den ersten über Manage Access to Leader-View → Grant Access.
Reichen meine Discord-Administrator-Rechte, um tw-utils zu benutzen?
Im Discordbot ja: Wer die Discord-Berechtigung Administrator hat, kommt dauerhaft an alle Verwaltungs-Buttons heran. Auf der Website nicht — den Leader-View öffnet nur, wer eine tw-utils-Rolle besitzt: TWU-Leader für Bot-Konfiguration und Module, TWU-Bunker für Bunker-Anträge, TWU-Troops für Truppendaten, TWU-Planner für die Planung. Vergeben werden sie im Leader-View unter Mitglieder → Verwalten; den ersten TWU-Leader ernennt ein Discord-Admin über Manage Access to Leader-View → Grant Access. Die frühere Discord-Rolle TWU-Mod gibt es nicht mehr.
Ich habe keine tw-utils-Rolle — was darf ich trotzdem?
Jedes verifizierte Mitglied darf auch ganz ohne Rolle: die eigenen geplanten Befehle einsehen, die eigenen laufenden Befehle hochladen und einsehen sowie die eigenen Truppen einsehen. „Gar kein Zugriff" gibt es also nicht — Rollen erweitern den Blick auf die Daten der anderen.
Welche Rolle brauche ich wofür?
Die Rollen bauen aufeinander auf:
- TWU-Troops — Truppendaten des Stammes
- TWU-Bunker — Truppendaten plus Bunker-Information-System
- TWU-Planner — Truppendaten plus Planung und alle Lesezugriffe
- TWU-Leader — alles davon, dazu Rollenvergabe, Mitgliederverwaltung, Bot-Konfiguration und Module
Warum kann ich mir die Leader-Rolle nicht selbst entziehen?
Zwei Schutzregeln verhindern, dass sich ein Server versehentlich aussperrt: Niemand kann sich selbst die Leader-Rolle nehmen, und der letzte verbliebene Leader kann nicht entfernt werden. Es muss also immer ein anderer Leader die Änderung vornehmen. Verlässt jemand den Discord-Server, greifen die Regeln bewusst nicht.
Warum reagiert der Bot in meinem Kanal nicht — und warum verschwinden meine Nachrichten?
Jede Bot-Funktion ist an ihren eingerichteten Kanal gebunden; schreibst du woanders, verweist der Bot auf den richtigen Kanal. In den Modul-Kanälen selbst wird zusätzlich jede getippte Nachricht sofort wieder gelöscht — dort gibt es einen kurzen Hinweis, dass die Buttons zu benutzen sind. Diese Kanäle sind reine Button-Oberflächen und keine Chats.
Discordbot: Meldungen & Bunker¶
Wie melde ich Adelsgeschlechter, Abschickzeiten und wie plane ich Offs aus?
Über den tw-utils Discordbot im Kanal #⚫-queries deines Stammes-Discords. Dort gibt es drei Buttons:
Snob Report— Adelsgeschlechter meldenLaunch Times— eigene Abschickzeitfenster eintragenOff-Exclusion— Herkunftsdörfer ausschließen, die der Off-Planer nicht nutzen soll
Jeder Button hat ein Sub-Menü mit Add / Show / Delete.
Voraussetzung ist eine laufende Stammes-Umfrage: Gibt es keine, lehnt der Bot die Meldung ab. Laufen mehrere, fragt er zuerst, für welche du melden möchtest.
Wie beantrage ich einen Bunker?
Wechsle in den Kanal #⚫-request-bunker und klicke auf den Button Request Bunker. Trage Koordinate(n), gewünschte Dual-Stärke und eine Begründung ein. Der Bot legt pro Koordinate einen Anfrage-Kanal an, in dem ein TWU-Bunker genehmigt oder ablehnt.
Wie beantrage ich eine Aufstockung für einen Bunker?
Im selben Kanal #⚫-request-bunker gibt es einen separaten Button Request Top-Up. Trage die Koordinate(n) des bereits bestehenden Bunkers und die zusätzliche Dual-Stärke ein. Der Bot erstellt einen Top-Up-Anfrage-Kanal pro Koordinate, in dem ein TWU-Bunker die Aufstockung freigibt.
„Es läuft gerade keine Umfrage" — was bedeutet das?
Meldungen hängen immer an einer laufenden Stammes-Umfrage. Eine Umfrage endet automatisch, sobald ihre Frist verstrichen ist — sie kann in der Übersicht noch als aktiv erscheinen, nimmt aber nichts mehr entgegen. In dem Fall muss die Stammesführung eine neue Umfrage starten.
Warum finde ich meine alte Meldung nicht mehr — und warum kann ich fremde nicht löschen?
Jede Meldung gehört zu einer bestimmten Umfrage. Show und Delete zeigen deshalb immer nur die Einträge der gerade gewählten Umfrage — dieselbe Koordinate kann in mehreren Umfragen liegen. Löschen darf außerdem nur, wem der gemeldete Account gehört; bei Abschickzeiten kommt zusätzlich die Planungsleitung an fremde Einträge heran.
Truppen & Uploads¶
Welches Format muss die hochgeladene Truppendatei haben?
Eine .txt-Datei mit kommagetrennten Werten. Sie wird am einfachsten über das Ingame-Schnellleisten-Skript „Download Tribe Info" erzeugt. Erwartet wird eine Header-Zeile (Coords,Player,spear,sword,axe,…,snob), gefolgt von einer Zeile pro Dorf mit Koordinaten und Truppenanzahlen.
Der Inhalt ist zwar CSV, die Dateiendung muss aber .txt sein — eine Datei namens truppen.csv wird abgelehnt und muss vorher umbenannt werden.
Wie lange bleiben hochgeladene Truppendaten gespeichert?
5 Tage. Ein täglicher Aufräumlauf entfernt ältere Uploads — getrennt je Stamm und je Erfassungsart. Für eine belastbare Planung solltest du die Truppen also regelmäßig neu hochladen.
Warum überschreibt mein neuer Upload die alten Truppen nicht?
„Truppen insgesamt" und „Truppen im Dorf" sind zwei getrennte Datensätze. Ein Upload ersetzt immer nur die Daten derselben Erfassungsart desselben Stammes — lädst du versehentlich in die andere Sicht hoch, steht der alte Datensatz unverändert daneben. Auch beim Löschen musst du die Erfassungsart angeben.
Planung, Berechnung & Pläne¶
Warum bricht meine Berechnung nach etwa 14 Minuten ab?
Es gibt ein hartes Zeitlimit von 14 Minuten pro Berechnung. Bei sehr großen Planungen hilft es, die Zahl der Ziele oder der Herkunftsdörfer zu verringern und in mehreren Läufen zu planen.
Ich habe den Tab geschlossen — bekomme ich das Ergebnis zurück?
Nein. Beim Verlassen der Seite wird eine laufende Berechnung abgebrochen, und fertige Ergebnisse verfallen ohnehin nach 24 Stunden. Ein Ergebnis, das du behalten willst, musst du als Plan speichern — gespeicherte Pläne bleiben dauerhaft erhalten.
Meine Mitspieler sehen den veröffentlichten Plan nicht.
Ausgeliefert werden nur aktive Container — sie steuern zugleich, ob Erinnerungen verschickt werden. Ist der Container inaktiv, sieht ihn niemand außer der Stammesführung. Den Schalter findest du in der Container-Übersicht.
Was ist der „Gesamtplan"?
Neben den Plänen der einzelnen Spieler legt tw-utils bei jeder Veröffentlichung zusätzlich einen Sammelplan mit allen Befehlen an. Er heißt immer Gesamtplan, steht in jeder Liste an erster Stelle und ist als Gesamtüberblick für die Stammesführung gedacht.
Was passiert mit den DS-Ultimate-Plänen, wenn ich einen Container lösche?
Die Pläne selbst bleiben bei DS-Ultimate bestehen — ein einmal angelegter DSU-Plan lässt sich über die Schnittstelle nicht mehr löschen. tw-utils leert ihn beim Löschen des Containers nur: alle Befehle werden aus den zugehörigen DSU-Plänen entfernt.
Bereits verteilte Links funktionieren also weiter, zeigen danach aber einen leeren Plan. Wer den Plan endgültig loswerden will, muss ihn direkt bei DS-Ultimate löschen.
Benachrichtigungen¶
Ich habe Erinnerungen aktiviert, bekomme aber keine DM.
Drei Dinge müssen zusammenpassen — der Reihe nach prüfen:
- In den Discord-Datenschutzeinstellungen dieses Servers müssen Direktnachrichten erlaubt sein. Sind sie blockiert, gibt es keinen Ersatzweg — der Bot kann dich dann gar nicht erreichen.
- Der Schalter für die jeweilige Benachrichtigungsart muss an sein.
- Zusätzlich muss der Schalter für diesen Server an sein.
Warum kam nur eine DM für mehrere Befehle — und wie stelle ich die Vorlaufzeit ein?
Alle fälligen Befehle einer Welt kommen gesammelt in einer Nachricht; danach greift eine Sperrfrist, damit dich der Bot nicht im Minutentakt anschreibt. Einstellbar sind eine Vorlaufzeit von 1 bis 15 Minuten (Standard 5) und eine Sperrfrist von 1 bis 60 Minuten (Standard 15). Änderst du Account-Verknüpfungen, wirkt sich das auf die Erinnerungen erst innerhalb der nächsten Stunde aus.
Warum sind die Nachrichten des Bots immer auf Englisch?
Das ist bewusst so: Der Discordbot antwortet durchgängig auf Englisch, unabhängig von der Welt und von der Sprache, die du auf der Website eingestellt hast. Die Website selbst gibt es auf Deutsch und Englisch.
Meine Befehle, Share-Links & API¶
Ich habe einen Befehl geändert — warum steht im geteilten Link noch der alte Stand?
Ein Share-Link ist eine eingefrorene Momentaufnahme des Zeitpunkts, an dem du ihn erzeugt hast. Spätere Änderungen sowie neue oder gelöschte Befehle erscheinen darin nicht — für einen aktuellen Stand erzeugst du einfach einen neuen Link. Links gelten höchstens 7 Tage; danach meldet die Seite, dass der Link abgelaufen ist.
Wie bekomme ich einen API-Key — und warum sehe ich das Feld nicht?
Den Key erzeugst du unter „Meine Accounts" auf der Karte des jeweiligen Servers. Zwei Voraussetzungen: Du musst auf diesem Server verifiziert sein, und die Karte muss zur aktuell eingestellten Welt des Servers gehören. Es gibt genau einen Key pro Nutzer und Server.
Ich habe meinen API-Key verloren — wo kann ich ihn nachsehen?
Gar nicht. Der Key wird nur ein einziges Mal im Klartext angezeigt, direkt nach dem Erzeugen — gespeichert wird nur eine Prüfsumme. Über „Neu generieren" bekommst du jederzeit einen Ersatz; der alte Key wird damit aber sofort ungültig und muss in allen Skripten ausgetauscht werden.
Mein Skript bekommt „429 / zu viele Anfragen" — hilft ein neuer Key?
Nein. Die Grenzen hängen an dir und dem Server, nicht am Key — ein neu generierter Key setzt sie nicht zurück. Es gilt: Truppen-Upload einmal alle 5 Minuten je Stamm und Erfassungsart, laufende Befehle einmal pro Minute je Spieler, Abfragen eine pro Sekunde. Ein wegen Formatfehlern abgelehnter Upload verbraucht das Kontingent nicht.