
                      KonnMuck MUD Client for Photon
                       (c) 1997 by Klaus Schneider


KonnMuck is a FREE client program for text-based MUDs for the Photon MicroGUI.
The current version is 0.2.

Now you may want to know what a MUD is because you have never heard about 
such a thing. Well, MUD stands for MultiUserDungeon. It is a virtual reality, 
an interactive roleplaying game in the internet.
There, you can find players from all over the world playing their characters.
Together with them, you can look around, have adventures or just talk or do 
mostly anything you can imagine.

This program implements Input/Output handling, session logging, automatic 
login, and a list where you can set up your prefered MUDs to connect to 
within only a few mouse klicks. The application can be configured via an 
easy to use configuration file.

NEW IN THIS VERSION:
Now, there is a scrollbar available in the output window. Also, a minor 
bug in the "registration" stuff has been fixed: sometimes the program
seemed to "forget" a previous registration. The .konnmuck.data file now
has a new data structure. (But don't worry, the old one will be correctly 
converted if you start the new version for the first time. If it doesn't,
it is a bug!)

New in version 0.15:
A new feature has been added: you now can send commands stored in a file
to the MUD you are currently connected to. That prevents you from typing
in all commands. For example, if you want to transfer a longer description,
this saves connection time.
Just create a file with one command each line, just as you would type them
manually, and then, click on "Send file" in the "Connection" menu, select
the file you want to send and click on "Send". Ready.
In addition, some minor changes have been made, for example the correct
setting of the menu state.

New in version 0.14:
The bug to look for the connect and receive programs in the wrong
directory has been fixed. Also, the "receive" program is named
"konnreceive" and "connect" "konnconnect" to prevent troubles with
programs that happen to be named "connect" or "receive".

New in version 0.13:
All commands are saved in a list so that you can get them within two
mouse clicks.

The archive contains the following files:
 README         - this readme file
 konnmuck       - the executable
 konnreceive    - the receive program for konnmuck, called by konnmuck
 konnconnect    - the connect program for konnmuck, called by konnmuck
 konnmuck.en_GB - English translation of KonnMuck, must be installed into
                  the /usr/photon/translations directory

Configuration file:
It is called ".konnmuck.cfg" and is located in your home directory. A sample 
configuration file will be created if none is found. There will also be a 
dialog window where you can select your prefered language (until now, the 
only languages available are English and German; if you wish to translate 
my application into another language, please let me know - email address 
see below).
Just look into the default configuration file to understand how it works, 
it is well commented and easy to understand (I hope).


COPYING CONDITIONS:
THIS APPLICATION IS FREE OF CHARGE. You are welcome to copy it to anyone
else.
YOU MAY NOT SELL EITHER THE PROGRAM OR ANY PART OF IT NOR MAKE MONEY WITH 
IT IN ANY OTHER WAY.
THE APPLICATION COMES WITH NO WARRENTY OF ANY KIND.

Please register to give yourself the chance of being informed about new
versions or any other news about this application.

NOTE: This is NOT a registration in the sense of a license. I just want
      to know how many people use my program and also give you the chance 
      of being informed about new versions.

There will be a dialog window which will ask you for your name and your
email address when starting the application for the first time. Then your
serial number will be requested by HTTP.
If you do not wish to provide your personal information, please leave the
text widgets empty. Then you only will be counted as a new user of KonnMuck
and receive your serial number.
Your user information will be stored in a binary file called ".konnmuck.data" 
which is located in your home directory. Please do not delete or edit it.
When you give KonnMuck to another person, please do not copy this file.

The following data is stored in the .konnmuck.data file:
 - a code string to identify the file ("KonnMuck Info File\n")
 - the version of the KonnMuck application
 - your serial number
 - some date stuff
 - your name and email as given in the dialog box


PLEASE SEND ANY COMMENTS, BUG REPORTS OR OTHER QUESTIONS TO
klaus@ds3.etech.fh-hamburg.de

This program also has a web page at
http://ds2.etech.fh-hamburg.de/~klaus/konnmuck/
(German version) or 
http://ds2.etech.fh-hamburg.de/~klaus/konnmuck/konnmuck.engl.shtml
(English version).

-----------------------------------------------------------------------------

P.S.: You ask why the default language is German? Well, it is just because 
      I am a German-speaking person, so I developed my application in German. 
      When I decided to make it accessable to others, I translated it.
