Difference between revisions of "DiscworldUI"

From Mudlet
Jump to navigation Jump to search
m (→‎Discworld MUD: Fixed grammatical error)
(Added new version 0.1.1. Made minor edits to setup instructions.)
Line 5: Line 5:
 
For(MUD): [http://discworld.starturtle.net Discworld]
 
For(MUD): [http://discworld.starturtle.net Discworld]
  
Size: 4.6 kiB
+
Size: 4.7 KiB
  
 
Version: 0.1
 
Version: 0.1
Line 12: Line 12:
  
 
== Known Issue ==
 
== Known Issue ==
Current version of the coloured map hack is printed upside down. Will be fixed ASAP
+
*Map colour hack is unstable due to it's hackish nature. Therefore it is disabled by default.
  
 
==Files==
 
==Files==
Package: [[File:Discworld-mud-ui-0-1.mpackage]]
+
===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==
 
==Summary/Description==
Line 37: Line 39:
 
*Disable XP/hour bar if you don't like it.
 
*Disable XP/hour bar if you don't like it.
 
*Customisable Style
 
*Customisable Style
==Instructions==
+
==Installation instructions==
#Enable GMCP in Mudlet settings
+
#Download the package and save it to your file-system.
#Install package. Do NOT import, that only works for XML files
+
#Load the profile you use to connect to the Discworld. (Unless you are already connected).
#Connect to Discworld MUD. If you were already connected relogon using "su" (Switch User)
+
#Enable GMCP in Mudlet settings.
#GUI should be fully initialised after the second command.
+
#Install the package trough the Mudlet package manager. Do NOT import from the script interface, that only works for XML files.
#Open Scripts and edit the variables in Discworld-MapUI and Discworld-StatusUI to your liking.
+
#Connect to the Discworld MUD. If you were already connected, re-login to the MUD by sending:
 +
su
 +
#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.)
 +
#Make sure you've told the MUD to send you map data. To do this send:
 +
options output map frame = on
 +
#Configure the Discworld MUD map options to your liking. (Recommended settings below)
 +
#[OPTIONAL] Open the Mudlet Scripts interface and customise the variables in Discworld-MapUI and Discworld-StatusUI to your liking.
  
 
==Recommended Discworld MUD settings==
 
==Recommended Discworld MUD settings==
 
  options output map:
 
  options output map:
   frame            = on  Note: Is required allows for gmcp.Window.Frame.map
+
   frame            = on  Note: Is required, configures server to send gmcp.Window.Frame.map
 
   glance            = off
 
   glance            = off
 
   glancecity        = off
 
   glancecity        = off
 
   look              = off
 
   look              = off
 
   lookcity          = off
 
   lookcity          = off
  mxp              = off Note: May causes issues if set to on.
 
  
 
==Acknowledgements==
 
==Acknowledgements==

Revision as of 12:52, 26 January 2013

Package Info

By: Ghostbird

Discworld-ui.png

For(MUD): Discworld

Size: 4.7 KiB

Version: 0.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.

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:
su
  1. 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.)
  2. Make sure you've told the MUD to send you map data. To do this send:
options output map frame = on
  1. Configure the Discworld MUD map options to your liking. (Recommended settings below)
  2. [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. 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: Thought up the coloured map hack.

Contact

If you have any questions, send me an email.