Wordle

Wordle

Wordle is a private, single-player word-guessing game played in its own thread.

Starting a Game

A game is created with /wordle, which takes three parameters:

game_length

the length of the secret word, from 5 to 18 letters

mode

Standardized (stricter rules) or Full Dictionary

include_hyphens

whether the secret word may contain a hyphen (defaults to false; apostrophes are never used in the secret word regardless of this setting)

Running the command creates a private thread and posts a starting grid of blank squares (⬜), one row per available attempt. Standardized mode always gives 6 attempts; Full Dictionary mode gives 8. The game times out after 180 seconds (3 minutes) of inactivity.

Standardized Mode

In Standardized mode, the secret word is drawn only from words meeting all of the following:

1. Contains between 1 and 3 vowels (counting Y as a vowel)
2. No letter appears more than twice
3. No letter appears three times in a row
4. Does not end in "s"
5. Contains no doubled "zz", "qq", "ii", or "hh"
6. Contains at most one letter total from J, K, Q, X, and Z combined
7. Contains no hyphen or apostrophe, regardless of the include_hyphens setting
8. Begins and ends with a consonant

The third rule above (no letter three times in a row) can never actually reject anything the second rule (no letter more than twice, anywhere in the word) hasn't already excluded — three of the same letter in a row already requires three total occurrences, which rule 2 forbids regardless of whether they're adjacent. It's redundant in practice rather than a second, independent restriction.

Because of the no-hyphen rule, Standardized mode never selects a hyphenated secret word even if include_hyphens is enabled; that setting only affects which words are eligible in Full Dictionary mode.

Guessing

Guesses are typed directly in the thread. A guess must be exactly the target length, contain only letters and hyphens (an apostrophe is treated as an invalid character in a guess, the same as any other symbol), and be a word in the dictionary; invalid guesses are rejected with an explanation and are not counted as an attempt. Each guess message is deleted after being processed, and the game's grid message is edited in place to show progress rather than posting a new message per guess.

Each letter in a valid guess is marked:

• 🟩 Green: correct letter, correct position
• 🟨 Yellow: correct letter, present but in the wrong position
• 🟥 Red: letter not in the word, or already fully accounted for by other squares

Scoring accounts for repeated letters correctly: a letter is only marked yellow as many times as it actually remains unmatched in the secret word, rather than every occurrence of that letter in the guess.

Winning, Losing, and Streaks

Guessing the word correctly (an all-green row) ends the game as a win: "🎉 Congratulations, {player}! You guessed the word! The word was: {word}. Guesses: {n}/{total}. Current Streak ({length}-letter, {mode}): {streak}." A win increases the player's current streak for that word length and mode by 1, and updates their longest streak if it was beaten. Winning in exactly one guess unlocks one title; winning in exactly two guesses unlocks a separate, different title — they are not the same reward at two thresholds, but two distinct ones.

Running out of attempts, or 180 seconds passing without a valid guess, ends the game as a loss and resets the current streak to 0 (the longest streak is preserved): "😥 Game Over! You didn't guess the word in {total} tries. The word was: {word}. Your {mode} streak for {length}-letter words has been reset." Either way, the game's thread is deleted one minute after the game ends.

Statistics

Wordle keeps its own streak-based statistics, separate from Shiritori's. /wordle_stats shows a player's current and longest streak for every word length and mode combination they've recorded any activity in, all at once. /wordle_leaderboard requires a specific word length and mode as parameters and shows the top 10 players by longest streak for that exact combination, breaking ties by current streak. Wordle results do not affect Shiritori stats or leaderboards.

History: saving a player's streak used to be a direct, blocking disk write performed right on the bot's shared event loop at the moment a game ended, win or lose — the same class of issue found across several other game modes, where a single save could briefly stall every other concurrent game across every server. It's since been moved to run on a background thread instead.

See also

• Super-Shiritori
• Solo Shiritori
• Achievements