Kharat Bot Docs

What is Kharat Bot?

A modular Discord bot with a web dashboard, custom commands and the KAL v2 automation language — and an honest list of what it does not do.

Kharat Bot is a modular Discord bot with three parts that work together:

  1. The bot — slash and prefix commands organised into toggleable modules, plus event-driven features such as logging, security filters, ticket panels and live server statistics.
  2. The web dashboard — a Discord-connected site where server administrators toggle modules, configure every feature, and manage custom commands.
  3. Custom commands & KAL v2 — a built-in programming language (the Kharat Automation Language) that lets you write your own commands, reactions and scheduled jobs, with a builder, a studio and a community marketplace.

What is included today#

AreaWhat you get
Utility moduleMessage recovery (snipe), persistent reminders, server/user/channel/role lookups, dice and random tools, time zone tools, invite tracking
Moderation moduleBan, kick, timeout, gulag role, module/command switches, prefix change
Tickets modulePanel buttons, departments, claiming, transcripts, log channel
Logging moduleTwelve configurable server event types sent to one log channel
Security moduleAnti-invite link filtering and anti-spam timeouts
Server Stats moduleLive statistic channels, activity roles and a stats overview
Automation moduleKeyword auto responses (up to 20 per server)
Custom commandsYour own slash/prefix commands written in KAL v2, with state and config
MarketplacePublish and install community commands across servers

How the pieces connect#

The website and the bot stay in sync over a websocket. The dashboard is the control surface: every settings change is sent to the bot, which applies it and reports back. If the bot is offline, the dashboard fails closed — it shows your server's last known state, but nothing can be saved until the bot is back.

KAL v2 scripts are compiled to bytecode by the bot before they ever run. Every example in this documentation is compiled against the real compiler, so if a snippet appears in a KAL guide, it builds.

What Kharat does not do#

We document only behaviour that exists in the code. As of this release Kharat has:

  • No native welcome messages — there is no welcome module. Use a custom command with a member_join trigger if you want greetings.
  • No command cooldowns — commands have no built-in cooldown system.
  • No warn, purge or poll commands — moderation covers ban, kick, timeout, unmute and the gulag role only.
  • No moderation case history — moderation actions are logged as Discord embeds; there is no case database.
  • No raid, mass-join or nuke detection — the security module does exactly two things: invite-link filtering and anti-spam.
  • No KAL WAIT/SLEEP or DM actions — scheduled work uses SCHEDULE; messages go to channels and interaction replies, not DMs.

Missing features are not hidden behind planned-language: if a page in this documentation describes something, it exists and works. Anything else simply is not part of the bot yet.

Where to go next#