Manual

The Astra Manual

Everything Astra does, explained the way you would explain it to a friend. Quick setup gets you running; this is what to read when you want to know what each part does, how to set it up, and what to check when something looks off.

Brand new here? Do the three steps in Help & Setup first, then come back. Open Help & Setup →
Chapters
  1. 01Permissions & roles
  2. 02Joining the server
  3. 03Protection
  4. 04Moderation
  5. 05Channels, roles & admins
  6. 06Community
  7. 07Commissions & artists
  8. 08Language, updates & your data
  9. 09When something looks off

Permissions & roles

Most "she does not work" problems are a permission or the position of her role. Five minutes here saves a lot of guessing later.

What she asks for when you add her

The Add to Discord button asks for the permissions below. Discord lets whoever adds her untick some of them, and Astra then works only in part. When she joins a server that is missing some, she sends a DM to whoever added her (or to the server owner) listing them.

The permissions, and what each one is for

  • View Channelsto see the channels where I work
  • Send Messagesto answer and post my panels
  • Embed Linksso my panels and replies show up properly
  • Read Message Historyto find my own panels and messages again
  • Manage Messagesto remove spam and scam messages and tidy the verify channel
  • Manage Channelsto create the verify, log and ticket channels
  • Manage Rolesto give the Verified role, level roles and the roles from panels
  • Manage Serverfor raid protection (pausing invites)
  • Kick Membersfor auto-kick and moderation
  • Ban Membersfor moderation and anti-scam
  • Timeout Membersto put members in timeout when needed
  • Create Invitefor server reviews, when the Astra team needs to take a look
  • Use Application Commandsso I can allow my commands where they are needed, like /verify in the verify channel

You can also just give her the Administrator permission, and she will never be missing anything. It is not needed, but it is the simplest if you trust her with the server.

How to turn them on afterwards

Open Server Settings → Roles, pick the role that has her name, and switch on what is missing. You do not need to remove her or add her again.

The position of her role

Discord only lets a bot give roles that sit below its own role. Drag her role above the roles she should hand out (Verified, level rewards, role panels) in Server Settings → Roles. If a role she gives never arrives, this is almost always why.

Who sees her commands

Members can only use app commands (the ones that start with /) if their roles allow Use Application Commands. If @everyone does not have it, nobody sees her commands unless they hold a role that does. Quick setup creates the Verified role with it already on. Some commands are hidden on purpose: the setup ones only show for people who manage the server, and the dashboard's Organize commands button can tidy who sees what.

Who can configure her

At first, only the server's Administrators. To let your moderators in, add their roles under Admin roles in the dashboard (or with the command below). They get her setup commands and nothing else: Admin roles never give a Discord permission.

/config admins addLet a role configure Astra.
/config admins removeTake that away.
/config admins listSee which roles can.
Back to top ↑

Joining the server

The first minutes of a new member: the gate, the welcome, and what happens to people who never finish.

Verification (optional)

Verification is a security tool you choose to use, and you can switch it on or off whenever you like on the Verification page. With it off, Astra asks nothing of new members and they can use her right away. With it on, until someone verifies, they can not talk anywhere else. It works in one step (a Verify button) or in two: press I Agree on the rules, then use /verify in the verify channel, in any order but within two minutes of each other. Anything else typed in that channel is removed with a short note. Quick setup builds a working version for you, and you can change the channels and roles in the Verification page.

/verifyWhat a member uses to verify.
/config verificationChannels, buttons and roles of the gate.

Auto-kick

Members who never finish verifying are removed after the number of days you choose, so the member list does not fill with people who never came in. Off until you turn it on.

18+ access

An optional panel for an 18+ role. Verified members confirm they are 18 or older by typing their birth date, which Astra never stores. Under 18 simply means no role.

Welcome and goodbye

A public welcome message, with an optional card, and a goodbye message, each in the channel you choose. You can write your own text.

/config welcomeWelcome message, channel and card.
/config leaveGoodbye message and channel.
TipTest the gate with a second account before you announce the server. Looking at it as a newcomer shows problems you will not see as an admin.
Back to top ↑

Protection

Quiet protection that works in the background, and the tools your moderators use when something happens.

Anti-raid

When many new accounts join at once, the new ones are held in a timeout, invites can be paused, and your moderators decide with buttons: lock the chat, kick, ban or release them. On by default. You can also start and stop it by hand.

/raid onStart raid mode now.
/raid offEnd it.
/raid statusSee if it is on.

Anti-scam

Catches the classic throwaway scam account: brand new and without an avatar. You choose whether Astra only flags it for the staff or removes it, and how old an account has to be to be trusted.

/config antiscamTurn it on, pick the action and the minimum age.

AutoMod

Discord's own filters (spam, mass mentions, invites to other servers, links, blocked words), set up from the dashboard. They keep working even when Astra is offline. She turns the basic ones on by default when she joins.

Message reports

Members report a message from its menu (Apps → Report message) or with /report. Astra shows the staff what she noticed and suggests what to do, and a moderator decides with one button. She never punishes on her own. Only the staff sees who reported.

