×
Create a new article
Write your page title here:
We currently have 69 articles on Super Shiritori Wiki. Type your article name above or click on one of the titles below and start writing!



Super Shiritori Wiki

Discord Bots: Difference between revisions

Welcome to Super-Shiritori!

Please remember:

  • No vandalism – Do not add nonsense, false info, spam, or blank pages.
  • Respect others – Be polite and assume good faith.
  • Use reliable information – Make sure edits are accurate and IMPORTANT.
  • Stay constructive – Help us grow the wiki with content, especially with the Word compendium.

⚠️ Repeated vandalism or rule-breaking may result in warnings or blocks. If you see vandalism, please revert it and notify an admin.

No edit summary
 
(28 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.


== 🔧 Features ==
This page summarizes what each bot does. For full command lists and mechanics, see each bot's own dedicated page.


* Interactive word-chain game
== Super-Shiritori ==
* 1 million Words to use!
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]].
* 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 ==
''Main article:'' [[Super-Shiritori]]
Super-Shiritori is coded using:


* '''Programming Language(s):''' Python
== Word-Curatori ==
* '''Libraries/Tools:''' Discord.py, Google Gemini
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.
* '''Database:''' shiritori_dict.txt
* '''Hosting Method:''' Runs on a single old laptop owned by Kos (kos256) that is kept 24/7 (usually)
----


== 🧩 Bot Commands ==
''Main article:'' [[Word-Curatori]]


