Bot Documentation

Atlas — All-in-One

Everything a Discord community needs in a single bot: a support desk (tickets, applications, appeals), a full moderation suite with AutoMod, anti-raid and anti-nuke, and the whole community toolkit — leveling, giveaways, events, polls, starboard, suggestions, welcomes and utilities. 63 slash commands, two right-click apps, and a web dashboard.

Atlas replaces roughly five separate bots. If you already run Tickets or Gavel, Atlas covers the same ground plus community features — you don't need all three.

Required permissions

Grant these on invite so every subsystem works without follow-up fixes: Manage Roles (auto-roles, level rewards, reaction roles, anti-nuke role stripping), Manage Channels (ticket channels, locks, slowmode), Kick Members, Ban Members, Moderate Members (timeout), Manage Messages (purge), Manage Nicknames (AdminSaver's rename action), View Audit Log (anti-nuke detection), Manage Threads and Create Private Threads (thread-mode tickets), Read Message History (transcripts and starboard), and Send Messages / Embed Links / Attach Files.

Atlas's role must sit above any role it needs to assign or remove. Auto-roles, level rewards, reaction roles and AdminSaver all fail if the target role is higher than Atlas in your role list — Atlas skips those roles rather than erroring, so the symptom is "nothing happened".

Setup

  1. 1

    Run /setup

    A three-step wizard: staff role tiers, log channels, then which AutoMod filters to switch on. You need Manage Server to run it. A handful of commands — /config, /panels, /mytickets, /staff, /reviews and /merge — wait until setup is done; the rest work for any administrator straight away.

  2. 2

    Set your staff tiers

    Atlas uses three inheriting tiers — Support ⊂ Moderator ⊂ Admin. Support handles tickets, applications and appeals. Moderator adds warns, timeouts, kicks, bans, purges, locks, lockdown and raid mode. Admin adds /setup, /config, panels, protection panels and the web dashboard. Discord's own permissions layer on top and only ever grant more: Administrator or server owner counts as Admin, and Manage Messages or Timeout Members counts as Moderator.

  3. 3

    Route your logs with /logs

    Five destinations, each independent: server events, tickets/applications/appeals (plus transcripts), AutoMod hits, anti-raid and anti-nuke alerts, and member reports. Inside the server-events destination you choose exactly which of the nine events post.

  4. 4

    Create your panels with /panels

    Build support (ticket), application, appeal and custom-embed panels — buttons or a dropdown, custom categories, question sets, ping roles and target channels. The free plan includes a shared pool of 10 panels across all four types.

  5. 5

    Tune protection with /automod and /antiraid

    Ten content filters, each with its own punishment ladder. Six of them — mentions, caps, emoji spam, attachment spam, duplicates and message rate — also take a threshold you can tune; bad words, scam links, invites and links are on-or-off. Anti-raid covers join-rate spikes and account-age gating; anti-nuke watches the audit log for a compromised insider deleting channels or roles en masse.

  6. 6

    Manage everything from the web

    Almost every setting above is also editable at bots.kojinstudios.com/dashboard — with trend charts, hosted transcripts, staff reviews, rank-card artwork and an audit log of who changed what. Changes apply immediately.

The support desk

Four panel types share one builder, one transcript format and one staff-permission model. Every panel you post counts against the same allowance, and /panels lists all of them — of every type — in a single manager.

Tickets

Members open a ticket from a panel; staff claim it with /claim so two people never answer at once. Panels can open a private channel or a thread — thread mode is a per-panel toggle in the builder's advanced step. Closing with /close saves a hosted HTML transcript and DMs it to the member, then asks them to rate the staff member who handled it. Quick responses (/response) and /tag snippets keep replies fast.

Applications

Staff, partner or creator applications with custom question sets. Each panel chooses how answers are collected: DM chat, where Atlas asks the questions one at a time, or a form popup. DM mode falls back to the form automatically if the applicant has DMs closed. Completed submissions post to your review channel with approve/deny buttons and reviewer notes. Up to 25 questions per application on every plan.

Appeals

Ban and punishment appeals get their own panel type and review flow, with a staff priority flag and the same transcript, closing DM and rating prompt as tickets — so appeals never get lost in a general queue.

Custom embeds

The fourth panel type posts a standalone branded embed — rules, an announcement, a links board — built and edited in the same designer as your support panels.

Auto-close sweeps inactive tickets, applications and appeals. It warns first, then closes after a grace period, saving a transcript and DMing the member. Tickets are on by default; applications and appeals are opt-in so a fresh install never closes a pending application. Configure the hours and which types it applies to under /config → Ticket Auto-Close, or on the dashboard. Auto-close is a Premium feature.

Moderation & protection

Manual actions

/warn, /timeout (up to Discord's 28-day maximum), /kick, /ban — which works on people who already left, can delete up to 7 days of their messages, and takes an optional duration for a temp-ban — plus /purge, /slowmode, /lock, /unlock and /lockdown. Every action creates a numbered case you can look up with /case, and /modlogs pages through a member's full history.

/lockdown on locks every text channel at once and /lockdown off lifts it. It's careful in both directions: it skips channels that were already no-send, and on lift it restores only the channels Atlas itself locked — so your announcement channels stay locked. Your Moderator and Admin roles keep talking rights throughout.

AutoMod

Ten filters — bad words, scam/phishing links, invite links, external links, mention spam, excessive caps, fast spam, duplicate text, emoji spam and attachment spam. Each filter has its own thresholds and its own punishment ladder, so mention spam can escalate differently from caps. Whitelisted roles and channels are exempt, and violations expire on a reset window you set. Scam links, invites, mentions, caps, fast spam and duplicate text are on out of the box; the rest are opt-in.

Warden

The shared warning ladder: manual /warn and AutoMod warnings both count toward it. Configure three thresholds and what fires at each step, whether the member is DM'd, and an auto-reset window. Whitelisted roles still have warnings recorded but never auto-escalate. The final step repeats for every warning past it, so someone at maximum warnings can't keep offending consequence-free.

Anti-raid & anti-nuke

Anti-raid watches join velocity (default: 5 joins in 10 seconds) and can separately gate accounts below a minimum age, arming raid mode automatically or on demand with /raidmode. Anti-nuke watches the audit log for one account rapidly deleting channels or roles, mass-banning, mass-kicking or creating webhooks, and can strip that account's roles instantly, ban it, or just alert — the defense that matters when a staff account is compromised. Both are free.

AdminSaver

Impersonation protection. Nominate the staff you want protected and Atlas checks every join and nickname change for a lookalike name, then kicks, bans or renames the impostor. The name-similarity threshold and a per-user whitelist are yours to set. AdminSaver is Premium.

Community & engagement

Leveling & rank cards

XP for chatting, with a configurable range per message (default 15–25), a cooldown, no-XP channels and roles, level-up announcements to the current or a fixed channel, and role rewards that can stack or hand out only the highest. /rank renders an image card; /leaderboard shows the top 10 and tells you where you stand. Rank-card artwork — background image, foreground overlay, accent and text colours — is free, and the dashboard crops uploads to size for you. The free plan includes 15 reward tiers.

Giveaways

/giveaways is a hub, not a form: create, end early, reroll and list from one panel with no message IDs to copy. Entry requirements can include a required role, a minimum account age and a minimum time in your server. Bonus entries for a chosen role are Premium.

Events

/events creates RSVP events with Going / Maybe / Declined buttons, an optional reminder before start, and an option to mirror the event into Discord's native scheduled events. Attendee caps with an auto-promoting waitlist are Premium.

Polls & suggestions

/poll posts a button poll with two to five options, one vote per person, and an optional duration after which it ends and freezes its results by itself. /polls is the admin hub for active polls. /suggest submits a numbered suggestion to the channel you set with /suggestions, where the community votes it up or down and staff approve or deny it.

Starboard, welcomes & reaction roles

/starboard reposts messages that clear a reaction threshold (default: 3 ⭐) into a highlights channel, with your choice of emoji and whether self-stars count. /welcome covers welcome and farewell messages — embed or plain text, in-channel and/or by DM, with a banner image, accent colour and the {user}, {username}, {server} and {count} placeholders — plus auto-roles granted on join. /reactroles builds self-assign role panels as buttons or a dropdown.

Everyday utilities

/tag sends a saved snippet (with autocomplete, and it can be aimed at a member); /tags is the create/delete/list panel. /remindme schedules a reminder by DM or a mention in the channel. /afk answers anyone who pings you. /translate auto-detects the source language. /weather gives current conditions and a three-day forecast, with /setlocation to save your city and /weatheralerts to be DM'd about severe weather. And /userinfo, /serverinfo and /avatar for the usual lookups.

Atlas also adds two right-click apps. Right-click any message → Apps → 🚩 Report Message lets members flag it to the reports channel you set in /logs, with an optional reason. Right-click a member → Apps → User Info is /userinfo without typing.

Command reference

63 slash commands. /help lists them in-Discord, grouped the same way, with Premium features marked.

Setup & admin

/setup

The three-step first-run wizard — staff roles, log channels, AutoMod defaults. Needs Manage Server.

/config

The settings hub: staff roles, log channels, ticket auto-close, quick responses, and links to every protection panel.

/logs

Set all five log destinations and choose which server events post. Admin.

/help

Browse every command by category, with Premium features marked.

/premium

Your plan, what it unlocks, and how to upgrade.

/vote

Your Top.gg vote count and how much premium time it's worth.

/redeem

Turn banked votes into premium time for this server (6 votes minimum).

Tickets & support

/panels

Create and manage support, application, appeal and custom-embed panels — or jump to the web designer. Admin.

/close

Close the current ticket: saves the transcript, DMs it to the member, asks for a rating.

/claim

Claim this ticket, application or appeal so nobody doubles up.

/unclaim

Release it back to the queue.

/transfer

Hand this conversation to another staff member.

/add

Add a member to this ticket, application or appeal.

/remove

Remove a member from it.

/rename

Rename this ticket, application or appeal channel.

/merge

Merge two tickets, two applications or two appeals — the source is closed and deleted.

/response

Send one of your saved quick responses — works inside a ticket, appeal or application channel. Staff only.

/mytickets

Staff see what they've claimed; members see their own open conversations.

/staff

💎 A staff member's handled/resolved counts, star rating and recent reviews.

/reviews

💎 The staff review leaderboard for this server.

Moderation

/warn

Warn a member — feeds the Warden ladder and creates a case. Moderator.

/warnings

List a member's active warnings.

/clearwarnings

Clear all of a member's active warnings.

/timeout

Time a member out for a duration like 10m, 2h or 1d (28-day maximum).

/untimeout

End a timeout early.

/kick

Kick a member, with a DM sent before they leave.

/ban

Ban a user — works if they've left, optionally deletes up to 7 days of messages, and takes a duration for a temp-ban.

/unban

Unban a user (paste their ID if they don't autocomplete).

/purge

Bulk-delete up to 100 recent messages, optionally only one member's.

/slowmode

Set a channel's slowmode — 5s to 6h, or off.

/lock

Lock one channel so @everyone can't send.

/unlock

Unlock a channel locked with /lock.

/lockdown

Lock or unlock every text channel at once — raid response. Skips already-locked channels and only restores its own.

/case

Look up any moderation case by number: action, moderator, target, reason, timestamp.

/modlogs

A member's full moderation history in this server, 8 cases per page.

AutoMod & protection

/automod

The AutoMod panel — toggle the ten filters, tune thresholds, edit each filter's punishment ladder, set whitelists. Admin.

/warden

The shared warning ladder used by both manual warns and AutoMod. Admin.

/antiraid

Join-rate raid detection, raid mode, account-age gating and the anti-nuke panel. Admin.

/raidmode

Arm or disarm raid protection by hand. Moderator.

/adminsaver

💎 Impersonation protection — pick protected staff and what happens to lookalike accounts. Admin.

Community

/giveaways

Create, end, reroll and list giveaways from one hub. Admin.

/events

Create RSVP events with reminders, list what's upcoming, cancel. Admin.

/poll

Post a button poll with 2–5 options and an optional auto-end time.

/polls

Manage active polls and end them early. Admin.

/suggest

Submit a numbered suggestion for the community to vote on.

/suggestions

Set the suggestions channel. Admin.

/starboard

Set the highlights channel, star emoji, threshold and whether self-stars count. Admin.

/welcome

Welcome and farewell messages, banners, DMs and auto-roles. Admin.

/reactroles

Build a self-assign role panel as buttons or a dropdown. Admin.

Leveling

/rank

Your (or someone's) level, XP and server rank as a rendered card.

/leaderboard

The top 10 by XP, plus your own standing if you're not in it.

/leveling

XP rates, cooldown, announcements, no-XP channels and roles, and role rewards. Admin.

Utilities

/tag

Send a saved snippet, optionally aimed at a member. Autocompletes.

/tags

Create, edit, delete and list this server's tags. Moderator.

/remindme

Be reminded after a delay, by DM or a mention in this channel.

/afk

Set yourself AFK with an optional note for anyone who pings you.

/translate

Translate text — the source language is auto-detected.

/weather

Current conditions and a three-day forecast, metric or imperial.

/setlocation

Save your city so /weather works without typing it.

/weatheralerts

Get a DM when severe weather is expected where you are.

/userinfo

A member's account age, join date and roles.

/serverinfo

Member counts, channels, boosts and server age.

/avatar

Show someone's avatar full size.

Free vs Premium

The free plan is genuinely usable: the entire moderation suite, all ten AutoMod filters, anti-raid and anti-nuke, Warden, hosted transcripts, logging, analytics, leveling with rank-card artwork, and every community feature — plus a pool of 10 panels and 15 tags.

Premium is $5/month per server and lifts the caps:

Support desk — unlimited panels instead of the 10-panel pool; 10 categories or application types per panel instead of 5; unlimited open tickets per member instead of 2; 20 quick responses instead of 5; per-panel whitelists and blacklists; emoji-only panel buttons; the per-category auto-responder; ticket auto-close; and the /staff and /reviews staff-performance commands.

Protection — AdminSaver impersonation protection, and Malware Detection, which checks every uploaded file (up to 32 MB) against VirusTotal's ~70 engines and can delete it and punish the uploader.

Community — weighted giveaway entries for a bonus role; event capacity with auto-promoting waitlists; unlimited level reward tiers instead of 15; unlimited tags.

Dashboard — Custom Branding (a per-server nickname, bio, avatar and banner for Atlas itself) and CSV export of your ticket and punishment trends.

You can earn premium without paying: each Top.gg vote is worth 12 hours (24 on weekends). Check your balance with /vote and claim it with /redeem once you have at least 6 votes banked — that's a 3-day minimum redemption.
If premium lapses, nothing is destroyed. Atlas keeps your ten oldest panels and deactivates the rest — their posted message is taken down, but the panel's configuration and every ticket channel stay put, so resubscribing restores them. Reward tiers past the fifteenth stop granting rather than disappearing, and premium-only protection simply switches off.

Web dashboard

At bots.kojinstudios.com/dashboard, pick Atlas and you get 22 pages across five sections. Home — overview, Statistics and Audit Logs. Support — Panels, Transcripts, Reviews and Quick Responses. Setup — Permissions, Logging, Tags, Auto-Close and Custom Branding. Moderation — AutoMod, Warden, Anti-Raid & Nuke and AdminSaver. Community — Welcome & Farewell, Leveling & Rank Card, Starboard, Giveaways, Events and Polls.

Most of it mirrors the slash commands, but some things only the web can do well: 7/14/30/90-day ticket and punishment trend charts, hosted transcripts you can read in a browser, the staff review leaderboard, drag-and-drop rank-card artwork with in-browser cropping, adjusting a member's XP directly, and an audit log naming every change and who made it. Changes apply instantly — no restart, no re-sync. Staff roles set here are also pushed onto your already-open tickets.

A few things live only in Discord, by design: the /setup wizard, the panel builders (the dashboard has its own designer), reaction-role panels, suggestions, reminders, AFK, weather and the right-click report app.