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.
| Line 1: | Line 1: | ||
== Overview == | == 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, | 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 == | == 🔧 Features == | ||
* Interactive word-chain game | * Interactive word-chain game | ||
* 1 million | * 1 million+ words to use | ||
* Tracks players’ scores and game history | * Tracks players’ scores and game history | ||
* | * Invite AIs to play with you | ||
* Prevents invalid or repeated words | * Prevents invalid or repeated words | ||
* | * Includes Wordle with standardized and difficult modes | ||
* Runs in any Discord server | * Runs in any Discord server | ||
== 💻 How It Works == | == 💻 How It Works == | ||
* '''Programming Language(s):''' Python | * '''Programming Language(s):''' Python | ||
* '''Libraries/Tools:''' Discord.py, Google Gemini | * '''Libraries/Tools:''' Discord.py, Google Gemini | ||
* '''Database:''' shiritori_dict.txt | * '''Database:''' shiritori_dict.txt | ||
* '''Hosting Method:''' Runs on a single old laptop owned by Kos (kos256) | * '''Hosting Method:''' Runs on a single old laptop owned by Kos (kos256), kept running 24/7 (usually) | ||
== 🧩 Bot Commands == | == 🧩 Bot Commands == | ||
=== | === 🟦 Multiplayer Shiritori Commands === | ||
{| class=" | {| class="wikitable" | ||
!Command | !Command | ||
!Description | !Description | ||
|- | |- | ||
|<code>/startshiritori [#channel]</code> | |<code>/startshiritori [#channel]</code> | ||
|Admin/Mod only (requires "Manage Messages" or Bot Owner). Starts a new | |Admin/Mod only (requires "Manage Messages" or Bot Owner). Starts a new multiplayer game in the chosen channel. | ||
|- | |- | ||
|<code>/endshiritori</code> | |<code>/endshiritori</code> | ||
| | |Ends the current game and shows final stats. | ||
|- | |- | ||
|<code>/invite_ai</code> | |<code>/invite_ai</code> | ||
|Adds an AI opponent with a random personality | |Adds an AI opponent with a random personality. | ||
|- | |- | ||
|<code>/leaderboard [category] [visibility]</code> | |<code>/leaderboard [category] [visibility]</code> | ||
| | |Server leaderboard by category (e.g. Longest Word, Hyphens, etc.). | ||
|- | |- | ||
|<code>/mystats [visibility]</code> | |<code>/mystats [visibility]</code> | ||
|Shows your | |Shows your multiplayer stats. | ||
|- | |||
|<code>/restoregames</code> | |||
|Restores saved games after a shutdown. | |||
|} | |} | ||
=== | === 🟨 Solo Shiritori Commands === | ||
{| class=" | {| class="wikitable" | ||
!Command | !Command | ||
!Description | !Description | ||
|- | |- | ||
|<code>/soloshiritori</code> | |<code>/soloshiritori</code> | ||
|Starts a | |Starts a solo game in a private thread. | ||
|- | |- | ||
|<code>/solostats [visibility]</code> | |<code>/solostats [visibility]</code> | ||
|Shows your solo stats | |Shows your solo stats. | ||
|- | |- | ||
|<code>/sololeaderboard [sort_by] [visibility]</code> | |<code>/sololeaderboard [sort_by] [visibility]</code> | ||
|Global solo leaderboard | |Global solo leaderboard. | ||
|} | |} | ||
=== 💣 Word Bomb Commands === | === 💣 Word Bomb Commands === | ||
{| class=" | {| class="wikitable" | ||
!Command | !Command | ||
!Description | !Description | ||
|- | |- | ||
|<code>/wordbomb [bombspeed] [starting_range]</code> | |<code>/wordbomb [bombspeed] [starting_range]</code> | ||
|Starts a | |Starts a Word Bomb game with up to 16 players. | ||
|- | |- | ||
|<code>/wordbombstats [visibility]</code> | |<code>/wordbombstats [visibility]</code> | ||
|Shows your | |Shows your Word Bomb stats. | ||
|- | |- | ||
|<code>/wordbombleaderboard [category] [visibility]</code> | |<code>/wordbombleaderboard [category] [visibility]</code> | ||
| | |Server leaderboard for Word Bomb. | ||
|} | |} | ||
=== 🧠 Wordle Commands === | === 🧠 Wordle Commands === | ||
{| class=" | {| class="wikitable" | ||
!Command | !Command | ||
!Description | !Description | ||
|- | |- | ||
|<code>/wordle [game_length] [mode] [include_hyphens]</code> | |<code>/wordle [game_length] [mode] [include_hyphens]</code> | ||
|Starts a | |Starts a Wordle game in a private thread. | ||
|- | |- | ||
|<code>/wordlestats [visibility]</code> | |<code>/wordlestats [visibility]</code> | ||
| | |Shows your Wordle win streaks. | ||
|- | |- | ||
|<code>/wordleleaderboard [game_length] [mode] [visibility]</code> | |<code>/wordleleaderboard [game_length] [mode] [visibility]</code> | ||
| | |Wordle leaderboard. | ||
|} | |} | ||
=== 🆙 Leveling & Titles === | === 🆙 Leveling & Titles === | ||
{| class=" | {| class="wikitable" | ||
!Command | !Command | ||
!Description | !Description | ||
|- | |- | ||
|<code>/level [visibility]</code> | |<code>/level [visibility]</code> | ||
|Shows your level | |Shows your level and EXP. | ||
|- | |- | ||
|<code>/levelsleaderboard [visibility]</code> | |<code>/levelsleaderboard [visibility]</code> | ||
| | |Level leaderboard. | ||
|- | |- | ||
|<code>/set_title [title]</code> | |<code>/set_title [title]</code> | ||
| | |Set or clear your title. | ||
|} | |} | ||
=== 🛠 Utility & Tools === | === 🛠 Utility & Tools === | ||
{| class=" | {| class="wikitable" | ||
!Command | !Command | ||
!Description | !Description | ||
|- | |- | ||
|<code>/check [word(s)]</code> | |<code>/check [word(s)]</code> | ||
| | |Checks dictionary validity. | ||
|- | |- | ||
|<code>/characters [words] [private?]</code> | |<code>/characters [words] [private?]</code> | ||
|Shows character count | |Shows character count. | ||
|- | |- | ||
|<code>/solve [prompt] [contains?] [exact_length?] [sorting?] [limit?]</code> | |<code>/solve [prompt] [contains?] [exact_length?] [sorting?] [limit?]</code> | ||
| | |Advanced word-finder tool. | ||
|- | |- | ||
|/server | |<code>/server</code> | ||
| | |Public invite to the official server. | ||
|- | |- | ||
|<code>/dictionaries [dictionary_name]</code> | |<code>/dictionaries [dictionary_name]</code> | ||
| | |Tracks your usage in themed word lists. | ||
|- | |- | ||
|<code>/wordhunt [mode]</code> | |<code>/wordhunt [mode]</code> | ||
| | |Personal word challenge. Refreshes every 12 hours. | ||
|- | |- | ||
|<code>/suggest [word(s)]</code> | |<code>/suggest [word(s)]</code> | ||
| | |Submit new words to the main dictionary. | ||
|- | |- | ||
|<code>/define [word]</code> | |<code>/define [word]</code> | ||
|AI- | |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=" | {| class="wikitable" | ||
!Command | !Command | ||
!Description | !Description | ||
|- | |- | ||
|<code>!level</code> | |<code>!level</code> | ||
|Quick | |Quick level/EXP view. | ||
|- | |- | ||
|<code>!titles</code> | |<code>!titles</code> | ||
|Opens your title | |Opens your unlocked title list. | ||
|- | |- | ||
|<code>!status</code> | |<code>!status</code> | ||
| | |Shows current game stats. | ||
|- | |- | ||
|<code>!longest</code> | |<code>!longest</code> | ||
| | |Shows top 5 longest words in the game. | ||
|- | |- | ||
|!stratford-upon-avon | |<code>!stratford-upon-avon</code> | ||
| | |Secret puzzle answer. | ||
|- | |- | ||
|!giza | |<code>!giza</code> | ||
| | |Secret puzzle answer. | ||
|} | |} | ||
== 🎭 AI Summons == | |||
Each has a cooldown and | Each summon works only in active games, has a cooldown, and some unlock titles. | ||
{| class=" | {| class="wikitable" | ||
!Command | !Command | ||
!AI Summoned | !AI Summoned | ||
| Line 181: | Line 189: | ||
|20% | |20% | ||
|10 min | |10 min | ||
|Unlocks | |Unlocks "Sniper's Mark" title | ||
|- | |- | ||
|<code>!assassin</code> | |<code>!assassin</code> | ||
| Line 187: | Line 195: | ||
|40% | |40% | ||
|15 min | |15 min | ||
|Fail | |Fail = silence 30 turns; success = "Assassin's Ally" title | ||
|- | |- | ||
|<code>!noob</code> | |<code>!noob</code> | ||
| Line 193: | Line 201: | ||
|100% | |100% | ||
|1 min | |1 min | ||
|N/ | |N/A | ||
|- | |- | ||
|<code>!rookie</code> | |<code>!rookie</code> | ||
| Line 199: | Line 207: | ||
|85% | |85% | ||
|2 min | |2 min | ||
|N/ | |N/A | ||
|- | |- | ||
|<code>!average</code> | |<code>!average</code> | ||
| Line 205: | Line 213: | ||
|75% | |75% | ||
|3 min | |3 min | ||
|N/ | |N/A | ||
|- | |- | ||
|<code>!pro</code> | |<code>!pro</code> | ||
| Line 211: | Line 219: | ||
|50% | |50% | ||
|10 min | |10 min | ||
|N/ | |N/A | ||
|- | |- | ||
|<code>!voweless</code> | |<code>!voweless</code> | ||
| Line 217: | Line 225: | ||
|50% | |50% | ||
|15 min | |15 min | ||
|Based on | |Based on player Lemonighter | ||
|- | |- | ||
|<code>!paster</code> | |<code>!paster</code> | ||
| Line 223: | Line 231: | ||
|45% | |45% | ||
|15 min | |15 min | ||
|Based on | |Based on player SUSSY (puperpupey) | ||
|- | |- | ||
|<code>!numbers</code> | |<code>!numbers</code> | ||
| Line 229: | Line 237: | ||
|50% | |50% | ||
|15 min | |15 min | ||
|N/ | |N/A | ||
|- | |- | ||
|<code>!palindrome</code> | |<code>!palindrome</code> | ||
| Line 235: | Line 243: | ||
|45% | |45% | ||
|15 min | |15 min | ||
|N/ | |N/A | ||
|- | |- | ||
|<code>!minimal</code> | |<code>!minimal</code> | ||
| Line 241: | Line 249: | ||
|50% | |50% | ||
|15 min | |15 min | ||
|N/ | |N/A | ||
|- | |- | ||
|<code>!mimic</code> | |<code>!mimic</code> | ||
| Line 247: | Line 255: | ||
|40% | |40% | ||
|16 min | |16 min | ||
| | |Dev favorite | ||
|} | |} | ||
== ⚙️ Behind the Scenes == | == ⚙️ Behind the Scenes == | ||
* '''Uptime Manager:''' Kos | * '''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 == | == 👥 Creator & Team == | ||
* '''Main Developer:''' | * '''Main Developer:''' Ghost (no_where.ghost_002) | ||
* '''Admins/Helpers:''' | * '''Admins/Helpers:''' Kos (kos256), GreenyMage (greenymage) | ||
== 📎 Links == | == 📎 Links == | ||
* https://discord.com/oauth2/authorize?client_id=1309504109308674089 | * [https://discord.com/oauth2/authorize?client_id=1309504109308674089 Invite the bot to your server] | ||
* [https://discord.gg/WahVXSkA7H Join the Support Server] | |||
Revision as of 07:05, 10 July 2025
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
- 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
- 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), kept running 24/7 (usually)
🧩 Bot Commands
🟦 Multiplayer Shiritori Commands
| Command | Description |
|---|---|
/startshiritori [#channel]
|
Admin/Mod only (requires "Manage Messages" or Bot Owner). Starts a new multiplayer game in the chosen channel. |
/endshiritori
|
Ends the current game and shows final stats. |
/invite_ai
|
Adds an AI opponent with a random personality. |
/leaderboard [category] [visibility]
|
Server leaderboard by category (e.g. Longest Word, Hyphens, etc.). |
/mystats [visibility]
|
Shows your multiplayer stats. |
/restoregames
|
Restores saved games after a shutdown. |
🟨 Solo Shiritori Commands
| Command | Description |
|---|---|
/soloshiritori
|
Starts a solo game in a private thread. |
/solostats [visibility]
|
Shows your solo stats. |
/sololeaderboard [sort_by] [visibility]
|
Global solo leaderboard. |
💣 Word Bomb Commands
| Command | Description |
|---|---|
/wordbomb [bombspeed] [starting_range]
|
Starts a Word Bomb game with up to 16 players. |
/wordbombstats [visibility]
|
Shows your Word Bomb stats. |
/wordbombleaderboard [category] [visibility]
|
Server leaderboard for Word Bomb. |
🧠 Wordle Commands
| Command | Description |
|---|---|
/wordle [game_length] [mode] [include_hyphens]
|
Starts a Wordle game in a private thread. |
/wordlestats [visibility]
|
Shows your Wordle win streaks. |
/wordleleaderboard [game_length] [mode] [visibility]
|
Wordle leaderboard. |
🆙 Leveling & Titles
| Command | Description |
|---|---|
/level [visibility]
|
Shows your level and EXP. |
/levelsleaderboard [visibility]
|
Level leaderboard. |
/set_title [title]
|
Set or clear your title. |
🛠 Utility & Tools
| Command | Description |
|---|---|
/check [word(s)]
|
Checks dictionary validity. |
/characters [words] [private?]
|
Shows character count. |
/solve [prompt] [contains?] [exact_length?] [sorting?] [limit?]
|
Advanced word-finder tool. |
/server
|
Public invite to the official server. |
/dictionaries [dictionary_name]
|
Tracks your usage in themed word lists. |
/wordhunt [mode]
|
Personal word challenge. Refreshes every 12 hours. |
/suggest [word(s)]
|
Submit new words to the main dictionary. |
/define [word]
|
AI-based definition tool. |
/toggle_corrections [mode]
|
Toggle auto-correction behaviors. |
/config_view
|
Shows server config for AI logs and suggestions. |
/wiki
|
Links to this wiki. |
/curator_form
|
Link to apply for the Word Curator role. |
/help
|
Lists all commands. |
⚡ Quick Chat Commands (! Prefix)
| Command | Description |
|---|---|
!level
|
Quick level/EXP view. |
!titles
|
Opens your unlocked title list. |
!status
|
Shows current game stats. |
!longest
|
Shows top 5 longest words in the game. |
!stratford-upon-avon
|
Secret puzzle answer. |
!giza
|
Secret puzzle answer. |
🎭 AI Summons
Each summon works only in active games, has a cooldown, and 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 = silence 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 player Lemonighter |
!paster
|
PASTER | 45% | 15 min | Based on player 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 | 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)
