WARERA.UNIKHORNE: Roles (Discord Bot functionality)
Deutsche Fassung weiter unten.
The suite, inside your Discord server. 55 commands in eight groups, free, no login, and most of them are set up once and then work while you sleep.
https://warera.unikhorne.dev/bot
ONE CLICK TO ADD IT
The invite asks for Manage Server, and for Manage Roles on top of it, which is there for exactly one feature: handing out government roles. Everything else runs without it.
If you do want the roles, one manual step remains and Discord insists on it: drag the bot's own role above the roles it should hand out, once, in Server Settings. A bot cannot grant a role that sits higher than itself, and no permission changes that.
EVERY COMMAND, BEFORE YOU INVITE ANYTHING
The page lists all 55 commands from the same source the bot itself uses, so you can read the whole surface from the outside and decide afterwards. /help prints that same list inside Discord. The two cannot drift apart, because there is only one list.
THE EIGHT GROUPS
Alerts for you, 13 commands. Your bars running low, a debuff landing, a battle turning, a new bounty, an auction you were watching. Direct messages, set up once.
Market and economy, 8. Prices, buy and sell signals with the reason behind each, a price alert that writes you the moment your line is crossed, and the daily report as a DM or in a channel.
Countries, units, influence, 3. Lookups on demand, answered in the chat.
Your own account, 4. Prove once that a WarEra account is yours, and the roles that follow it work on every server that runs this bot.
Daily reading, 7. The morning Digest in your channel or your inbox, the game results, and a translation for a post in a language you do not read.
Games, 2. The unikhorne games from inside Discord.
Roles and verification, 10. Offices, citizenship and units as Discord roles, kept current by the hour.
Server setup, 8. For admins: where the bot may post, which channel gets what, and who is allowed to change it.
THE GOVERNMENT ROLES
The one feature that needs the extra permission, and the one worth explaining before you switch it on.
Add the countries your server cares about, several if you host embassies, and the bot matches every Discord member against the WarEra players holding office there. Congress, ministers, the president: each gets the role of their office, and a role that does not exist yet is created.
Two decisions inside it are worth knowing.
The matching is strict. Discord names and WarEra accounts are nowhere verifiably linked, so the bot guesses, and a wrong guess would hand a stranger the president's role. It therefore matches only names that really correspond, and would rather hand out nothing than something wrong.
And it never strips a role because a reading failed. If a country's government cannot be read in a run, that country is left untouched instead of being treated as "nobody holds office there". A sync that empties your server because an API call timed out would be worse than no sync at all.
It re-runs every hour, so an election result reaches your roles by itself.
ONLY THE BOUNTIES THAT MATTER TO YOU
A bounty channel can be narrowed with /set-bounty-scope: every battle, only your country, your country and its allies, or the whole alliance with its allies. The bot reads alliances and allies from the game, so a new alliance changes the channel by itself. The idea comes from the Bounty Notify in PROST, a userscript by beertierchen.
SET UP ONCE
Nothing here has to be done twice. That is the whole design: you run a command once, and the bot keeps working without you being there.
All of it free, no login: https://warera.unikhorne.dev
DEUTSCH
Die Suite, mitten in deinem Discord-Server. 55 Befehle in acht Gruppen, kostenlos, ohne Login, und die meisten richtest du einmal ein. Danach arbeiten sie, während du schläfst.
https://warera.unikhorne.dev/bot
EIN KLICK ZUM HINZUFÜGEN
Die Einladung verlangt die Berechtigung Server verwalten und zusätzlich Rollen verwalten. Die zweite gibt es für genau eine Funktion: das Verteilen von Regierungsrollen. Alles andere läuft ohne sie.
Wenn du die Rollen willst, bleibt ein Handgriff, und auf dem besteht Discord: Zieh die eigene Rolle des Bots einmal in den Servereinstellungen über die Rollen, die er verteilen soll. Ein Bot kann keine Rolle vergeben, die höher steht als er selbst, und daran ändert keine Berechtigung etwas.
JEDER BEFEHL, BEVOR DU IRGENDETWAS EINLÄDST
Die Seite listet alle 55 Befehle aus derselben Quelle, die auch der Bot selbst nutzt. So kannst du von außen alles lesen, was er kann, und danach entscheiden. /help gibt dieselbe Liste in Discord aus. Die beiden können nicht auseinanderlaufen, weil es nur eine Liste gibt.
DIE ACHT GRUPPEN
Benachrichtigungen für dich, 13 Befehle. Deine Leisten werden knapp, ein Debuff trifft dich, ein Kampf kippt, eine neue Bounty, eine Auktion, die du beobachtet hast. Direktnachrichten, einmal eingerichtet.
Markt und Wirtschaft, 8. Preise, Kauf- und Verkaufssignale mit dem Grund zu jedem, ein Preisalarm, der dir schreibt, sobald deine Marke überschritten ist, und der Tagesbericht als DM oder in einem Kanal.
Länder, Einheiten, Einfluss, 3. Abfragen auf Zuruf, beantwortet im Chat.
Dein eigenes Konto, 4. Weise einmal nach, dass ein WarEra-Konto dir gehört, und die Rollen, die daraus folgen, gelten auf jedem Server, auf dem dieser Bot läuft.
Tägliche Lektüre, 7. Der morgendliche Digest in deinem Kanal oder Postfach, die Spielergebnisse und eine Übersetzung für einen Beitrag in einer Sprache, die du nicht liest.
Spiele, 2. Die unikhorne-Spiele direkt aus Discord.
Rollen und Verifizierung, 10. Ämter, Staatsbürgerschaft und Einheiten als Discord-Rollen, stündlich aktuell gehalten.
Servereinrichtung, 8. Für Admins: wo der Bot posten darf, welcher Kanal was bekommt und wer das ändern darf.
DIE REGIERUNGSROLLEN
Das ist die eine Funktion, die die zusätzliche Berechtigung braucht. Man sollte sie erklären, bevor man sie einschaltet.
Füge die Länder hinzu, um die sich dein Server kümmert, gern mehrere, wenn du Botschaften betreibst. Der Bot gleicht dann jedes Discord-Mitglied mit den WarEra-Spielern ab, die dort ein Amt haben. Kongress, Minister, Präsident: Jeder bekommt die Rolle seines Amtes, und eine Rolle, die es noch nicht gibt, wird angelegt.
Zwei Entscheidungen darin solltest du kennen.
Der Abgleich ist streng. Discord-Namen und WarEra-Konten sind nirgends nachprüfbar verknüpft, also rät der Bot, und ein falscher Treffer würde einem Fremden die Rolle des Präsidenten geben. Deshalb ordnet er nur Namen zu, die wirklich übereinstimmen, und verteilt lieber gar nichts als etwas Falsches.
Und er nimmt nie eine Rolle weg, weil ein Lesevorgang fehlgeschlagen ist. Lässt sich die Regierung eines Landes in einem Durchlauf nicht lesen, bleibt dieses Land unberührt. Der Bot behandelt es nicht so, als hätte dort niemand ein Amt. Ein Abgleich, der deinen Server leerräumt, weil ein API-Aufruf in einen Timeout lief, wäre schlimmer als gar kein Abgleich.
Er läuft jede Stunde neu, so erreicht ein Wahlergebnis deine Rollen von selbst.
NUR DIE BOUNTIES, DIE DICH BETREFFEN
Ein Bounty-Kanal lässt sich mit /set-bounty-scope eingrenzen: jeder Kampf, nur dein Land, dein Land und seine Verbündeten, oder die ganze Allianz mit ihren Verbündeten. Der Bot liest Allianzen und Verbündete aus dem Spiel, so ändert eine neue Allianz den Kanal von selbst. Die Idee stammt vom Bounty Notify in PROST, einem Userscript von beertierchen.
EINMAL EINRICHTEN
Nichts hier muss zweimal gemacht werden. Darauf ist alles ausgelegt: Du führst einen Befehl einmal aus, und der Bot arbeitet weiter, ohne dass du dabei sein musst.
Alles kostenlos, ohne Login: https://warera.unikhorne.dev
(Uni)Khorne