Want to see whether a dye matches your card? Run adyetest and Keqing makes a preview using your card and Karuta's dye swatch. It works with regular and Mystic dyes, including the glow shown by a Mystic dye.

Free while on beta. Dye Tester is now a public beta available in every server where Keqing is present. You don't need Keqing Premium. Your server's channel settings and the frame's availability still apply.

This only makes a picture. It doesn't spend your dye, apply it to your card or remove the dye you already have. Karuta's actual result can still look different, even on an approved frame.

Choose a dyeChoose a cardPreviewNot approvedCancelled

itsdeiToday at 21:03

adyetest

itsdeiToday at 21:03

kv <dye code>

↳ Replying to itsdei

KarutaAPPToday at 21:03

Dye Details

Mystic dye · ice blue sample

itsdeiToday at 21:03

kci lz9phb

↳ Replying to itsdei

KarutaAPPToday at 21:03

Card Details

Owned by @itsdei

lz9phb · ★★★★ · #14043 · ◈2 · Violet Evergarden · Violet Evergarden

Framed with Mirrored Energy

🎨1

↳ Replying to itsdei

KeqingAPPToday at 21:03

Dye preview

lz9phb · Mirrored Energy.
Preview only: Karuta's own result can differ.

Beta · Free while in beta

Try the demo again

Interactive example · owner, wear and approval state are illustrative. Replace the dye placeholder with your dye code in Discord. Custom frames require approval; Proceed is only for the bot developer and superadmins.

#Your first dye preview

Keep all three commands in the same channel. Replace the placeholders with your actual dye and card codes; don't type the angle brackets.

1. Start the tester

   Type adyetest. Keqing asks you to choose a dye.

2. Look up the dye

   Run kv <dye code> yourself. Keqing reads Karuta's Dye Details, then asks for your card.

3. Look up the card

   Run kci <card code> yourself. Keqing reads Karuta's Card Details and uses the frame already on that card.

4. Check the result

   For an approved custom frame with a usable mask, Keqing posts Dye preview. Default edition 1–8 frames can also be used without custom-frame approval. If the frame is not approved or not ready, Keqing explains why instead of showing a preview.

You have two minutes for each missing input. The timer starts again after Keqing accepts the next lookup. Follow the current prompt: running kci while Keqing is asking for kv won't select the card.

The short commands adyet and adyepreview work too. These examples use Keqing's default a prefix; use your server's prefix if it's different.

#Start from a card or dye you already looked up

You don't have to start from scratch. Reply to Karuta's message itself with adyetest, and Keqing keeps that input.

A character lookup (klu) isn't Card Details. This tester needs a specific card, so use kci. To try a different frame on a character first, see the Frame Tester.

#The 🎨 shortcut

Press 🎨 on Karuta's Card Details to open the tester with that card selected, then run kv <dye code> when asked.

The shortcut appears only when the card's frame is approved and Dye Tester is enabled in that channel. This approval check also applies to default edition 1–8 frames for the reaction shortcut. Keqing doesn't add 🎨 to Dye Details or Remove Dye previews; you can still reply to those messages with adyetest.

If 🎨 is missing, reply to Card Details with adyetest to check availability. The command allows default edition 1–8 frames without custom-frame approval, but custom frames still need approval. Neither shortcut guarantees a usable mask is ready.

#Trying a new dye on an already-dyed card

Keqing needs a clean version of the card so the old dye doesn't affect the new preview. Karuta's kdr preview supplies that version without making you remove the dye.

1. Start adyetest and supply the dye and card as usual.
2. When Keqing says Undyed preview needed, run kdr <card code> in the same channel.
3. Leave Karuta's confirmation buttons untouched. Keqing reads the undyed side of the preview and renders the new dye from that image. Your card keeps its current dye.

Use exactly the same card code for kci and kdr. If you changed the card's appearance between the lookups, run both again so their images match.

You can also start by replying to an existing Remove Dye preview with adyetest, then provide the dye and matching Card Details when asked.

↳ Replying to Karuta’s Card Details

itsdeiToday at 21:03

adyetest

Example: Violet Evergarden already has a dye, and you have supplied the new dye with kv.

↳ Replying to itsdei

KeqingAPPToday at 21:03

Undyed preview needed

lz9phb already has a dye. Run Karuta's kdr lz9phb in this channel.
I'll use the undyed side of that preview to apply the new dye. Leave Karuta's confirmation buttons untouched; your card keeps its current dye.

Closes in 2 minutes.

Beta · Free while in beta

Cancel

Simulate receiving the matching kdr

This demo makes no changes to a card. In Discord, leave Karuta's removal confirmation untouched.

#When your frame isn't available yet

Custom frames must be approved for dye previews. If yours isn't approved, Keqing says Frame not approved and names the frame. It doesn't render a card or show a Proceed button to ordinary players. When you start by replying to Card Details, it can stop before asking you to look up the dye.

Default Edition 1–8 frames don't need this custom-frame approval, but Keqing still needs a usable dye mask to render them. If an available frame has no reliable mask, it shows Learning, followed by a short message asking you to try again when a reliable preview is available. Sample counts are not shown.

