# $EPIC: on_new_nickname.txt,v 1.3 2006/08/19 02:42:38 sthalik Exp $
on [<modes>]new_nickname [<serial#>] [-|^]<match> { <action> }
This hook is triggered whenever your current nickname is no longer acceptable and a new one must be created. It is expected that you would use the NICK command in the <action> of this hook. If you do not hook this, the client chooses a new one for you.
| $0 | The server for which we need a new nickname |
| $1 | The actual current nickname (or “*” if we don't have one) |
| $2 | The current “pending” nickname (or “*” if we don't have one) |
The ON NEW_NICKNAME hook first appeared in EPIC5-0.0.3.