### Current version

MudMagic Client version 1.9, released September, 2, 2006. Read the ChangeLog to see what's new in this version.

### Introduction

Welcome to the MudMagic Mud Client for online text game enthusiasts. This is an OpenSource project developed by the Host Team at MudMagic.Com. This is a free software, and will always remain free. Proceeds earned by the www.mudmagic.com website are reinvested in the continued development of this software.

The client is designed to operate on Linux OS distros, Microsoft Windows XP and above, and MAC OS X ( with the assistance of X11 package ). The program is bundled with the gtk+ library for GUI enhancements on Windows and Mac - meaning no additional installations are required, other than downloading and running the client. There are different releases of this software.

If you have a recomendation for the software, or find an error, please post it on our public forums at: Mud Client Forums

### Copyright / Standard disclaimers

The contents of this documentation, and the name MudMagic & MudMagic.Com, is Copyright © by MudMagic.Com, eMail hosting@mudmagic.com. The source code is covered under GNU GPL licensing.

    	/***************************************************************************
    	*   This program is free software; you can redistribute it and/or modify  *
    	*   it under the terms of the GNU General Public License as published by  *
    	*   the Free Software Foundation; either version 2 of the License, or     *
    	*   (at your option) any later version.                                   *
    	*                                                                         *
    	***************************************************************************/

### Downloading

There are several versions of the Mud Client available for download.
- For Windows

- Memory Stick Version [ Mudmagic-version.zip ] : This download allows you to download the software program onto a removable storage device such as a memory stick. It is usually a 10Meg zipped file. To use the client on any Windows XP workstation, you move the zipped archive from your storage device to somewhere on the hard drive. Then extract the file by right-clicking and selecting extract. The program will unzip into: mudmagic-version directory. Going into this folder, and then clicking on the MudMagic Wizard icon will start the client.This version of the client is bundled to operate without requiring any type of setup or installation - just click-n-go
- Full Setup Version [ MudMagic-version-setup.exe ] : This download for Windows XP allows for the end desktop user to do a full installation of the mud client for all users on your computer. The software installs itself in the PROGRAMS -> MudMagic directory. An Uninstall feature is available with this version.
- As of version 1.9 of the mud client, there will be no further Win98 support

- For Linux

- Linux RPM Binary [ mudmagic-version-fdr.i386.rpm ] This is the Fedora Core 5 binary version of the software client. It is designed to operate out of the box on any Fedora Core OS ( version 5 of this release, and potentially earlier releases )
- Linux SRC RPM [ mudmagic-1.8-fdr.src.rpm ] This is the Fedora Core 5 source code RPM package for rebuilding the software on any Fedora OS.
- For other Linux Binary distributions, see the Linux download page of the Mud Client area on our website. Several users of this software provide Linux binary uploads

- For MAC OS X

- Disk Mount Image [ MudMagic-version.dmg ] This is the MAC OS X disk image version that can be dragged to toolbar. It automounts disk when clicked and is smaller in size than the non-compressed release. This version requires the X11 package to operate. See the Mud Client MAC OS X page of our website for details.

- For All OS

- Source Code Version [ mudmagic-src-version.tar.gz ] This is the full source code of the text game client. See the Developing section for details on compiling this version.

### Feature Overview

Let's have a brief look at some of the features. Click on the image to see a full snapshot of the feature. For more details on these features, plus many more - view its respective documentation to the left.

