Copyright: Helpfile Generated by VB HelpWriter!


SimpleMU Help File Contents
SimpleMU

The Information in this help file can also be found in the file Manual.doc in your SimpleMU directory.

•	SIMPLEMU REQUIREMENTS

•	CONTACT AND UPDATE INFORMATION

REGISTRATION INFORMATION

VERSION CHANGES

•	GETTING STARTED

Starting SimpleMU

Choosing A Destination

•	ESTABLISHING A CONNECTION

The Connect Window

Entering your first site configuration

Site Settings

Closing A Connection

•	CUSTOMIZING SIMPLEMU

Colors & Fonts

Other Interface Preferences

Scrollbars

Send Window Size

Toolbar

Custom Site Definitions

•	USING SIMPLEMU AND SIMPLEMU FEATURES

HANDLING MULTIPLE CONNECTIONS

Using The Menu System

Using / Commands

KEEPING TRACK OF ACTIVITY

The Activity Box

The Sessions Window

When SimpleMU is Minimized

DEFINING AND USING HIGHLIGHTS

Using the Highlight Configuration Window

Entering Highlights Manually

Entering Highlights Into The Send Window

Highlights Color Table

PATTERN MATCHING

DEFINING AND USING GAGS

Using the Gags Configuration Window

Entering Gags Manually

Entering Gags Into The Send Window

DEFINING AND USING TRIGGERS

Sample Trigger Definition

Using the Triggers Configuration Window

USING AND DEFINING SOUND ASSOCIATIONS

USING FILE LOGGING AND DEFINING LOG OMISSIONS

Log Omissions

Using the Log Omission Configuration Window

Entering Log Omissions Manually

  USING F-KEY MACROS

•	WHILE YOU ARE CONNECTED

  	  FILE QUOTING

  RECALLING SENT COMMANDS/TEXT

  MUSH SPECIFIC FEATURES

        Soft-Code Support

        WHO Window

  THE MAIL ROOM

  CHAT WINDOW (REGISTERED FEATURE)

  VIEW WINDOW (REGISTERED FEATURE)

•	APPENDIX OF /COMMANDS

•	APPENDIX OF KEYBOARD COMMANDS

•	APPENDIX OF CONNECTION ERRORS

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Keyboard Commands

PAGEUP

PAGEDOWN  	Scrolls the Receive Window up and down one page.

UP AND DOWN 	Scrolls the Receive Window if No Text in Send Window

Otherwise scrolls Send Window

END	Scrolls the Receive Window all the way to the bottom.

SHIFT-PAGEUP       Scrolls the Chat Window up and down.

SHIFT-PAGEDOWN

SHIFT-UP

SHIFT-DOWN 	Scrolls the Chat Window if No Text in Send Window

CTL-A	Removes Carriage Returns from selected text

and pastes it into the outbound window

CTL-B	 	Stores text to History without sending it.

CTL-C	Copies selected text from the inbound window.

CTL-D	Opens the Connect Window.

CTL-I	Opens the Default Settings Window

CTL-J	Drops to the next line in the Send	Window, allowing you to

Stack multiple commands/poses.

CTL-L	Opens the Log Window.

CTL-N	Scrolls forward through the History.

CTL-P 	Scrolls backwards through the History.

CTL-S	Converts Multiple Lined text in the Send Window to be prefixed by

the "say" command.   (Caution. Even the last line must end in a

Line Feed or it will be chopped off.)

CTL-T	Converts Multiple Lined text in the Send Window to be prefixed by

the "@emit" command.   (Caution. Even the last line must end in a

Line Feed or it will be chopped off.)

CTL-U       	Clears text from the Send Window.

CTL-V	Pastes selected text in outbound window.

CTL-W	Scrolls through connected worlds.

CTL-X	Cuts Selected Text

CTL-Z	Functions as an UNDO in the Text Window.

CTL-ENTER	Drops to the next line in the Send Window, allowing you to Stack

multiple commands/poses.

The NumberPad Map:

7	8	9

NW	N	NE

4	5	6

W	U	E

1	2	3

SW	S	SE

0

D

SimpleMU Help File - Helpfile generated by VB HelpWriter.


File Logging
Using File Logging

Defining Log Omissions

You can log the text received from any site to individual log files.

To begin logging:

Choose File then Log from the pull down menus.

Or

Type /log into the Send Window.

After confirming that you really do want to log, you will be asked if you want to include the buffer in the log as well.  This is useful if you decided to log something after the fact.

Log files can be split into files that are 32K long, by selecting Split Logs from the Options pull down menu..

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Establishing a Connection

Once you have a destination in mind and have established a connection to your local Internet provider, launch SimpleMU.  Loading and attempting to use SimpleMU when you are not properly connected to your Internet provider can cause unwanted effects.

Establishing A Connection

To make a connection to a MU* server you must open the Connect Window:

Choose File then Connect from the pull down menus.

Or

 	Type /connect into the Send Window

Or

CTL-D

The Connect Window

The Connect Window houses information about Stored sites that have been entered by you, the user.  Initially, this screen is blank, but will fill with Site names as you enter them.  To enter a new Site, click Add/Edit or press the F3 key.

Figure 1 - Connect Window

The Connect Window can be navigated with the Keyboard Arrow Up & Down keys which will highlight defined sites.  Once the site that you wish to connect to is Highlighted, depressing the F2 key will begin the connection process.

Once sites have been defined, it is possible to skip this screen altogether by using the /connect command.

Usage: (as typed into the send window)

/connect or /con	Opens the Connect Window

/con <worldname>	Opens a Connection to <worldname>

Entering your first site configuration