Try another approved frame or come back once your frame is ready. There is no countdown that automatically makes a frame ready, and a server admin's channel setting doesn't approve it.

↳ Replying to Karuta’s Card Details

itsdeiToday at 21:03

adyetest

Illustrative frame status: an ordinary player tries a custom frame that is unapproved, or approved but missing a usable mask.

↳ Replying to itsdei

KeqingAPPToday at 21:03

Frame not approved

Mirrored Energy hasn't been approved for dye previews yet. Please try again once it's approved.

Beta · Free while in beta

No card preview, sample counts or Proceed button for ordinary players.

#Cancelling a preview

While Keqing is waiting for your dye, card or kdr preview, press the red Cancel button on its message. Only the person who started that tester can cancel it.

The same message changes to Dye preview cancelled, its buttons disappear, and you can run adyetest again in that channel immediately. The bot staff's Proceed prompt also has Cancel. Finished previews and approval notices don't have a Cancel button.

itsdeiToday at 21:03

adyetest

You already have an active preview in this channel and try starting a second one.

↳ Replying to itsdei

KeqingAPPToday at 21:03

Already waiting

Finish your current dye preview in this channel first.

Beta · Free while in beta

#Reading and repeating a preview

The finished message shows your card code, frame name, the chosen dye as a thumbnail and the rendered card. Tester embeds carry the footer Beta · Free while in beta. On an already-dyed card, it also tells you that it used the undyed version from kdr.

Check both the frame colour and, for Mystic dyes, the glow against the card's art. A normal Dye preview is still a preview of Karuta's result; Approximate dye preview adds uncertainty about which frame parts should change.

To compare another dye, run adyetest again or reply to the Card Details with it and look up the next dye. To test the same dye on another card, reply to Dye Details and provide the new card. Each run makes one preview.

Only your own new Karuta lookups fill the tester's prompts. Another player's kv or kci won't take over your session. You can have one active dye preview per channel; finish it or press Cancel before starting another there.

For a closer look at a Mystic dye's colours and glow on their own, see the Dye Extractor, which is a separate Premium feature.

#When it doesn't work

Switch between the examples to see Keqing's reply and what to try next.

No frameWrong kdrkdr imageDye imagePermissionsTimeout

↳ Replying to Karuta’s Card Details

itsdeiToday at 21:03

adyetest

↳ Replying to itsdei

KeqingAPPToday at 21:03

Card has no frame

lz9phb has no frame. Dye previews need a framed card. Run adyetest again, or reply to a card or dye.

Beta · Free while in beta

Use Card Details that identifies a custom frame or a default edition frame. This example illustrates missing frame information.

Keqing needs View Channel, Send Messages, Read Message History, Embed Links and Attach Files in the testing channel. To add the 🎨 shortcut itself, it also needs Add Reactions. If it can't read the replied-to message or send the picture, ask a server admin to check its channel permissions.

#Choosing where Dye Tester works

Server admins can control Dye Tester separately from the other frame tools. This setting covers adyetest and its aliases, the 🎨 shortcut, and whether Keqing adds 🎨 to supported messages. The public beta is free in every server; enabling a channel still does not bypass frame approval.

#In the dashboard

Open your server's Feature restrictions page in the dashboard, then find Dye Tester.

1. Under Disable in channels, select the channels where dye previews should stay off.
2. The chips below the picker show disabled channels. A chip labelled Frame Testers means the restriction comes from that setting.
3. To allow Dye Tester in a listed channel, press its ×. If the channel is disabled under Frame Testers, this creates a Dye Tester exception: frame tools stay off, but dye previews can run there.
4. Press Save changes to apply your choices.

Try the example below: #trading starts restricted by Frame Testers. Remove its chip under Dye Tester to allow dye previews there, or select another channel to disable them.

#In Discord

Use adyetesting with Discord's Manage Server permission. adyetestsettings is an alias.

on and off work instead of enable and disable. You can use a channel ID instead of a mention. To check another channel, run adyetesting inside it; a channel mention on its own isn't valid command syntax.

Example: Frame Testers is off in #trading. Check the inherited status, or set a Dye Tester exception.

itsdeiToday at 21:03

adyetesting disable #trading

↳ Replying to itsdei

KeqingAPPToday at 21:03

Dye Tester

Dye testing is now off in #trading.

Defaults follow Frame Tester until explicitly enabled or disabled. Applies to dyetest and 🎨 reactions. Public beta: free while in beta.

Dye previews stay off here even if Frame Testers is enabled later.

Keqing stops adding 🎨 in this channel. Pressing an existing 🎨 does not open a dye tester.

Without a Dye Tester exception, the channel follows Frame Testers. An explicit disable keeps dye testing off; an explicit enable allows it even when other frame tools are off. Once you set an exception, later Frame Testers changes don't decide Dye Tester's status in that channel.

When dye testing is off, adyetest says Dye testing is off in this channel. Keqing stops adding 🎨, and pressing an existing 🎨 doesn't open the tester.