Skip to content

Lich and Mudlet for playing Gemstone Dragonrealms with a screen reader

Jump to bottom
Mahtra edited this page May 5, 2024 · 8 revisions

Mudlet is an open source MUD Client, with excellent screen reader support.

Lich is a scripting engine for Simutronics based games. It is compatible with Dragonrealms, and Gemstone, and provides a robust scripting engine for both games, and for our purposes, it works as an authentication layer, since Mudlet can't authenticate directly to Simutronics games.

When we combine Lich, and Mudlet, we have an excellent platform for someone to play Gemstone, or Dragonrealms with the help of a screen reader.

Note: The help of a sighted person is required one time for the initial installation and configuration of Lich. They will need to input your username and password into the Lich launcher one time.

  1. Download and install Mudlet
  2. Download and install Lich as documented

Simutronics games are XML based, and Mudlet isn't an XML enabled client. As such, we need to squelch raw XML output from the game. For this we create a trigger to hide the XML feed from our screen reader.

  • Add trigger
  • Name: Squelch Strings
  • Under 1. Add .+ and select Perl Regex
  • Where is says Add your Lua code here add the following two lines
selectString(">", 1)
replace("")

After going through the first-time Lich setup, and saving your login info, you can launch lich from the command line by going to your lich folder, Shift+Right-Click, Open PowerShell Window here, and in the newly opened window type:

.\lich.rbw --login YourCharacterNameYouSavedTheLoginToEarlier --without-frontend --detachable-client=8000

Note: This process can be drastically simplified by creating a bat file to automate it. Simply create a file named CharacterName.bat (name it for your character) and inside put the following:

@echo off
cd c:\ruby4lich5\lich5
start lich.rbw --login YourCharacterNameYouSavedTheLoginToEarlier --without-frontend --detachable-client=8000

Please make sure to replace YourCharacterNameYouSavedTheLoginToEarlier with your actual character name!

In Mudlet, create a profile for, and connect to localhost port 8000

Clone this wiki locally