/blacklist - User Blacklist Management

The /blacklist command manages the user blacklist, preventing specific users from using the bot.

Admin Only

This command requires the Admin Role to use.

Command Usage

/blacklist add <user> [duration]
/blacklist remove <user>
/blacklist list

Subcommands

`/blacklist add`

Add a user to the blacklist.

Options:

Option	Type	Required	Description
`user`	User	Yes	The user to blacklist
`duration`	String	No	Duration format: 1s, 1m, 1h, 1d (permanent if blank)

Examples:

/blacklist add user:@Spammer
→ Permanent blacklist

/blacklist add user:@TroubleMaker duration:1h
→ Blacklisted for 1 hour

/blacklist add user:@Raider duration:30m
→ Blacklisted for 30 minutes

`/blacklist remove`

Remove a user from the blacklist.

Options:

Option	Type	Required	Description
`user`	User	Yes	The user to unblacklist

Example:

/blacklist remove user:@FormerSpammer
→ User can use bot again

`/blacklist list`

Display all blacklisted users.

Options: None

Features:

Paginated display
Shows expiration status
Navigation buttons

Duration Formats

Format	Duration
`1s`	1 second
`30s`	30 seconds
`1m`	1 minute
`15m`	15 minutes
`1h`	1 hour
`12h`	12 hours
`1d`	1 day
`7d`	7 days

Response Format

Add (Permanent)

ok blacklisted @UserTag (permanent)

Add (Temporary)

ok blacklisted @UserTag (until <time>)

Remove

ok unblacklisted @UserTag

List

## blacklisted users
page 1 of 3

`123456789` - Spammer#1234 (permanent)
`987654321` - Troublemaker#5678 (expires in 30 minutes)

How Blacklisting Works

Command Blocking

When a blacklisted user tries to use a command:

you are blacklisted from using rynzen.

Admin Exception

Admins can still use commands even if blacklisted.

Step-by-Step Guide

Blacklist a User

Run Command

/blacklist add user:@TargetUser

Optional Duration

/blacklist add user:@TargetUser duration:24h

Confirmation

User added to blacklist
Expiration set (if duration provided)

Remove from Blacklist

Run Command

/blacklist remove user:@FormerOffender

Confirmation

User removed from blacklist
Can use bot again

View Blacklist

Run Command

/blacklist list

Navigate Pages

Use < and > buttons
Browse all entries

Use Cases

Spam Prevention

Block users who spam commands
Temporary cooldown for offenders
Protect bot from abuse

Moderation Tool

Supplement server moderation
Enforce server rules
Manage disruptive users

Security

Block known bad actors
Prevent ban evasion
Control bot access

Temporary Blacklist Behavior

Expiration

Automatically expires after duration
User regains access automatically
No manual removal needed

Display

Shows relative expiration time
"expires in X" or "expired X ago"
Updated on list view

List Pagination

[<] [>]

< - Previous page (disabled on first page)
> - Next page (disabled on last page)

Admin Permissions

Required Role

Must have Admin Role ID
Configured in bot settings
Checked on every interaction

Example Workflows

Temporary Timeout

User spams commands
→ /blacklist add user:@Spammer duration:1h
→ User blocked for 1 hour
→ Automatically unbanned

Permanent Ban

User severely abuses bot
→ /blacklist add user:@Abuser
→ Permanent blacklist
→ Manual review required for removal

Mass Review

/blacklist list
→ Review all blacklisted users
→ Remove expired/temporary bans
→ Clean up blacklist

/admin-tools - Full admin panel
/leaderboard - View raid statistics