XP & Levels — Guess the Word Premium

A definition-guessing game: Mokito posts a word's definition, part of speech, syllable count, and type of without revealing the word itself. Members type guesses in the game channel. The first member to guess correctly wins XP, and a new word is posted automatically. A word cache, a per-server blacklist, an optional default bad-words filter, an alternation rule, and a round timeout keep the game fresh and fair.

Overview

Guess the Word 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 configures the rules. Mokito then posts a word's definition (without the word itself), and members compete to be the first to guess correctly.

Each correct guess 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 guesses, 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 Guess the Word page is not accessible — the owner or manager is redirected to the Premium page. No round embeds are posted, no guesses 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, no reactions) 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 word from its local word cache (words are fetched in the background — the bot never hits the external API during a round).
2. It posts a round embed showing the definition, part of speech, syllable count, and type of (joined as a comma list). It does not show the word itself or the pronunciation — those would make it trivially searchable.
3. Members type guesses in the game channel. Mokito compares each trimmed message to the active word, case-insensitively.
4. Wrong guess: Mokito reacts with ✖ and the word being guessed stays active. The round embed is bumped to the bottom of the channel (see Keeping the word at the bottom).
5. Correct guess: Mokito reacts with ✓, awards random XP in [Minimum XP, Maximum XP], bumps the guesser's correct-count on the scoreboard, posts a green success embed revealing the full word (with definition, part of speech, pronunciation when available, syllable breakdown, and type of), and immediately starts the next round.

The first round is posted automatically when the game is enabled (or re-enabled after a channel change with no active round). If no words are cached yet, the bot posts a friendly "No words are available to start a round right now" message and tries again on the next round start.

Correct guess

When a member's message matches the active word (trimmed, case-insensitive), Mokito:

• Reacts to the member's message with ✓.
• Awards a random amount of XP in the configured [Minimum XP, Maximum XP] range.
• Bumps the member's correct-count on the scoreboard.
• Posts a green success embed showing the solved word, its definition, part of speech, pronunciation (when available), syllable breakdown, type of, and the XP awarded.
• Clears the current round and immediately starts the next one (picks a new word + posts a fresh round embed).

Wrong guess

When the message does not match the active word, Mokito:

• Reacts to the member's message with ✖.
• Updates the last-guesser (for the alternation rule).
• Bumps the round embed back to the bottom of the channel (see Keeping the word at the bottom).

The wrong message is not deleted — it stays in the channel so the conversation reads naturally. The word stays active until someone guesses it correctly or the round timeout elapses.

The alternation rule

The "Allow consecutive guesses by the same member" toggle controls whether a member may guess multiple times in a row:

• OFF: the member who guessed last (right or wrong) cannot guess again until someone else does. Their silenced message still bumps the round embed to the bottom, but it is not evaluated as a guess.
• ON (default): a member may guess as many times in a row as they like.

The rule compares the author of the current message against the last guesser. It applies to both correct and wrong guesses — a correct guess by the same member is not blocked (the round is already over).

Round timeout

The round timeout controls how long a word stays active after the first guess attempt. The timer starts only on the first guess — an untouched word sits quietly until someone engages. When the timeout elapses with no correct guess:

• Mokito posts an amber "⏰ Time's up!" reveal embed showing the word, its definition, part of speech, pronunciation (when available), syllable breakdown, and type of. No XP is awarded (no one guessed).
• It clears the round and immediately starts the next one.

Set the timeout to 0 to disable it entirely — a word stays active until someone guesses it, no matter how long that takes. The default is 60 minutes.

Keeping the word at the bottom

Every non-bot message in the game channel that is not a correct guess triggers a delete-and-repost of the round embed. Mokito deletes the old round embed (the word being guessed) and posts a fresh copy at the bottom of the channel. This keeps the active word visible as the most recent message so members don't have to scroll up.

This is a lazy, event-driven bump — there is no scheduled repost. The embed only re-bumps when someone talks in the channel. A silenced member's message (blocked by the alternation rule) still triggers the repost because their message landed in the channel.

The word cache

Mokito maintains a local cache of words with their definitions, parts of speech, syllable counts, type-of lists, and pronunciations. The game reads exclusively from this cache — it never hits the external API during a round. New words are fetched in the background and added to the cache automatically.

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

Word selection

When a new round starts, Mokito picks a word from the cache that passes the guild's blacklist filters. The picker prefers words that have been served fewer times (ordered by serve count, then randomized) so the game doesn't keep repeating the same handful of words. If every cached word is blacklisted or the cache is empty, the bot posts a friendly "No words are available to start a round right now" message.

Word validation

Only single words (no phrases with spaces) that include a definition, a part of speech, and a syllable count of at least 1 are cached. Words missing any of these fields are skipped. Pronunciation is optional — stored when present, omitted otherwise.

Word blacklist

Two blacklist layers can prevent specific words from ever appearing as a round word. Both are applied at word-pick time — a blacklisted word is simply skipped and another is chosen.

Custom blacklist

A comma-separated list of words that should never appear as a round word in this server. Case-insensitive. Enter words separated by commas in the "Custom blacklist" field on the Guess the Word page. The list is de-duplicated automatically. For example: spam, test, example, offensive-word.

Default bad-words filter

An optional toggle that, when ON, also filters a bundled English bad-words list (the LDNOOBW list) at pick time, in addition to your custom blacklist. This is a curated list of common offensive terms — you don't need to type each one yourself. It stacks on top of your custom blacklist (both are applied).

The Guess the Word page

The configuration page lives at XP & Levels → Guess the Word 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 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 word to the selected channel immediately.

Scoreboard & leaderboard

Each member's Guess the Word score tracks correct guesses. Every correct guess 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 Guess the Word leaderboard under the Leaderboards area (accessible to members in the guild). It shows:

• Your Rank pod — the logged-in member's own correct-count and rank, with a 10-block progress bar. Only shown if the member has at least one correct guess.
• Olympic-style podium for the top 3 (gold center, silver left, bronze right) with medals and member avatars. Missing ranks leave the slot empty so a short leaderboard still shows the highest rank in the gold-center position.
• Ranked cards for ranks 4–15 — compact rows with avatar, display name, Discord ID, and correct-count.

Members with zero correct guesses are excluded from the leaderboard. The leaderboard is read-only — no configuration lives here (the game channel, timeout, XP range, and blacklist are on the management page under XP & Levels → Guess the Word).

Limits & Edge Cases