Add a new site using the Address for Guardians MUX:

Click Add A New Site

Enter the Name: Guardians

Enter Hostname: jitter.rahul.net

Enter Port: 4205

Enter Username: Guest

Leave the Password Blank.

Ensure the Circle next to ‘This is a MUSH type’ is selected.

Click Save and answer Yes to save changes.

That’s it!  Choose Close to hide the Site Settings and the Connect Window will reappear.  Select Guardians from the selection list and click Connect to establish your first connection.

Site Settings

The Site Settings window is where all pertinent information to each connection is stored, including advanced settings of Color and Fonts that are discussed later in this manual.

For our first connection we will use the Default Settings.

Closing A Connection

If all went well, you should have connected to the Guest Character at Guardians MUX.  To leave your connection, you can type QUIT into the send window and press enter.  This sends a message to the MUX that you would like to disconnect.  You will receive a message back that you are now disconnected from the Server and any further attempts to send information will be met with a ‘Not Connected’ error.  To close the connection altogether, choose File then Close from the pull down menus or type /close into the Send Window or CTL-R.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Registration Information

Writing SimpleMU has been a very good experience for me and it is a product I hope to continue to improve and support for MUSH players.  As of this release, I have put two years time into production, not to mention the expense of  development software.

If you like SimpleMU and use it regularly, you might consider dropping a donation ($15.. whatever you feel the program is worth.) into the mail towards the costs I have incurred in software and time to bring this program to you.  Those who do will receive a KeyCode that will unlock Registered only features including Unlimited Highlights, More Sound Triggers, Logging with Word Wrap Formatting, The Chat Window and the Text Editor.

There are many products available for the Internet and MUDding, in fact I maintain a directory of them at http://www.together.net/~shae/client.html.  My goal has been to create a tool MUSHers could use with features MUSHers need.

If you like SimpleMU please tell others, if you do not, please tell me.

Make sure you include your email address so that I can email you a registration code that will unlock features exclusive to the registered version of SimpleMU and keep you updated immediately of future releases.

Thank You,

Kathleen MacMahon

RR#1 Box 2660

Hinesburg, VT 05461

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Connection Errors

"Can't Assign Requested Address."

Verify that the MUD Address you have is correct.

"Network is unreachable."

The address appears to be valid, but SimpleMU cannot reach the Machine. Try again later.

"No Route To Host. Try Later."

Your connection to the Internet may be down.

"Connection rest by peer."

You connected and then were disconnected.  The MUD may have been  rebooting.

"Connection timed out."

SimpleMU could not establish a connection in 15 seconds.

"Connection refused."

There is either no MUD running at the requested address or it is currently down.

"Unable to find WINSOCK.DLL. Please connect to your provider."

Winsock needs to be loaded and you need to be connected to your Internet provider before attempting to connect.

"Unable to find Host."

The requested Named Address could not be found, try your connection using the numerical IP address.

 "Operation In Progress.  Please Wait."

You attempted to do something while SimpleMU was still making a connection.

"Sorry, unable to re-initialize 'winsock.dll', a Windows re-boot is required. If the problem persists, please contact shae@together.net"

This problem usually occurs after there has been a critical shutdown of one or more programs on the system and is best solved with a computer reboot.

"Can't Assign Requested Host Address: "

Ensure that you are using a valid Host Address.

"Your Winsock protocol does not support this software."

You are attempting to use the 32-bit version of SimpleMU with a 16-bit Winsock Stack.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Release Changes
SimpleMU Release Changes

This subject reflects changes to the SimpleMU program by Build Date:

Release V 1.6.9 and 2.2.9

December 1st, 1996

•	Eliminated GPF Error.

•	Released SimpleMU Manual

•	SimpleMU now reacts to a 'connection refused'.

•	Added 'At Connection' optional text.

•	Fixed SimpleMU Tab Handling so Word Wrapping works as it should.

•	Fixed a reported bug caused by a line of text containing only one space, at the beginning of the line.

•	SoftCode commands now easily accept multiple words for the Object.

•	SimpleMU now remembers if it was closed Maximized or Minimized and restarts in that format.

•	The Toolbar now remembers if it should be docked at the bottom.

•	Activity Box is now visible on Toolbar and moved to Send Window when Toolbar is hidden

•	Added extra error handling for Winsock Errors.

•	By Default, Bright ANSI Colors is now No.

•	/bright - Toggles Bright ANSI Colors on and off.

•	/addgag <text> Adds a gag on the fly.

•	/gexit <exit name> Grabs an exit name and brings it into the send window for editing.

•	/partial <color> <text>  Adds a word hilight color to text with defined <color#>. See the table below

•	/addhilight <color> <text> Adds a line hilight color to lines with text using defined <color>

•	 /bg <color> Temporarily changes the Background color to <color#>  This will last until you restart SimpleMU.

•	/fg <color>  Temporarily changes the Foreground color to <color#>  This will last until you restart SimpleMU.

•	Found a bug in the Activity Playsound that would cause configuring your own sound not to work.

•	Added 6 more highlight color options.  These will work provided you do not have Bright ANSI Colors checked on the Site Configuration Window.

•	The Activity Notification Window now pops up as it should instead of waiting for SimpleMU to get focus.

•	 SimpleMU's terminal window no longer adds blank space at the bottom when the Window is resized.

    Release V 1.6.8 and 2.2.8

    November 17th, 1996

•	Fixed Page-Down Key Behaviour.

•	Consolidated Gags, Omissions, Sounds and Triggers to the Settings Screen.

•	Dis-abled Cancel Connection when SimpleMU is busy looking up a HostName.

