Yotsu Documentation

Copying individual card codes on mobile Discord is frustrating and slow. Code Extractor monitors card lookups and collections, automatically outputting clean, copy-pasteable blocks with the exact card code.

Supported Triggers:

• k!v or kv — Single card inspection
• k!ci or kci — Detailed card view
• k!c or kc — Multi-card collection pages

Simply tap the codeblock output on mobile to copy the code directly to your clipboard for instant trading, tagging, or grabbing.

Karuta's daily bulletin board (kdaily) rewards players for answering anime trivia questions. Yotsu listens for bulletin board embeds, queries our verified quiz database, and immediately replies with the correct answer option.

Never lose your daily streak or forfeit bonus tickets due to unfamiliar anime questions.

In Karuta, many characters are registered under alternate names, nick-names, or original Japanese romaji. The /alias slash command provides instant access to all known aliases for any character in the database.

Highlights & Capabilities:

• Live Autocomplete: As you type into either the name or optional series field, Discord suggestions auto-fill with matching characters and series names.
• Interactive Candidate Selector: If a query matches multiple characters across different series, Yotsu presents an interactive dropdown menu to pick the exact character you want.
• Fuzzy Matching Fallback: If there is a slight typo, Yotsu automatically falls back to intelligent fuzzy search to identify the character.

Karuta card drops expire within a short window if players do not react in time. When Drop Timer is enabled, Yotsu reacts to the drop embed with an hourglass emoji (⏳) and posts a prominent warning alert exactly 10 seconds before expiration, ensuring you and your server members never miss an unclaimed card.

Yotsu incorporates an advanced Optical Character Recognition (OCR) and template-matching pipeline running on a dedicated worker pool. When a card drop occurs (3-card or 4-card), Yotsu analyzes the drop image in parallel and posts a comprehensive breakdown:

1. Print Scanner Recognition

The scanner reads card numbers directly from drop graphics and badges them by print rarity:

2. Wishlist Star Tier Indicators

Card popularity is dynamically resolved against stored wishlist metrics:

• ⭐ Tier 1: 100 – 499 Wishlist
• ⭐⭐ Tier 2: 500 – 999 Wishlist
• 🌟 Tier 3 (High Grail): 1,000+ Wishlist

3. High-Performance Perceptual Hash Cache

Frequent card art and series banners are cached via cryptographic image hashes in SQLite. Common drops evaluate in milliseconds without unnecessary OCR recomputation.

Notifies dedicated droppers whenever a server drop appears. Yotsu automatically maintains a designated server drop role.

Self-Assignment: Server members can type /server_drop_ping at any time to add or remove the role from their profile without needing administrative assistance.

Receive alerts whenever a card from your favorite anime, manga, or gaming series drops in the server!

• Personal 50-Slot Capacity: Every player can track up to 50 distinct series for free.
• Interactive UI Manager: Running /series_wishlist displays a paginated list of your tracked series with search buttons and removal dropdowns.
• Fuzzy OCR Matching: Recognizes series even when OCR encounters minor background distortions or stylized fonts.
• Cross-Server Drop Alerts: Your tracked wishlist follows your Discord account across all servers where Yotsu and Series Wishlist are active.

Track specific grail characters and get pinged the second they drop in any active channel!

• Personal 50-Slot Capacity: Add up to 50 individual characters with zero premium restrictions.
• Interactive Character Search: Search by character name and filter by series to disambiguate characters sharing identical names across different anime.
• Targeted Notifications: Never miss your dream card drop when chatting in other channels or playing games.

Prevent ping fatigue by mentioning members only when truly valuable cards drop! Peak Drop Ping filters server drops against a customizable minimum wishlist threshold (default: 1,000+ WL).

• Customizable Threshold: Server admins configure the exact threshold in /config via the Setup Peak Drop modal.
• Self-Assignment: Members use /peak_drop_ping to toggle the grail hunter role on their profile.
• Server Drop Protection: Ignores low-wishlist cards to ensure mentions remain exciting and meaningful.

Automatically re-route and showcase high-value drops in a dedicated announcement feed (e.g. #peak-drops or #grail-showcase).

• Native Discord Forwarding: Uses Discord's modern message forwarding API with a fallback alert link if permissions restrict native forwards.
• Custom Channel & Threshold: Configured effortlessly inside /config via the Setup Peak Forward modal.
• Channel Loop Safeguard: Automatically skips forwarding if the original card drop occurred inside the target announcement channel itself.

Maxing out worker node productivity is essential for mining bits and gems. When viewing worker details with k!wi or kwi, Yotsu automatically calculates:

• Base toughness, quickness, and vanity formulas.
• Wellness percentage scaling and impact on total yield.
• Style bonus multipliers (frames, dyes, morphs).
• Efficiency profile indicating how close the card is to optimal output.

Managing vast bit inventories across iron, gold, wood, and celestial bits can be tedious. When viewing bit inventories (k!bi / kbi), Yotsu calculates:

• Total accumulated bit counts across all ore and material categories.
• Total available morphs supported by your current bit balances.
• Convenient formatted summaries with comma separation for effortless reading.