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.

Bot Labor
Unser Discord-Bot liefert umfassende Daten.
- Schiffsdaten & Vergleiche
- 24/7 stabil
- für jede Community

[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.
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.pyfür Discord-Integration und Slash-Commands aiohttpfü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.
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?
- Entspannte Atmosphäre ohne Pflichtstress
- Erfahrene Spieler helfen gerne weiter
- Tolle Community & aktive Crew
- Co-op, Unternehmen & Events
- Entwicklergeist im Bot-Labor
