Features Docs Premium Trust Center Lookup Feed Add to Discord
Documentation

Command Reference

Full reference for every slash command - parameters, permission levels, and usage examples.

Getting Started

Blacklist Terminal connects to a global threat intelligence network the moment it joins your server. No initial setup is required - the bot will begin monitoring new members immediately.

To configure your alert channel and automatic action, run /config from any channel. Server administrators can change settings at any time.

/config Moderator

Configure your server's alert channel, automatic actions, spam protection, and notification roles. Run this first after adding the bot. All 7 settings are documented in the Config Reference below.

alert_channelThe text channel where Blacklist Terminal posts alerts when flagged users are detected. Optional - if not set, the bot falls back to your server's system channel, then to the first text channel it has permission to send in.
auto_actionWhat happens automatically when a blacklisted user joins: none (alert only), kick, ban, or role (assigns blacklist_role). Default: none.
spam_protectionEnable or disable the built-in anti-spam / raid protection system. Default: off.
spam_actionAction to take when spam is detected: mute, kick, or ban. Requires spam_protection to be on.
blacklist_roleRole assigned to blacklisted users when auto_action is set to role.
ping_roleRole to ping in the alert embed when a blacklisted user is detected.
watchlist_ping_roleRole to ping when a watchlisted user joins your server.

User Commands

Available to all server members with access to use slash commands - no special permissions required.

/checkuser Everyone

Look up any Discord user by their ID. Returns their full blacklist status, reason, date added, and evidence count.

discord_idThe Discord user ID to check (18-digit number). Right-click a user → Copy ID in developer mode.
/listusers Everyone

Browse the full list of blacklisted users in the global database - paginated, 10 per page. Use the Prev / Next buttons to navigate.

pagePage number to start on. Default: 1. Optional.
/userstats Everyone

View global network statistics: total blacklisted users, users added in the last 30 days, and database status.

Moderator Commands

Requires the Manage Server Discord permission in the server where the command is run.

/reportuser Moderator

Submit a report for a user. Reports from external servers go into a review queue - admins approve or reject before anything is added to the global blacklist.

discord_idThe Discord user ID of the person being reported.
reasonA clear description of the behavior or incident. Be specific - vague reports are harder to verify and more likely to be rejected.
evidence – evidence5Attach up to 5 screenshot or video files as evidence (PNG, JPG, GIF, WEBP, MP4, MOV - max 50MB each). Optional but strongly recommended.

Admin Commands

Requires bot admin access granted by the bot owner. Used to manage the global blacklist and review pending reports.

/approve Admin

Approve a pending report by its ID, adding the user to the global blacklist. Triggers real-time alerts across all connected servers where the user is a member.

report_idThe numeric ID of the pending report to approve (shown in the approval embed).
/reject Admin

Reject a pending report by its ID and remove it from the queue. The server that submitted the report is notified of the decision.

report_idThe numeric ID of the pending report to reject (shown in the approval embed).
/listevidence Admin

View all evidence files saved on the server for a specific user - filenames, types, and upload dates.

discord_idThe Discord user ID to look up evidence for.

Moderation Tools

Per-server moderation commands - free for all servers. Requires the Manage Server permission unless noted.

/watchlist add Moderator

Add a user to your server's local watchlist. Watchlisted users trigger an alert when they join, even if they're not on the global blacklist.

discord_idThe Discord user ID to watchlist.
reasonWhy this user is being watched. Shown in join alerts. Optional.
/watchlist remove Moderator

Remove a user from your server's local watchlist.

discord_idThe Discord user ID to remove.
/watchlist list Moderator

View all users currently on your server's watchlist with their reasons and dates added.

/quarantine Moderator

Quarantine a user - strips their roles and assigns the configured quarantine role, restricting server access. A DM is sent with appeal instructions. Requires quarantine_role to be set in /config.

userThe server member to quarantine.
reasonReason shown in the DM and logged in mod notes.
/unquarantine Moderator

Release a quarantined user and restore their original roles. The quarantine role is removed automatically.

userThe quarantined server member to release.
/appeal Everyone

Submit a quarantine appeal in the current server. Only available to users who are currently quarantined. Appeal is sent to the alert channel for moderator review.

reasonYour appeal message - explain why the quarantine should be lifted.
/note add Moderator

Attach a private moderation note to a user. Notes are only visible to your server's moderators and are never shared with the global network.

discord_idThe Discord user ID to attach the note to.
noteThe note content.
/note remove Moderator

Delete a specific moderation note by its note ID.

note_idThe numeric ID of the note to remove (shown in /note list).
/note list Moderator

View all moderation notes attached to a user in your server.

discord_idThe Discord user ID to look up notes for.
/multicheck Moderator

Check multiple Discord IDs against the global blacklist in a single command. Free tier supports up to 3 IDs at once. Premium extends this to 10 IDs.

id1 – id3Discord user IDs to check. id1 is required; id2 and id3 are optional (free tier). Premium unlocks id4 through id10.

Premium Commands ⭐ Premium

Available to servers with an active Premium subscription. View plans →

/riskcheck Premium

Advanced threat scoring for any Discord user. Analyzes account age, username patterns, shared servers, blacklist history, and behavioral signals - returns a risk score from 0–100 with a detailed breakdown.

discord_idThe Discord user ID to analyze.
/serverrisk Premium

Full security audit of your server. Scans all members against the blacklist, flags suspicious accounts and unverified bots, and generates a prioritized risk report with recommendations.

/botscan Premium

Scan your server for suspicious or unverified bots. Flags bots with unusual permission scopes, low trust scores, or patterns associated with raid and nuke bots.

/lookup Premium

