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.