Friendly-Helpers

WIR SIND MEHR ALS EIN CLAN
WIR SIND EINE CREW.

Friendly Helpers Logo

Clan

Wir sind ein entspannter WoWS-Clan ohne Pflichten. Real-Life schlägt immer Pixel. Täglich findet sich eine Crew für Co-op-Runs oder Unternehmen.

Discord

Unser Discord ist das Steuerrad für Absprachen.

zum Discord

Bot Labor

Unser Discord-Bot liefert umfassende Daten.

[FYHS] Friendly-Helpers

Friendly-Helpers entstand ursprünglich schon vor vielen Jahren als Gilde im Spiel Order & Chaos das ich damals über lange Zeit auf dem iPad gespielt habe.

Friendly Helpers

Dort habe ich einige wirklich gute Leute kennengelernt und viele schöne Erinnerungen gesammelt. Genau deshalb wollte ich den Namen nie einfach verschwinden lassen. Friendly-Helpers weiterzuführen war für mich auch eine Art Erinnerung an Leute wie Steffi, Tilda und die anderen aus dieser Zeit.

Später kam dann World of Warships dazu. Anfangs war ich als „FeuchterHase“ meistens alleine unterwegs, bis irgendwann auch mein Sohn „TrockenesKarnickel“ angefangen hat mitzuspielen. Seitdem er alt genug ist, das Spiel wirklich zu verstehen und einordnen zu können, fahren wir regelmäßig gemeinsam Gefechte.

Durch verschiedene Streamer und Communitys rund um World of Warships, unter anderem TeamKrado, Trenlass, OhMyDoge, komusu und Seakrauts, kam dann irgendwann die Idee auf, wieder etwas Eigenes aufzubauen. Daraus wurden nach und nach unser Discord, der Clan und später auch die Entwicklung des eigenen Bots.

Friendly-Helpers ist bewusst klein und entspannt gehalten. Kein Zwang, kein künstliches Hardcore-Image und kein Drama. Einfach gemeinsam spielen, Spaß haben und nebenbei ein technisches Projekt weiterentwickeln, das über die Zeit immer größer geworden ist.

Mein persönliches Ziel ist es, den Friendly-Helpers Bot in den kommenden Jahren weiter auszubauen und vielleicht irgendwann auf vielen großen World-of-Warships-Discords zu sehen. Nicht wegen Reichweite oder „groß werden“, sondern weil Leute Spaß daran haben und die Arbeit hinter dem Projekt erkennen.

Bot-Labor

Unser Friendly-Helper Discord-Bot bringt World-of-Warships-Daten direkt in den Discord. Schiffsdaten, Spielerstatistiken, Clan-Rankings, Karten, Kommandanten, Errungenschaften und Vergleichswerte können direkt per Slash-Command abgerufen werden. Das Ziel ist klar: weniger Browserwechsel, weniger Copy-Paste, mehr Infos genau da, wo die Community gerade redet. Der Bot verbindet die Wargaming-API, lokal vorbereitete JSON-Daten und eigene Auswertungslogik zu einem Discord-Werkzeug für Clans, Spieler und Community-Server.

Viele World-of-Warships-Daten gibt es bereits im Web, zum Beispiel im Wiki oder auf Statistikseiten.

Der Unterschied ist:
Dort muss man den Browser öffnen, suchen, kopieren, zurück in Discord wechseln und Werte erklären.

Friendly-Helper bringt diese Informationen direkt in den Discord-Chat.

Das bedeutet:
keine extra Browser-Tabs, kein Copy-Paste, keine langen Suchwege, direkte Diskussion im Channel, schnelle Vergleiche, sofort sichtbare Clan- und Spielerwerte

Gerade für Clan-Server, Streamer-Communitys und aktive WoWS-Gruppen ist das ein klarer Vorteil.

Projektziel

Entwicklung eines Discord-Bots für World of Warships mit direkter Discord-Ausgabe.

Der Bot soll:

  • Schiffsdaten direkt im Chat anzeigen
  • Spielerstatistiken abrufen und verständlich ausgeben
  • Spieler, Schiffe und Clans vergleichen
  • Clan-Leaderboards und persönliche Clanränge erzeugen
  • Karten, Kommandanten und Errungenschaften anzeigen
  • Daten automatisch aktuell halten
  • stabil im Dauerbetrieb laufen
  • für größere Community-Server nutzbar bleiben