/reportReport a message to the staff.

Message logs

Edited and deleted messages are posted to a staff channel with what they said, so a moderator can see what was removed. Astra does not store them anywhere else.

Anti-nuke

If one person deletes several channels or roles, or bans and kicks many members, in a few seconds, Astra takes their powerful roles away, warns the staff channel and messages the server owner. She never bans or kicks anyone, and a moderator can give the roles back. The owner, Astra and the people you trust are never touched. She needs View Audit Log and Manage Roles, and her role must sit above the ones she takes.

/antinuke onTurn it on and pick where the warning goes.
/antinuke offTurn it off.
/antinuke statusSee the limits and who is trusted.
/antinuke limitsChange how many deletes or bans, and how many seconds.
/antinuke trust / untrustPeople who are never acted on.
/antinuke restoreGive a person back the roles that were taken.

Activity log

Pick a staff channel and Astra writes who banned or timed out someone, who changed roles or nicknames, and who created, renamed or deleted channels. You choose which kinds to show. She stores none of it: each event is posted and forgotten. She needs View Audit Log. Edits and deletes of messages have their own log above.

/logs onTurn it on in a channel.
/logs offTurn it off.
/logs eventsChoose which kinds are shown.
/logs statusSee what is on.
Heads upKeep the log channels staff-only. They show things members deleted on purpose.
Back to top ↑

Moderation

Every action is a numbered case with a reason, so nothing depends on someone's memory.

Acting on members

You need the matching Discord permission to use each one. Astra writes the case in the mod log.

/warnGive a warning.
/timeoutMute for a while.
/kickRemove from the server.
/banBan.
/clearDelete recent messages, optionally only from one person.

History and undo

See a member's warnings, clear them, lift a ban or a timeout. The dashboard's Moderation log shows every case and lets you search it.

/mod warningsA member's warnings.
/mod clearwarningsClear them.
/mod unbanLift a ban.
/mod untimeoutEnd a timeout.

Automatic punishments

Choose what happens after a number of warnings (for example a timeout, then a kick) and which channel gets the mod log.

/mod settingsThe log channel and the automatic punishments.

Controlling a channel

Slow a channel down or lock it while things calm down.

/mod slowmodeSet the slow mode.
/mod lockStop members from writing.
/mod unlockLet them write again.
Back to top ↑

Channels, roles & admins

The tools that tidy the server itself, so you do not have to click through Discord's settings.

Channels

See who can see and talk in each channel, fix problems in one click (including the ones that stop Astra from answering), keep channels in step with their category and edit permissions.

Roles and dividers

Create the roles Astra uses (verified, rules, staff) and cosmetic divider roles that group the member list under headings. Dividers have no permissions: they are only labels.

Role panels

A message with buttons or a menu where members pick their own roles: pings, colors, pronouns. Astra can only give roles that sit below her own.

Admin roles

Choose which roles can configure Astra besides the Administrators. Only an Administrator can change this list, so nobody can give themselves more access through her.

TipRun quick setup again any time. It only makes what is missing and checks that what you already have still works.
Back to top ↑

Community

What makes the server feel alive. All of it is optional and each part has its own switch.

Levels

Members earn XP by chatting, with a cooldown so spamming does not help. Levels can give roles, and a daily chat goal can start a double-XP event.

/rankYour level and XP.
/leaderboardThe top members.
/config levelingTurn XP on and set the cooldown and range.
/config level-rolesRoles given at certain levels.
/xpevent startStart an XP event (double or triple).

Economy

Coins from chatting and a daily reward that grows with a streak, a shop that sells your cosmetic roles, transfers, a coin-flip, and random coin drops in the chat. You name the currency.

/dailyClaim the daily reward.
/balanceYour coins.
/paySend coins to someone.
/gambleCoin minigames: coin flip, slots, dice or blackjack.
/duelA coin duel with another member; the winner takes both.
/shop and /buySee and buy what is for sale.
/config economyTurn it on and name the currency.
/shopconfigThe shop and the random events.

Talking to her

She answers when someone says her name, mentions her or replies to one of her messages. With smart replies on she also answers questions about how things work, and in the channels you pick she answers on her own. In those same channels she can start a conversation now and then, in a quiet moment and at most twice a day. The replies run inside Astra herself: nothing is sent to an AI company.

/config funHer replies to her name and mentions.
/config aiThe smart replies.

Your own FAQ

Write the questions people keep asking in your server and Astra answers them, when called or on her own in the help channels you choose.

Starboard, birthdays, YouTube, prompts, giveaways, polls and reminders

Messages with enough stars are reposted in a highlights channel. Members save their birthday (day and month only) and get a happy birthday on the day. New videos from up to five YouTube channels are announced where you choose. And there is a drawing idea whenever someone asks, or a daily one in a channel you choose. Staff can run giveaways with a Join button, a timer and fair random winners, and anyone can ask the server a question with a poll or ask Astra to remind them of something later.

