What is this

This document describes how to download and install MTScripts. It is a good idea to read this information before installing, just to make sure everything is all set. It's not too hard to do though, so this shouldn't be too painful.

Install Monkey Term

Since MTScripts is a makeover of Monkey Term, it must be installed in the same installation directory as Monkey Term in order to work properly. If you did not change the installation location for Monkey Term from the default, the installer for MTScripts will most likely suggest the correct installation directory for it. That said, if you did instruct the installer for Monkey Term itself to put it's files somewhere other than what it suggested by default, you will have to instruct the MTScripts installer to put it's files in the same location in order for MTScripts to even begin to operate properly. Speaking of which, as of MTScripts 5.1.5.4, the installer will ask you where you would like to install MTScripts.

Download Link for Monkey Term v2.1 installer

Download Monkey Term now

Installing MTScripts

Be reminded one more time that MTScripts overwrites some of Monkey term. If You already have a working Monkey Term and you just are wanting to try MTScripts out, I highly recommend that you create a backup of your entire monkeyTerm folder before installing MTScripts, just in case things don't work as smoothly as hoped. MTScripts doesn't back up the Monkey Term folder for you, so this must be done manually.

Go to start menu, go to my computer. This is called computer in vista
go to local disk (c:), go to program files. If these folders are not displaying, look for a button somewhere that says display the contents of this folder.
Select MonkeyTerm, but don't open it. You can just arrow to it with the keyboard
hold down the ctrl key and press c before releasing both keys. This copies the MonkeyTerm folder to the clipboard.
Hold down the ctrl key again and press the v key before releasing both keys one more time. This will create a copy of the MonkeyTerm folder that is called "copy of MonkeyTerm" or "monkeyTerm - copy" in the case of Vista or Windows 7.

If you run into problems and want to resort to the backup, all you have to do is go back to the folder I just explained how to get to, delete that folder, select the "copy of MonkeyTerm" folder, press f2, press home, and delete the word "copy of" from in front of the name before pressing enter. So basically delete the MonkeyTerm folder and rename the copy you made to "MonkeyTerm". Obviously the steps would be slightly different for renaming the copy on Vista or Win7 owing to the fact that it's called monkeyTerm - copy not copy of monkeyTerm.

Download MTScripts below

There is a link for each version of MTScripts that I have made publicly available. Below each link is a short explanation of what was changed in that version.

MTScripts v 5.1.5.4
Changes in 5.1.5.4:
1. Ctrl+f2, the keystroke formerly to cycle through speech output options, is removed as the new Screen Reader API makes it more difficult to do this. I'm going to see about putting it back in, but just now it's rather inconvenient.
2. Before I forget, those who need to use no speech will have to hit f5 for the FMT, go to the top, expand "actions", expand "default", expand "speech", select output, and uncheck the "enabled" checkbox in order to stop not all but most of the speech output. I removed as much of the code as possible related to being aware of the current speech output in an attempt to bring forth performance improvements, but unfortunately this resulted in the loss of the ability to turn speech off. This oversight should be fixed in the next version.
3. volume up down scripts changed to only have 10 different volume levels.
4. volume up down script changed to not play the sound if the volume isn't changing. You'll still hear the xml saver kicking in, no easy way to fix that.
5. MTScripts is now path aware. I finally figured out how to do it, and you can now install MTScripts anywhere just make sure it is in the same place monkeyTerm is. The installer will be modified so that it now asks you where to put it. Those running monkey Term under windows vista or 7 are asked to please install it somewhere in their user account's folder to eliminate the myriad of problems brought on by UAC (User Account Control). Of course, if you have UAC disabled, feel free to put it where it goes by default if you want, or on the route of your hard drive.
6. implemented support for system access and NVDA.
7. dlls distributed with MTScripts have changed. We now have screenreaderapi.dll, screenreaderapi.tlb, saapi32.dll and nvda-controler-client.dll and no longer distribute gwspeak.dll and jfwapi.dll. These are the new system used to communicate with screen readers. It's a new package that handles this called ScreenReaderAPI.
8. moved the spelling functionality from xml to default.mos. In order to use, xml's must use the spell command. I'm not entirely sure I have updated all xml's to use the new code, but I'm definitely certain Mathayas Alter Aeon.xml is taking advantage of it.
9. Hll now speaks a friendly error message if it is not populated. I have tried to make this work for all of the xml's.
10. xml's now save when adjusting SAPI voice. I have attempted to work this into all of them.
11. Functions used to speak are now changed slightly. Old xml's may not run properly on the new scripts. This is for slight performance improvements as well as cosmetic, code makes a little more sense now. Functions are now,
  - SISay SAPI interrupt and speak
  - SSay SAPI speak
  - say speak with currently used screen reader or SAPI as last resort
  - iSay interrupt and speak with currently used screen reader or SAPI as last resort
  - SStop stop any current speech being produced by currently used screen reader or SAPI as last resort, but not SAPI speech which is being issued explicitly, for instance by OSM other spell monitor found in Mathayas Alter Aeon.xml.
  - SAPIStop stop any SAPI Speech, explicitly started or not.