Im Prinzip kombiniert der Bot wichtige Funktionen aus WoWS-Wiki, Wargaming-API und Statistikseiten wie WoWS-Numbers, aber direkt im Discord.

Technische Basis

Der Bot ist in Python geschrieben und nutzt unter anderem:

  • discord.py für Discord-Integration und Slash-Commands
  • aiohttp für asynchrone API-Abfragen
  • lokale JSON-Dateien als schnelle Datenbasis
  • eigene Builder-Skripte für automatische Datenerstellung
  • Watchdog-Überwachung für Dauerbetrieb und Neustarts
  • Autocomplete für Schiffe, Spieler, Clans, Nationen und Klassen
  • Fuzzy Search für Tippfehler bei Schiffsnamen und Spielernamen

Im Prinzip kombiniert der Bot wichtige Funktionen aus WoWS-Wiki, Wargaming-API und Statistikseiten wie WoWS-Numbers, aber direkt im Discord.

Datenbasis

Der Bot arbeitet mit einer Mischung aus lokal vorbereiteten Daten und Live-Abfragen.

ships.json
Enthält Schiffsdaten aus der Wargaming-Enzyklopädie, darunter:

  • Name
  • Nation
  • Klasse
  • Tier
  • Trefferpunkte
  • Geschwindigkeit
  • Wendekreis
  • Ruderstellzeit
  • Hauptgeschütze, Nachladezeit, Reichweite, Streuung
  • Torpedowerte
  • Sekundärbewaffnung
  • Sichtbarkeit
  • Premium- und Spezialstatus
  • Preise
  • Module, Bilder und Icons

achievements.json
Enthält Errungenschaften aus World of Warships mit:

  • Name
  • Beschreibung
  • Typ
  • Untertyp
  • Bild
  • ID
  • Sichtbarkeit
  • Anforderungen

crews.json
Enthält Kommandanten-Daten:

  • Namen
  • Nation
  • Trainingskosten
  • Umschulungskosten
  • Icon
  • weitere API-Werte

maps.json
Enthält Karteninformationen für die Map-Befehle.

Automatischer JSON-Bau

Die Daten werden nicht manuell gepflegt, sondern über eigene Builder-Skripte erzeugt.

build_ships_from_api.py
Ruft alle Schiffe aus der Wargaming-API ab, lädt zusätzlich die globalen Module und baut daraus eine lokale ships.json

build_crews_from_api.py
Ruft Kommandanteninformationen aus der Wargaming-API ab. Zusätzliche Overrides ermöglichen eigene Texte, Korrekturen und individuelle Ergänzungen. Anschließend werden beide Datenquellen zusammengeführt und zur fertigen crews.json verarbeitet.

build_maps_from_api.py
Erzeugt die lokale Kartendatenbank für /karte und /karten.

build_achievements.py
Erstellt die lokale achievements.json direkt aus der Wargaming-API. Dabei werden alle verfügbaren Errungenschaften automatisch geladen, strukturiert gespeichert und für die Discord-Ausgabe im Bot vorbereitet.

Dadurch bleibt der Bot schnell, weil Stammdaten lokal gelesen werden, während Spieler-, Clan- und Statistikwerte live über die API kommen.

Watchdog und Dauerbetrieb

Der Bot wird durch einen externen Watchdog überwacht, der Watchdog prüft regelmäßig:

  • ob der Bot-Prozess noch läuft, ob Internetverbindung besteht
  • ob wichtige JSON-Dateien fehlen, ob JSON-Dateien veraltet sind
  • ob Builder-Skripte erneut ausgeführt werden müssen, ob Remote-Dateien aktualisiert wurden
  • ob ein Neustart notwendig ist

Wenn eine Datei fehlt oder veraltet ist, wird sie automatisch neu gebaut. Wenn der Bot abstürzt, startet der Watchdog ihn neu. Wenn Daten aktualisiert wurden, wird der Bot ebenfalls neu gestartet, damit die neuen Informationen aktiv sind.

