Basic Setup

This guide covers the essential configuration for setting up Card Companion. For more detail on any feature, continue with the tutorials that follow this one.

All server configuration uses the /config command. View your current settings at any time:

/config view

Or open the interactive menu:

/config menu

---

Drop Analysis#

Drop Analysis is the core feature — Card Companion reads Karuta card drops and displays wishlist counts, print numbers, and pog alerts automatically.

Enable drop analysis server-wide:

/config karuta drop_analysis enable_embeds:True

Embed Format#

Choose what information appears in each drop embed. Pass one of these values to /config karuta custom_embed format_type:

---

Date Solver#

The Date Solver automatically solves Karuta daily puzzles and posts answers in a configured channel.

Enable date solving:

/config karuta date_solver enabled:True

Set the channel where answers are posted:

/config karuta date_solver date_channel:#date-channel

---

Drop Pings#

Card Companion can ping roles when special drops occur. There are three ping types.

Event Item Pings#

Ping a role when event items or new edition cards drop:

/config karuta event_item role:@Role enabled:True type:Server Drops Only

The type option accepts Server Drops Only, User Drops Only, or Server and User Drops.

Server Drop Pings#

Ping a role whenever Karuta drops cards in a channel:

/config karuta server_drops role:@Role enabled:True

Pog Drop Pings#

Ping a role when a high-wishlist or low-print card is dropped. Pick a pog_type matching the tier you want to watch:

/config karuta pog_drops pog_type:Single Print pog_role:@Role

Add a custom emoji that appears on pog drops:

/config karuta pog_drops pog_type:Single Print pog_role:@Role pog_emoji:🌸

---

Starboard#

Card Companion automatically reposts standout drops to a dedicated starboard channel. A card is starboarded if its wishlist is at or above wishlist_threshold or its print is at or below print_threshold.

/config karuta starboard channel:#starboard-channel wishlist_threshold:500 print_threshold:999

---

Troubleshooting#

Bot Doesn't Respond#

If Card Companion isn't reacting to drops or dates:

Drop Failures#

Drop processing can occasionally take longer when Discord's API is under load. Most drops are returned within a second. Drop and print reads exceed 99.7% accuracy across all drops — if you spot an incorrect reading, please report it in the support server.

---

Ready for more? Continue with the Custom Embed tutorial to personalise how drop embeds look.