Documentation

ProtoBot Docs

Setup notes, addon behavior, permissions, and slash-command reference for ProtoBot. Use search for direct jumps, or read through the sections like a normal docs page.

14 addons52 commands

Setup

Quick Start

The shortest path from invite to a working server configuration.

01Invite ProtoBot to your server.
02Open the Proto dashboard and select the server you want to configure.
03Enable the addons you want to use.
04Set required channels, roles, and rule options in the dashboard.
05Use the slash commands below once the addon is active.

Modules

Addons

Each addon includes its setup notes and associated commands in one place.

Moderation

FreeEnabled

Manual staff tools for warnings, timeouts, kicks, bans, temporary roles, and user lookups.

Configuration: Enabled per server. Individual moderation commands can be toggled in server settings with per-command role or member access.
Permissions: Manage Messages, Manage Roles, Moderate Members, Kick Members, Ban Members, and Mute Members depending on the command used. Native Discord moderation permissions can use moderation commands even when extra dashboard allowlists are configured.

Associated Commands

/help

Shows the command list available in the current server.

Permissions: Command must be enabled for the server.
Example: /help

/ping

Checks bot latency and response time.

Permissions: Command must be enabled for the server.
Example: /ping

/prune

/prune user?:<member> amount:<count>

Deletes the requested number of recent messages in the current text channel, optionally limited to one member.

Permissions: Manage Messages
Example: /prune user:@Nova amount:25

/giverole

/giverole user:<member> role:<role> days? hours? minutes? reason?

Gives a member a temporary role for a set duration.

Permissions: Manage Roles
Example: /giverole user:@Nova role:@Event days:1 hours:2 reason:Weekend event

/user info

/user info user:<member>

Shows a moderation snapshot for a member.

/mod timeout

/mod timeout user:<member> duration:<minutes> reason?

Temporarily times out a member. If Timeout Challenges is enabled, fresh timeout events from any source can trigger a challenge DM separately from this command.

Permissions: Moderate Members
Example: /mod timeout user:@Spammer duration:60 reason:Spam links

/mod untimeout

/mod untimeout user:<member> reason?

Removes a member timeout.

Permissions: Moderate Members
Example: /mod untimeout user:@Member reason:Appeal accepted

/mod warn

/mod warn user:<member> reason?

Records a warning for a member.

Permissions: Moderate Members
Example: /mod warn user:@Member reason:Backseat moderation

/mod warnings

/mod warnings user:<member>

Shows warning history for a member.

Permissions: Moderate Members
Example: /mod warnings user:@Member

/mod history

/mod history user:<member>

Shows recent moderation history for a member.

Permissions: Moderate Members
Example: /mod history user:@Member

/mod kick

/mod kick user:<member> reason?

Kicks a member from the server.

Permissions: Kick Members
Example: /mod kick user:@Raider reason:Advertising

/mod ban

/mod ban user:<member> reason?

Bans a member from the server.

Permissions: Ban Members
Example: /mod ban user:@Raider reason:Malicious spam

/mod unban

/mod unban user-id:<discord user id> reason?

Unbans a user by Discord user ID.

Permissions: Ban Members
Example: /mod unban user-id:123456789012345678 reason:Appeal accepted

/mod mute

/mod mute user:<member> reason?

Server-mutes a member in voice channels.

Permissions: Mute Members
Example: /mod mute user:@Member reason:Mic spam

Timeout Challenges

FreeOptional

Automatically DM sentence challenges when members receive fresh Discord timeouts from any source.

Configuration: Enable the addon, configure custom sentences and repeat challenge behavior. Free servers show ProtoBot branding in challenge embeds; premium servers omit the branding.
Permissions: ProtoBot needs member update events to detect new timeouts and must be able to DM members. The leaderboard command is available when the addon is enabled.

Associated Commands

/timeout leaderboard

/timeout leaderboard limit? user?

Posts this server's timeout challenge leaderboard publicly in the channel. The command has a per-server global cooldown to prevent spam.

Permissions: Timeout Challenges addon must be enabled for the server.
Example: /timeout leaderboard limit:10

Logger

FreeEnabled

Always-on activity history for moderation and tracked member changes in the dashboard.

