You know how your mIRC has those colors that define what type of action is which? Like your MODE text is green? Your own text is brown/gray/green? Well $text will help you color that color.

The whole point of this identifier, is so you can make error messages/joins/parts in a channel. Like if you needed to make an error message if something didn't check out in a script, you could use $text(* Error on $script $+ ; $scriptline,6) to return that message in the info text.

This is how it works:

$text(text,N)

"text" is the text you want to color

N is the number in the keycode that represents a type of text

So you could do //echo -a $text(hi there,3)

So that you'd have "hi there" echo to your active window, in your action text color.

Below is the keycode for the $text identifier, which is also included in the script under /keycode

1 = $null (you don't use this keycode)
2 = background
3 = action text
4 = CTCP text
5 = Hightlight text
6 = Info text
7 = Info2 text
8 = Invite text
9 = Join text
10 = Kick text
11 = Mode text
12 = Nick text
13 = Normal text
14 = Notice text
15 = Notify text
16 = Other text
17 = Own text
18 = Part text
19 = Quit text
20 = Topic text
21 = Wallops text
22 = /Whois text
23 = Editbox background
24 = Inactive/Editbox text
25 = Listbox Background
26 = Listbox text
27 = Listbox - Gray text
28 = Listbox - Title text
29 = Inactive background
30 = Treebar Background
31 = Treebar text

For extensive info on commands involving this, /help Colors Dialog

Note: $text only works with the mIRC theme that you are currently using.

alias text {
  If (!$2) { halt }
  unset %v %i
  %i = 0
  While (%i <= $calc($ini(mirc.ini,colors,0) - 1)) {
    If ($gettok($readini(mirc.ini,colors,$+(n,%i)),1,44) = $readini(mirc.ini,text,theme)) { set %v $+(n,%i) }
    inc %i
  }
  If (!$gettok($readini(mirc.ini,colors,%v),$2,44)) { halt }
  If ($$3 != b) { halt }
  If ($$3 = b) { return $+(,0,$gettok($readini(mirc.ini,colors,%v),$2,44),$chr(44),0,$gettok($readini(mirc.ini,colors,%v),2,44),$1) }
  If (!$3) { return $+(,0,$gettok($readini(mirc.ini,colors,%v),$2,44),$1) }
}