•	Added BytesSent and BytesReceived to the Status Bar.

Release V 1.6.7a and 2.2.7a

October 27th, 1996

•	The Sessions Window no long loads when SimpleMU does.

•	The Activity Box has moved to the Send Window.

•	CTL-A now inserts the appropriate space.

•	SimpleMU checks on load to ensure it is being run from the appropriate directory.

•	/commands can now be sent to the server using the format //command.

•	CTL-X replaces CTL-E for exiting SimpleMU.

•	Empty Commands are no longer stored in the History Buffer.

•	The END Key now works to scroll the screen to the bottom.

•	The Receive Window no longer jumps down a page when selecting text for copy.

•	The Toolbar can be docked at the bottom of the screen.

•	Added Tool Tips to the Toolbar.

Release V 1.6.7 and 2.2.7           (Pre-Release Only)

October 20th, 1996

•	Added many more options.

•	Removed Picture Tiling

•	Added support for sounds.

•	Moved toolbar to top and it is now hideable.

•	Added option to hide horizontal scrollbars.

•	Added site definition window.

•	Removed Site Lists.

•	Default scrollbar buffer is now 50 lines.

•	Removed WHO Font and Color Options. (Sometimes too much customizing is overkill!)

•	Added connection status window.

•	Forms now stay on top of SimpleMU but are non-invasive of other programs.

•	Added Session Window.

•	Log files can now be appended.

•	Disconnected sessions can now be saved to a log file.

•	/commands are now stored in the history buffer.

•	/who now performs same function as WHO Command Button.

•	/decompile commands enables full decompiles to be pasted into the send window.

•	/w # toggles to open session #.

•	Changing Global Defaults now affects site definitions that were using the previous defaults.

•	Mail can now be of any text length.

      Release V 1.6.5 and 2.2.5

  July 30th, 1996

•	Removed Extraneous Scroll Window Menu.

•	Added Picture Tiling to Forms.

•	Notify Window now informs once then Minimized SimpleMU Flashes.

•	Removed Two extraneous dead Windows that were eating up memory.

•	Various Cosmetic Bug Fixes.

•	Chat Window now hides Scrollbars if option is checked.

•	(Shift-PageUP and Shift-PageDown will scroll Chat Window).

•	Up Key and Down Key now work to scroll Receive window when the Send window has no Text.

      Release V 1.6.4 and 2.2.4

•	Fixed a bug in CTL-T and CTL-S.

•	Added a menu option to disable Confirmations when closing or disconnecting Worlds.

•	Fixed a bug in the Log Recall routine.

•	Removed the Scrollback Window, PageUP and PageDown now work as they should.

•	Added Command Line option, SimpleMU can now be used as Netscape's Telnet Program and will pull telnet://address:port into the Connect Window.  Keep in mind this only works with MUDs and MUSHs, SimpleMU is NOT a freestanding telnet program. Fixed an bug in logging to multiple parts.

•	Removed the Scrollback Window, PageUP and PageDown now work as they should.

      Release V 1.6.3 and 2.2.3

July 21st, 1996

•	Various patches to correct bugs introduced by Terminal Change.

•	Windows are now recycled 100% wich is easier on Memory and speed of connections.

•	Added Scrollback Window which can be accessed with the PageUP/PageDN or /scroll command. (The /scroll or HOME Key will subsequently hide it.)

•	Added option to lose scrollbars.

•	Removed Autoscroll to Bottom Behaviour.

•	Added Cut and Paste option to remove Carriage Returns.

•	Added ScrollBack Buffer Setting.

•	Added Setup Wizard for setting up SimpleMU after upgrading.

 	 Release v 1.6 and 2.2         (16 and 32-Bit Versions)

 July 14th, 1996

•	Added Cancel Button to Settings Window

•	Logs can be recorded with Word Wrapping Format (Registered Version)

•	You are not only notified of activity once when SimpleMU is minimized.

•	You can now paste from and to the send window as well as transfer text between the View Screen and the send window.

•	Repaired 1.5.4 introduced bug with CTL-T and CTL-S not working correctly.

•	Repaired 1.5.4 introduced bug where /grab ate the first character.

•	Disabled ToolBar When SimpleMU is Iconized or When Connection Window is open for you Zealous clickers.

•	The ScrollBack Buffer is now Custom Length Settable.

•	Full-Featured 32-Bit Version

•	Sites can now have independent font styles.

•	/close and /quit default to no.

•	User now has option of logfile directory.

•	Full ANSI color support with use of PDQComm Terminal Addin.

•	This changes the previously working PageUP and PageDOWN features.

•	Scrollbars are now automatic.  Horizontal scrollbars appear if window is smaller then it needs to be.

•	Hilights are now limited to 5 definitions in the unregistered version.

•	Chat WindowFeature added (Registered Version)

•	Small Text Editor Added (Registered Version)

Release v 1.54 (16-Bit Version)          (Limited Release)

June 30th, 1996

•	Sites can now have independent Custom Colors and WordWrapping

•	Corrected Quote bug the caused first line to be skipped.

•	Complete revision of window handling, hopefully squashing the Subscript 9 error for good.  Window numbers are now reclaimed and reused.  SimpleMU doesn't crash if your modem hangs up unexepectedly.

•	If your modem does hang up you are given the option to capture text from the connection before the

      window is cleaned up.

•	Logs are no longer split into 32K parts.

•	SimpleMU can now be used to connect to MUDs.

•	The Send Window is now resizable in Height.

•	Support for /cls (Clear Screen), /quit (Close SimpleMU) and /connect <name> to open an immediate connection to <name>.

