Mathayas alter aeon

Mathayas Alter Aeon.xml

This help file currently directly applies to: MTScripts 3.7.9.7

What is Mathayas Alter Aeon.xml?

Mathayas Alter Aeon.xml is a soundpack for the mud Alter Aeon. It has sounds for most spells and a few other things as well. It uses the prompt from the mud and does a number of interesting things with it. It is part of MTScripts and includes a neat little XP and gold counter which lets you keep track of how much experience and gold you've gained or lost. Most of my time working with MTScripts went straight into Mathayas Alter Aeon.xml, which is an exact copy of the xml I use to play the character Mathayas on alter Aeon. It has a lot of functionality, and this help page will try to touch on everything so new or upgrading users can take advantage of all the features.

How to open Mathayas Alter Aeon.xml?

Open Monkey Term and close the recent sessions list if it appears with alt+f4. press ctrl+o to get the open dialogue. Browse using common browse techniques to c:\program files\monkeyTerm\Mathayas Alter Aeon.xml and open it. These instructions are correct even for those of you running 64 bit versions of windows.

What are some initial setup configurations one should make to get this xml to work best?

Note that the config or cfg command has been introduced to make initial setup easier. If you prefer, you can just type cfg and press enter to be presented with a list of options that you can configure.

Select desired speech output

Press ctrl+f2 to cycle between the speech settings. By default speech is set to sapi5. If you are a JAWS or Window-eyes user press this until it says "JAWS or Window-Eyes". Speech can be turned completely off using this key as well. If you lose automatic speech at any point try hitting ctrl+f2 to see if it comes back on.

Modify your eq change aliases to set the eq variable (optional).

The eq variable is an Alter Aeon based variable that Monkey Term monitors, changing it's own variable's value to match that of the Alter Aeon variable. The purpose of this is to help Monkey term figure out what equipment set you are wearing and behave differently depending. For instance, if it thinks you are in hit and you have the trigger system turned on, it will make you automatically assist, etc. To learn about Alter Aeon's variable functionality, log into it and type help variable. Note that using triggers in groups is against the rules on Alter Aeon. The trigger system exists for you to use at your own risk. To set this up, at the end of each alias you have made for changing equipment you need a command that looks like this. var eq eqhit The above command has the word hit in it, telling Monkey term to behave like you are in a hit set. right now there are three different values that make a difference, eqhit, eqtank and eqheal. If you set it to eqblah for example, it will behave as though the variable were not set at all. Tip: You can just type this yourself into alter Aeon instead of putting it in your equipment change aliases. Useful if you don't have eq change aliases or otherwise haven't added them to your aliases. Note that until this variable is set you will receive a slightly annoying error when you log in that says variable not set or something along those lines. To stop this error message, just type var eq eqblah.

How do I upgrade to a different version of Mathayas Alter Aeon.xml and maintain my own custom aliases and such?

create a template containing all of your personal items

1. Open your existing xml file in MonkeyTerm. 2. Save this xml file as a different file by going to file menu with alt+f and choosing save as. 3. Open the FMT by pressing f5 and delete everything that you didn't create yourself. Delete all actions, aliases, substitutes, events, variables, etc. Delete every single thing that you can find that you don't think you created on your own. Things that were included when you first got the file but that you have modified you should probably delete to, or keep them if you think you know how you can manually merge them together. It can cause problems sometimes if you overwrite something already existing in the newest file when you merge in your old code. So if you have manually changed code in something that is included, maybe the best thing to do is copy the code for that particular item into a document in notepad or something like that and save it separately to paste back in after you finish merging the template and after you check if you shouldn't break anything by overwriting the new file's code with your own. 4. Once you are pretty certain you have deleted everything except things you have created, note that includes any default things like speech even. Don't be afraid to delete. Anything you don't delete may possibly have been something that was updated in the newest version and merging your own legacy code over top of the new may very well break it, save the template. For instance if your xml is called Mathayas Alter Aeon.xml, I suggest saving the template as Mathayas Template Alter Aeon.xml. 5. After updating to the latest MTScripts, you can open Mathayas Alter Aeon.xml, note that this will be a new file copied in by the installer for the new scripts. Anyway, open it in MonkeyTerm and make sure you like it if you want. When you are ready, leave Mathayas Alter Aeon.xml open and go to file with alt+f and choose import/merge xml. Answer any prompts during this process as you think best. It may want to know if you want to overwrite things. If these come up I would recommend choosing no. After the import is complete you can leave the new file open and check the template for things that it had asked you if you wanted to overwrite to compare differences and see if you need to copy in your own stuff and if you can do so without breaking things. 6. There isn't really a 6th step. You should be done. Well you should save the result of your merge if you are satisfied with the results as what ever name you desire. I'd recommend not overwriting Mathayas Alter Aeon.xml though so you shouldn't just press ctrl+s. You should go to file and choose save as and give it a name that will match your character or otherwise be significant to you. You don't want to overwrite Mathayas Alter Aeon.xml because if you happened to break anything you don't have the original default code to start fresh from any more until you reinstall MTScripts or grab a fresh copy of Mathayas Alter Aeon.xml from somewhere else.