Configuration: Runs as part of the server setup and surfaces history in the dashboard logs view.
Permissions: No public slash commands.

Associated Commands

No public slash commands. Configure and use this addon from the dashboard.

AutoMod

FreeOptional

Automatic detection and enforcement for spam, suspicious links, repeated mentions, and raid-style behavior.

Configuration: Enable the addon, then configure rules and thresholds in the dashboard.
Permissions: Dashboard-managed configuration.

Associated Commands

No public slash commands. Configure and use this addon from the dashboard.

Tickets

FreeOptional

DM-based support tickets bridged into private staff channels with attachment support.

Configuration: Enable the addon, configure the ticket panel, choose staff channels, and manage ticket command access in the dashboard.
Permissions: Manage Channels for staff ticket commands. Optional role restrictions can be configured in the dashboard.

Associated Commands

/ticket close

Closes the current open ProtoBot ticket channel and notifies the ticket member.

Permissions: Manage Channels. Command must be enabled and allowed for one of the member's roles if role restrictions are configured.
Example: /ticket close

/ticket add

/ticket add member:<member>

Adds a server member to the current open ticket channel.

Permissions: Manage Channels. Command must be enabled and allowed for one of the member's roles if role restrictions are configured.
Example: /ticket add member:@Helper

/ticket remove

/ticket remove member:<member>

Removes a server member from the current open ticket channel.

Permissions: Manage Channels. Command must be enabled and allowed for one of the member's roles if role restrictions are configured.
Example: /ticket remove member:@Helper

/ticket info

Shows the current ticket details.

Permissions: Manage Channels. Command must be enabled and allowed for one of the member's roles if role restrictions are configured.
Example: /ticket info

/ticket history

/ticket history member? status? page?

Browses recent tickets with member and status filters, including transcript views through interactive controls.

Permissions: Manage Channels. Command must be enabled and allowed for one of the member's roles if role restrictions are configured.
Example: /ticket history status:open

/ticket reopen

/ticket reopen ticket-id:<id>

Reopens a closed ticket by ticket ID.

Permissions: Manage Channels. Command must be enabled and allowed for one of the member's roles if role restrictions are configured.
Example: /ticket reopen ticket-id:184

Misc

FreeEnabled

Community utility and fun commands such as rolls, polls, choices, and AFK status.

Configuration: Enabled per server, with individual misc commands controllable in server settings.
Permissions: Most commands only need to be enabled. Ending a poll early requires Administrator, Manage Server, Manage Messages, or Moderate Members.

Associated Commands

/roll

/roll min? max?

Rolls a random number, defaulting to 1 through 6.

Permissions: Command must be enabled for the server.
Example: /roll min:10 max:25

/coinflip

Flips a coin and returns heads or tails.

Permissions: Command must be enabled for the server.
Example: /coinflip

/choose

/choose options:<comma-separated list>

Picks one option from a list.

Permissions: Command must be enabled for the server.
Example: /choose options:blue, red, green

/8ball

/8ball question:<text>

Answers a question with a Magic 8 Ball response.

Permissions: Command must be enabled for the server.
Example: /8ball question:Will the event sell out?

/rate

/rate topic:<text>

Rates something from 1 to 10.

Permissions: Command must be enabled for the server.
Example: /rate topic:my new profile picture

/picknumber

/picknumber min:<number> max:<number>

Picks a random number inside a required range.

Permissions: Command must be enabled for the server.
Example: /picknumber min:100 max:250

/poll

/poll question:<text> options?

Creates a live poll with button voting and final results.

Permissions: Command must be enabled for the server. Ending a poll early requires Administrator, Manage Server, Manage Messages, or Moderate Members.
Example: /poll question:Movie night? options:Yes, No

/afk

/afk status?

Sets your AFK status, or clears it if you are already AFK and omit the status.

Permissions: Command must be enabled for the server.
Example: /afk status:At lunch

Social Integration

FreeOptional

Announcements for supported creator go-live events in a chosen Discord channel.

Configuration: Enable the addon, choose providers, and set the destination channel in the dashboard.
Permissions: Dashboard-managed configuration.

Associated Commands

No public slash commands. Configure and use this addon from the dashboard.

ATB Results

PremiumOptional

Tournament results, player stats, team stats, win leaderboards, and award tracking from the ATB results sheet.

