liveJust banned:mesutkomser9725·2 hours ago9lookups today3servers protected
FiveBan
Sign in

Discord blacklist bot

FiveBan | Blacklist is a Discord bot Pro and Business customers can invite to their own Discord server. Once paired, members with a chosen role can issue network-wide bans with a slash command — no need to open the dashboard.

⚠️ Bans issued via this bot are global. They affect every FiveBan-protected server, not just yours. Treat the configured role as a network-moderator role and only give it to people you trust to ban cheaters across the entire FiveBan network.

Requirements

  • An active Pro or Business plan (the dashboard block is hidden on Free).
  • You're the owner or a co-owner of the server in the FiveBan dashboard.
  • On your own Discord guild, you have Manage Server permission (needed to run /setup).

1 — Generate a pairing token

  1. Open your dashboard.
  2. Find the server card and scroll to FiveBan Blacklist Bot.
  3. Click Generate pairing token. The token appears below; copy it.

The token is one-time and valid for 1 hour. If you don't run /setup in time, just generate a new one.

2 — Invite the bot

In the same dashboard block, click Add FiveBan | Blacklist. You'll be sent to Discord's authorization screen — pick the guild you want, accept the permissions, and confirm.

The bot needs only:

  • View Channels — see the channel where bans are issued
  • Send Messages — post confirmations
  • Read Message History — needed for slash command replies
  • Use Application Commands — register /setup and /ban

3 — Pair the guild

In your guild, run:

/setup pairing_token:<your-token> channel:#bans role:@Mod
  • pairing_token — paste the token from step 1
  • channel — the channel where /ban will be allowed
  • role — the role required to use /ban in that channel

If everything checks out, the bot replies with:

✅ Paired to FiveBan server #N • /ban will work in #bans for members with @Mod • Bans issued here are global across the FiveBan network.

4 — Issue a ban

Inside the configured channel, anyone with the configured role can run:

/ban discord_id:123456789012345678 reason:cheating evidence:https://…

Or the alias:

/blacklist discord_id:123456789012345678 reason:cheating evidence:https://…

The bot replies (ephemeral — only you see it) with the recorded ban ID. The player is immediately marked as confirmed in FiveBan's database and every FiveBan-protected FiveM server will auto-kick them on connect. Business-tier customer webhooks fire as well.

Restrictions enforced server-side

The FiveBan backend checks every /ban request:

| Check | Failure message | |---|---| | Guild is paired | This guild is not paired yet. Run /setup first. | | Used in the configured channel | /ban can only be used in the channel configured during /setup. | | Caller has the configured role | You don't have the role configured for issuing bans. | | Plan is still Pro/Business | Your FiveBan plan no longer qualifies for the Blacklist Bot. | | Plan hasn't expired | Your Pro/Business plan has expired — please renew at fiveban.xyz/pricing. | | Reason ≥ 3 characters | Reason must be at least 3 characters. |

Re-pairing or moving the channel

Run /setup again with a fresh pairing token — it overwrites the existing binding (channel/role/server) for that guild. There can be only one binding per Discord guild.

If you change plans or move the FiveBan dashboard ownership, also re-pair so the binding points to the right server entry.

Removing the bot

Either kick FiveBan | Blacklist from your guild, or contact us via the Discord ticket flow to drop the binding. Once unbound, /ban from that guild stops working immediately even if the bot is still present.

Troubleshooting

"Pairing token is invalid, already used or expired" You either used the token already, or more than 1 hour passed since you generated it. Generate a new one.

"This server does not have an active Pro/Business plan" The FiveBan server tied to that token isn't on Pro/Business right now. Upgrade via the buying ticket or pick the correct server in the dashboard.

Slash commands don't appear Discord caches slash commands per-user. Wait ~1 minute, restart Discord client, or kick + re-invite the bot. The bot syncs commands globally on startup.

"Bot is misconfigured (shared secret mismatch). Contact FiveBan staff." The bot's shared secret doesn't match the one our backend expects. This is a FiveBan-side ops issue — open a ticket and we'll fix it.

Related