{{>toc}}

h1. Emoticons Options

For colored emoji support, check "this plugin":https://dev.adiirc.com/boards/4/topics/1355.

_Tip. [[Options Dialog|Options]] -> [[Messages Options|Messages]] -> [[Messages_Options#Pixel-spacing|Pixel spacing]] makes lines bigger, emoticons will also resize to be bigger._

h2. Use Emoticons

Enable or disable emoticons.

_Enabling emoticons only works on new messages after emoticons is enabled._

_All icons will be resized/scaled to fit inside the text line height, aspect ratio will be preserved._

h2. Use animated gifs

Enable or disable animated gifs support.

When the support is disabled, all gifs will stop animating and show the first frame as a static image.

h2. Case insensitive

If enabled, _text_ and _TEXT_ will both be replaced with the same icon, otherwise they could have different icons.

h2. Only replace whole words

If enabled, emoticons inside links and words will not be replaced.

h2. Use regex to match a pattern

If enabled, allows using a custom [[Scripting_Regex|Regular Expression]] to match the emoticons trigger.

h2. Regex

The [[Scripting_Regex|Regular Expression]] to use when *Use regex to match a pattern* is enabled.

_<emote> in the regex will be replaced with the pattern (trigger|trigger|trigger)._

h2. Adding emoticons through scripting

Use [[/setoption]] Emoticons Emoticon_<matchtext> <filename>.

_\ and = characters must be escaped with a \ character._