Configuration: Requires a premium server. Enable the addon in the dashboard; tournament data refreshes automatically from the configured Google Sheet.
Permissions: Addon must be enabled for the server.

Associated Commands

/atb-topten

Shows the top 10 players by tournament wins, including regular wins, late-night wins, and awards when available.

Permissions: ATB Results addon must be enabled for the server.
Example: /atb-topten

/atb-topteams

Shows the top 3 teams by tournament wins.

Permissions: ATB Results addon must be enabled for the server.
Example: /atb-topteams

/atb-pstats

/atb-pstats tag:<player tag>

Shows tournament statistics for a specific player tag.

Permissions: ATB Results addon must be enabled for the server.
Example: /atb-pstats tag:Nova

/atb-tstats

/atb-tstats team:<team name>

Shows tournament statistics for a specific team.

Permissions: ATB Results addon must be enabled for the server.
Example: /atb-tstats team:Red Wolves

/atb-recentwinners

Shows winners from the most recent tournament date in the ATB results data.

Permissions: ATB Results addon must be enabled for the server.
Example: /atb-recentwinners

AI Bot

FreeOptional

Experimental mention-based AI chat powered by a local LM Studio model with ATB winners archive context.

Configuration: Global admins enable the addon in the dashboard. Members then mention ProtoBot in Discord to chat.
Permissions: Only global admins can manage the addon. Members can use it after it is enabled for the server.

Associated Commands

No public slash commands. Configure and use this addon from the dashboard.

Suggestions

FreeOptional

Collect server suggestions in a configured channel with voting reactions, linked discussion threads, and staff decisions.

Configuration: Enable the addon, choose the suggestions channel, configure submitter and staff roles, and set voting emoji in the dashboard. Staff can accept or decline from slash commands or the buttons on suggestion posts.
Permissions: Addon and /suggest command must be enabled. Create access and decision access can be restricted to configured roles.

Associated Commands

/suggest create

/suggest create title:<text> description:<text>

Posts a new suggestion in the configured suggestions channel, adds the configured voting reactions, and creates a linked discussion thread.

Permissions: Suggestions addon and /suggest command must be enabled. Member must have a submitter role if role restrictions are configured.
Example: /suggest create title:Movie night description:Add a monthly movie night event

/suggest accept

/suggest accept id:<suggestion id> reason:<text>

Marks a pending suggestion as accepted, updates the suggestion post, and posts the reason in the linked thread when available.

Permissions: Suggestions addon and /suggest command must be enabled. Member must have a decision role if role restrictions are configured; otherwise staff permissions are required.
Example: /suggest accept id:12 reason:Added to next community event

/suggest decline

/suggest decline id:<suggestion id> reason:<text>

Marks a pending suggestion as declined, updates the suggestion post, and posts the reason in the linked thread when available.

Permissions: Suggestions addon and /suggest command must be enabled. Member must have a decision role if role restrictions are configured; otherwise staff permissions are required.
Example: /suggest decline id:12 reason:Outside current server scope

AutoRoles

PremiumOptional

Automatically assigns configured roles to new members when they join.

Configuration: Requires a premium server. Enable the addon and select the join roles in the dashboard.
Permissions: Dashboard-managed configuration. ProtoBot must be above the target roles in Discord role hierarchy.

Associated Commands

No public slash commands. Configure and use this addon from the dashboard.

Automated Messages

FreeOptional

Schedule recurring messages to post automatically in any channel on a configurable interval.

Configuration: Enable the addon, then create and manage scheduled messages from the dashboard or via /automessage. Free servers can configure one automated message; premium servers have no limit.
Permissions: Manage the addon from the dashboard. Slash command access can be restricted to specific roles in the dashboard.

Associated Commands

/automessage list

Lists all configured automated messages for the server, including their ID, channel, interval, status, and next scheduled send time.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role if role restriction is configured.
Example: /automessage list

/automessage add

/automessage add name:<text> channel:<channel> content:<text> interval:<minutes>

Creates a new automated message that will post to the specified channel on the given interval. Interval must be between 5 and 10080 minutes. Free servers are limited to one message.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role if role restriction is configured.
Example: /automessage add name:Daily recap channel:#general content:Good morning everyone! interval:1440

