Features Commands Docs Trust Center Support 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

Set your server's alert channel and automatic action for blacklisted users. Run this first after adding the bot.

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, or ban. Default: none.

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.

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.

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?
Yes - completely free. Add it to any server at no cost. There are no paid tiers, premium gates, or feature limits. Donations help cover hosting costs but are entirely optional.
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, or ban). 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.