•	It appears to load much faster. Many routines were re-written for speed's sake.

•	I've attempted to adjust for the bug caused by the inbound window attempting to print a single line that is wider than the visible screen and has no spaces... this causes the screen to blank.  (A multitext bug.. not mine.)

•	Some of you have complained about a bug that causes the screen to stop printing text, even though you are still connected and exchanging text.  I have pinned this down and fixed it.

•	Error 25005 Invalid Data now correctly reports an invalid hostname error.

•	Error "Invalid Argument." Now asks that you reboot windows. (Looking for other solutions to this one.)

•	The screen no longer scrolls all the way to the bottom when text is received.  (Why I did this in the first place is beyond me!)

•	Hilites can work on words or Entire Lines now.

4/18/96

Release v 1.53a (16-Bit Version)

•	Fixed Scrolling Problems

•	Enhanced Settings Screen

•	Added Custom Option to File Quoting.

•	Added Option not to overwrite exiting logfiles.

4/7/96

Beta Release v 1.53 (16-Bit Version)

•	Fixed RegKey Bug (Finally????).

•	Added ANSI Color Support.

•	Added Hilite Support.

•	Removed Scrollbars. (See TroubleShooting)

•	Added supports for PageUp and PageDown Keys.

•	Extensive rewrite of Word Wrap function for improved speed.

•	Added an option to log from the beginning of the buffer.

•	New Shortcuts "/t", "/sc","/scroll"

•	Added pre-defined Log Omissionoptions.

3/12/96

 Non-Beta Release v. 2.01 (Windows 95) and 1.51 (Windows 3.11)

•	Fixed RegKey Bug

•	Added Enable/Disable Screen

•	Fixed Site Window Bug

•	Changed Mail Window Tab Order

•	Pasting Word-Wrap and Indented Text now Unformats correctly.

•	CTL-S Shortcut Key.

•	CTL-T Shortcut Key.

•	Fixed Crash Bug in /grab command.

•	Site List Now Resizes

•	Removed Some of The Menu Shorcuts. Need more keys for shortcuts.

2/23/96

Non-Beta Release v. 2.00 (Windows 95) and 1.50 (Windows 3.11)

•	Added cancel button when Quoting.

•	Added delay option when Quoting.

•	Added Notification when Quoting is finished.

•	Added /dc command and Disconnect to Menu.

•	Expanded Send History to 40.

•	Fixed Bug that truncated long history recalls.

•	Added Simple Triggers.

•	Added /trig command.

•	Added Custom Log Ommisions.

•	Added Gag Options.

•	Added /gag command.

•	Discovered CTL-ENTER Keystroke.

•	Added Separator for New Activity.

•	Added Notification when a hidden world is disconnected.

•	Added Custom Colors and Fonts for WHO window.

•	The WHO window can now be resized.

•	You can now change the color of the ToolBar

•	The Connect Window now shows the newly added site as opposed to jumping back to the top of the list.

2/4/96

Revision Number:  24

•	Major Cosmetic and Appearance Overhaul to both versions.

•	Added option to change line color.

•	Added option to disable word wrapping.

•	Updated Help File.

•	Added CTL-B Option to store a command into history without sending it.

•	Added CTL-U to clear send window text.

•	Fixed problems with extra carriage returns in incoming text.

•	Added Numerical Key Pad to Map option.

•	Added Activity NotifyOption

•	Fixed Activity Box bug that occured when more then 10 worlds had been opened.

•	Pasted Text now has carriage returns removed from it.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Getting Started

Starting SimpleMU

After a successful installation, SimpleMU creates a Program Icon either in the Start Menu or within the Program Manager inside the Group ‘SimpleMU.'

Double-clicking on this will launch SimpleMU.

It is important that the SimpleMU Application (EXE) file is not relocated from its original installation directory at anytime.  During Installation, sub-directories are created to store information about SimpleMU, as well as Help Files and this Manual.  If the Application File is moved, SimpleMU will not be able to find these sub- directories and will fail to operate properly.

The SimpleMU Interface

The main SimpleMU interface consists of a Send Window, Receive Window and Toolbar.

The Send Window is where text that is to be sent to the Game Server is entered, simply type in the text you wish to send and depress the Enter key, the text will automatically be sent to the Game Server.  This window also accepts commands that begin with the ‘/’ key that performs certain SimpleMU features.

The Receive Window is where incoming text will be displayed as it is received from the Game Server.

The Toolbar houses command buttons for key SimpleMU commands.

Choosing A Destination

In order to use SimpleMU to make a connection to a MU* server you need a destination address.

These addresses consist of a HostName or IP numerical address and a Port Number. For example, the server address for Guardians MUX is jitter.rahul.net Port 4205.

For example purposes, I will use the address for Guardians MUX.

WWW Mud List Archives

Updated Address for currently running MUD servers can be obtained from one of the following WWW sources:

Amberyl's Almost Complete List of MUSHes

http://www.cis.upenn.edu/~lwl/muds.html

The Mud Connector

http://www.mudconnect.com

Doran's MUDlist

http://www.csc.calpoly.edu/~kamundse/MUD/mudlist.html

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Using SimpleMU Features

Handling Multiple Connections

SimpleMU was designed for the die-hard MUSH players who often maintain connections to two or more game servers at any given time.  As each new connection opens, currently open windows move to the back and the new connection window is placed on top.

There are many ways access the newly ‘hidden’ previous connections.

Using The Menu System

The Worlds Menu lists all open connection windows.  You can go directly to one of those connections by choosing it from the list.

The Toggle Command places the currently active window to the back of the list and brings forward the next connection on the Menu list.  This is useful for scrolling through each connection via the Toggle Command or the Shortcut Key CTL-W.

