Talk:Lich:Software/Installation

The official GemStone IV encyclopedia.
< Talk:Lich:Software
Jump to navigation Jump to search

Prior installation guide for Lich with GTK2 and Ruby 2.5.5

Install Guide for Lich Version 4.6.58 (as of January 5th, 2021)

  1. Uninstall ALL existing Ruby installations. This includes deleting all existing Ruby folders (they should be located in the root C:\ drive folder).
  2. Run the installer created by Doug ( http://bit.ly/WinLich ). Do NOT change the install drive to be different than C: drive. Do NOT restart the computer if prompted (just cancel that message). The install will seem like it isn't doing anything when there's a black box on the screen, but just give it some time. When the installer window itself goes away it's done.
  3. A Lich folder will be placed on your desktop after the install is finished, open that folder and run the lich.rbw file contained inside to start Lich's launcher.
  4. Log in and do -> ;repo download-lich <- when command completes exit the game. This is required for things to work proper.
  5. Log in and do -> ;repo download repository <- and wait the few seconds for it to finish. This is required for the repository to work proper.
  6. Do -> ;repo download-mapdb <- and wait the few seconds for it to finish. This is required for map related components to work proper.
  7. Do -> ;repo download jinx <- and wait the few seconds for it to finish. This is an alternative, maintained by Elanthia Online, to the Lich repository to facilitate downloading/updating scripts when the repository is offline.
  8. Do -> ;jinx script update infomon.lic <- and wait the few seconds for it to finish. After it's downloaded do -> ;repo unset-updatable infomon.lic <- to prevent Lich from replacing it with an outdated version. Finally, do -> ;kill infomon <- and then -> ;infomon <- to restart infomon. This version of infomon is maintained by Elanthia Online to allow quicker updating as the game changes.
  9. Do -> ;jinx data update spell-list.xml <- and wait the few seconds for it to finish. After it's downloaded do -> ;repo unset-updatable spell-list.xml <- to prevent Lich from replacing it with an outdated version. Finally, do -> ;e Spell.load <- to load the new data. This version of spell-list.xml is maintained by Elanthia Online to allow quicker updating as the game changes.
  10. Do -> ;jinx data update autostart.lic <- and wait the few seconds for it to finish. After it's downloaded do -> ;repo unset-updatable autostart.lic <- to prevent Lich from replacing it with an outdated version. This fixes an issue with the repository not checking for updates at startup. This may also introduce an unknown result with go2 and narost on a fresh install so just be aware.

PLEASE BE AWARE that Jinx currently does not have a way to auto update itself, or infomon and spell-list. This ability is on the list of features to be implemented at some point in the near future. As a result, be mindful of checking your versions from time to time or asking in the GemStone #scripting channel on Discord to see if there's been any significant updates recently.

Additional assistance in installation can be found in the scripting channel of the GemStone Discord.


Save deprecated instructions 11/14/2023


  1. Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.
  2. Download and Run the Ruby4Lich5.exe Installer. You will receive the Microsoft Warning because this is not distributed through the MS Store. Click on 'More Info' and then select the 'Run Anyway' button.
  3. The installation may take a few minutes, especially on non-SSD harddrives.
  4. A Lich5 folder will be placed on your desktop after the install is finished.
  5. Since you likely have a ton of information already saved in your previous lich folder, the fastest way to update to Lich5 is to open the Lich5 folder, open your existing lich folder, select ALL in your existing lich folder, and drag it over to the Lich5 folder. DO NOT OVERWRITE any files that already exist. If you do, your new Lich5 installation will not work. Always keep the existing Lich5 file when copying over your old information. You did back up your existing lich folder, right?
  6. Log in as you normally would. The Lich Quick Game Entry and Game Entry windows will look different, so don't be surprised. The Lich Quick Game Entry window should show your accounts in tabs on the left side, click through them to be sure your characters are all still listed under their tabs.

Special note to Profanity / Illthorn and other third-party FrontEnd users - this installer does not create an entry to the Environment Path variable. If you're using a third-party FrontEnd, be sure to add the Ruby4Lich5\bin directory to your path. See how here.

If you choose to not use the installer and want to live dangerously and try to install Ruby yourself, we recommend also installing the following gems: gem install tomlib ascii_charts concurrent-ruby ftools gtk3 json jwt mechanize nokogiri redis sequel sqlite3 terminal-table tzinfo webrick xmpp4r