Game List Wizard | The Game List Wizard feature provides a front end to locating the perfect online text game. Features of this wizard include the Full Game List from MudMagic.Com website (updatedable on demand), Our FEATURED text game, and the Top 30 text games. Sorting of fields, and field selections allow you to view any list based off Game Name, Theme, Codebase, Search Criteria and more.
Saved Character | Software configuration settings are saved on a character-by-character basis. This includes proxy settings, font settings, aliases, triggers, macros, notes, and much more. You can access your individual Saved Characters with the OPEN dialogue button. Saved Characters can then be exported and imported online by use of your mudmagic.com website login.
MXP & Protocols | Med Xtension Procotol (MXP), Mud Sound Protocol (MSP), Mud Client Compression Protocol (MCCP) are supported. MXP variables and guages can be modified on a game-by-game basis.
Recorder, Notes, Automap | Loadable modules are available in the: Settings -> Modules area. Notes can be used to store date-time specific notes on a game-by-game basis. If you are looking for a command recorder, to create Speed Walk aliases - the Recorder feature makes catching input a snap. The Automapper is more a proof-of-concept which will be heavily developed in future 2.x releases of the software.
Alias, Trigger, Hotkeys | There are two areas which provide Alias, Trigger, and Macro (hotkey) support. You have your GLOBAL Actions area, which allow you to create these features for every game. Or you can use Profile -> Actions to create a user-specific set of alias, triggers and hotkeys. Python scripting, BASIC scripting, Plain Text Output, Sound for events ( mp3, wav, midi ) and popup windows on events are all available.
Delayed Input | Delayed Input, located under Tools -> Delayed Commands; allows you to continuously, or only once input a specific command. This works hand in hand with Triggers. So if you need to execute a trigger, or alias at certain times - this is the tool for you. This is handy for anti-idle outs and practicing those skills.
Font & Colors | Pango fonts are used with this software program. The font system allows you to set your font preferences. Color for input, output, and echoing on a per-game storage basis is also available.
Theme Engine | This software makes use of the GTK+ Theme Engine. This allows you to modify the look and feel of your client to your specifications. Wether you need large text output, or are looking for a sleeker option - the theme engine will support it. For more themes, visit Gnome Look

### ChangeLog

    1.9:
    ---------
    * Mar 2006
    Victor Vorodyukhin < victor.scorpion@gmail.com >
    	- tools
    		* added dialog window for script testing
    		* added dialog window for passing long text to client
    		* added dialog window for viewing session log files
    		* added ability for commands sheduling
    		* added support of remote storage for keeping session settings on dedicated server
    	- network
    		* added proxy support
    	- interface and usability
    		* added connectivity to system browser
    		* added ability for keeping MudMagic account credentials for remote storage access purposes
    		* user defined browser used to open MudMagic web site for recovering forgotten password
    		* added Featured Game icon to main window
    		* added game icon support to Saved Characters dialog
    		* added proxy server selection ability for saved games
    	- user defined actions
    		* added support for sound capable triggers
    		* added support for popup message type triggers
    		* added support for plain text type actions (aliases, triggers and macros)
    	- Connection Wizard
    		* added support for game icons
    		* game list separated by 'All', 'Top 30' and 'Featured Game' now
    		* added search dialog
    		* added ability for hiding user selected game entry colums
    		* user defined browser used to open game link

    Tomas Mecir :
    	-MXP support fully implemented
    		*gauge values located in Profile
    		*MXP variable settings located in Profile

    Kyndig
            -Deleting an entry in the OPEN dialogue now works on windows
            -Concatenation in BASIC language now supports '.' character
                    * send "This is a".$test;
            -Removed text based documentation and added in HTML based documentation
                    * much more documentation added - much more documentation to go

    Applied Patches: < http://www.mudmagic.com/mud-client/boards >
    < Pythos >
    - src/interface/data.c
    	don't add sent lines to the sent-command-history list, when server
            is responsible for echoing.
    - src/protocols/telnet.c
    	* IAC_GA, IAC_EOR added.
    	* TELOPT_END_OF_RECORD added
    	* prevent client from losing data at the end of a cutoff zlib stream
    	  when the client has read more data than is currently in the stream

    < Vanthar >
    Forum Feedback: < http://www.mudmagic.com/mud-client/boards >
    - interface/interface.glade
    	spelling error,  -Settings/Strings:
    	"Command seperator string" (<-"separator")

Copyright © 2004-02-26 MudMagic.Com