Using / Commands

Entering /t into the Send Window performs the same function as the  CTL-W or Toggle Command.  You may notice that each open connection is given a unique ID number.  You can bring forward a specific connection using the command /w #.

Using /w alone will open the Sessions Window.  This window shows all currently open connection windows.  Double clicking on one of the titles in this list will take you directly to that window.

Once open, the Session Window can be minimized by hitting the Esc Key or Hidden with the Hide Window command button.

Keeping Track Of Activity

While maintaining multiple connections, it is handy to know if some activity is happening in a hidden connection while your attention is upon the foreground window.  There are several events that occur when activity occurs in a hidden world.

The Activity Box

Located on the Toolbar when it is visible and on the Send Window when the Toolbar is hidden, the Activity Box is a small square area that is used for announcing activity in hidden connections.  When activity is present, the Connection Name will appear in the Activity Box and stay there until that connection is brought to the foreground.

Double-clicking on the Connection Name when it appears in the Activity Box will take you directly to that connection.

The Sessions Window

The Sessions Window show all open connections including those which appear to have some activity.  These are designated with the word ‘Active’ after the Connection Name.

Using the ‘New Activity’ Messages

The Options menu contains two options related to Multiple Connections.

Use % Activity in <Site> Notification: Prints a notice in Magenta directly upon the Receive Window.

Use New Activity Separator: Prints "New Activity" before printing to the Receive Window so you know how far to scroll back to when you bring that connection into the foreground.

When SimpleMU is Minimized

In the event that you would like to do other tasks while connected to the game server, you can select the Options Menu choice ‘Notify of Activity When Minimized’.  This option will Alert you to activity that occurs within one of your open connections when SimpleMU is minimized.  The Alert only comes once, you will not be sent another notice unless SimpleMU is brought to theforeground and then minimized again.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


The Toolbar

The toolbar can be hidden altogether by choosing Options and Hide Toolbar from the pull down menus.  This option will be stored for each time you start SimpleMU.

The toolbar can also be ‘docked’ at the bottom of the screen by clicking the small box in the upper left hand corner of the toolbar.

The icons on the toolbar represent the following commands:

Lazy Chair:	Connect

Trash:	Close Window

Ink:	Log Connection

Mail Box:	Mail Box

Question Mark:	/who command

Eye:	look command

Hand:	Pause

Exit:	Quit SimpleMU

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Customizing SimpleMU

Now that you have had a chance to establish a primary connection, it is time to customize the SimpleMU interface to your preferences.

Colors And Fonts

SimpleMU stores Default Color and Font choices that are remembered for each session of SimpleMU, these default colors are used by any Site Configuration that has not been explicitly customized on the Site Settings Window.  The Default Color and Font choices are also the settings inherited by New Sites Definitions as they are added.

To change the default properties, open the Settings Window:

Choose Preferences and SimpleMU Settings from the pull down menus.

Or

Type /settings into the Send Window.

Or CTL-I

.

Once the Settings Screen is open, you can choose custom colors for both the Send Window and the Receive window.  The Default Font is also the font that will be used by the Send Window at all times.

Once you are done making the changes, click Done, you will be prompted with a Yes/No to save changes and the window will disappear.  If you are still connected to Guardians (Or whatever address you used for your first connection.)  You will need to close that connection and re-connect for these changes to take place.

Other Interface Preferences

Scrollbars

I have added the option to hide both the Vertical and Horizontal Scrollbars that appear on the Receive Window.  This can be done by choosing Options and Scrollbars from the pull down menus.  It is still possible to scroll the Receive Window without the Scrollbars, via the Page Up, Page Down, Arrow Up, Arrow Down and End Keys.

Send Window Size

The Send Window can be resized with the mouse.  When the Mouse arrow is placed over the upper border of the send window, the mouse cursor will change to an up-down arrow.   Depressing the left mouse key and dragging the border up and down will resize the window to your preference.  This size will be stored for each time you start SimpleMU.

Toolbar

Customizing For A Site Definition

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Log Omissions
Log Ommissions

The Log Options Window allows for the omission of text from the log file.

To configure SimpleMU to gag words or lines of text from a log file:

Using the Log Omission Configuration Window

Choose Preferences then SimpleMU Settings from the pull down menus.

Click on Log Omissions in the Selections Options Box.

Once the window is activated, enter the text you would like to be excluded from the log.

Click Save or Enter.

Some sample Log Omissions are available on the log omission screen and include:

To Omit Pages:     	* pages:*

   	          You page*

                                	From afar,*

                              	Long distance to*

To Omit Whispers:    	You whisper "*

                                	* whispers "*

                                	You sense "*

           	                    	 * senses "*

To Omit Channels:  	[[]*[]] *

                              	 <*> *

To use the pre-set Log Omissions, double click on the one you want from the list on the right.  This will automatically add this to your list of preset Log Omissions.

Entering Log Omissions Manually

Log Omission settings are saved in the SimpleMU\Settings Directory in the file "omits.txt".

This file can be manually edited with any text editor. The proper format is:

 	Text

Text

Text

Where each line of  text is equal to one omission.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Pattern Matching

SimpleMU supports Pattern Matching for Log Ommissions, Gags and Simple Triggers.

This Table gives examples on how the pattern matching works:

Pattern	Matches	Doesn't Match

* smiles.	Foo smiles.	Foo Smiles. or Foo smiles, 'Hello'

* ?rins.	Foo Grins. or	Foo grins, 'hi.'

Foo grins.

10:#0	10:10 or 10:50	10:A0

