|
|
| (12 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, unique gameplay modes, and comprehensive word tracking to keep things interesting.
| |
|
| |
|
| Even though it’s actively maintained and improved, ''Super-Shiritori'' has always had its fair share of quirks, bugs, and glorious mishaps — just part of its charm.
| | 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. |
|
| |
|
| {{Character|name=Super-Shiritori|
| | This page summarizes what each bot does. For full command lists and mechanics, see each bot's own dedicated page. |
| image1=<gallery>Super Shiritori Bot (Discord).png|Main PFP
| |
| Halloween Shiritori PFP.webp|Halloween PFP
| |
| Original Super-Shiritori PFP.webp|Old PFP</gallery>
| |
| |aliases=Super Shiritori, Shiritori|birthDate=November 22, 2024|birthPlace=Discord|gender=Male|relatives=Super Shiritori (Test Edition)|counterparts=Super Shiritori (test edition)}}
| |
|
| |
|
| == 🔧 Features == | | == 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 (<code>/check</code>, <code>/solve</code>, <code>/suggest</code>, and others), even though it doesn't own the dictionary files directly — see [[Word-Curatori]]. |
|
| |
|
| * Interactive word-chain game
| | ''Main article:'' [[Super-Shiritori]] |
| * 1 million+ words to use
| |
| * Tracks players’ scores and game history
| |
| * Invite AIs to play with you
| |
| * Prevents invalid or repeated words
| |
| * Includes Wordle with standardized and difficult modes
| |
| * Runs in any Discord server
| |
|
| |
|
| == 💻 How It Works == | | == 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. |
|
| |
|
| * '''Programming Language(s):''' Python
| | ''Main article:'' [[Word-Curatori]] |
| * '''Libraries/Tools:''' Discord.py, Google Gemini
| |
| * '''Database:''' shiritori_dict.txt
| |
| * '''Hosting Method:''' Runs on a single old laptop owned by Kos (kos256), kept running 24/7 (usually)
| |
|
| |
|
| == 🧩 Bot Commands == | | == 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. |
|
| |
|
| === 🟦 Multiplayer Shiritori Commands ===
| | ''Main article:'' [[Vexitori]] |
| {| class="wikitable"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/start_shiritori [#channel]</code>
| |
| |Admin/Mod only (requires "Manage Messages" or Bot Owner). Starts a new multiplayer game in the chosen channel.
| |
| |-
| |
| |<code>/end_shiritori</code>
| |
| |Ends the current game and shows final stats.
| |
| |-
| |
| |<code>/invite_ai</code>
| |
| |Adds an AI opponent with a random personality.
| |
| |-
| |
| |<code>/leaderboard [category] [visibility]</code>
| |
| |Server leaderboard by category (e.g. Longest Word, Hyphens, etc.).
| |
| |-
| |
| |<code>/my_stats [visibility]</code>
| |
| |Shows your multiplayer stats.
| |
| |-
| |
| |<code>/restore_games</code>
| |
| |Restores saved games after a shutdown.
| |
| |}
| |
|
| |
|
| === 🟨 Solo Shiritori Commands === | | == See also == |
| {| class="wikitable"
| | * [[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>/solo_shiritori</code>
| |
| |Starts a solo game in a private thread.
| |
| |-
| |
| |<code>/solo_stats [visibility]</code>
| |
| |Shows your solo stats.
| |
| |-
| |
| |<code>/solo_leaderboard [sort_by] [visibility]</code>
| |
| |Global solo leaderboard.
| |
| |}
| |
| | |
| === 💣 Word Bomb Commands ===
| |
| {| class="wikitable"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/wordbomb [bombspeed] [starting_range]</code>
| |
| |Starts a Word Bomb game with up to 16 players.
| |
| |-
| |
| |<code>/wordbomb_stats [visibility]</code>
| |
| |Shows your Word Bomb stats.
| |
| |-
| |
| |<code>/wordbomb_leaderboard [category] [visibility]</code>
| |
| |Server leaderboard for Word Bomb.
| |
| |}
| |
| | |
| === 🤔 Anagram Commands ===
| |
| | |
| {| class="wikitable"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/anagram </code>
| |
| |Starts a private Anagram game in a thread.
| |
| |-
| |
| |<code>/anagram_stats [category] [visibility]</code>
| |
| |Shows your Anagram stats.
| |
| |-
| |
| |<code>/anagram_leaderboard [category] [visibility]</code>
| |
| |Shows leaderboard for Anagram.
| |
| |}
| |
| | |
| === 🧠 Wordle Commands ===
| |
| {| class="wikitable"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/wordle [game_length] [mode] [include_hyphens]</code>
| |
| |Starts a Wordle game in a private thread.
| |
| |-
| |
| |<code>/wordle_stats [visibility]</code>
| |
| |Shows your Wordle win streaks.
| |
| |-
| |
| |<code>/wordle_leaderboard [game_length] [mode] [visibility]</code>
| |
| |Wordle leaderboard.
| |
| |}
| |
| | |
| === 🆙 Leveling & Titles ===
| |
| {| class="wikitable"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/level [visibility]</code>
| |
| |Shows your level and EXP.
| |
| |-
| |
| |<code>/levels_leaderboard [visibility]</code>
| |
| |Level leaderboard.
| |
| |-
| |
| |<code>/set_title [title]</code>
| |
| |Set or clear your title.
| |
| |}
| |
| | |
| === 🛠 Utility & Tools ===
| |
| {| class="wikitable"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>/check [word(s)]</code>
| |
| |Checks dictionary validity.
| |
| |-
| |
| |<code>/characters [words] [private?]</code>
| |
| |Shows character count.
| |
| |-
| |
| |<code>/solve [prompt] [contains?] [exact_length?] [sorting?] [limit?]</code>
| |
| |Advanced word-finder tool.
| |
| |-
| |
| |<code>/server</code>
| |
| |Public invite to the official server.
| |
| |-
| |
| |<code>/dictionaries [dictionary_name]</code>
| |
| |Tracks your usage in themed word lists.
| |
| |-
| |
| |<code>/wordhunt [mode]</code>
| |
| |Personal word challenge. Refreshes every 12 hours.
| |
| |-
| |
| |<code>/suggest [word(s)]</code>
| |
| |Submit new words to the main dictionary.
| |
| |-
| |
| |<code>/define [word]</code>
| |
| |AI-based definition tool.
| |
| |-
| |
| |<code>/toggle_corrections [mode]</code>
| |
| |Toggle auto-correction behaviors.
| |
| |-
| |
| |<code>/config_view</code>
| |
| |Shows server config for AI logs and suggestions.
| |
| |-
| |
| |<code>/wiki</code>
| |
| |Links to this wiki.
| |
| |-
| |
| |<code>/curator_form</code>
| |
| |Link to apply for the Word Curator role.
| |
| |-
| |
| |<code>/help</code>
| |
| |Lists all commands.
| |
| |}
| |
| | |
| == ⚡ Quick Chat Commands (! Prefix) ==
| |
| {| class="wikitable"
| |
| !Command
| |
| !Description
| |
| |-
| |
| |<code>!level</code>
| |
| |Quick level/EXP view.
| |
| |-
| |
| |<code>!titles</code>
| |
| |Opens your unlocked title list.
| |
| |-
| |
| |<code>!status</code>
| |
| |Shows current game stats.
| |
| |-
| |
| |<code>!longest</code>
| |
| |Shows top 5 longest words in the game.
| |
| |-
| |
| |<code>!stratford-upon-avon</code>
| |
| |Secret puzzle answer.
| |
| |-
| |
| |<code>!giza</code>
| |
| |Secret puzzle answer.
| |
| |}
| |
| | |
| == 🎭 AI Summons ==
| |
| Each summon works only in active games, has a cooldown, and some unlock titles.
| |
| {| class="wikitable"
| |
| !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 = silence 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 player Lemonighter
| |
| |-
| |
| |<code>!paster</code>
| |
| |PASTER
| |
| |45%
| |
| |15 min
| |
| |Based on player 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
| |
| |Dev favorite
| |
| |}
| |
| | |
| == ⚙️ Behind the Scenes ==
| |
| | |
| * '''Uptime Manager:''' Kos
| |
| * '''Main Developer:''' Ghost (no_where.ghost_002)
| |
| * '''Admin Support:''' Kos (kos256), GreenyMage (greenymage)
| |
| | |
| ''Super-Shiritori'' began over three years ago using a small curated list from the OMG Community. It later expanded with a bulk import of 320,000 words and ongoing contributions from users. The dictionary now includes:
| |
| | |
| * Over 1,000,000 entries
| |
| * Acronyms
| |
| * User-submitted words
| |
| * Foreign languages
| |
| * Constructed languages (conlangs)
| |
| * Dictionary scraping (Merriam-Webster, Oxford)
| |
| | |
| There is no anti-cheat system. Players are free to use external tools like Google or dictionaries, though playing blind is encouraged for maximum fun and learning.
| |
| | |
| == 🎮 Unique Game Modes ==
| |
| | |
| * '''Multiplayer Shiritori:''' Classic word-chain game with others or AI.
| |
| * '''Solo Shiritori:''' Play privately against adaptive AI.
| |
| * '''Word Bomb:''' Elimination speed game — submit valid words before the bomb explodes.
| |
| * '''Wordle:''' Guess the secret word in 6 or 8 tries. Adjustable length and hyphen rules.
| |
| * '''Dictionary Hunts:''' Complete a 15-word challenge using unused dictionary words.
| |
| | |
| == 👥 Creator & Team ==
| |
| | |
| * '''Main Developer:''' Ghost (no_where.ghost_002)
| |
| * '''Admins/Helpers:''' Kos (kos256), GreenyMage (greenymage)
| |
| | |
| == 📎 Links ==
| |
| | |
| * [https://discord.com/oauth2/authorize?client_id=1309504109308674089 Invite the bot to your server] | |
| * [https://discord.gg/WahVXSkA7H Join the Support Server]
| |
| [[Category:Information]] | | [[Category:Information]] |
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
