mIRC

Commands & Identifiers

• mSL Commands
• mSL Identifiers

Basics

• Introduction
• Variables
• String Manipulation
• Token Manipulation
• Aliases

Events

• On events
• Access levels
• Raw Events
• Ctcp Events

Matching Tools

• Wildcard
• Regex

Data Storage

• Variables
• File Handling
• Hash Tables
• Binary variables
• INI Files
• Text Files

Control Structures

• If Then Else
• Operators
• While Loops
• Goto Loops
• Groups

GUI Scripting

• Custom Windows
• Picture Windows
• Dialogs
• Dialog Components

Sockets

• Sockets
• TCP Sockets
• UDP Sockets

Advanced Scripting

• Eval Brackets
• COM
• DLL
• SendMessage

Additional Resources

• mSL Commands
• mSL Identifiers
• mSL Local Identifiers
• mSL Events
• mSL Event Prefixes

Security

• mSL Injection
• DCC GET security

Other

• mIRC Installation
• Virtual profile
• Playing music
• Unicode
• IPv6
• Optimization
• Threads
• DCC Protocols
• Line Length Limit
• Font rendering

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 RAW 366 which indicates the end of the user list. Similarly, if you're an operator on the channel, you won't be opped inside the on join event, and should use ON OP event instead.

Synopsis

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

Parameters

<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

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

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

• ON PART
• List of on events

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