12. removed the declaration of an array in default.mos who's purpose I have no idea of save I am sure it's not used any more.
13. changed logIt function which is used to log text so that if logging with timestamps the timestamp prints after the log entry rather than before.
14. A needed line of code setting the path for log files was noticed to be commented out for some reason. Fixed that so manually created log files work once again. Users of previous versions may possibly not notice this to have been a problem in the first place as I think it's most likely I did that to the latest yet unreleased version and noticed it luckily before release.
15. added in a soundError function that is called by the play function when it encounters an error trying to play sounds with com audio. The soundError function writes the error into a file in the logs folder that is found inside the MonkeyTerm folder. The log entry will have the path and name of the file and then the timestamp. After logging, the function will try to play a new sound error.wav file located in the sounds/default folder. To summarize, if users hear a buzzer sound, they should be aware that this is an error playing a sound, and they can open the sound errors.log file to find out what it was. The log is always appended, therefore it is ok to close Monkey Term and reopen it and load the xml again as there's no concern that previous log entries will be lost. It is also safe to delete this file while the xml that seems to be writing to it is loaded. If more errors occur the file will be recreated.
  
  All changes listed below unless otherwise noted were made to Mathayas Alter Aeon.xml only
16. Mathayas Alter Aeon.xml has been updated to run on the new default.mos.
17. Implemented support for KXWT
18. sped up repose by 1 second
19. triggers improved slightly to not spam the game in certain situations.
20. attempt to prevent the possibility of multiple copies of group members being caught in the group list when multiple changes to the group happen in rapid succession. More complex code is involved, yet though this will make the group list update slightly more slowly by intention, it should take some continuous load off the client and also it will reduce the amount of times the gr command is sent to Alter Aeon now too. Also hopefully at last it's pretty much bullet proof. Took some serious effort to finally get this fixed.
21. new sound for friends posts
22. changed the sound for clantell. I found the old one very annoying.
23. improvement reporter and associated sound now work for gaining sudden incite thanks Lilmike.
24. the waypoint change sound has been, well, changed.
25. Mud sound protocol support for Alter Aeon is implemented and taken advantage of.
26. repicklocks is removed from the cfg command and the functionality is likewise no longer available as Alter Aeon's new lockpicking code is event based and automatic to begin with, making this useless.
27. A new keyboard shortcut, ctrl+f, has been added that just types foes, which means this will tell users if anyone in their group, and in the same room with them, is being attacked by anyone.
28. the Cure critical sound now plays properly instead of the heal sound playing for it instead sometimes.
29. ctrl+w now also works with experience gains on dented NPCs as a result of you having killed them too often in too short a time. The error message displayed when someone presses this keystroke when they haven't killed anything yet is also improved.
30. The regen calculator has been modified so that it works when someone using it is not regenning at all in one of their stats, or is actually negative regenning. In so doing, this fixed the possibility for the show regen command to actually display on screen instead of firing off the substitute that is supposed to hide it when the regen calculator is being used.
31. resleep has been removed. If someone in your group yells, waking you up, you'll no longer automatically go back to sleep. I was asked to remove it because often group leaders would yell something to make the group wake up then do a groupcast while everyone was awake.
32. Saving new changes to the xml automatically has been changed so that it is done with a delay. This will cut down on how many write operations to the disk the xml makes when cycling quickly through settings like adjusting volume. I did this to help improve responsiveness when quickly going through settings and also to try and save write operations on my netbook with it's solid sate disk. Pressing ctrl+s still works as it has done in the past, it is instantaneous. Users will notice a short two beep sound when a setting is changed, then, a time later the sound for saving the xml is heard, the same one that is heard if one actually presses ctrl+s. I have made some attempt to port this to other xml's, but I'm not quite sure I've gotten them all done. Those that haven't been changed to behave in this way will still work properly the old fashioned way.
MTScripts v 4.0.4.9
Changes in 4.0.4.9:
1. For Mathayas Alter Aeon, fixed a typo with the string for toggling spell reporter.
2. For Mathayas Alter Aeon, made the order functionality a little more secure.
3. For Mathayas Alter Aeon, fixed a bug introduced with the new ground, faith shield and dread portent. Thanks Hannibal.
4. For Mathayas Alter Aeon, the spell reporter has been modified in such a way that should hopefully improve performance, plus make it easier for contributors like Hannibal to add more spells.
5. For Mathayas Alter Aeon, when you tried to toggle spell reporter substitutes by finding that option with shift+ctrl+q then pressing shift+ctrl+w to toggle it, the shift+ctrl+w didn't work to toggle it, printing an error instead. This has been fixed.
6. For Mathayas Alter Aeon, the sapi5 speech interrupt on enter functionality, which was not working as expected anyway, has been removed. If I find a way to make it work without causing problems, I will put it back in. If you're stuck with SAPI, you might want to use a different client like vip Mud.
7. For Mathayas Alter Aeon, added a translator that will print emoticons in english word form with *symbols around them. Probably only useful in very specific cases, so it is disabled by default. It can be toggled with the cfg emoticons command. Thanks Salinar.
8. For Mathayas Alter Aeon, improved the pose triggers, so your group members can say more things to make you sit down, etc. Note that group botting is Illegal on Alter Aeon, so take advantage of this at your own risk.
9. For Mathayas Alter Aeon, the truncation for dexterity and strength going up has been changed. Now you'll get the Mathayas casts strength message, then you'll get Mathayas's strength increases.
10. For Mathayas Alter Aeon, added sounds for players/npc's joining and leaving the group. Thanks Kelsier.
11. For Mathayas Alter Aeon, Strength up sound modified.
12. For Mathayas Alter Aeon, Sanc down sound modified. Sounds more like the opposit of Sanc up now.
13. For Mathayas Alter Aeon, Invis up sound modified. It's more like the opposit of invis down now.
14. For Mathayas Alter Aeon, displace down sound should more reliably play from the same direction as displace up went. The exception is when the xml is closed, and the displace spell falls after the xml is reloaded. It will pick a direction to play the displace down sound from in that case.
15. For all xml's running on MTScripts, removed the error message that prints when trying to play more than 64 sounds at once. The only difference this makes is when doing a replay on Alter Aeon for instance, and a whole bunch of sounds from all the different channel sends play simultaneously. Now you won't get spammed with error messages when you try that. Thanks Rhorae and Lilmike.
Thanks go to all the contributors again. I get help from various people when I work on this stuff, and it is a pleasure to have others contributing to what I'm working on. I'm proud to name so many contributors in the changelog.
MTScripts v 4.0.2.4
Notice: I forgot to change the version number reported by the !ping command in Mathayas Alter Aeon.xml, so be aware that version 4.0.1.5 is the same as 4.0.2.4. I don't have enough bandwidth to upload it again just to change a 4 octet number.
Also note that all changes listed below concern Mathayas Alter Aeon.xml.
Changes in 4.0.2.4:
1. added an alias grlist that takes over the previous functionality of updating the list of group members
2. added an alias grwho that prints a single line list of the group members stored in grlist, printed in literary form like this (Mathayas, Lexie and Karah).
3. The Grwho command has been configured to allow a numerical argument after it, grwho2 for instance. Doing this will spell the name in that position in the grlist with the currently selected speech output. Thanks Cheetah
4. Grouping and ungrouping people now runs the grlist alias
5. the group member recognizer can now go up to 61 members instead of just 41
6. a config command has been added, gr, that allows the player to toggle whether the group members are reported every time the group changes members. The list of group members is maintained regardless of this setting.
7. group checker now totally ignored npc's in the group. That is, it doesn't add them in the list of group members that it creates and it doesn't show the status of the NPC's when it checks the gr command to find out if there are any changes in the group.
  
  All the new grouping functionality took some testing from others. Thanks go to Rain, Hannibal, Cheetah and rayden.
