From WikiChip
Difference between revisions of "mirc/commands/ban"
< mirc‎ | commands

(Parameters)
(Parameters)
 
(33 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 [[/userhost command - mIRC|/userhost command]] to find the user's address before applying a ban.
+
{{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]''' - The optionnam 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/kick Dave3 from #FooBar with a kick message of "Cya!"
+
;Ban/Kick for nick Dave from #FooBar with a kick message of "Bye!"
;ban type 2
+
;ban type 4 - this number corresponds to the mask (*!*@*.host)
/ban -k #FooBar Dave3 2 Cya!</syntaxhighlight>
+
/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 ==
Added: mIRC v2.1a
+
{{mIRC compatibility|2.1a}}
 
 
Added On: 28/02/95
 
 
 
<small>Note: Individual switches were not taken into consideration.</small>
 
  
 
== 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]]
* [[$banmask identifier - mIRC|$banmask]]
+
* {{mIRC|$banmask}}
* [[$bnick identifier - mIRC|$bnick]]
+
* {{mIRC|$bnick}}
* [[$ibl identifier - mIRC|$ibl]]
+
* {{mIRC|$ibl}}
* [[$address identifier - mIRC|$address]]
+
* {{mIRC|$mask}}
* [[$chan identifier - mIRC|$chan]]
+
* {{mIRC|$address}}
* [[$nick identifier - mIRC|$nick]]
+
* {{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

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[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]


v · d · e mIRC commands list

A /abook, /action, /add, /ajinvite, /alias, /aline, /ame, /amsg, /anick, /aop, /auser, /auto, /autojoin, /avoice, /away

B /background, /ban, /bcopy, /beep, /bindip, /bread, /break, /breplace, /bset, /btrunc, /bunset, /bwrite

C /channel, /clear, /clearall, /clearial, /cline, /clipboard, /close, /closechats, /closedccs, /closefserves, /closemsg, /cnick, /color, /colour, /comclose, /comlist, /commands, /comopen, /comreg, /continue, /copy, /creq, /ctcp, /ctcpreply, /ctcps

D /dcc, /dccserver, /dde, /ddeserver, /debug, /dec, /describe, /dialog, /did, /didtok, /disable, /disconnect, /dlevel, /dline, /dll, /donotdisturb, /dns, /dqwindow, /drawcopy, /drawdot, /drawfill, /drawline, /drawpic, /drawrect, /drawreplace, /drawrot, /drawsave, /drawscroll, /drawsize, /drawtext

E /ebeeps, /echo, /editbox, /else, /elseif, /emailaddr, /enable, /events, /exit

F /fclose, /filter, /findtext, /finger, /firewall, /flash, /flist, /flood, /flush, /flushini, /fnord, /font, /fopen, /fseek, /fsend, /fserve, /fullname, /fupdate, /fwrite

G /ghide, /gload, /gmove, /gopts, /goto, /gplay, /gpoint, /gqreq, /groups, /gshow, /gsize, /gstop, /gtalk, /gunload, /guser

H /hadd, /halt, /haltdef, /hdec, /hdel, /help, /hfree, /hinc, /hload, /hmake, /hotlink, /hop, /hsave

I /ial, /ialclear, /ialmark, /identd, /if, /ignore, /iline, /inc, /iuser

J /join

L /leave, /linesep, /links, /list, /load, /loadbuf, /localinfo, /log, /logview

M /maxdepth, /mdi, /me, /menubar, /mkdir, /mnick, /mode, /msg

N /noop, /notice, /notify

O /onotice, /omsg

Q /qme, /qmsg, /query, /queryrn, /quit, /quote

P /parseline, /part, /partall, /pdcc, /perform, /play, /playctrl, /pop, /protect, /proxy, /pvoice

R /raw, /registration, /reload, /remini, /remote, /remove, /rename, /renwin, /reseterror, /resetidle, /return, /returnex, /rlevel, /rline, /rmdir, /run, /ruser

S /save, /savebuf, /saveini, /say, /scid, /scon, /server, /set, /setlayer, /showmirc, /signal, /sline, /sockaccept, /sockclose, /socklist, /socklisten, /sockmark, /sockopen, /sockpause, /sockread, /sockrename, /sockudp, /sockwrite, /sound, /speak, /splay, /sreq, /strip, /switchbar

T /timer, /timestamp, /tip, /tips, /titlebar, /tnick, /tokenize, /toolbar, /topic, /tray, /treebar

U /ulist, /unload, /unset, /unsetall, /updatenl, /url, /username, /uwho

V /var, /vcadd, /vcmd, /vcrem, /vol

W /wallchops, /wavplay, /while, /window, /winhelp, /write, /writeini

X /xyzzy