Gammon Forum

I am pleased to release version 4.48 of MUSHclient. See the release notes for more details.

Improvements

• Added color.lua module for working in HSL colour space.
• Rewrote telnet subnegotiation as described in some length in the forum post Suggested protocol for server to client "out of band" messages.
• Added script functions OnPluginTelnetRequest and OnPluginTelnetSubnegotiation to handle telnet subnegotiations. See the release notes for more documentation.

Warning - the changes made in this version are fairly major, in the area of handling telnet negotiations. They have been tested, however they may possibly incorrectly handle MCCP, MCP, IAC GA, IAC EOR, IAC IAC, character set negotiation, NAWS, SGA, terminal type negotiation, chat system, colour codes. This version is intended to be tested by plugin authors, particularly those interested in writing plugins that use telnet negotiation, such as ATCP (Achaea), ZMP, and Aardwolf plugins. If you are not interested in such plugins, please do not install this version, in case something goes wrong. Please report problems on the forum as a new bug report, or to the thread mentioned above.

Download

You can view the release notes for version 4.48

You are strongly advised to backup (make a copy of) your existing MUSHclient world files before upgrading. Just in case.

If there are any problems, please post messages to the Bug Reports, Suggestions, or General parts of this forum.

If you do an md5sum on mushclient448.exe you should get this result:

2cc7b0f32088d8275a70650dd502e25d

The forum post a small script to sumcheck the MUSHclient download shows how you can write a small script in MUSHclient to do the sumcheck. It also lists some places you can download md5sum.exe to do the sumcheck (if this is the first time you have downloaded MUSHclient).

One way of doing an md5sum is to download the Installer_sumcheck plugin from the Plugins page (RH click that link and "save link as" to get the plugin). Then install the plugin (see the File menu -> Plugins) and type "md5sum" which lets you browse to the installer file, load it, and display the sumcheck.

Message about "Failed to load resources file"

Some users are reporting getting a message like " Failed to load resources file: C:\Programme\MUSHclient\locale\DE.dll - trying English file" when starting MUSHclient (the DE.dll part might be another language like FR.dll).

This will be because you have customized the "locale" of MUSHclient to other than EN (English). See the How to localize MUSHclient messages into other languages forum posting for more details about localization.

To fix this, find the directory you installed MUSHclient into (eg. "C:\Program Files\MUSHclient\") and then locate the subdirectory "locale". In that you will find a file en.dll. Copy or rename that file to match the missing file in the message (eg. copy en.dll to de.dll).

Alternative suggestion: Go into the File menu -> Global Preferences -> General, and change the field "Locale code" back to "EN" (English) and then it should look for EN.DLL next time.

Warning about Lua 5.1 upgrade

MUSHclient version 3.80 upgraded the Lua script engine from Lua 5.0.2 to 5.1.1. If you are upgrading to this version from an earlier version than 3.80, you should read Version 3.80 released - with Lua 5.1 script engine - this post has recommendations about what is required if you use Lua scripting or Lua plugins. Note: Since version 3.80 was released, the version of Lua has been upgraded. It is currently 5.1.4.

Warning about upgrading from versions prior to 3.21

MUSHclient version 3.85 (onwards) no longer reads the old "binary" world files produced by versions prior to 3.21. For more information about this please read the forum post Versions 3.85 onwards no longer support world files created prior to version 3.21 - this post has recommendations about how to upgrade your world files if you are upgrading from a version earlier than 3.21.

Note that version 3.21 was released about 5 years ago, so people who have recently installed MUSHclient should not have any problems.

Source code

The source code for this version is available from GitHub:

http://github.com/nickgammon/mushclient/tree/v4.48

You can directly download the source from the Downloads page (http://github.com/nickgammon/mushclient/downloads), or preferably install Git and use the appropriate commands to clone or pull the source. For some suggestions about getting the source from Git see MUSHclient source being made available on GitHub forum posting.

If you install Git, subsequent downloads (of new versions) will be much faster as it only needs to download the changes, not the whole source. Also by using Git you can find out exactly what has changed from version to the next.

Summary of changes in this version

$ git diff v4.47..v4.48 --stat
 MUSHclient.cpp              |   26 +--
 MUSHclient.dsp              |   38 ++--
 MUSHclient.h                |    8 -
 MUSHclient.rc               |    8 +-
 OtherTypes.h                |   10 +-
 TextView.cpp                |   12 +-
 chatsock.cpp                |   10 +-
 doc.cpp                     |  135 ++++----
 doc.h                       |   58 ++--
 doc_construct.cpp           |    6 +-
 docs/Lua Colors LICENSE.txt |   22 ++
 install/mushclient.nsi      |    8 +-
 install/readme.txt          |    4 +-
 lua/colors.lua              |  270 ++++++++++++++++
 lua_helpers.h               |    9 +-
 mushview.cpp                |    2 +-
 plugins.cpp                 |   28 ++-
 scripting/bits.c            |    9 +-
 scripting/lrexlib.c         |    9 +-
 scripting/lua_compress.c    |    9 +-
 scripting/lua_scripting.cpp |   14 +-
 scripting/methods.cpp       |   10 +-
 scripting/scripting.h       |   12 +-
 stdafx.h                    |    2 +
 telnet_phases.cpp           |  750 ++++++++++++++++++++++++++-----------------
 xml/xml_load_world.cpp      |    4 +
 26 files changed, 937 insertions(+), 536 deletions(-)