Kharat Bot Docs

Module configuration

Field-by-field reference for the moderation, logging, tickets, security and server stats configuration pages.

Each configuration page saves through the bot and fails closed when the bot is offline. Field limits below are enforced server-side; the form shows the same bounds.

Moderation#

FieldTypePurpose
Gulag roleroleThe role ,gulag assigns and ,forgive removes
Gulag log channelchannelWhere gulag/forgive actions are logged

The same values can be set with ,gulagrole and ,gulagchannelid (Administrator required).

Logging#

FieldTypePurpose
Log channeltext/announcement channelDestination for every enabled event
Event checkboxes12 togglesWhich events are logged

The twelve events: message deleted, message edited, channel created, channel deleted, role created, role deleted, member banned, member unbanned, ticket opened, ticket closed, ticket reopened, moderation action. When a channel is set, an event with no explicit toggle is treated as enabled. Full details in Logging.

Tickets#

Behaviour

FieldBoundsPurpose
Ticket categorychannel categoryWhere ticket channels are created
Support rolesmax 10Roles that can claim and manage tickets
Log channelchannelPanels, transcripts and ticket events are posted here
Max open per user1–5Concurrent ticket limit
Ticket name prefix≀20 charsChannel name prefix
Naming format4 optionsnumber, username, username-number, department-number
Allow user closetoggleWhether creators can close their own tickets
Claiming enabledtoggleShow claim/unclaim controls
Transcripts enabledtoggleGenerate a transcript on delete

Panel appearance

FieldBoundsDefault
Title≀100 chars🎫 Support Ticket
Description≀2000 charsClick the button below to open a support ticket.
Color≀10 chars#FFFEB6
Button label≀80 charsOpen Ticket
Button emoji≀30 chars🎫
Button stylePrimary / Secondary / Success / DangerPrimary
Thumbnail / Image≀500 chars (URL)empty
Footer≀200 charsempty

Departments (optional, up to 10): each has a label (≀60), short id (≀32), optional emoji, description (≀120), its own category and up to 5 extra support roles. Panels with departments render one button per department β€” or a select menu when there are more than five.

See Tickets for the runtime flow.

Security#

FieldBoundsDefault
Anti-invitetoggleoff
Anti-spam enabledtoggleoff
Spam threshold3–30 messages5
Spam window2–60 seconds5
Spam timeout10–86400 seconds60
Exempt rolesmax 25empty
Exempt channelsmax 25empty

Details and bypass rules: Security.

Server Stats#

Organised in tabs β€” overview, channels, activity, members, settings.

FieldBoundsDefault
Statistic channelsmax 20β€”
Statistic keyone of 9 keysβ€”
Template≀120 chars, must contain {value}{emoji} {label}: {value}
Number formatplain / comma / compact / paddedcomma
Prefix / suffix / emoji / label≀12 / ≀12 / ≀16 / ≀40 charsempty
Activity rulesmax 20β€”
Activity typemessages / voice minutes / days activeβ€”
Activity threshold1–1,000,000β€”
Activity window1–90 days30
Update interval10–1440 minutes10
Track messages / voicetoggleson
Retention7–365 days90
Ignored channels / rolesid listsempty

The nine statistic keys: members, boosts, channels, text channels, voice channels, categories, roles, open tickets, closed tickets. Behaviour details: Server statistics.

Invite Tracker (inside the utility module)#

FieldPurpose
Log channelOptional join/leave/invite log
Fake threshold days0–30; joins younger than this count as "fake" (default 3)
Track vanityWhether vanity-URL joins are attributed

Settings & Permissions pages#

Both are read-only: Settings explains that global bot settings are managed on the main dashboard, and Permissions renders the access rules configured for the server (see Server permissions).