Download

mudlist_v0_3.tgz (6.5KB)

Instructions

Download the file above to wherever you want to put it and then untar/gzip it e.g. with tar xvf mudlist_v0_3.tgz and it creates a subdirectory called mudlist in your current directory.

You'll need to know where your want the mudlist web page and info page to go. You'll probably want the web page to go in your public_html directory and the info page to go in data/INFO for your MUD.

Edit mudlist_client_conf.txt to set your locations and change the colours if you want. The file is commented and it should be easy enough to find what you need to change.

Copy the stylesheet file mudlist.css to wherever you're going to put the HTML page and edit it if you want.

Run perl -w mudlist_client.pl and there you go!

You'll probably want to set a cron job up to run it every two hours. The server runs the job every two hours on the even hours of the day e.g. 14:00, 16:00, 18:00 etc. UK time (usually 8 hours ahead of US Pacific time or an hour behind Central European time). The server may take a while to run the job which creates the file that's downloaded by the client, depending on the number of MUDs that are down and the reason, so it's suggested you allow half an hour for it by e.g. running the job every 2 hours, but on the half hour. For example a crontab entry might look like this for a MUD running in the UK:

# MyMUD's crontab
#
# Fields are as follows:
#
#             field          allowed values
#             -----          --------------
#             minute         0-59
#             hour           0-23
#             day of month   1-31
#             month          1-12
#             day of week    0-7 (0 or 7 is Sun, or use names)
#
# See man 5 crontab for more info
#
# Update the mudlist every two hours - added by Ellyll 2002-02-03
30 00,02,04,06,08,10,12,14,16,18,20,22 * * * cd mudlist ;
  perl -w mudlist_client.pl 2>&1 >mudlist_client.log ;
# Note that the above is on one long line, not two seperate as shown here.

Feel free to edit the client Perl script if you want but be aware that if a new version comes out you'll probably need to reapply the changes.

Disclaimer

You install and run this at your own risk, if you don't want to take the risk either read the code yourself and change if required or don't run it. I have tested it on Debian Linux and Windows without a problem but the fact that it worked ok for me does not mean it will work ok for you. Remember this is still only a development version and has not been thoroughly tested.

Copyright

The copyright for this code belongs to me, but you can use and modify this script for your own MUD as long as the MUD is totally free (i.e. no charge what so ever). If your MUD does not fit this criteria and you would like to use this client please feel free to contact me. Note that in the future, once I feel the code is more stable I will probably release both the client and server code under the GPL.

Who to hassle?

If you have any requests for changes to the script, or any comments or suggestions for improvements, problems or bugs please email me at ellyll@yahoo.com or find me on a MUD (I'm normally on ElvenMUD, Northern Lights or Cryosphere as Ellyll).