Geas Custom MUSHclient Package

If it's no bug or an idea, but it's still mud-related, it goes here.

Moderator: Wizards

Post Reply
User avatar
Posts: 54
Joined: Tue Oct 24, 2017 6:51 am

Geas Custom MUSHclient Package

#1 Post by Israfel » Sat Oct 27, 2018 12:15 am

(Updated 6 October 2019: New version of the client is now available with more plugins and fixes. Notable changes include the addition of a Soundpack for ambient and combat sounds, and a preconfigured version of the client for VI players. The VI version should be compatible with screenreaders)

Hi all

I have packaged up a customised version of MUSHclient to be pre-configured for Geas. Essentially it is a package that includes the current latest version of MUSHclient (available here: for free) as well as a pre-configured world file for Geas and a few plugins.

This package includes the following plugins:
1. GMCP Handler (back-end script that supplies data to other plugins)
2. GMCP Auto-Mapper (described here: viewtopic.php?f=7&t=2679)
3. GMCP Visual Vitals Bars (described here: viewtopic.php?f=7&t=2658)
4. Geas Voting Reminder (described here: viewtopic.php?f=7&t=2658)
5. Chat Miniwindow (described here: viewtopic.php?f=7&t=2689)
6. Clickable Action Bar Icons (viewtopic.php?f=7&t=2687)
7. Geas Soundpack (Ambient, Combat, Communication sounds, Combat music ( ...
8. Custom Colour Formatter (expands setcolour options, required for SoundPack)
9. Status Handler (handles some GMCP variables, sends abbreviated text updates when hp, mana, stamina, fatigue changes)
10. Map Marker (gives you the ability to add notes and bookmarks to rooms)
12. Mushreader, Capture MUD Output, Output Functions plugins (for VI version only)
13. A few additional utilities including one that lets you move and resize your main output window.

This is an early attempt to package it all up for easy distribution. There are going to be a few bugs. If/when you find them please report them to me here on the forums or on Slack.

Three versions are now available and one additonal optional download:

You can DOWNLOAD THE CUSTOM CLIENT from dropbox here:

Client with sounds (224MB download): ...

VI client with sounds (224MB download, contains mushreader): ... fHrga?dl=0

Non_sound version (6MB download): ...

Combat Music Soundpack (optional, 1GB download): ...

Standalone plugin files (not necessary for download, listed for bug fixes or if you need to get a clean version of a certain plugin): ... n1DJa?dl=0

1. download the entire zip file (6.1mb)
2. unzip to your desired location
3. If you’re installing the optional soundpack, just replace your Mushclient\sounds\combatmusic folder with the downloaded folder of the same name, then restart your client.
4. run the MUSHclient.exe in the MUSHclient folder

Upgrading or changing from an existing MUSHclient world:
5. run the steps above and run the new custom Mushclient
6. a Geas world will automaticall open
7. Got to File\Import.. or hit Ctrl+Alt+I
8. Select the tickboxes for what you want to import (eg aliases, triggers etc)
9. Import from: (click File), now locate your old world file in your old Mushclient\worlds folder (eg Geas.MCL)
10. Click load.
11. Add any plugins you want to bring over by going to the plugin manager (Ctrl+Shift+P) and adding them

Bring across an existing map database:
12. Locate the 'geas.de_3334' file in your old mushclient directory. Copy that into the new installation, replacing any existing file of the same name

1. A Geas World file should load automatically prompting you to sign in
2. I highly recommend utilizing the quick-login feature which can be set up in the Game\Configure...\Connecting menu
3. Many plugins require colourset changes. This will configure your coloursets with the MUD but give you more options to change them to a variety of colours of style. If you wish to use the communication miniwindow and the soundpacks, you MUST run the colour formatter by typing 'xsetcolour setup'
4. The Icon Bar is a default set of clickable buttons. They're there as an example. Instructions on how to modify this are in the plugin xml file. This can be edited in most text editors and also from within MUSHclient.
5. The following helpfiles are available for the plugins:
Xsound help : sound manager
Xcolour help : colour settings and formatter
Mapper help : GMCP mapper
Xmark help : map marker and notes
Xfish help : secret quest

Map or Vitals GMCP troubleshooting:
Occasionally you might log in and find that the GMCP startup sequence runs but you get no data flowing for the map or health bars. There are a few troubleshooting options for this but the easiest fix is just to reconnect to the mud and let it run again. 99% of the time this will fix it.

Message me with any issues on the forums or on the Geas slack group.

You do not have the required permissions to view the files attached to this post.
Last edited by Israfel on Tue Nov 05, 2019 1:45 am, edited 5 times in total.

User avatar
Posts: 54
Joined: Tue Oct 24, 2017 6:51 am

Re: Geas Custom MUSHclient Package

#2 Post by Israfel » Sun Oct 06, 2019 6:12 am

Updated 6 October 2019: The post above has been modified for the release of a new version of the Geas Client with more plugins and fixes. Notable changes include the addition of a Soundpack for ambient and combat sounds, a preconfigured version of the client for VI players, and FISH LIFE. The VI version should be compatible with screenreaders. Enjoy :)

The old version is also still available here: ...


15 Oct 2019 - Fixed a few bugs occuring with the colour formatter and with client-side highlighting triggers interferring with line detection. Download links have been updated to include new versions and an extra link has been listed in the above post to updated plugin files. This update, Geas_Combat_Formatter_5 was updated. Available from ... n1DJa?dl=0
5 November 2019 - The VI version had a malfunctioning preferences file that meant it didn't auto install the plugins properly. This is now fixed in the download link. Apoligies to anyone who was put off by this issue.
Last edited by Israfel on Tue Nov 05, 2019 2:08 am, edited 2 times in total.

Posts: 1
Joined: Sat Apr 17, 2010 1:04 am

Re: Geas Custom MUSHclient Package

#3 Post by Tresnog » Mon Oct 07, 2019 12:52 am

Just wanted to drop a quick reply to say thanks for putting this together. I've been using this since I got back into Geas recently and it's made the experience much more enjoyable. :)

Posts: 376
Joined: Tue Aug 09, 2005 3:16 am
Location: Norway

Re: Geas Custom MUSHclient Package

#4 Post by ferranifer » Fri Oct 18, 2019 7:21 am

This is ridiculously awesome! Thank you so much for building it!

Post Reply