Zusätzlich führt der Watchdog unabhängig von den regulären Checks alle 7 Tage einen automatisierten Full-Build aller build.py-Skripte aus, um sämtliche Datensätze auch ohne manuellen Admin-Eingriff konsistent und aktuell zu halten.

Autocomplete & Fuzzy Search

Viele Befehle nutzen Autocomplete, damit User Schiffe, Spieler, Clans, Nationen oder Klassen bequem auswählen können.

Zusätzlich wurde Fuzzy Search eingebaut. Wenn ein User ein Schiff oder einen Spieler nicht exakt schreibt, schlägt der Bot einen passenden Treffer vor, statt einfach nur „nicht gefunden“ zu sagen.

Das macht die Nutzung deutlich freundlicher, gerade auf mobilen Geräten oder bei komplizierten WoWS-Namen.:

Friendly-Helper ist ein Discord-Bot für World of Warships, der Schiffsdaten, Spielerstatistiken, Clan-Auswertungen, Karten, Kommandanten und Errungenschaften direkt im Chat verfügbar macht. Gebaut mit Python, Wargaming-API, lokal erzeugten JSON-Daten, Slash-Commands, Autocomplete, Fuzzy Search und Watchdog-Dauerbetrieb. Ein Bot für Spieler, Clans und Communitys, die ihre WoWS-Daten direkt dort haben wollen, wo gerade gesprochen wird: im Discord.

Bot-Befehlskatalog

Der Friendly-Helper Bot bringt inzwischen ein komplettes WoWS-Werkzeugset direkt in den Discord.

6 Schiffe & Technik
5 Spielerstatistiken
3 Clan & Community
5 Karten, Crew, Sammlungen
2 Bot & Hilfe
/info <Schiff> Zeigt technische Schiffsdaten, Module, Bild aus der JSON.
/liste [Nation] [Klasse] Listet Schiffe auf, optional gefiltert nach Nation und Klasse. Wenn du wissen willst, was es alles gibt, ohne lange zu suchen.
/vergleich <Schiff1> <Schiff2> Vergleicht zwei Schiffe anhand ihrer technischen Werte. Zwei Schiffe, ein direkter Faktencheck.
/zufallsschiff Wählt ein zufälliges Schiff aus und zeigt die Infos dazu. Für alle, die nicht wissen, was sie als Nächstes fahren sollen.
/schiffstats <Spieler> <Schiff> Zeigt die Statistik eines Spielers auf genau einem Schiff. Deine Yamato, deine Zahlen, keine Ausreden.
/schiffduell <Spieler1> <Spieler2> <Schiff> Vergleicht dasselbe Schiff zwischen zwei Spielern. Wer fährt die Tirpitz wirklich besser?
/mystats <Spieler> <Modus> Zeigt Spielerstatistiken für PvP, PvE, Solo und Divisionen. Deine WoWS-Zahlen, sauber sortiert statt irgendwo im Browser versteckt.
/spielerduell <Spieler1> <Spieler2> <Modus> Vergleicht zwei Spieler in einem gewählten Statistikmodus. Direkter Spielercheck, ohne Tab-Wechsel und Copy-Paste.
/top_schaden <Spieler> Zeigt die Top 10 Schiffe eines Spielers nach höchstem Einzelschaden. Für die großen Zahlen, auf die man heimlich doch stolz ist.
/hits <Spieler> [Nation] [Klasse] Zeigt Trefferquoten und erweiterte Schiffswerte eines Spielers. Wenn du wissen willst, ob du triffst oder nur Wasser umpflügst.
/meineschiffe <Spieler> [Nation] Zeigt gespielte Schiffe eines Spielers inklusive letztem Gefecht. Deine Flotte auf einen Blick, sortiert nach Aktivität.
/clanmitglieder <Clan> Zeigt Clanmitglieder mit Rolle und letztem Gefecht. Wer ist aktiv, wer führt, wer war zuletzt unterwegs?
/leaderboard <Clan> <Sortierung> [Min. Gefechte] Erstellt ein Top-10-Clanranking nach gewählter Sortierung. Siegrate, Schaden, Gefechte, EP oder Scout-Werte: Clanvergleich auf Knopfdruck.
/clanrang <Clan> <Spieler> [Min. Gefechte] Zeigt den persönlichen Rang eines Spielers innerhalb eines Clans. Ein Command und du weißt, wo du im Clan wirklich stehst.
/karte <Karte> Zeigt Details zu einer bestimmten Karte. Map-Infos direkt im Chat, ohne langes Nachschlagen.
/karten Listet vorhandene Karten aus der lokalen Datenbasis auf. Alle Maps im Überblick, schnell und sauber abrufbar.
/kommandant <Name> Zeigt Details zu einem bestimmten Kommandanten. Der passende Kapitän, ohne in Menüs zu versinken.
/kommandanten <Nation> Listet Kommandanten einer ausgewählten Nation. Alle verfügbaren Kommandanten nach Nation sortiert.
/errungenschaften [Typ] Zeigt WoWS-Errungenschaften nach Typ inklusive Beschreibung und Bild. Erfolge, Medaillen und Sammlerkram direkt aus der JSON-Datenbank.
/help Zeigt alle wichtigen Befehle und Beispiele. Der Einstiegspunkt, wenn du wissen willst, was der Bot kann.
/aboutme Zeigt eine kurze Übersicht zum Friendly-Helper Bot. Was der Bot macht, woher die Daten kommen und warum er praktisch ist.