/birthday setSave your birthday.
/birthday nextWho is next.
/promptA random drawing idea.
/giveaway startStart a giveaway (prize, time, winners, optional required role).
/giveaway end / reroll / listEnd one now, draw a new winner, or see the ones running.
/poll createAsk a question with up to 5 options.
/poll endClose a poll and show the result.
/remind addGet a reminder later (like 2h or 1d 12h).

Games, away mode and reputation

Members can play small games, say they are away so people who mention them are told, and thank each other with a reputation point once a day. Nothing from the games is saved, and nobody is ever pinged by them.

/play shipHow well two people match (always the same result for the same two).
/play rateA mark from 0 to 10 for anything.
/play chooseAstra picks one of your options.
/play rpsRock, paper, scissors against Astra.
/play coin / rollFlip a coin or roll dice.
/afk set / offSay you are away (with a reason if you like) or that you are back. It also clears when you write again.
/rep giveGive someone a reputation point (one per day, not yourself, not bots).
/rep viewSee someone's points.

Scheduled messages

Staff can schedule messages to be posted later, once or every day or week. Nothing in them can ping anybody.

/schedule addStaff post a message later, once or repeating every day or week (up to 90 days ahead).
/schedule list / removeSee or cancel the scheduled messages.

Twitch live alerts

Follow up to 5 Twitch channels (here or on the dashboard) and Astra announces in a channel you choose when one goes live, once per stream, with an optional role ping and your own text. The text can include the streamer's name, the title, the game and the link.

/twitch addFollow a channel (name or link) and choose where to announce.
/twitch removeStop following one.
/twitch listSee the followed channels.
Back to top ↑

Commissions & artists

Built for art servers. If yours is not one, you can skip this chapter.

Tickets

A client opens a private ticket with an artist, from the list or straight from the artist's own panel, with the artist's terms and prices in front of them. Set the ticket channel and the category where tickets are created.

/config ticketsThe ticket channel, category and setup category.
/ticketsYour open tickets.

Artists

Register artists one by one, or pick roles whose members count as artists automatically. Each artist gets a private setup channel and edits their own panel.

/artist addRegister an artist.
/artist panelPost an artist's panel with its ticket button.
/config artist-rolesRoles that count as artists.

The artist's own panel

Each artist sets their terms, what they will not do, prices, banner and links, and can open or close commissions. Clients can rate a finished commission, and the staff can act on any rating that breaks the rules.

/panel set-tosTerms of service.
/panel set-priceA price.
/panel previewSee it as a client does.
/slotsHow many commissions you take, or close them.

Portfolios

A portfolio channel for each artist, with new art announced to the people who follow them.

/portfolioYour portfolio channel and follow role.
/artistsBrowse the server's artists.
Back to top ↑

Language, updates & your data

The small things that make her fit your server, and what she keeps.

Language

Astra speaks English or Brazilian Portuguese, set per server. The website has its own language switch at the top. You can also pick the channel where she sends notices meant for the staff.

/config languageThe language she speaks here.
/config logsWhere admin notices go.

Updates

She can post what is new in each of her updates in a channel you choose. Turn it off any time.

/updatesTurn the update notices on or off, or preview one.

Statistics

Joins, leaves, tickets, commissions and moderation over time, for your server only.

Your data

Any member can see everything Astra stores about them, and erase it. Moderation records stay, because they protect the server. The full details are in the Privacy Policy.

/mydata viewSee what she stores about you.
/mydata deleteErase it.

Removing her

Kick her from the server. What she saved about your server is deleted automatically 30 days later, and adding her back before then brings it back as it was.

Back to top ↑

When something looks off

The problems people meet most, and what to check first.

I can not see her commands

Check that your roles (or @everyone) have Use Application Commands. The setup commands also only show for people who manage the server. See "Who sees her commands" in the first chapter.

She does not give the Verified role, or any role

Her role has to sit above the role she gives, and she needs Manage Roles. Drag her role up in Server Settings → Roles.

A button does nothing, or she does not answer in a channel

She needs to see that channel and write in it. The Channels page of the dashboard shows who can see each channel and fixes it in one click.

A member says they are stuck on verification

With two steps, both have to be done within two minutes of each other: I Agree on the rules and /verify in the verify channel. Messages typed in that channel are removed on purpose. If the commands do not show up for them, see the first question.

Astra joined, but with missing permissions

Whoever added her (or the server owner) gets a DM listing what is missing. Turn those on in Server Settings → Roles, on the role with her name.

Nothing I change in the dashboard seems to happen

Check that you picked the right server at the top, that the part you changed is switched on, and that she can see the channel it uses. The dashboard marks parts that need attention.

A new command is not showing up

New commands appear for new servers right away and for older servers after Astra restarts, which takes a few minutes. Reload Discord if it still is not there.

How do I report a problem?

Join the support server (the button at the bottom of this page). Say what you did, what you expected and what happened, and add a screenshot.

Still stuck? Tell the staff what you see and what you expected. A screenshot of the problem helps a lot.
Join the support server →
Back to top ↑