From WikiChip
Difference between revisions of "mirc/commands/ban"
(→Types (numbered masks)) |
(→Parameters) |
||
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 [https://en.wikichip.org/wiki/mirc/identifiers/$address $address] or [https://en.wikichip.org/wiki/mirc/identifiers/$mask $mask]. | * '''[type]''' - The address type to use for the ban. This must be a number. Can see all types here [https://en.wikichip.org/wiki/mirc/identifiers/$address $address] or [https://en.wikichip.org/wiki/mirc/identifiers/$mask $mask]. |
Revision as of 19:45, 4 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
/ban [-ruN] [#channel] <nickname|address> [type] /ban -k[ruN] [#channel] <nickname|address> [type] [kick message]
Switches
- -k - Bans and kicks the user
- -r - Used to remove a banned address
- -uN - Unsets the ban in N amount of seconds
Parameters
- [#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)
- 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
;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
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
mIRC commands list