First Time Setup

Before proceeding to install Lich, please ensure you have a working method to get into the game. Be it Genie, Frostbite, Wrayth or whatever your FE of choice may be, please do not proceed to use Lich prior to being able to get in game using your client without Lich.

New installs on Windows

If you're planning to use Wrayth, please make sure to install the Simutronics Launcher and login to the game using Wrayth at least once before proceeding.

If you need help with these instructions, please see us on the lich Discord, in the #install channel.

1. Steps for new installs using Wrayth (formerly known as Stormfront)

• download Ruby4Lich5.exe from github
• Run the installer you just downloaded (a new lich5 folder should be placed on your desktop by the installer) (do not change any paths in the installer)
• Move your lich5 folder from your desktop.
  • Cut your folder, then Navigate to c:\ruby4lich5\ and paste your lich5 folder.
• Log into DR using the lich launcher (double click the lich.rbw in the lich5 folder, should pop up for you to input your account info. You can make a shortcut to lich.rbw on your desktop if you want.)
  • In the popup window, Choose your desired client (if you're using genie/frostbite/profanity, it doesn't matter wiz or wrayth.) and make sure you tick "Save this info for quick game entry"
  • If you're using wrayth/wizard, your FE should launch when you click Play, and several automated steps will happen the first time to install DR scripts.
  • The install process is very wordy. It will go through some steps to install DR Scripts, after which it will download maps. This step takes a few minutes, and here is a log of what this step looks like in case there is doubt.
  • After the maps are downloaded, and the alias service starts (this is the very last line of the install process, see log above) you should update lich (this step will be deprecated when the Windows installer is updated) by running ;lich5-update --update a log of which can be found here.
  • When this step finishes it will urge you to exit the game, and launch lich anew. When you've logged out, and back in, follow on...

2. When the above is all done... consider the following

• ;jinx install script lnet --repo=elanthia-online Will install the lnet script, which allows you to use ;chat in game
  • ;autostart add lnet Will add lnet to that character's autostart list
  • ;autostart add --global lnet Will add lnet to all character's autostart lists
  • ;lnet will start the script as a one-off.
  • Log of installing lnet, and using it.
• ;setupaliases this will set up common commands that you can use, such as typing map to bring up narost, and cc to check your circle requirements
• If you are just coming back from a long time away, make sure monsterbold is set. run SET MONSTERBOLD
• We have some sample config files in Samples. They're named by class, and some folks have kindly shared the yamls they use. Use named yamls with care. The Samples are very good... They are intended to be reference material, not copy/paste and things will run perfectly.

3. You might want to add some scripts you download to run automatically when you log in:
   • ;e autostart('script-name') will start it for all of your characters
   • ;e autostart('script-name', false) will start it for only this character
   • ;e echo(list_autostarts) will show you the files being autostarted on a given character
   • ;e stop_autostart('script-name') will remove an autostarted file from the list
   • ;e autostart(['textsubs', 'roomnumbers']) to add many scripts at once. This one is highly recommended for every person to run.
   • Detailed autostart documentation
4. Type ;links to see links to other helpful resources, including this guide.

• If you're migrating from Lich 4 click here
• OSX instructions
• If you're a genie user...
• If you want to use Frostbite...