AstraMaster (also written “Astra Master”) is a Discord security bot. It protects servers from nukes, raids and spam, and includes anti-nuke, quarantine, automod, moderation commands, backups, logging and a web dashboard. Its systems are modular, so you can turn on only what you need and configure each one separately.
- Prefix:
b2!(some features also have slash commands) - Website: https://astramaster.vercel.app
- Docs: https://astramaster.vercel.app/docs
- Full documentation as plain text: https://astramaster.vercel.app/llms-full.txt
- Live status: https://astramaster.vercel.app/status
- Terms and Privacy as plain text: https://astramaster.vercel.app/llms-legal.txt
- Add AstraMaster and move its role to the very top of your role list. Quarantine, Buster Call, restoration and backups all depend on this.
- Run
b2!setup(Server Owner only). It runs four steps: it enables Anti-Nuke and makes a first backup, checks the bot role and enables Quarantine, enables Automod, and asks you to pick a log channel. - Run
b2!whitelistand add your trusted admins and trusted bots to the Anti-Nuke Whitelist. Then review the channel and user exemptions for Automod.
Please do step 3 early. Whitelists are not retroactive, and any admin who is not on the list can be flagged and banned if they hit a threshold, even if they are legitimate.
Anti-nukeAnti-nuke watches for mass destructive actions. It is separate from the Quarantine system, so you can enable it at any time. It triggers when one person performs 3 of the same action within a short window:
- Channel deletion, creation or edits: 3 in 15 seconds
- Category deletion, creation or edits: 3 in 15 seconds
- Role deletion or creation: 3 in 15 seconds
- Role permission updates: 3 in 20 seconds
- Webhook creation: 3 in 15 seconds
- Kicks or bans: 3 in 15 seconds
- Mass ping (@everyone, @here, large role): 3 in 15 seconds
When a threshold is hit:
- The person responsible is banned immediately.
- The server is restored automatically from the latest backup.
- An alert goes to your log channel, if you set one.
Commands: b2!antinuke (shows status, or enables it if it’s off), b2!antinuke disable, and /antinuke. Server Owner only. When you enable it, AstraMaster takes a backup right away and then one every day.
Anti-nuke uses a global whitelist only. Per-action and per-channel whitelists do not apply to it. Even people whitelisted for specific actions can still be flagged if they exceed the thresholds, so add trusted admins and bots to the Anti-Nuke Whitelist with b2!whitelist.
If a nuke attempt is detected and a restoration is running, don’t make changes. Let it finish.
Backup and restoreb2!backupcreates a backup now and sends the file (JSON) to the server owner by DM.b2!restorerestores a server from a backup. Attach the JSON file the bot sent you. It recreates channels, roles and permissions. Owner only.- Automatic backups run every day while Anti-nuke is on, and are used for the automatic restore after a nuke.
- Backups are delivered by DM, so the server owner’s DMs must be open.
Quarantine takes away a member’s ability to send messages in every channel using a restricted role. Enabling it creates the role and syncs it to all existing channels.
/quarantineenables the system (Owner).b2!quarantine @userplaces a member in quarantine.b2!quarantine remove @userreleases them./add-quarantineand/remove-quarantineare the slash equivalents.
The Quarantine Whitelist is selective, so you can exempt specific actions such as channel creation, role deletion, webhook creation, bans, kicks, adding bots and server updates.
AutomodAutomod runs all the time and acts on violations automatically. Open the panel with b2!automod or /automod and switch each filter on or off.
Filters: swear blocking, GIF blocking, link blocking, spam blocking, external apps protection, and mass ping protection.
From the dashboard, the swear, GIF, link, external apps and mass ping filters can be tuned with a base timeout, a max multiplier for repeat offenses, and a reset window. Each filter has its own whitelist page.
Emergency and permission tools- Buster Call:
b2!buster-callstrips dangerous permissions from all roles server-wide and DMs affected members. It is for an attack that is happening or about to happen.b2!rewoke-callrestores the permissions removed by the most recent Buster Call. Server Owner or Extra Owner. - Strip:
b2!strip @userremoves dangerous permissions from one person.b2!unstrip @userrestores them.
b2!logs #channelsends moderation events (timeouts, bans, kicks, quarantines, backups, whitelist updates, anti-nuke alerts) to a channel.b2!logs removestops it. Server Owner only.b2!manageopens a panel where the server owner grants Extra Owner access. Extra Owners and Trusted Moderators get extra commands, so only give this to people you fully trust.
- AstraMaster’s role should be above all other roles for every feature to work fully.
- Data stored: Discord user IDs, guild IDs and names, channel and role IDs, backup snapshots and moderation logs. No message content, real names, emails or payment details. Full details in the Privacy Policy.
- Backups must not be shared, sold or reused on another server. See the Terms.
- Restorations are not guaranteed to be complete or error-free.