=== 🔹 Multiplayer 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>/startshiritori [#channel]</code>
|Admin/Mod only (requires "Manage Messages" or Bot Owner). Starts a new [[Multiplayer Shiritori|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 ===
''Main article:'' [[Vexitori]]
{| class="fandom-table"
!Command
!Description
|-
|<code>/soloshiritori</code>
|Starts a [[SoloShiritori|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.
|}


=== 💣 Word Bomb Commands ===
== 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>/wordbomb [bombspeed] [starting_range]</code>
[[Category:Information]]
|Starts a [[Word Bomb]] game in the current channel. Players join via buttons. Bomb Speed: Slow, Standard, Fast, Rapid. You can set a starting word bucket (e.g., Guaranteed, Exotic, Mythic). Max 16 players.
|-
|<code>/wordbombstats [visibility]</code>
|Shows your personal Word Bomb stats: games played, wins, turns, average word length, and total characters.
|-
|<code>/wordbombleaderboard [category] [visibility]</code>
|Displays the server Word Bomb leaderboard. Categories: Games Played, Wins, Turns Played, Avg Word Length, Total Characters. Visibility: Public or Private.
|}
 
=== 🧠 Wordle Commands ===
{| 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 ===
{| class="fandom-table"
!Command
!Description
|-
|<code>/level [visibility]</code>
|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.
|-
|/server
|Makes a public invite to the Super Shiritori offical Discord Server the message is:
'''Join the Official Server for Super Shiritori! 🎮'''
 
Hang out with other word game lovers, get bot support, and suggest new features!
 
→ https://discord.gg/WahVXSkA7H
|-
|<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.
|-
|!stratford-upon-avon
|The answer to the first puzzle "The Quillmaster's Path"
|-
|!giza
|The answer to the first puzzle "Rotten & Mummified"
|}
----
 
=== 🎭 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 '''1,000,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.
* '''[[SoloShiritori|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 (Admin)|Kos (kos256)]], GreenyMage(greenymage)
 
== 📎 Links ==
 
* https://discord.com/oauth2/authorize?client_id=1309504109308674089 (Invite link)
 
* https://discord.gg/WahVXSkA7H (Support Server)
 
 
Overview
 
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.
 
🔧 Features
 
Interactive word-chain game
 
1 million 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 is coded using:
 
Programming Language(s): Python
 
Libraries/Tools: Discord.py, Google Gemini
 
Database: shiritori_dict.txt
 
Hosting Method: Runs on a single old laptop owned by Kos (kos256) that is kept 24/7 (usually)
 
🧩 Bot Commands
 
<nowiki>###</nowiki> 🟦 Multiplayer Shiritori Commands
 
| Command | Description |
 
|---------|-------------|
 
| `/startshiritori [#channel]` | Admin/Mod only (requires "Manage Messages" or Bot Owner). Starts a new multiplayer game in the chosen text channel. Only one game per channel. |
 
| `/endshiritori` | Admin/Mod only. Ends the current game and shows final stats: longest words, total words, and dictionary coverage. |
 
| `/invite_ai` | Adds an AI opponent with a random personality (e.g., NOOB, PRO, MIMIC, ASSASSIN). Only one AI per game. |
 
| `/leaderboard [category] [visibility]` | Shows server leaderboard by category: Longest Word, Turns Played, Hyphens, Apostrophes, Dictionary Completion. Visibility: Public or Private. |
 
| `/mystats [visibility]` | Shows your combined multiplayer stats across all servers: longest word, turns, hyphens, apostrophes, and dictionary completion. |
 
| `/restoregames` | Restore Shiritori games saved from last shutdown in this server. |
 
<nowiki>###</nowiki> 🟨 Solo Shiritori Commands
 
| Command | Description |
 
|---------|-------------|
 
| `/soloshiritori` | 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. |
 
| `/solostats [visibility]` | Shows your solo stats: level, longest word, turns played, hyphen/apostrophe use, and dictionary coverage. |
 
| `/sololeaderboard [sort_by] [visibility]` | Global solo leaderboard. Sort by: Longest Word, Turns Played, Dictionary Completion. |
 
<nowiki>###</nowiki> 💣 Word Bomb Commands
 
| Command | Description |
 
|---------|-------------|
 
| `/wordbomb [bombspeed] [starting_range]` | Starts a Word Bomb game in the current channel. Players join via buttons. Bomb Speed: Slow, Standard, Fast, Rapid. You can set a starting word bucket (e.g., Guaranteed, Exotic, Mythic). Max 16 players. |
 
| `/wordbombstats [visibility]` | Shows your personal Word Bomb stats: games played, wins, turns, average word length, and total characters. |
 
| `/wordbombleaderboard [category] [visibility]` | Displays the server Word Bomb leaderboard. Categories: Games Played, Wins, Turns Played, Avg Word Length, Total Characters. Visibility: Public or Private. |
 
<nowiki>###</nowiki> 🧠 Wordle Commands
 
| Command | Description |
 
|---------|-------------|
 
| `/wordle [game_length] [mode] [include_hyphens]` | 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. |
 
| `/wordlestats [visibility]` | Displays your Wordle win streaks by length and mode. |
 
| `/wordleleaderboard [game_length] [mode] [visibility]` | Shows top 10 Wordle players by win streak. Filter by length and mode. |
 
<nowiki>###</nowiki> 🆙 Leveling & Titles
 
| Command | Description |
 
|---------|-------------|
 
| `/level [visibility]` | Shows your level, EXP progress, and next-level goal. |
 
| `/levelsleaderboard [visibility]` | Displays top 10 users by level on this server. |
 
| `/set_title [title]` | Sets your title (visible in leaderboards/stats). You can only use unlocked titles. Use None to clear. Autocomplete supported. |
 
<nowiki>###</nowiki> 🛠 Utility & Tools
 
| Command | Description |
 
|---------|-------------|
 
| `/check [word(s)]` | Validates up to 15 words. Returns ✅ or ❌ based on dictionary presence. |
 
| `/characters [words] [private?]` | Shows character count for up to 20 words. Optionally private. |
 
| `/solve [prompt] [contains?] [exact_length?] [sorting?] [limit?]` | Word-finder tool. Filters by starting letters, length, and sorting (longest/shortest). Limit: 1–500 results. |
 
| `/server` | Makes a public invite to the Super Shiritori official Discord Server. |
 
| `/dictionaries [dictionary_name]` | Checks which words you've used from special lists (e.g., Blacklist, Phobias, Ologies, Numbers). |
 
| `/wordhunt [mode]` | Generates a personal challenge of 15 unused words. Modes: Multiplayer or Solo Hunt. Refreshes after 12h or completion. |
 
| `/suggest [word(s)]` | Suggests 1–1001 new words for the main dictionary. Gives feedback on duplicates/invalid entries. |
 
| `/define [word]` | AI-assisted definition with pronunciation. Not guaranteed accurate—based on common usage. |
 
| `/toggle_corrections [mode]` | Toggle Shiritori correction warnings and deletions for this server. |
 
| `/config_view` | Configure Sniper AI event logging and word suggestion notifications for this server. |
 
| `/wiki` | Get the link to the Super Shiritori Wiki. |
 
| `/curator_form` | Get the Word Curator Assessment Form. |
 
| `/help` | Show a list of all bot commands and their usage. |
 
---
 
⚡ Quick Chat Commands (!)
 
| Command | Description |
 
|---------|-------------|
 
| `!level` | Quick, private level and EXP display (same as /level). |
 
| `!titles` | Opens your title overview. |
 
| `!status` | (Game channel only) — Shows current Shiritori stats, average word length, and next starting letter. |
 
| `!longest` | (Game channel only) — Shows top 5 longest words in the current game and who played them. |
 
| `!stratford-upon-avon` | The answer to the first puzzle "The Quillmaster's Path" |
 
| `!giza` | The answer to the first puzzle "Rotten & Mummified" |
 
<nowiki>###</nowiki> 🎭 AI Summons (Game Channel Only)
 
Each has a cooldown and summon chance. Some unlock titles.
 
| Command | AI Summoned | Success Rate | Cooldown | Notes |
 
|---------|-------------|--------------|----------|-------|
 
| `!snipe` | Sniper | 20% | 10 min | Unlocks Sniper's Mark title |
 
| `!assassin` | Assassin | 40% | 15 min | Fail: silenced 30 turns. Success: Assassin's Ally title |
 
| `!noob` | NOOB | 100% | 1 min | N/a |
 
| `!rookie` | ROOKIE | 85% | 2 min | N/a |
 
| `!average` | AVERAGE | 75% | 3 min | N/a |
 
| `!pro` | PRO | 50% | 10 min | N/a |
 
| `!voweless` | VOWELLESS | 50% | 15 min | Based on a real player known as Lemonighter (lemonighter) |
 
| `!paster` | PASTER | 45% | 15 min | Based on a real player known as SUSSY (puperpupey) |
 
| `!numbers` | NUMBERPHILE | 50% | 15 min | N/a |
 
| `!palindrome` | PALINDROMIC | 45% | 15 min | N/a |
 
| `!minimal` | MINIMALIST | 50% | 15 min | N/a |
 
| `!mimic` | MIMIC | 40% | 16 min | Bot Owner's 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 1,000,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.
 
- **Word Bomb:** Fast-paced elimination game where players must quickly submit valid words before the bomb explodes. Multiple speeds and word buckets.
 
- **Wordle:** Guess the secret word in 6 or 8 tries. Supports custom word lengths, modes, and hyphen toggling.
 
- **Dictionary Hunts:** Complete personal challenges to find unused words from the massive dictionary. Modes for solo and multiplayer.
 
👥 Creator & Team
 
Main Developer: Ghost (no_where.ghost_002)
 
Admins/Helpers: Kos (kos256), GreenyMage(greenymage)
 
📎 Links
 
<nowiki>https://discord.com/oauth2/authorize?client_id=1309504109308674089</nowiki> (Invite link)
 
<nowiki>https://discord.gg/WahVXSkA7H</nowiki> (Support Server)

Latest revision as of 06:45, 21 August 2026

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