# Booster Roles

Booster roles let members get their own role for boosting your server.

> [!info] Permissions
> Antidote needs:
> - **Manage Server** — to see boosts in the audit log
> - **Manage Roles** — to create and give booster roles

## Setup

Open the [dashboard](https://antidote.bot/dashboard), pick your server, go to **Modules**, then open **Booster Roles**.

The options on that page are straightforward. After you save, members can see booster role info in Discord.

We recommend setting a **pinned role**. New booster roles are created next to it.

> [!warning] New booster roles copy the permissions of the pinned role.

![Booster Roles Configuration](https://i.gyazo.com/da6467db2730daac66dc4404ab9ea17f.png)

![Booster Roles Information](https://i.gyazo.com/5272bceec501b0c38689607aa0c2007b.png)

## For boosters

Members can type **`!br`** to see booster role info, then create theirs with **`!br create`** or **`!br setup`**.

1. Configure the role

![Configure booster role](https://i.gyazo.com/043704a8e44aef36d739ca96e6d6c2ce.png)

2. Update it later

![Updating a booster role](https://i.gyazo.com/adedf0490314f23ef5a25d63ab8d54c8.png)

3. Set an icon

![Setting an icon](https://i.gyazo.com/0de42edaab3afedc51f57f48719a8ab6.png)

4. Delete it

![Deleting](https://i.gyazo.com/23a0b12c2d3a6dbbafbf4e5825ddfb34.png)

## Sharing

Boosters can share their role with **`!br share`**.

![Share booster role](https://i.gyazo.com/3f4b9836881677d4315be594c8302e39.png)


Booster roles

# Introduction

Antidote is a Discord bot that helps you set up and run a server. It also includes an RPG you can play with friends.

## What you can do

### Easy setup

Most features are turned on from the [dashboard](/dashboard). You can usually get a server running in a few minutes.

### RPG

Fight monsters, battle other players, level up, earn money, own casinos, and more. Open the RPG pages in the sidebar to learn the details.

### Voice Control

Let members create and manage their own voice channels. They can lock, hide, rename, kick, ban, and whitelist people.

See [Voice Control](/docs/voice-control/setup) for setup.

### Antinuke

Stop people with permissions from wrecking your server. If someone bans, kicks, or deletes too much too fast, Antidote can jail, strip roles, kick, or ban them.

### Auto Moderator

Automatically warn or punish people for bad words, spam, invites, scam images, and more.

### Welcomer / Leaver

Greet people when they join, and optionally send a message when they leave. You can use a saved embed for this.

![Welcome embed example](https://i.gyazo.com/7b434637c8dfdaedb4104ddf31445f7a.png)

### Fun commands

Kiss, hug, 8ball, quotes, anime, Urban Dictionary, and more. See the full list on the [commands](https://antidote.bot/commands) page.

### Role menus and auto roles

Let members pick roles with reactions. You can also give roles automatically based on activity.

### And more

This page is only a short tour. Use the sidebar to open the feature you want to set up.


Introduction

# Antinuke

Antinuke stops people with permissions from wrecking your server.

You pick a limit, like **5 bans in 10 minutes**. If someone goes over that limit, Antidote punishes them.

> [!info] How it knows who did it
> Antidote uses Discord’s **audit log**. Give the bot **View Audit Log**, or it can’t tell who to punish.

![Dashboard Antinuke overview](https://i.gyazo.com/f8641fe26f1f1d2bf2aead09d7dffd5f.png)

## Quick setup

1. Turn **Antinuke** on in the [dashboard](/dashboard), or run **`antinuke setup`** in Discord.
2. Put Antidote’s role **high enough** to manage roles and jail people.
3. If you want **Jail**, set a jail role and jail channel under **Moderation**. If you skip that, Antidote can still strip dangerous roles.

## Where to change settings

- [Dashboard](/dashboard) → your server → **Antinuke**
- In Discord: **`antinuke config`** or **`antinuke setup`**

![Discord Antinuke config](https://i.gyazo.com/2890e24065f55954da21d513d660c357.png)

## Logging

When Antinuke punishes someone, it can post a log and ping roles.

Set this in the dashboard: **Modules → Logging → Antinuke**. You can open that tab directly by adding `#antinuke` to the Logging module URL.

Enable the **Logging** module and pick a channel, or nothing is posted.

## What each module watches

Each module has its **own** limit, punishment, and Cmd detection switch. Going over the ban limit does **not** reset the channel limit.

| Module | Watches |
| ------ | ------- |
| **Vanity protection** | Changes to your custom invite URL |
| **Deny bot joins** | Bots being added |
| **Ban protection** | Members getting banned |
| **Kick protection** | Members getting kicked |
| **Role deletion** | Roles being deleted |
| **Channel creation / deletion** | Channels being created or deleted |
| **Emoji deletion** | Custom emojis being removed |
| **Webhook creation** | Webhooks being created |
| **Sticker deletion** | Stickers being removed |

## Limits

A limit is how many times one person can do that action in a short window.

| Setting | Meaning |
| ------- | ------- |
| **Instant** | Punish on the first action. Only use this if you really want it. |
| **3 actions / 5m** | 3 actions in 5 minutes |
| **5 actions / 10m** | 5 actions in 10 minutes (good default) |
| **7 actions / 30m** | 7 actions in 30 minutes |
| **10 actions / 60m** | 10 actions in 60 minutes |
| **15 actions / 60m** | 15 actions in 60 minutes |
| **20 actions / 60m** | 20 actions in 60 minutes |

Use tighter limits on public servers. Small staff teams can use looser ones.

## Punishments

| Punishment | What happens |
| ---------- | ------------ |
| **Jail + strip** | Takes away dangerous permissions, then jails them. If jail isn’t set up, it still strips roles. |
| **Strip roles** | Removes roles that can ban, kick, or manage the server, channels, roles, and webhooks. |
| **Ban** | Bans them from the server. |
| **Kick** | Kicks them from the server. |

Strip is a fast lock-down. It is not a full review of every role on the server.

## Cmd detection

Each module has a **Cmd detection** switch. It decides whether Discord commands (slash commands and similar) count toward the limit.

- **On** — command actions count.
- **Off** — command actions are ignored for that module. Use this if staff often moderate with commands and you don’t want that to trip Antinuke.

> [!info] Note
> Antinuke only counts actions Discord’s audit log can show, and only when it can tell **who** did them.

## Trusted people

- **Super admins** can change Antinuke settings. Only the server owner can add them.
- **Whitelisted members** are not punished.
- **Whitelisted roles** skip people who have that role.

Whitelist logging bots, ticket bots, and staff who need to do bulk actions.

![Whitelist / super admins](https://i.gyazo.com/d324f710f638550c74519b01c372b3de.png)

## Permissions Antidote needs

- **View Audit Log**
- **Ban Members** and **Kick Members** (if you use those punishments)
- **Manage Roles** (for strip and jail)
- **Manage Channels**
- **Manage Webhooks**
- **Manage Expressions** (emojis and stickers)
- **Manage Server**

If a permission is missing, the punishment may not work.

## Extra commands

- **`antinuke view @user`** — see how close someone is to a limit right now
- **`antinuke clear @user`** — reset their current counts so they can keep working

These are live counts, not a history log.


Antinuke

# Fake Permissions

Fake permissions let staff use Antidote moderation commands **without** native Discord permissions.

A moderator with fake `ban_members` can use **`ban`** through Antidote. They still cannot use Discord’s own ban button, Discord’s native timeout, or any other Discord client action that needs the real permission.

That is the point. Staff can moderate through the bot. They cannot mass-ban with a script against the Discord API, because Discord itself will refuse.

> [!info] Where to set it up
> [Dashboard](/dashboard) → your server → **Fake Permissions**, or run **`fakepermissions`** in Discord. This is **Server Premium**, and only the **server owner** can change grants.

This is **not** the same as [Antinuke](/docs/antinuke). Antinuke punishes people who already have Discord permissions and start wrecking the server. Fake permissions keep those Discord permissions off staff in the first place.

## Why use it

Give moderators a Discord role with **no** Ban Members, Kick Members, or Administrator. Grant the matching fake permissions to that role.

They can still:

- Ban, kick, timeout, and purge **with Antidote commands**
- Change nicknames or manage messages **with Antidote**, if you granted those flags
- Browse Discord’s audit log with **`audit`**, if you granted `view_audit_log`

They cannot:

- Open Discord’s native ban / kick / timeout UI
- Run a selfbot or raid script that hits Discord’s API as them
- Change Fake Permissions themselves, even with fake `administrator`

Pair this with [Antinuke](/docs/antinuke) so leftover native permissions still cannot nuke the server.

## Requirements

| Requirement | Why |
| ----------- | --- |
| **Server Premium** | Fake Permissions is a premium server feature. |
| **Server owner** | Only the guild owner can grant, remove, or reset. Discord admins who are not the owner cannot. |
| **Antidote’s own permissions** | The **bot** still needs the real Discord permission to carry out the action. If Antidote cannot Ban Members, `ban` fails even when the user has fake `ban_members`. |

> [!warning] Premium lapses
> If Server Premium expires, saved grants stay in the database but **do nothing** until the server is premium again. Staff need native Discord permissions (or Premium back) to use those commands.

## How it works

1. You grant permission names to a **role**, not to a user.
2. Anyone with that role is treated as having those flags **for Antidote command checks**.
3. Discord’s own permissions are unchanged.
4. Fake `administrator` passes **every user command permission check**. It does not give Discord Administrator, it does not skip role hierarchy, and it does not let them manage Fake Permissions.

Antidote still respects:

- Role hierarchy (you cannot moderate someone above you)
- Channel-specific checks on some commands (for example **`nuke`** still looks at native Manage Channels on that channel)
- Bot permissions (Antidote must actually be allowed to do the action)

> [!info] Prefix commands
> Discord hides slash commands like `/ban` from people who lack Ban Members. Fake-perm staff should use the **prefix** command (your server prefix + `ban`). Slash stays gated by Discord.

## Viewing the audit log

Staff with native or fake `view_audit_log` can run **`audit`** (aliases: **`auditlog`**, **`logs`**).

| Command | What it does |
| ------- | ------------ |
| **`audit [user]`** | Latest Discord audit log, paginated with Previous / Next. Optional user is **who performed the action**. |

The bot still needs real **View Audit Log** in the server. The fake flag only lets the user run the command.

## Quick setup

1. Create or pick a staff role with **no** dangerous Discord permissions.
2. Open [Dashboard](/dashboard) → **Fake Permissions**, or run **`fakepermissions`** in Discord.
3. Grant the role a preset (Moderator, Administrator, or Co-Owner) or pick flags yourself.
4. Confirm with **`fakepermissions list`**.
5. Have a test moderator run a prefix command such as **`ban`**. It should work. Discord’s native ban should still fail for them.

## Dashboard

Only the server owner can open this page. Everyone else is sent back to the server list.

On a **free** server the page is visible so you can read it, but Grant, chip remove, and Reset are locked. Use **Get Premium** to unlock.

On a **premium** server:

1. Pick a role.
2. Pick one or more permissions, or click a preset.
3. Click **Grant**.
4. Granted flags show as chips under that role. Remove one chip to revoke that flag.
5. **Reset all** clears every grant on the server (you get a confirm prompt).

Presets fill the permission list. You still click **Grant** after picking a role.

## Commands

All of these are **server owner only** and need **Server Premium**. Aliases: **`fakepermissions`**, **`fakeperms`**, **`fp`**.

| Command | What it does |
| ------- | ------------ |
| **`fakepermissions`** | Overview, examples, and a dashboard link |
| **`fakepermissions grant <role> <permissions>`** | Add flags to a role. Alias: **`add`** |
| **`fakepermissions remove <role> <permissions>`** | Take flags off a role |
| **`fakepermissions list [role]`** | Show all grants, or only one role |
| **`fakepermissions reset [role]`** | Clear every grant, or only one role |

### Examples

```
fakepermissions grant @Moderator manage_messages, moderate_members, manage_nicknames, kick_members
fakepermissions grant @Admin ban_members, kick_members, manage_roles
fakepermissions grant @Co-Owner administrator
fakepermissions remove @Moderator kick_members
fakepermissions list
fakepermissions list @Admin
fakepermissions reset @Moderator
fakepermissions reset
```

You can mention the role, paste its ID, or type its name. Permissions are comma-separated. Names are snake_case (`ban_members`). `BanMembers` and `timeout_members` are also accepted.

## Recommended presets

These match the dashboard buttons.

### Moderator

Good for day-to-day chat staff. Do **not** give this role Ban Members or Administrator in Discord.

| Permission | Lets them use |
| ---------- | ------------- |
| `manage_messages` | Delete / purge messages through Antidote |
| `moderate_members` | Timeout, mute, warn, and similar |
| `manage_nicknames` | Change nicknames through Antidote |
| `kick_members` | Kick through Antidote |

```
fakepermissions grant @Moderator manage_messages, moderate_members, manage_nicknames, kick_members
```

### Administrator

Adds bans and role management through the bot. Still keep native Discord Administrator **off**.

| Extra permission | Lets them use |
| ---------------- | ------------- |
| `manage_roles` | Role commands through Antidote |
| `ban_members` | Ban / unban through Antidote |

```
fakepermissions grant @Admin manage_messages, moderate_members, manage_nicknames, kick_members, manage_roles, ban_members
```

### Co-Owner

Fake `administrator` passes **all** Antidote user permission checks. It is the widest bot-side grant. They still cannot:

- Use Discord’s native Administrator tools
- Change Fake Permissions (owner only)
- Bypass role hierarchy
- Make Antidote do something the **bot** is not allowed to do

```
fakepermissions grant @Co-Owner administrator
```

> [!warning] Co-Owner is not Discord owner
> Fake administrator is for trusted people who should moderate **through Antidote only**. Do not also give that role Discord Administrator, or you lose the protection.

## Permission names

These are the flags you can grant. They only affect **Antidote command checks**.

| Permission | Typical Antidote use |
| ---------- | -------------------- |
| `administrator` | All user command permission checks |
| `ban_members` | Ban / unban |
| `kick_members` | Kick |
| `moderate_members` | Timeout, mute, warn, history |
| `manage_messages` | Purge / delete messages |
| `manage_nicknames` | Nickname commands |
| `manage_roles` | Role management commands |
| `manage_channels` | Channel commands (some still check native per-channel perms) |
| `manage_guild` | Server management commands |
| `manage_webhooks` | Webhook commands |
| `manage_expressions` | Emoji / sticker commands |
| `mute_members` | Voice mute |
| `deafen_members` | Voice deafen |
| `move_members` | Move members in voice |
| `mention_everyone` | Commands that need mention everyone |
| `view_audit_log` | `audit` — paginated Discord audit log |
| `view_guild_insights` | Insights-related commands |
| `external_emojis` | External emoji commands |
| `change_nickname` | Changing their own nickname through the bot |

Unknown names are rejected. Check **`fakepermissions`** in Discord for the live list.

## What fake permissions do not do

- They do **not** change Discord role permissions.
- They do **not** let someone use Discord’s native ban, kick, timeout, or channel settings.
- They do **not** give the **bot** extra permissions. Antidote must already be allowed to ban, kick, and so on.
- They do **not** skip hierarchy. A moderator still cannot punish someone with a higher role.
- They do **not** unlock Fake Permissions setup. Only the real server owner can grant or reset.
- They do **not** apply on a server that is not premium.

## Checklist

1. Staff roles in Discord have **no** Ban Members, Kick Members, Manage Channels, or Administrator.
2. Antidote’s role is high enough to moderate those staff and the people they punish.
3. Antidote itself has Ban Members, Kick Members, Moderate Members, Manage Messages, View Audit Log (for **`audit`**), and anything else you expect it to do.
4. Fake Permissions grants match the commands those roles should run.
5. [Antinuke](/docs/antinuke) is on, so leftover native permissions still cannot raid.

## Related

- **[Dashboard](/dashboard)** — Fake Permissions settings
- **[Antinuke](/docs/antinuke)** — punish people who already have Discord permissions and abuse them
- **[Automod](/docs/automod)** — automatic message punishments
- **[Premium](/premium)** — Server Premium unlocks this feature


Fake Permissions

# Auto Nuke

Auto Nuke recreates a Discord channel on a timer.

The new channel keeps the same name, permissions, topic, category, and slowmode. The old messages are gone from the live channel, unless you use archive mode.

This is **not** the same as [Antinuke](/docs/antinuke). Antinuke stops raids. Auto Nuke cleans a channel on a schedule.

> [!info] Where to set it up
> [Dashboard](/dashboard) → your server → **Auto Nuke**. You need to be the owner or a server admin.

## What happens

1. Antidote copies the channel’s settings.
2. If you chose archive mode, it keeps a copy of the old channel for staff.
3. It creates a new live channel with the same settings, then deletes the old live channel.
4. Other Antidote features (welcomer, tickets, automod logs, and similar) are pointed at the **new** channel automatically.

> [!warning] Messages are deleted
> **Recreate only** wipes the live channel. **Archive then recreate** keeps a separate copy staff can still read. Pins, threads, and old bot panels are not rebuilt on the new channel.

## Modes

| Mode | What it does |
| ---- | ------------ |
| **Recreate only** | Deletes the channel and makes a fresh one with the same settings. |
| **Archive then recreate** | Makes a hidden archive copy first, then recreates the live channel. |

### Archive options

- **Roles that can view archives** — required. Those roles can see the archive. Everyone else cannot.
- **Archive category** — optional. If you leave it empty, Antidote uses or creates **`auto-nuke-archives`**.

Archive channels are only for history. They are not used by welcomer or other modules.

## Schedule

The timer starts from the last successful run, not from a clock time like “every day at 8.”

| Interval | How often |
| -------- | --------- |
| **Hourly** | Every 1 hour |
| **Daily** | Every 24 hours |
| **Weekly** | Every 7 days |
| **Monthly** | Every 30 days |

Disabled rules are skipped. The dashboard shows **Last run** after a successful nuke.

## Manual nuke

Staff can also run **`nuke`** in Discord to recreate a channel right away. You get a confirm button first.

- You and Antidote both need **Manage Channels**.
- Text and voice channels only.
- System / rules / community channels cannot be nuked.

> [!warning] Manual nuke and Auto Nuke rules
> A manual `nuke` does **not** update the channel saved on your Auto Nuke rule. Edit the rule to point at the new channel, or wait for the next successful scheduled run.

## Permissions

Antidote needs **Manage Channels**. For archive mode it also needs to create channels in the archive category and set who can see them.

If a run fails, the dashboard can show an error and the timer does not move forward.

## Dashboard steps

1. Click **Add channel** and pick a text or voice channel.
2. Set **Enabled**, the interval, and the mode.
3. For archive mode, pick the roles (and optionally a category).
4. Click **Save all**.
5. Use edit or trash on a row to change or remove it.

You can add more than one channel, each with its own schedule.

## Related

- **[Dashboard](/dashboard)** — Auto Nuke settings
- **`nuke`** — recreate a channel right now
- **[Antinuke](/docs/antinuke)** — raid protection, not channel cleanup


Autonuke channel

# Autoresponder

Autoresponders watch messages or reactions and reply for you.

They can send text, a saved embed, a reaction, or a mix of those.

> [!info] Where to set it up
> [Dashboard](/dashboard) → your server → **Auto responders**. You build these in the dashboard, not with a Discord command.

![Autoresponder list in dashboard](https://i.gyazo.com/f2666d7034116c3f4b8291c5775f2c27.png)

## Limits

Free servers can usually save **2** autoresponders. Premium can usually save **50**. Your live plan in the dashboard is the real limit.

> [!warning] You need a response
> A rule must send a **message**, an **embed**, or a **reaction**. Empty rules cannot be saved.

## How they run

- **Message** rules run when someone sends a message the bot can see.
- **Reaction** rules run when someone adds that emoji (and optionally when they remove it).
- Changes can take a few minutes to show up.

Test in a private channel first. More than one rule can fire on the same message.

## Message trigger

You pick the **trigger text** and how it should match:

| Match type | When it fires |
| ---------- | ------------- |
| **Check entire message** | The message **contains** the text anywhere |
| **Check start** | The message **starts with** the text |
| **Check end** | The message **ends with** the text |

Matching ignores capital letters.

> [!info] “Entire message”
> That option still matches if the text appears **anywhere** in the message. Use **starts with** or **ends with** if you want it stricter.

## Reaction trigger

| Option | Meaning |
| ------ | ------- |
| **Reaction to monitor** | A **server emoji** to watch. Normal Unicode emojis cannot be picked here. |
| **Any message** | Fires on that emoji, no matter what the message says. |
| **Only matching messages** | The message text must match exactly (ignoring capital letters). |
| **Also check remove** | Removing the emoji can fire the same response. |

Reactions from bots are ignored.

![Reaction trigger settings](https://i.gyazo.com/1cbbb27a3552c66cc710671b6068d5ca.png)

## Extra options

| Option | What it does |
| ------ | ------------ |
| **Delete trigger message** | Deletes the original message after the delay you set. `0` means delete right away. |
| **Use reply** | Sends the text response as a reply. Embeds still post as a normal message. |
| **Self destruct** | Deletes the trigger message after 0–60 seconds. |

## Responses

You can turn on more than one:

- **Send a message** — plain text. Uses reply if that option is on.
- **Send an embed** — a saved server embed.
- **Send a reaction** — Antidote reacts with a server emoji.

## Tips

- Use a specific trigger so it does not fire all the time in busy channels.
- Remember that delete / self destruct removes the original message.

## Related

- **[Dashboard](/dashboard)** — create, edit, and delete autoresponders
- **Custom embeds** — used by **Send an embed**


Autoresponder

# Role templates

A role template is a ready-made pack of embeds, roles, and reaction menus.

You copy or edit it in the dashboard, then run it so Antidote can create the Discord roles, post the embeds, and attach the menus.

> [!info] Where to find them
> **My templates** — copies on your server that you can edit, run, or delete.
> **Templates library** — ready-made templates you can copy.
> **Execute template** — pick a channel, optionally an anchor role, then run it.

![My templates and library](https://i.gyazo.com/caad27e8c61e53681eeb7f068e4fa474.png)

## Copy from the library

1. Open **Templates library** and view a template.
2. **Copy to server** puts it under **My templates**.
3. You can edit, run, or delete that copy without changing the library.

Deleting a server template only deletes the saved setup in Antidote. Roles and messages already created in Discord stay.

## Edit a template

Each embed is its own card, with:

- name, color, title, and description
- optional author, footer, images, and fields
- roles under that embed: name, color, and reaction emoji

Before you can save:

- every role needs an emoji
- two roles in the same embed cannot share the same emoji

## Run a template

- **Channel** — required. Embeds and menus are posted there.
- **Anchor role** — optional. New roles are placed near this role in the list.
- **Execute** — creates the roles, saves the embeds, and sets up the menus.

If a role name already exists, Antidote reuses or updates it. Read the warning before you confirm.

You need dashboard access. Antidote needs **Manage Roles** and a role **above** the roles it creates.

## Discord command

Admins can also run **`template <template_id>`** in a channel. The ID is the number shown on your server template in the dashboard.

Use **Execute template** in the dashboard if you want to pick the channel and anchor role without typing IDs.

## Related

- **[Role menus](/docs/role-menus)** — how menus, groups, and DMs work after they are posted


Role templates

# Role menus

Role menus let members pick roles by reacting to a message.

You pair each role with an emoji in the dashboard, then run a short command on the message you want to use.

> [!info] Where to set it up
> [Dashboard](/dashboard) → your server → **Role menus**. Groups have their own page. Templates are separate — see [Role templates](/docs/role-templates).

![Role menu editor](https://i.gyazo.com/2ccf41b94c642990e446fb6a4ddb9f6c.png)

## Limits

Typical caps:

- **Role menus** — 10 free / 250 premium
- **Role menu groups** — 2 free / 25 premium

Your dashboard shows the real limit for your plan.

## Menu options

These apply when the menu is **not** in a group:

- **Name** — only used in the dashboard list
- **Group** — optional. If you add the menu to a group, some settings move to the group instead
- **Require one role** — members must keep at least one role from this menu
- **Remove old role** — picking a new role from this menu can remove their previous choice from the same menu
- **Reaction roles** — one emoji + one Discord role per row
- **Required roles** — members need at least one of these roles to use the menu
- **Ignored roles** — members with any of these roles cannot use it

### DMs

For standalone menus you can:

- send Antidote’s default DM when a role is given or taken
- turn DMs off
- send custom saved embeds instead

## Groups

Use a group when several menus should share the same rules, like color roles that cannot stack.

The group controls:

- required and ignored roles
- whether picking a new role removes the old one
- whether members must keep at least one role
- DM settings for every menu in the group

If you later remove a menu from the group, that menu’s own DM settings come back.

## Post it in Discord

After you save, the dashboard shows a command like **`rolemenu create <menu_id>`**. Use your server’s prefix.

Reply to the message, or pass the message ID. Antidote adds the reactions and starts listening.

> [!warning] Role order
> Antidote’s role must sit **above** the roles it gives, or Discord will block it.

## Remove a menu from a message

Use **`rolemenu clear`** with the message ID (Developer Mode → Copy ID), or reply to that message. Check in-Discord help for the exact usage.

## Related

- **[Role templates](/docs/role-templates)** — create roles, embeds, and menus in one go


Role menus

# Items

Items are used all over the RPG.

- **Equipment** raises your battle stats.
- Some items boost skills, robbery, or crime.
- Resources like wood, ore, and leather are used for skilling and crafting.

## Inventory

Use **`!inventory`** to see what you own.

## Shop

Use **`!shop`** to browse and buy items.

> [!info] Item details
> Each item has its own stats, price, and rules for buying, selling, or trading.
> Some items cannot be sold or traded. You get those by [battling monsters](/docs/rpg-battle) or [skilling](/docs/rpg-skilling).

![example item](https://i.gyazo.com/e08400c6865ff50febade260111137db.png)

## Equipping items

Weapons and armour can be equipped with **`!equip`**.

Use **`!equipment`** to see what you are wearing and your current stats.


RPG - Items 

# Invasion Boss

The invasion boss is a server-wide fight. Everyone can hit it together.

It appears about every <mark class="info">1 in 3000</mark> messages.

## Rewards

Kill it for items, resources, and other loot.

## Dangers

> [!error] Losing profile XP
> The boss has a **5%** chance to hit you. That hit damages your profile XP and level.

![Invasion Boss](https://api.antidote.bot/media/invasion_boss.jpg)


RPG - Invasion Boss

# Battling

You can fight monsters or other players. Wins give profile XP and rewards.

![battle](https://i.gyazo.com/f3165c809c17ae02d139147d14488b81.png)

## Monsters

Use **`!battle`** to fight a monster.

Monsters have a level, which changes their stats. They can drop resources and equipment.

Resources are used for crafting. Equipment raises your stats.

## Players

Use **`!battle <player> [stake]`** to fight another player.

The stake is optional. If you add money, the winner takes it.

## Pets

Your pet helps in battle.

In PvP, pets fight each other first. If your pet wins, it then helps against the other player.

Monsters do not have pets, so your pet fights after your turn.

## Dungeon

> [!warning] In development
> The dungeon can pay well, but it is risky. You can lose the **500,000** entry fee and get nothing back.

Use **`!dungeon`** to enter and fight for extra rewards.


RPG - Battle

# Skilling

Skills give extra benefits in the RPG. Use **`!skills`** to see yours.

> [!info] Did you know?
> Skill levels use a similar formula to Old School RuneScape.

![skills example](https://i.gyazo.com/a2c284f1936d0997391fb793f5c7e7e0.png)

## How to train

Each skill needs a tool. Buy tools from **`!shop`**, then equip them. Check **`!equipment`** to see what you have on.

| Skill | Tool |
| ----- | ---- |
| Woodcutting | Any axe |
| Mining | Any pickaxe |
| Fishing | Fishing net |
| Hunting | Any dagger |

### Hunting

Hunt animals for meat and other resources with **`!hunt`**.

Use **`!animalinfo`** to see the animals.

Get started with **`!buy bronze dagger`**.

![hunting](https://i.gyazo.com/19a0c9e58412b2ef6be3b538334a3026.png)

### Cooking

Cook raw food with **`!cook <raw_food_name>`**.

Cooked food can heal you in battles.

### Fishing

Catch fish with **`!fish`**.

Use **`!fishinfo`** to see the fish.

Get started with **`!buy fishing net`**.

![fishing](https://i.gyazo.com/1d116557e51f999cdf65cffb35849ffa.png)

### Mining

Mine ores with **`!mine`**.

Use **`!rockinfo`** to see the ores.

Get started with **`!buy bronze pickaxe`**.

![mining](https://i.gyazo.com/46ccefc26fcb7369a36a631b116522d4.png)

### Woodcutting

Chop trees with **`!chop`**.

Use **`!trees`** to see the trees.

Get started with **`!buy bronze axe`**.

![woodcutting](https://i.gyazo.com/9188cd7642a33fdc7f2c0a264f04913a.png)

### Crafting

Combine resources into new items with **`!craft`**.

See recipes with **`!recipes`**.

No tool is required, but you need the resources.

![selection](https://i.gyazo.com/d18e12fdaf4eb1916b18b9c37369aee2.png)
![result](https://i.gyazo.com/81c6bdb5fb969c9e2c8bc57f6f12fb56.png)

### Salvaging

Break items down for resources with salvaging.

You get about **half** of the resources the item was made from, plus XP.

Use **`!salvageinfo`** to see recipes.


RPG - Skilling

# Cars

You can steal cars, race them, repair them, or sell them.

Durability affects speed and price.

## Stealing

Use **`!steal`**. You can do this **once per hour**.

The stolen car gets a random durability. Price depends on durability, rarity, and type.

## Selling

Use **`!car sell <car_id>`**.

## Racing

Use **`!race`** to race for fun, or **`!race <user> <amount>`** to race for money.

The other player has to accept. Then you both pick a car.

## Repairing

Repairing costs money based on how damaged the car is. How much durability you get back is random — sometimes almost all of it, sometimes almost none.

That result changes the car’s speed and sell price.


RPG - Cars

# Pets

Pets can spawn in chat. The chance is **1 in 2500** messages.

Press **Adopt** to try to claim one. Each try has a **40%** chance.

You can also find pets while training the hunting skill.

![example](https://i.gyazo.com/f59eae89677df085db61a6fb584eb8f6.png)

Rarity changes a pet’s starting stats. Use **`!pet`** to view yours.

## Stats and training

Pets start with different attack and health. You can train a pet up to **level 30**.

![example pet](https://i.gyazo.com/a838c46d4a6a37c47f09a6b63b540f2f.png)

Train by fighting monsters with **`!battle`**. Your pet also helps in those fights.

In PvP, pets fight each other first. If your pet wins, it then helps against the other player.

![training](https://i.gyazo.com/f3165c809c17ae02d139147d14488b81.png)

## Rename

Use **`!pet rename`**. This is free for now. It might cost in-game money later.

![renaming](https://i.gyazo.com/51c05aed670d2c28228eead4bdf20126.png)

## Discard

If you want a different pet, use **`!pet discard`**. That lets you try to claim another one.

![heartbreak](https://i.gyazo.com/52bc07c0f0480313f3e6c6fe2d3699c5.png)


RPG - Pets

# Automod

Automod watches messages and takes action for you.

You create **rules** in the dashboard. Each rule looks for something specific (bad words, spam, sketchy links, and more). If someone trips the rule often enough, Antidote can warn them and punish them.

> [!info] Where to set it up
> [Dashboard](/dashboard) → your server → **Automod**. From there you can create rules and manage blacklisted words.

![Automod rules list in the dashboard](https://i.gyazo.com/dc1d9ac60db60a868fadde68cbbc86df.png)

## What Antidote needs

The bot must be able to **read messages**, **delete messages** (if you turn that on), and apply the punishment you pick (timeout, kick, jail, and so on).

If a rule does not seem to work, check Antidote’s role and channel permissions.

## How a rule works

1. Someone sends a message that matches the rule.
2. That counts as one hit for that person.
3. If they get enough hits in the time window you set, the punishment runs.
4. You can also log hits, delete the message, and send a warning.

> [!tip] One rule per trigger
> You usually cannot create two rules with the same trigger. If you already have “blacklisted word in message,” edit that rule instead of making another one.

## Blacklisted words

Word rules share one word list for your server. Manage it with **Manage blacklisted words**.

You can check:

- **Message only** — the message text
- **Name only** — username or nickname
- **Message or name** — either one
- **Strict** — a tighter match

Turn on **Check unicode** to catch people hiding letters with lookalike characters.

## Other triggers

| Trigger | What it watches |
| ------- | --------------- |
| **Message matches regex** | A pattern you write. For advanced setups. Bad patterns are ignored. |
| **Emote spam** | Too many emojis in one message |
| **Someone spams mentions** | Too many @mentions in one message |
| **URL that is not related to Discord** | Links that are not normal Discord links |
| **Discord server invites** | Invites to other servers. Your own invite is allowed. |
| **Harmful images / scam images** | Images that match known scam screenshots |

> [!tip] Test first
> Try a new rule in a staff-only channel before you turn it on for everyone.

## Limits

For spam-style rules you set:

- how many emojis or mentions count as one bad message
- how many times someone can trip the rule
- how many minutes that window lasts

Think of it as: “this many strikes in this many minutes, then take action.”

## Punishments and warnings

When the limit is reached, you can **warn only**, **jail**, **mute**, **timeout**, **kick**, **ban**, or do nothing extra.

- Mute and timeout also need a **duration**.
- Warnings can go to **DM** or the **channel**, and can use a saved embed.
- **Delete trigger message** removes the message that caused the hit.

## Ignored roles

Pick roles that should never be punished, usually staff or bots.

## Plan limits

How many rules you can save depends on your plan. If you hit the cap, remove an old rule or upgrade.

## After you save

Changes can take a minute or two to show up in Discord.

## Related

- **[Antinuke](/docs/antinuke)** — raid protection, separate from Automod
- **Jail** — set a jail role and channel if you use jail as a punishment


Automod

# Server Events

Antidote can drop money, spawn pets, and run fun events in chat. These keep the server active.

## Money drops

By default, a money drop happens every **250 messages**.

You can change this in the economy module on the dashboard:

![server drops](https://i.gyazo.com/dc463f4f332618e90f11d07a790707ce.png)

You can turn drops off, or limit them to one channel. We recommend leaving them on — people like claiming them.

## Pet spawns

Pets spawn less often: about every **2500 messages**. Rarer pets are less likely to appear. Members can try to adopt them.

You can limit pet spawns to one channel, or turn them off:

![pet settings](https://i.gyazo.com/8d00daebc1dfeea973d7f3fc9f28b9ce.png)

## Fun events

Fun events can also be turned off, or limited to one channel, in the fun module. That keeps them from spamming every chat.


Booster roles

Booster Roles

Setup

For boosters

Contents

© 2026 - Antidote Multi-Purpose Discord Bot

Booster roles

Setup

For boosters

Sharing

Contents

© 2026 - .css-qar18d{margin:0;font-size:0.9rem;line-height:1.5;font-weight:500;font-family:'Geist Variable',sans-serif;letter-spacing:0.00938em;word-wrap:break-word;color:#fff;font-weight:600;display:inline-block;color:#c74343;}Antidote Multi-Purpose Discord Bot

© 2026 - Antidote Multi-Purpose Discord Bot