Yotsu Documentation

Welcome to the official feature documentation for Yotsu. Yotsu is a lightweight Discord companion bot specifically built to assist Karuta players with card tracking, calculations, reminders, and daily chores.

Modularity First: Unlike other bots that flood your channels with messages, Yotsu only responds to embeds you specify. All features can be individually turned on or off.

Our Free-Forever Promise

We believe that Discord bot utilities should enhance gaming experiences, not profit off them. Yotsu was built with the promise that every feature is, and always will be, 100% free.

There are no voting requirements, no locked features, and no premium tiers. Server admins and players get full, unlimited access to the entire suite of tools from day one.

Code Extractor

Toggleable

Command Toggle: code_extractor

Manually double-clicking and selecting individual card codes on mobile Discord is notoriously frustrating. Yotsu solves this by listening to card view (kv) and card collection (kc) commands and outputting clean, copy-pasteable strings containing all card codes from the embeds.

Simply tap the code block output on your phone to copy the codes instantly to your clipboard.

Drop Timer Warning

Toggleable

Command Toggle: drop_timer

Card drops in Karuta expire rapidly if unclaimed. If enabled, Yotsu monitors drops and sends an alert warning exactly 10 seconds before the drop expires, ensuring you and your server members never miss another grab.

Worker Effort Calculator

Toggleable

Command Toggle: effort_calculator

Finding the optimal card node assignments can require complex math. When you run worker details (kwi), Yotsu calculates card effort metrics and outputs a clean efficiency profile showing exactly how close your worker is to their maximum potential effort.

Bit & Morph Counter

Toggleable

Command Toggle: bit_counter

When viewing your bit inventory (kbi), Yotsu will run in the background, calculate, and output a summary of your total bits and morph values, saving you the manual calculations.

Daily Quiz Solver

Toggleable

Command Toggle: daily_solver

Karuta features daily bulletin board tasks. Yotsu automatically identifies daily quizzes when the bulletin board (kdaily) is displayed and provides the correct answer immediately, so you never miss out on daily rewards.

Drop Scanning (OCR)

Toggleable

Command Toggle: drop_scanning

Yotsu includes an advanced, built-in OCR (Optical Character Recognition) card scanning engine. When active, it scans card drop images, fuzzy-matches characters and series against our database, and returns card details immediately.

This helps players quickly recognize high-wishlist and high-value cards on drops, even if they aren't familiar with the character name or series.

Server Drop Ping

Toggleable

Command Toggle: server_drop_ping

Whenever a server drop triggers, Yotsu can mention a specific, custom-configured server role (e.g., @ActiveDroppers) to notify collectors that new cards are available to claim.

Server Configuration

Managing Yotsu requires the Manage Server permission. Toggling modules can be done dynamically using standard Discord slash commands.

Command Subcommand / Argument Description
/config show Displays the current configuration and active modules for the server.
/config code_extractor [status: true/false] Enables or disables automatic card code extraction.
/config drop_timer [status: true/false] Enables or disables card drop expiry warning timer.
/config effort_calculator [status: true/false] Enables or disables the worker effort calculator panel.
/config bit_counter [status: true/false] Enables or disables total bit summaries.
/config daily_solver [status: true/false] Enables or disables the daily Bulletin Board solver.
/config drop_scanning [status: true/false] Enables or disables automatic OCR card drop scanning.
/config server_drop_ping [status: true/false] Enables or disables role pings for server drops.

Planned Features & Roadmap

Yotsu is in active development. Below are the planned updates for our next release cycles:

Wishlist Drop Highlights Detect high wishlist cards from drop listings and highlight them with custom icons to help players react faster.
Custom Ping Filters Permit servers to filter drop pings by card edition, print counts, or character ratings.
Custom Ping Conditions Permit servers to filter drop pings by card edition, print counts, or character ratings.