AstraMaster

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.app
• Docs: https://astramaster.app/docs
• Full documentation as plain text: https://astramaster.app/llms-full.txt
• Live status: https://astramaster.app/status
• Terms and Privacy as plain text: https://astramaster.app/llms-legal.txt

Getting started

1. Add AstraMaster and move its role to the very top of your role list. Quarantine, Buster Call, restoration and backups all depend on this.
2. 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.
3. Run b2!whitelist and 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-nuke

Anti-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 restore

• b2!backup creates a backup now and sends the file (JSON) to the server owner by DM.
• b2!restore restores 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

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.

• /quarantine enables the system (Owner).
• b2!quarantine @user places a member in quarantine.
• b2!quarantine remove @user releases them.
• /add-quarantine and /remove-quarantine are 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.

Automod

Automod 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-call strips 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-call restores the permissions removed by the most recent Buster Call. Server Owner or Extra Owner.
• Strip: b2!strip @user removes dangerous permissions from one person. b2!unstrip @user restores them.

Logs and access

• b2!logs #channel sends moderation events (timeouts, bans, kicks, quarantines, backups, whitelist updates, anti-nuke alerts) to a channel. b2!logs remove stops it. Server Owner only.
• b2!manage opens 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.

Things to know

• 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.

Links

• Terms: https://astramaster.app/terms
• Privacy: https://astramaster.app/privacy