|
|
| (40 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| == Overview == | | = Discord Bots = |
| '''Super-Shiritori''' is a custom Discord bot designed to run a smart and fun word game. It challenges players to continue a word chain where each new word starts with the last letter of the previous one. The bot includes special rules, gameplay modes, and word tracking.
| |
|
| |
|
| == 🔧 Features ==
| | The project is powered by '''three separate Discord bots''', each running as its own independent process with its own login token, all operating together in the same Discord server. They were split apart specifically so that heavy work in one — a large multiplayer game, a bulk dictionary rewrite — can never stall or lag the other two; running as genuinely separate processes gives real operating-system-level isolation that three clients sharing one process couldn't. |
|
| |
|
| * Interactive word-chain game
| | This page summarizes what each bot does. For full command lists and mechanics, see each bot's own dedicated page. |
| * 950K Words to use!
| |
| * Tracks players’ scores and game history
| |
| * Can Invite Ai's to play with you
| |
| * Prevents invalid or repeated words
| |
| * Has wordle with standardized and a spike in difficulty
| |
| * Runs in any Discord server
| |
|
| |
|
| == 💻 How It Works == | | == Super-Shiritori == |
| Super-Shiritori is coded using:
| | The flagship bot and the reason the project exists: it runs the core word-chain game, along with several related game modes (Word Bomb, Wordle, Anagram, Solo Shiritori, Protori), AI opponents with distinct personalities, a rarity-based word rolling and trading system, and player statistics, levels, and titles. It also hosts the dictionary-facing player commands (<code>/check</code>, <code>/solve</code>, <code>/suggest</code>, and others), even though it doesn't own the dictionary files directly — see [[Word-Curatori]]. |
|
| |
|
| * '''Programming Language(s):''' Python
| | ''Main article:'' [[Super-Shiritori]] |
| * '''Libraries/Tools:''' Discord.py, Google Gemini
| |
| * '''Database:''' Words.txt
| |
| * '''Hosting Method:''' Runs on a single old laptop that is kept 24/7 (usually)
| |
|
| |
|
| == 🧩 Bot Commands == | | == Word-Curatori == |
| | The curation bot. It is the only one of the three bots permitted to write to the dictionary files, and it runs the review workflow behind Super-Shiritori's <code>/suggest</code> command — validating submissions, posting them for a curator's Accept/Reject decision, and merging accepted words into the live dictionary. Curators also use it directly, via <code>!add</code>/<code>!remove</code>, to edit dictionary entries by hand. |
|
| |
|
| === 🔹 Multiplayer Shiritori Commands ===
| | ''Main article:'' [[Word-Curatori]] |
| {| class="fandom-table"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/startshiritori [#channel]</code>
| |
| |'''Admin/Mod only''' (requires "Manage Messages" or Bot Owner). Starts a new multiplayer game in the chosen text channel. Posts the rules and a starting word. Only one game per channel.
| |
| |-
| |
| |<code>/endshiritori</code>
| |
| |'''Admin/Mod only.''' Ends the current game and shows final stats: longest words, total words, and dictionary coverage.
| |
| |-
| |
| |<code>/invite_ai</code>
| |
| |Adds an AI opponent with a random personality (e.g., NOOB, PRO, MIMIC, ASSASSIN). Only one AI per game.
| |
| |-
| |
| |<code>/leaderboard [category] [visibility]</code>
| |
| |Shows server leaderboard by category: Longest Word, Turns Played, Hyphens, Apostrophes, Dictionary Completion. Visibility: Public or Private.
| |
| |-
| |
| |<code>/mystats [visibility]</code>
| |
| |Shows your combined multiplayer stats across all servers: longest word, turns, hyphens, apostrophes, and dictionary completion.
| |
| |}
| |
| ----
| |
|
| |
|
| === 🔸 Solo Shiritori Commands === | | == Vexitori == |
| {| class="fandom-table"
| | The vexillology (flag-guessing) bot. It runs a continuous, fully automatic flag-identification game in a dedicated channel — no player needs to start a round — alongside commands to browse, search, and (for curators) manage the flag database. It shares no game state with Super-Shiritori at all; the flag game was extracted into its own process specifically because it never touched Shiritori, Anagram, or Word Bomb data in the first place. |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/soloshiritori</code>
| |
| |Starts a solo Shiritori game against an adaptive AI in a private thread. Ends on a mistake, repeat, or 5 minutes of inactivity. Stats contribute to solo and global records.
| |
| |-
| |
| |<code>/solostats [visibility]</code>
| |
| |Shows your solo stats: level, longest word, turns played, hyphen/apostrophe use, and dictionary coverage.
| |
| |-
| |
| |<code>/sololeaderboard [sort_by] [visibility]</code>
| |
| |Global solo leaderboard. Sort by: Longest Word, Turns Played, Dictionary Completion.
| |
| |}
| |
| ----
| |
|
| |
|
| === 🧠 Wordle Commands ===
| | ''Main article:'' [[Vexitori]] |
| {| class="fandom-table"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/wordle [game_length] [mode] [include_hyphens]</code>
| |
| |Starts a private Wordle game in a new thread. Length: 5–18 letters. Modes: Standardized (6 tries) or Full Dictionary (8 tries). Can toggle hyphen allowance. Ends on win, loss, or 3-minute inactivity.
| |
| |-
| |
| |<code>/wordlestats [visibility]</code>
| |
| |Displays your Wordle win streaks by length and mode.
| |
| |-
| |
| |<code>/wordleleaderboard [game_length] [mode] [visibility]</code>
| |
| |Shows top 10 Wordle players by win streak. Filter by length and mode.
| |
| |}
| |
| ----
| |
|
| |
|
| === 🆙 Leveling & Titles === | | == See also == |
| {| class="fandom-table"
| | * [[Dictionary Information]] — the content standards in Super-Shiritori and Word-Curatori's dictionary-facing features are built around |
| !Command
| | * [[AI Bots]] |
| !Description
| | * [[Achievements]] — the cosmetic progression system spanning Super-Shiritori's own game modes |
| |-
| | * [[Vexillopedia]] - the entire game Vexitori operates for |
| |<code>/level [visibility]</code>
| | [[Category:Information]] |
| |Shows your level, EXP progress, and next-level goal.
| |
| |-
| |
| |<code>/levelsleaderboard [visibility]</code>
| |
| |Displays top 10 users by level on this server.
| |
| |-
| |
| |<code>/set_title [title]</code>
| |
| |Sets your title (visible in leaderboards/stats). You can only use unlocked titles. Use <code>None</code> to clear. Autocomplete supported.
| |
| |}
| |
| ---- | |
| | |
| === 🛠 Utility & Tools ===
| |
| {| class="fandom-table"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/check [word(s)]</code>
| |
| |Validates up to 15 words. Returns ✅ or ❌ based on dictionary presence.
| |
| |-
| |
| |<code>/characters [words] [private?]</code>
| |
| |Shows character count for up to 20 words. Optionally private.
| |
| |-
| |
| |<code>/solve [prompt] [contains?] [exact_length?] [sorting?] [limit?]</code>
| |
| |Word-finder tool. Filters by starting letters, length, and sorting (longest/shortest). Limit: 1–500 results.
| |
| |-
| |
| |<code>/dictionaries [dictionary_name]</code>
| |
| |Checks which words you've used from special lists (e.g., Blacklist, Phobias, Ologies, Numbers).
| |
| |-
| |
| |<code>/wordhunt [mode]</code>
| |
| |Generates a personal challenge of 15 unused words. Modes: Multiplayer or Solo Hunt. Refreshes after 12h or completion.
| |
| |-
| |
| |<code>/suggest [word(s)]</code>
| |
| |Suggests 1–1001 new words for the main dictionary. Gives feedback on duplicates/invalid entries.
| |
| |-
| |
| |<code>/define [word]</code>
| |
| |AI-assisted definition with pronunciation. Not guaranteed accurate—based on common usage.
| |
| |}
| |
| ----
| |
| | |
| === ⚡ Quick Chat Commands (<code>!</code>) ===
| |
| {| class="fandom-table"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>!level</code>
| |
| |Quick, private level and EXP display (same as <code>/level</code>).
| |
| |-
| |
| |<code>!titles</code>
| |
| |Opens your title overview.
| |
| |-
| |
| |<code>!status</code>
| |
| |''(Game channel only)'' — Shows current Shiritori stats, average word length, and next starting letter.
| |
| |-
| |
| |<code>!longest</code>
| |
| |''(Game channel only)'' — Shows top 5 longest words in the current game and who played them.
| |
| |}
| |
| ----
| |
| | |
| === 🎭 AI Summons (Game Channel Only) ===
| |
| Each has a cooldown and summon chance. Some unlock titles.
| |
| {| class="fandom-table"
| |
| !Command
| |
| !AI Summoned
| |
| !Success Rate
| |
| !Cooldown
| |
| !Notes
| |
| |-
| |
| |<code>!snipe</code>
| |
| |Sniper
| |
| |20%
| |
| |10 min
| |
| |Unlocks ''Sniper's Mark'' title
| |
| |-
| |
| |<code>!assassin</code>
| |
| |Assassin
| |
| |40%
| |
| |15 min
| |
| |Fail: silenced 30 turns. Success: ''Assassin's Ally'' title
| |
| |-
| |
| |<code>!noob</code>
| |
| |NOOB
| |
| |100%
| |
| |1 min
| |
| |N/a
| |
| |-
| |
| |<code>!rookie</code>
| |
| |ROOKIE
| |
| |85%
| |
| |2 min
| |
| |N/a
| |
| |-
| |
| |<code>!average</code>
| |
| |AVERAGE
| |
| |75%
| |
| |3 min
| |
| |N/a
| |
| |-
| |
| |<code>!pro</code>
| |
| |PRO
| |
| |50%
| |
| |10 min
| |
| |N/a
| |
| |-
| |
| |<code>!voweless</code>
| |
| |VOWELLESS
| |
| |50%
| |
| |15 min
| |
| |Based on a real player known as Lemonighter (lemonighter)
| |
| |-
| |
| |<code>!paster</code>
| |
| |PASTER
| |
| |45%
| |
| |15 min
| |
| |Based on a real player known as SUSSY (puperpupey)
| |
| |-
| |
| |<code>!numbers</code>
| |
| |NUMBERPHILE
| |
| |50%
| |
| |15 min
| |
| |N/a
| |
| |-
| |
| |<code>!palindrome</code>
| |
| |PALINDROMIC
| |
| |45%
| |
| |15 min
| |
| |N/a
| |
| |-
| |
| |<code>!minimal</code>
| |
| |MINIMALIST
| |
| |50%
| |
| |15 min
| |
| |N/a
| |
| |-
| |
| |<code>!mimic</code>
| |
| |MIMIC
| |
| |40%
| |
| |16 min
| |
| |Bot Owners favorite
| |
| |}
| |
| | |
| == ⚙️ Behind the Scenes ==
| |
| | |
| * '''Uptime Manager:''' Kos (on Discord)
| |
| | |
| * This bot has been in development for over '''three years''', originally starting with a curated list from the '''OMG Community'''. Later, a friend contributed a massive list of '''320,000 words''', which became the foundation. Over time, the dictionary grew steadily—scraping terms from reputable sources like '''Merriam-Webster''' and '''Oxford''', as well as expanding through:
| |
| ** Acronyms
| |
| ** Word suggestions from users
| |
| ** Foreign language entries
| |
| ** Constructed languages (conlangs)
| |
| ** And countless unique additions
| |
| | |
| * Today, the word bank includes over '''950,000 entries''', making it one of the '''largest Shiritori-focused word lists''' known. It’s intentionally kept private to protect its integrity and uniqueness.
| |
| | |
| * There’s '''no anti-cheat system'''—the only enforced mechanic is checking whether a word has been used before. Players are free to use external tools like Google or dictionaries, though it’s encouraged to play without them for a more rewarding and educational experience.
| |
| | |
| * At its core, this game is about '''learning''', '''exploration''', and '''having fun with language'''.
| |
| | |
| ----
| |
| | |
| === 🎮 Unique Game Modes ===
| |
| | |
| * '''Multiplayer Shiritori''' Compete with friends or AI in an ongoing game of linguistic strategy.
| |
| * '''Solo Shiritori''' Face off against an adaptive AI opponent in a private session to test your vocabulary and endurance.
| |
| | |
| == 👥 Creator & Team ==
| |
| | |
| * '''Main Developer:''' [[Ghost (Owner)|Ghost (no_where.ghost_002)]]
| |
| * '''Admins/Helpers:''' Kos (kos256), GreenyMage(greenymage)
| |
| | |
| == 📎 Links ==
| |
| | |
| * https://discord.com/oauth2/authorize?client_id=1309504109308674089 (Invite link)
| |
| | |
| * https://discord.gg/WahVXSkA7H (Support Server)
| |
Discord Bots
The project is powered by three separate Discord bots, each running as its own independent process with its own login token, all operating together in the same Discord server. They were split apart specifically so that heavy work in one — a large multiplayer game, a bulk dictionary rewrite — can never stall or lag the other two; running as genuinely separate processes gives real operating-system-level isolation that three clients sharing one process couldn't.
This page summarizes what each bot does. For full command lists and mechanics, see each bot's own dedicated page.
Super-Shiritori
The flagship bot and the reason the project exists: it runs the core word-chain game, along with several related game modes (Word Bomb, Wordle, Anagram, Solo Shiritori, Protori), AI opponents with distinct personalities, a rarity-based word rolling and trading system, and player statistics, levels, and titles. It also hosts the dictionary-facing player commands (/check, /solve, /suggest, and others), even though it doesn't own the dictionary files directly — see Word-Curatori.
Main article: Super-Shiritori
Word-Curatori
The curation bot. It is the only one of the three bots permitted to write to the dictionary files, and it runs the review workflow behind Super-Shiritori's /suggest command — validating submissions, posting them for a curator's Accept/Reject decision, and merging accepted words into the live dictionary. Curators also use it directly, via !add/!remove, to edit dictionary entries by hand.
Main article: Word-Curatori
Vexitori
The vexillology (flag-guessing) bot. It runs a continuous, fully automatic flag-identification game in a dedicated channel — no player needs to start a round — alongside commands to browse, search, and (for curators) manage the flag database. It shares no game state with Super-Shiritori at all; the flag game was extracted into its own process specifically because it never touched Shiritori, Anagram, or Word Bomb data in the first place.
Main article: Vexitori
See also
- Dictionary Information — the content standards in Super-Shiritori and Word-Curatori's dictionary-facing features are built around
- AI Bots
- Achievements — the cosmetic progression system spanning Super-Shiritori's own game modes
- Vexillopedia - the entire game Vexitori operates for
