docs/moderation/banning_users.md

# Banning Users

{% hint style="warning" %}
This page is partially outdated, and therefore not everything described in this page may work with the latest versions of the bot. Please give us some time and we'll update these pages.
{% endhint %}

## Normal Ban

Use the `-ban` command to ban a user, regardless if they are in the server or not.

**Legacy Command**

```
-ban <UserID|UserMention|UserTag> [-d=DAYS] [Reason]
```

**Options**:

* `-d`: Specify the how many days old messages to delete. Must be in range of 0-7. Default is - "Don't delete any".

**Slash Command**

```
/ban <User> [days] [reason]
```

**Examples**

```
-ban @Someone
-ban @Someone Spamming a lot
-ban @Someone -d 5 Spamming a lot
-ban 45643846466843
-ban 45643846466843 Spamming a lot
-ban 45643846466843 -d 7 Spamming a lot
```

## Temporary Ban

Temporarily ban users.

**Legacy Command**

```
-tempban <UserID|UserMention> <Time> [Reason]
```

**Slash Command**

```
/tempban <UserID> <Time> [days] [reason]
```

**Examples**

```
-tempban @Someone 1h
-tempban @Someone 30m Spamming a lot
-tempban 45643846466843 2m
-tempban 45643846466843 5d Spamming a lot
```

## Softban

Ban a user and unban immediately to remove messages from the user.

**Legacy Command**

```
-softban <UserID|UserMention> [-d=DAYS_OF_MESSAGE_DELETION] [Reason]
```

**Slash Command**

```
/softban <UserID> [-d=DAYS_OF_MESSAGE_DELETION] [days] [reason]
```

**Options**:

* `-d`: Specify the how many days old messages to delete. Must be in range of 0-7. Default is `7`.

**Examples**

```
-tempban @Someone 1h
-tempban @Someone 30m Spamming a lot
-tempban 45643846466843 2m
-tempban 45643846466843 5d Spamming a lot
```

## Mass Ban

Use the `-massban` command to massban users.

**Legacy Command**

```
-massban <...UserIDs|UserMentions> [Reason]
```

**Slash Command**

```
/massban <...UserIDs> [days] [reason]
```

{% hint style="info" %}
While using slash command, the IDs must be separated with spaces.
{% endhint %}

**Examples**

```
-massban 23626825621964 217216291276407
-massban 23626825621964 217216291276407 63876523582826865 Raiding the Server
-massban 23626825621964 217216291276407 @Someone 36362742746674467
```

## Unbanning

Use the `-unban` command to unban users.

**Legacy Command**

```
-unban <UserID>
```

**Slash Command**

```
/unban <UserID>
```

**Examples**

```
-unban 7485692162169
```
1	rakinar2	577	# Banning Users
2
3			{% hint style="warning" %}
4			This page is partially outdated, and therefore not everything described in this page may work with the latest versions of the bot. Please give us some time and we'll update these pages.
5			{% endhint %}
6
7			## Normal Ban
8
9			Use the `-ban` command to ban a user, regardless if they are in the server or not.
10
11			Legacy Command
12
13			```
14			-ban <UserID\|UserMention\|UserTag> [-d=DAYS] [Reason]
15			```
16
17			Options:
18
19			* `-d`: Specify the how many days old messages to delete. Must be in range of 0-7. Default is - "Don't delete any".
20
21			Slash Command
22
23			```
24			/ban <User> [days] [reason]
25			```
26
27			Examples
28
29			```
30			-ban @Someone
31			-ban @Someone Spamming a lot
32			-ban @Someone -d 5 Spamming a lot
33			-ban 45643846466843
34			-ban 45643846466843 Spamming a lot
35			-ban 45643846466843 -d 7 Spamming a lot
36			```
37
38			## Temporary Ban
39
40			Temporarily ban users.
41
42			Legacy Command
43
44			```
45			-tempban <UserID\|UserMention> <Time> [Reason]
46			```
47
48			Slash Command
49
50			```
51			/tempban <UserID> <Time> [days] [reason]
52			```
53
54			Examples
55
56			```
57			-tempban @Someone 1h
58			-tempban @Someone 30m Spamming a lot
59			-tempban 45643846466843 2m
60			-tempban 45643846466843 5d Spamming a lot
61			```
62
63			## Softban
64
65			Ban a user and unban immediately to remove messages from the user.
66
67			Legacy Command
68
69			```
70			-softban <UserID\|UserMention> [-d=DAYS_OF_MESSAGE_DELETION] [Reason]
71			```
72
73			Slash Command
74
75			```
76			/softban <UserID> [-d=DAYS_OF_MESSAGE_DELETION] [days] [reason]
77			```
78
79			Options:
80
81			* `-d`: Specify the how many days old messages to delete. Must be in range of 0-7. Default is `7`.
82
83			Examples
84
85			```
86			-tempban @Someone 1h
87			-tempban @Someone 30m Spamming a lot
88			-tempban 45643846466843 2m
89			-tempban 45643846466843 5d Spamming a lot
90			```
91
92			## Mass Ban
93
94			Use the `-massban` command to massban users.
95
96			Legacy Command
97
98			```
99			-massban <...UserIDs\|UserMentions> [Reason]
100			```
101
102			Slash Command
103
104			```
105			/massban <...UserIDs> [days] [reason]
106			```
107
108			{% hint style="info" %}
109			While using slash command, the IDs must be separated with spaces.
110			{% endhint %}
111
112			Examples
113
114			```
115			-massban 23626825621964 217216291276407
116			-massban 23626825621964 217216291276407 63876523582826865 Raiding the Server
117			-massban 23626825621964 217216291276407 @Someone 36362742746674467
118			```
119
120			## Unbanning
121
122			Use the `-unban` command to unban users.
123
124			Legacy Command
125
126			```
127			-unban <UserID>
128			```
129
130			Slash Command
131
132			```
133			/unban <UserID>
134			```
135
136			Examples
137
138			```
139			-unban 7485692162169
140			```