XP & Levels — Trivia Premium

A multiple-choice question game: Mokito posts a trivia question embed with answer buttons (A/B/C/D or True/False). Members click a button to answer. The first member to click the correct button wins XP; wrong answers are ephemeral and lock that member out of the question. One guess per person per question. After a correct answer, the bot reveals the answer, removes the buttons, and schedules the next question after a configurable cooldown.

Overview

Trivia is one of the five mini-games in the XP & Levels category, which is Mokito Premium-only. The server owner or a manager picks one channel as the game channel, sets the XP reward range, and sets the cooldown between questions. Mokito then posts trivia questions with answer buttons, and members compete to be the first to click the correct button.

Each correct answer awards a random amount of XP in the configured range, feeding into the same level curve as message XP. The game also keeps a per-member scoreboard of correct answers, with a leaderboard in the member dashboard.

For how XP and levels work in general, see XP & Leveling. For the other mini-games, see the Mini-Games page.

A Mokito Premium feature

The entire XP & Levels category is Premium-only. In a server without Premium, the Trivia page is not accessible — the owner or manager is redirected to the Premium page. No question embeds are posted, no answers are evaluated, and no scoreboard is kept.

If a server loses Premium after configuring the game, the stored settings are preserved. The game goes dormant (no rounds posted, no buttons evaluated) but the configuration is retained so a seamless re-upgrade restores everything exactly as it was — the game resumes immediately on reactivation.

How a round works

