Discord Bot · Karuta Companion · 100% Free · Completely Modular

Yotsu

A lightweight, fully modular companion bot for Karuta card collection players. Features 11 powerful modules across 4 categories — 100% free, zero vote locks, and effortlessly configured with an interactive Discord dashboard.

The Yotsu Core Principles

Built from the ground up to respect players and server administrators alike.

💎
100% Free Forever

No voting locks, no paywalled features, and no premium subscription tiers. Server admins and collectors get unlimited access to all 11 modules and 50-slot personal wishlists from day one.

🧩
Completely Modular

Every feature is an isolated module. Turn on only the tools your community needs — from drop timers to high-speed OCR scanning — without unwanted clutter or channel spam.

⚙️
Interactive Dashboard

No complicated syntax or command parameters. Run /config to launch an interactive Discord dashboard with category menus, toggle dropdowns, setup modals, and bulk actions.

All 11 Modules

Each module is independently toggleable per server via the interactive /config dashboard. Requires the Manage Server permission.

Module Category Toggle Key What it does
📦 Utility & QoL
Code Extractor Utility code_extractor Extracts card codes from kv, kci, and kc embeds into a clean, tap-to-copy codeblock for mobile and desktop collectors.
Daily Solver Utility daily_solver Automatically detects Karuta daily quiz questions on kdaily bulletin boards and provides the verified correct answer immediately.
🎲 Drop Helpers
Drop Timer Drops drop_timer Reacts with an hourglass emoji and sends an alert warning exactly 10 seconds before an active card drop expires so you never miss a grab.
Drop Scanning Drops drop_scanning Multi-threaded OCR scanning with print recognition (SPLPMPHP), edition detection, database fuzzy matching, and wishlist star tier badges (100+, 500+, 1000+).
🔔 Drop Alerts
Server Drop Ping Alerts server_drop_ping Mentions a dedicated role whenever a server card drop occurs. Members can self-assign or remove the role anytime using /server_drop_ping.
Series Wishlist Alerts series_wishlist Alerts members when cards from anime or manga series on their personal wishlist drop in the server. Supports up to 50 series per user via /series_wishlist.
Yotsu Wishlist Alerts wishlist Alerts members when specific characters on their personal wishlist drop in the server. Supports up to 50 characters per user via /wishlist.
Peak Drop Ping Alerts peak_drop_ping Pings a configured role whenever a server drop card meets or exceeds the server's minimum wishlist threshold (e.g. 1,000+ WL). Self-assignable via /peak_drop_ping.
Peak Drop Forwarding Alerts peak_drop_forwarding Automatically forwards high-wishlist server drops to a dedicated showcase channel (e.g. #peak-drops) whenever a card meets the wishlist threshold.
📊 Calculators & Stats
Effort Calculator Calculators effort_calculator Calculates expected worker effort, wellness impact, and style bonuses when inspecting worker details with kwi.
Bit Counter Calculators bit_counter Calculates and summarizes total bits and available morph values when inspecting bit inventories with kbi.

Player Slash Commands

In addition to automatic background modules, Yotsu provides interactive slash commands for collectors and administrators.

Command Audience Description
/config Admins Opens the interactive Server Configuration Dashboard with category navigation, feature toggles, setup modals, and bulk actions.
/wishlist Everyone Interactive Character Wishlist Manager. Track up to 50 characters with pagination, character & series search, and cross-server drop alerts.
/series_wishlist Everyone Interactive Series Wishlist Manager. Track up to 50 anime & manga series with pagination and cross-server drop alerts.
/alias Everyone Displays all registered aliases for any character with live Discord autocomplete for both character name and series.
/server_drop_ping Everyone Quickly toggles the Server Drop Ping role on your profile to receive or mute general server drop mentions.
/peak_drop_ping Everyone Quickly toggles the Peak Drop Ping role on your profile to receive or mute high-wishlist grail drop mentions.

Quick Start: Modern Configuration

  1. Invite Yotsu to your Discord server using the Add to Discord button.
  2. In any channel, run /config to launch the interactive dashboard.
  3. Select a category from the navigation dropdown, toggle features on/off, or click Setup Peak Drop / Setup Peak Forward to configure alert thresholds.

Explore deep-dive instructions and advanced options in the Docs & Features guide.