Gamification¶
Gamification encourages community activity without affecting moderation. At its core are coins 🪙: a separate in-game currency you earn through daily actions and spend on cosmetics, games, and unmuting yourself for coins.
Disabled by default
By default, gamification is disabled. Enable it in the bot's settings — the "Reputation" section (the "Gamification" toggle). The same section enables "Question of the day", "Weekly digest", and "Unmute for coins".
Coins ≠ reputation
Coins 🪙 are an in-game currency: earned through actions, spent on cosmetics/games. Reputation is a separate axis of trust: earned only through thanks (+rep / "thank you" in reply to a message) and cannot be bought. These are different systems: coins don't grant rank, and reputation can't be purchased with coins.
🔥 Earning coins¶
The main source is the daily check-in /checkin (once per day, Kyiv time):
- a base of 10 🪙 + 2 🪙 for each day of the streak (consecutive days), up to the 11th day;
- that is: day 1 — 10, day 2 — 12, day 3 — 14 … day 11 and onward — 30 🪙/day;
- missing a day resets the streak to 1;
- upon reaching milestones, the bot automatically awards achievements plus a one-time coin bonus (see below).
| Command | Action |
|---|---|
/checkin, /daily |
Daily check-in: streak 🔥 + coins 🪙 |
/balance |
Coin balance 🪙 and streak 🔥 (reply — about someone else) |
/badges |
Earned achievements 🏆 (reply — about someone else) |
🏅 Achievements and thresholds¶
Achievements are awarded automatically as soon as a member reaches the threshold (checked on /checkin and /badges). Each grants a one-time coin bonus. See your own achievements with /badges.
| Achievement | Condition | Bonus |
|---|---|---|
| 💬 | 100 messages | +50 🪙 |
| 🗯 | 1000 messages | +200 🪙 |
| 🔥 | 7-day streak | +70 🪙 |
| 🌋 | 30-day streak | +300 🪙 |
| 📅 | 50 /checkin check-ins |
+150 🪙 |
| ⭐ | 50 reputation | +100 🪙 |
| 🌟 | 100 reputation | +200 🪙 |
The ⭐/🌟 achievements only acknowledge earned reputation — they are not a way to buy it.
🛒 Shop and spending¶
Coins are a "stock" that gets spent somewhere so the economy doesn't inflate. You can spend them on cosmetic flairs (a badge next to your name), a gift to someone else, or unmuting yourself for coins.
| Command | Action |
|---|---|
/shop, /store |
Flair shop + your balance |
/buy <id> |
Buy a flair for coins |
/give <amount> (reply) |
Transfer coins to another member |
Flairs in the shop:
| ID | Flair | Price |
|---|---|---|
star |
🌠 | 120 🪙 |
rainbow |
🌈 | 150 🪙 |
rocket |
🚀 | 200 🪙 |
crown |
👑 | 300 🪙 |
diamond |
💎 | 500 🪙 |
The flair you bought is shown before your balance in /balance.
🎲 Mini-games¶
Bet coins against the bot. There's a 4-second cooldown between games; a small "house edge" keeps the economy balanced (you can win, but over the long run the "house" comes out ahead).
| Command | Game | Winnings |
|---|---|---|
/dice <bet> |
Dice against the bot: yours > the bot's — you win | +bet (double) |
/guess <bet> <1-6> |
Guess the dice value (1 in 6) | ×4 the bet |
On a loss, the bet is deducted.
🪙 Unmute for coins¶
If an admin enabled this option (the "Reputation" section → unmute price), a restricted user sees a "Remove restriction for N 🪙" button under the mute notice. Tapping it deducts coins and lifts the restriction.
The offer appears only when the user has enough coins — so drive-by spammers with a zero balance don't get a pointless button.
💬 Question of the day¶
To liven up the chat, the bot posts a short, friendly "question of the day" once a day. To enable it, use the "Question of the day" toggle in the settings (the "Reputation" section). /question posts one right now (admin only): the command deletes itself and the question is sent as a separate message.
⚙️ Question of the day mode¶
A separate switch, "Question of the day: mode", determines exactly how the bot posts:
| Mode | What it posts |
|---|---|
| Poll 📊 (default) | An AI question with several answer options. A single tap is enough — even lurkers get drawn in. If the AI didn't produce usable options, it falls back to plain text. |
| Message 💬 | A classic text question without options. |
| Language quiz 🎓 | A quiz from the lingua dictionary with a correct answer (native Telegram quiz): a word in a foreign language → pick the correct translation. |
- 🕶️ Anonymous poll — a separate toggle: the poll/quiz is anonymous (you can't see who answered what) or open.
- AI generation uses the chat's language; topics are neutral (hobbies, memories, plans), with no politics or religion. If the AI is unavailable, the bot posts a fallback question, so the feature always works.
🎓 Language quiz¶
The "language quiz" mode uses the same language pair as "Word of the day" (🇩🇪→🇺🇦 or 🇬🇧→🇺🇦; if "Word of the day" is disabled — German→Ukrainian by default). The bot shows a word in the foreign language and offers a choice of the correct translation among the options; after you answer, Telegram highlights the correct one and shows a usage example. Perfect for chats focused on language learning — it complements the "Word of the day" text card with a game format.