Difference between revisions of "mirc/on events/on join"

Latest revision as of 08:03, 6 February 2024

The ON JOIN event triggers when the mIRC client, or a remote user, joins a channel.

Note: When you join a channel yourself, $nick($chan,0) is always 1 inside the ON JOIN event because mIRC has to send /names to get the nickname; if you want to undertake some processing once the channel user list is complete, then use the RAW 366 event which indicates the end of the user list. Similarly, if you're an operator on the channel, you won't have been opped at the point that the ON JOIN event runs, so if you need to use your op capabilities inside the event script then you should use the ON OP event instead.

Synopsis[edit]

ON <level>:JOIN:<#[,#]>:<commands>

Parameters[edit]

<level>The corresponding access levels for the event to trigger.

<#,[,#]>The text that to be matched. Can also be a wildcard.

[,#]Specific channel names

<commands>The commands to be performed when the event listener's criteria is met.

Examples[edit]

The following example makes use of the ON ME event, which triggers only when the local mIRC client triggers the event, not remote users.

ON ME:*:JOIN:#testing: { msg $chan Hello $chan - Today is $day and time is $time }

The following example works for everyone else who joins but except your self.

ON !*:JOIN:#mychan: { msg $chan Hey $nick $+ ! Welcome in our channel. }

Who ever joins, send them a greeting:

ON *:JOIN:#:msg # Welcome to # $+ , $nick $+ !

Override the join event to print a custom text and then tell mIRC to ignore it's own text.

on ^*:JOIN:*:{
  echo -tcbf join $chan * $nick ( $+ $fulladdress $+ ) join $chan
  halt
}

Compatibility[edit]

Added: mIRC v4.5
Added on: 30 Jun 1996
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also[edit]

mIRC on event list

A on Action, on Active, on Agent, on Appactive

B on Ban

C on Char, on Chat, on Chatclose, on Chatopen, on Close, on Connect, on Connectfail, on Ctcpreply

D on Dccserver, on Dehelp, on Deop, on Deowner, on Devoice, on Dialog, on Disconnect, on Dns

E on Error, on Exit

F on Filercvd, on Filesent

G on Getfail

H on Help, on Hotlink

I on Input, on Invite

J on Join

K on Keydown, on Keyup, on Kick

L on Load, on Logon

M on Midiend, on Mode, on Mp3end

N on Nick, on Nosound, on Notice, on Notify

O on Op, on Open, on Owner

P on Parseline, on Part, on Ping, on Playend, on Pong

Q on Queryclose, on Queryopen, on Quit

R on Rawmode

S on Sendfail, on Serv, on Servclose, on Servermode, on Serverop, on Servopen, on Signal, on Snotice, on Sockclose, on Socklisten, on Sockopen, on Sockread, on Sockwrite, on Start

T on Text, on Topic

U on Udpread, on Udpwrite, on Unban, on Unload, on Unotify, on Usermode

V on Vcmd, on Voice

W on Wallops, on Waveend

@@ Line 1: / Line 1: @@
+{{mirc title|On Join - Events}}
 The '''ON JOIN''' event triggers when the mIRC client, or a remote user, joins a channel.
+'''Note''': When you join a channel yourself, $nick($chan,0) is always 1 inside the ON JOIN event because mIRC has to send /names to get the nickname; if you want to undertake some processing once the channel user list is complete, then use the RAW 366 event which indicates the end of the user list. Similarly, if you're an operator on the channel, you won't have been opped at the point that the ON JOIN event runs, so if you need to use your op capabilities inside the event script then you should use the ON OP event instead.
 == Synopsis ==
@@ Line 5: / Line 8: @@
 == Parameters ==
-<span style="display: inline-block; width: 105px;">'''<level>'''</span>The level for the event to trigger.
+<span style="display: inline-block; width: 105px;">'''<level>'''</span>The corresponding {{mIRC|access levels}} for the event to trigger.
-<span style="display: inline-block; width: 105px;">'''<#,[,#]>'''</span>The text that to be matched. Can also be a [[wildcard]].
+<span style="display: inline-block; width: 105px;">'''<#,[,#]>'''</span>The text that to be matched. Can also be a {{mirc|wildcard}}.
 <div style="background-color: rgba(0,0,0,.06); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 60px;">'''[,#]'''</span>Specific channel names</div>
@@ Line 14: / Line 17: @@
 == Examples ==
-Once the local mIRC client has joined a channel, echo to the channel window the total users inside of the channel:
-<source lang="mIRC">ON ME:*:JOIN:#:echo # Total Users: $nick(#,0)</source>
-The above example makes use of the [[on me - mIRC|ON ME]] event, which triggers only when the local mIRC client triggers the event, not remote users.
+The following example makes use of the [[on me - mIRC|ON ME]] event, which triggers only when the local mIRC client triggers the event, not remote users.
+<source lang="mIRC">ON ME:*:JOIN:#testing: { msg $chan Hello $chan - Today is $day and time is $time }</source>
-When a user joins, send them a greeting:
+The following example works for everyone else who joins but except your self.
+<source lang="mIRC">ON !*:JOIN:#mychan: { msg $chan Hey $nick $+ ! Welcome in our channel. }</source>
+Who ever joins, send them a greeting:
 <source lang="mIRC">ON *:JOIN:#:msg # Welcome to # $+ , $nick $+ !</source>
+Override the join event to print a custom text and then tell mIRC to ignore it's own text.
+<source lang="mIRC">
+on ^*:JOIN:*:{
+  echo -tcbf join $chan * $nick ( $+ $fulladdress $+ ) join $chan
+  halt
+}
+</source>
 == Compatibility ==
-{{mIRC compatibility|2.1a}}
+{{mIRC compatibility|4.5}}
 == See Also ==
 * [[on part - mIRC|ON PART]]
-* [[list of on events - mIRC|ON EVENTS]]
+* {{mIRC|on events|List of on events}}
 {{mIRC on event list}}
 [[Category:mIRC on events|join]]

WikiChip

The Fuse Coverage

Social Media

Companies

Microarchitectures

Technology Nodes

Intel

AMD

ARM

Cavium

Samsung

Intel

AMD

Ampere

Apple

Cavium

HiSilicon

MediaTek

NXP

Qualcomm

Renesas