DiscworldUI

From Mudlet
Revision as of 14:05, 26 January 2013 by Ghostbird (talk | contribs) (Added known issue on bad lua scoping in the scripts.)
Jump to navigation Jump to search
"Image of Mudlet with the Discworld UI active."
Discworld UI v0.1 top aligned. Showing the upside down coloured map bug that was fixed in version 0.1.1 and upwards

Package Info

By: Ghostbird

For(MUD): Discworld

Size: 4.7 KiB

Version: 0.1.1

Contents: discworld-ui.xml, config.lua

Known Issue

  • Map colour hack is unstable due to it's hackish nature. Therefore it is disabled by default.
  • I have (almost) no prior Lua experience and have not learned lua's scope mechanisms. The entire thing runs on horrible global variables and functions. This may cause issues if you load packages that use the same variable names.

Files

Current version

Version 0.1.1: File:Discworld-mud-ui-0-1-1.mpackage

Older versions

Version 0.1: File:Discworld-mud-ui-0-1.mpackage

Summary/Description

This package adds GMCP powered status bars and a GMCP powered separate map window to the MUDlet client. This way you can keep an eye on your status and your location without having to read between the lines. No longer will your combat monitor clutter up your entire screen.

Configuration can be done almost entirely by changing the global variable names in the scripts. Take your time to read the comments so you know what you're changing. Requires GMCP enabled in Mudlet settings. Sets up GMCP session settings for client upon login to the DiscWorld.

Features

  • Five status bars on the right hand side
  • HP, GP, XP, XP/hour, Burden.
  • Separate map
  • Automatic GMCP handshake with Disworld MUD server upon login.
  • Configurable top or bottom alignment.
  • Map automatically snaps to status bars, can be disabled if desired.
  • Status bars update on every command you send and when the MUD sends a status update.
  • Map updates on location change, look, glance.
  • Disable XP/hour bar if you don't like it.
  • Customisable Style

Installation instructions

  1. Download the package and save it to your file-system.
  2. Load the profile you use to connect to the Discworld. (Unless you are already connected).
  3. Enable GMCP in Mudlet settings.
  4. Install the package trough the Mudlet package manager. Do NOT import from the script interface, that only works for XML files.
  5. Connect to the Discworld MUD. If you were already connected, re-login to the MUD by sending:
  6. su
  7. Make sure you've told the MUD to send you map data. To do this send:
  8. options output map frame = on
  9. Interface is fully initialised once the second gmcp.Char.Vitals is received. (For every command you send to the mud after login you receive updated gmcp.Char.Vitals data.)
  10. Configure the Discworld MUD map options to your liking. (Recommended settings below)
  11. [OPTIONAL] Open the Mudlet Scripts interface and customise the variables in Discworld-MapUI and Discworld-StatusUI to your liking.

Recommended Discworld MUD settings

options output map:
  frame             = on  Note: Is required, configures server to send gmcp.Window.Frame.map
  glance            = off
  glancecity        = off
  look              = off
  lookcity          = off

Acknowledgements

Discworld MUD

  • Pit Veridicus: Helped by reporting server-side GMCP status of the connection. He explained that Mudlet doesn't support ANSI sequences in strings sent over GMCP and right away implemented a fix that escapes ANSI sequences if the GMCP client reports it is "mudlet". Without this, the coloured map would not have been possible.

Mudlet IRC

  • Demmonic: Helped explain the documentation of Mudled and Geyser and why the Wiki is more up to date than the LuaDoc.
  • _heiko (Heiko Köhn): Thought up the coloured map hack.

Contact

If you have any questions, send me an email.