Hotkeys

There are many hotkeys that can be used to do a wide variety of different things. Here we'll take an in depth look at the keybindings. Keybindings, by the way, is Monkey Term's name for hotkeys.

The Config command (cfg)

The config command, cfg for short, allows the user to make changes to the way Monkey Term behaves when using Mathayas Alter Aeon.xml. To use the config command, type cfg and press enter. A list of options will be given. If the meaning of one of the choices is unclear, see this section of the documentation for enlightenment. In most cases, the options can be toggled. If the option says it is enabled or disabled it can be toggled. Otherwise, something else must be typed after it to enable it, or nothing at all to disable it. See below to find out more about this.

Basic options:

ali: set up automatic logging in (currently mathayas)

Syntax to auto log into Mathayas example: cfg ali mathayas password Syntax to disable auto log in: cfg ali This command enables the user to configure MTScripts to automatically log a character in when the file is open. To set this up, type cfg, a space, the name of the character, another space, then the password and press enter. To disable this functionality, just type cfg, a space, then ali (cfg ali). NOTE: This functionality stores your password in a variable with no encryption, so it is not secure. If one looks at the variable, the password will be written there, clear as day. If you've security concerns please do not use ali.

history: Store channel sends in the history buffer? enabled

Syntax to toggle this on and off: cfg history This functionality will track most channel sends and store them in the history buffer so they can be read with the history buffer commands. To learn how to read the history buffer please see the section dedicated to history buffer commands in this same document. When this functionality has been enabled, the standard history buffer will be disabled, so the only thing stored in the history buffer will be channel sends. This will be useful for those who have JAWS or Window-Eyes, but need a way to keep up with people are saying during spammy situations. NOTE: When this functionality is toggled on while the standard history buffer functionality is already on, the standard history buffer functionality will be automatically disabled. To switch back to the standard history buffer functionality, please use the standard history buffer toggle hotkey ctrl+shift+f2. Doing this will automatically disable the channel history buffer.

reset: reset the xml to distribution default settings

Syntax to reset the file to distribution defaults: cfg reset This command resets the xml file to it's default distribution settings. It will disable auto login and remove the user and password information from that, as well as turn off the order functionality, etc. I, that is the developer of MTScripts, use this command to make sure I have removed my own password and my own preferred configuration before I package up a new version of MTScripts for distribution. If you mess something up, cfg reset may fix it, depending on what the problem is.

Triggers and automation

triggers: Use the trigger system? disabled

syntax to toggle: cfg trigs These are actions that will make the character automatically do certain things when in groups. Use the eq variable mentioned early on in this documentation to control what the triggers do. See the section mentioning that eq variable for more information. NOTE: Group bots are now against the rules on Alter Aeon. So use this functionality at your own risk. It is disabled by default.

order: use the order functionality? enabled

Syntax to toggle: cfg order Order is a trigger that allows anyone listed in it to have complete control over the character. It behaves just like the ordering of minions. Just type order name command and what ever you ordered will perform that action if it were charmed by you or happened to be your minion who also happened to have enough intelligence to follow commands. To adjust who can order the character when it is enabled, find the action misc/order. Understand the code in the if statement before adding or removing names. NOTE: Order is set to allow people whom Mathayas has allowed to order him by default. A new user of MTScripts should not use order, as they don't know who can order them until they look at the code in action/misc/order. Order allows complete power over the character. Someone can order the character to quit, drop equipment, donate, sacrifice, send tells, sleep, leap, bash, trip, shout something, spamm people, beep someone, kill themselves, etc. User should not use order unless they know what they are doing. Order is disabled by default. Type cfg order until it says it is disabled.

autogroup: automatically group those who follow you? disabled

syntax to toggle: cfg autogroup Autogroup will group anyone who follows the character automatically. This is disabled by default.

Conclusions

this help file is still being written.