/automessage remove

/automessage remove id:<message id>

Permanently removes an automated message by its ID. Use /automessage list to find message IDs.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role if role restriction is configured.
Example: /automessage remove id:3

/automessage toggle

/automessage toggle id:<message id>

Enables or disables an automated message without deleting it. Use /automessage list to find message IDs.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role if role restriction is configured.
Example: /automessage toggle id:3

Sticky Messages

FreeOptional

Keeps configured channel messages as the latest visible message after members chat.

Configuration: Enable the addon, then create and manage sticky messages from the dashboard or via /sticky. Create and edit open Discord modals so longer sticky content can be entered cleanly. Free servers can configure one sticky message; premium servers can configure multiple channels.
Permissions: Manage the addon from the dashboard. Base /sticky access and individual subcommands can be restricted to specific roles in the dashboard.

Associated Commands

/sticky list

Lists configured sticky messages, including IDs, channels, status, and content preview.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role if role restriction is configured.
Example: /sticky list

/sticky create

/sticky create channel:<channel> embed? color?

Opens a modal to create a sticky message for a text or announcement channel. Embed mode defaults to on and supports Discord markdown in the embed description.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role for /sticky create if role restrictions are configured. Free servers are limited to one sticky message.
Example: /sticky create channel:#rules embed:true color:#6C5CE7

/sticky edit

/sticky edit id:<sticky id>

Opens a modal to edit an existing sticky message's content and embed color. Use /sticky list to find IDs.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role for /sticky edit if role restrictions are configured.
Example: /sticky edit id:2

/sticky message

/sticky message channel:<channel> message:<message id or link> embed? color?

Creates or updates a sticky by copying content from an existing Discord message in the selected channel.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role for /sticky message if role restrictions are configured. Free servers are limited to one sticky message.
Example: /sticky message channel:#announcements message:123456789012345678 embed:true color:#6C5CE7

/sticky remove

/sticky remove id:<sticky id>

Permanently removes a sticky message by its ID. Use /sticky list to find IDs.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role for /sticky remove if role restrictions are configured.
Example: /sticky remove id:2

/sticky toggle

/sticky toggle id:<sticky id>

Enables or disables a sticky message without deleting it.

Permissions: Addon must be enabled. Command must be enabled. Member must have a permitted role for /sticky toggle if role restrictions are configured.
Example: /sticky toggle id:2

Reaction Roles

FreeOptional

Let members self-assign or remove roles from Discord button panels.

Configuration: Enable the addon, create panels in the dashboard or with /reactionrole, then post panels to the configured channel.
Permissions: Addon and /reactionrole command must be enabled. Slash command access can be restricted to configured roles. ProtoBot must be above the roles it manages in Discord role hierarchy.

Associated Commands

/reactionrole list

Lists configured reaction role panels with IDs, status, channels, and role options.

Permissions: Reaction Roles addon and /reactionrole command must be enabled. Member must have a permitted role if role restrictions are configured.
Example: /reactionrole list

/reactionrole create

/reactionrole create channel:<channel> role:<role> title:<text> description:<text> label? emoji?

Creates a simple one-role button panel that members can use to toggle the selected role.

Permissions: Reaction Roles addon and /reactionrole command must be enabled. Member must have a permitted role if role restrictions are configured. ProtoBot must be above the managed role.
Example: /reactionrole create channel:#roles role:@Events title:Event Alerts description:Click to toggle event pings label:Event alerts emoji::bell:

/reactionrole post

/reactionrole post id:<panel id>

Posts a configured reaction role panel to its channel.

Permissions: Reaction Roles addon and /reactionrole command must be enabled. Member must have a permitted role if role restrictions are configured.
Example: /reactionrole post id:1

/reactionrole toggle

/reactionrole toggle id:<panel id>

Enables or disables a reaction role panel without deleting it.

Permissions: Reaction Roles addon and /reactionrole command must be enabled. Member must have a permitted role if role restrictions are configured.
Example: /reactionrole toggle id:1

/reactionrole remove

/reactionrole remove id:<panel id>

Removes a reaction role panel by ID.

Permissions: Reaction Roles addon and /reactionrole command must be enabled. Member must have a permitted role if role restrictions are configured.
Example: /reactionrole remove id:1