Friendly-Helper brings World of Warships straight into Discord and connects chat with the detailed analyses on our website.

The bot can:

• display ship data directly in chat
• retrieve player profiles, statistics, Ranked progress and expert badges
• compare players, ships and clans
• display clan leaderboards, records and individual clan rankings
• display maps, commanders and achievements
• link directly from Discord to the relevant web analyses
• maintain server and clan statistics as locked display channels
• greet new members with configurable welcome messages
• send enabled notifications automatically to the selected channels
• regularly showcase selected bot features in a channel through demo mode
• manage settings through Discord admin centers and the web control panel
• refresh data regularly and run reliably around the clock

The Quiz Center adds general knowledge and clan quizzes with test rounds, free quizzes and scheduled Ranked rounds. The dedicated WoWS quiz module is not yet enabled.

The bot runs on Python 3.13 and uses, among other things:

• discord.py for Discord integration, slash commands and interactive admin centers
• aiohttp for asynchronous API requests
• prepared ship data and local JSON files for maps, commanders and achievements
• PostgreSQL 16 as the central database for players, clans, rankings and bot settings
• FastAPI for the website and the separate web control panel
• shared settings for Discord commands, admin centers and the control panel
• builder scripts for the supplementary JSON data
• systemd and a watchdog for continuous operation
• nginx, separate logs and regular health checks
• autocomplete and typo-tolerant search for supported commands

Since September 2026, Friendly-Helpers has been running on a netcup RS 2000 G12 with Debian 13, eight available processor cores and around 16 GB of RAM. The bot, website, control panel, database and background jobs run there as separate services and tasks.

Concise Discord output links to the full analysis on the website. The bot and control panel use the same stored settings.

Ship data is readily available for bot commands and ship pages.

Depending on the area, player, clan and season data is read from the Wargaming API, our PostgreSQL database or a temporary cache. This keeps responses fast and consolidates repeated requests.

Our ship data includes:

• Name, nation, class and tier
• Hit points, speed, turning circle and rudder shift time
• Main battery, reload time, range, dispersion and sigma
• Torpedoes, secondary armament and anti-aircraft defence
• Detectability, consumables and upgrades
• Aircraft, tactical squadrons and airstrikes
• Premium and special status, modules, images and icons

These values are available in commands such as /info and /vergleich, as well as on the detailed ship pages.

achievements.json
Contains achievements with names, descriptions, types, images and requirements.

Commanders, skills and ranks
The commander pages use the new prepared dataset with portraits, talents, enhanced skills and rank information. The bot adds concise information and a link to the relevant detail page.

maps.json
Contains map information for the map commands.

PostgreSQL also stores player and clan profiles, per-player ship statistics, rankings, Clan Wars data, snapshots and update timestamps. Server settings, notifications, welcome messages, demo mode and quiz state are also held centrally there.

Supplementary data is processed by dedicated builders for each area and made available as validated datasets.

Commander data preparation
The new builder supplies commanders, skills, ranks and associated images for the commander pages. Talents and enhanced skills are shown there with their conditions and effects.

build_maps_from_api.py
Creates the local map database for /karte and /karten.

build_achievements_from_api.py
Retrieves the available achievements from the Wargaming API and prepares achievements.json for Discord output.

The watchdog checks the local bot JSON files for maps, achievements and the existing commander output for missing or outdated content. Their weekly refresh begins on Thursdays from 10:00. The new commander dataset for the website is released independently.

The crawler continuously maintains player and clan data in PostgreSQL. Rankings, ship meta and snapshots are refreshed by dedicated scheduled jobs. This keeps quick bot responses and heavier background analyses separate.

systemd keeps the services running on the root server. An external watchdog also starts and monitors the bot.

The watchdog checks every five minutes.

• whether the bot process is running and an internet connection is available
• whether JSON files for maps, commanders and achievements are missing or outdated
• whether the corresponding builders need to run again
• whether the available ship data is valid and readable
• whether a data build or process failure requires a bot restart

Missing or outdated JSON content is refreshed by the corresponding builders. After relevant rebuilds, the watchdog restarts the bot so it loads the updated content.

On the new root server, the bot, website, control panel, crawler and monitoring run alongside one another in a controlled way. Staggered background jobs and dedicated resource limits help distribute the load.

The daily health check and additional regular checks monitor services, availability, data freshness and database growth. Separate logs make command errors, automated notifications and restarts traceable.

Many commands use autocomplete, allowing users to select ships, players, clans, nations or classes with ease.

There are also typo-tolerant suggestions: /info helps when ship names are not entered exactly; /spielerduell and /clanrang can suggest matching player names from the Wargaming search results.

Many slash commands include a direct link to the relevant Friendly-Helpers page. This keeps embeds compact, while player and clan profiles, ship details, comparisons and duels provide more depth.

For admins, /welcome einrichten, /notifications einrichten, /serverstats einrichten, /clanserverstats einrichten and /demomodus einrichten open the respective interactive Discord centers. The same five areas can also be managed in the protected Control Panel (German).

Selection menus, buttons and input dialogs make setup and changes easier. Simply opening a center does not activate any feature; changes require the appropriate server permissions.