1. Mokito picks a question from its local question cache (questions are fetched in the background — the bot never hits the external API during a round).
2. It builds an embed showing the question, category, difficulty, type (Multiple Choice or True/False), and the options (A/B/C/D, shuffled per round so the correct answer is not always in the same slot). The embed color reflects the difficulty (green = easy, amber = medium, red = hard).
3. It posts the embed with answer buttons — 4 buttons (A/B/C/D) for multiple-choice, 2 buttons (True/False) for boolean questions.
4. A member clicks a button.
5. Wrong answer: Mokito replies with an ephemeral "❌ That's not it. The question is still open for others to answer!" The question stays open. No one else in the channel sees the failure.
6. Correct answer: Mokito awards random XP in [Minimum XP, Maximum XP], edits the original embed to reveal the answer (a green "✅ Trivia Solved!" embed showing the correct answer, the winner, the XP earned, the new total XP, and the winner's level — with "⬆ leveled up!" if the member crossed a level boundary), removes the answer buttons, schedules the next round after the configured cooldown, and posts a public "🎉 **{user}** got it right and earned **{N} XP**!" message so the whole channel sees who won.
7. One guess per user per question: clicking again after you have answered (right or wrong) gives an ephemeral "You've already answered this question. You can't guess again until the next question."

The first round is posted automatically when the game is enabled (or re-enabled after a channel change with no active round). If no questions are cached yet, the bot posts a friendly "No trivia questions are available yet. The cache is being populated — the first question will appear shortly." and the first question appears once the cache has been populated.

Correct answer

When a member clicks the button matching the correct answer, Mokito:

• Awards a random amount of XP in the configured [Minimum XP, Maximum XP] range.
• Bumps the member's correct-count on the scoreboard.
• Edits the original question embed in place — it becomes a green "✅ Trivia Solved!" embed showing the correct answer, the winner (with their avatar as the thumbnail), the XP earned, the new total XP, and the winner's level (with "⬆ leveled up!" if applicable). The answer buttons are removed.
• Schedules the next round after the configured cooldown.
• Posts a public message in the channel: "🎉 **{user}** got it right and earned **{N} XP**!" (plus a "Level up! → Level **{L}**." note if the member leveled up).

Wrong answer

When a member clicks a button that is not the correct answer, Mokito:

• Replies with an ephemeral "❌ That's not it. The question is still open for others to answer!" — only the member who clicked sees it; no one else in the channel is notified.
• Locks that member out of the current question — they cannot guess again until the next question (see One guess per user per question).
• Leaves the question open — other members can still answer.

The wrong-click is not posted to the channel. The question stays active until someone answers correctly.

One guess per user per question

Each member gets exactly one guess per question. After clicking any button (right or wrong), the member is locked out of that question — clicking again returns an ephemeral "You've already answered this question. You can't guess again until the next question." The lock is per question, not per round-cycle; once a new question is posted, every member can guess again.

Question types

Trivia questions come in two types, each rendered with its own button layout:

Multiple Choice

The question has one correct answer and three incorrect answers. Mokito shuffles the four options into slots A/B/C/D every round, so the correct answer is not always in the same position — it's randomized per round. The embed lists the options as:

A. {option 1}
B. {option 2}
C. {option 3}
D. {option 4}

Four buttons (A, B, C, D) appear in a single row below the embed. Click the letter matching the answer you think is correct.

True / False

The question is a true/false statement. Two buttons appear: True and False. The correct one is whichever the question's answer says is correct. True is always the left button and False is always the right button (conventional order — no shuffling needed for boolean questions, since the correctness is in the question, not the button position).

Difficulty colors

The round embed's color reflects the question's difficulty, so members can see at a glance how hard the current question is:

The question cache

Mokito maintains a local cache of trivia questions — each with a category, difficulty, type (multiple or boolean), the question text, the correct answer, and the incorrect answers. The game reads exclusively from this cache — it never hits the external API during a round. New questions are fetched in the background and added to the cache automatically.

This keeps the game responsive (no waiting on an external API when a round starts) and avoids rate-limit pressure on the question provider. The cache grows over time; the picker prefers less-served questions so the game stays fresh.

Question selection

When a new round starts, Mokito picks a question from the cache. The picker prefers questions that have been served fewer times (ordered by serve count, then randomized) so the game doesn't keep repeating the same handful of questions. If the cache is empty, the bot posts the friendly "No trivia questions are available yet" message and tries again on the next round start.

The Trivia page

The configuration page lives at XP & Levels → Trivia in the guild dashboard. Only the server owner, managers, and Mokito admins can access it (moderators and support team cannot). The page has an enable banner, a current-round status card (visible when the game is on and a channel is selected), and a single configuration form with a save button at the bottom.

Configurable settings

The enable banner

The master ON/OFF toggle sits in a prominent banner card directly below the hero header so the ON/OFF state is impossible to miss. It uses the standard X / ✓ radio toggle pattern (same as the Guess the Word, Counting, and other XP settings pages). When ON, the banner turns green and reads "Trivia is ON · The bot is posting trivia questions in the game channel." When OFF, it reads "Trivia is OFF · Flip the switch on to start posting trivia questions."

Current round status card

When the game is enabled and a channel is selected, a status card appears showing the current round state:

• "A question is active · waiting for a correct answer" — a question embed with buttons is live in the channel.
• "Cooldown · next question posts shortly" — a correct answer was received and the bot is waiting the configured cooldown before posting the next question.
• "No active question · the next question posts when a round starts" — the game is on but no round is live or scheduled yet.

The card also shows the game channel and the number of questions cached locally.

Game channel picker

The game channel is a type-to-search input listing the server's text and announcement channels. You can type a channel name to filter the list or paste a channel ID directly. Only channels that exist in the server are accepted — a channel ID not in the local channel cache is rejected with a validation error.

A channel must be selected before Trivia can be enabled. If you try to save with the toggle ON but no channel, the form rejects with "A game channel must be selected before Trivia can be enabled."

If the previously-saved channel no longer exists in the server (e.g. it was deleted), a warning appears prompting you to pick a new channel or clear the field to disable.

XP reward range

The XP reward range controls how much XP a correct answer awards. Mokito picks a random integer between the Minimum XP and Maximum XP (inclusive) on each correct answer. Both values must be between 1 and 1,000, and the Minimum must be less than or equal to the Maximum. If you save a Minimum greater than the Maximum, the form rejects with "The minimum XP must be less than or equal to the maximum XP."

Cooldown between questions

After a correct answer, the bot waits the configured cooldown (in seconds) before posting the next question. The cooldown is per server — everyone in the channel waits the same amount of time. The default is 30 seconds; the bounds are 5 seconds (fast-paced) to 600 seconds (10 minutes, leisurely). The cooldown only applies after a correct answer — it does not apply if a question is sitting unanswered.

Saving

The save button is at the bottom of the form only. When you save with the game enabled and no round is active, the bot posts the first question to the selected channel immediately. The status flash confirms: "Trivia enabled and saved. The bot posted the first question to #your-channel." If you save with the game off, the status reads "Trivia settings saved (the game is currently off)."

Scoreboard & leaderboard

Each member's Trivia score tracks correct answers. Every correct answer increments the member's correct-count. The scoreboard is kept even after a member leaves the server — guild staff may want to review participation.

The web dashboard leaderboard

The member dashboard has a Trivia leaderboard under the Leaderboards area (accessible to members in the guild). It shows the members with the most correct answers. Members with zero correct answers are excluded from the leaderboard. The leaderboard is read-only — no configuration lives here (the game channel, XP range, and cooldown are on the management page under XP & Levels → Trivia).

Limits & Edge Cases