Ms Agent Mircryption Variables

Top Previous Next

There are a lot of mircryption variables for MS Agent support; defaults are be set automatically. Hit the tiny [az] button in the alt-R->Variables tab to sort them.

Maybe someone will add a nice dialog interface one day?

Global MS Agent Variables:

•	%mc_agent_enable [yes/no]

disables or enables all speech - it can be toggled from the mircryption menu

•	%mc_agent_options [mirc_/gopt_option_string]

see Mirc MS Agent load options below

•	%mc_agent_talkoptions [mirc_/gopt_option_string]

see Mirc MS Agent talk options below

•	%mc_agent_afterspeech [hide/unload/nothing]

what to do with each character after it speaks

•	%mc_agent_speakevents [yes/no]

should agents speak events (like when someone joins a channel or parts)

•	%mc_agent_actionanimations [yes/no]

animate characters based on keywords found in /me actions?

•	%mc_agent_speechanimations [yes/no]

animate characters based on keywords found in normal typed text?

•	%mc_agent_replacemirc [yes/no]

should mircryption takeover all ms agent functions (recommended)

•	%mc_agent_smartnames [yes/no]

if set to yes, then agents will not speak the preface "NICK says:" if the last speaker that used that agent character was the same (defaults to yes)

•	%mc_agent_agentscanmove [yes/no]

if set to yes, then agents will move on screen if person types "/me moves left" or "/me moves right", etc.

Mirc MS Agent load options (from mirc help file /gopt topic):

•	The -b switch turns balloons on or off. You can also make ballons size to fit the text being spoken, pace to display text word by word as it is being spoken, and hide to hide the balloons when no text is being spoken.

•	The -i switch turns idle effects on or off.

•	The -e switch turns sound effects on or off.

•	The -n switch allows you to set a language id, where langid is the hex id value.

•	The -h switch turns the auto-hide feature on or off (see /gload for more info).

Mirc MS Agent talk options (from mirc help file /gtalk topic)

•	The -l switch applies the lexicon settings in the lexicon dialog to the text.

•	The -u switch applies the speech settings in the speech options dialog.

Channel/Nick MS Agent Variables:

These variables are arranged in a hierarchy, so that the most specific agent file will be used for any speaker. use 'disable' (or place a 'hyphen (-) in front of a filename) to disable it

•	%mc_agent_char_default [name_of_agent_file.acs/#]

tells mircryption what agent to use as the default character for all speakers which are not otherwise specified

•	%mc_agent_char_query [name_of_agentfile.acs/#]

tells mircryption what agent to use as default character in queries

•	%mc_agent_char_CHANNELORNICKNAME [name_of_agent_file.acs/disable]

specifies the agent file to use for speakers in a channel, or for a specific nick

•	%mc_agent_char_NICK#CHANNELNAME [name_of_agent_file.acs/disable]

specifies the agent file to use for a specific nick in a specific channel

•	%mc_agent_char_mynick [name_of_agent_file.acs/disable]

specifies the agent file to use when you type (set to default to disable self speak)

Examples (these would be entries in your alt-R -> Variable tab):

•	%mc_agent_enable yes

enable MS Agent functions through mircryption, (if set to no it overrides all other options, including individual channel agents)

•	%mc_agent_char_default merlin.acs

use merlin.acs agent as default speech agent

•	%mc_agent_char_query wizard.acs

use wizard.acs agent as default speech agent for query windows.

•	%mc_agent_car_query disable

disable speaking in query windows.

•	%mc_agent_options -b off -e off -i off

disable baloons, disable sound effects, disable idle effects

•	%mc_agent_afterspeech unload

tell mircryption to unload the agent after every sentence (can cause re-load delays, use hide for faster effect)

•	%mc_agent_char_jinxy#mircryption parrot.acs

when jinxy is speaking text in channel #mircryption, use the parrot.acs agent

•	%mc_agent_char_#mircryption parrot.acs

for all who speak in channel #mircryption, use the parrot.acs agent

•	%mc_agent_char_bushjr disable

do not use ms agent to speak text from nick bushjr

•	%mc_agent_speakevents yes

tells mircryption to announce when the following events occur: join,part,quit,connect,disconnect,notify,unnotify

•	%mc_agent_replacemirc yes

all MS Agent speaking for all channels (even those not encrypted) will be handled by mircryption routines

Extra Notes:

•	you can set the default agent (%mc_agent_char_default) to disable to tell Micryption to only speak in channels for which you have specific mc_agent_char_CHANNELORNICKNAME entries

•	you can use "%mc_agent_disable yes" to temporarily disable all MS Agent functions.

Using Built-in Mirc MS Agent simultaneously with Mircryption MS Agent functions

•	it is possible but tricky to use both simultaneously, though we recommend letting mircryption take over all speech functions

•	you can use the regular mIRC agent support for non-encrypted channels BUT you must take care to disable it on encrypted channels (left click on channel icon -> Agent -> Off) AND use a different agent for mircryption.

•

the preffered mechanism is to completely disable the built-in mIRC MS Agent functions by going to Alt-O -> Sounds -> Agent -> and unchecking boxes for Channels, Private, Other (and make sure you didnt override individual channels to use agent->on using channel icon menu), and then set the %mc_agent_replacemirc variable to yes. That will instruct Mircryption to take over all MS Agent speaking responsibilities, even on unencrypted channels.