#log	5log or 6log	#log

[#]log	#log	5log or 6log

[*]smiles[*]	*smiles*	Jane smiles.

You okay?	You okay.	You okay?

You okay[?]	You okay?	You okay.

[[]Nospoof[]]	[Nospoof]	Nospoof

[Nospoof]	Nothing	Everything

<*>*	<Public> Foo	Jane <grins>.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


File Quoting

You can quote from a text file into the current connection by using the Quote Window.

You can open the Quote Window one of the following ways:

Choose File then Quote from the pull down menu.

Or

Type /quote into the Send Window.

There are four ways to prefix a quoted file:

Raw: Quotes the file raw, with no prefix.  Used for quoting in Code.

Say:  Quotes the file in with the Say prefix.

Emit: Quotes the file in with the MUSH @emit prefix.

Custom:  Enter your own custom prefix.. such as Page.

You can also chose the amount of delay between each send.  This should be a value of 1 to 60 representing seconds.  Once quoting is begun a 'cancel' button will appear on the Status Bar.  When depressed it will cancel the operation at the next Delay Interval.

At present SimpleMU cannot quote a file longer then 32K in length.

File Quoting reads the entire text into memory before sending it to the server.  If you are quoting a long file it may take a moment to begin sending the text to the server.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Gags

‘Gags’ define text that you do not wish to ever see printed on the Receive Window.  This text will still be printed in the File Log unless it is listed under Log Omissions as well.

Gags use Pattern Matching.

To configure SimpleMU to gag words or lines of text:

Using the Gags Configuration Window

Choose Preferences then SimpleMU Settings from the pull down menus.

Click on gags in the Selections Options Box.

Once the window is activated, enter the text you would like to be gagged

Click Save or Enter.

Entering Gags Manually

SimpleMU Gag Definitions are stored in the SimpleMU\Settings Directory within the file "gags.txt"

This file can be manually edited with any text editor. The proper format is:

 	Text

Text

Text

Where each line of  text is equal to one gag.

Entering Gags Into The Send Window

Gags can be added via the following Send Window command

/addgag Text

Defines a new gag on Text.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Highlighting Text
Highlighting Text in Color

The Highlight Option Window enables you to enter text and select a color it should be displayed in.  The text you enter will be matched for case sensitivity.

(‘Pages’ does not equal ‘pages’.)

The unregistered version is limited to 5 Highlight definitions.  Registered Users may define unlimited Highlights.

There are 15 color choices for Highlighting.  Some colors may be obscured by custom Background and Text colors choices.  All colors will be forces to Bright if the ‘Bold ANSI Color’ option is checked on the Site Settings Window.

To configure SimpleMU to color words or lines of text:

Using the Highlight Configuration Window

Choose Preferences then SimpleMU Settings from the pull down menus.

Click on Highlights in the Selections Options Box.

Once the window is activated, enter the text you would like to be colored.

Click one of the color options.

Check the box below if you would like the entire line of text that contains that word or words to be colored.

Click Save or Enter.

Be careful choosing to highlight something as simple as one letter.  (like the letter I)  Doing so will lag SimpleMU.

Entering Highlights Manually

SimpleMU Highlight Definitions are stored in the SimpleMU\Settings Directory within the file "Hilight.txt"

This file can be manually edited with any text editor. The proper format is:

 	# [0/1] Text

Where # is equal to a numeric value representing the color the text should be colored in. (See the color table below.)

0 or 1 represents False or True if the entire line should be colored.

Text is the text that should be searched for.

Entering Highlights Into The Send Window

Highlights can be added via the following Send Window commands:

/partial <color> Text  - Defines a new Color Highlight that will only color Text.

/addhilight <color> Text - Defines a new color highlight that will color all lines containing Text.

Highlights Color Table

BLACK	0

BLUE	1

GREEN	2

CYAN	                	3

RED	4

MAGENTA	5

YELLOW	6

WHITE	7

LIGHTBLUE	9

LIGHTGREEN	10

LIGHTCYAN	11

LIGHTRED	12

LIGHTMAGENTA	13

LIGHTYELLOW	14

BRIGHTWHITE	15

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Triggers

Triggers represent a response to text received from the server.  Each Trigger definition has 3 components.  The Pattern Matching string of text that should cause the trigger to happen, the reaction text which represents a command to execute when a trigger has been activated and the Stack Word.

The '|' character (SHIFT-\) represents the pointer where the stack word is to be substituted.

For example:

   If the Stack Word evaluated to "Bar" and the reaction text was:

:dances around |, "Hey |"

   The resulting command to the server would be:

:dances around Bar, "Hey Bar"

Sample Trigger Definition

Trigger Text:

* smiles, "Hi Foo."

Reaction Text:

:waves to |.

Stack Word:

1

Result:

Each time SimpleMU receives text that matches:

<text> smiles, "Hi Foo", SimpleMU will send the pose:

: waves to <text>.

WARNING:

Be very careful that your Trigger Text and Reaction Text do not match or you will throw the client into an infinite loop reaction.

An example looping trigger would be:

Trigger Text:  *smiles*

Reaction Text: :smiles.

To configure SimpleMU Triggers:

Using the Triggers Configuration Window

Choose Preferences then SimpleMU Settings from the pull down menus.

Click on Triggers in the Selections Options Box.

Enter The Trigger Text, Reaction Text and Stack Word (if one applies).

Click Save.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Command History Window

The view history window enables you to view and re-capture the last 40 commands you have sent to your connections.

To open the History Window do one of the following:

Choose Edit then View History Window from the Pull Down Menus.

Type /history into the Send Window.

Once the History Window is visible, a double click on the Command  you wish to resend will place that text into the Send Window.

You can also use the Keystroke commands of CTL-P and CTL-N at the Send Window to scroll through the history lines individually without opening the History Window.

CTL-B will take text from the Send Window and store it into the History Buffer without sending it.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


F-Key Macros

The F2 through F12 commands can be assigned one or more commands to be sent to the Server.

To open the Keyboard Macros window choose one of the following:

Select Preferences and then Settings from the Pull Down Menus.

Click on F-Keys from the Settings Selection Box.

Multiple commands are separated by the character | (Shift-\).

Example:  F2: Say Hello!|pose smiles.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Mail Room, The

To configure the Mail System open the Mail Room Window by typing /mail into the Send Window or clicking the Compose Mail button on the toolbar. Choose Configure from the Tool Bar at the bottom of the Mail Window.

The Mail Room Configuration window will open offering one of three options.

+mail	A common format used on TinyMUSH

@mail	These commands support the TinyMUX mail system.

Custom	Here you can change the commands to whatever is

                                    supported by your favorite MUSH.

The Configuration setting should be set correctly for the current world you are about to send mail to.

Save Copies Check Box

Check this box if you want to save copies of the mail you send out.

The Mail Window

To compose mail simply type in the name of the character you wish to send mail to.

If you are sending to multiple characters, the format (a space or comma separated list) should be whichever is supported by the inter-MUSH mail system you are using.

Pressing the Enter Key will move you down to the next box.

Pressing the Tab Key will move you down to the command buttons.

Please note that not all Mail systems support the Blind Carbon Copy command.

Mail Text:

Pressing the Enter Key while composing the body of your message will insert a %r into your mail message. (Thus adding a carriage return to your mail message format.)

When you have finished composing the message you can choose Send or Save. (If you have the Save Copies option selected on the Mail Configuration Window the Mail will automatically be saved when you send the message.

The Mail Box

You can save the mail you are composing to your mailbox to be sent at a later time.

Simply click on the Save button and it will be saved into your mailbox.

Opening Saved Mail

SimpleMU saves copies of mail sent in the SimpleMU mailbox is you click the Save button or have the option of saving mail checked on the Mail Configuration Window.

To Open a saved letter click the Open command button on the Mail Room Window.

The Mail Box window will open and display an index of the mail in your mailbox.  To choose a letter for opening select one from the list by clicking on it with the mouse and choose Open.  Or you can also delete the selected letter by choosing Delete.

Advanced:

The Mailbox information is stored in you SimpleMU\Mail directory, it can be manually edited if needed.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Chat Window
Chat Window (Registered Feature)

The chat window was designed to be used with MUSH/MUCK type environments.  It can be displayed and hidden on your current connection by typing /chat into the send window.  The chat window will display all text that matches the following formats: (Channels and +watch code)

[text] text and <text> text

Puppet spam can be placed in this window as well by typing /puppet.  This will catch any text that has the format text> text.

Lastly all text containing the word page can also be placed into this window by choosing /pages.

Each of these features can be toggled on and off by retyping the command associated with it.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


The View Window
View Window (Registered Feature)

The registered version of SimpleMU features a simple Text-Editor that can be used to load, edit and cut and paste text to and from SimpleMU.  To open this window type /view into the send window or choose Edit and View Window from the pull down menus..

SimpleMU Help File - Helpfile generated by VB HelpWriter.


SimpleMU

SimpleMU is a client application designed to work with an Internet Direct or SLIP connection to the Internet.  It uses a modified Telnet Protocol to connect to a remote Game Server running a server type from the MUD family.  This includes but is not limited to MUSH, MUX, MOO, MUD and MUCK.

Minimum System Requirements

Internet Connection

486/25 or Higher Processor

6MB of RAM

WindowsÒ Operating System

5MB of Disk Space

Recommended System

486/100 or Higher Processor

16MB of RAM

Hardware Supported

Sound Card

Winsock Supported

SimpleMU for the Windows 95 or Windows NT operating system requires a 32-Bit Winsock stack.   It will not work with America Online’s 16-Bit stack, nor Trumpet Winsock’s 32-Bit Thunking Stack.  In order to run SimpleMU with these versions of Winsock, you must use the version designed for the Windows 3.1 operating system.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Site Definition Window

Each newly defined Site Configuration defaults to the Color and Font choices defined by the Settings Defaults.  It is possible, however, to configure each connection so that each uses a different Color Scheme and Font.  This is done on the Site Settings Window.  After selecting the Site Name you wish to edit, click upon Define Colors or Fonts to gain access to making changes to these default settings.  Once you have decided upon a scheme you like simply choose Save to commit the changes.

                SimpleMU Help File - Helpfile generated by VB HelpWriter.


Sounds

SimpleMU supports custom configuration for playing wav files at events.

Startup, Shutdown and Activity (Used in conjunction with the Activity Notification.)

SimpleMU also supports Sound Triggers, where a Wav file can be played when certain text is matched. (Using Pattern Matching)

The shareware version supports 5 configurations, the registered version supports 10.  These triggers use pattern matching.

To open the Sounds Window, choose Preferences then Settings from the pull down menu.  Click on Sounds in the Settings Options box.

To define a sound trigger enter one or more words with pattern matching syntax in the Text Box indicated by "Keyword(s)" then click Select.  This will open a browse window so you can choose the Wav file you want to be played when incoming text matches the keyword statement.

Sound Example:

To play a sound each time someone pages you with Wakeup!, your keyword would be: * Wakeup!*

SimpleMU Help File - Helpfile generated by VB HelpWriter.


/Commands

/addgag <text>	Adds a Gag

/addhilight <color> <text> 	Adds a highlight color to lines with text using

defined <color>

/bg <color> 	Temporarily changes the Background color to

<color#>  This will last until you restart SimpleMU.

/bright	 	Toggles Bright ANSI Colors on and off.

/chat	Opens/Closes a separate window for Chat Channels

/puppet	Adds Puppet Spam to the Chat Window

/pages	Adds Pages to the Chat Window

/connect, /c  or /con	Opens the Connect Window.

/con [site name]	Opens an immediate connection to [site name].

/close or /cl	Closes a disconnected connection.

/cls	Clears the Inbound Window.

/dc, /disconnect or /dis	Closes your connection to the current window.

/decompile [object]	Decompile a soft coded object pasting the text into the send window. (MUSH)

/fg <color>  	Temporarily changes the Foreground color to

<color#>  This will last until you restart SimpleMU.

/grab <object>/<attribute>  Grabs the contents of the named attribute from the

object and places it 	into the Send Window for editing.

/gexit <exit name>	Grabs an exit name and pulls it into the Send Window

for easy editing.

/history  or /his	Opens the History Window.

/log  or /l	Begins or Ends File Logging.

/mail or /m	Opens the Compose Mail Window.

/max	Maximizes the SimpleMU Window.

/min	Minimizes the SimpleMU Window.

/mid	Sets the SimpleMU Window back to normal size.

/partial <color> <text>  	Adds a word highlight color to text with defined

<color#>.

/quit	Closes SimpleMU.

/quote	 	Opens the Quote Window.

/refresh	Refreshes the display.

/settings or /set	Opens the Settings Window.

/t or /tog	Triggers the Toggle Event

/view or /v	Opens a small text editing window.

/w [#] or /world [#]	Displays the Sessions Window.  When the optional #

is supplied, connection # is brought to the foreground.

/who	Sends the DOING command to the active connection.

Also activates the WHO Window.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


Contact And Update Information
Bug Reports And Technical Support

Technical support is available via Internet email only from the address shae@together.net.  This includes Installation Assistance, Bug Reports and feature requests.

When reporting s problem or requesting help, it is very important that you include the following information with your request:

SimpleMU Version: (1.6.?, 2.6.?)

Windows Version:

Winsock Version: (Microsoft Winsock, Trumpet Winsock, Chamelion...)

This problem occurs:  Every time or Occasionally

If the problem occurred while attempting to make a connection, what

is the address you were connecting to?

If You received an Error Message please include the exact Text of

the Error and If possible the Error #:

The latest version of SimpleMU can be downloaded from its homepage:

http://www.together.net/~shae/simple.html

If you would like to be advised when updates to the SimpleMU Program are released, email Shae@together.net with a request to be added to the mailing list.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


MUSH Specific Features

Soft-Code Support

/grab <object>/<attribute>

Grabs the contents of the named

attribute from the object and places it

into the Send Window for editing.

Example:   /grab me/desc

/decompile <object>

Decompile a soft coded object pasting the text into the send window.

/gexit <exit name>

Grabs an exit name and pulls it into the Send Window for easy editing.

WHO Window

The WHO Window captures WHO Text from the server and displays it in a separate window.

/who

Sends the DOING command to the active connection.

Also activates the WHO Window if that option is checked under the Options Menu.

SimpleMU Help File - Helpfile generated by VB HelpWriter.


C

Connect Window

Contact and Update Information

D

Default Colors

Default Font

H

HostAddress

HostPort

L

lag

M

MUSH

S

Send Window

Site Definition

T

Toggle

U

UserID

W

WHO window


Connect Window

The connect window lists all previously defined connection sites.


Contact and Update Information

SimpleMU is written and supported by Kathleen MacMahon (shae@together.net)

As of this release, updates will be available from:

ftp.rahul.net /pub/galen/simple

or

http://www.together.net/~shae/simple.html

If you use SimpleMU on a regular basis, you should drop a note to the above address so you can be notified of updates.

Feedback both in the way of suggestions or bug reports is always welcome at the above address.


Default Colors

The default color settings are the colors which are assigned to each newly created Site Definition.


Default Font

The default font setting is the font which is assigned to each newly created Site Definition.


HostAddress

The HostAddress is an IP or Doman Name address representing the remote machine where the MUSH server is running. (ie. jitter.rahul.net)


HostPort

The HostPort represents the port number on the Remote Machine where the MUSH Server is running. (ie. 4205)


lag

A term used in MUSHing to represent the delay in time for the results of a command to be executed.  This lag can be caused by a slow connection, network traffic, or a server running on a heavily loaded machine.


MUSH

A MUSH (Multi-User Shared Hallucination) is one of the many type of Multi-User Dungeons that can be found on the net.  These include TinyMUSH, PennMUSH, AlloyMUSH and TinyMUX game servers.  MUSH games are often built around an established theme and has interactive roleplay as its main objective.


Send Window

The Send Window located at the bottom of the SimpleMU Main Screen is where text can be entered to send to the currently activated connection.


Site Definition

The Site Definitions are stored in the SimpleMU\Sites directory.  These files store the following information about each of the site addresses you have defined:

HostAddress, HostPort, UserID, UserPassword, Font Settings, Color Settings, Word Wrap Settings, Last Connection Date and Total Connection Time.


Toggle

The 'toggle' event scrolls through all open connections one at a time.


UserID

A UserID is the name of the character you have created for play on the remote MUSH Server.


WHO window

The who window is used to display the results of a WHO command into a separate window.  Clicking on a name displayed in the WHO indow will paste "page name=" into the send window.