Kharat Bot Docs

FAQ

Straight answers to the questions we hear most — including the features Kharat deliberately does not have.

Is Kharat free?#

Yes. Every module, the dashboard, custom commands and the marketplace are free.

Does Kharat have command cooldowns?#

No. There is no cooldown system. If you need rate limits around your commands, KAL's RATE <key> LIMIT <n> WITHIN <ms> { … } gives you exactly that inside your own scripts.

Is there a welcome feature?#

No native welcome module exists — member joins are only processed by the invite tracker. Build your own greeting with a custom command:

kal
KAL VERSION 2.0;
AUTOMATION welcome_greeter {

    CONFIG {
        greet_channel: CHANNEL [
            label: "Greeting channel",
            description: "Where greetings are posted",
            required: true
        ];
    }

    WHEN EVENT member_join {
        SEND MESSAGE "Welcome, " + member.mention + "!" TO config.greet_channel;
    }
}

Where are warn, purge or poll commands?#

They do not exist. Moderation covers ban, kick, timeout, unmute and the gulag role. There is also no moderation case history — actions are logged as Discord embeds to your log channel, and that is the record.

Does the security module stop raids?#

No. Security does exactly two things: deletes invite links and times out spammers (thresholds and exemptions in Security). There is no raid detection, no mass-join protection, no nuke protection.

Can KAL send DMs?#

No. There are no DM actions in KAL v2 — messages go to channels, interaction replies and follows-ups. There is also no WAIT/SLEEP; delayed work uses SCHEDULE AFTER.

How do I change the prefix?#

,cgprefix <prefix> (Administrator). 1–5 characters, no spaces. ,prefix shows the current one. Slash commands are unaffected.

Who can open the dashboard?#

Only a server's owner and members with Administrator. Manage Server is not enough. See Account & access.

Can I use the dashboard while the bot is offline?#

You can look, but you cannot save — every save is applied by the bot and the dashboard fails closed with bot_unavailable when it cannot reach it.

What happens to my scripts if the bot restarts?#

Compiled scripts are re-registered automatically, and their durable state survives. Nothing to do.

I found a bug — where do I report it?#

Through the support page: describe the command, what you expected and what happened. For KAL problems, include the compiler diagnostic (code, line, column, hint).

Where do the KAL examples in these docs come from?#

Every ```kal example is compiled against the real KAL v2 compiler as part of this site's test suite. If an example stopped compiling, the docs build fails — so the examples you copy are the examples that build.