Deep investigation on any Discord user ID. Returns full blacklist history, account metadata, shared server count, mod notes, evidence count, and a complete risk assessment in one embed.

discord_idThe Discord user ID to investigate.
/lockdown Premium

Lock channels to block all regular member messages. Three modes: default locks the current channel only, scope:server locks every text channel, scope:category locks all channels in the current category. The bot saves the existing permission state before locking - /unlockdown restores exactly what was there before, preserving any custom overrides.

scopeWhat to lock: channel (default - current channel only), server (all text channels), or category (all channels in the current category). Optional.
reasonReason for the lockdown. Posted in the alert channel. Optional.
/unlockdown Premium

Lift an active lockdown and restore channel send permissions for all regular members.

Network Features Free · Approved Servers

Available at no cost to approved partner servers. These commands connect your server to the Blacklist Terminal owner network - a private cross-server communication channel for server owners and trusted admins across the ecosystem. Blacklisted users are automatically silenced in the relay.

/ownerchat setup Moderator

Connect your server to the Owner Chat relay - a private cross-server channel for server owners and configured admin roles to communicate securely across the network. Messages sent in the relay channel are forwarded to every participating server with the sender's avatar, username, and server tag. Images, links, and embeds are supported.

channelThe text channel to use as your Owner Chat relay channel.
/ownerchat leave Moderator

Disconnect your server from the Owner Chat relay. Future messages will no longer be relayed to or from your server.

/ownerchat list Moderator

View all servers currently connected to the Owner Chat relay network.

Config Reference

All /config options and their defaults. Settings are per-server and can be changed at any time.

alert_channel

The text channel where the bot posts blacklist alert embeds when a flagged user is detected joining. If not set, defaults to the server's system channel. If no system channel is configured, the bot uses the first text channel it has permission to send in.

auto_action

The automatic action taken when a blacklisted user joins your server:

noneAlert only - no automatic kick or ban. Default setting. Recommended for first setup.
kickAutomatically kick the user from your server when detected. They can rejoin, but will be flagged again.
banAutomatically ban the user from your server when detected. Recommended for high-security servers.
roleAssigns the configured blacklist_role to the user instead of kicking or banning. The user remains visible in the member list with restricted access - moderators can review and act manually. Requires blacklist_role to be configured first.
blacklist_role

A role to assign to users who are detected as blacklisted when they join. Useful for restricting access without a full kick or ban - lets you review the user before taking action.

ping_role

A role to ping in the alert embed when a blacklisted user is detected. Useful for notifying your moderator team immediately. Leave unset to send alerts without a ping.

watchlist_ping_role

A role to ping when a watchlisted user joins your server. Separate from ping_role so you can route blacklist and watchlist alerts to different team members.

spam_protection

Enable or disable the built-in anti-spam / raid protection system. When on, the bot monitors for rapid-fire message spam and triggers the configured spam_action automatically.

onSpam detection active. Monitors for high-frequency message bursts.
offSpam detection disabled. Default setting.
spam_action

The action taken automatically when spam is detected (requires spam_protection to be on):

muteTemporarily mute the user when a spam burst is detected. Least disruptive option.
kickKick the user from the server when spam is detected.
banPermanently ban the user when spam is detected. Recommended for raid scenarios.

Permission Levels

Blacklist Terminal uses three permission levels to control access to commands.

Everyone

Any server member who can use slash commands. Can run /checkuser, /listusers, and /userstats.

Moderator

Users with the Manage Server Discord permission. Can run /reportuser to submit reports and /config to set up the bot.

Admin

Bot admins granted by the bot owner. Can approve and reject pending reports (/approve, /reject) and view evidence files (/listevidence).

Frequently Asked Questions

Common questions about how Blacklist Terminal works, what it stores, and what to expect.

Is Blacklist Terminal free to use?
Core protection is free for all servers - join alerts, /checkuser, /listusers, /reportuser, watchlist, quarantine, notes, and /multicheck (up to 3 IDs) are available at no cost. A Premium tier unlocks advanced commands: /riskcheck, /serverrisk, /lookup, /botscan, /lockdown, /unlockdown, and expanded /multicheck (up to 10 IDs). Network features (/ownerchat) are free for approved partner servers. Subscriptions help cover hosting, but you never need to pay to use the core bot.
What permissions does the bot need?
Blacklist Terminal requests Administrator permission during the invite flow. This allows it to kick or ban users when auto-action is enabled, post alerts in any channel, and respond to all slash commands.
How do I report a user to the network?
Use /reportuser with the user's Discord ID, a clear reason, and optionally up to 5 evidence files (screenshots, video). You need the Manage Server permission. Reports go into a review queue and are not public until an admin approves them.
What happens after I submit a report?
Your report enters the admin review queue. Admins review the reason and evidence before any action is taken. If approved, the user is added to the global blacklist and all connected servers are notified instantly. If rejected, your server receives a notification with a reason.
My report was rejected - can I resubmit?
Yes, if you have new or stronger evidence. Resubmitting the exact same report without additional evidence will likely be rejected again. Read the rejection reason carefully before resubmitting.
How do I set up alerts in my server?
Run /config and set an alert_channel and your preferred auto_action (none, kick, ban, or role). If you skip this, alerts fall back to your system channel. You can update settings at any time.
Does the bot read messages or monitor my server?
No. Blacklist Terminal only checks users against the blacklist when they join your server. It does not read, store, or monitor message content. The only data stored is Discord user IDs, report details, and per-server configuration.
What if I believe someone was wrongly blacklisted?
Anyone can submit an appeal through the Blacklist Terminal support server. Appeals are reviewed by the admin team and typically resolved within 48–72 hours. See the Trust Center for the full appeal process.