From WikiChip
Difference between revisions of "mirc/commands/ban"
(→Example) |
(→Example) |
||
(6 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{mirc title|/ban Command}} | {{mirc title|/ban Command}} | ||
− | The '''/ban command''' is used to ban someone from a specific channel using their address. If no channel specified mIRC will use the active channel window. Using the -k switch mIRC will also kick the user with a kick message. mIRC uses the /userhost server command to find the user's address before applying a ban. | + | The '''/ban command''' is used to ban someone from a specific channel using their address. If no channel specified mIRC will use the active channel window. Using the '''-k''' switch mIRC will also kick the user with a kick message. mIRC uses the /userhost server command to find the user's address before applying a ban. |
== Synopsis == | == Synopsis == | ||
Line 12: | Line 12: | ||
== Parameters == | == Parameters == | ||
− | * '''[#channel]''' - A specific channel to apply the ban on. | + | * '''[#channel]''' - A specific channel to apply the ban on. If not specified, then in the active channel. |
* '''<nickname|address>''' - The nick or address to use for the ban. | * '''<nickname|address>''' - The nick or address to use for the ban. | ||
− | * '''[type]''' - The address type to use for the ban. This must be a number. Can see all types here | + | * '''[type]''' - The address type to use for the ban. This must be a number. Can see all types here {{mIRC|$address}} or {{mIRC|$mask}}. |
* '''[kick message]''' - The optional kick message. | * '''[kick message]''' - The optional kick message. | ||
== Types (numbered masks) == | == Types (numbered masks) == | ||
− | * 0 | + | |
− | * 1 | + | * '''0''' = *!user@host |
− | * 2 | + | * '''1''' = *!*user@host |
− | * 3 | + | * '''2''' = *!*@host |
− | * 4 | + | * '''3''' = *!*user@*.host |
− | * 5 | + | * '''4''' = *!*@*.host |
− | * 6 | + | * '''5''' = nick!user@host |
− | * 7 | + | * '''6''' = nick!*user@host |
− | * 8 | + | * '''7''' = nick!*@host |
− | * 9 | + | * '''8''' = nick!*user@*.host |
− | Type 10-19 are same as types 0-9 except asterisks in host are expanded to the text they replaced, then all numbers are replaced by question marks. | + | * '''9''' = nick!*@*.host |
+ | |||
+ | |||
+ | Type '''10-19''' are same as types '''0-9''' except asterisks in host are expanded to the text they replaced, then all numbers are replaced by question marks. | ||
== Example == | == Example == | ||
Line 38: | Line 41: | ||
/ban -ku60 Mike202 Owned! | /ban -ku60 Mike202 Owned! | ||
− | ;Ban/ | + | ;Ban/Kick for nick Dave from #FooBar with a kick message of "Bye!" |
;ban type 4 - this number corresponds to the mask (*!*@*.host) | ;ban type 4 - this number corresponds to the mask (*!*@*.host) | ||
/ban -k #FooBar Dave 4 Bye! | /ban -k #FooBar Dave 4 Bye! | ||
− | ;Ban/ | + | ;Ban/Kick for nick Troll from #KindSmile with a kick message of "Your trolling is not welcome here!" |
;Unset ban after 3600 seconds (1 hour) | ;Unset ban after 3600 seconds (1 hour) | ||
− | ;ban type | + | ;ban type 2 - this number corresponds to the mask (*!*@host) |
− | /ban -ku3600 #KindSmile Troll | + | /ban -ku3600 #KindSmile Troll 2 Your trolling is not welcome here! |
</syntaxhighlight> | </syntaxhighlight> | ||
Latest revision as of 05:17, 11 October 2025
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
The /ban command is used to ban someone from a specific channel using their address. If no channel specified mIRC will use the active channel window. Using the -k switch mIRC will also kick the user with a kick message. mIRC uses the /userhost server command to find the user's address before applying a ban.
Contents
Synopsis[edit]
/ban [-ruN] [#channel] <nickname|address> [type] /ban -k[ruN] [#channel] <nickname|address> [type] [kick message]
Switches[edit]
- -k - Bans and kicks the user
- -r - Used to remove a banned address
- -uN - Unsets the ban in N amount of seconds
Parameters[edit]
- [#channel] - A specific channel to apply the ban on. If not specified, then in the active channel.
- <nickname|address> - The nick or address to use for the ban.
- [type] - The address type to use for the ban. This must be a number. Can see all types here $address or $mask.
- [kick message] - The optional kick message.
Types (numbered masks)[edit]
- 0 = *!user@host
- 1 = *!*user@host
- 2 = *!*@host
- 3 = *!*user@*.host
- 4 = *!*@*.host
- 5 = nick!user@host
- 6 = nick!*user@host
- 7 = nick!*@host
- 8 = nick!*user@*.host
- 9 = nick!*@*.host
Type 10-19 are same as types 0-9 except asterisks in host are expanded to the text they replaced, then all numbers are replaced by question marks.
Example[edit]
;Ban Foo's address (type 2) in the active channel window /ban Foo 2 ;Ban/Kick for nick Mike202 from the active channel with a kick message of "Owned!" ;Unset ban after 60 seconds /ban -ku60 Mike202 Owned! ;Ban/Kick for nick Dave from #FooBar with a kick message of "Bye!" ;ban type 4 - this number corresponds to the mask (*!*@*.host) /ban -k #FooBar Dave 4 Bye! ;Ban/Kick for nick Troll from #KindSmile with a kick message of "Your trolling is not welcome here!" ;Unset ban after 3600 seconds (1 hour) ;ban type 2 - this number corresponds to the mask (*!*@host) /ban -ku3600 #KindSmile Troll 2 Your trolling is not welcome here!
Compatibility[edit]
Added: mIRC v2.1a
Added on: 28 Feb 1995
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.
See also[edit]
mIRC commands list