Lich:Software

The official GemStone IV encyclopedia.
Revision as of 15:59, 12 February 2011 by WHIGHTCNIGHT (talk | contribs) (→‎F.A.Q.)
Jump to navigation Jump to search

About

The Lich is third-party software that expands on both The Wizard and StormFront, allowing players to script using the Ruby Programming Language, a high-level programming language with almost limitless capability. The program comes bundled with several scripts, such as scripts that calculate a character's redux, move from any location to another within a database, walk through an area until a creature is found, and spell up a character using all available spells. Also, there is a repository that allows for the quick, easy downloading of user-made scripts through The Lich, itself. Scripts can range from being very simple to quite advanced; for example, there is a script, titled xpSF, that modifies the experience window in StormFront to display additional information about the character's experience level that updates itself when experience is gained.

The Lich is written to be compatible with other third-party software, such as PsiNet and Black Lightning.

Installation

All the following instructions are pulled from Tillmen's Lich update website. Please visit his site for the latest downloads and instructions on how to install Lich.

Windows

Windows + Stormfront/WizardFE + Lich

  1. Download and install the Simutronics Launcher if it is not already installed.
  2. Download and install Ruby 1.8.6.
  3. Download and extract lich-4.2.7.zip.
  4. Double-click on lich.rbw
  5. Log in using Lich's game entry.

Optional:

  1. Download and install the Simutronics Game Entry if it is not already installed.
  2. Double-click on lich.rbw
  3. Click on the install tab.
  4. Click the install button.
  5. Log in use the Simutronics Game Entry.

Windows + Stormfront + Lich + PsiNet

  1. Uninstall PsiNet if it is installed.
  2. Download and install the Simutronics Launcher even if it's already installed. This will help clean up the typical case of PsiNet not uninstalling completely.
  3. Download and install the Simutronics Game Entry if it is not already installed.
  4. Download and install Ruby 1.8.6.
  5. Download and extract lich-4.2.7.zip.
  6. Double-click on lich.rbw
  7. Click on the install tab.
  8. Make sure the "Use PsiNet compatible install method" is checked.
  9. Click the install button.
  10. Install PsiNet.
  11. Log in using the Simutronics Game Entry.

Windows + WizardFE + Lich + PsiNet

  1. Uninstall PsiNet if it is installed.
  2. Download and install the Simutronics Launcher even if it's already installed. This will help clean up the typical case of PsiNet not uninstalling completely.
  3. Download and install the Simutronics Game Entry if it is not already installed.
  4. Download and install Ruby 1.8.6.
  5. Download and extract lich-4.2.7.zip.
  6. Double-click on lich.rbw
  7. Click on the install tab.
  8. Make sure the "Use PsiNet compatible install method" is checked.
  9. Click the install button.
  10. Put a file named fakestormfront.txt in your Lich directory. (The directory containing lich.rbw)
  11. Install PsiNet.
  12. Log in using the Simutronics Game Entry and select Stormfront as your frontend. (Yes, select Stromfront even though you want to use the WizardFE. We have to trick PsiNet into connecting to the right server.)

Linux

Ubuntu + Stormfront/WizardFE + Lich

Download and install the Simutronics Launcher using WINE if it is not already installed.

The ruby-gtk bindings in the Ubuntu repository don't work with Lich for some reason, so you'll have to compile them yourself. It's pretty simple, just open a terminal and enter the commands below. Some of the commands will prompt you for something or other.

(update: Compiling the ruby-gtk bindings yourself may not be needed anymore. If you try the ruby-gtk bindings from the Ubuntu repositoy, let me know if it works or not. Also, check to see if your processor is stuck at 100% while using them.)

Mac

Mac + Avalon + Lich

  1. You may need to install Xcode in order to use MacPorts. You can find the Xcode install package in the "Optional Installs" folder on your OS X Install DVD.
  2. Follow part 1 and Part 2 of this guide to install MacPorts.
  3. Open a terminal and type the following to install Ruby with GTK bindings:

sudo port install rb-gnome

  1. Download and extract lich-4.2.7.zip.
  2. Run Lich using one of these commands:
    1. sudo ruby lich.rbw --gemstone --avalon
    2. sudo ruby lich.rbw --gemstone --platinum --avalon
    3. sudo ruby lich.rbw --shattered --avalon
  3. Log in using Avalon. (After starting Lich, you have two minutes to log in before it times out.)

Note: Avalon needs an update to connect to Shattered. If Simu hasn't done it by the time you read this, here's how to do it yourself (as posted by Naos):

  1. Quit any instances of Avalon you have launched. You will need to update all copies that you may have downloaded or created.
  2. Locate your Avalon.app application bundle using Finder -- I expect it lives in most people's Applications folder.
  3. Select the application bundle in Finder, Control-Click (or Right-Click) on the icon, and select Show Package Contents from the context menu. (If you don't see this option in the context menu, you can try clicking on the toolbar button with a gear icon, which should give you a similar menu with the option.)
  4. Open the Contents folder. Open the Resources folder. You should see a list of file including "Custom Games.plist" -- this is the file of interest.
  5. Open the Text Edit application. It should be located in your Applications folder.
  6. Drag the "Custom Games.plist" file onto the dock icon for Text Edit -- this will open the file using Text Edit.
  7. The file is a plain text file that stores a list of games to display in an XML format. You will be adding two lines to this file.
  8. Find the following two lines:
<string>GS3</string>
<string>GS4D</string>
  1. You want to insert a line between these two so that your file looks like this:
<string>GS3</string>
<string>GSF</string>
<string>GS4D</string>
  1. Find the following two lines:
<string>GemStone IV</string>
<string>GemStone IV Development</string>
  1. You want to insert a line between these two so that your file looks like this:
<string>GemStone IV</string>
<string>GemStone IV Shattered</string>
<string>GemStone IV Development</string>
  1. Save the file. You're done!
  2. If you have multiple copies of Avalon that you are updating, you can copy the file you just modified and replace the unmodified version in your other copies of Avalon. Just follow steps 2-4 to find the files.

F.A.Q.

Q: Where did my inventory windows go?

A: If you use inventory windows in Stormfront, you’ll find they have disappeared the first time you run Lich on each character. Lich hijacks the setting to provide container contents to scripts. In doing so, it’s unable to tell what the setting was to start with, so it turns it off (from Stormfront’s point of view). Just type “set inv on” to turn it back on.

Reference

Third-Party Software - edit
Lich Installation: Lich
Downloadable Lich Scripts: Go2 | Map | Repository | Popular Scripts