> For the complete documentation index, see [llms.txt](https://docs.zeroauthority.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zeroauthority.xyz/nova-bot/nova-ai-agent/community/nova-community-games.md).

# Nova Community Games

**Nova Community Games** is an opt-in **engagement suite** for your Discord server or Telegram group — light "tribe games & hangouts" style fun that rewards members for showing up. Once an admin turns it on, Nova runs an **XP + levels** system, **leaderboards**, an automatic **weekly leaderboard post**, a fair **random winner picker / giveaways** — all free — plus, on Community PRO, a **weekly AI recap** and a library of **engagement games a moderator starts on demand**: trivia, question-of-the-day, would-you-rather, meme challenges and mini-games, all keyed to your community.

{% hint style="info" %}
**Games are mod-run, not scheduled.** A moderator simply asks Nova to *"start a trivia"* (or any game) whenever they want to liven up the chat — Nova generates it on the spot, posts it, and plays host. Nothing auto-posts on a timer except the weekly recap and weekly leaderboard.
{% endhint %}

Once it's on (for the **whole** server/group), the fun is **member-facing**: anyone can earn XP, check the leaderboard, and join giveaways.

## Free vs PRO

|                                             | **Free** | **Community PRO**    |
| ------------------------------------------- | -------- | -------------------- |
| ⭐ XP & levels                               | ✅        | ✅                    |
| 🏆 Leaderboards (on demand)                 | ✅        | ✅                    |
| 📣 Weekly leaderboard post                  | ✅        | ✅                    |
| 🎁 Giveaways                                | ✅        | ✅                    |
| 🎮 Mod-run AI games & 🧠 trivia (on demand) | —        | ✅ (25 AI games/week) |
| 📅 Weekly AI recap                          | —        | ✅                    |

Everything data-driven is **free**; the **AI generations** (mod-run games, trivia, the AI weekly recap) are part of [Community PRO](/nova-bot/premium/nova-premium-for-communities.md) with a generous weekly budget. When the budget is spent, XP, leaderboards, and giveaways keep running — only the AI games pause until Monday.

***

## What's Inside

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>⭐ XP &#x26; Levels</strong></td><td>Members earn XP for chatting and level up over time, with an anti-spam cooldown so quality beats spam.</td></tr><tr><td><strong>🏆 Leaderboards</strong></td><td>All-time, weekly, and monthly rankings — plus "what's my rank?" for any member.</td></tr><tr><td><strong>📣 Weekly Leaderboard Post</strong></td><td>An automatic weekly celebration — top members of the week + the all-time podium, posted on your chosen day and channel.</td></tr><tr><td><strong>🎮 Engagement Games (on demand)</strong></td><td>A mod asks Nova to run a game — community questions, would-you-rather, this-or-that, meme challenges, mini-games — and Nova generates and hosts it live. <em>(PRO)</em></td></tr><tr><td><strong>🧠 Trivia</strong></td><td>A mod starts a trivia tuned to your community; Nova holds the answer and reveals it in-chat when you ask. <em>(PRO)</em></td></tr><tr><td><strong>📅 Weekly Recap</strong></td><td>A "here's how the week went" summary built from real activity — most-active members and highlights. <em>(PRO)</em></td></tr><tr><td><strong>🎁 Giveaways</strong></td><td>A fair random winner picker — members enter with a keyword, Nova draws winners uniformly at random.</td></tr></tbody></table>

***

## XP & Levels

Every qualifying message earns **15–25 XP** (uniform random), and members **level up** on a quadratic curve (each level costs a little more than the last). Two guardrails keep it fair:

* **Anti-spam cooldown** — a member earns XP **at most once every 60 seconds**, no matter how fast they type. This is the single most important anti-gaming measure, so flooding the chat doesn't farm XP.
* **Minimum length** — messages shorter than **3 characters** (trimmed) earn nothing, so "gm" / single-emoji spam doesn't dominate.

When a member levels up, Nova can post a small **level-up announcement** in the channel where it happened (on by default — you can turn it off). Prefer them out of the way? Nominate a dedicated **level-up channel** — *"announce level-ups in #achievements"* — and they all land there instead (on Telegram, a forum topic).

{% hint style="success" %}
XP is earned **server/group-wide** — it doesn't matter which channel a member is active in. The leaderboard reconciles it all under one community.
{% endhint %}

### Checking the leaderboard

The leaderboard is readable by **any** member (not admin-only), group-only. Just ask Nova:

> *"show the leaderboard"* — or ask for your own rank: *"what level am I?"*

Rankings are available **all-time, this week, and this month**.

### The weekly leaderboard post

Once a week Nova also posts the leaderboard **automatically** — the top members of the week (with total XP earned and active-member count) plus the **all-time podium**. It's built straight from the XP data, included on every tier, and fully configurable:

* *"post the weekly leaderboard on Sundays"* — any weekday (default **Monday**, at your games post time)
* *"post the weekly leaderboard in #general"* — any channel (on Telegram, a forum topic); defaults to the games channel
* *"turn off the weekly leaderboard"* — it's on by default

***

## Engagement Games — mod-run *(Community PRO)*

Whenever a moderator wants to spark some life in the chat, they just ask Nova to run a game — **there's no schedule**. Nova generates the game on the spot (grounded in your community, or on a topic you name), posts it, and plays host:

* **Trivia** — *"start a trivia"* — a genuine question with one verifiable answer. Nova **holds the answer** and posts it when you say *"reveal the answer"* (no timer — you decide when).
* **Question of the day** — *"post a community question"* — an open, inviting question that gets members talking
* **Would-you-rather** / **this-or-that** — *"run a would-you-rather"* — pick a side and defend it
* **Meme challenge** — *"do a meme challenge"* — a caption or meme prompt on a theme
* **Mini-game** — *"run a mini-game"* — a light in-chat game (word games, "guess the project from an emoji", two-truths-and-a-lie…)

Say *"list games"* to see everything on offer, and add a theme any time — *"start a trivia about the Bitcoin halving"*. Games are **admin/mod-only**; anyone can join in once posted.

AI game generation runs on a **weekly budget of 25**. If it's ever spent, games pause until Monday — XP, leaderboards, and giveaways are unaffected. *"community games status"* shows this week's usage.

***

## Weekly Recap *(Community PRO)*

Once a week (Mondays by default), Nova posts a **community recap** built from real activity data — the most-active members and a summary of the week. It's deterministic where it counts (the numbers come from actual data), so it's an honest readout, not a hallucinated one — and it doesn't consume the AI-games budget. On the free tier, the weekly leaderboard post covers the same celebration moment.

***

## Giveaways / Random Winner Picker

Run a fair raffle right in chat. The flow is simple:

1. **Start** — *"start a giveaway for a WL spot, pick 1 winner"*. Nova posts the giveaway and opens entries.
2. **Enter** — members type the **entry keyword** (default `join`) to enter. It's an exact, case-insensitive match on the trimmed message, so ordinary chatter never counts as an entry.
3. **Pick** — *"pick the winner"*. Nova closes entries and draws winner(s) **uniformly at random** (a Fisher–Yates draw — unbiased).
4. **Reroll / status / cancel** — *"reroll"* draws a fresh winner from the same entries; *"how many entries?"* / *"giveaway status"*; *"cancel the giveaway"*.

You can draw up to **20 winners** per giveaway. Giveaways are **admin-only** and require Community Games to be enabled with giveaways allowed.

***

## Set It Up — just talk to Nova

There's no wizard — configure it conversationally. (Setup is admin-only, in your server/group — not DMs.) @mention Nova or reply to it:

1. **Turn it on:**
   * *"@Nova turn on community games for this server"*
2. **Run a game (admin/mod), any time:**
   * *"start a trivia"* — then *"reveal the answer"* when you're ready
3. **Toggle individual features:**
   * *"turn off level-up announcements"*
4. **Tune the XP extras** (shown as "Ascend" in the dashboard):
   * *"announce level-ups in #achievements"*
5. **Set the recap time (optional):**
   * *"post the weekly recap on Fridays at 6pm"* — defaults to **Monday, 16:00 UTC**. This only schedules the recap; games are always on demand.
6. **Use it (any member):**
   * *"leaderboard"*
7. **Run a giveaway (admin):**
   * *"start a giveaway for \<prize>"* → members type `join` → *"pick a winner"*
8. **Check status / turn off:**
   * *"are community games on?"* · *"turn off community games"*

***

## Privacy Note

Community Games tracks **activity for scoring** — it counts qualifying messages to award XP and rank members, and logs giveaway entries. Prompts and recaps are generated from your community's brief and aggregate activity. It's engagement data, kept per-community and used only to run the games.