From WikiChip
Difference between revisions of "mirc/commands/ban"
(format error fixed) |
(→Parameters) |
||
(35 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
− | 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 | + | {{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. | ||
== Synopsis == | == Synopsis == | ||
Line 11: | 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 | + | * '''[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]''' - kick message | + | * '''[kick message]''' - The optional kick message. |
+ | |||
+ | == Types (numbered masks) == | ||
+ | |||
+ | * '''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 == | == Example == | ||
Line 20: | Line 37: | ||
/ban Foo 2 | /ban Foo 2 | ||
− | ;Ban/Kick Mike202 from the active channel with a kick message of "Owned!" | + | ;Ban/Kick for nick Mike202 from the active channel with a kick message of "Owned!" |
;Unset ban after 60 seconds | ;Unset ban after 60 seconds | ||
/ban -ku60 Mike202 Owned! | /ban -ku60 Mike202 Owned! | ||
− | ;Ban/ | + | ;Ban/Kick for nick Dave from #FooBar with a kick message of "Bye!" |
− | ;ban type | + | ;ban type 4 - this number corresponds to the mask (*!*@*.host) |
− | /ban -k #FooBar | + | /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 9 - this number corresponds to the mask (nick!*@*.host) | ||
+ | /ban -ku3600 #KindSmile Troll 9 Your trolling is not welcome here! | ||
+ | </syntaxhighlight> | ||
== Compatibility == | == Compatibility == | ||
− | + | {{mIRC compatibility|2.1a}} | |
− | |||
− | |||
− | |||
− | |||
== See also == | == See also == | ||
* [[List of commands - mIRC|List of commands]] | * [[List of commands - mIRC|List of commands]] | ||
* [[List of identifiers - mIRC|List of identifiers]] | * [[List of identifiers - mIRC|List of identifiers]] | ||
− | * | + | * {{mIRC|$banmask}} |
− | * | + | * {{mIRC|$bnick}} |
− | * | + | * {{mIRC|$ibl}} |
− | * | + | * {{mIRC|$mask}} |
− | * | + | * {{mIRC|$address}} |
− | * | + | * {{mIRC|$chan}} |
+ | * {{mIRC|$nick}} | ||
+ | * {{mIRC|/mode}} | ||
+ | |||
+ | {{mIRC command list}} | ||
− | [[Category:mIRC commands]] | + | [[Category:mIRC commands|ban command - mIRC]] |
Latest revision as of 06:44, 5 May 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 9 - this number corresponds to the mask (nick!*@*.host) /ban -ku3600 #KindSmile Troll 9 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