8. upgraded the order functionality to allow the player to edit the list of allowances easily via config command. Need to update documentation for this it is a little less simplistic than the other config commands are. Huuuge thanks to Hannibal.
9. Edited the config command a lot just for wording, changed the way things are written. Looking for consistancy That helps with ease of use.
10. Modified the showMe and iShowMe functions so that they no longer occasionally just append text to the last line instead of putting it on it's own.
11. The spell reporter for the ground spell has been fixed so that it correctly honors the spell reporter settings made with shift+ctrl+q and shift+ctrl+w. Thanks Hannibal.
12. There is now a sound for the spell Faith shield. Thanks Hannibal.
13. There is now a sound for the spell dread portance, Thanks Hannibal.
14. There is now a sound for the spell protection from evil. Thanks Hannibal
15. there is now a sound for the spell slow poison. Thanks Hannibal
16. There is now a sound for receiving combat points
17. The sound for Tensors floating disk has been removed.
18. The truncated strings which can optionally be displayed when spells go up and down on the character have been improved slightly.
19. A berserk keystroke, ctrl+shift+b, has been added. Thanks Hannibal.
20. A cleave keystroke, ctrl+shift+l, has been added. Thanks Hannibal.
MTScripts v 3.7.9.7
Changes in 3.7.9.7:
1. Virjal Cyber Assault and Mathayas Cyber Assault both removed and replaced with a single file for Cyber Assault that works with both builders and non builders.
2. SAPI5 support upgraded in Cyber Assault and also the upgrade will now be included in default new files. So voices and settings of those voices can be changed.
3. Ground up and down sounds added for Alter Aeon.
4. Lightning bolt sound added for Alter Aeon.
5. Regen calculator for Alter Aeon is now accurate. Thanks Lexie, Cria and Kahlan
6. In Alter Aeon, the regen calculator can now be adjusted with the cfg rs command to send the regen status to a channel, just display, or do nothing at all.
7. In Alter Aeon, Brag rs added to enable the user to announce time left to regen. Brag yt rs, brag tell mathayas rs, etc. Rs is short for regen status.
8. In Alter Aeon, ctrl+shift+e impliminted to send regen status to the group you're in.
9. In Alter Aeon, ctrl+e modified to support the new regen status calculator. End result behavior should be the same.
10. Ctrl+f1 now leads to the correct documentation for Mathayas Alter Aeon.xml, Cyber Assault.xml, and Default.xml and consequently newly created xml's. Can't remember who reported
11. In Alter Aeon, Bad conditions show up sooner than better conditions now when one types hpall or presses the "group condition key" now ~ grave accent. Thanks Cheetah
12. In Alter Aeon, Group Conditions key moved from ; semi colon to ` grave accent to free up semi colon for use in stacking commands. Thanks Kahlan
13. In Alter Aeon, underwater terrain sound added.
14. In Alter Aeon, force terrains to play the sound for a different terrain if there isn't a sound for it yet. If you notice rapid beeping I forgot one. Contact me if this happens. Thanks Cheetah, Rayden and Enoch.
15. In Cyber Assault, fixed the cfg reset command to disable a couple of things.
16. In Alter Aeon, fixed ball lightning sound. It was broken by string changes in the game. Thanks Rayden
17. In Alter Aeon, fixed issue where date gag was being a little too agressive and hiding the wrong dates. Thanks Lilmike
Thanks everyone. A lot of you contributed to changes made in this version. Many comments. Thanks very much. If I didn't mention you and you want notice where it's do, contact me on Alter Aeon.
MTScripts v 3.4.4.1
Changes in 3.4.4.1:
1. SAPI5 support now upgraded with Mathayas Alter Aeon.xml to allow the user to change voices voice rate, and voice volume. These functions are accomplished using ctrl+- dash and ctrl+= equals, as well as shifted variation of those commands.
2. Virjal Cyber Assault xml added for builders on Cyber Assault.
3. Leap Attack sound added for Alter Aeon.
4. Waypoint switch sound changed for Alter Aeon.
5. Regen calculator changed with the Alter Aeon xml so that it now reports the time needed to regen in minutes and seconds, instead of ticks. Helpful if using event based regen.; If still using tick based regen, just try to calculate that a tick is about half a minute.
MTScripts v 3.4.2.4
Changes in 3.4.2.4:
1. JAWS scripts have been updated.
  1. Copying of text to the clipboard is easier to listen to now
  2. Append to clipboard is now possible with alt+insert+c
  3. Help insert+h has been updated so for complete knoledge of how things work now check that out
2. Mathayas Alter Aeon.xml has been updated
  1. Automatic repicking of locks has been impliminted see the config command
  2. Automatic repicking of pockets has been impliminted again see the config command
  3. Big one: A new channel system has been added that can store most channel sends into the history buffer without storing all the other infformation like the default history buffer functionality. for this to work properly the history buffer must be disabled. This system works great if enabled for users of jaws and window-eyes who can use the history buffer read commands to repeat any channel sends that they may have missed. See the config command and the help files assuming information has been added to the help file by then.
  4. config command has been updated to include all of these new options
  5. Sounds for fire shield, ice shield, and darken have been added. thanks Hannibal.
  6. A couple of possibilities for automatic rescue trigger to fail have been fixed.
  7. heal, sanc, stone, displace and area triggers have been added. Again group bots are illegal in Alter Aeon so enable these at own risk.
3. We now overwrite MTSettings.xml with our own copy when installing the scripts. This means when a new user first launches the client after installation, the client will immediately pop up with the recent session's list that will have entries for each xml we currently distribute. This way maybe brand new users will be less confused about how monkey term works. So many times we've had new users with problems who turned out to have opened the wrong file or who couldn't understand how to open the right file do to inconsistancies. The downside of this change is that if you use an xml that we don't distribute, it will disappear from the recent session's list after installing. That's not too bad however, as it will reappear again at the top once the user has manually opened the xml file using the open file dialogue.
MTScripts v3.2.6.9
changes in 3.2.6.9
1. initial soundpack for Cyber Assault!
  1. No extra sounds have been added. It uses sounds from Alter Aeon and Miriani and of course from default sound archives, at least for now.
  2. It has a config command
  3. It has a help page which can be reached with ctrl+f1 when the xml is running in Monkey Term, as is the case with mathayas Alter aeon.xml.
  4. The name of the xml for cyber assault is Mathayas Cyber Assault.xml and it is located in the files folder where the other files are.
  5. For now, type psm1 to get the prompt set up after logging into cyber Assault. I suggest enabling the battle spamm filter with the "toggle fight on" command.
2. Battle bot has been removed
3. sg3.0 has been removed
4. Improved the config command for Mathayas Alter Aeon.xml
5. Increased the volume of all of the sounds and decreased the bitrate from 22050hz to 16000hz. Let me know if the quality is noticeable all that much. I still have the orriginall sounds.
6. waypoint changing, failure to recall and improvement sounds added to Mathayas Alter aeon.xml
7. documentation is being moved from it's previous location to a wiki that has just been created for the purpose.
8. Since I removed the two audio games mentioned above and decreased the quality of the sounds, the size is coming back down some. I wasn't able to handle uploading new versions that large with the kind of internet I have.
9. ctrl+f1 in Mathayas Alter Aeon.xml now loads up the wiki page as apose to the orriginal help page.
10. ctrl+f1 in default.xml or a newly created xml that hasn't been given a specific help page yet now loads up the help page from the wiki, rather than the orriginal file.
11. In Mathayas Alter Aeon.xml, ctrl+b (bash), ctrl+i (trip) and ctrl+k (kick) interrupt speech now when pressed.

this page was last edited on December 25, 2011, at exactly 8:06 PM. Merry Christmas Everybody!!