Changelog

Neuer Slash-Command: /clanrang
Ein neuer persönlicher Clanranking-Befehl wurde gebaut.

Funktion: /clanrang <clan> <Spieler> [min_gefechte]

Der Command zeigt, wo ein Spieler innerhalb eines Clans steht.

    Ausgewertete Kategorien:
  • Siegrate
  • ØSchaden
  • Gefechte
  • Ø EP
  • Kills/Gefecht
  • Überlebensrate
  • Ø Aufklärungsschade
  • Ø Potenzieller Schaden
    Neue Features:
  • Clan per ID, Tag oder Name möglich
  • Spieler-Autocomplete eingebaut
  • Spieler-Fuzzy-Suche ergänzt Prüfung, ob der Spieler wirklich Mitglied des gewählten Clans ist
  • Mindestgefechte werden berücksichtigt
  • Ausgabe als kompaktes Embed

Watchdog erkennt nun das Reboot-Flag und startet den Bot automatisch neu.

Watchdog erkennt nun das Reboot-Flag und startet den Bot automatisch neu.

Watchdog erkennt nun das Reboot-Flag und startet den Bot automatisch neu.

Watchdog erkennt nun das Reboot-Flag und startet den Bot automatisch neu.

Kommandanten-Befehle wurden erweitert und das Logging-System wurde überarbeitet.

  • Nation-Übersetzung auf Deutsch – Einführung einer NATION_MAP, die alle WoWS-Nationen von Englisch auf Deutsch abbildet (z. B. germany → Deutschland, pan_asia → Pan-Asien).
  • Module und Schiffsbilder einbinden – Module und Schiffe ziehen ihre Thumbnail-URLs direkt aus der JSON und zeigen sie per Embed.set_thumbnail. Später ergänzt um die Anzeige des großen Schiffsbildes oben im Embed via Embed.set_image(url=…).
  • Sichtweiten korrekt auslesen – Aus default_profile.concealment die Werte für Wasser-, Luft- und U-Boot-Erkennung gezogen und als „m“ ausgegeben.

Kommandanten-Befehle wurden erweitert und das Logging-System wurde überarbeitet.

  • Nation-Übersetzung auf Deutsch – Einführung einer NATION_MAP, die alle WoWS-Nationen von Englisch auf Deutsch abbildet (z. B. germany → Deutschland, pan_asia → Pan-Asien).
  • Module und Schiffsbilder einbinden – Module und Schiffe ziehen ihre Thumbnail-URLs direkt aus der JSON und zeigen sie per Embed.set_thumbnail. Später ergänzt um die Anzeige des großen Schiffsbildes oben im Embed via Embed.set_image(url=…).
  • Sichtweiten korrekt auslesen – Aus default_profile.concealment die Werte für Wasser-, Luft- und U-Boot-Erkennung gezogen und als „m“ ausgegeben.

Warum Friendly-Helpers?