ア キ ラ - Documentation

Meet Akira

Your server's personal card collecting companion - built for the shows you actually watch.

Akira Bot  ·  v0.0.1
Documentation  ·  v0.0.1
Getting started
1
What is Akira?
A curated, cosy card bot for friend groups - Karuta-adjacent without the coldness.
2
Your first card
React on a drop, say hi to Akira, and welcome the card into your binder.
3
Importing from Karuta
Bring a k!spreadsheet CSV and Akira will match what she can from her pool.
WebUI

Akira's browser app sits alongside Discord: two sign-in paths (embedded vs normal browser), then collection, economy & leaderboard, and admin when your account allows. Feature depth is still growing - those pages say what exists today.

1
Authentication
Discord Activity auto-sign-in vs browser username, DM code, and optional WebUI-only password.
2
Collection
Grid and card viewer from Home - filters and search are not built yet.
3
Economy
Shop, the server pot, milestones, and prestige. The same actions as the bot.

The WebUI is hosted by your server - use the URL your admin configures (separate from this documentation site).

Economy & progression
🪙
Bits
Earned from grabs, daily, and burns. Spent on a personal buff, or given to the server pot.
🎲
Server buff pool
Give bits to a shared pot. At midnight, 500 or more becomes a buff for the whole server.
🏅
Personal milestones
Only pool gifts fill the bar. Each step costs twice the last and pays a little back.
✨
Prestige
Optional after milestone 5. The bar resets. Steps past 5 leave a small permanent percent, and a later prestige adds to it.
Commands

Text commands start with a. The command list has every command, its parameters, and its aliases. Grab is a reaction, not a slash command.

All commands
Parameters and aliases. Dye and import are the commands that are not finished.
↗
/drop
Cards in the drop channel. Usually three. Alias d.
↗
Grab
React 1️⃣ 2️⃣ or 3️⃣ on a drop. A fourth card takes 4️⃣. There is no /grab.
↗
/view
Open a card by its code. Bare av opens the last grab.
↗
/collection
List owned cards. Aliases c and col.
↗
/lookup
Search characters, then swap editions. Aliases lu, search, find.
↗
/wishlist
Watch a character and get mentioned on the drop. Aliases wl, wa, wr.
↗
/burn
Destroy one of your cards for bits. Alias b.
↗
/daily
100 bits, plus any passive bonus, every 24 hours.
↗
/cooldowns
Grab, drop, and daily timers. Aliases cd and timers.
↗
/reminders
DM when daily, drop, or grab is ready. Aliases rm and remind.
↗
/frame
Server default frame, or a frame on one card.
↗
/userinfo
Bits, cards, and prestige. Aliases ui and whois.
↗
Contributing
💻
Code
Help build the bot and WebUI by setting up the repo locally and opening a PR.
📝
Documentation
Improve this website by fixing typos, expanding guides, or writing new sections.
🖼️
Series & additions
Pull a show from AniList with the portraits scripts, then load it into the drop pool.