Discord Bots

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, gameplay modes, and word tracking.

🔧 Features

• Interactive word-chain game
• 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 is coded using:

• Programming Language(s): Python
• Libraries/Tools: Discord.py, Google Gemini
• Database: Words.txt
• Hosting Method: Runs on a single old laptop owned by Kos (kos256) that is kept 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 text channel. Posts the rules and a starting word. 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.

---

🔸 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.

---

🧠 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.

---

🆙 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.

---

🛠 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 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
/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.

---

⚡ 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.

---

🎭 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 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 (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)