Animation List Files

The variables %mc_agent_actionanimations and %mc_agent_speechanimations are used to engage a feature that uses keywords in text typed to figure out what animations to show for an agent.

Using this feature you can have some fun while you talk and even put on a little mirc play with a little work.

Microsoft Agent animations are not standardized well, so that in order to figure out what animations should be linked to certain keywords, we create an agent animation list (.aal) file which describes what patterns should trigger what animations.  Since different MS Agents support different animations, a separate step is performed within the script to only use animations supported.  We have worked hard to make this process as efficient as possible.

We use a default .aal file (msagentdefault.aal) which should be placed in your main mirc directory along with the rest of the script files.  This file is loaded for all agents.

You can also provide an additional .aal file for any agent which specifies additional animations/patterns.  If an agent file is peedy.acs, then its .aal (agent animtion list) file is peedy.aal.

The .aal file is just a list of paired lines of the form

 animationname

 pattern1,pattern2,...

 animationname

 pattern1,pattern2,...

 animationname

 pattern1,pattern2,...

 ...

The animationname must be from the list of animations supported by the agent.  Animation names are case insensitive (so wave is same as Wave).  You can use a free program like Agent Animation Browser (http://softnik.com/products/msagent.htm) to discover the animations for an agent.

Patterns are just text with wildcards:

To match the pattern haha anywhere in a string you would use pattern: *haha*

To match only if haha was a whole word, you would use patten: * haha *

To match at begining or end of sentence you can use a '_ ', so to match the word hello only at begining of sentence you would use pattern: _ hello *

To match only the exact phrase 'bye bye' you would use: _ bye bye _

If multiple animations match a sentence, one will be chosen at random

EXAMPLE FILE:

Acknowledge

* acknowled*,_ ok *,_ yes *,_ okay *,_ yep *,_ yeah *

Announce

* announc*,* attention *

Blink

* blink*

You can edit the msagentdefault.aal file to add your own patterns, and if you're feeling especially creative you can make your own agent using Microsoft or 3rd party tools.