# Working with KARA

> What KARA handles automatically, what triggers a moderator ping, and how to respond when one fires.

KARA is the bot that runs inside every active set channel. It reads player messages and replies in the same channel - answering routine questions, surfacing the result-report button, and escalating to a human only when it can't handle something on its own. Most of the time you'll never see it fire; the ping is the exception, not the rule.

As a moderator you don't configure KARA - that's the TO's job (see [organizer/kara](/docs/organizer/kara)). What's worth understanding is what triggers a ping so you know what you're walking into when one arrives.

A player asks for help; KARA pings the moderator role; you reply in the set channel.

## What KARA handles on its own

In a set channel, KARA reads each incoming message and picks a response. It answers basic questions about the set - game, round, best-of, opponent's platform gamertag or cross-play ID - by pulling from the set context. It stays silent on chit-chat between players: "gg", "good luck", "brb" get no response. When a player's message includes an explicit score ("I won 3-2", "ggs that's the set"), KARA posts a _Report this result_ button under that message. The player taps it, selects the score, and the set finalizes. KARA never parses the score itself. Match-level problems - no-shows, scheduling questions, rules disputes - get a `@`-mention of the organizer role. Conduct issues - toxicity, harassment, inappropriate behavior - get a `@`-mention of the moderator role, which is your cue.

KARA also pings the moderator role when a player asks for help in an open-ended way ("can someone help me", "halp") so a human can come in and figure out what they actually need.

## When KARA pings you

The ping arrives as a Discord notification in the set channel, addressed to whichever role the TO has configured for moderators. Read the message that triggered the ping - it's right above KARA's reply - then act.

For a conduct issue, handle it in chat. Warn the player, mute them at the server level if that's appropriate, or move toward a DQ (see [disqualifications](./disqualifications)) if the behavior warrants it. Once you've engaged, players generally direct further messages at you and KARA steps back from the exchange. For something that turns out to be match-level rather than conduct, it's fine to handle it yourself - your moderator permissions cover the same set of actions as the TO's, minus the configuration settings you don't own.

You're a regular Discord user in the set channel. Post freely, react, mute the channel if you need to.

## When KARA pings the TO instead

You'll sometimes see KARA tag the organizer role for things you could handle yourself - a result dispute, a no-show timer. That's by design: KARA routes match-level issues to the TO and conduct issues to moderators. If the TO doesn't respond and you're available, jumping in is fine. Your permissions cover the same actions regardless of which role KARA tagged.

## What players see

The ping is a normal Discord message visible to everyone in the channel. There's no hidden queue. Players who are anxious about being ignored see that help has been summoned - it's a visible signal that someone is on the way.

## FAQ

### Can I scroll back through the set channel to see what KARA has said?

Yes. Set channels are standard Discord channels with full message history. KARA's replies persist alongside player messages.

### Can I correct KARA if it tells a player the wrong thing?

Just reply in the channel as yourself. KARA doesn't try to override human messages, and players will trust the human reply. If you see KARA giving consistently wrong answers about a specific topic, flag it to the TO - they may need to adjust KARA's configuration or update the underlying tournament data.

### When does KARA ping me vs. the TO?

KARA routes conduct issues and open-ended help requests to the moderator role. Match-level issues - no-shows, rules questions, scheduling, result disputes - go to the organizer role. If both roles are the same Discord role on this tournament, you'll see both kinds of pings; the channel context tells you which is which.

### Does the player know KARA pinged me?

Yes. The ping is a visible role mention in the channel - nothing is hidden.

### Can I post in the set channel while KARA is active?

Yes. KARA doesn't take over the channel. Your messages and KARA's coexist, and players treat human messages as authoritative. KARA stops re-engaging when a human has clearly stepped in.

### KARA isn't pinging me in a channel where it should - what's wrong?

Most likely the moderator role isn't configured on the tournament, or you're not in that Discord role. KARA pings whatever role the TO has set up; if no role is configured, the ping is silently dropped. Ask the TO to verify the role wiring.

Source: https://klash.gg/docs/moderator/working-with-kara
