Tournament bot for the IVN clan

Task

The IVN clan in Brawl Stars, a community of players in Telegram, runs tournaments all the time. A player needs to sign up, pay and see who they play and when, all within a minute. The organiser needs to run everything from a phone: dozens of participants, brackets, disputes, money, reminders. Players speak three languages. Entry fees are other people’s money, so payments must work without double charges, with refunds and a log, and no change may break what already works.

Solution

A tournament platform inside Telegram: a bot and an app that opens right in the chat. All data lives in the project’s own database on its own server.

• Tournaments of any format. 1v1 and 3v3 teams, single and double elimination, a “places” mode. A captain gathers a team by link and each member pays their share; if the team is not complete, the fee is refunded automatically.
• A bracket that runs itself. A place is held for 10 minutes, a match gets 3 hours, the result is marked with one button. If the opponent stays silent for an hour, the result is counted automatically and the dispute goes to the organiser. With a game key the result is checked against the battle log.
• Duels. Over 20 modes, ranked series to 3, 5 and 7 wins, referees, screenshot evidence, a refund after a day if no opponent is found.
• Money inside Telegram. Payment in Telegram’s built-in currency, refunds per payment, a log of every payment, protection against double charges and against a race for the last place. Every money action by an assistant is confirmed by the owner.
• Profile, rating, seasons. Elo rating, 19 achievements, a monthly season by points, a reliability rating for attendance, a winner card for stories, weekly results in the clan group.
• Nobody forgets a match. Attendance confirmation before the start, reminders 15 minutes before the deadline, a waiting list, a schedule.
• Management from a phone. Owner, assistant and referee roles with permissions by section, broadcasts, bans, export, system status and a backup at the press of a button.
• Three languages. Each player picks their own, and the bot and the app reply in it; translations are checked automatically before every release.

Result

The whole tournament lives in Telegram: sign-up, payment, bracket, results and awards, and the organiser runs it from a phone. A copy of the data is made every night and sent to the owner; restoring from it has been tested. Before launch the project passed two security audits: an automatic walk through every button, and a review of permissions, payments and the server; everything found was fixed.