GemStone IV Wiki - User contributions [en]

Lich:Software/Mac Installation

2026-01-13T13:30:27Z

DOUG: Update gems

{{3rd-party}}
To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install gobject-introspection</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>
# <code>brew install openssl@3</code>
# <code>brew upgrade ca-certificates</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 4.0.0</code>
# <code>rbenv global 4.0.0</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 4.0.0 (2025-12-25 revision 553f1675f3) +PRISM [arm64-darwin25]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin22]</code>
seek assistance (restarting the terminal you used to run commands up to this point may be required for `ruby -v` to show the proper, updated version of ruby).

The key is the ruby 4.0.0 part -> it needs to read 4.0.0

If your version reflects 4.0.0, proceed to the next steps. Enter this command and press ENTER. Wait for the system to finish before moving on to the next.

<p><code>gem install ascii_charts concurrent-ruby curses ffi gtk3 jwt logger mechanize nokogiri os redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r --no-document</code></p>

Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

Don't care for Avalon as a front end? There's a new offering in town. Give this a look!

https://warlockfe.github.io/

Configuration for Mac (and other OS types) here:

https://github.com/sproctor/warlock3/wiki/Lich-support

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}

Lich:Software/Mac Installation

2026-01-13T13:28:09Z

DOUG: Update to Ruby 4.0

{{3rd-party}}
To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install gobject-introspection</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>
# <code>brew install openssl@3</code>
# <code>brew upgrade ca-certificates</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 4.0.0</code>
# <code>rbenv global 4.0.0</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 4.0.0 (2025-12-25 revision 553f1675f3) +PRISM [arm64-darwin25]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin22]</code>
seek assistance (restarting the terminal you used to run commands up to this point may be required for `ruby -v` to show the proper, updated version of ruby).

The key is the ruby 4.0.0 part -> it needs to read 4.0.0

If your version reflects 4.0.0, proceed to the next steps. Enter this command and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r --no-document</code>
Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

Don't care for Avalon as a front end? There's a new offering in town. Give this a look!

https://warlockfe.github.io/

Configuration for Mac (and other OS types) here:

https://github.com/sproctor/warlock3/wiki/Lich-support

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}

Lich:Software/Installation

2025-11-10T02:24:51Z

DOUG:

{{3rd-party}}
=About=

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Wrayth or Wizard FE. Lich is also used by many on both MacOS and multiple Linux distributions.

=Installing the Latest Stable Release=

'''The latest stable lich version is 5.12.12 supporting Ruby 3.4 - published November 9, 2025'''

==In-Place Upgrade==

If you are on an older version of Lich 5 and want to upgrade to the most current version, you can choose to either upgrade Lich5 only or both Lich 5 and Ruby. If you're currently on Lich 4, able to check by running the command <CODE>;e echo LICH_VERSION</CODE>, go to the [[#Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)|upgrade from Lich 4 section]].

For each section, please follow the directions/commands one at a time.

===Lich 5 Only===

====Lich 5.6.0 or newer====
# '''Backup existing Lich 5 folder'''
# Run this command in-game <CODE>;lich5-update --library=update.rb</CODE>
# Quit and restart lich.
# Run this command in-game <CODE>;lich5-update --update</CODE>
# Quit and restart lich.
# Congratulations - you're now running on the latest version of Lich!

====Lich 5.5 or older====
Does not work for Lich 4 upgrades, please do a full new install if on Lich 4.
# '''Backup existing Lich 5 folder'''
# Run this command in-game <CODE>;lich5-update --snapshot</CODE>
# Quit and close out of the game.
# Download the full release [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip lich-5.zip]
# Extract the zip file over your existing Lich5 installation, choosing to overwrite existing files.
# Restart lich.
# Congratulations - you're now running on the latest version of Lich!

===Both Ruby 3.4 & Lich 5===
This method is for Windows only. Linux and MacOS users, please do a Lich 5 only update and update Ruby manually via normal install/update methods for the OS.

# Logout of all characters
# '''Backup existing Lich 5 folder'''
# Uninstall existing Ruby4Lich5 installs from Programs & Features control panel, or alternatively, rename your existing Ruby4Lich5 folder to Ruby4Lich5save. (Defaults to C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer]
# Run the installer and be sure to have both Ruby and Lich 5 option selected
# Congratulations - you're now running on the latest version of Lich & Ruby!

===Ruby 3.4 Only===
Use this to upgrade to the newest version of Ruby only if you're already on the latest version of Lich5 and now want to update Ruby afterwards. If you're not already on the latest version of Lich5, please use previous section steps instead.
# Logout of all instances/characters
# '''Backup existing Lich 5 folder'''
# Uninstall your existing Ruby4Lich5 install via Programs & Features (ensure it's now gone, default location was C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer]
# Run the new installer and choose to only install Ruby Only
# Congratulations - you're now running on the latest version Ruby!

==Windows New Installation==

{{blue|These instructions are not for DragonRealms. [[#Ecosystem Information|For those scroll to the bottom]].}}

'''For Windows 11 / 10 / 8 / 7''' users: you can download the [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer] and install everything you need automatically. Click on the '''Ruby4Lich5.exe''' and download it to your computer then double click on the executable in your default download folder. Note, a user may need to adjust their browser or security settings to allow download and installation.
If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

===New Installation for Lich 5 (11/14/2023)===

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The Wrayth FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.

===Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)===

This option is deprecated. Lich 5 architectures are not compatible with Lich 4. Back up your existing Lich 4 folder, uninstall any existing Ruby executables, and then follow the instructions for a new install above.

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

==MacOS==
There two common options for playing Gemstone IV on a Mac is either to play natively with Avalon or to use virtualization software such as Parallels with Wrayth/WizardFE. Below are the options on how to do that.

===Native Avalon===
Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help. This process works well for Mac OS Catalina and Big Sur. If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Parallels Windows===
'''The following only pertains to Apple Silicon based Macs. If you have an Intel based Mac, you can use the normal Windows installation procedures instead.'''

To install Wrayth/WizardFE, Lich, and Ruby via Parallels you will need to do a few various steps as outlined below. Please note, the rubyw file in C:\Ruby4Lich5\X.X.X\bin may be set to run in compatibility mode for windows 7. On an ARM Mac running parallels, this causes Wrayth scripts not to run. Turning compatibility mode off in the rubyw file fixes this issue if it was enabled.

<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
The following steps are to be done AFTER you've successfully installed Wrayth/WizardFE and can login normally without Lich5 on the machine. Once you've done that and can successful connect normally, then follow these steps:
# Download and install [https://github.com/oneclick/rubyinstaller2/releases/download/RubyInstaller-3.4.3-1/rubyinstaller-devkit-3.4.3-1-x86.exe Ruby 3.4.3 x86 (32bit) Installer] and use default options presented during install
# Open a Command Prompt and issue the following command to install the necessary gems, this process will take awhile (at least 30 mins)<pre>gem install ascii_charts concurrent-ruby curses ftools gtk3 json jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r --no-document</pre>
# Download and extract the Lich5 latest [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip lich-5.zip] to somewhere you want it stored (usually desktop)
# Double click the lich.rbw file that is now located in the extracted Lich5 location you did above. Login and play as usual.
</div>

==Chromebook & Debian variants==
<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Wrayth).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential curl libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev git unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 3.4.4 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 3.4.5 -v
rbenv global 3.4.5
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r
</pre>

If you wish to use LNet with newer versions of Ruby, you'll need to downgrade the default version of REXML to be 3.3.1 or older due to Tillmen's LNet server not supporting the newer version currently:
<pre>
gem install rexml:'<3.3.2' && gem uninstall rexml:'>3.3.1'
</pre>

Install Lich and Profanity:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.
</div>

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora 38 & 39 use Ruby 3.2.2, while Fedora 40 uses Ruby 3.3.0. All of which are currently compatible with Lich 5.7.0 or higher.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison curl gcc gdbm gdbm-devel glib2-devel gobject-introspection-devel \
libyaml-devel libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
$ gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r
</pre>

4. Download Lich & Profanity:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>
</div>

=Popular Scripts=
{{#section:Lich:Script Repository|popularscripts}}

=Ecosystem Information=

* DragonRealms Variant - [https://elanthipedia.play.net/Lich_script_repository#Setup_and_Installation Setup and Install instructions]

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.12.12''' (current)
<PRE>
Bug Fixes (general)
Update module strip markdown comments (#1056)
Vars/UserVars module fixes and corrections (#1057)
Bug Fixes (gs)
Infomon parse fix for singular currency (#1051)
</PRE>
'''5.12.11'''
<PRE>
Bug Fixes (dr)
add bput match for system updates preventing actions (#1034)
drdefs.rb npc parsing (#1038)
Fix container reference in get_item_from_eddy_portal method (#1039)
Bug Fixes (gs)
bounty location regex needs to match "under" (#1037)
</PRE>
'''5.12.10'''
<PRE>
Bug Fixes
all: games.rb catch additional error for nested single/double quotes (#1031)
dr: change keys for DR_SKILLS_DATA[:guild_skill_aliases] to be strings instead of symbols (#1032)
gs: Bounty parser for SG npcs matching (#1027)
gs: match READY/STOW items with a/an/some inside the link (#1026)
</PRE>
'''5.12.9'''
<PRE>
Bug Fixes
gs: StowList/ReadyList reset bug if non-default keys added #1019
</PRE>
'''5.12.8'''
<PRE>
Bug Fixes
all: script.rb show custom at script exit as well (#993)
all: Updated update.rb for single trunk and release please (#1001)
</PRE>
'''5.12.7'''
<PRE>
fix(all): ensure updates do not target detached proxy views #990
fix(gs): bounty parser and move fixes for sailor's grief #987
fix(gs): Infomon xmlparser.rb Ready/Stow fix for LONG before exist #988
fix(gs): gameobj.rb for Sailor's Grief ghostly/boss/guild tentacles #989
</PRE>
'''5.12.6'''
<PRE>
fix(all): settings.rb update to preserve root of derived views #975
fix(all): show custom in various script output when custom script #967
fix(dr): drparser.rb update for PlayedSubscription #983
fix(gs): include store location for ReadyList #977
fix(gs): infomon parser.rb update for ACCOUNT output varies #979
fix(gs): global_defs.rb move def update for Hive traps #980
fix(gs): activespell.rb prevent removal of RF Penalty #981
fix(gs): add .compact to input of Disk.find_by_name #982
</PRE>
'''5.12.5'''
<PRE>
fix(all): update.rb word boundary for abbreviations #971
fix(dr): equipmanager.rb Fix for changed game output. #969
fix(dr): common-arcana.rb Regalia fix for changed game output. #970
fix(dr): common-items.rb Fix for changed inventory command output #973
fix(gs): StowList missing space in capture in xmlparser.rb #963
fix(gs): stowlist.rb wait for RT when issuing check #964
fix(gs): readylist.rb wait for RT when issuing check #965
fix(gs): Bounty heirloom return msg'ing update #972
</PRE>
'''5.12.4'''
<PRE>
build(all): installer.yml use windows-2022 #950
fix(all): restore Wrayth / Wizard script execution ability #952
fix(all): database_adapter.rb error handling improvement #956
fix(dr): common-items.rb wear/remove messaging additions #949
fix(dr): games.rb - ignore UIDs for Frostbite mapping #951
fix(dr): map_dr.rb prevent inadvertent settings changes #958
fix(gs): GameObj targets for new Sailor's Grief tentacle npc #948
fix(gs): map_gs.rb remove delete_if to prevent bad settings #957
fix(gs): weapon.rb assault break if no targets #962
</PRE>
'''5.12.3'''
<PRE>
fix(all): limitedarray.rb max_size increase #946
fix(all): uservars.rb update for vars method missing #940
fix(dr): drparser.rb to set ShowRoomID to on if turned off #945
fix(gs): change namespace accessors to Ruby 2.6 compatible #944
fix(gs): infomon state reset on status prompt #943
fix(gs): Societies to check membership for various methods #942
fix(gs): standardize warcry.rb to match other PSMS #941
</PRE>
'''5.12.2'''
<PRE>
fix(gs): infomon parser.rb for profile full name matching #938
fix(gs): force PROFILE FULL to sync CHE info for infomon #937
fix(dr): Tighten checks on releasing invisibility for thieves #936
</PRE>
'''5.12.1'''
<PRE>
- fix(all): gameobj.rb - add type? method for explicit type check #928
- fix(all): messaging.rb encoding issue #933
- fix(gs): Various CMan cost corrections #932
</PRE>
'''5.12.0'''
<PRE>
- feat(all): settings.rb - proposal for sequel based Settings #591, #875, #889, #896, #927
- feat(all): util.rb add Ruby gem install helper method #861
- feat(all): messaging.rb add cmd link method #866
- refactor(all): games.rb modernization #849, #882, #924
- fix(all): add class extensions #800
- fix(all): lich.rb deprecated FE message #852
- fix(all): messaging.rb fix XML encoding for wizard and avalon #853
- fix(all): lich.rb class variable not initialized #855
- fix(all): log.rb force msg to String for regexp comparison #856
- fix(all): global_defs.rb bug in fput #864
- fix(all): messaging.rb xml_encode mono method msg #868
- fix(all): script.rb class to is_a? checks #878
- fix(all): gameobj.rb deeper lookup #885
- fix(all): messaging.rb debug not compared to falseclass #887
- fix(all): change class to is_a? checks #91-3
- fix(all): Util.issue_command allow single line captures #918
- fix(dr): drparser.rb casing for Premium status check #842
- fix(dr): map_dr.rb Don't assign UID of zero to rooms #844
- fix(dr): drparser.rb add $last_logoff tracking #851
- fix(dr): update message patterns in common-items #859
- fix(dr): add moon_visible?(moon) convenience method to common-moonmage #860
- fix(dr): exp mods output is not enclosed in preset xml tags anymore #870
- fix(dr): update.rb beta send validation for genie lich char #880
- fix(dr): Update regex and parsing for active spells #894
- fix(dr): add 'You scoop' match pattern to common-items #900
- fix(dr): add missing match patterns #901
- fix(dr): common-items: add and fix match strings #904
- fix(dr): Add missing matches for common-items #905
- fix(dr): Release Khri Vanish if Thief, when going visible #906
- fix(dr): Fix race condition when clearing and repopulating XMLData.dr_active_spells #907
- fix(dr): Fix SLS release pattern #908
- fix(dr): resolve race condition in DR crafting_magic_routine #914
- fix(dr): xmlparser.rb - Fix XMLData.dr_active_spells race condition #915
- fix(dr): xmlparser.rb - Clear out spells properly #916
- fix(dr): drparser.rb update for Platinum account status #922
- feat(gs): gameobj.rb allow for custom gameobj data #848
- feat(gs): PSMS updates, including CMan.use #865, #874, #881, #890, #899
- feat(gs): ReadyList & StowList classes for item tracking #884
- feat(gs): Breakout and Buildout Societes #919
- fix(gs): infomon parsing for CHE membership #841
- fix(gs): map_gs.rb for no UID when hexdigest used #843
- fix(gs): warcry.rb yowlp :buff to string instead of regexp #847
- fix(gs): group.rb multiple corrections #850, #869, #883
- fix(gs): Bounty parser.rb fix for HW & KF guard return #862
- fix(gs): Bounty task.rb fix for assigned? and Ruby 2.6 #863
- fix(gs): stash.rb stale sheaths recheck #867
- fix(gs): allow spell.rb casting to take a force_stance parameter #902
- fix(gs): update Infomon parsing for new ACCOUNT output format #903
- fix(gs): PSMS cost for multiple cost types & add Excoriate feat #912
- fix(gs): Feat excoriate regex correction #920
- fix(gs): weapon PSM affordable check against Glorious Momentum #926
</PRE>
'''5.11.1'''
<PRE>
- fix(all): restore @theme_state and add to CLI capability #795
- fix(all): retire gtk2 monkey patch for gtk3 #823
- fix(all): games.rb XMLData.name wait till both not NIL and not EMPTY #826
- fix(all): standardize xmlparser game instance #827
- fix(all): games.rb fix multiple single and double quote in XML #832,836,837
- fix(dr): games.rb - optional hide Room Title display of Real IDs with FLAG on #782
- chore(dr): common-moonmage - refactor of peer_telescope #783
- fix(dr): move HMR load to common before for dragonrealms #784
- fix(dr): common-crafting.rb minor edit to add "You tuck" #787
- fix(dr): common-arcana.rb - remove unecessary pause from discern code #792
- fix(dr): drparser.rb Restore Premium status checking #834
- fix(gs): migrate PSMS.name_normal to Lich::Util.normalize_name #790,833
- fix(gs): add Char.che to know current character's CHE #791
- fix(gs): FEAT and Infomon module parsing of new Covert Art feats. #796
- fix(gs): add Currency.gemstone_dust and fix redsteel mark capture #797
- fix(gs): FEAT Covert Arts colon normalization and stamina costs #799
- fix(gs): escape dash in regex for HouseCHE #824
- fix(gs): disk.rb comparison helpers #828
- fix(gs): allow for Group.disks to show self disk in array #829
- fix(gs): feat.rb Covert Arts throw poison costs 15 stam #830
- fix(gs): add missing Feat.use ability #831
- fix(gs): multiple CritRanks updates #801-822
</PRE>
'''5.11.0'''
<PRE>
- [all] - chore: Namespace & File Path Updates #713
- [all] - [argv_options.rb] bugfix: correct darkmode to work via CLI #693
- [all] - [games.rb] feat: make show Room Exits of non-StringProc/Obvious Exits toggable for all games #699
- [all] - [games.rb] feat: toggleable display of StringProcs with clickable links #751
- [all] - [gui-manual-login.rb] fix: change label to Wrayth #720
- [all] - [gui-saved-login.rb] fix: update Stormfront label #721
- [all] - [update.rb] fix: purge old LIB folder prior to update release #729
- [all] - [util.rb] bugfix: allow issue_command to use fput or put #715
- [all] - [xmlparser.rb] feat: add XMLData.room_name attribute #685
- [all] - [main.rb] fix: create session file in regular connect method #733
- [all] - [init.rb] bugfix: error for Windows DISPLAY variable #735
- [all] - [main.rb] fix: Mudlet support #736
- [all] - [wine.rb] fix: add --no-wine CLI flag prevent WINE startup
- [all] - [init.rb] fix: add --no-gtk CLI flag prevent GTK3 gem load
- [dr] - [games.rb] feat: DRinfomon and common files as core lich libraries #686
- [dr] - [games.rb] chore: add DR requires here #690
- [dr] - [games.rb] fix: add Room# display for DR #697
- [dr] - [games.rb] bugfix: Genie FE real ID#s not supported, hide by default #728
- [dr] - [drdefs.rb] bugfix: fix for Shadow Servants #710
- [dr] - [map_dr.rb] fix: cleanup and support for UIDs #719
- [dr] - [xmldata.rb] bugfix: add support for DR Room IDs #716
- [dr] - [xmlparser.rb] feat: XMLData - adding dr_active_spells #691
- [gs] - [games.rb] bugfix: support for pre/post room name txt #683
- [gs] - [group.rb] chore: update to account for hold #701
- [gs] - [resource.rb] feat: add additional tracking of covert art charges #714
- [gs] - [spell.rb] bugfix: Spell.affordable? 515 release #687
- [gs] - [stash.rb] bugfix: sheath_bags when not found #694
- [gs] - [xmlparser.rb] bugfix: missing real ID in nav #684
- [gs] - [xmlparser.rb] bugfix: Claim module obvious hiding #717
- [gs] - [sk.rb] feat: Self-Knowledge functionality in core #748
</PRE>
'''5.10.4'''
<PRE>
-o- [GS4] - [xmlparser.rb] bugfix: Simu XML breaking change RoomID #679
</PRE>
'''5.10.3'''
<PRE>
-o- [GS4] - [crit_tables] fix: CritRanks regex fixes (multiple files and changes) #671
-o- [GS4] - [spellsong.rb] fix: Correct Spellsong sync method #674
-o- [GS4] - [parser.rb] fix: thorn status regex correction #673
-o- [All] - [xmlparser.rb] fix: Split out if elif block to account for DR having multiple… #670
-o- [All] - [global_defs.rb] fix: percentconcentration #676
-o- [All] - [global_defs.rb] fix: update move failure message to handle attack and casting #667
-o- [All] - [init.rb] fix: update required ruby check messaging #669
-o- [All] - [sessionvars.rb] feat: new module SessionVars for non-persistent variable storage #666
</PRE>
'''5.10.2'''
<PRE>
-o- [DR] - [games.rb] bugfix: tweak XML rewrite section #662
-o- [GS4] - [crit_tables] bugfix: additional crit table regex corrections #663
-o- [GS4] - [ascension.rb] bugfix: add new Transcend Destiny to lookups #661
-o- [GS4] - [effects.rb] bugfix: regexp escape txt #660
-o- [GS4] - [disruption_critical_table.rb] Bugfix in regex #659
</PRE>
'''5.10.1'''
<PRE>
-o- [All] - [games.rb] bugfix: prevent race condition in games thread #656
-o- [All] - [init.rb] bugfix: address WINE variance between linux / installs #655
-o- [GS4] - [gs][stash.rb] bugfix: wear code improvement #657
</PRE>
'''5.10.0'''
<PRE>
-o- [All] - [main.rb] bugfix: correct encoding for WizardFE PR #640
-o- [All] - [games.rb] bugfix: correct logic for room detection when using CLI --start-scripts PR #639
-o- [All] - [DB_Store.rb] feat: add direct support for Simu RENAME and CHANGE PROF PR #633
-o- [All] - chore: breakout code to individual files for easier management PR #617
-o- [All] - [lich.rbw] chore: add deprecated msg to old Settings/GameSettings/CharSettings methods PR #589
-o- [All] - [lich.rbw] feat: add new --dark-mode CLI option PR #583
-o- [All] - [global_defs.rb] bugfix: monsterbold fix for additional clients PR #581
-o- [All] - [update.rb] feat: update core scripts from source on Lich5 update/install PR #579
-o- [All] - [log.rb] feat: add new Log module copied from Olib PR #577
-o- [All] - [numeric.rb] feat: add days/hours/minutes/seconds methods to numerics PR #623
-o- [All] - [messaging.rb] feat: WizardFE Voln window support #647
-o- [All] - [init.rb] bugfix: WINE entries for Linux / MacOS #649
-o- [DR] - [lich.rbw] bugfix: cleanup downstream hook exclusions PR #593
-o- [DR] - [global_defs.rb] bugfix: missing climb failure message PR #592
-o- [GS4] - [effects.rb] bugfix: show non-standard Effects in `;magic` output PR #641
-o- [GS4] - [parser.rb] bugfix: fix WARCRY duplication results / add WALL OF THORNS effect detection PR #634 / PR #637
-o- [GS4] - [critranks.rb] feat: add critical rank resolution tables and methods PR #625
-o- [GS4] - [effects.rb] bugfix: to support regex for active? & time_left PR #590
-o- [GS4] - [infomon.rb] bugfix: add implicit NPC death monitoring PR #588
-o- [GS4] - [infomon.rb] bugfix: change PSM to be stored as type.mnemonic PR #587
-o- [GS4] - [lich.rbw] bugfix: strip_xml multiline fix PR #584
-o- [GS4] - [stash.rb] bugfix: fix sack detection to use Stash.container(param) PR #578
-o- [GS4] - [spell.rb] feat: Spell.after_stance #644
-o- [GS4] - [xmlparser.rb] bugfix: for Claim module #646
-o- [GS4] - [infomon] feat: track Voln favor via RESOURCE output #648
-o- [GS4] - [gameobj.rb] feat: add Bandit hidden target API #650
</PRE>
'''5.9.2'''
<PRE>
-o- [GS4] - [group.rb] bugfix: proper leader detection from GROUP output
-o- [GS4] - [char.rb] bugfix: add back depracted Char.maxvitals with msging to switch to new Char.max_vitals methods
</PRE>
'''5.9.1'''
<PRE>
-o- [GS4] - [group.rb] bugfix: group.check syntax change
-o- [GS4] - [spell.rb] bugfix: affordable? Char.mana parenthesis logic
</PRE>
'''5.9.0'''
<PRE>
-o- [All] - feat: sqlite3 gem syntax code cleanup PR#553
-o- [All] - [lich.rbw] bugfix: remove unused Setting, GameSetting, CharSetting PR#542
-o- [All] - [lich.rbw] bugfix: scrub login key from error message popups PR#548
-o- [All] - [messaging.rb] bugfix: color mismatch WizardFE white txt PR#554
-o- [All] - [lich.rb] feat: add new Lich.deprecated method to aid in deprecating older API calls PR#523
-o- [GS4] - [char.rb] feat: log method_missing calls PR#552
-o- [GS4] - [char.rb] feat: add missing global_def related methods PR#523
-o- [GS4] - [global_defs.rb] feat: deprecate various Char module methods PR#523
-o- [GS4] - [spellsong.rb] bugfix: cache spellsong duration calc PR#551
-o- [GS4] - [effects.rb] feat: Effects module breakout PR#549
-o- [GS4] - [group.rb][disk.rb] feat: Group & Disk class PR#532
-o- [GS4] - [activespell.rb] feat: add duration change messaging, off by default, see ;help for details PR#487
</PRE>
'''5.8.1'''
<PRE>
-o- [All] - [lich.rbw] feat: add Game:Character to debug log file ouput
-o- [All] - [init.rb] feat: add milliseconds to debug filename
-o- [GS4] - [lich.rbw] bugfix: reorder parsing of $SERVERSTRING to avoid certain conflicts
-o- [GS4] - [parser.rb] bugfix: update for new Empath resource and sleep/bind messaging
-o- [GS4] - [status.rb] bugfix: bound? calmed? and sleeping? support for spellnames flag being off
-o- [GS4] - [xmlparser.rb] bugfix: additional creature dying messaging to check against XML dead not being sent
-o- [GS4] - [gameobj.rb] bugfix: remove sorcerer arms and animates from GameObj.targets
</PRE>
'''5.8.0'''
<PRE>
-o- [All] - Ruby 3.3 compatibility
-o- [All] - [lich.rbw] feat: adds .sources for up/downstream hooks
-o- [All] - [lich.rbw] bugfix: don't use WINE for custom frontends
-o- [GS4] - [char.rb] bugfix: add back Char.stance
-o- [GS4] - [claim.rb] feat: new module and associated changes to xmlparser
-o- [GS4] - [experience.rb] feat: percent experience options
-o- [GS4] - [parser.rb] bugfix: allow for negative TNL exp value
-o- [GS4] - [parser.rb] bugfix: allow hyphenated last names in character names
-o- [GS4] - [parser.rb] feat: update resource matching for new Bard service
-o- [GS4] - [stash.rb] bugfix: catch more shield removal messages
-o- [GS4] - [util.rb] bugfix: underscore issue for PSMs
</PRE>
'''5.7.0'''
<PRE>
-o- Supports Ruby 3.2 - security enhancements and huge speed improvements for regex
-o- New libraries/modules/classes: Account, HMR (Hot Module Reloading)
-o- GS4 Infomon now baked into Lich5 as a library, no more need to run standalone script
-o- New GS4 libraries/modules/classes: Ascension, Bounty, Currency, Experience, Resources, Society, Status, Warcry
-o- Updates to existing libraries/modules/classes: Armor, Util, Weapon, Spell, GameObj, Messaging
-o- Several Bugfixes for lots of things
-o- Lots of code cleanup
</PRE>
'''5.6.2'''
<PRE>
-o- Fix for XML errors
-o- Adds the DR Plat instance for Frostbite FE
-o- Adds ‘ball’ as the noun used for ‘ball and chain’
-o- Adds the movement result ‘slip in the mud and fall flat’
-o- Corrects stamina cost for the feature Dispel Magic
-o- Plus all the latest script updates from Elanthia-Online!
</PRE>
'''5.6.1'''
<PRE>
-o- Fix for XML to limit login errors (DR)
-o- Fix for XMLData.active_spells to properly register wizard 'recovery' spell cooldowns
-o- Messaging updates to remove error in Wizard FE encodings
-o- Corrects for error in detecting PSM skill changes (cman) via warrior / rogue guild lessons
-o- Deprecates LNet script from master repository
-o- Miscellaneous small bug squashing
</PRE>

'''5.6.0'''
<PRE>
-o- (DragonRealms) Support for Genie and Frostbite frontends
-o- (GemStone) Changed methods to improve ;go2 speed and reduce lich.db3 calls
-o- (GemStone) Updates to support silver_count function
-o- (Both) Changed method for updating lich ecosystem
</PRE>

'''5.5.0'''
<PRE>
-o- Support for DragonRealms
-o- Updated support for scripts like BigShot
-o- Providing the LichID and UID on Profanity
-o- Spell.force_incant, .force_channel, and .force_evoke
-o- Standardized message method for script authors
-o- Sundry small improvements / fixes and changes
-o- And the creme de la creme - a custom directory
</PRE>

'''5.4.0'''
<PRE>
-o- Simu Room IDs (formally called 'unique ID' or 'uid' for Lich) added to Map, mapDB where known, and ;go2 for navigation (courtesy Xanlin and with our thanks!) ;go2 u7120 for all you ex-GMs out there.
-o- Room titles will now display the Lich ID and / or the UID for the room based on user selections - default is on for both, and enabled / disabled via Lich.display_lichid or Lich.display_uid toggles that can be set to on / off or true / false. (;e Lich.display_lichid=true/false and ;e Lich.display_uid=true/false) You can remove that rnum from your autostart now! To gain the benefit of the UID deployment, be sure to ;repo download-mapdb
-o- REQUESTS: Drop 5 minute timeout function from Lich
-o- waitrt? and waitcastrt? will still pause activities, but will return TRUE or FALSE in keeping with the Ruby functionname? tradition (no more failing to get a weapon out due to RT from climbing!)
-o- empty_hands and fill_hands will now check to see if the character is in roundtime before trying to put away or retrieve held items
-o- Infomon received an update that keeps spell timers in sync with the information received from the server - no more need to immediately do a spell active in game to get the right times to display for various legacy scripts and ;magic after visiting the invoker or using an SK item
-o- Lich now provides a facility to get current coins on the character that is a bit more agnostic to data changes from Simu - Lich::Util.silver_count
-o- Various other small tidbits to help ease maintenance and future development
-o- PLEASE NOTE: This update is required for the newest Bigshot (released today!) and for future eloot and eherbs scripts (release RSN)
</PRE>

'''5.3.0'''
<PRE>
-o- Added support for Wrayth (renamed Stormfront) installations
-o- Converted Linux | WINE login methods to 'method 0', does not use Simu launcher
</PRE>

'''5.2.1'''
<PRE>
-o- Support for STOWing items irrespective of special item scripts
-o- Improved query support for Effects and CMans
-o- Fix Lich bug to respect the 'groupmovement' flag in game
-o- Fix Lich round time calculations (more aggressive timing)
-o- Dark Mode is now a thing
-o- Lich4 Style GUI layout available
-o- Several file location changes to support future code change efforts
</PRE>

'''5.0.19'''
<PRE>
-o- Benefit: Monks with Mental Acuity (all 3 of you) rejoice - stamina casting!
-o- Benefit: PSM3 included, no charge. No hair remaining, either!
-o- Benefit: Ok, stay seated: Some of your various SF spell duration windows may work. . . better? Yes, not perfect, but better. No pictures, please!
-o- Updated infomon that properly detects Cloak of Shadows on those pesky sorcerers, and the Raise Dead Cooldown periods for those wondrous clerics.
-o- A new update process for Lich 5 - tired of having to download that script over and over just to update? Get yourself a copy of lich5-update.lic. Note, if you already have it, you're set! If not - ;jinx script install lich5-update --repo=elanthia-online
</PRE>

'''5.0.11'''
<PRE>
-o- Updated the method used to log onto SIMU servers.
-o- Added the Animalist item specifics to Lich5's empty and fill hands routines
-o- Improved Invoker messages for Avalon and Wizard FEs (no change for SF FE)
-o- Improved cleanup and store methods when player EXIT's or QUIT's game
-o- Crafted two new methods (stash_hands and equip_hands) for future script use
-o- Some behind-the-scenes cleanup to improve maintaining the Lich5 ecosystem
-o- Add Spell Active improvements
-o- Add PSM and Ranger improvements
</PRE>
</div>

=Resources=
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:New Player]]

Lich:Software/Mac Installation

2025-08-14T00:50:15Z

DOUG: /* The Process */

{{3rd-party}}
To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install gobject-introspection</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 3.4.5</code>
# <code>rbenv global 3.4.5</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin22]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin22]</code>
seek assistance (restarting the terminal you used to run commands up to this point may be required for `ruby -v` to show the proper, updated version of ruby).

The key is the ruby 3.4.5 part -> it needs to read 3.4.5

'''3.4.5 is expected'''. If your version reflects 3.4.5, proceed to the next steps. Enter these commands, one at a time, and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r --no-document</code>
Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

Don't care for Avalon as a front end? There's a new offering in town. Give this a look!

https://warlockfe.github.io/

Configuration for Mac (and other OS types) here:

https://github.com/sproctor/warlock3/wiki/Lich-support

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}

Lich:Software/Installation

2025-08-14T00:42:30Z

DOUG: /* Installing the Latest Stable Release */

{{3rd-party}}
=About=

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Wrayth or Wizard FE. Lich is also used by many on both MacOS and multiple Linux distributions.

=Installing the Latest Stable Release=

'''The latest stable lich version is 5.12.4 supporting Ruby 3.4 - published August 13, 2025'''

==In-Place Upgrade==

If you are on an older version of Lich 5 and want to upgrade to the most current version, you can choose to either upgrade Lich5 only or both Lich 5 and Ruby. If you're currently on Lich 4, able to check by running the command <CODE>;e echo LICH_VERSION</CODE>, go to the [[#Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)|upgrade from Lich 4 section]].

For each section, please follow the directions/commands one at a time.

===Lich 5 Only===

====Lich 5.6.0 or newer====
# '''Backup existing Lich 5 folder'''
# Run this command in-game <CODE>;lich5-update --library=update.rb</CODE>
# Quit and restart lich.
# Run this command in-game <CODE>;lich5-update --update</CODE>
# Quit and restart lich.
# Congratulations - you're now running on the latest version of Lich!

====Lich 5.5 or older====
Does not work for Lich 4 upgrades, please do a full new install if on Lich 4.
# '''Backup existing Lich 5 folder'''
# Run this command in-game <CODE>;lich5-update --snapshot</CODE>
# Quit and close out of the game.
# Download the full release [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip lich-5.zip]
# Extract the zip file over your existing Lich5 installation, choosing to overwrite existing files.
# Restart lich.
# Congratulations - you're now running on the latest version of Lich!

===Both Ruby 3.4 & Lich 5===
This method is for Windows only. Linux and MacOS users, please do a Lich 5 only update and update Ruby manually via normal install/update methods for the OS.

# Logout of all characters
# '''Backup existing Lich 5 folder'''
# Uninstall existing Ruby4Lich5 installs from Programs & Features control panel, or alternatively, rename your existing Ruby4Lich5 folder to Ruby4Lich5save. (Defaults to C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer]
# Run the installer and be sure to have both Ruby and Lich 5 option selected
# Congratulations - you're now running on the latest version of Lich & Ruby!

===Ruby 3.4 Only===
Use this to upgrade to the newest version of Ruby only if you're already on the latest version of Lich5 and now want to update Ruby afterwards. If you're not already on the latest version of Lich5, please use previous section steps instead.
# Logout of all instances/characters
# '''Backup existing Lich 5 folder'''
# Uninstall your existing Ruby4Lich5 install via Programs & Features (ensure it's now gone, default location was C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer]
# Run the new installer and choose to only install Ruby Only
# Congratulations - you're now running on the latest version Ruby!

==Windows New Installation==

{{blue|These instructions are not for DragonRealms. [[#Ecosystem Information|For those scroll to the bottom]].}}

'''For Windows 11 / 10 / 8 / 7''' users: you can download the [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer] and install everything you need automatically. Click on the '''Ruby4Lich5.exe''' and download it to your computer then double click on the executable in your default download folder. Note, a user may need to adjust their browser or security settings to allow download and installation.
If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

===New Installation for Lich 5 (11/14/2023)===

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The Wrayth FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.

===Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)===

This option is deprecated. Lich 5 architectures are not compatible with Lich 4. Back up your existing Lich 4 folder, uninstall any existing Ruby executables, and then follow the instructions for a new install above.

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

==MacOS==
There two common options for playing Gemstone IV on a Mac is either to play natively with Avalon or to use virtualization software such as Parallels with Wrayth/WizardFE. Below are the options on how to do that.

===Native Avalon===
Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help. This process works well for Mac OS Catalina and Big Sur. If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Parallels Windows===
'''The following only pertains to Apple Silicon based Macs. If you have an Intel based Mac, you can use the normal Windows installation procedures instead.'''

To install Wrayth/WizardFE, Lich, and Ruby via Parallels you will need to do a few various steps as outlined below. Please note, the rubyw file in C:\Ruby4Lich5\X.X.X\bin may be set to run in compatibility mode for windows 7. On an ARM Mac running parallels, this causes Wrayth scripts not to run. Turning compatibility mode off in the rubyw file fixes this issue if it was enabled.

<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
The following steps are to be done AFTER you've successfully installed Wrayth/WizardFE and can login normally without Lich5 on the machine. Once you've done that and can successful connect normally, then follow these steps:
# Download and install [https://github.com/oneclick/rubyinstaller2/releases/download/RubyInstaller-3.4.3-1/rubyinstaller-devkit-3.4.3-1-x86.exe Ruby 3.4.3 x86 (32bit) Installer] and use default options presented during install
# Open a Command Prompt and issue the following command to install the necessary gems, this process will take awhile (at least 30 mins)<pre>gem install ascii_charts concurrent-ruby curses ftools gtk3 json jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r --no-document</pre>
# Download and extract the Lich5 latest [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip lich-5.zip] to somewhere you want it stored (usually desktop)
# Double click the lich.rbw file that is now located in the extracted Lich5 location you did above. Login and play as usual.
</div>

==Chromebook & Debian variants==
<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Wrayth).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential curl libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev git unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 3.4.4 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 3.4.4 -v
rbenv global 3.4.4
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r
</pre>

If you wish to use LNet with newer versions of Ruby, you'll need to downgrade the default version of REXML to be 3.3.1 or older due to Tillmen's LNet server not supporting the newer version currently:
<pre>
gem install rexml:'<3.3.2' && gem uninstall rexml:'>3.3.1'
</pre>

Install Lich and Profanity:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.
</div>

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora 38 & 39 use Ruby 3.2.2, while Fedora 40 uses Ruby 3.3.0. All of which are currently compatible with Lich 5.7.0 or higher.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison curl gcc gdbm gdbm-devel glib2-devel gobject-introspection-devel \
libyaml-devel libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
$ gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r
</pre>

4. Download Lich & Profanity:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>
</div>

=Popular Scripts=
{{#section:Lich:Script Repository|popularscripts}}

=Ecosystem Information=

* DragonRealms Variant - [https://elanthipedia.play.net/Lich_script_repository#Setup_and_Installation Setup and Install instructions]

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.12.3''' (current)
<PRE>
fix(all): limitedarray.rb max_size increase #946
fix(all): uservars.rb update for vars method missing #940
fix(dr): drparser.rb to set ShowRoomID to on if turned off #945
fix(gs): change namespace accessors to Ruby 2.6 compatible #944
fix(gs): infomon state reset on status prompt #943
fix(gs): Societies to check membership for various methods #942
fix(gs): standardize warcry.rb to match other PSMS #941
</PRE>
'''5.12.2'''
<PRE>
fix(gs): infomon parser.rb for profile full name matching #938
fix(gs): force PROFILE FULL to sync CHE info for infomon #937
fix(dr): Tighten checks on releasing invisibility for thieves #936
</PRE>
'''5.12.1'''
<PRE>
- fix(all): gameobj.rb - add type? method for explicit type check #928
- fix(all): messaging.rb encoding issue #933
- fix(gs): Various CMan cost corrections #932
</PRE>
'''5.12.0'''
<PRE>
- feat(all): settings.rb - proposal for sequel based Settings #591, #875, #889, #896, #927
- feat(all): util.rb add Ruby gem install helper method #861
- feat(all): messaging.rb add cmd link method #866
- refactor(all): games.rb modernization #849, #882, #924
- fix(all): add class extensions #800
- fix(all): lich.rb deprecated FE message #852
- fix(all): messaging.rb fix XML encoding for wizard and avalon #853
- fix(all): lich.rb class variable not initialized #855
- fix(all): log.rb force msg to String for regexp comparison #856
- fix(all): global_defs.rb bug in fput #864
- fix(all): messaging.rb xml_encode mono method msg #868
- fix(all): script.rb class to is_a? checks #878
- fix(all): gameobj.rb deeper lookup #885
- fix(all): messaging.rb debug not compared to falseclass #887
- fix(all): change class to is_a? checks #91-3
- fix(all): Util.issue_command allow single line captures #918
- fix(dr): drparser.rb casing for Premium status check #842
- fix(dr): map_dr.rb Don't assign UID of zero to rooms #844
- fix(dr): drparser.rb add $last_logoff tracking #851
- fix(dr): update message patterns in common-items #859
- fix(dr): add moon_visible?(moon) convenience method to common-moonmage #860
- fix(dr): exp mods output is not enclosed in preset xml tags anymore #870
- fix(dr): update.rb beta send validation for genie lich char #880
- fix(dr): Update regex and parsing for active spells #894
- fix(dr): add 'You scoop' match pattern to common-items #900
- fix(dr): add missing match patterns #901
- fix(dr): common-items: add and fix match strings #904
- fix(dr): Add missing matches for common-items #905
- fix(dr): Release Khri Vanish if Thief, when going visible #906
- fix(dr): Fix race condition when clearing and repopulating XMLData.dr_active_spells #907
- fix(dr): Fix SLS release pattern #908
- fix(dr): resolve race condition in DR crafting_magic_routine #914
- fix(dr): xmlparser.rb - Fix XMLData.dr_active_spells race condition #915
- fix(dr): xmlparser.rb - Clear out spells properly #916
- fix(dr): drparser.rb update for Platinum account status #922
- feat(gs): gameobj.rb allow for custom gameobj data #848
- feat(gs): PSMS updates, including CMan.use #865, #874, #881, #890, #899
- feat(gs): ReadyList & StowList classes for item tracking #884
- feat(gs): Breakout and Buildout Societes #919
- fix(gs): infomon parsing for CHE membership #841
- fix(gs): map_gs.rb for no UID when hexdigest used #843
- fix(gs): warcry.rb yowlp :buff to string instead of regexp #847
- fix(gs): group.rb multiple corrections #850, #869, #883
- fix(gs): Bounty parser.rb fix for HW & KF guard return #862
- fix(gs): Bounty task.rb fix for assigned? and Ruby 2.6 #863
- fix(gs): stash.rb stale sheaths recheck #867
- fix(gs): allow spell.rb casting to take a force_stance parameter #902
- fix(gs): update Infomon parsing for new ACCOUNT output format #903
- fix(gs): PSMS cost for multiple cost types & add Excoriate feat #912
- fix(gs): Feat excoriate regex correction #920
- fix(gs): weapon PSM affordable check against Glorious Momentum #926
</PRE>
'''5.11.1'''
<PRE>
- fix(all): restore @theme_state and add to CLI capability #795
- fix(all): retire gtk2 monkey patch for gtk3 #823
- fix(all): games.rb XMLData.name wait till both not NIL and not EMPTY #826
- fix(all): standardize xmlparser game instance #827
- fix(all): games.rb fix multiple single and double quote in XML #832,836,837
- fix(dr): games.rb - optional hide Room Title display of Real IDs with FLAG on #782
- chore(dr): common-moonmage - refactor of peer_telescope #783
- fix(dr): move HMR load to common before for dragonrealms #784
- fix(dr): common-crafting.rb minor edit to add "You tuck" #787
- fix(dr): common-arcana.rb - remove unecessary pause from discern code #792
- fix(dr): drparser.rb Restore Premium status checking #834
- fix(gs): migrate PSMS.name_normal to Lich::Util.normalize_name #790,833
- fix(gs): add Char.che to know current character's CHE #791
- fix(gs): FEAT and Infomon module parsing of new Covert Art feats. #796
- fix(gs): add Currency.gemstone_dust and fix redsteel mark capture #797
- fix(gs): FEAT Covert Arts colon normalization and stamina costs #799
- fix(gs): escape dash in regex for HouseCHE #824
- fix(gs): disk.rb comparison helpers #828
- fix(gs): allow for Group.disks to show self disk in array #829
- fix(gs): feat.rb Covert Arts throw poison costs 15 stam #830
- fix(gs): add missing Feat.use ability #831
- fix(gs): multiple CritRanks updates #801-822
</PRE>
'''5.11.0'''
<PRE>
- [all] - chore: Namespace & File Path Updates #713
- [all] - [argv_options.rb] bugfix: correct darkmode to work via CLI #693
- [all] - [games.rb] feat: make show Room Exits of non-StringProc/Obvious Exits toggable for all games #699
- [all] - [games.rb] feat: toggleable display of StringProcs with clickable links #751
- [all] - [gui-manual-login.rb] fix: change label to Wrayth #720
- [all] - [gui-saved-login.rb] fix: update Stormfront label #721
- [all] - [update.rb] fix: purge old LIB folder prior to update release #729
- [all] - [util.rb] bugfix: allow issue_command to use fput or put #715
- [all] - [xmlparser.rb] feat: add XMLData.room_name attribute #685
- [all] - [main.rb] fix: create session file in regular connect method #733
- [all] - [init.rb] bugfix: error for Windows DISPLAY variable #735
- [all] - [main.rb] fix: Mudlet support #736
- [all] - [wine.rb] fix: add --no-wine CLI flag prevent WINE startup
- [all] - [init.rb] fix: add --no-gtk CLI flag prevent GTK3 gem load
- [dr] - [games.rb] feat: DRinfomon and common files as core lich libraries #686
- [dr] - [games.rb] chore: add DR requires here #690
- [dr] - [games.rb] fix: add Room# display for DR #697
- [dr] - [games.rb] bugfix: Genie FE real ID#s not supported, hide by default #728
- [dr] - [drdefs.rb] bugfix: fix for Shadow Servants #710
- [dr] - [map_dr.rb] fix: cleanup and support for UIDs #719
- [dr] - [xmldata.rb] bugfix: add support for DR Room IDs #716
- [dr] - [xmlparser.rb] feat: XMLData - adding dr_active_spells #691
- [gs] - [games.rb] bugfix: support for pre/post room name txt #683
- [gs] - [group.rb] chore: update to account for hold #701
- [gs] - [resource.rb] feat: add additional tracking of covert art charges #714
- [gs] - [spell.rb] bugfix: Spell.affordable? 515 release #687
- [gs] - [stash.rb] bugfix: sheath_bags when not found #694
- [gs] - [xmlparser.rb] bugfix: missing real ID in nav #684
- [gs] - [xmlparser.rb] bugfix: Claim module obvious hiding #717
- [gs] - [sk.rb] feat: Self-Knowledge functionality in core #748
</PRE>
'''5.10.4'''
<PRE>
-o- [GS4] - [xmlparser.rb] bugfix: Simu XML breaking change RoomID #679
</PRE>
'''5.10.3'''
<PRE>
-o- [GS4] - [crit_tables] fix: CritRanks regex fixes (multiple files and changes) #671
-o- [GS4] - [spellsong.rb] fix: Correct Spellsong sync method #674
-o- [GS4] - [parser.rb] fix: thorn status regex correction #673
-o- [All] - [xmlparser.rb] fix: Split out if elif block to account for DR having multiple… #670
-o- [All] - [global_defs.rb] fix: percentconcentration #676
-o- [All] - [global_defs.rb] fix: update move failure message to handle attack and casting #667
-o- [All] - [init.rb] fix: update required ruby check messaging #669
-o- [All] - [sessionvars.rb] feat: new module SessionVars for non-persistent variable storage #666
</PRE>
'''5.10.2'''
<PRE>
-o- [DR] - [games.rb] bugfix: tweak XML rewrite section #662
-o- [GS4] - [crit_tables] bugfix: additional crit table regex corrections #663
-o- [GS4] - [ascension.rb] bugfix: add new Transcend Destiny to lookups #661
-o- [GS4] - [effects.rb] bugfix: regexp escape txt #660
-o- [GS4] - [disruption_critical_table.rb] Bugfix in regex #659
</PRE>
'''5.10.1'''
<PRE>
-o- [All] - [games.rb] bugfix: prevent race condition in games thread #656
-o- [All] - [init.rb] bugfix: address WINE variance between linux / installs #655
-o- [GS4] - [gs][stash.rb] bugfix: wear code improvement #657
</PRE>
'''5.10.0'''
<PRE>
-o- [All] - [main.rb] bugfix: correct encoding for WizardFE PR #640
-o- [All] - [games.rb] bugfix: correct logic for room detection when using CLI --start-scripts PR #639
-o- [All] - [DB_Store.rb] feat: add direct support for Simu RENAME and CHANGE PROF PR #633
-o- [All] - chore: breakout code to individual files for easier management PR #617
-o- [All] - [lich.rbw] chore: add deprecated msg to old Settings/GameSettings/CharSettings methods PR #589
-o- [All] - [lich.rbw] feat: add new --dark-mode CLI option PR #583
-o- [All] - [global_defs.rb] bugfix: monsterbold fix for additional clients PR #581
-o- [All] - [update.rb] feat: update core scripts from source on Lich5 update/install PR #579
-o- [All] - [log.rb] feat: add new Log module copied from Olib PR #577
-o- [All] - [numeric.rb] feat: add days/hours/minutes/seconds methods to numerics PR #623
-o- [All] - [messaging.rb] feat: WizardFE Voln window support #647
-o- [All] - [init.rb] bugfix: WINE entries for Linux / MacOS #649
-o- [DR] - [lich.rbw] bugfix: cleanup downstream hook exclusions PR #593
-o- [DR] - [global_defs.rb] bugfix: missing climb failure message PR #592
-o- [GS4] - [effects.rb] bugfix: show non-standard Effects in `;magic` output PR #641
-o- [GS4] - [parser.rb] bugfix: fix WARCRY duplication results / add WALL OF THORNS effect detection PR #634 / PR #637
-o- [GS4] - [critranks.rb] feat: add critical rank resolution tables and methods PR #625
-o- [GS4] - [effects.rb] bugfix: to support regex for active? & time_left PR #590
-o- [GS4] - [infomon.rb] bugfix: add implicit NPC death monitoring PR #588
-o- [GS4] - [infomon.rb] bugfix: change PSM to be stored as type.mnemonic PR #587
-o- [GS4] - [lich.rbw] bugfix: strip_xml multiline fix PR #584
-o- [GS4] - [stash.rb] bugfix: fix sack detection to use Stash.container(param) PR #578
-o- [GS4] - [spell.rb] feat: Spell.after_stance #644
-o- [GS4] - [xmlparser.rb] bugfix: for Claim module #646
-o- [GS4] - [infomon] feat: track Voln favor via RESOURCE output #648
-o- [GS4] - [gameobj.rb] feat: add Bandit hidden target API #650
</PRE>
'''5.9.2'''
<PRE>
-o- [GS4] - [group.rb] bugfix: proper leader detection from GROUP output
-o- [GS4] - [char.rb] bugfix: add back depracted Char.maxvitals with msging to switch to new Char.max_vitals methods
</PRE>
'''5.9.1'''
<PRE>
-o- [GS4] - [group.rb] bugfix: group.check syntax change
-o- [GS4] - [spell.rb] bugfix: affordable? Char.mana parenthesis logic
</PRE>
'''5.9.0'''
<PRE>
-o- [All] - feat: sqlite3 gem syntax code cleanup PR#553
-o- [All] - [lich.rbw] bugfix: remove unused Setting, GameSetting, CharSetting PR#542
-o- [All] - [lich.rbw] bugfix: scrub login key from error message popups PR#548
-o- [All] - [messaging.rb] bugfix: color mismatch WizardFE white txt PR#554
-o- [All] - [lich.rb] feat: add new Lich.deprecated method to aid in deprecating older API calls PR#523
-o- [GS4] - [char.rb] feat: log method_missing calls PR#552
-o- [GS4] - [char.rb] feat: add missing global_def related methods PR#523
-o- [GS4] - [global_defs.rb] feat: deprecate various Char module methods PR#523
-o- [GS4] - [spellsong.rb] bugfix: cache spellsong duration calc PR#551
-o- [GS4] - [effects.rb] feat: Effects module breakout PR#549
-o- [GS4] - [group.rb][disk.rb] feat: Group & Disk class PR#532
-o- [GS4] - [activespell.rb] feat: add duration change messaging, off by default, see ;help for details PR#487
</PRE>
'''5.8.1'''
<PRE>
-o- [All] - [lich.rbw] feat: add Game:Character to debug log file ouput
-o- [All] - [init.rb] feat: add milliseconds to debug filename
-o- [GS4] - [lich.rbw] bugfix: reorder parsing of $SERVERSTRING to avoid certain conflicts
-o- [GS4] - [parser.rb] bugfix: update for new Empath resource and sleep/bind messaging
-o- [GS4] - [status.rb] bugfix: bound? calmed? and sleeping? support for spellnames flag being off
-o- [GS4] - [xmlparser.rb] bugfix: additional creature dying messaging to check against XML dead not being sent
-o- [GS4] - [gameobj.rb] bugfix: remove sorcerer arms and animates from GameObj.targets
</PRE>
'''5.8.0'''
<PRE>
-o- [All] - Ruby 3.3 compatibility
-o- [All] - [lich.rbw] feat: adds .sources for up/downstream hooks
-o- [All] - [lich.rbw] bugfix: don't use WINE for custom frontends
-o- [GS4] - [char.rb] bugfix: add back Char.stance
-o- [GS4] - [claim.rb] feat: new module and associated changes to xmlparser
-o- [GS4] - [experience.rb] feat: percent experience options
-o- [GS4] - [parser.rb] bugfix: allow for negative TNL exp value
-o- [GS4] - [parser.rb] bugfix: allow hyphenated last names in character names
-o- [GS4] - [parser.rb] feat: update resource matching for new Bard service
-o- [GS4] - [stash.rb] bugfix: catch more shield removal messages
-o- [GS4] - [util.rb] bugfix: underscore issue for PSMs
</PRE>
'''5.7.0'''
<PRE>
-o- Supports Ruby 3.2 - security enhancements and huge speed improvements for regex
-o- New libraries/modules/classes: Account, HMR (Hot Module Reloading)
-o- GS4 Infomon now baked into Lich5 as a library, no more need to run standalone script
-o- New GS4 libraries/modules/classes: Ascension, Bounty, Currency, Experience, Resources, Society, Status, Warcry
-o- Updates to existing libraries/modules/classes: Armor, Util, Weapon, Spell, GameObj, Messaging
-o- Several Bugfixes for lots of things
-o- Lots of code cleanup
</PRE>
'''5.6.2'''
<PRE>
-o- Fix for XML errors
-o- Adds the DR Plat instance for Frostbite FE
-o- Adds ‘ball’ as the noun used for ‘ball and chain’
-o- Adds the movement result ‘slip in the mud and fall flat’
-o- Corrects stamina cost for the feature Dispel Magic
-o- Plus all the latest script updates from Elanthia-Online!
</PRE>
'''5.6.1'''
<PRE>
-o- Fix for XML to limit login errors (DR)
-o- Fix for XMLData.active_spells to properly register wizard 'recovery' spell cooldowns
-o- Messaging updates to remove error in Wizard FE encodings
-o- Corrects for error in detecting PSM skill changes (cman) via warrior / rogue guild lessons
-o- Deprecates LNet script from master repository
-o- Miscellaneous small bug squashing
</PRE>

'''5.6.0'''
<PRE>
-o- (DragonRealms) Support for Genie and Frostbite frontends
-o- (GemStone) Changed methods to improve ;go2 speed and reduce lich.db3 calls
-o- (GemStone) Updates to support silver_count function
-o- (Both) Changed method for updating lich ecosystem
</PRE>

'''5.5.0'''
<PRE>
-o- Support for DragonRealms
-o- Updated support for scripts like BigShot
-o- Providing the LichID and UID on Profanity
-o- Spell.force_incant, .force_channel, and .force_evoke
-o- Standardized message method for script authors
-o- Sundry small improvements / fixes and changes
-o- And the creme de la creme - a custom directory
</PRE>

'''5.4.0'''
<PRE>
-o- Simu Room IDs (formally called 'unique ID' or 'uid' for Lich) added to Map, mapDB where known, and ;go2 for navigation (courtesy Xanlin and with our thanks!) ;go2 u7120 for all you ex-GMs out there.
-o- Room titles will now display the Lich ID and / or the UID for the room based on user selections - default is on for both, and enabled / disabled via Lich.display_lichid or Lich.display_uid toggles that can be set to on / off or true / false. (;e Lich.display_lichid=true/false and ;e Lich.display_uid=true/false) You can remove that rnum from your autostart now! To gain the benefit of the UID deployment, be sure to ;repo download-mapdb
-o- REQUESTS: Drop 5 minute timeout function from Lich
-o- waitrt? and waitcastrt? will still pause activities, but will return TRUE or FALSE in keeping with the Ruby functionname? tradition (no more failing to get a weapon out due to RT from climbing!)
-o- empty_hands and fill_hands will now check to see if the character is in roundtime before trying to put away or retrieve held items
-o- Infomon received an update that keeps spell timers in sync with the information received from the server - no more need to immediately do a spell active in game to get the right times to display for various legacy scripts and ;magic after visiting the invoker or using an SK item
-o- Lich now provides a facility to get current coins on the character that is a bit more agnostic to data changes from Simu - Lich::Util.silver_count
-o- Various other small tidbits to help ease maintenance and future development
-o- PLEASE NOTE: This update is required for the newest Bigshot (released today!) and for future eloot and eherbs scripts (release RSN)
</PRE>

'''5.3.0'''
<PRE>
-o- Added support for Wrayth (renamed Stormfront) installations
-o- Converted Linux | WINE login methods to 'method 0', does not use Simu launcher
</PRE>

'''5.2.1'''
<PRE>
-o- Support for STOWing items irrespective of special item scripts
-o- Improved query support for Effects and CMans
-o- Fix Lich bug to respect the 'groupmovement' flag in game
-o- Fix Lich round time calculations (more aggressive timing)
-o- Dark Mode is now a thing
-o- Lich4 Style GUI layout available
-o- Several file location changes to support future code change efforts
</PRE>

'''5.0.19'''
<PRE>
-o- Benefit: Monks with Mental Acuity (all 3 of you) rejoice - stamina casting!
-o- Benefit: PSM3 included, no charge. No hair remaining, either!
-o- Benefit: Ok, stay seated: Some of your various SF spell duration windows may work. . . better? Yes, not perfect, but better. No pictures, please!
-o- Updated infomon that properly detects Cloak of Shadows on those pesky sorcerers, and the Raise Dead Cooldown periods for those wondrous clerics.
-o- A new update process for Lich 5 - tired of having to download that script over and over just to update? Get yourself a copy of lich5-update.lic. Note, if you already have it, you're set! If not - ;jinx script install lich5-update --repo=elanthia-online
</PRE>

'''5.0.11'''
<PRE>
-o- Updated the method used to log onto SIMU servers.
-o- Added the Animalist item specifics to Lich5's empty and fill hands routines
-o- Improved Invoker messages for Avalon and Wizard FEs (no change for SF FE)
-o- Improved cleanup and store methods when player EXIT's or QUIT's game
-o- Crafted two new methods (stash_hands and equip_hands) for future script use
-o- Some behind-the-scenes cleanup to improve maintaining the Lich5 ecosystem
-o- Add Spell Active improvements
-o- Add PSM and Ranger improvements
</PRE>
</div>

=Resources=
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:New Player]]

User talk:SIGSEGV

2025-08-01T15:36:55Z

DOUG:

Responding to your question on my wiki page.

I don't have experience with thrown at the capped / ascension levels. Sounds like it could be fun! So please take my comments with a huge grain of salt.

1) Time to get your enhancives in order if you're not yet doing ascension. For example, dexterity is critical for a number of reasons. So ensure you have enhancives to get your DEX bonus to +50, and a solid plan to maintain them. Same for Thrown Weapons skill, CMan skill, etc., etc.

2) I suspect your training for Combat Maneuvers is light, and it only will net max enhanced 151/4 points (37). However, as far as I know, you can't get them any other way.

3) Depending on where you are in your experience run - it may be time to start ascension training. Again, I don't have a lot of advice here, give your path. Seek help from ascended characters with 5x cap training, etc. Leifi is a mainstay on 'general' ascension matters, but this might be a bit too tailored for the info provided to give a lot of support. https://gswiki.play.net/Leafiara_(prime)/Mechanical_Musings/Ascension_Considerations

4) A sometimes overlooked resource could possibly be the Shattered crew. There's some wild pursuits in Shattered. Join the server and see if anyone is awake / paying attention enough to answer some basic questions from their direct experience. Here's an invite link - https://discord.gg/5hfWcUfP

5) Stick with it! Given the way we can reallocate / change / revert these days, a mistake isn't the end of the world. I look forward to hearing about your progress!

User talk:SIGSEGV

2025-08-01T15:35:07Z

DOUG:

Responding to your question on my wiki page.

I don't have experience with thrown at the capped / ascension levels. Sounds like it could be fun! So please take my comments with a huge grain of salt.

1) Time to get your enhancives in order if you're not yet doing ascension. For example, dexterity is critical for a number of reasons. So ensure you have enhancives to get your DEX bonus to +50, and a solid plan to maintain them. Same for Thrown Weapons skill, CMan skill, etc., etc.

2) I suspect your training for Combat Maneuvers is light, and it only will net max enhanced 151/4 points (37). However, as far as I know, you can't get them any other way.

3) Depending on where you are in your experience run - it may be time to start ascension training. Again, I don't have a lot of advice here, give your path. Seek help from ascended characters with 5x cap training, etc. Leifi is a mainstay on 'general' ascension matters, but this might be a bit too tailored for the info provided to give a lot of support.

4) A sometimes overlooked resource could possibly be the Shattered crew. There's some wild pursuits in Shattered. Join the server and see if anyone is awake / paying attention enough to answer some basic questions from their direct experience. Here's an invite link - https://discord.gg/5hfWcUfP

5) Stick with it! Given the way we can reallocate / change / revert these days, a mistake isn't the end of the world. I look forward to hearing about your progress!

User talk:SIGSEGV

2025-08-01T15:33:54Z

DOUG: Created page with "Responding to your question on my wiki page. I don't have experience with thrown at the capped / ascension levels. Sounds like it could be fun! So please take my comments with a huge grain of salt. 1) Time to get your enhancives in order if you're not yet doing ascension. For example, dexterity is critical for a number of reasons. So ensure you have enhancives to get your DEX bonus to +50, and a solid plan to maintain them. Same for Thrown Weapons skill, CMan skill,..."

Responding to your question on my wiki page.

I don't have experience with thrown at the capped / ascension levels. Sounds like it could be fun! So please take my comments with a huge grain of salt.

1) Time to get your enhancives in order if you're not yet doing ascension. For example, dexterity is critical for a number of reasons. So ensure you have enhancives to get your DEX bonus to +50, and a solid plan to maintain them. Same for Thrown Weapons skill, CMan skill, etc., etc.

2) I suspect your training for Combat Maneuvers is light, and it only will net max enhanced 151/4 points (37). However, as far as I know, you can't get them any other way.

3) Depending on where you are in your experience run - it may be time to start ascension training. Again, I don't have a lot of advice here, give your path. Seek help from ascended characters with 5x cap training, etc. Leifi is a mainstay on 'general' ascension matters, but this might be a bit too tailored for the info provided to give a lot of support.

4) A sometimes overlooked resource could possibly be the Shattered crew. There's some wild pursuits in Shattered. Join the server and see if anyone is awake / paying attention enough to answer some basic questions from their direct experience. I sent you an invite.

5) Stick with it! Given the way we can reallocate / change / revert these days, a mistake isn't the end of the world. I look forward to hearing about your progress!

Talk:Lich:Software/Mac Installation

2025-07-08T04:25:57Z

DOUG:

Preparing for future launcher activities.

gem install ascii_charts gtk3 json logger ostruct redis sequel sqlite3 terminal-table tzinfo tzinfo-data webrick --no-document

preserving the old to bring in the new!

==Installing the Lich script engine on your Mac OS X Computer==

{{equation box|'''No longer viable due to change in GTK with Homebrew''' - '''FIXED (sort of)'''
User Jahadeem left a note about GTK failing. Our friends at Homebrew strike again. I have a workaround in place both in the instructions below and in the installer. I'll address this more permanently in the coming months, but for now OSX-Lich is BACK IN BUSINESS! [[User:DOUG|DOUG]] ([[User talk:DOUG|talk]]) 22:57, 10 June 2018 (CDT)}}

{{equation box|'''An important note to users who updated to High Sierra (Mac OS X 10.13)''' - Apple has changed the default version of Ruby in its core software release. The version of Ruby distributed with Mac OS X 10.13 (High Sierra) is version 2.3.x, which does not work with the current Lich implementation. If you have had Lich installed in a prior version of Mac OS X (10.12 or earlier) and it was working, but you are now getting errors about SAFE variables, you are affected by this change. More detail will be provided when available as we work through these issues. If you have not installed Lich yet, the instructions below will work for you.

For those who desire immediate assistance, email doug@play.net for current information. When the entire solution is in place and known to be working, instructions will be provided below and this note will be removed.

[[User:DOUG|DOUG]] ([[User talk:DOUG|talk]]) 19:44, 9 October 2017 (CDT)}}

{{#lst:Lich_(software)|About}}

==Background==

Mac OS X systems for Mavericks (10.9), Yosemite (10.10) and El Capitan (10.11) have some of the elements you need to run [[Lich_(software)|Lich]] already installed. Some elements are missing, and will require you to install components on your system. While most software distributed for Mac OS X comes in the form of an automated install file, Lich is different. Lich will require that you install some components via a Terminal window command prompt. You will also start Lich from the Terminal window.

==Note for versions prior to Mavericks (10.9)==

Installation instructions for Mac OS X versions prior to 10.9 is more complicated. The best option is to update your OS X version to current.

==Steps to Install==

Before you begin, it may be a good idea to download and run the 3rd party provided lich diagnostics script. This script is written to run on your Mac no matter how much, or how little of the required components you have installed. It can be useful to create a reference snapshot before you begin installing, and again after. Just run the script again, it will simply add on to your existing diagnostics file, so you have a before and after picture.

To run this script, download the [http://bit.ly/GSLichDiag file] and then:

1) Open up your Terminal window (you can use Spotlight to search for Terminal, then open the application)
2) In your terminal window enter the following commands:
cd
chmod 744 ./Downloads/lichdiag.sh
./Downloads/lichdiag.sh
3) The output in Terminal will tell you what you have and don't have.

There are six steps to getting Lich up and running on your new Mac.

1) Installing the [[Avalon]] client.
2) Installing the xQuartz windowing system.
3) Installing the software compiling tools from Apple.
4) Installing the core software Ruby will use to support gems required for Lich.
5) Installing the Ruby gems used by Lich.
6) Testing the game and finalizing the installation.

Depending on the capabilities of your Mac and your network, you should anticipate that this installation process will take between 15 minutes and 45 minutes for most Macbook Pros and MacPros.

==Detailed Installation Instructions==

Let's get you set up to use Lich on your Mac system. You have two choices in how you can install Lich on your Mac OS X system. You can download a 3rd party installer file and let it do most of the work for you, or you can manually install the necessary components. The 3rd party installer file is not supported by Simutronics. '''NOTE:''' when running the installer file, you will be asked for your password twice - once to install Homebrew, and once to install xQuartz. This should happen within the first 5 to 10 minutes of the install. Thereafter the script should run without any further interaction required.

''Note: For most current Mac systems, the install script will take about 20 to 30 minutes to complete if it has to install everything.''

'''To install via the 3rd party script osxlich.sh''':

{|{{prettytable}}
|'''Command''' || '''Comment'''
|-
|'''[http://bit.ly/GSLichDiag Download the diagnostic file]''' || You should run this before and after the installation to get a snapshot of your system to troubleshoot from.
|-
|'''[http://bit.ly/GSLichInstall Download the installer file]''' || After you've run the diagnostics, you'll run this program to install what you need.
|-
|'''Open the Terminal Application''' || You can find Terminal by using Spotlight.
|-
|'''cd''' || type (or copy / paste this and the following commands into your Terminal window.
|-
|'''chmod 744 ./Downloads/lichdiag.sh''' || make the diagnostic file executable only by you.
|-
|'''chmod 744 ./Downloads/osxlich.sh''' || make the installer program executable only by you.
|-
|'''./Downloads/lichdiag.sh''' || run the diagnostics program. It will create a text file on your desktop for reference.
|-
|'''./Downloads/osxlich.sh''' || run the installer program. You will be asked for your password twice during the install.
|-
|'''./Downloads/lichdiag.sh''' || after the installer completes, run the diagnostics again.
|-
|'''You are now ready to play''' || scroll down to the section on Running Lich for the First Time.
|}

'''If you would rather manually install the required components:'''

First, if you haven't already, download Avalon 4.3.3 (beta) from http://www.play.net/playdotnet/play/avalon-info.asp
''You'll want to scroll down to the bottom to find the right one.'' After you've downloaded it, double click on the download to unzip it. Then, I would recommend you drag the application onto your desktop where it can be handy!

Now we get serious.

Below, you'll find a list of commands that you'll need to enter in Terminal. Terminal is an application on every Mac system that allows you to enter Unix-style commands. If you've never used Terminal before, it is simply a console that you type information (commands) into and the system responds. It is in the Applications / Utilities folder, or you can simply use Spotlight (magnifying glass upper right corner on most Macs) to search for Terminal, and open it.

In Terminal, you're going to type (or copy / paste) the commands below. It is absolutely ok to copy and paste these commands into Terminal rather than type them in. You only need to copy the bold part. Anything in comment column is to help inform what's going on. Don't copy that portion. Be sure to copy the complete command, though.

{|{{prettytable}}
|'''Command''' || '''Comment'''
|-
|'''cd''' || just making sure we're in our home directory
|-
|'''/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"''' || copy and paste this whole command - don't just click on the link. You'll be asked for your password here.
|-
|'''brew install Caskroom/cask/xquartz''' || Install xQuartz. This might ask you for your password again.
|-
|'''brew install rbenv''' || this command will install the rbenv manager to manage ruby versions
|-
|'''rbenv init''' || Initialize the environment
|-
|-'''echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile''' || set up the environment to 'see' rbenv
|-
|'''echo 'eval "$(rbenv init -)"' >> ~/.bash_profile''' || make sure this works every time we open terminal
|-
|'''exit''' || log out of the terminal window
|-
|'''From the Terminal > Shell menu, open a new window''' || If you need to, you can use Spotlight to search for Terminal
|-
|'''brew install sethrfore/r-srf/cairo''' || this command should take a few minutes to complete
|-
|'''brew install https://raw.githubusercontent.com/Homebrew/homebrew/bb3fe5f2de87f76bc0a3f3480635c8fd0d68cec3/Library/Formula/gtk+.rb''' || copy and paste this whole command - don't just click on the link
|-
|'''rbenv install 2.2.5''' || Install Ruby version 2.2.5
|-
|'''rbenv global 2.2.5''' || Set 2.2.5 as the Ruby the system will use
|-
|'''rbenv rehash''' || Setting up to install the gems needed
|-
|'''gem install sqlite3''' || Install the database Lich uses This command may fail on some systems complaining that it is already installed. That's ok.
|-
|'''gem install gtk2 -v 3.1.8''' || Install the graphics interface Lich uses for advanced scripts like narost
|-
|'''cd''' || just making sure we're in our home directory
|-
|'''curl -OL http://lichproject.org/download/lich-4.6.33.zip''' || download the current Lich software
|-
|'''unzip lich-4.6.33.zip || unzip the lich software for use
|}

That is everything we should need to worry about to get into the game with Lich operating.

==Running Lich for the First Time==

In order to start the game with Lich, from Terminal we'll have to run the following command:

sudo ruby lich/lich.rbw --gemstone --avalon

You will be prompted for your password. Then, you should see in Terminal that Lich is waiting for the game client to connect. Just fire up Avalon, log in and enjoy!

'''Quick pro tip:''' The next time you want to play, just open up Terminal and hit your 'up arrow' one time. You should see the sudo ruby line above in your Terminal window. You can just press enter, fire up Avalon and enjoy again!

==Final Steps==
After confirming everything is working the way you want, don't forget! Open up Terminal and type the following three commands:

brew pin gtk+
brew pin cairo
brew pin pango

Enjoy!

==A Few Quick Pro Tips==

If you've read this far, you're going to benefit!

'''caffeinate -di [command]'''

Sometimes your Mac will want to go to sleep, and will disrupt your processes - even sometimes causing the dread 'SEGFAULT' that reboots your Mac with cryptic information that no one really can use (despite claims to the contrary). If you use the 'caffeinate' command in Terminal, your Mac will not sleep ( [d]isplay or computer [i]dle ) until the command completes. Suggested usage might be 'caffeinate -di ./osxinstall.sh' as one (very pertinent) example.

'''Install Wine'''

Took the plunge from a Windows PC to Mac OS X, but not quite ready to give up on your Stormfront or Wizard (my personal fav) yet? Great news! You don't have to. While Avalon is a tried and tested Mac front end, let's face it - the PC crowd presently has the better collection of front ends. So, how do you make this magic all happen? Just follow these instructions (wine installs are as long or longer than the core OS X Lich installs, so make sure you have time!) And now might just be a good time to test 'caffeinate' on that first command - it takes a while and might abort if the machine tries to sleep.

{|{{prettytable}}
|'''Command''' || '''Explanation'''
|-
|'''Open Terminal''' || Yes, we love this application to do heavy work!
|-
|'''cd''' || Always a good idea anytime you're not sure exactly where you are (which folder) on your Mac
|-
|'''caffeinate -di brew install wine''' || This will take a bit of time to complete, so we'll pour in some caffeine.
|-
|'''curl -OL http://www.play.net/software/lnchInst.exe''' || Don't just click the link, copy (or type) the entire command.
|-
|'''wine lnchInst.exe''' || You might see a few errors / warnings, but it'll work as of 8/2016
|-
|'''ruby ./lich/lich.rbw''' || Note! No SUDO (yay!) and no specifying --gemstone --avalon. Simple.
|}

''Troubleshooting - you may get this strange error message: "concat': no implicit conversion of Errno::EACCES into String (TypeError)" . If you've used Avalon and Lich previously (in particular, using 'sudo ruby' as the instructions say), then we have one step we need to take to remove this error. Don't worry, it is an expected outcome of using sudo with lich, and can be fixed with one line.''

{|{{prettytable}}
|'''Command''' || '''Explanation'''
|-
|'''cd''' || Absolutely ensure we're in the right directory
|-
|'''sudo chown -R $(whoami):staff ./lich''' || change ownership of all content in the lich directory to your username
|-
|'''ruby ./lich/lich.rbw''' || continue on with the login
|}

At this point, you'll see the Lich login window - just type in your account information, select your character, and then '''look at the two radio buttons'''. One of them is Wizard, and the other Stormfront. Select your preference, and click PLAY. Your front end will be downloaded and you'll be guided to install (please just select the default locations - wine knows what it's doing).

''Caution - sometimes wine takes a bit of time 'searching' for a previous installation of a file, especially the Wizard. No panic, let the process complete. Then you may not connect, especially the Wizard, the first time. No worries - wait it out and close up Terminal, then start Terminal again, and re-enter the command. You'll get in the second time.''

''Note: Stormfront is a very nice looking front end, but it has a memory leak in it. This situation is really exacerbated on a Mac / wine installation. You'll notice the front end start to get sluggish. When it does - simply move someplace safe, log out, and log back in. Voilà!''

'''Use those config files!'''

If you've been playing for a while, you'll have a couple of challenges to overcome - migrating any non-lich scripts you may have, and migrating your existing highlights, macros and other settings. The process is slightly different for each front end, but in general:

Wine installs all Windows programs under the user directory at the following path:

~/.wine/drive_c/Program\ Files

So our Simutronics front ends are stored at

~/.wine/drive_c/Program\ Files/SIMU/STORM

~/.wine/drive_c/Program\ Files/SIMU/WIZARD

To move your existing Stormfront configuration, take these steps:

1) Check to see if your scripts and such are saved on the server. If they are - confirm they're available to you
2) If they're not, on your old system with Stormfront - click on the Options button, then select SETTINGS and EXPORT
3) This will create an XML file. Copy this file over to your Mac (desktop is fine if you wish)
4) Start the game on your Mac with Lich and Stormfront, and then on that system, click Options > SETTINGS and IMPORT
5) Confirm your settings / highlights / scripts are available to you.

To move over your existing Wizard configuration (it's a bit harder), take these steps:

1) On your old system, copy the directory under Wizard called Gemstone
2) On your new Mac you'll need to use Terminal to put them in the right place
3) On your new Mac, you need to have the Wizard front end (via wine) already installed
4) Put the Gemstone folder on your desktop
5) In Terminal, type in
cd
cp -R ./Desktop/Gemstone ./.wine/drive_c/Program\ Files/SIMU/WIZARD/
6) Log into the game and see if your files made the transfer

'''Don't forget, Terminal remembers your command history'''

Just like in the game front ends, if you want to repeat a command that you've already typed in, you can simply hit the UP ARROW on your keyboard, and scroll backwards to find the command. If you go too far, DOWN ARROW will scroll you forwards. Admittedly, this is most advantageous when you're getting ready to play, and you hit UP ARROW to get your 'ruby ./lich/lich.rbw' command back.

From time to time, contributors may make changes / modifications to these tips (and the article in general), so bookmark this page, and check it periodically to see what's new and exciting!

'''If you're lazy, like a good Unix admin, use AUTOCOMPLETE in your Terminal window'''

Your Terminal window in Mac OS X will allow you to zip through long filenames and directory paths, if you use the TAB key (autocomplete). For example, in the Wizard instructions above, you can simply type in the following (and hit the TAB key where the field has [T]ab

5) cp -R ./Desk[T]ab/Gem[T]ab ./.wine/driv[T]ab/Prog[T]ab/SIMU/WIZ[T]ab

Autocomplete makes things much easier, and much less error prone! This will work if the file or directory already exists. If you hit TAB and it doesn't autocomplete, the capitalization is off - Unix is case sensitive!

==Resources==
* [http://bit.ly/GSLichDiag OS X Lich Diagnostics] 3rd party, not supported by Simutronics
* [http://bit.ly/GSLichInstall OS X Lich Installation Script] 3rd party, not supported by Simutronics
* [[Lich scripting reference]]
* Tillmen's Lich Update (v4.6.33): https://lichproject.org/
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}

Lich:Software/Installation

2025-06-25T16:17:27Z

DOUG: /* Chromebook & Debian variants */

{{3rd-party}}
=About=

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Wrayth or Wizard FE. Lich is also used by many on both MacOS and multiple Linux distributions.

=Installing the Latest Stable Release=

'''The latest stable lich version is 5.12.0 supporting Ruby 3.4 - published June 24, 2025'''

==In-Place Upgrade==

If you are on an older version of Lich 5 and want to upgrade to the most current version, you can choose to either upgrade Lich5 only or both Lich 5 and Ruby. If you're currently on Lich 4, able to check by running the command <CODE>;e echo LICH_VERSION</CODE>, go to the [[#Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)|upgrade from Lich 4 section]].

For each section, please follow the directions/commands one at a time.

===Lich 5 Only===

====Lich 5.6.0 or newer====
# '''Backup existing Lich 5 folder'''
# Run this command in-game <CODE>;lich5-update --library=update.rb</CODE>
# Quit and restart lich.
# Run this command in-game <CODE>;lich5-update --update</CODE>
# Quit and restart lich.
# Congratulations - you're now running on the latest version of Lich!

====Lich 5.5 or older====
Does not work for Lich 4 upgrades, please do a full new install if on Lich 4.
# '''Backup existing Lich 5 folder'''
# Run this command in-game <CODE>;lich5-update --snapshot</CODE>
# Quit and close out of the game.
# Download the full release [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip lich-5.zip]
# Extract the zip file over your existing Lich5 installation, choosing to overwrite existing files.
# Restart lich.
# Congratulations - you're now running on the latest version of Lich!

===Both Ruby 3.4 & Lich 5===
This method is for Windows only. Linux and MacOS users, please do a Lich 5 only update and update Ruby manually via normal install/update methods for the OS.

# Logout of all characters
# '''Backup existing Lich 5 folder'''
# Uninstall existing Ruby4Lich5 installs from Programs & Features control panel, or alternatively, rename your existing Ruby4Lich5 folder to Ruby4Lich5save. (Defaults to C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer]
# Run the installer and be sure to have both Ruby and Lich 5 option selected
# Congratulations - you're now running on the latest version of Lich & Ruby!

===Ruby 3.4 Only===
Use this to upgrade to the newest version of Ruby only if you're already on the latest version of Lich5 and now want to update Ruby afterwards. If you're not already on the latest version of Lich5, please use previous section steps instead.
# Logout of all instances/characters
# '''Backup existing Lich 5 folder'''
# Uninstall your existing Ruby4Lich5 install via Programs & Features (ensure it's now gone, default location was C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer]
# Run the new installer and choose to only install Ruby Only
# Congratulations - you're now running on the latest version Ruby!

==Windows New Installation==

{{blue|These instructions are not for DragonRealms. [[#Ecosystem Information|For those scroll to the bottom]].}}

'''For Windows 11 / 10 / 8 / 7''' users: you can download the [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer] and install everything you need automatically. Click on the '''Ruby4Lich5.exe''' and download it to your computer then double click on the executable in your default download folder. Note, a user may need to adjust their browser or security settings to allow download and installation.
If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

===New Installation for Lich 5 (11/14/2023)===

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The Wrayth FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.

===Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)===

This option is deprecated. Lich 5 architectures are not compatible with Lich 4. Back up your existing Lich 4 folder, uninstall any existing Ruby executables, and then follow the instructions for a new install above.

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

==MacOS==
There two common options for playing Gemstone IV on a Mac is either to play natively with Avalon or to use virtualization software such as Parallels with Wrayth/WizardFE. Below are the options on how to do that.

===Native Avalon===
Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help. This process works well for Mac OS Catalina and Big Sur. If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Parallels Windows===
'''The following only pertains to Apple Silicon based Macs. If you have an Intel based Mac, you can use the normal Windows installation procedures instead.'''

To install Wrayth/WizardFE, Lich, and Ruby via Parallels you will need to do a few various steps as outlined below. Please note, the rubyw file in C:\Ruby4Lich5\X.X.X\bin may be set to run in compatibility mode for windows 7. On an ARM Mac running parallels, this causes Wrayth scripts not to run. Turning compatibility mode off in the rubyw file fixes this issue if it was enabled.

<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
The following steps are to be done AFTER you've successfully installed Wrayth/WizardFE and can login normally without Lich5 on the machine. Once you've done that and can successful connect normally, then follow these steps:
# Download and install [https://github.com/oneclick/rubyinstaller2/releases/download/RubyInstaller-3.4.3-1/rubyinstaller-devkit-3.4.3-1-x86.exe Ruby 3.4.3 x86 (32bit) Installer] and use default options presented during install
# Open a Command Prompt and issue the following command to install the necessary gems, this process will take awhile (at least 30 mins)<pre>gem install ascii_charts concurrent-ruby curses ftools gtk3 json jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r --no-document</pre>
# Download and extract the Lich5 latest [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip lich-5.zip] to somewhere you want it stored (usually desktop)
# Double click the lich.rbw file that is now located in the extracted Lich5 location you did above. Login and play as usual.
</div>

==Chromebook & Debian variants==
<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Wrayth).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential curl libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev git unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 3.4.4 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 3.4.4 -v
rbenv global 3.4.4
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r
</pre>

If you wish to use LNet with newer versions of Ruby, you'll need to downgrade the default version of REXML to be 3.3.1 or older due to Tillmen's LNet server not supporting the newer version currently:
<pre>
gem install rexml:'<3.3.2' && gem uninstall rexml:'>3.3.1'
</pre>

Install Lich and Profanity:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.
</div>

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora 38 & 39 use Ruby 3.2.2, while Fedora 40 uses Ruby 3.3.0. All of which are currently compatible with Lich 5.7.0 or higher.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison curl gcc gdbm gdbm-devel glib2-devel gobject-introspection-devel \
libyaml-devel libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
$ gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r
</pre>

4. Download Lich & Profanity:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>
</div>

=Popular Scripts=
{{#section:Lich:Script Repository|popularscripts}}

=Ecosystem Information=

* DragonRealms Variant - [https://elanthipedia.play.net/Lich_script_repository#Setup_and_Installation Setup and Install instructions]

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.11.1''' (current)
<PRE>
- fix(all): restore @theme_state and add to CLI capability #795
- fix(all): retire gtk2 monkey patch for gtk3 #823
- fix(all): games.rb XMLData.name wait till both not NIL and not EMPTY #826
- fix(all): standardize xmlparser game instance #827
- fix(all): games.rb fix multiple single and double quote in XML #832,836,837
- fix(dr): games.rb - optional hide Room Title display of Real IDs with FLAG on #782
- chore(dr): common-moonmage - refactor of peer_telescope #783
- fix(dr): move HMR load to common before for dragonrealms #784
- fix(dr): common-crafting.rb minor edit to add "You tuck" #787
- fix(dr): common-arcana.rb - remove unecessary pause from discern code #792
- fix(dr): drparser.rb Restore Premium status checking #834
- fix(gs): migrate PSMS.name_normal to Lich::Util.normalize_name #790,833
- fix(gs): add Char.che to know current character's CHE #791
- fix(gs): FEAT and Infomon module parsing of new Covert Art feats. #796
- fix(gs): add Currency.gemstone_dust and fix redsteel mark capture #797
- fix(gs): FEAT Covert Arts colon normalization and stamina costs #799
- fix(gs): escape dash in regex for HouseCHE #824
- fix(gs): disk.rb comparison helpers #828
- fix(gs): allow for Group.disks to show self disk in array #829
- fix(gs): feat.rb Covert Arts throw poison costs 15 stam #830
- fix(gs): add missing Feat.use ability #831
- fix(gs): multiple CritRanks updates #801-822
</PRE>
'''5.11.0'''
<PRE>
- [all] - chore: Namespace & File Path Updates #713
- [all] - [argv_options.rb] bugfix: correct darkmode to work via CLI #693
- [all] - [games.rb] feat: make show Room Exits of non-StringProc/Obvious Exits toggable for all games #699
- [all] - [games.rb] feat: toggleable display of StringProcs with clickable links #751
- [all] - [gui-manual-login.rb] fix: change label to Wrayth #720
- [all] - [gui-saved-login.rb] fix: update Stormfront label #721
- [all] - [update.rb] fix: purge old LIB folder prior to update release #729
- [all] - [util.rb] bugfix: allow issue_command to use fput or put #715
- [all] - [xmlparser.rb] feat: add XMLData.room_name attribute #685
- [all] - [main.rb] fix: create session file in regular connect method #733
- [all] - [init.rb] bugfix: error for Windows DISPLAY variable #735
- [all] - [main.rb] fix: Mudlet support #736
- [all] - [wine.rb] fix: add --no-wine CLI flag prevent WINE startup
- [all] - [init.rb] fix: add --no-gtk CLI flag prevent GTK3 gem load
- [dr] - [games.rb] feat: DRinfomon and common files as core lich libraries #686
- [dr] - [games.rb] chore: add DR requires here #690
- [dr] - [games.rb] fix: add Room# display for DR #697
- [dr] - [games.rb] bugfix: Genie FE real ID#s not supported, hide by default #728
- [dr] - [drdefs.rb] bugfix: fix for Shadow Servants #710
- [dr] - [map_dr.rb] fix: cleanup and support for UIDs #719
- [dr] - [xmldata.rb] bugfix: add support for DR Room IDs #716
- [dr] - [xmlparser.rb] feat: XMLData - adding dr_active_spells #691
- [gs] - [games.rb] bugfix: support for pre/post room name txt #683
- [gs] - [group.rb] chore: update to account for hold #701
- [gs] - [resource.rb] feat: add additional tracking of covert art charges #714
- [gs] - [spell.rb] bugfix: Spell.affordable? 515 release #687
- [gs] - [stash.rb] bugfix: sheath_bags when not found #694
- [gs] - [xmlparser.rb] bugfix: missing real ID in nav #684
- [gs] - [xmlparser.rb] bugfix: Claim module obvious hiding #717
- [gs] - [sk.rb] feat: Self-Knowledge functionality in core #748
</PRE>
'''5.10.4'''
<PRE>
-o- [GS4] - [xmlparser.rb] bugfix: Simu XML breaking change RoomID #679
</PRE>
'''5.10.3'''
<PRE>
-o- [GS4] - [crit_tables] fix: CritRanks regex fixes (multiple files and changes) #671
-o- [GS4] - [spellsong.rb] fix: Correct Spellsong sync method #674
-o- [GS4] - [parser.rb] fix: thorn status regex correction #673
-o- [All] - [xmlparser.rb] fix: Split out if elif block to account for DR having multiple… #670
-o- [All] - [global_defs.rb] fix: percentconcentration #676
-o- [All] - [global_defs.rb] fix: update move failure message to handle attack and casting #667
-o- [All] - [init.rb] fix: update required ruby check messaging #669
-o- [All] - [sessionvars.rb] feat: new module SessionVars for non-persistent variable storage #666
</PRE>
'''5.10.2'''
<PRE>
-o- [DR] - [games.rb] bugfix: tweak XML rewrite section #662
-o- [GS4] - [crit_tables] bugfix: additional crit table regex corrections #663
-o- [GS4] - [ascension.rb] bugfix: add new Transcend Destiny to lookups #661
-o- [GS4] - [effects.rb] bugfix: regexp escape txt #660
-o- [GS4] - [disruption_critical_table.rb] Bugfix in regex #659
</PRE>
'''5.10.1'''
<PRE>
-o- [All] - [games.rb] bugfix: prevent race condition in games thread #656
-o- [All] - [init.rb] bugfix: address WINE variance between linux / installs #655
-o- [GS4] - [gs][stash.rb] bugfix: wear code improvement #657
</PRE>
'''5.10.0'''
<PRE>
-o- [All] - [main.rb] bugfix: correct encoding for WizardFE PR #640
-o- [All] - [games.rb] bugfix: correct logic for room detection when using CLI --start-scripts PR #639
-o- [All] - [DB_Store.rb] feat: add direct support for Simu RENAME and CHANGE PROF PR #633
-o- [All] - chore: breakout code to individual files for easier management PR #617
-o- [All] - [lich.rbw] chore: add deprecated msg to old Settings/GameSettings/CharSettings methods PR #589
-o- [All] - [lich.rbw] feat: add new --dark-mode CLI option PR #583
-o- [All] - [global_defs.rb] bugfix: monsterbold fix for additional clients PR #581
-o- [All] - [update.rb] feat: update core scripts from source on Lich5 update/install PR #579
-o- [All] - [log.rb] feat: add new Log module copied from Olib PR #577
-o- [All] - [numeric.rb] feat: add days/hours/minutes/seconds methods to numerics PR #623
-o- [All] - [messaging.rb] feat: WizardFE Voln window support #647
-o- [All] - [init.rb] bugfix: WINE entries for Linux / MacOS #649
-o- [DR] - [lich.rbw] bugfix: cleanup downstream hook exclusions PR #593
-o- [DR] - [global_defs.rb] bugfix: missing climb failure message PR #592
-o- [GS4] - [effects.rb] bugfix: show non-standard Effects in `;magic` output PR #641
-o- [GS4] - [parser.rb] bugfix: fix WARCRY duplication results / add WALL OF THORNS effect detection PR #634 / PR #637
-o- [GS4] - [critranks.rb] feat: add critical rank resolution tables and methods PR #625
-o- [GS4] - [effects.rb] bugfix: to support regex for active? & time_left PR #590
-o- [GS4] - [infomon.rb] bugfix: add implicit NPC death monitoring PR #588
-o- [GS4] - [infomon.rb] bugfix: change PSM to be stored as type.mnemonic PR #587
-o- [GS4] - [lich.rbw] bugfix: strip_xml multiline fix PR #584
-o- [GS4] - [stash.rb] bugfix: fix sack detection to use Stash.container(param) PR #578
-o- [GS4] - [spell.rb] feat: Spell.after_stance #644
-o- [GS4] - [xmlparser.rb] bugfix: for Claim module #646
-o- [GS4] - [infomon] feat: track Voln favor via RESOURCE output #648
-o- [GS4] - [gameobj.rb] feat: add Bandit hidden target API #650
</PRE>
'''5.9.2'''
<PRE>
-o- [GS4] - [group.rb] bugfix: proper leader detection from GROUP output
-o- [GS4] - [char.rb] bugfix: add back depracted Char.maxvitals with msging to switch to new Char.max_vitals methods
</PRE>
'''5.9.1'''
<PRE>
-o- [GS4] - [group.rb] bugfix: group.check syntax change
-o- [GS4] - [spell.rb] bugfix: affordable? Char.mana parenthesis logic
</PRE>
'''5.9.0'''
<PRE>
-o- [All] - feat: sqlite3 gem syntax code cleanup PR#553
-o- [All] - [lich.rbw] bugfix: remove unused Setting, GameSetting, CharSetting PR#542
-o- [All] - [lich.rbw] bugfix: scrub login key from error message popups PR#548
-o- [All] - [messaging.rb] bugfix: color mismatch WizardFE white txt PR#554
-o- [All] - [lich.rb] feat: add new Lich.deprecated method to aid in deprecating older API calls PR#523
-o- [GS4] - [char.rb] feat: log method_missing calls PR#552
-o- [GS4] - [char.rb] feat: add missing global_def related methods PR#523
-o- [GS4] - [global_defs.rb] feat: deprecate various Char module methods PR#523
-o- [GS4] - [spellsong.rb] bugfix: cache spellsong duration calc PR#551
-o- [GS4] - [effects.rb] feat: Effects module breakout PR#549
-o- [GS4] - [group.rb][disk.rb] feat: Group & Disk class PR#532
-o- [GS4] - [activespell.rb] feat: add duration change messaging, off by default, see ;help for details PR#487
</PRE>
'''5.8.1'''
<PRE>
-o- [All] - [lich.rbw] feat: add Game:Character to debug log file ouput
-o- [All] - [init.rb] feat: add milliseconds to debug filename
-o- [GS4] - [lich.rbw] bugfix: reorder parsing of $SERVERSTRING to avoid certain conflicts
-o- [GS4] - [parser.rb] bugfix: update for new Empath resource and sleep/bind messaging
-o- [GS4] - [status.rb] bugfix: bound? calmed? and sleeping? support for spellnames flag being off
-o- [GS4] - [xmlparser.rb] bugfix: additional creature dying messaging to check against XML dead not being sent
-o- [GS4] - [gameobj.rb] bugfix: remove sorcerer arms and animates from GameObj.targets
</PRE>
'''5.8.0'''
<PRE>
-o- [All] - Ruby 3.3 compatibility
-o- [All] - [lich.rbw] feat: adds .sources for up/downstream hooks
-o- [All] - [lich.rbw] bugfix: don't use WINE for custom frontends
-o- [GS4] - [char.rb] bugfix: add back Char.stance
-o- [GS4] - [claim.rb] feat: new module and associated changes to xmlparser
-o- [GS4] - [experience.rb] feat: percent experience options
-o- [GS4] - [parser.rb] bugfix: allow for negative TNL exp value
-o- [GS4] - [parser.rb] bugfix: allow hyphenated last names in character names
-o- [GS4] - [parser.rb] feat: update resource matching for new Bard service
-o- [GS4] - [stash.rb] bugfix: catch more shield removal messages
-o- [GS4] - [util.rb] bugfix: underscore issue for PSMs
</PRE>
'''5.7.0'''
<PRE>
-o- Supports Ruby 3.2 - security enhancements and huge speed improvements for regex
-o- New libraries/modules/classes: Account, HMR (Hot Module Reloading)
-o- GS4 Infomon now baked into Lich5 as a library, no more need to run standalone script
-o- New GS4 libraries/modules/classes: Ascension, Bounty, Currency, Experience, Resources, Society, Status, Warcry
-o- Updates to existing libraries/modules/classes: Armor, Util, Weapon, Spell, GameObj, Messaging
-o- Several Bugfixes for lots of things
-o- Lots of code cleanup
</PRE>
'''5.6.2'''
<PRE>
-o- Fix for XML errors
-o- Adds the DR Plat instance for Frostbite FE
-o- Adds ‘ball’ as the noun used for ‘ball and chain’
-o- Adds the movement result ‘slip in the mud and fall flat’
-o- Corrects stamina cost for the feature Dispel Magic
-o- Plus all the latest script updates from Elanthia-Online!
</PRE>
'''5.6.1'''
<PRE>
-o- Fix for XML to limit login errors (DR)
-o- Fix for XMLData.active_spells to properly register wizard 'recovery' spell cooldowns
-o- Messaging updates to remove error in Wizard FE encodings
-o- Corrects for error in detecting PSM skill changes (cman) via warrior / rogue guild lessons
-o- Deprecates LNet script from master repository
-o- Miscellaneous small bug squashing
</PRE>

'''5.6.0'''
<PRE>
-o- (DragonRealms) Support for Genie and Frostbite frontends
-o- (GemStone) Changed methods to improve ;go2 speed and reduce lich.db3 calls
-o- (GemStone) Updates to support silver_count function
-o- (Both) Changed method for updating lich ecosystem
</PRE>

'''5.5.0'''
<PRE>
-o- Support for DragonRealms
-o- Updated support for scripts like BigShot
-o- Providing the LichID and UID on Profanity
-o- Spell.force_incant, .force_channel, and .force_evoke
-o- Standardized message method for script authors
-o- Sundry small improvements / fixes and changes
-o- And the creme de la creme - a custom directory
</PRE>

'''5.4.0'''
<PRE>
-o- Simu Room IDs (formally called 'unique ID' or 'uid' for Lich) added to Map, mapDB where known, and ;go2 for navigation (courtesy Xanlin and with our thanks!) ;go2 u7120 for all you ex-GMs out there.
-o- Room titles will now display the Lich ID and / or the UID for the room based on user selections - default is on for both, and enabled / disabled via Lich.display_lichid or Lich.display_uid toggles that can be set to on / off or true / false. (;e Lich.display_lichid=true/false and ;e Lich.display_uid=true/false) You can remove that rnum from your autostart now! To gain the benefit of the UID deployment, be sure to ;repo download-mapdb
-o- REQUESTS: Drop 5 minute timeout function from Lich
-o- waitrt? and waitcastrt? will still pause activities, but will return TRUE or FALSE in keeping with the Ruby functionname? tradition (no more failing to get a weapon out due to RT from climbing!)
-o- empty_hands and fill_hands will now check to see if the character is in roundtime before trying to put away or retrieve held items
-o- Infomon received an update that keeps spell timers in sync with the information received from the server - no more need to immediately do a spell active in game to get the right times to display for various legacy scripts and ;magic after visiting the invoker or using an SK item
-o- Lich now provides a facility to get current coins on the character that is a bit more agnostic to data changes from Simu - Lich::Util.silver_count
-o- Various other small tidbits to help ease maintenance and future development
-o- PLEASE NOTE: This update is required for the newest Bigshot (released today!) and for future eloot and eherbs scripts (release RSN)
</PRE>

'''5.3.0'''
<PRE>
-o- Added support for Wrayth (renamed Stormfront) installations
-o- Converted Linux | WINE login methods to 'method 0', does not use Simu launcher
</PRE>

'''5.2.1'''
<PRE>
-o- Support for STOWing items irrespective of special item scripts
-o- Improved query support for Effects and CMans
-o- Fix Lich bug to respect the 'groupmovement' flag in game
-o- Fix Lich round time calculations (more aggressive timing)
-o- Dark Mode is now a thing
-o- Lich4 Style GUI layout available
-o- Several file location changes to support future code change efforts
</PRE>

'''5.0.19'''
<PRE>
-o- Benefit: Monks with Mental Acuity (all 3 of you) rejoice - stamina casting!
-o- Benefit: PSM3 included, no charge. No hair remaining, either!
-o- Benefit: Ok, stay seated: Some of your various SF spell duration windows may work. . . better? Yes, not perfect, but better. No pictures, please!
-o- Updated infomon that properly detects Cloak of Shadows on those pesky sorcerers, and the Raise Dead Cooldown periods for those wondrous clerics.
-o- A new update process for Lich 5 - tired of having to download that script over and over just to update? Get yourself a copy of lich5-update.lic. Note, if you already have it, you're set! If not - ;jinx script install lich5-update --repo=elanthia-online
</PRE>

'''5.0.11'''
<PRE>
-o- Updated the method used to log onto SIMU servers.
-o- Added the Animalist item specifics to Lich5's empty and fill hands routines
-o- Improved Invoker messages for Avalon and Wizard FEs (no change for SF FE)
-o- Improved cleanup and store methods when player EXIT's or QUIT's game
-o- Crafted two new methods (stash_hands and equip_hands) for future script use
-o- Some behind-the-scenes cleanup to improve maintaining the Lich5 ecosystem
-o- Add Spell Active improvements
-o- Add PSM and Ranger improvements
</PRE>
</div>

=Resources=
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:New Player]]

Lich:Software/Installation

2025-06-24T21:45:44Z

DOUG: /* Installing the Latest Stable Release */

{{3rd-party}}
=About=

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Wrayth or Wizard FE. Lich is also used by many on both MacOS and multiple Linux distributions.

=Installing the Latest Stable Release=

'''The latest stable lich version is 5.12.0 supporting Ruby 3.4 - published June 24, 2025'''

==In-Place Upgrade==

If you are on an older version of Lich 5 and want to upgrade to the most current version, you can choose to either upgrade Lich5 only or both Lich 5 and Ruby. If you're currently on Lich 4, able to check by running the command <CODE>;e echo LICH_VERSION</CODE>, go to the [[#Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)|upgrade from Lich 4 section]].

For each section, please follow the directions/commands one at a time.

===Lich 5 Only===

====Lich 5.6.0 or newer====
# '''Backup existing Lich 5 folder'''
# Run this command in-game <CODE>;lich5-update --library=update.rb</CODE>
# Quit and restart lich.
# Run this command in-game <CODE>;lich5-update --update</CODE>
# Quit and restart lich.
# Congratulations - you're now running on the latest version of Lich!

====Lich 5.5 or older====
Does not work for Lich 4 upgrades, please do a full new install if on Lich 4.
# '''Backup existing Lich 5 folder'''
# Run this command in-game <CODE>;lich5-update --snapshot</CODE>
# Quit and close out of the game.
# Download the full release [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip lich-5.zip]
# Extract the zip file over your existing Lich5 installation, choosing to overwrite existing files.
# Restart lich.
# Congratulations - you're now running on the latest version of Lich!

===Both Ruby 3.4 & Lich 5===
This method is for Windows only. Linux and MacOS users, please do a Lich 5 only update and update Ruby manually via normal install/update methods for the OS.

# Logout of all characters
# '''Backup existing Lich 5 folder'''
# Uninstall existing Ruby4Lich5 installs from Programs & Features control panel, or alternatively, rename your existing Ruby4Lich5 folder to Ruby4Lich5save. (Defaults to C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer]
# Run the installer and be sure to have both Ruby and Lich 5 option selected
# Congratulations - you're now running on the latest version of Lich & Ruby!

===Ruby 3.4 Only===
Use this to upgrade to the newest version of Ruby only if you're already on the latest version of Lich5 and now want to update Ruby afterwards. If you're not already on the latest version of Lich5, please use previous section steps instead.
# Logout of all instances/characters
# '''Backup existing Lich 5 folder'''
# Uninstall your existing Ruby4Lich5 install via Programs & Features (ensure it's now gone, default location was C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer]
# Run the new installer and choose to only install Ruby Only
# Congratulations - you're now running on the latest version Ruby!

==Windows New Installation==

{{blue|These instructions are not for DragonRealms. [[#Ecosystem Information|For those scroll to the bottom]].}}

'''For Windows 11 / 10 / 8 / 7''' users: you can download the [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer] and install everything you need automatically. Click on the '''Ruby4Lich5.exe''' and download it to your computer then double click on the executable in your default download folder. Note, a user may need to adjust their browser or security settings to allow download and installation.
If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

===New Installation for Lich 5 (11/14/2023)===

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The Wrayth FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.

===Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)===

This option is deprecated. Lich 5 architectures are not compatible with Lich 4. Back up your existing Lich 4 folder, uninstall any existing Ruby executables, and then follow the instructions for a new install above.

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

==MacOS==
There two common options for playing Gemstone IV on a Mac is either to play natively with Avalon or to use virtualization software such as Parallels with Wrayth/WizardFE. Below are the options on how to do that.

===Native Avalon===
Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help. This process works well for Mac OS Catalina and Big Sur. If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Parallels Windows===
'''The following only pertains to Apple Silicon based Macs. If you have an Intel based Mac, you can use the normal Windows installation procedures instead.'''

To install Wrayth/WizardFE, Lich, and Ruby via Parallels you will need to do a few various steps as outlined below. Please note, the rubyw file in C:\Ruby4Lich5\X.X.X\bin may be set to run in compatibility mode for windows 7. On an ARM Mac running parallels, this causes Wrayth scripts not to run. Turning compatibility mode off in the rubyw file fixes this issue if it was enabled.

<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
The following steps are to be done AFTER you've successfully installed Wrayth/WizardFE and can login normally without Lich5 on the machine. Once you've done that and can successful connect normally, then follow these steps:
# Download and install [https://github.com/oneclick/rubyinstaller2/releases/download/RubyInstaller-3.4.3-1/rubyinstaller-devkit-3.4.3-1-x86.exe Ruby 3.4.3 x86 (32bit) Installer] and use default options presented during install
# Open a Command Prompt and issue the following command to install the necessary gems, this process will take awhile (at least 30 mins)<pre>gem install ascii_charts concurrent-ruby curses ftools gtk3 json jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r --no-document</pre>
# Download and extract the Lich5 latest [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip lich-5.zip] to somewhere you want it stored (usually desktop)
# Double click the lich.rbw file that is now located in the extracted Lich5 location you did above. Login and play as usual.
</div>

==Chromebook & Debian variants==
<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Wrayth).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential curl libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev git unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 3.3.5 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 3.4.3 -v
rbenv global 3.4.3
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r
</pre>

If you wish to use LNet with newer versions of Ruby, you'll need to downgrade the default version of REXML to be 3.3.1 or older due to Tillmen's LNet server not supporting the newer version currently:
<pre>
gem install rexml:'<3.3.2' && gem uninstall rexml:'>3.3.1'
</pre>

Install Lich and Profanity:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.
</div>

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora 38 & 39 use Ruby 3.2.2, while Fedora 40 uses Ruby 3.3.0. All of which are currently compatible with Lich 5.7.0 or higher.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison curl gcc gdbm gdbm-devel glib2-devel gobject-introspection-devel \
libyaml-devel libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
$ gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r
</pre>

4. Download Lich & Profanity:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>
</div>

=Popular Scripts=
{{#section:Lich:Script Repository|popularscripts}}

=Ecosystem Information=

* DragonRealms Variant - [https://elanthipedia.play.net/Lich_script_repository#Setup_and_Installation Setup and Install instructions]

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.11.1''' (current)
<PRE>
- fix(all): restore @theme_state and add to CLI capability #795
- fix(all): retire gtk2 monkey patch for gtk3 #823
- fix(all): games.rb XMLData.name wait till both not NIL and not EMPTY #826
- fix(all): standardize xmlparser game instance #827
- fix(all): games.rb fix multiple single and double quote in XML #832,836,837
- fix(dr): games.rb - optional hide Room Title display of Real IDs with FLAG on #782
- chore(dr): common-moonmage - refactor of peer_telescope #783
- fix(dr): move HMR load to common before for dragonrealms #784
- fix(dr): common-crafting.rb minor edit to add "You tuck" #787
- fix(dr): common-arcana.rb - remove unecessary pause from discern code #792
- fix(dr): drparser.rb Restore Premium status checking #834
- fix(gs): migrate PSMS.name_normal to Lich::Util.normalize_name #790,833
- fix(gs): add Char.che to know current character's CHE #791
- fix(gs): FEAT and Infomon module parsing of new Covert Art feats. #796
- fix(gs): add Currency.gemstone_dust and fix redsteel mark capture #797
- fix(gs): FEAT Covert Arts colon normalization and stamina costs #799
- fix(gs): escape dash in regex for HouseCHE #824
- fix(gs): disk.rb comparison helpers #828
- fix(gs): allow for Group.disks to show self disk in array #829
- fix(gs): feat.rb Covert Arts throw poison costs 15 stam #830
- fix(gs): add missing Feat.use ability #831
- fix(gs): multiple CritRanks updates #801-822
</PRE>
'''5.11.0'''
<PRE>
- [all] - chore: Namespace & File Path Updates #713
- [all] - [argv_options.rb] bugfix: correct darkmode to work via CLI #693
- [all] - [games.rb] feat: make show Room Exits of non-StringProc/Obvious Exits toggable for all games #699
- [all] - [games.rb] feat: toggleable display of StringProcs with clickable links #751
- [all] - [gui-manual-login.rb] fix: change label to Wrayth #720
- [all] - [gui-saved-login.rb] fix: update Stormfront label #721
- [all] - [update.rb] fix: purge old LIB folder prior to update release #729
- [all] - [util.rb] bugfix: allow issue_command to use fput or put #715
- [all] - [xmlparser.rb] feat: add XMLData.room_name attribute #685
- [all] - [main.rb] fix: create session file in regular connect method #733
- [all] - [init.rb] bugfix: error for Windows DISPLAY variable #735
- [all] - [main.rb] fix: Mudlet support #736
- [all] - [wine.rb] fix: add --no-wine CLI flag prevent WINE startup
- [all] - [init.rb] fix: add --no-gtk CLI flag prevent GTK3 gem load
- [dr] - [games.rb] feat: DRinfomon and common files as core lich libraries #686
- [dr] - [games.rb] chore: add DR requires here #690
- [dr] - [games.rb] fix: add Room# display for DR #697
- [dr] - [games.rb] bugfix: Genie FE real ID#s not supported, hide by default #728
- [dr] - [drdefs.rb] bugfix: fix for Shadow Servants #710
- [dr] - [map_dr.rb] fix: cleanup and support for UIDs #719
- [dr] - [xmldata.rb] bugfix: add support for DR Room IDs #716
- [dr] - [xmlparser.rb] feat: XMLData - adding dr_active_spells #691
- [gs] - [games.rb] bugfix: support for pre/post room name txt #683
- [gs] - [group.rb] chore: update to account for hold #701
- [gs] - [resource.rb] feat: add additional tracking of covert art charges #714
- [gs] - [spell.rb] bugfix: Spell.affordable? 515 release #687
- [gs] - [stash.rb] bugfix: sheath_bags when not found #694
- [gs] - [xmlparser.rb] bugfix: missing real ID in nav #684
- [gs] - [xmlparser.rb] bugfix: Claim module obvious hiding #717
- [gs] - [sk.rb] feat: Self-Knowledge functionality in core #748
</PRE>
'''5.10.4'''
<PRE>
-o- [GS4] - [xmlparser.rb] bugfix: Simu XML breaking change RoomID #679
</PRE>
'''5.10.3'''
<PRE>
-o- [GS4] - [crit_tables] fix: CritRanks regex fixes (multiple files and changes) #671
-o- [GS4] - [spellsong.rb] fix: Correct Spellsong sync method #674
-o- [GS4] - [parser.rb] fix: thorn status regex correction #673
-o- [All] - [xmlparser.rb] fix: Split out if elif block to account for DR having multiple… #670
-o- [All] - [global_defs.rb] fix: percentconcentration #676
-o- [All] - [global_defs.rb] fix: update move failure message to handle attack and casting #667
-o- [All] - [init.rb] fix: update required ruby check messaging #669
-o- [All] - [sessionvars.rb] feat: new module SessionVars for non-persistent variable storage #666
</PRE>
'''5.10.2'''
<PRE>
-o- [DR] - [games.rb] bugfix: tweak XML rewrite section #662
-o- [GS4] - [crit_tables] bugfix: additional crit table regex corrections #663
-o- [GS4] - [ascension.rb] bugfix: add new Transcend Destiny to lookups #661
-o- [GS4] - [effects.rb] bugfix: regexp escape txt #660
-o- [GS4] - [disruption_critical_table.rb] Bugfix in regex #659
</PRE>
'''5.10.1'''
<PRE>
-o- [All] - [games.rb] bugfix: prevent race condition in games thread #656
-o- [All] - [init.rb] bugfix: address WINE variance between linux / installs #655
-o- [GS4] - [gs][stash.rb] bugfix: wear code improvement #657
</PRE>
'''5.10.0'''
<PRE>
-o- [All] - [main.rb] bugfix: correct encoding for WizardFE PR #640
-o- [All] - [games.rb] bugfix: correct logic for room detection when using CLI --start-scripts PR #639
-o- [All] - [DB_Store.rb] feat: add direct support for Simu RENAME and CHANGE PROF PR #633
-o- [All] - chore: breakout code to individual files for easier management PR #617
-o- [All] - [lich.rbw] chore: add deprecated msg to old Settings/GameSettings/CharSettings methods PR #589
-o- [All] - [lich.rbw] feat: add new --dark-mode CLI option PR #583
-o- [All] - [global_defs.rb] bugfix: monsterbold fix for additional clients PR #581
-o- [All] - [update.rb] feat: update core scripts from source on Lich5 update/install PR #579
-o- [All] - [log.rb] feat: add new Log module copied from Olib PR #577
-o- [All] - [numeric.rb] feat: add days/hours/minutes/seconds methods to numerics PR #623
-o- [All] - [messaging.rb] feat: WizardFE Voln window support #647
-o- [All] - [init.rb] bugfix: WINE entries for Linux / MacOS #649
-o- [DR] - [lich.rbw] bugfix: cleanup downstream hook exclusions PR #593
-o- [DR] - [global_defs.rb] bugfix: missing climb failure message PR #592
-o- [GS4] - [effects.rb] bugfix: show non-standard Effects in `;magic` output PR #641
-o- [GS4] - [parser.rb] bugfix: fix WARCRY duplication results / add WALL OF THORNS effect detection PR #634 / PR #637
-o- [GS4] - [critranks.rb] feat: add critical rank resolution tables and methods PR #625
-o- [GS4] - [effects.rb] bugfix: to support regex for active? & time_left PR #590
-o- [GS4] - [infomon.rb] bugfix: add implicit NPC death monitoring PR #588
-o- [GS4] - [infomon.rb] bugfix: change PSM to be stored as type.mnemonic PR #587
-o- [GS4] - [lich.rbw] bugfix: strip_xml multiline fix PR #584
-o- [GS4] - [stash.rb] bugfix: fix sack detection to use Stash.container(param) PR #578
-o- [GS4] - [spell.rb] feat: Spell.after_stance #644
-o- [GS4] - [xmlparser.rb] bugfix: for Claim module #646
-o- [GS4] - [infomon] feat: track Voln favor via RESOURCE output #648
-o- [GS4] - [gameobj.rb] feat: add Bandit hidden target API #650
</PRE>
'''5.9.2'''
<PRE>
-o- [GS4] - [group.rb] bugfix: proper leader detection from GROUP output
-o- [GS4] - [char.rb] bugfix: add back depracted Char.maxvitals with msging to switch to new Char.max_vitals methods
</PRE>
'''5.9.1'''
<PRE>
-o- [GS4] - [group.rb] bugfix: group.check syntax change
-o- [GS4] - [spell.rb] bugfix: affordable? Char.mana parenthesis logic
</PRE>
'''5.9.0'''
<PRE>
-o- [All] - feat: sqlite3 gem syntax code cleanup PR#553
-o- [All] - [lich.rbw] bugfix: remove unused Setting, GameSetting, CharSetting PR#542
-o- [All] - [lich.rbw] bugfix: scrub login key from error message popups PR#548
-o- [All] - [messaging.rb] bugfix: color mismatch WizardFE white txt PR#554
-o- [All] - [lich.rb] feat: add new Lich.deprecated method to aid in deprecating older API calls PR#523
-o- [GS4] - [char.rb] feat: log method_missing calls PR#552
-o- [GS4] - [char.rb] feat: add missing global_def related methods PR#523
-o- [GS4] - [global_defs.rb] feat: deprecate various Char module methods PR#523
-o- [GS4] - [spellsong.rb] bugfix: cache spellsong duration calc PR#551
-o- [GS4] - [effects.rb] feat: Effects module breakout PR#549
-o- [GS4] - [group.rb][disk.rb] feat: Group & Disk class PR#532
-o- [GS4] - [activespell.rb] feat: add duration change messaging, off by default, see ;help for details PR#487
</PRE>
'''5.8.1'''
<PRE>
-o- [All] - [lich.rbw] feat: add Game:Character to debug log file ouput
-o- [All] - [init.rb] feat: add milliseconds to debug filename
-o- [GS4] - [lich.rbw] bugfix: reorder parsing of $SERVERSTRING to avoid certain conflicts
-o- [GS4] - [parser.rb] bugfix: update for new Empath resource and sleep/bind messaging
-o- [GS4] - [status.rb] bugfix: bound? calmed? and sleeping? support for spellnames flag being off
-o- [GS4] - [xmlparser.rb] bugfix: additional creature dying messaging to check against XML dead not being sent
-o- [GS4] - [gameobj.rb] bugfix: remove sorcerer arms and animates from GameObj.targets
</PRE>
'''5.8.0'''
<PRE>
-o- [All] - Ruby 3.3 compatibility
-o- [All] - [lich.rbw] feat: adds .sources for up/downstream hooks
-o- [All] - [lich.rbw] bugfix: don't use WINE for custom frontends
-o- [GS4] - [char.rb] bugfix: add back Char.stance
-o- [GS4] - [claim.rb] feat: new module and associated changes to xmlparser
-o- [GS4] - [experience.rb] feat: percent experience options
-o- [GS4] - [parser.rb] bugfix: allow for negative TNL exp value
-o- [GS4] - [parser.rb] bugfix: allow hyphenated last names in character names
-o- [GS4] - [parser.rb] feat: update resource matching for new Bard service
-o- [GS4] - [stash.rb] bugfix: catch more shield removal messages
-o- [GS4] - [util.rb] bugfix: underscore issue for PSMs
</PRE>
'''5.7.0'''
<PRE>
-o- Supports Ruby 3.2 - security enhancements and huge speed improvements for regex
-o- New libraries/modules/classes: Account, HMR (Hot Module Reloading)
-o- GS4 Infomon now baked into Lich5 as a library, no more need to run standalone script
-o- New GS4 libraries/modules/classes: Ascension, Bounty, Currency, Experience, Resources, Society, Status, Warcry
-o- Updates to existing libraries/modules/classes: Armor, Util, Weapon, Spell, GameObj, Messaging
-o- Several Bugfixes for lots of things
-o- Lots of code cleanup
</PRE>
'''5.6.2'''
<PRE>
-o- Fix for XML errors
-o- Adds the DR Plat instance for Frostbite FE
-o- Adds ‘ball’ as the noun used for ‘ball and chain’
-o- Adds the movement result ‘slip in the mud and fall flat’
-o- Corrects stamina cost for the feature Dispel Magic
-o- Plus all the latest script updates from Elanthia-Online!
</PRE>
'''5.6.1'''
<PRE>
-o- Fix for XML to limit login errors (DR)
-o- Fix for XMLData.active_spells to properly register wizard 'recovery' spell cooldowns
-o- Messaging updates to remove error in Wizard FE encodings
-o- Corrects for error in detecting PSM skill changes (cman) via warrior / rogue guild lessons
-o- Deprecates LNet script from master repository
-o- Miscellaneous small bug squashing
</PRE>

'''5.6.0'''
<PRE>
-o- (DragonRealms) Support for Genie and Frostbite frontends
-o- (GemStone) Changed methods to improve ;go2 speed and reduce lich.db3 calls
-o- (GemStone) Updates to support silver_count function
-o- (Both) Changed method for updating lich ecosystem
</PRE>

'''5.5.0'''
<PRE>
-o- Support for DragonRealms
-o- Updated support for scripts like BigShot
-o- Providing the LichID and UID on Profanity
-o- Spell.force_incant, .force_channel, and .force_evoke
-o- Standardized message method for script authors
-o- Sundry small improvements / fixes and changes
-o- And the creme de la creme - a custom directory
</PRE>

'''5.4.0'''
<PRE>
-o- Simu Room IDs (formally called 'unique ID' or 'uid' for Lich) added to Map, mapDB where known, and ;go2 for navigation (courtesy Xanlin and with our thanks!) ;go2 u7120 for all you ex-GMs out there.
-o- Room titles will now display the Lich ID and / or the UID for the room based on user selections - default is on for both, and enabled / disabled via Lich.display_lichid or Lich.display_uid toggles that can be set to on / off or true / false. (;e Lich.display_lichid=true/false and ;e Lich.display_uid=true/false) You can remove that rnum from your autostart now! To gain the benefit of the UID deployment, be sure to ;repo download-mapdb
-o- REQUESTS: Drop 5 minute timeout function from Lich
-o- waitrt? and waitcastrt? will still pause activities, but will return TRUE or FALSE in keeping with the Ruby functionname? tradition (no more failing to get a weapon out due to RT from climbing!)
-o- empty_hands and fill_hands will now check to see if the character is in roundtime before trying to put away or retrieve held items
-o- Infomon received an update that keeps spell timers in sync with the information received from the server - no more need to immediately do a spell active in game to get the right times to display for various legacy scripts and ;magic after visiting the invoker or using an SK item
-o- Lich now provides a facility to get current coins on the character that is a bit more agnostic to data changes from Simu - Lich::Util.silver_count
-o- Various other small tidbits to help ease maintenance and future development
-o- PLEASE NOTE: This update is required for the newest Bigshot (released today!) and for future eloot and eherbs scripts (release RSN)
</PRE>

'''5.3.0'''
<PRE>
-o- Added support for Wrayth (renamed Stormfront) installations
-o- Converted Linux | WINE login methods to 'method 0', does not use Simu launcher
</PRE>

'''5.2.1'''
<PRE>
-o- Support for STOWing items irrespective of special item scripts
-o- Improved query support for Effects and CMans
-o- Fix Lich bug to respect the 'groupmovement' flag in game
-o- Fix Lich round time calculations (more aggressive timing)
-o- Dark Mode is now a thing
-o- Lich4 Style GUI layout available
-o- Several file location changes to support future code change efforts
</PRE>

'''5.0.19'''
<PRE>
-o- Benefit: Monks with Mental Acuity (all 3 of you) rejoice - stamina casting!
-o- Benefit: PSM3 included, no charge. No hair remaining, either!
-o- Benefit: Ok, stay seated: Some of your various SF spell duration windows may work. . . better? Yes, not perfect, but better. No pictures, please!
-o- Updated infomon that properly detects Cloak of Shadows on those pesky sorcerers, and the Raise Dead Cooldown periods for those wondrous clerics.
-o- A new update process for Lich 5 - tired of having to download that script over and over just to update? Get yourself a copy of lich5-update.lic. Note, if you already have it, you're set! If not - ;jinx script install lich5-update --repo=elanthia-online
</PRE>

'''5.0.11'''
<PRE>
-o- Updated the method used to log onto SIMU servers.
-o- Added the Animalist item specifics to Lich5's empty and fill hands routines
-o- Improved Invoker messages for Avalon and Wizard FEs (no change for SF FE)
-o- Improved cleanup and store methods when player EXIT's or QUIT's game
-o- Crafted two new methods (stash_hands and equip_hands) for future script use
-o- Some behind-the-scenes cleanup to improve maintaining the Lich5 ecosystem
-o- Add Spell Active improvements
-o- Add PSM and Ranger improvements
</PRE>
</div>

=Resources=
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:New Player]]

Lich:Software/Mac Installation

2025-06-24T21:38:32Z

DOUG: /* The Process */

{{3rd-party}}
To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install gobject-introspection</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 3.4.4</code>
# <code>rbenv global 3.4.4</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 3.4.4 (2025-02-15 revision d2930f8e7a) [arm64-darwin22]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin22]</code>
seek assistance (restarting the terminal you used to run commands up to this point may be required for `ruby -v` to show the proper, updated version of ruby).

The key is the ruby 3.4.4 part -> it needs to read 3.4.4

'''3.4.4 is expected'''. If your version reflects 3.4.4, proceed to the next steps. Enter these commands, one at a time, and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install ascii_charts concurrent-ruby curses gtk3 jwt logger mechanize nokogiri redis sequel sqlite3 terminal-table tomlib tzinfo tzinfo-data webrick xmpp4r --no-document</code>
Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

No guides are available at this time, please email doug@play.net for help.

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}

Lich:Software/Installation

2024-10-17T17:59:50Z

DOUG: /* Installing the Latest Stable Release */

Lich:Software/Installation

2024-10-14T18:24:14Z

DOUG: /* Installing the Latest Stable Release */

User:DOUG/Sandbox Lich API

2024-08-28T20:50:11Z

DOUG:

Place holder of limited intent

Sample 1 style

{| {{verbtable|90}}
|- {{verbtableheader}}
! scope="col" | Library
! scope="col" style="width: 30%" | API spec
! scope="col" style="width: 20%" | Return
! scope="col" style="width: 50%" | Information
|-
! scope="row" role="rowheader"|Infomon
| Infomon.sync
| T / F
| Immediately refreshes all information held by Infomon.
|-
! scope="row" role="rowheader"|Infomon
| Infomon.redo!
| T / F
| Destructive - deletes char table, recreates it, then repopulates it.
|-
! scope="row" role="rowheader"|Infomon
| Infomon.show
| Text rows
| Displays all populated information stored by Infomon.
|-
! scope="row" role="rowheader"|Infomon
| Infomon.show(full=true)
| Text rows
| Displays all information stored or possible by Infomon.
|-
! |
|-
! scope="row" role="rowheader"|Status
| Status.thorned?
| T / F
| Currently suffering from Wall of Thorns poisoning,
|-
! scope="row" role="rowheader"|Status
| Status.bound?
| T / F
| Currently bound or under similar effect.
|-
! scope="row" role="rowheader"|Status
| Status.calmed?
| T / F
| Currently calmed or under similar effect.
|-
! scope="row" role="rowheader"|Status
| Status.cutthroat?
| T / F
| Currently suffering from a cutthroat (rogue) effect.
|-
! scope="row" role="rowheader"|Status
| Status.silenced?
| T / F
| Currently silenced or under similar effect.
|-
! scope="row" role="rowheader"|Status
| Status.sleeping?
| T / F
| Currently slept or under similar effect.
|-
! scope="row" role="rowheader"|Status
| Status.webbed?
| T / F
| Currently webbed.
|-
! scope="row" role="rowheader"|Status
| Status.stunned?
| T / F
| Currently stunned.
|-
! scope="row" role="rowheader"|Status
| Status.dead?
| T / F
| Currently supine with no respiratory activity detectable.
|-
! scope="row" role="rowheader"|Status
| Status.muckled?
| T / F
| Suffering any of these - webbed?, bound?, sleeping?, stunned?, dead?
|}

User:DOUG/Sandbox Lich API

2024-08-28T20:20:37Z

DOUG:

Place holder of limited intent

Sample 1 style

{| {{verbtable|90}}
|- {{verbtableheader}}
! scope="col" | Library
! scope="col" style="width: 35%" | Use
! scope="col" style="width: 65%" | Return
|-
! scope="row" role="rowheader"|Infomon
| Infomon.sync
| Immediately refreshes all information held by Infomon.
|-
! scope="row" role="rowheader"|Infomon
| Infomon.redo!
| Destructive - deletes char table, recreates it, then repopulates it.
|-
! scope="row" role="rowheader"|Infomon
| Infomon.show or Infomon.show(full=true)
| Displays all non-zero information stored by Infomon. Full displays all values 0 or not.
|}

User:DOUG/Sandbox Lich API

2024-08-28T20:05:05Z

DOUG: Created page with "Place holder of limited intent"

Place holder of limited intent

User:DOUG/Sandbox Colors Test

2024-08-28T18:12:42Z

DOUG:

Let's overload prettytable and look at various color combos.

{|
! Standard||style="background-color: #AAA;"|Standard||style="background-color: #BBB;"|Standard||style="background-color: #CCC;"|Standard||style="background-color: #DDD"|Standard||style="background-color: #EEE;"|Standard||style="background-color: #FFF;"|Standard||style="background-color: #111;"|Standard||style="background-color: #222;"|Standard||style="background-color: #333;"|Standard||style="background-color: #444"|Standard||style="background-color: #555;"|Standard||style="background-color: #666;"|Standard||style="background-color: #777;"|Standard||style="background-color: #888;"|Standard||style="background-color: #999;"|Standard||style="background-color: #000"|Standard
|-
|Color||style="background-color: #BAA;"|Color||style="background-color: #BBB;"|Color||style="background-color: #BCC;"|Color||style="background-color: #BDD"|Color||style="background-color: #BEE;"|Color||style="background-color: #BFF;"|Color||style="background-color: #B11;"|Color||style="background-color: #B22;"|Color||style="background-color: #B33;"|Color||style="background-color: #B44"|Color||style="background-color: #B55;"|Color||style="background-color: #B66;"|Color||style="background-color: #B77;"|Color||style="background-color: #B88;"|Color||style="background-color: #B99;"|Color||style="background-color: #B00"|Color
|-
|Color||style="background-color: #CAA;"|Color||style="background-color: #CBB;"|Color||style="background-color: #CCC;"|Color||style="background-color: #CDD"|Color||style="background-color: #CEE;"|Color||style="background-color: #CFF;"|Color||style="background-color: #C11;"|Color||style="background-color: #C22;"|Color||style="background-color: #C33;"|Color||style="background-color: #C44"|Color||style="background-color: #C55;"|Color||style="background-color: #C66;"|Color||style="background-color: #C77;"|Color||style="background-color: #C88;"|Color||style="background-color: #C99;"|Color||style="background-color: #C00"|Color
|-
|Color||style="background-color: #DAA;"|Color||style="background-color: #DBB;"|Color||style="background-color: #DCC;"|Color||style="background-color: #DDD"|Color||style="background-color: #DEE;"|Color||style="background-color: #DFF;"|Color||style="background-color: #D11;"|Color||style="background-color: #D22;"|Color||style="background-color: #D33;"|Color||style="background-color: #D44"|Color||style="background-color: #D55;"|Color||style="background-color: #D66;"|Color||style="background-color: #D77;"|Color||style="background-color: #D88;"|Color||style="background-color: #D99;"|Color||style="background-color: #D00"|Color
|-
|Color||style="background-color: #EAA;"|Color||style="background-color: #EBB;"|Color||style="background-color: #ECC;"|Color||style="background-color: #EDD"|Color||style="background-color: #EEE;"|Color||style="background-color: #EFF;"|Color||style="background-color: #E11;"|Color||style="background-color: #E22;"|Color||style="background-color: #E33;"|Color||style="background-color: #E44"|Color||style="background-color: #E55;"|Color||style="background-color: #E66;"|Color||style="background-color: #E77;"|Color||style="background-color: #E88;"|Color||style="background-color: #E99;"|Color||style="background-color: #E00"|Color
|-
|Color||style="background-color: #FAA;"|Color||style="background-color: #FBB;"|Color||style="background-color: #FCC;"|Color||style="background-color: #FDD"|Color||style="background-color: #FEE;"|Color||style="background-color: #FFF;"|Color||style="background-color: #F11;"|Color||style="background-color: #F22;"|Color||style="background-color: #F33;"|Color||style="background-color: #F44"|Color||style="background-color: #F55;"|Color||style="background-color: #F66;"|Color||style="background-color: #F77;"|Color||style="background-color: #F88;"|Color||style="background-color: #F99;"|Color||style="background-color: #F00"|Color
|-
|Color||style="background-color: #1AA;"|Color||style="background-color: #1BB;"|Color||style="background-color: #1CC;"|Color||style="background-color: #1DD"|Color||style="background-color: #1EE;"|Color||style="background-color: #1FF;"|Color||style="background-color: #111;"|Color||style="background-color: #122;"|Color||style="background-color: #133;"|Color||style="background-color: #144"|Color||style="background-color: #155;"|Color||style="background-color: #166;"|Color||style="background-color: #177;"|Color||style="background-color: #188;"|Color||style="background-color: #199;"|Color||style="background-color: #100"|Color
|-
|Color||style="background-color: #2AA;"|Color||style="background-color: #2BB;"|Color||style="background-color: #2CC;"|Color||style="background-color: #2DD"|Color||style="background-color: #2EE;"|Color||style="background-color: #2FF;"|Color||style="background-color: #211;"|Color||style="background-color: #222;"|Color||style="background-color: #233;"|Color||style="background-color: #244"|Color||style="background-color: #255;"|Color||style="background-color: #266;"|Color||style="background-color: #277;"|Color||style="background-color: #288;"|Color||style="background-color: #299;"|Color||style="background-color: #200"|Color
|-
|Color||style="background-color: #3AA;"|Color||style="background-color: #3BB;"|Color||style="background-color: #3CC;"|Color||style="background-color: #3DD"|Color||style="background-color: #3EE;"|Color||style="background-color: #3FF;"|Color||style="background-color: #311;"|Color||style="background-color: #322;"|Color||style="background-color: #333;"|Color||style="background-color: #344"|Color||style="background-color: #355;"|Color||style="background-color: #366;"|Color||style="background-color: #377;"|Color||style="background-color: #388;"|Color||style="background-color: #399;"|Color||style="background-color: #300"|Color
|-
|Color||style="background-color: #4AA;"|Color||style="background-color: #4BB;"|Color||style="background-color: #4CC;"|Color||style="background-color: #4DD"|Color||style="background-color: #4EE;"|Color||style="background-color: #4FF;"|Color||style="background-color: #411;"|Color||style="background-color: #422;"|Color||style="background-color: #433;"|Color||style="background-color: #444"|Color||style="background-color: #455;"|Color||style="background-color: #466;"|Color||style="background-color: #477;"|Color||style="background-color: #488;"|Color||style="background-color: #499;"|Color||style="background-color: #400"|Color
|-
|Color||style="background-color: #5AA;"|Color||style="background-color: #5BB;"|Color||style="background-color: #5CC;"|Color||style="background-color: #5DD"|Color||style="background-color: #5EE;"|Color||style="background-color: #5FF;"|Color||style="background-color: #511;"|Color||style="background-color: #522;"|Color||style="background-color: #533;"|Color||style="background-color: #544"|Color||style="background-color: #555;"|Color||style="background-color: #566;"|Color||style="background-color: #577;"|Color||style="background-color: #588;"|Color||style="background-color: #599;"|Color||style="background-color: #500"|Color
|-
|Color||style="background-color: #6AA;"|Color||style="background-color: #6BB;"|Color||style="background-color: #6CC;"|Color||style="background-color: #6DD"|Color||style="background-color: #6EE;"|Color||style="background-color: #6FF;"|Color||style="background-color: #611;"|Color||style="background-color: #622;"|Color||style="background-color: #633;"|Color||style="background-color: #644"|Color||style="background-color: #655;"|Color||style="background-color: #666;"|Color||style="background-color: #677;"|Color||style="background-color: #688;"|Color||style="background-color: #699;"|Color||style="background-color: #600"|Color
|-
|Color||style="background-color: #8AA;"|Color||style="background-color: #8BB;"|Color||style="background-color: #8CC;"|Color||style="background-color: #8DD"|Color||style="background-color: #8EE;"|Color||style="background-color: #8FF;"|Color||style="background-color: #811;"|Color||style="background-color: #822;"|Color||style="background-color: #833;"|Color||style="background-color: #844"|Color||style="background-color: #855;"|Color||style="background-color: #866;"|Color||style="background-color: #877;"|Color||style="background-color: #888;"|Color||style="background-color: #899;"|Color||style="background-color: #800"|Color
|-
|Color||style="background-color: #7AA;"|Color||style="background-color: #7BB;"|Color||style="background-color: #7CC;"|Color||style="background-color: #7DD"|Color||style="background-color: #7EE;"|Color||style="background-color: #7FF;"|Color||style="background-color: #711;"|Color||style="background-color: #722;"|Color||style="background-color: #733;"|Color||style="background-color: #744"|Color||style="background-color: #755;"|Color||style="background-color: #766;"|Color||style="background-color: #777;"|Color||style="background-color: #788;"|Color||style="background-color: #799;"|Color||style="background-color: #700"|Color
|-
|Color||style="background-color: #8AA;"|Color||style="background-color: #8BB;"|Color||style="background-color: #8CC;"|Color||style="background-color: #8DD"|Color||style="background-color: #8EE;"|Color||style="background-color: #8FF;"|Color||style="background-color: #811;"|Color||style="background-color: #822;"|Color||style="background-color: #833;"|Color||style="background-color: #844"|Color||style="background-color: #855;"|Color||style="background-color: #866;"|Color||style="background-color: #877;"|Color||style="background-color: #888;"|Color||style="background-color: #899;"|Color||style="background-color: #800"|Color
|-
|Color||style="background-color: #9AA;"|Color||style="background-color: #9BB;"|Color||style="background-color: #9CC;"|Color||style="background-color: #9DD"|Color||style="background-color: #9EE;"|Color||style="background-color: #9FF;"|Color||style="background-color: #911;"|Color||style="background-color: #922;"|Color||style="background-color: #933;"|Color||style="background-color: #944"|Color||style="background-color: #955;"|Color||style="background-color: #966;"|Color||style="background-color: #977;"|Color||style="background-color: #988;"|Color||style="background-color: #999;"|Color||style="background-color: #900"|Color
|-
|Color||style="background-color: #0AA;"|Color||style="background-color: #0BB;"|Color||style="background-color: #0CC;"|Color||style="background-color: #0DD"|Color||style="background-color: #0EE;"|Color||style="background-color: #0FF;"|Color||style="background-color: #011;"|Color||style="background-color: #022;"|Color||style="background-color: #033;"|Color||style="background-color: #044"|Color||style="background-color: #055;"|Color||style="background-color: #066;"|Color||style="background-color: #077;"|Color||style="background-color: #088;"|Color||style="background-color: #099;"|Color||style="background-color: #000"|Color
|-
|}

Ugh, or just use this! [https://www.w3schools.com/colors/colors_picker.asp Color Picker] (Thanks, FIRENSIA!)

User:DOUG/Sandbox Colors Test

2024-08-28T18:11:38Z

DOUG:

Lich:Software/Mac Installation

2024-01-19T03:54:12Z

DOUG: /* The Process */

{{3rd-party}}
To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one. Note: Ruby 3.0 and higher does not support Lich presently. The most tested Ruby version is 2.7.7.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 3.2.3</code>
# <code>rbenv global 3.2.3</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 3.2.3 (2024-01-16 revision 5124f9ac75) [arm64-darwin22]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin22]</code>
seek assistance (restarting the terminal you used to run commands up to this point may be required for `ruby -v` to show the proper, updated version of ruby).

The key is the ruby 3.2.3 part -> it needs to read 3.2.3

'''3.2.3 is expected'''. If your version reflects 3.2.3, proceed to the next steps. Enter these commands, one at a time, and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install sqlite3 gtk3 curses sequel terminal-table ascii_charts concurrent-ruby tomlib --no-document</code>

Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://github.com/elanthia-online/lich-5/releases/latest Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

No guides are available at this time, please email doug@play.net for help.

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}

Lich:Software/Installation

2023-11-14T15:36:26Z

DOUG:

{{3rd-party}}
==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Wrayth or Wizard FE. Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

'''The latest stable lich version is 5.7.0 on Ruby 3.2 - published Nov 17, 2023'''

====Upgrade Lich 5 to the Current Version====

If you are on an older version of Lich 5 and want to upgrade to the most current version, copy and paste these commands one at a time then restart your front-end client. You can run the command <CODE>;e echo LICH_VERSION</CODE> to check your version. If it starts with 4, go to the Upgrade from Lich 4 section.
<pre>
;lich5-update --library=update.rb
</pre>

Quit and restart lich.
<pre>
;lich5-update --update
</pre>

Quit and restart lich. Congratulations - you're now running on Lich 5.7.0

'''Note for Parallels on ARM:''' By default the rubyw file in C:\Ruby4Lich5\bin is set to run in compatibility mode for windows 7. On an ARM Mac running parallels, this causes Wrayth scripts not to run. Turning compatibility mode off in the rubyw file fixes this issue.

===Windows New Installation===

{{blue|These instructions are not for DragonRealms. For those scroll to the bottom.}}

'''For Windows 11/ 10 / 8 / 7''' users: you can download the [We can update the links to use [https://github.com/elanthia-online/lich-5/releases/latest Ruby4Lich5.exe Installer] and install everything you need automatically. Click on the '''Ruby4Lich5.exe''' and download it to your computer then double click on the executable in your default download folder. Note, a user may need to adjust their browser or security settings to allow download and installation.
If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

====New Installation for Lich 5 (11/14/2023)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The Wrayth FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://github.com/elanthia-online/lich-5/releases/latest 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.

====Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)====

This option is deprecated. Lich 5 architectures are not compatible with Lich 4. Back up your existing Lich 4 folder, uninstall any existing Ruby executables, and then follow the instructions for a new install above.

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===
<div class="mw-customtoggle-kestrels" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kestrels">
Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help.

This process works well for Mac OS Catalina and Big Sur.

If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.
</div>

===Chromebook & Debian variants===
<div class="mw-customtoggle-kestrels" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kestrels">
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Wrayth).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev git
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.7.8 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.7.8 -v
rbenv global 2.7.8
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install ascii_charts concurrent-ruby curses gtk3 sequel sqlite3 terminal-table tomlib
</pre>

Install Lich and Profanity:
<pre>
cd ~
git clone https://github.com/elanthia-online/lich-5.git
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>
</div>
Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Fedora===
<div class="mw-customtoggle-kestrels" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kestrels">
There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel glib2-devel gobject-introspection-devel \
libyaml-devel libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
$ gem install ascii_charts concurrent-ruby curses gtk3 sequel sqlite3 terminal-table tomlib
</pre>

4. Download Lich & Profanity:
<pre>
$ cd ~
$ git clone https://github.com/elanthia-online/lich-5.git
$ git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>
</div>

==Popular Scripts==
{{#section:Lich:Script Repository|popularscripts}}

==Ecosystem Information==

* DragonRealms Variant

[https://elanthipedia.play.net/Lich_script_repository#Setup_and_Installation Setup and Install instructions]

==Lich Changelog==
<div class="mw-customtoggle-kestrels" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kestrels">
'''5.6.2''' (current)
<PRE>
-o- Fix for XML errors
-o- Adds the DR Plat instance for Frostbite FE
-o- Adds ‘ball’ as the noun used for ‘ball and chain’
-o- Adds the movement result ‘slip in the mud and fall flat’
-o- Corrects stamina cost for the feature Dispel Magic
-o- Plus all the latest script updates from Elanthia-Online!
</PRE>
'''5.6.1'''
<PRE>
-o- Fix for XML to limit login errors (DR)
-o- Fix for XMLData.active_spells to properly register wizard 'recovery' spell cooldowns
-o- Messaging updates to remove error in Wizard FE encodings
-o- Corrects for error in detecting PSM skill changes (cman) via warrior / rogue guild lessons
-o- Deprecates LNet script from master repository
-o- Miscellaneous small bug squashing
</PRE>

'''5.6.0'''
<PRE>
-o- (DragonRealms) Support for Genie and Frostbite frontends
-o- (GemStone) Changed methods to improve ;go2 speed and reduce lich.db3 calls
-o- (GemStone) Updates to support silver_count function
-o- (Both) Changed method for updating lich ecosystem
</PRE>

'''5.5.0'''
<PRE>
-o- Support for DragonRealms
-o- Updated support for scripts like BigShot
-o- Providing the LichID and UID on Profanity
-o- Spell.force_incant, .force_channel, and .force_evoke
-o- Standardized message method for script authors
-o- Sundry small improvements / fixes and changes
-o- And the creme de la creme - a custom directory
</PRE>

'''5.4.0'''
<PRE>
-o- Simu Room IDs (formally called 'unique ID' or 'uid' for Lich) added to Map, mapDB where known, and ;go2 for navigation (courtesy Xanlin and with our thanks!) ;go2 u7120 for all you ex-GMs out there.
-o- Room titles will now display the Lich ID and / or the UID for the room based on user selections - default is on for both, and enabled / disabled via Lich.display_lichid or Lich.display_uid toggles that can be set to on / off or true / false. (;e Lich.display_lichid=true/false and ;e Lich.display_uid=true/false) You can remove that rnum from your autostart now! To gain the benefit of the UID deployment, be sure to ;repo download-mapdb
-o- REQUESTS: Drop 5 minute timeout function from Lich
-o- waitrt? and waitcastrt? will still pause activities, but will return TRUE or FALSE in keeping with the Ruby functionname? tradition (no more failing to get a weapon out due to RT from climbing!)
-o- empty_hands and fill_hands will now check to see if the character is in roundtime before trying to put away or retrieve held items
-o- Infomon received an update that keeps spell timers in sync with the information received from the server - no more need to immediately do a spell active in game to get the right times to display for various legacy scripts and ;magic after visiting the invoker or using an SK item
-o- Lich now provides a facility to get current coins on the character that is a bit more agnostic to data changes from Simu - Lich::Util.silver_count
-o- Various other small tidbits to help ease maintenance and future development
-o- PLEASE NOTE: This update is required for the newest Bigshot (released today!) and for future eloot and eherbs scripts (release RSN)
</PRE>

'''5.3.0'''
<PRE>
-o- Added support for Wrayth (renamed Stormfront) installations
-o- Converted Linux | WINE login methods to 'method 0', does not use Simu launcher
</PRE>

'''5.2.1'''
<PRE>
-o- Support for STOWing items irrespective of special item scripts
-o- Improved query support for Effects and CMans
-o- Fix Lich bug to respect the 'groupmovement' flag in game
-o- Fix Lich round time calculations (more aggressive timing)
-o- Dark Mode is now a thing
-o- Lich4 Style GUI layout available
-o- Several file location changes to support future code change efforts
</PRE>

'''5.0.19'''
<PRE>
-o- Benefit: Monks with Mental Acuity (all 3 of you) rejoice - stamina casting!
-o- Benefit: PSM3 included, no charge. No hair remaining, either!
-o- Benefit: Ok, stay seated: Some of your various SF spell duration windows may work. . . better? Yes, not perfect, but better. No pictures, please!
-o- Updated infomon that properly detects Cloak of Shadows on those pesky sorcerers, and the Raise Dead Cooldown periods for those wondrous clerics.
-o- A new update process for Lich 5 - tired of having to download that script over and over just to update? Get yourself a copy of lich5-update.lic. Note, if you already have it, you're set! If not - ;jinx script install lich5-update --repo=elanthia-online
</PRE>

'''5.0.11'''
<PRE>
-o- Updated the method used to log onto SIMU servers.
-o- Added the Animalist item specifics to Lich5's empty and fill hands routines
-o- Improved Invoker messages for Avalon and Wizard FEs (no change for SF FE)
-o- Improved cleanup and store methods when player EXIT's or QUIT's game
-o- Crafted two new methods (stash_hands and equip_hands) for future script use
-o- Some behind-the-scenes cleanup to improve maintaining the Lich5 ecosystem
-o- Add Spell Active improvements
-o- Add PSM and Ranger improvements
</PRE>
</div>
==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:New Player]]

Talk:Lich:Software/Installation

2023-11-14T15:28:01Z

DOUG:

'''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)

# Uninstall ALL existing Ruby installations. This includes deleting all existing Ruby folders (they should be located in the root C:\ drive folder).
# 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.
# 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.
# Log in and do -> <code>;repo download-lich</code> <- when command completes exit the game. This is required for things to work proper.
# Log in and do -> <code>;repo download repository</code> <- and wait the few seconds for it to finish. This is required for the repository to work proper.
# Do -> <code>;repo download-mapdb</code> <- and wait the few seconds for it to finish. This is required for map related components to work proper.
# Do -> <code>;repo download jinx</code> <- 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.
# Do -> <code>;jinx script update infomon.lic</code> <- and wait the few seconds for it to finish. After it's downloaded do -> <code>;repo unset-updatable infomon.lic</code> <- to prevent Lich from replacing it with an outdated version. Finally, do -> <code>;kill infomon</code> <- and then -> <code>;infomon</code> <- to restart infomon. This version of infomon is maintained by Elanthia Online to allow quicker updating as the game changes.
# Do -> <code>;jinx data update spell-list.xml</code> <- and wait the few seconds for it to finish. After it's downloaded do -> <code>;repo unset-updatable spell-list.xml</code> <- to prevent Lich from replacing it with an outdated version. Finally, do -> <code>;e Spell.load</code> <- to load the new data. This version of spell-list.xml is maintained by Elanthia Online to allow quicker updating as the game changes.
# Do -> <code>;jinx data update autostart.lic</code> <- and wait the few seconds for it to finish. After it's downloaded do -> <code>;repo unset-updatable autostart.lic</code> <- 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 [https://discord.gg/KF9Wr8u Discord].

Save deprecated instructions 11/14/2023

# Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.
# Download and Run the [https://github.com/elanthia-online/lich-5/releases/tag/v5.6.1 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ 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: <CODE> gem install tomlib ascii_charts concurrent-ruby ftools gtk3 json jwt mechanize nokogiri redis sequel sqlite3 terminal-table tzinfo webrick xmpp4r</CODE>

Lich:Software/Installation

2023-11-14T15:27:23Z

DOUG: /* Installing the Latest Stable Release */

{{3rd-party}}
==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Wrayth or Wizard FE. Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

'''The latest stable lich version is 5.7.0 on Ruby 3.2 - published Nov 17, 2023'''

====Upgrade Lich 5 to the Current Version====

If you are on an older version of Lich 5 and want to upgrade to the most current version, copy and paste these commands one at a time then restart your front-end client. You can run the command <CODE>;e echo LICH_VERSION</CODE> to check your version. If it starts with 4, go to the Upgrade from Lich 4 section.
<pre>
;lich5-update --library=update.rb
</pre>

Quit and restart lich.
<pre>
;lich5-update --update
</pre>

Quit and restart lich. Congratulations - you're now running on Lich 5.7.0

'''Note for Parallels on ARM:''' By default the rubyw file in C:\Ruby4Lich5\bin is set to run in compatibility mode for windows 7. On an ARM Mac running parallels, this causes Wrayth scripts not to run. Turning compatibility mode off in the rubyw file fixes this issue.

===Windows New Installation===

{{blue|These instructions are not for DragonRealms. For those scroll to the bottom.}}

'''For Windows 11/ 10 / 8 / 7''' users: you can download the [https://github.com/elanthia-online/lich-5/releases/tag/v5.7.0 Ruby4Lich5.exe Installer] and install everything you need automatically. Click on the '''Ruby4Lich5.exe''' and download it to your computer then double click on the executable in your default download folder. Note, a user may need to adjust their browser or security settings to allow download and installation.
If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

====New Installation for Lich 5 (11/14/2023)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The Wrayth FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://github.com/elanthia-online/lich-5/releases/tag/v5.7.0 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.

====Upgrade Installation for Lich 5 from Lich 4 (11/14/2023)====

This option is deprecated. Lich 5 architectures are not compatible with Lich 4. Back up your existing Lich 4 folder, uninstall any existing Ruby executables, and then follow the instructions for a new install above.

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===
<div class="mw-customtoggle-kestrels" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kestrels">
Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help.

This process works well for Mac OS Catalina and Big Sur.

If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.
</div>

===Chromebook & Debian variants===
<div class="mw-customtoggle-kestrels" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kestrels">
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Wrayth).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev git
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.7.8 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.7.8 -v
rbenv global 2.7.8
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install ascii_charts concurrent-ruby curses gtk3 sequel sqlite3 terminal-table tomlib
</pre>

Install Lich and Profanity:
<pre>
cd ~
git clone https://github.com/elanthia-online/lich-5.git
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>
</div>
Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Fedora===
<div class="mw-customtoggle-kestrels" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kestrels">
There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel glib2-devel gobject-introspection-devel \
libyaml-devel libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
$ gem install ascii_charts concurrent-ruby curses gtk3 sequel sqlite3 terminal-table tomlib
</pre>

4. Download Lich & Profanity:
<pre>
$ cd ~
$ git clone https://github.com/elanthia-online/lich-5.git
$ git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>
</div>

==Popular Scripts==
{{#section:Lich:Script Repository|popularscripts}}

==Ecosystem Information==

* DragonRealms Variant

[https://elanthipedia.play.net/Lich_script_repository#Setup_and_Installation Setup and Install instructions]

==Lich Changelog==
<div class="mw-customtoggle-kestrels" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kestrels">
'''5.6.2''' (current)
<PRE>
-o- Fix for XML errors
-o- Adds the DR Plat instance for Frostbite FE
-o- Adds ‘ball’ as the noun used for ‘ball and chain’
-o- Adds the movement result ‘slip in the mud and fall flat’
-o- Corrects stamina cost for the feature Dispel Magic
-o- Plus all the latest script updates from Elanthia-Online!
</PRE>
'''5.6.1'''
<PRE>
-o- Fix for XML to limit login errors (DR)
-o- Fix for XMLData.active_spells to properly register wizard 'recovery' spell cooldowns
-o- Messaging updates to remove error in Wizard FE encodings
-o- Corrects for error in detecting PSM skill changes (cman) via warrior / rogue guild lessons
-o- Deprecates LNet script from master repository
-o- Miscellaneous small bug squashing
</PRE>

'''5.6.0'''
<PRE>
-o- (DragonRealms) Support for Genie and Frostbite frontends
-o- (GemStone) Changed methods to improve ;go2 speed and reduce lich.db3 calls
-o- (GemStone) Updates to support silver_count function
-o- (Both) Changed method for updating lich ecosystem
</PRE>

'''5.5.0'''
<PRE>
-o- Support for DragonRealms
-o- Updated support for scripts like BigShot
-o- Providing the LichID and UID on Profanity
-o- Spell.force_incant, .force_channel, and .force_evoke
-o- Standardized message method for script authors
-o- Sundry small improvements / fixes and changes
-o- And the creme de la creme - a custom directory
</PRE>

'''5.4.0'''
<PRE>
-o- Simu Room IDs (formally called 'unique ID' or 'uid' for Lich) added to Map, mapDB where known, and ;go2 for navigation (courtesy Xanlin and with our thanks!) ;go2 u7120 for all you ex-GMs out there.
-o- Room titles will now display the Lich ID and / or the UID for the room based on user selections - default is on for both, and enabled / disabled via Lich.display_lichid or Lich.display_uid toggles that can be set to on / off or true / false. (;e Lich.display_lichid=true/false and ;e Lich.display_uid=true/false) You can remove that rnum from your autostart now! To gain the benefit of the UID deployment, be sure to ;repo download-mapdb
-o- REQUESTS: Drop 5 minute timeout function from Lich
-o- waitrt? and waitcastrt? will still pause activities, but will return TRUE or FALSE in keeping with the Ruby functionname? tradition (no more failing to get a weapon out due to RT from climbing!)
-o- empty_hands and fill_hands will now check to see if the character is in roundtime before trying to put away or retrieve held items
-o- Infomon received an update that keeps spell timers in sync with the information received from the server - no more need to immediately do a spell active in game to get the right times to display for various legacy scripts and ;magic after visiting the invoker or using an SK item
-o- Lich now provides a facility to get current coins on the character that is a bit more agnostic to data changes from Simu - Lich::Util.silver_count
-o- Various other small tidbits to help ease maintenance and future development
-o- PLEASE NOTE: This update is required for the newest Bigshot (released today!) and for future eloot and eherbs scripts (release RSN)
</PRE>

'''5.3.0'''
<PRE>
-o- Added support for Wrayth (renamed Stormfront) installations
-o- Converted Linux | WINE login methods to 'method 0', does not use Simu launcher
</PRE>

'''5.2.1'''
<PRE>
-o- Support for STOWing items irrespective of special item scripts
-o- Improved query support for Effects and CMans
-o- Fix Lich bug to respect the 'groupmovement' flag in game
-o- Fix Lich round time calculations (more aggressive timing)
-o- Dark Mode is now a thing
-o- Lich4 Style GUI layout available
-o- Several file location changes to support future code change efforts
</PRE>

'''5.0.19'''
<PRE>
-o- Benefit: Monks with Mental Acuity (all 3 of you) rejoice - stamina casting!
-o- Benefit: PSM3 included, no charge. No hair remaining, either!
-o- Benefit: Ok, stay seated: Some of your various SF spell duration windows may work. . . better? Yes, not perfect, but better. No pictures, please!
-o- Updated infomon that properly detects Cloak of Shadows on those pesky sorcerers, and the Raise Dead Cooldown periods for those wondrous clerics.
-o- A new update process for Lich 5 - tired of having to download that script over and over just to update? Get yourself a copy of lich5-update.lic. Note, if you already have it, you're set! If not - ;jinx script install lich5-update --repo=elanthia-online
</PRE>

'''5.0.11'''
<PRE>
-o- Updated the method used to log onto SIMU servers.
-o- Added the Animalist item specifics to Lich5's empty and fill hands routines
-o- Improved Invoker messages for Avalon and Wizard FEs (no change for SF FE)
-o- Improved cleanup and store methods when player EXIT's or QUIT's game
-o- Crafted two new methods (stash_hands and equip_hands) for future script use
-o- Some behind-the-scenes cleanup to improve maintaining the Lich5 ecosystem
-o- Add Spell Active improvements
-o- Add PSM and Ranger improvements
</PRE>
</div>
==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:New Player]]

Lich:Software/Installation

2022-05-29T19:32:58Z

DOUG: Updating with current info - 5/29/22

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Wrayth or Wizard FE. Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

{{blue|These instructions are not for DragonRealms. For those scroll to the bottom.}}

'''For Windows 11/ 10 / 8 / 7''' users: you can download the [https://github.com/elanthia-online/lich-5/releases/latest Ruby4Lich5.exe Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest doesn't fix it, check out the jinx repo or ask in Discord #scripting for assistance.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/1/2022)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The Wrayth FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://github.com/elanthia-online/lich-5/releases/latest 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 from Lich 4 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://github.com/elanthia-online/lich-5/releases/latest 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

====Upgrade Lich 5 to the Current Version====

If you are on an older version of Lich 5 and want to upgrade to the most current version, copy and paste these three commands one at a time then restart lich.
<pre>
;lich5-update --update
;jinx data update spell-list.xml --repo=elanthia-online
;jinx script update waggle.lic --repo=elanthia-online
Then restart lich using "quit" or "exit".
</pre>

===Mac OS X===

Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help.

This process works well for Mac OS Catalina and Big Sur.

If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Wrayth).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.7.6 -v
rbenv global 2.7.6
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk3 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://github.com/elanthia-online/lich-5/archive/refs/tags/v5.6.0.zip
unzip lich-*.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel glib2-devel gobject-introspection-devel \
libyaml-devel libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4.a. Download Lich (GTK2):
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

4.b. Download Lich (GTK3):
<pre>
$ cd ~
$ git clone https://github.com/elanthia-online/lich-5.git
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

==Ecosystem Information==

* DragonRealms Variant

[https://elanthipedia.play.net/Lich_script_repository#Setup_and_Installation Setup and Install instructions]

==Lich Changelog==
'''5.6.1''' (current)
<PRE>
-o- Fix for XML to limit login errors (DR)
-o- Fix for XMLData.active_spells to properly register wizard 'recovery' spell cooldowns
-o- Messaging updates to remove error in Wizard FE encodings
-o- Corrects for error in detecting PSM skill changes (cman) via warrior / rogue guild lessons
-o- Deprecates LNet script from master repository
-o- Miscellaneous small bug squashing
</PRE>

'''5.6.0'''
<PRE>
-o- (DragonRealms) Support for Genie and Frostbite frontends
-o- (GemStone) Changed methods to improve ;go2 speed and reduce lich.db3 calls
-o- (GemStone) Updates to support silver_count function
-o- (Both) Changed method for updating lich ecosystem
</PRE>

'''5.5.0'''
<PRE>
-o- Support for DragonRealms
-o- Updated support for scripts like BigShot
-o- Providing the LichID and UID on Profanity
-o- Spell.force_incant, .force_channel, and .force_evoke
-o- Standardized message method for script authors
-o- Sundry small improvements / fixes and changes
-o- And the creme de la creme - a custom directory
</PRE>

'''5.4.0'''
<PRE>
-o- Simu Room IDs (formally called 'unique ID' or 'uid' for Lich) added to Map, mapDB where known, and ;go2 for navigation (courtesy Xanlin and with our thanks!) ;go2 u7120 for all you ex-GMs out there.
-o- Room titles will now display the Lich ID and / or the UID for the room based on user selections - default is on for both, and enabled / disabled via Lich.display_lichid or Lich.display_uid toggles that can be set to on / off or true / false. (;e Lich.display_lichid=true/false and ;e Lich.display_uid=true/false) You can remove that rnum from your autostart now! To gain the benefit of the UID deployment, be sure to ;repo download-mapdb
-o- REQUESTS: Drop 5 minute timeout function from Lich
-o- waitrt? and waitcastrt? will still pause activities, but will return TRUE or FALSE in keeping with the Ruby functionname? tradition (no more failing to get a weapon out due to RT from climbing!)
-o- empty_hands and fill_hands will now check to see if the character is in roundtime before trying to put away or retrieve held items
-o- Infomon received an update that keeps spell timers in sync with the information received from the server - no more need to immediately do a spell active in game to get the right times to display for various legacy scripts and ;magic after visiting the invoker or using an SK item
-o- Lich now provides a facility to get current coins on the character that is a bit more agnostic to data changes from Simu - Lich::Util.silver_count
-o- Various other small tidbits to help ease maintenance and future development
-o- PLEASE NOTE: This update is required for the newest Bigshot (released today!) and for future eloot and eherbs scripts (release RSN)
</PRE>

'''5.3.0'''
<PRE>
-o- Added support for Wrayth (renamed Stormfront) installations
-o- Converted Linux | WINE login methods to 'method 0', does not use Simu launcher
</PRE>

'''5.2.1'''
<PRE>
-o- Support for STOWing items irrespective of special item scripts
-o- Improved query support for Effects and CMans
-o- Fix Lich bug to respect the 'groupmovement' flag in game
-o- Fix Lich round time calculations (more aggressive timing)
-o- Dark Mode is now a thing
-o- Lich4 Style GUI layout available
-o- Several file location changes to support future code change efforts
</PRE>

'''5.0.19'''
<PRE>
-o- Benefit: Monks with Mental Acuity (all 3 of you) rejoice - stamina casting!
-o- Benefit: PSM3 included, no charge. No hair remaining, either!
-o- Benefit: Ok, stay seated: Some of your various SF spell duration windows may work. . . better? Yes, not perfect, but better. No pictures, please!
-o- Updated infomon that properly detects Cloak of Shadows on those pesky sorcerers, and the Raise Dead Cooldown periods for those wondrous clerics.
-o- A new update process for Lich 5 - tired of having to download that script over and over just to update? Get yourself a copy of lich5-update.lic. Note, if you already have it, you're set! If not - ;jinx script install lich5-update --repo=elanthia-online
</PRE>

'''5.0.11'''
<PRE>
-o- Updated the method used to log onto SIMU servers.
-o- Added the Animalist item specifics to Lich5's empty and fill hands routines
-o- Improved Invoker messages for Avalon and Wizard FEs (no change for SF FE)
-o- Improved cleanup and store methods when player EXIT's or QUIT's game
-o- Crafted two new methods (stash_hands and equip_hands) for future script use
-o- Some behind-the-scenes cleanup to improve maintaining the Lich5 ecosystem
-o- Add Spell Active improvements
-o- Add PSM and Ranger improvements
</PRE>

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software/Mac Installation

2022-03-25T22:00:00Z

DOUG: /* The Process */ - Link to Lich5 updated

To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one. Note: Ruby 3.0 and higher does not support Lich presently. The most tested Ruby version is 2.6.6.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 2.6.6</code>
# <code>rbenv global 2.6.6</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 2.6.6p146 (2020-03-31 revision 67876) [x86_64-darwin19]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin20]</code>
seek assistance.

The key is the ruby 2.6 part -> it either reads 2.6.6 or 2.6.3.

'''2.6.6 is expected'''. If your version reflects 2.6.6, proceed to the next steps. Enter these commands, one at a time, and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install sqlite3 --no-document</code>
# <code>gem install gtk3 --no-document</code>

Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://www.dropbox.com/s/dua2zh61xhqw8j1/Lich5.zip?dl=1 Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

No guides are available at this time, please email doug@play.net for help.

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}
[[Category:Third-Party Software]]

Lich:Software/Installation

2022-01-17T17:28:39Z

DOUG: /* Lich Changelog */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

{{blue|These instructions are not for DragonRealms. For those scroll to the bottom.}}

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-scripts/tree/master/scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The StormFront FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 from Lich 4 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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.

'''Note4:''' The script 'sloot' is very popular, and it is confusing to keep track of which sloot variant out there is best. Sloot is currently undergoing maintenance so we recommend all users utilize the Lich5 compatible version of the previous iteration of sloot, found at
<pre>
;repo download gtk3-sloot
then in Windows, rename the gtk3-sloot file to sloot inside your lich5/scripts folder
</pre>

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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

====Upgrade Lich 5 to the Current Version (5.2.1 as of 08Jan2022)====

If you are on an older version of Lich 5 and want to upgrade to the most current version,
<pre>
;repo download lich5-update
;lich5-update --update
quit/relaunch Lich
</pre>

===Mac OS X===

Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help.

This process works well for Mac OS Catalina and Big Sur.

If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel glib2-devel gobject-introspection-devel \
libyaml-devel libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4.a. Download Lich (GTK2):
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

4.b. Download Lich (GTK3):
<pre>
$ cd ~
$ git clone https://github.com/elanthia-online/lich-5.git
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/elanthia-online/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

==Ecosystem Information==

* DragonRealms Variant

[https://elanthipedia.play.net/Lich_script_repository#Setup_and_Installation Setup and Install instructions]

==Lich Changelog==

'''5.2.1 (current)'''
<PRE>
"Support for STOWing items irrespective of special item scripts",
"Improved query support for Effects and CMans",
"Fix Lich bug to respect the 'groupmovement' flag in game",
"Fix Lich round time calculations (more aggressive timing)",
"Dark Mode is now a thing",
"Lich4 Style GUI layout available",
"Several file location changes to support future code change efforts"
</PRE>

'''5.0.19'''
<PRE>
Benefit: Monks with Mental Acuity (all 3 of you) rejoice - stamina casting!
Benefit: PSM3 included, no charge. No hair remaining, either!
Benefit: Ok, stay seated: Some of your various SF spell duration windows may work. . . better? Yes, not perfect, but better. No pictures, please!
1) Updated infomon that properly detects Cloak of Shadows on those pesky sorcerers, and the Raise Dead Cooldown periods for those wondrous clerics.
2) A new update process for Lich 5 - tired of having to download that script over and over just to update? Get yourself a copy of lich5-update.lic. Note, if you already have it, you're set! If not - ;jinx script install lich5-update --repo=elanthia-online
</PRE>

'''5.0.11'''
<PRE>
1) Updated the method used to log onto SIMU servers.
2) Added the Animalist item specifics to Lich5's empty and fill hands routines
3) Improved Invoker messages for Avalon and Wizard FEs (no change for SF FE)
4) Improved cleanup and store methods when player EXIT's or QUIT's game
5) Crafted two new methods (stash_hands and equip_hands) for future script use
6) Some behind-the-scenes cleanup to improve maintaining the Lich5 ecosystem
6) Add Spell Active improvements
7) Add PSM and Ranger improvements
</PRE>

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software/Mac Installation

2021-10-12T00:21:06Z

DOUG: /* The Process */

To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one. Note: Ruby 3.0 and higher does not support Lich presently. The most tested Ruby version is 2.6.6.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 2.6.6</code>
# <code>rbenv global 2.6.6</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 2.6.6p146 (2020-03-31 revision 67876) [x86_64-darwin19]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin20]</code>
seek assistance.

The key is the ruby 2.6 part -> it either reads 2.6.6 or 2.6.3.

'''2.6.6 is expected'''. If your version reflects 2.6.6, proceed to the next steps. Enter these commands, one at a time, and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install sqlite3 --no-document</code>
# <code>gem install gtk3 --no-document</code>

Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://www.dropbox.com/s/cbdhey4fp6i96e4/Lich5.zip?dl=1 Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

No guides are available at this time, please email doug@play.net for help.

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}
[[Category:Third-Party Software]]

Lich:Software/Mac Installation

2021-10-12T00:00:18Z

DOUG: /* The Process */

To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one. Note: Ruby 3.0 and higher does not support Lich presently. The most tested Ruby version is 2.6.6.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 2.6.8</code>
# <code>rbenv global 2.6.8</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 2.6.6p146 (2020-03-31 revision 67876) [x86_64-darwin19]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin20]</code>
seek assistance.

The key is the ruby 2.6 part -> it either reads 2.6.6 or 2.6.3.

'''2.6.6 is expected'''. If your version reflects 2.6.6, proceed to the next steps. Enter these commands, one at a time, and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install sqlite3 --no-document</code>
# <code>gem install gtk3 --no-document</code>

Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://www.dropbox.com/s/cbdhey4fp6i96e4/Lich5.zip?dl=1 Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

No guides are available at this time, please email doug@play.net for help.

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}
[[Category:Third-Party Software]]

Symbol of Renewal

2021-09-25T17:27:33Z

DOUG: Changing cooldown verbiage

{{Order of Voln navigation}}
'''Step 19'''

The '''Symbol of Renewal''', governed by Lady [[Imaera]], is obtained at the nineteenth step of the [[Order of Voln]]. Each use of this symbol will immediately restore 1 [[Spirit|spirit]] point (SP) to the player. When the symbol is activated, it enters a hard cooldown period of 2 minutes where the symbol cannot be reactivated.

==Messaging==

Activation:

<pre{{log2|margin-right=300px}}>>sym of renewal
You call upon the vitality of nature to renew your soul.
You feel a surge of life flow through you.</pre>

End of Cooldown Period:

<pre{{log2|margin-right=300px}}>You feel your connection to vitality of nature renew itself once more.</pre>

==Favor Cost==
{{Spoiler}}

[[Favor]] cost is based on the member's level. See [[Favor#Symbol Use Favor Cost|Table]] for specific examples. Symbol of Renewal has a relative cost of 5x [[Symbol of Protection]]. In other words, 1 use of Renewal has the same favor cost as 5 activations of Protection.

===Favor Required to Obtain Symbol of Renewal===

'''Formula: <tt>1800 + (( level<sup>2</sup> × 30 ) ÷ 3 )</tt>'''

Ex. level 15 member: <tt>1800 + ((15 × 15 × 30) ÷ 3) = 4050 favor</tt>

Ex. level 20 member: <tt>1800 + ((20 × 20 × 30) ÷ 3) = 5800 favor</tt>

===Monk's Teaching and Instruction Highlights===
*Lady [[Imaera]] is beautiful in any form she takes
*She taught us the Symbol of Protection and also taught us how to renew our souls with the Symbol of Renewal

=== [[Wehnimer's Landing]] Task ===
To complete this task you must return to Imaera's island. Once on the island have both hands empty and after kneeling and praying she will appear in the form of a deer. You should then bow to the deer. If for some reason you are unsuccessful, you will need to return to the monk and listen to his instructions again. By setting a ring at the monastery courtyard you can quickly return from the island.
*From the North Gate: SW, S, S, S, S, S, SE, E, E, GO BRIDGE, CLIMB BANK, NE, NW, N, N, NE, N, NE, NE, N, N, NE, N, CLIMB ROCKSLIDE, E, SW, S, E, N, N, N, N, SE, S, SE, SE, E, E, Go Path, NW, NE, E, E, SW, D, SE, GO SHORE, SWIM WATER, SWIM ISLAND, GO ISLAND. (Lich ID 6459)
*Kneel
*Pray (wait for a deer to appear)
*Bow deer
*Return to monk to receive symbol (Lich ID 18194)

=== [[Ta'Vaalor]] Task ===
To complete this task you must go to the shrine/altar in the Rambling Meadows area (Victory Road Map). Once there you kneel, pray shrine and when Imaera appears in the form of a deer, just: Bow deer
*From Victory Gate: Go Gate, SW, SW, SW, SW, SW, S, SW, S, S, S, S, S, S, E, E, E, Go Gate, SW, S, S, S, S, SE, N, N (Lich ID: 6011)
*Kneel
*Pray Shrine (repeat until the deer appears)
*Bow deer
*Return to monk to receive symbol

{{top}}

[[Category:Order of Voln]]
[[Category:Symbols]]

Symbol of Transcendence

2021-09-25T17:26:43Z

DOUG: Changing cooldown verbiage

{{Order of Voln navigation}}
'''Step 12'''

The '''Symbol of Transcendence''', governed by Lady [[Lumnis]], is obtained at the twelfth step of the [[Order of Voln]]. This symbol will allow the player to step into the space between the corporeal and ethereal realms for 30 seconds. While in this state, players will take [[Hitpoint|damage]] as if they were a [[non-corporeal]] creature (i.e. [[critical]] wounds will be much harder to inflict upon them and [[combat maneuver]]s will be harder to land on them). When the symbol is activated, there is a 3 minute hard cooldown period where the symbol cannot be reactivated.

This symbol may also be invoked while the player is stunned, webbed, bound, or in [[RT]], in which case the cooldown period is 10 minutes. It is important to note that the use of this symbol '''does not''' remove the negative status effect. Additionally, when used during this 'emergency' situation, symbol activation must be {{boldmono|CONFIRM}}ed. This confirmation requirement can be preset with an on/off toggle (See {{boldmono|SYMBOL OF TRANSCENDENCE TOGGLE}} while in game to set the desired option).

The {{boldmono|SPELL ACTIVE}} command will display the remaining cooldown duration.

==Syntax==

:Symbol of transcendence (can be abbreviated) or
:Symbol of transcendence confirm (while stunned, webbed, bound or in RT)

==Messaging==
Symbol activation:

<div {{log}}>>sym of trans<br>
You step into the space between the corporeal and ethereal realms.</div>

Symbol activation while stunned, webbed, bound or in RT:

<div {{log}}>>sym of trans
You must CONFIRM that you wish to use the emergency feature of this symbol.<br>

[You may set your preference to automatically confirm emergency use of this symbol with the SYMBOL OF TRANSCENDENCE TOGGLE option.]<br>

>sym of trans confirm<br>
With difficulty, you manage to will yourself into the space between the corporeal and ethereal realms.</div>

Wearing off:

<div {{log}}>You feel yourself being pulled back fully into the corporeal realm.</div>

Cooldown ending:

<div {{log}}>You feel ready to challenge the grasp of the corporeal realm once more.</div>

==Favor Cost==
{{Spoiler}}

[[Favor]] cost is based on the member's level. See [[Favor#Symbol Use Favor Cost|Table]] for specific examples. It's relative cost is 6x [[Symbol of Protection]]. In other words, 1 use of Symbol of Transcendence uses the same favor as 6 activations of [[Symbol of Protection]].

===Favor Required to Obtain Symbol of Transcendence===

'''Formula: <tt>1100 + (( level<sup>2</sup> × 20 ) ÷ 3 )</tt>'''

Ex. level 10 member: <tt>1100 + ((10 × 10 × 20) ÷ 3) = 1766 favor</tt>

Ex. level 20 member: <tt>1100 + ((20 × 20 × 20) ÷ 3) = 3766 favor</tt>

===Monk's Teaching and Instruction Highlights===
*Lumnis is the wife of [[Koar]] and the patron of scholars and masters of thought. She is also known as The Wise.
*Lumnis taught a way to temporarily slip into the place between the corporeal and ethereal realms.

=== [[Wehnimer's Landing]] Task ===
*From inside the Graveyard Gate proceed: {{boldmono|NE, N, N, NW, GO TRAIL, NE, N, W, NW, NW, SW, W, GO PATH, E}} (Lich ID 7262)
*Search twice
*Wait for a question
*{{boldmono|Say Koar}} or {{boldmono|'Koar}}
*Return to the monk to receive your symbol (Lich ID 18201)

=== [[Ta'Vaalor]] Task ===

*Go to library in [[Ta'Illistim]]. Directions to library from the Sapphire Gate in Ta'Illistim: {{boldmono|N, N, GO PORTCULLIS, W, W, NE, NE, GO GATE, SW, W, NE, N, SW, SW, SW, SW, W, N, N, N, W, NW, N, N, N, NW, SW, W, W, GO COURTYARD, GO DOORS, GO ARCH}} (Lich ID 13233)
*{{boldmono|BOW BANNER}}, {{boldmono|LOOK BANNER}}
*Next, {{boldmono|GO DOOR}} to enter Hall of Being. You will be tasked to find the appropriate room in the hall and {{boldmono|PRAY}}.
**Example room task: A voice twinkles in your ear, "Of the great elven houses, both Ta'Ardenai and Ta'Illistim were ruled by these."
**Solution room: Hall of Queens (No Lich ID, {{boldmono|GO DOOR}} from 13445)
*You will know when you've completed the task when you get the tingling sensation
*Return to the monk to receive your symbol

{{top}}

[[Category:Order of Voln]]
[[Category:Symbols]]

Symbol of Mana

2021-09-25T17:25:51Z

DOUG: Changing cooldown verbiage

{{Order of Voln navigation}}
'''Step 13'''

The '''Symbol of Mana''', governed by Lord [[Koar]], is obtained at the thirteenth step of the [[Order of Voln]]. Upon a successful invocation of this [[symbol]] the member will immediately gain 50 mana.

If, by using this symbol, mana is increased above the normal max capacity, it will begin to incrementally dissipate at 5 per pulse until the normal level is reached.

Initial use of this symbol will cost only favor and no [[deed]]s. When initially activated, the symbol will also enter a soft cooldown period of 5 minutes, where additional activations will require 1 deed per use. [[Cleric]]s may be interested to note that the symbol will become useable while [[Death's Sting|dead]], should any [[Miracle]]s be required.

Typing SYMBOL OF MANA TOGGLE ON|OFF will help you not accidentally use deeds when you don't mean to use them.

==Messaging==
Successful invocation:

<div {{log}}>''>symbol of mana''<br>
You call upon a special blessing from Koar<br>
You feel a surge of mana flow through you.</div>

Cooldown ending:

<div {{log}}>You feel Koar's blessing return to you.</div>

Failure:

<div {{log}}>''>symbol of mana''<br>
The image of the symbol burns in your mind, but no mana flows.</div>

==Favor Cost==
{{Spoiler}}

[[Favor]] cost is based on the member's level. See [[Favor#Symbol Use Favor Cost|Table]] for specific examples. It has a relative cost of 3x [[Symbol of Protection]]. In other words, one use of Symbol of Mana costs the same favor as three activations of [[Symbol of Protection]].

===Favor Required to Obtain Symbol of Mana===

'''Formula: <tt>1200 + (( level<sup>2</sup> × 20 ) ÷ 3 )</tt>'''

Ex. level 10 member: <tt>1200 + ((10 × 10 × 20) ÷ 3) = 1866 favor</tt>

Ex. level 20 member: <tt>1200 + ((20 × 20 × 20) ÷ 3) = 3866 favor</tt>

===Monk's Teaching and Instruction Highlights===
*[[Koar]] is the Master of [[Mana]].
*He controls the pools of mana. This is why he leads the other Lords of Liabo.
*He taught us how to tap the mana around us.

=== [[Wehnimer's Landing]] Task ===
*From Town Square Central: Go well, Climb rope, Kneel (Lich ID 7544)
*Say I have come to honor Koar, master of mana. (must be exact including punctuation)
*Return to the monk to receive your symbol (Lich ID 18200)

=== [[Ta'Vaalor]] Task ===
*From Annatto Gate: N, E, E, E, N, N, kneel (Lich Shortcut ;go2 3539)
*Say I have come to honor Koar, Master of Mana. (must be exact including punctuation)
*Return to the monk to receive your symbol

{{top}}

[[Category:Order of Voln]]
[[Category:Symbols]]

F2P subscription

2021-06-21T10:39:10Z

DOUG: /* Login Rewards */ - Adding limit for day 19 Rewards F2P (10 Guild Boosts)

'''F2P subscriptions''' were created in 2015 as an option for new accounts only, with no character transfers allowed. This subscription is highly restricted (see specifics below), with passes around the restrictions available through the [[SimuCoin#F2P_Subscription_Items|SimuCoin Store]]. None of these items, however, will provide a greater mechanical benefit than what can be obtained by having a [[standard subscription]].

Once an account is upgraded to a monthly paying subscription (standard or [[premium]]), it cannot be reverted back.

==Experience==
*The weekly Gift of Lumnis does not occur. It is accessible via a pass.
*Experience absorption is less efficient on a sliding scale. The first 10 levels are unchanged. After level 10, the efficiency of absorption gradually decreases. This can be fully or partially offset with [[experience pass]]es.
*Experience gained per monster killed is also reduced under same scale.
*Field experience cannot be absorbed while logged off.
*There is no bonus experience point per pulse absorbed while grouped with a non-F2P character.
*No yearly [[fixskills]].

The exact formula of exp loss is not yet known, but so far research tends to favor the formula for on-node exp loss: Exp Loss Per Pulse = (Level - 10) / 1.75 .
So for instance, a typical character will see loss per pulse similar to this table...
:{| {{prettytable|1=text-align:center}}
!align="right"|Level||10||15||20||25||30
|-
|align="right"|Exp Loss Per Pulse On-Node||0||3||6||10||13
|}
This is a severely debilitating loss above level 25ish. Beyond that point levels will take 50+ hours of gametime to achieve.

==Organization Access==
*One task per hour will be available from the [[Adventurer's Guild]]. This can be upgraded to 1 task per 30 minutes with an Adventure Boost.
*Cannot gain [[Artisan Guild]] ranks. Will allow access purchases down the line.
*Can gain the first rank of a [[society]] and advance to the cusp of the 2nd rank. A society pass is required to gain rank 2 and beyond, as well as use any powers beyond 2nd rank. (Any ranks above 2 earned during Society Pass will remain but unusable after boost expires with no penalties or down ranking will occurring due to lack of attendance to duties. Last gained rank returned on pass renewal.)
*Cannot join a profession [[guild]]. Will allow access purchases down the line.
*Cannot join [[CHE]]s.

==Combat/Magic==
*No direct PvP attacks allowed. Mass Attack spells like [[Elemental Wave (410)]] that can hit players as well as creatures have a 30 second cooldown (to prevent careless spamming). If actually used to attack another player, this cooldown increases to 5 minutes (cooldown can be removed with a cooldown remover).
*Spells that significantly impact a room without attacking a player (notably [[Minor Sanctuary]]) are restricted from use.
*Attack spells (vs. creatures) are largely unrestricted, aside from the mass attack spell limitations noted above. Sorcerers may cast [[Focused Implosion]].
*All beneficial spells are self-cast only, except for [[Spirit Warding I (101)]], [[Elemental Defense I (401)]], and [[Foresight (1204)]] which may be cast on others up to the 2 hour duration limit. Mass spells [[Mass Blur (911)]], [[Natural Colors (601)]] (evoked), and [[Mass Elemental Defense (419)]] will buff yourself but not your party. [[ARMOR]] abilities are also self-cast only. A casting pass allows casting on anyone else. If the caster does not have a casting pass, the receiving player can choose to purchase a receiving pass to allow any F2P caster to cast upon them. Only one pass needs to be present.
*All beneficial spell [[duration]]s cap at 2 hours.
*Permanent/Long-term item boosts have complete/partial restrictions ([[Enchant Item]], [[Charge Item]], [[Magic Item Creation]], [[Imbue]], [[Resist Nature]], [[Scroll Infusion]], [[Holy Receptacle]], [[Ensorcell]], Damage Specializations, etc.).
*Utility spells such as teleportation, locate, and such have a four hour cooldown period between each use. These cooldowns can be removed with a cooldown remover.
*Only access to random attunement, unless a purchase is made to select one.
*Only access to one particular sort of pet for pet spells (Call Familiar, Animal Companion, etc).
*[[Loresinging]] is restricted, unless a pass is purchased which allows loresinging on a per item basis.
*Cannot [[SEND]] mana. A casting pass purchased by one of the parties will remove this restriction.
*Warriors cannot protect another player using {{boldmono|[[GUARD (verb)|GUARD]]}} or {{boldmono|[[PROTECT (verb)|PROTECT]]}}

Listed above are the general rules for casting, and these are the exceptions found so far...
*[[Spirit Fog (106)]] is unrestricted, you may fog up rooms as you wish.
*[[Stun Relief (108)]] is unrestricted, you may unstun as many players as you wish.
*[[Undisease (113)]] is unrestricted, you may undisease as many players as you wish.
*[[Unpoison (114)]] is unrestricted, you may unpoison as many players as you wish.
*[[Manna (203)]] is unrestricted, you may create this and give to anyone.
*[[Light (205)]] is unrestricted, you may brighten/darken a room as you wish.
*[[Untrammel (209)]] is unrestricted, you may unweb as many players as you wish.
*[[Bless (304)]] is unrestricted, you may bless as many items as you like but each bless is capped at 50 swings.
*[[Preservation (305)]] is unrestricted, you may lifekeep as many players as you like.
*[[Holy Receptacle (325)]] is completely unusable even for yourself.
*[[Elemental Detection (405)]] is unrestricted, you may detect spells on players and in items.
*[[Elemental Blade (411)]] is unrestricted, you may eblade your weapons and those of others.
*[[Herb Production (1118)]] is unrestricted, you may grow all the herbs you want.
*[[Troll's Blood (1125)]] does in fact buff your party, and can even be cast over the 2 hour limit.
*[[Vertigo (1219)]] does not suffer from the normal AOE limit of 4 hours.
*[[Consecrate (1604)]] is unrestricted, you may consecrate all you want.
*[[Arm of the Arkati (1605)]] extends to your group.
*Paladin auras extend to your group: [[Divine Shield (1609)]], [[Zealot (1617)]], [[Fervor (1618)]].

==Healing/Raising==
*The last 10 players healed are kept track of. Each time a new person is healed, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A healing pass increases this to 4 times.
*An empath must first [[empathic linking|link]] (via [[TOUCH]]) to their prospective client. This linking process takes 30 seconds (15 with a healing pass). Once established, the link lasts for 3 minutes. All wound transfers done during this link are considered part of a single healing session (one entry on the above list).
*The last 10 players raised are kept track of. Each time a new person is raised, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A pass removes this restriction.
*A cleric must have a Resurrection Pass active to use a [[chrism]].

==Treasure/Items/Banks==
*Creatures which are more than 10 levels below the player's level are not eligible for ANY treasure production, including but not limited to any treasure generated when searching, looting, or skinning.
*In-bank limits start at 100,000 and can be permanently increased in 100,000 silver increments pretty cheaply.
*5k in-pocket silver maximum to hunt with (can carry as much as desired outside of combat). Waived with a Treasure Boost.
*One bank account (F2P accounts will receive a warning before using a bank for the first time as they need to pay to move it from town to town).
*Notes cost 1% more.
*Silvers apply twice as much encumbrance.
*50k daily treasure cap. Cap can be reset with a Treasure Cap Reset. Lowered treasure per kill. Expanded to 100k cap with a Treasure Boost, and increased treasure. Limits on Purify silver value boosts and increased difficulty.
*Shop prices are less favorable.
*No base access to a [[locker]]. Can purchase a temporary 10 item locker pass, or the existing locker upgrades (both permanent and temporary).
*100 item personal carry limit. Can be expanded to 300 items with a pass.
*Can use up to 5x (+25) gear (any additional bonus is not applied). Similarly limited to "somewhat" padding/weighting/sighting. Gear passes are available that allow the full benefit of any equipment's enchantment, weighting, padding, sighting, TD enhancement, or Defensive Bonus (DB), just like a paid subscriber.

==Geography==
*During the release, transportation to [[River's Rest]] and [[Teras Isle]] was said to restricted by boat or teleportation. [[Chronomage]] orb purchases are similarly restricted in-game and thus, the player must purchase one from the SimuCoin store.
* The boot to River's Rest prevents F2P travel by foot and directs the player to purchase a Chronomage orb from the store.
* Passage on the smuggler's cutter to River's Rest is not restricted.
* TBD on whether Teras ticket purchase is also restricted.

==Miscellaneous==
*Lockpicking (and popping/bashing) limited to self-found boxes only. Plans for this to change based on how the rotating lists for healing/raising work.
*Foraging is harder. F2P cannot take the last two forageables out of a room. Max 15 items per hour. Foraging pass removes restrictions and makes foraging easier.
*Pickpocketing skill cannot be used to steal from other player characters.

==Login Rewards==
[[Login Rewards]] are awarded to characters that login daily on all types of accounts, but F2P subscribers receive fewer or a lesser form of what paying subscribers receive, as well as limits on the amount of rewards that can be stockpiled. Also, F2P subscribers must logout and login each day (past 00:00 on game [[TIME]]) as the system will not keep track automatically for them.

Currently F2P is limited to stockpile 1 Gift of the Gods and 1 Experience Booster, so they should be spent every month. In addition, only 2 daily [[Login bridge|login bridges]] may be stockpiled through login rewards, so at most one can only miss 2 consecutive days of logins to maintain a streak (without obtaining bridges from an alternate source).
{| {{prettytable}} width="80%"
|-bgcolor="lightblue"
!width="7%"|DAY
!REWARD
|-
|align="center"| 1||500 fame
|-
|align="center"| 2||1 random magical crystal ([[blue crystal|blue]]/[[white crystal|white]]/[[black crystal|black]]). Can stockpile up to 5 uses at once.
|-
|align="center"| 3||1 Minor Loot Boost (small boost on [[LOOT]] rolls for 15 minutes)
|-
|align="center"| 4||1 Temporary Urchin Guide access (access to the [[URCHIN]] guides for 15 minutes)
|-
|align="center"| 5||1 Bounty Boost (reduces all bounty wait times (to a nominal few seconds) until the character shares a task or successfully completes it, max 1 hour)
|-
|align="center"| 6||1 Enhancive Boost (player's choice of either 5 enhancive pauses, or 15 minutes of +5 to all Base Stat Bonuses, or 15 minutes of +15 to Stamina and Mana Regen)
|-
|align="center"| 7||1 Urchin Runner (allows characters to use the remote [[BANK (verb)|BANK]] and [[LOCKER]] access commands. Comes with a free 15 minutes of LOCKER MANIFEST access)
|-
|align="center"| 8||1 Encumbrance Boost (minus 50 lbs to effective encumbrance for 15 minutes)
|-
|align="center"| 9||1 Guild Boost (player's choice of either doubled TPs earned for each profession guild task or another use of the Bounty Boosts)
|-
|align="center"| 10||1 Lesser Experience Pass (60 minute Exp Pass)
|-
|align="center"| 11||2 hours of Bounty Waivers (choose one Adventurer Guild task type (Forage Herbs, Escort NPC, etc) that they do not want to get assigned for the duration). Can stockpile up to 10 unredeemed Bounty Waivers.
|-
|align="center"| 12||1 Major Loot Boost (larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another.) Can stockpile up to 10 unredeemed Major Loot Boosts.
|-
|align="center"| 13||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 14||1 Minor Loot Boost. Can stockpile up to 10 unredeemed Minor Loot Boosts.
|-
|align="center"| 15||1 Bounty Boost. Can stockpile up to 10 unredeemed Bounty Boosts.
|-
|align="center"| 16||1 Enhancive Boost. Can stockpile up to 10 unredeemed Enhancive Boosts.
|-
|align="center"| 17||2 uses of the Urchin Runners. Can stockpile up to 10 unredeemed Urchin Runner uses.
|-
|align="center"| 18||1 Encumbrance Boost. Can stockpile up to 10 unredeemed Encumbrance Boosts.
|-
|align="center"| 19||1 Guild Boost. Can stockpile up to 10 unredeemed Guild Boosts.
|-
|align="center"| 20||1 Instant Mind Clearer (instantly moves 1000 current field exp into their absorbed exp pool. It does not apply any RPA, XXX, or other modifiers to this amount)
|-
|align="center"| 21||1 [[Death's Sting|Deathsting]] Reducer (reduces deathsting penalties by 1 priestess potion sip per use)
|-
|align="center"| 22||2 hours of Bounty Waivers. Can stockpile up to 10 uses at once.
|-
|align="center"| 23||1 Major Loot Boost(Larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another)
|-
|align="center"| 24||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 25||2 Item Superchargers (when activated, any standard flaring gear that the character uses will flare more often, any weighted/padded/sighted gear will gain bonus additional weighting/padding/sighting, and any item's enchantment bonus will provide an extra 50% bonus to AS/DS for 15 minutes)
|-
|align="center"| 26||2 Luck Boosters (When activated, all standard offensive combat rolls made by the character will reroll d100 results of 10 or less (keeping the new number if it is higher) for 15 minutes)
|-
|align="center"| 27||3-day [[society]] pass
|-
|align="center"| 28||2 Major Loot Boosts
|-
|align="center"| 29||1 Gift of the Gods. You can only choose Lorminstra (5 deeds) and can only stockpile 1 unredeemed. Be sure to redeem it before your next 29-day reward rolls around or you will lose that one.
|-
|align="center"| 30||2 Doubled Experience Boosters (Double experience absorption for 15 minutes.) Can stockpile only '''1''' unredeemed Doubled Experience Booster. Make sure to use both of them before the next 30-day reward rolls around.
|}

==Official Message Boards==
As of May 2016, F2P accounts only have access to selected sections of the official message boards, all of which are linked here:

*[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/view Officials F2P Discussions main folder]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/Announcements/view Announcements]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Subscription/view F2P Subscription]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20General%20Discussion/view F2P General Discussion]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Game%20Mechanics/view F2P Game Mechanics]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Professions/view F2P Professions]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20World%20Discussions/view F2P World Discussions]

*[http://forums.play.net/forums/GemStone%20IV/Help%20for%20Players/view Help for Players main folder]
*[http://forums.play.net/forums/GemStone%20IV/Software%20&%20Hardware%20Help/view Software & Hardware Help main folder]
*[http://forums.play.net/forums/GemStone%20IV/Socializing/view Socializing main folder]
*[http://forums.play.net/forums/GemStone%20IV/The%20Marketplace/view The Marketplace main folder]

==Resources==
*[[Login Rewards]]
*[http://forum.gsplayers.com/showthread.php?94776-Getting-Lich-to-work-with-F2P-accounts Getting Lich to work with F2P]
*[http://forum.gsplayers.com/showthread.php?95891-F2P-Experience&p=1773183#post1773183 F2P Experience Penalty Analysis]
*[http://forum.gsplayers.com/showthread.php?96614-F2P-Spell-Research Maerit's F2P Spell Research]
*[http://forum.gsplayers.com/showthread.php?94753-F2P-thread Unofficial's general F2P thread]

[[category: Subscriptions]]

F2P subscription

2021-06-20T04:22:30Z

DOUG: /* Login Rewards */ - Adding limit for day 18 Rewards F2P (10 Encumbrance Boosts)

'''F2P subscriptions''' were created in 2015 as an option for new accounts only, with no character transfers allowed. This subscription is highly restricted (see specifics below), with passes around the restrictions available through the [[SimuCoin#F2P_Subscription_Items|SimuCoin Store]]. None of these items, however, will provide a greater mechanical benefit than what can be obtained by having a [[standard subscription]].

Once an account is upgraded to a monthly paying subscription (standard or [[premium]]), it cannot be reverted back.

==Experience==
*The weekly Gift of Lumnis does not occur. It is accessible via a pass.
*Experience absorption is less efficient on a sliding scale. The first 10 levels are unchanged. After level 10, the efficiency of absorption gradually decreases. This can be fully or partially offset with [[experience pass]]es.
*Experience gained per monster killed is also reduced under same scale.
*Field experience cannot be absorbed while logged off.
*There is no bonus experience point per pulse absorbed while grouped with a non-F2P character.
*No yearly [[fixskills]].

The exact formula of exp loss is not yet known, but so far research tends to favor the formula for on-node exp loss: Exp Loss Per Pulse = (Level - 10) / 1.75 .
So for instance, a typical character will see loss per pulse similar to this table...
:{| {{prettytable|1=text-align:center}}
!align="right"|Level||10||15||20||25||30
|-
|align="right"|Exp Loss Per Pulse On-Node||0||3||6||10||13
|}
This is a severely debilitating loss above level 25ish. Beyond that point levels will take 50+ hours of gametime to achieve.

==Organization Access==
*One task per hour will be available from the [[Adventurer's Guild]]. This can be upgraded to 1 task per 30 minutes with an Adventure Boost.
*Cannot gain [[Artisan Guild]] ranks. Will allow access purchases down the line.
*Can gain the first rank of a [[society]] and advance to the cusp of the 2nd rank. A society pass is required to gain rank 2 and beyond, as well as use any powers beyond 2nd rank. (Any ranks above 2 earned during Society Pass will remain but unusable after boost expires with no penalties or down ranking will occurring due to lack of attendance to duties. Last gained rank returned on pass renewal.)
*Cannot join a profession [[guild]]. Will allow access purchases down the line.
*Cannot join [[CHE]]s.

==Combat/Magic==
*No direct PvP attacks allowed. Mass Attack spells like [[Elemental Wave (410)]] that can hit players as well as creatures have a 30 second cooldown (to prevent careless spamming). If actually used to attack another player, this cooldown increases to 5 minutes (cooldown can be removed with a cooldown remover).
*Spells that significantly impact a room without attacking a player (notably [[Minor Sanctuary]]) are restricted from use.
*Attack spells (vs. creatures) are largely unrestricted, aside from the mass attack spell limitations noted above. Sorcerers may cast [[Focused Implosion]].
*All beneficial spells are self-cast only, except for [[Spirit Warding I (101)]], [[Elemental Defense I (401)]], and [[Foresight (1204)]] which may be cast on others up to the 2 hour duration limit. Mass spells [[Mass Blur (911)]], [[Natural Colors (601)]] (evoked), and [[Mass Elemental Defense (419)]] will buff yourself but not your party. [[ARMOR]] abilities are also self-cast only. A casting pass allows casting on anyone else. If the caster does not have a casting pass, the receiving player can choose to purchase a receiving pass to allow any F2P caster to cast upon them. Only one pass needs to be present.
*All beneficial spell [[duration]]s cap at 2 hours.
*Permanent/Long-term item boosts have complete/partial restrictions ([[Enchant Item]], [[Charge Item]], [[Magic Item Creation]], [[Imbue]], [[Resist Nature]], [[Scroll Infusion]], [[Holy Receptacle]], [[Ensorcell]], Damage Specializations, etc.).
*Utility spells such as teleportation, locate, and such have a four hour cooldown period between each use. These cooldowns can be removed with a cooldown remover.
*Only access to random attunement, unless a purchase is made to select one.
*Only access to one particular sort of pet for pet spells (Call Familiar, Animal Companion, etc).
*[[Loresinging]] is restricted, unless a pass is purchased which allows loresinging on a per item basis.
*Cannot [[SEND]] mana. A casting pass purchased by one of the parties will remove this restriction.
*Warriors cannot protect another player using {{boldmono|[[GUARD (verb)|GUARD]]}} or {{boldmono|[[PROTECT (verb)|PROTECT]]}}

Listed above are the general rules for casting, and these are the exceptions found so far...
*[[Spirit Fog (106)]] is unrestricted, you may fog up rooms as you wish.
*[[Stun Relief (108)]] is unrestricted, you may unstun as many players as you wish.
*[[Undisease (113)]] is unrestricted, you may undisease as many players as you wish.
*[[Unpoison (114)]] is unrestricted, you may unpoison as many players as you wish.
*[[Manna (203)]] is unrestricted, you may create this and give to anyone.
*[[Light (205)]] is unrestricted, you may brighten/darken a room as you wish.
*[[Untrammel (209)]] is unrestricted, you may unweb as many players as you wish.
*[[Bless (304)]] is unrestricted, you may bless as many items as you like but each bless is capped at 50 swings.
*[[Preservation (305)]] is unrestricted, you may lifekeep as many players as you like.
*[[Holy Receptacle (325)]] is completely unusable even for yourself.
*[[Elemental Detection (405)]] is unrestricted, you may detect spells on players and in items.
*[[Elemental Blade (411)]] is unrestricted, you may eblade your weapons and those of others.
*[[Herb Production (1118)]] is unrestricted, you may grow all the herbs you want.
*[[Troll's Blood (1125)]] does in fact buff your party, and can even be cast over the 2 hour limit.
*[[Vertigo (1219)]] does not suffer from the normal AOE limit of 4 hours.
*[[Consecrate (1604)]] is unrestricted, you may consecrate all you want.
*[[Arm of the Arkati (1605)]] extends to your group.
*Paladin auras extend to your group: [[Divine Shield (1609)]], [[Zealot (1617)]], [[Fervor (1618)]].

==Healing/Raising==
*The last 10 players healed are kept track of. Each time a new person is healed, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A healing pass increases this to 4 times.
*An empath must first [[empathic linking|link]] (via [[TOUCH]]) to their prospective client. This linking process takes 30 seconds (15 with a healing pass). Once established, the link lasts for 3 minutes. All wound transfers done during this link are considered part of a single healing session (one entry on the above list).
*The last 10 players raised are kept track of. Each time a new person is raised, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A pass removes this restriction.
*A cleric must have a Resurrection Pass active to use a [[chrism]].

==Treasure/Items/Banks==
*Creatures which are more than 10 levels below the player's level are not eligible for ANY treasure production, including but not limited to any treasure generated when searching, looting, or skinning.
*In-bank limits start at 100,000 and can be permanently increased in 100,000 silver increments pretty cheaply.
*5k in-pocket silver maximum to hunt with (can carry as much as desired outside of combat). Waived with a Treasure Boost.
*One bank account (F2P accounts will receive a warning before using a bank for the first time as they need to pay to move it from town to town).
*Notes cost 1% more.
*Silvers apply twice as much encumbrance.
*50k daily treasure cap. Cap can be reset with a Treasure Cap Reset. Lowered treasure per kill. Expanded to 100k cap with a Treasure Boost, and increased treasure. Limits on Purify silver value boosts and increased difficulty.
*Shop prices are less favorable.
*No base access to a [[locker]]. Can purchase a temporary 10 item locker pass, or the existing locker upgrades (both permanent and temporary).
*100 item personal carry limit. Can be expanded to 300 items with a pass.
*Can use up to 5x (+25) gear (any additional bonus is not applied). Similarly limited to "somewhat" padding/weighting/sighting. Gear passes are available that allow the full benefit of any equipment's enchantment, weighting, padding, sighting, TD enhancement, or Defensive Bonus (DB), just like a paid subscriber.

==Geography==
*During the release, transportation to [[River's Rest]] and [[Teras Isle]] was said to restricted by boat or teleportation. [[Chronomage]] orb purchases are similarly restricted in-game and thus, the player must purchase one from the SimuCoin store.
* The boot to River's Rest prevents F2P travel by foot and directs the player to purchase a Chronomage orb from the store.
* Passage on the smuggler's cutter to River's Rest is not restricted.
* TBD on whether Teras ticket purchase is also restricted.

==Miscellaneous==
*Lockpicking (and popping/bashing) limited to self-found boxes only. Plans for this to change based on how the rotating lists for healing/raising work.
*Foraging is harder. F2P cannot take the last two forageables out of a room. Max 15 items per hour. Foraging pass removes restrictions and makes foraging easier.
*Pickpocketing skill cannot be used to steal from other player characters.

==Login Rewards==
[[Login Rewards]] are awarded to characters that login daily on all types of accounts, but F2P subscribers receive fewer or a lesser form of what paying subscribers receive, as well as limits on the amount of rewards that can be stockpiled. Also, F2P subscribers must logout and login each day (past 00:00 on game [[TIME]]) as the system will not keep track automatically for them.

Currently F2P is limited to stockpile 1 Gift of the Gods and 1 Experience Booster, so they should be spent every month. In addition, only 2 daily [[Login bridge|login bridges]] may be stockpiled through login rewards, so at most one can only miss 2 consecutive days of logins to maintain a streak (without obtaining bridges from an alternate source).
{| {{prettytable}} width="80%"
|-bgcolor="lightblue"
!width="7%"|DAY
!REWARD
|-
|align="center"| 1||500 fame
|-
|align="center"| 2||1 random magical crystal ([[blue crystal|blue]]/[[white crystal|white]]/[[black crystal|black]]). Can stockpile up to 5 uses at once.
|-
|align="center"| 3||1 Minor Loot Boost (small boost on [[LOOT]] rolls for 15 minutes)
|-
|align="center"| 4||1 Temporary Urchin Guide access (access to the [[URCHIN]] guides for 15 minutes)
|-
|align="center"| 5||1 Bounty Boost (reduces all bounty wait times (to a nominal few seconds) until the character shares a task or successfully completes it, max 1 hour)
|-
|align="center"| 6||1 Enhancive Boost (player's choice of either 5 enhancive pauses, or 15 minutes of +5 to all Base Stat Bonuses, or 15 minutes of +15 to Stamina and Mana Regen)
|-
|align="center"| 7||1 Urchin Runner (allows characters to use the remote [[BANK (verb)|BANK]] and [[LOCKER]] access commands. Comes with a free 15 minutes of LOCKER MANIFEST access)
|-
|align="center"| 8||1 Encumbrance Boost (minus 50 lbs to effective encumbrance for 15 minutes)
|-
|align="center"| 9||1 Guild Boost (player's choice of either doubled TPs earned for each profession guild task or another use of the Bounty Boosts)
|-
|align="center"| 10||1 Lesser Experience Pass (60 minute Exp Pass)
|-
|align="center"| 11||2 hours of Bounty Waivers (choose one Adventurer Guild task type (Forage Herbs, Escort NPC, etc) that they do not want to get assigned for the duration). Can stockpile up to 10 unredeemed Bounty Waivers.
|-
|align="center"| 12||1 Major Loot Boost (larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another.) Can stockpile up to 10 unredeemed Major Loot Boosts.
|-
|align="center"| 13||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 14||1 Minor Loot Boost. Can stockpile up to 10 unredeemed Minor Loot Boosts.
|-
|align="center"| 15||1 Bounty Boost. Can stockpile up to 10 unredeemed Bounty Boosts.
|-
|align="center"| 16||1 Enhancive Boost. Can stockpile up to 10 unredeemed Enhancive Boosts.
|-
|align="center"| 17||2 uses of the Urchin Runners. Can stockpile up to 10 unredeemed Urchin Runner uses.
|-
|align="center"| 18||1 Encumbrance Boost. Can stockpile up to 10 unredeemed Encumbrance Boosts.
|-
|align="center"| 19||1 Guild Boost
|-
|align="center"| 20||1 Instant Mind Clearer (instantly moves 1000 current field exp into their absorbed exp pool. It does not apply any RPA, XXX, or other modifiers to this amount)
|-
|align="center"| 21||1 [[Death's Sting|Deathsting]] Reducer (reduces deathsting penalties by 1 priestess potion sip per use)
|-
|align="center"| 22||2 hours of Bounty Waivers. Can stockpile up to 10 uses at once.
|-
|align="center"| 23||1 Major Loot Boost(Larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another)
|-
|align="center"| 24||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 25||2 Item Superchargers (when activated, any standard flaring gear that the character uses will flare more often, any weighted/padded/sighted gear will gain bonus additional weighting/padding/sighting, and any item's enchantment bonus will provide an extra 50% bonus to AS/DS for 15 minutes)
|-
|align="center"| 26||2 Luck Boosters (When activated, all standard offensive combat rolls made by the character will reroll d100 results of 10 or less (keeping the new number if it is higher) for 15 minutes)
|-
|align="center"| 27||3-day [[society]] pass
|-
|align="center"| 28||2 Major Loot Boosts
|-
|align="center"| 29||1 Gift of the Gods. You can only choose Lorminstra (5 deeds) and can only stockpile 1 unredeemed. Be sure to redeem it before your next 29-day reward rolls around or you will lose that one.
|-
|align="center"| 30||2 Doubled Experience Boosters (Double experience absorption for 15 minutes.) Can stockpile only '''1''' unredeemed Doubled Experience Booster. Make sure to use both of them before the next 30-day reward rolls around.
|}

==Official Message Boards==
As of May 2016, F2P accounts only have access to selected sections of the official message boards, all of which are linked here:

*[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/view Officials F2P Discussions main folder]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/Announcements/view Announcements]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Subscription/view F2P Subscription]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20General%20Discussion/view F2P General Discussion]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Game%20Mechanics/view F2P Game Mechanics]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Professions/view F2P Professions]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20World%20Discussions/view F2P World Discussions]

*[http://forums.play.net/forums/GemStone%20IV/Help%20for%20Players/view Help for Players main folder]
*[http://forums.play.net/forums/GemStone%20IV/Software%20&%20Hardware%20Help/view Software & Hardware Help main folder]
*[http://forums.play.net/forums/GemStone%20IV/Socializing/view Socializing main folder]
*[http://forums.play.net/forums/GemStone%20IV/The%20Marketplace/view The Marketplace main folder]

==Resources==
*[[Login Rewards]]
*[http://forum.gsplayers.com/showthread.php?94776-Getting-Lich-to-work-with-F2P-accounts Getting Lich to work with F2P]
*[http://forum.gsplayers.com/showthread.php?95891-F2P-Experience&p=1773183#post1773183 F2P Experience Penalty Analysis]
*[http://forum.gsplayers.com/showthread.php?96614-F2P-Spell-Research Maerit's F2P Spell Research]
*[http://forum.gsplayers.com/showthread.php?94753-F2P-thread Unofficial's general F2P thread]

[[category: Subscriptions]]

F2P subscription

2021-06-19T04:23:07Z

DOUG: /* Login Rewards */ - Adding limit for Day 17 Rewards F2P (10 Urchin Runner uses)

'''F2P subscriptions''' were created in 2015 as an option for new accounts only, with no character transfers allowed. This subscription is highly restricted (see specifics below), with passes around the restrictions available through the [[SimuCoin#F2P_Subscription_Items|SimuCoin Store]]. None of these items, however, will provide a greater mechanical benefit than what can be obtained by having a [[standard subscription]].

Once an account is upgraded to a monthly paying subscription (standard or [[premium]]), it cannot be reverted back.

==Experience==
*The weekly Gift of Lumnis does not occur. It is accessible via a pass.
*Experience absorption is less efficient on a sliding scale. The first 10 levels are unchanged. After level 10, the efficiency of absorption gradually decreases. This can be fully or partially offset with [[experience pass]]es.
*Experience gained per monster killed is also reduced under same scale.
*Field experience cannot be absorbed while logged off.
*There is no bonus experience point per pulse absorbed while grouped with a non-F2P character.
*No yearly [[fixskills]].

The exact formula of exp loss is not yet known, but so far research tends to favor the formula for on-node exp loss: Exp Loss Per Pulse = (Level - 10) / 1.75 .
So for instance, a typical character will see loss per pulse similar to this table...
:{| {{prettytable|1=text-align:center}}
!align="right"|Level||10||15||20||25||30
|-
|align="right"|Exp Loss Per Pulse On-Node||0||3||6||10||13
|}
This is a severely debilitating loss above level 25ish. Beyond that point levels will take 50+ hours of gametime to achieve.

==Organization Access==
*One task per hour will be available from the [[Adventurer's Guild]]. This can be upgraded to 1 task per 30 minutes with an Adventure Boost.
*Cannot gain [[Artisan Guild]] ranks. Will allow access purchases down the line.
*Can gain the first rank of a [[society]] and advance to the cusp of the 2nd rank. A society pass is required to gain rank 2 and beyond, as well as use any powers beyond 2nd rank. (Any ranks above 2 earned during Society Pass will remain but unusable after boost expires with no penalties or down ranking will occurring due to lack of attendance to duties. Last gained rank returned on pass renewal.)
*Cannot join a profession [[guild]]. Will allow access purchases down the line.
*Cannot join [[CHE]]s.

==Combat/Magic==
*No direct PvP attacks allowed. Mass Attack spells like [[Elemental Wave (410)]] that can hit players as well as creatures have a 30 second cooldown (to prevent careless spamming). If actually used to attack another player, this cooldown increases to 5 minutes (cooldown can be removed with a cooldown remover).
*Spells that significantly impact a room without attacking a player (notably [[Minor Sanctuary]]) are restricted from use.
*Attack spells (vs. creatures) are largely unrestricted, aside from the mass attack spell limitations noted above. Sorcerers may cast [[Focused Implosion]].
*All beneficial spells are self-cast only, except for [[Spirit Warding I (101)]], [[Elemental Defense I (401)]], and [[Foresight (1204)]] which may be cast on others up to the 2 hour duration limit. Mass spells [[Mass Blur (911)]], [[Natural Colors (601)]] (evoked), and [[Mass Elemental Defense (419)]] will buff yourself but not your party. [[ARMOR]] abilities are also self-cast only. A casting pass allows casting on anyone else. If the caster does not have a casting pass, the receiving player can choose to purchase a receiving pass to allow any F2P caster to cast upon them. Only one pass needs to be present.
*All beneficial spell [[duration]]s cap at 2 hours.
*Permanent/Long-term item boosts have complete/partial restrictions ([[Enchant Item]], [[Charge Item]], [[Magic Item Creation]], [[Imbue]], [[Resist Nature]], [[Scroll Infusion]], [[Holy Receptacle]], [[Ensorcell]], Damage Specializations, etc.).
*Utility spells such as teleportation, locate, and such have a four hour cooldown period between each use. These cooldowns can be removed with a cooldown remover.
*Only access to random attunement, unless a purchase is made to select one.
*Only access to one particular sort of pet for pet spells (Call Familiar, Animal Companion, etc).
*[[Loresinging]] is restricted, unless a pass is purchased which allows loresinging on a per item basis.
*Cannot [[SEND]] mana. A casting pass purchased by one of the parties will remove this restriction.
*Warriors cannot protect another player using {{boldmono|[[GUARD (verb)|GUARD]]}} or {{boldmono|[[PROTECT (verb)|PROTECT]]}}

Listed above are the general rules for casting, and these are the exceptions found so far...
*[[Spirit Fog (106)]] is unrestricted, you may fog up rooms as you wish.
*[[Stun Relief (108)]] is unrestricted, you may unstun as many players as you wish.
*[[Undisease (113)]] is unrestricted, you may undisease as many players as you wish.
*[[Unpoison (114)]] is unrestricted, you may unpoison as many players as you wish.
*[[Manna (203)]] is unrestricted, you may create this and give to anyone.
*[[Light (205)]] is unrestricted, you may brighten/darken a room as you wish.
*[[Untrammel (209)]] is unrestricted, you may unweb as many players as you wish.
*[[Bless (304)]] is unrestricted, you may bless as many items as you like but each bless is capped at 50 swings.
*[[Preservation (305)]] is unrestricted, you may lifekeep as many players as you like.
*[[Holy Receptacle (325)]] is completely unusable even for yourself.
*[[Elemental Detection (405)]] is unrestricted, you may detect spells on players and in items.
*[[Elemental Blade (411)]] is unrestricted, you may eblade your weapons and those of others.
*[[Herb Production (1118)]] is unrestricted, you may grow all the herbs you want.
*[[Troll's Blood (1125)]] does in fact buff your party, and can even be cast over the 2 hour limit.
*[[Vertigo (1219)]] does not suffer from the normal AOE limit of 4 hours.
*[[Consecrate (1604)]] is unrestricted, you may consecrate all you want.
*[[Arm of the Arkati (1605)]] extends to your group.
*Paladin auras extend to your group: [[Divine Shield (1609)]], [[Zealot (1617)]], [[Fervor (1618)]].

==Healing/Raising==
*The last 10 players healed are kept track of. Each time a new person is healed, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A healing pass increases this to 4 times.
*An empath must first [[empathic linking|link]] (via [[TOUCH]]) to their prospective client. This linking process takes 30 seconds (15 with a healing pass). Once established, the link lasts for 3 minutes. All wound transfers done during this link are considered part of a single healing session (one entry on the above list).
*The last 10 players raised are kept track of. Each time a new person is raised, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A pass removes this restriction.
*A cleric must have a Resurrection Pass active to use a [[chrism]].

==Treasure/Items/Banks==
*Creatures which are more than 10 levels below the player's level are not eligible for ANY treasure production, including but not limited to any treasure generated when searching, looting, or skinning.
*In-bank limits start at 100,000 and can be permanently increased in 100,000 silver increments pretty cheaply.
*5k in-pocket silver maximum to hunt with (can carry as much as desired outside of combat). Waived with a Treasure Boost.
*One bank account (F2P accounts will receive a warning before using a bank for the first time as they need to pay to move it from town to town).
*Notes cost 1% more.
*Silvers apply twice as much encumbrance.
*50k daily treasure cap. Cap can be reset with a Treasure Cap Reset. Lowered treasure per kill. Expanded to 100k cap with a Treasure Boost, and increased treasure. Limits on Purify silver value boosts and increased difficulty.
*Shop prices are less favorable.
*No base access to a [[locker]]. Can purchase a temporary 10 item locker pass, or the existing locker upgrades (both permanent and temporary).
*100 item personal carry limit. Can be expanded to 300 items with a pass.
*Can use up to 5x (+25) gear (any additional bonus is not applied). Similarly limited to "somewhat" padding/weighting/sighting. Gear passes are available that allow the full benefit of any equipment's enchantment, weighting, padding, sighting, TD enhancement, or Defensive Bonus (DB), just like a paid subscriber.

==Geography==
*During the release, transportation to [[River's Rest]] and [[Teras Isle]] was said to restricted by boat or teleportation. [[Chronomage]] orb purchases are similarly restricted in-game and thus, the player must purchase one from the SimuCoin store.
* The boot to River's Rest prevents F2P travel by foot and directs the player to purchase a Chronomage orb from the store.
* Passage on the smuggler's cutter to River's Rest is not restricted.
* TBD on whether Teras ticket purchase is also restricted.

==Miscellaneous==
*Lockpicking (and popping/bashing) limited to self-found boxes only. Plans for this to change based on how the rotating lists for healing/raising work.
*Foraging is harder. F2P cannot take the last two forageables out of a room. Max 15 items per hour. Foraging pass removes restrictions and makes foraging easier.
*Pickpocketing skill cannot be used to steal from other player characters.

==Login Rewards==
[[Login Rewards]] are awarded to characters that login daily on all types of accounts, but F2P subscribers receive fewer or a lesser form of what paying subscribers receive, as well as limits on the amount of rewards that can be stockpiled. Also, F2P subscribers must logout and login each day (past 00:00 on game [[TIME]]) as the system will not keep track automatically for them.

Currently F2P is limited to stockpile 1 Gift of the Gods and 1 Experience Booster, so they should be spent every month. In addition, only 2 daily [[Login bridge|login bridges]] may be stockpiled through login rewards, so at most one can only miss 2 consecutive days of logins to maintain a streak (without obtaining bridges from an alternate source).
{| {{prettytable}} width="80%"
|-bgcolor="lightblue"
!width="7%"|DAY
!REWARD
|-
|align="center"| 1||500 fame
|-
|align="center"| 2||1 random magical crystal ([[blue crystal|blue]]/[[white crystal|white]]/[[black crystal|black]]). Can stockpile up to 5 uses at once.
|-
|align="center"| 3||1 Minor Loot Boost (small boost on [[LOOT]] rolls for 15 minutes)
|-
|align="center"| 4||1 Temporary Urchin Guide access (access to the [[URCHIN]] guides for 15 minutes)
|-
|align="center"| 5||1 Bounty Boost (reduces all bounty wait times (to a nominal few seconds) until the character shares a task or successfully completes it, max 1 hour)
|-
|align="center"| 6||1 Enhancive Boost (player's choice of either 5 enhancive pauses, or 15 minutes of +5 to all Base Stat Bonuses, or 15 minutes of +15 to Stamina and Mana Regen)
|-
|align="center"| 7||1 Urchin Runner (allows characters to use the remote [[BANK (verb)|BANK]] and [[LOCKER]] access commands. Comes with a free 15 minutes of LOCKER MANIFEST access)
|-
|align="center"| 8||1 Encumbrance Boost (minus 50 lbs to effective encumbrance for 15 minutes)
|-
|align="center"| 9||1 Guild Boost (player's choice of either doubled TPs earned for each profession guild task or another use of the Bounty Boosts)
|-
|align="center"| 10||1 Lesser Experience Pass (60 minute Exp Pass)
|-
|align="center"| 11||2 hours of Bounty Waivers (choose one Adventurer Guild task type (Forage Herbs, Escort NPC, etc) that they do not want to get assigned for the duration). Can stockpile up to 10 unredeemed Bounty Waivers.
|-
|align="center"| 12||1 Major Loot Boost (larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another.) Can stockpile up to 10 unredeemed Major Loot Boosts.
|-
|align="center"| 13||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 14||1 Minor Loot Boost. Can stockpile up to 10 unredeemed Minor Loot Boosts.
|-
|align="center"| 15||1 Bounty Boost. Can stockpile up to 10 unredeemed Bounty Boosts.
|-
|align="center"| 16||1 Enhancive Boost. Can stockpile up to 10 unredeemed Enhancive Boosts.
|-
|align="center"| 17||2 uses of the Urchin Runners. Can stockpile up to 10 unredeemed Urchin Runner uses.
|-
|align="center"| 18||1 Encumbrance Boost
|-
|align="center"| 19||1 Guild Boost
|-
|align="center"| 20||1 Instant Mind Clearer (instantly moves 1000 current field exp into their absorbed exp pool. It does not apply any RPA, XXX, or other modifiers to this amount)
|-
|align="center"| 21||1 [[Death's Sting|Deathsting]] Reducer (reduces deathsting penalties by 1 priestess potion sip per use)
|-
|align="center"| 22||2 hours of Bounty Waivers. Can stockpile up to 10 uses at once.
|-
|align="center"| 23||1 Major Loot Boost(Larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another)
|-
|align="center"| 24||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 25||2 Item Superchargers (when activated, any standard flaring gear that the character uses will flare more often, any weighted/padded/sighted gear will gain bonus additional weighting/padding/sighting, and any item's enchantment bonus will provide an extra 50% bonus to AS/DS for 15 minutes)
|-
|align="center"| 26||2 Luck Boosters (When activated, all standard offensive combat rolls made by the character will reroll d100 results of 10 or less (keeping the new number if it is higher) for 15 minutes)
|-
|align="center"| 27||3-day [[society]] pass
|-
|align="center"| 28||2 Major Loot Boosts
|-
|align="center"| 29||1 Gift of the Gods. You can only choose Lorminstra (5 deeds) and can only stockpile 1 unredeemed. Be sure to redeem it before your next 29-day reward rolls around or you will lose that one.
|-
|align="center"| 30||2 Doubled Experience Boosters (Double experience absorption for 15 minutes.) Can stockpile only '''1''' unredeemed Doubled Experience Booster. Make sure to use both of them before the next 30-day reward rolls around.
|}

==Official Message Boards==
As of May 2016, F2P accounts only have access to selected sections of the official message boards, all of which are linked here:

*[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/view Officials F2P Discussions main folder]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/Announcements/view Announcements]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Subscription/view F2P Subscription]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20General%20Discussion/view F2P General Discussion]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Game%20Mechanics/view F2P Game Mechanics]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Professions/view F2P Professions]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20World%20Discussions/view F2P World Discussions]

*[http://forums.play.net/forums/GemStone%20IV/Help%20for%20Players/view Help for Players main folder]
*[http://forums.play.net/forums/GemStone%20IV/Software%20&%20Hardware%20Help/view Software & Hardware Help main folder]
*[http://forums.play.net/forums/GemStone%20IV/Socializing/view Socializing main folder]
*[http://forums.play.net/forums/GemStone%20IV/The%20Marketplace/view The Marketplace main folder]

==Resources==
*[[Login Rewards]]
*[http://forum.gsplayers.com/showthread.php?94776-Getting-Lich-to-work-with-F2P-accounts Getting Lich to work with F2P]
*[http://forum.gsplayers.com/showthread.php?95891-F2P-Experience&p=1773183#post1773183 F2P Experience Penalty Analysis]
*[http://forum.gsplayers.com/showthread.php?96614-F2P-Spell-Research Maerit's F2P Spell Research]
*[http://forum.gsplayers.com/showthread.php?94753-F2P-thread Unofficial's general F2P thread]

[[category: Subscriptions]]

F2P subscription

2021-06-18T04:23:35Z

DOUG: /* Login Rewards */ - Adding limit for Day 16 Rewards F2P (10 Enhancive Boosts)

'''F2P subscriptions''' were created in 2015 as an option for new accounts only, with no character transfers allowed. This subscription is highly restricted (see specifics below), with passes around the restrictions available through the [[SimuCoin#F2P_Subscription_Items|SimuCoin Store]]. None of these items, however, will provide a greater mechanical benefit than what can be obtained by having a [[standard subscription]].

Once an account is upgraded to a monthly paying subscription (standard or [[premium]]), it cannot be reverted back.

==Experience==
*The weekly Gift of Lumnis does not occur. It is accessible via a pass.
*Experience absorption is less efficient on a sliding scale. The first 10 levels are unchanged. After level 10, the efficiency of absorption gradually decreases. This can be fully or partially offset with [[experience pass]]es.
*Experience gained per monster killed is also reduced under same scale.
*Field experience cannot be absorbed while logged off.
*There is no bonus experience point per pulse absorbed while grouped with a non-F2P character.
*No yearly [[fixskills]].

The exact formula of exp loss is not yet known, but so far research tends to favor the formula for on-node exp loss: Exp Loss Per Pulse = (Level - 10) / 1.75 .
So for instance, a typical character will see loss per pulse similar to this table...
:{| {{prettytable|1=text-align:center}}
!align="right"|Level||10||15||20||25||30
|-
|align="right"|Exp Loss Per Pulse On-Node||0||3||6||10||13
|}
This is a severely debilitating loss above level 25ish. Beyond that point levels will take 50+ hours of gametime to achieve.

==Organization Access==
*One task per hour will be available from the [[Adventurer's Guild]]. This can be upgraded to 1 task per 30 minutes with an Adventure Boost.
*Cannot gain [[Artisan Guild]] ranks. Will allow access purchases down the line.
*Can gain the first rank of a [[society]] and advance to the cusp of the 2nd rank. A society pass is required to gain rank 2 and beyond, as well as use any powers beyond 2nd rank. (Any ranks above 2 earned during Society Pass will remain but unusable after boost expires with no penalties or down ranking will occurring due to lack of attendance to duties. Last gained rank returned on pass renewal.)
*Cannot join a profession [[guild]]. Will allow access purchases down the line.
*Cannot join [[CHE]]s.

==Combat/Magic==
*No direct PvP attacks allowed. Mass Attack spells like [[Elemental Wave (410)]] that can hit players as well as creatures have a 30 second cooldown (to prevent careless spamming). If actually used to attack another player, this cooldown increases to 5 minutes (cooldown can be removed with a cooldown remover).
*Spells that significantly impact a room without attacking a player (notably [[Minor Sanctuary]]) are restricted from use.
*Attack spells (vs. creatures) are largely unrestricted, aside from the mass attack spell limitations noted above. Sorcerers may cast [[Focused Implosion]].
*All beneficial spells are self-cast only, except for [[Spirit Warding I (101)]], [[Elemental Defense I (401)]], and [[Foresight (1204)]] which may be cast on others up to the 2 hour duration limit. Mass spells [[Mass Blur (911)]], [[Natural Colors (601)]] (evoked), and [[Mass Elemental Defense (419)]] will buff yourself but not your party. [[ARMOR]] abilities are also self-cast only. A casting pass allows casting on anyone else. If the caster does not have a casting pass, the receiving player can choose to purchase a receiving pass to allow any F2P caster to cast upon them. Only one pass needs to be present.
*All beneficial spell [[duration]]s cap at 2 hours.
*Permanent/Long-term item boosts have complete/partial restrictions ([[Enchant Item]], [[Charge Item]], [[Magic Item Creation]], [[Imbue]], [[Resist Nature]], [[Scroll Infusion]], [[Holy Receptacle]], [[Ensorcell]], Damage Specializations, etc.).
*Utility spells such as teleportation, locate, and such have a four hour cooldown period between each use. These cooldowns can be removed with a cooldown remover.
*Only access to random attunement, unless a purchase is made to select one.
*Only access to one particular sort of pet for pet spells (Call Familiar, Animal Companion, etc).
*[[Loresinging]] is restricted, unless a pass is purchased which allows loresinging on a per item basis.
*Cannot [[SEND]] mana. A casting pass purchased by one of the parties will remove this restriction.
*Warriors cannot protect another player using {{boldmono|[[GUARD (verb)|GUARD]]}} or {{boldmono|[[PROTECT (verb)|PROTECT]]}}

Listed above are the general rules for casting, and these are the exceptions found so far...
*[[Spirit Fog (106)]] is unrestricted, you may fog up rooms as you wish.
*[[Stun Relief (108)]] is unrestricted, you may unstun as many players as you wish.
*[[Undisease (113)]] is unrestricted, you may undisease as many players as you wish.
*[[Unpoison (114)]] is unrestricted, you may unpoison as many players as you wish.
*[[Manna (203)]] is unrestricted, you may create this and give to anyone.
*[[Light (205)]] is unrestricted, you may brighten/darken a room as you wish.
*[[Untrammel (209)]] is unrestricted, you may unweb as many players as you wish.
*[[Bless (304)]] is unrestricted, you may bless as many items as you like but each bless is capped at 50 swings.
*[[Preservation (305)]] is unrestricted, you may lifekeep as many players as you like.
*[[Holy Receptacle (325)]] is completely unusable even for yourself.
*[[Elemental Detection (405)]] is unrestricted, you may detect spells on players and in items.
*[[Elemental Blade (411)]] is unrestricted, you may eblade your weapons and those of others.
*[[Herb Production (1118)]] is unrestricted, you may grow all the herbs you want.
*[[Troll's Blood (1125)]] does in fact buff your party, and can even be cast over the 2 hour limit.
*[[Vertigo (1219)]] does not suffer from the normal AOE limit of 4 hours.
*[[Consecrate (1604)]] is unrestricted, you may consecrate all you want.
*[[Arm of the Arkati (1605)]] extends to your group.
*Paladin auras extend to your group: [[Divine Shield (1609)]], [[Zealot (1617)]], [[Fervor (1618)]].

==Healing/Raising==
*The last 10 players healed are kept track of. Each time a new person is healed, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A healing pass increases this to 4 times.
*An empath must first [[empathic linking|link]] (via [[TOUCH]]) to their prospective client. This linking process takes 30 seconds (15 with a healing pass). Once established, the link lasts for 3 minutes. All wound transfers done during this link are considered part of a single healing session (one entry on the above list).
*The last 10 players raised are kept track of. Each time a new person is raised, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A pass removes this restriction.
*A cleric must have a Resurrection Pass active to use a [[chrism]].

==Treasure/Items/Banks==
*Creatures which are more than 10 levels below the player's level are not eligible for ANY treasure production, including but not limited to any treasure generated when searching, looting, or skinning.
*In-bank limits start at 100,000 and can be permanently increased in 100,000 silver increments pretty cheaply.
*5k in-pocket silver maximum to hunt with (can carry as much as desired outside of combat). Waived with a Treasure Boost.
*One bank account (F2P accounts will receive a warning before using a bank for the first time as they need to pay to move it from town to town).
*Notes cost 1% more.
*Silvers apply twice as much encumbrance.
*50k daily treasure cap. Cap can be reset with a Treasure Cap Reset. Lowered treasure per kill. Expanded to 100k cap with a Treasure Boost, and increased treasure. Limits on Purify silver value boosts and increased difficulty.
*Shop prices are less favorable.
*No base access to a [[locker]]. Can purchase a temporary 10 item locker pass, or the existing locker upgrades (both permanent and temporary).
*100 item personal carry limit. Can be expanded to 300 items with a pass.
*Can use up to 5x (+25) gear (any additional bonus is not applied). Similarly limited to "somewhat" padding/weighting/sighting. Gear passes are available that allow the full benefit of any equipment's enchantment, weighting, padding, sighting, TD enhancement, or Defensive Bonus (DB), just like a paid subscriber.

==Geography==
*During the release, transportation to [[River's Rest]] and [[Teras Isle]] was said to restricted by boat or teleportation. [[Chronomage]] orb purchases are similarly restricted in-game and thus, the player must purchase one from the SimuCoin store.
* The boot to River's Rest prevents F2P travel by foot and directs the player to purchase a Chronomage orb from the store.
* Passage on the smuggler's cutter to River's Rest is not restricted.
* TBD on whether Teras ticket purchase is also restricted.

==Miscellaneous==
*Lockpicking (and popping/bashing) limited to self-found boxes only. Plans for this to change based on how the rotating lists for healing/raising work.
*Foraging is harder. F2P cannot take the last two forageables out of a room. Max 15 items per hour. Foraging pass removes restrictions and makes foraging easier.
*Pickpocketing skill cannot be used to steal from other player characters.

==Login Rewards==
[[Login Rewards]] are awarded to characters that login daily on all types of accounts, but F2P subscribers receive fewer or a lesser form of what paying subscribers receive, as well as limits on the amount of rewards that can be stockpiled. Also, F2P subscribers must logout and login each day (past 00:00 on game [[TIME]]) as the system will not keep track automatically for them.

Currently F2P is limited to stockpile 1 Gift of the Gods and 1 Experience Booster, so they should be spent every month. In addition, only 2 daily [[Login bridge|login bridges]] may be stockpiled through login rewards, so at most one can only miss 2 consecutive days of logins to maintain a streak (without obtaining bridges from an alternate source).
{| {{prettytable}} width="80%"
|-bgcolor="lightblue"
!width="7%"|DAY
!REWARD
|-
|align="center"| 1||500 fame
|-
|align="center"| 2||1 random magical crystal ([[blue crystal|blue]]/[[white crystal|white]]/[[black crystal|black]]). Can stockpile up to 5 uses at once.
|-
|align="center"| 3||1 Minor Loot Boost (small boost on [[LOOT]] rolls for 15 minutes)
|-
|align="center"| 4||1 Temporary Urchin Guide access (access to the [[URCHIN]] guides for 15 minutes)
|-
|align="center"| 5||1 Bounty Boost (reduces all bounty wait times (to a nominal few seconds) until the character shares a task or successfully completes it, max 1 hour)
|-
|align="center"| 6||1 Enhancive Boost (player's choice of either 5 enhancive pauses, or 15 minutes of +5 to all Base Stat Bonuses, or 15 minutes of +15 to Stamina and Mana Regen)
|-
|align="center"| 7||1 Urchin Runner (allows characters to use the remote [[BANK (verb)|BANK]] and [[LOCKER]] access commands. Comes with a free 15 minutes of LOCKER MANIFEST access)
|-
|align="center"| 8||1 Encumbrance Boost (minus 50 lbs to effective encumbrance for 15 minutes)
|-
|align="center"| 9||1 Guild Boost (player's choice of either doubled TPs earned for each profession guild task or another use of the Bounty Boosts)
|-
|align="center"| 10||1 Lesser Experience Pass (60 minute Exp Pass)
|-
|align="center"| 11||2 hours of Bounty Waivers (choose one Adventurer Guild task type (Forage Herbs, Escort NPC, etc) that they do not want to get assigned for the duration). Can stockpile up to 10 unredeemed Bounty Waivers.
|-
|align="center"| 12||1 Major Loot Boost (larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another.) Can stockpile up to 10 unredeemed Major Loot Boosts.
|-
|align="center"| 13||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 14||1 Minor Loot Boost. Can stockpile up to 10 unredeemed Minor Loot Boosts.
|-
|align="center"| 15||1 Bounty Boost. Can stockpile up to 10 unredeemed Bounty Boosts.
|-
|align="center"| 16||1 Enhancive Boost. Can stockpile up to 10 unredeemed Enhancive Boosts.
|-
|align="center"| 17||2 uses of the Urchin Runners
|-
|align="center"| 18||1 Encumbrance Boost
|-
|align="center"| 19||1 Guild Boost
|-
|align="center"| 20||1 Instant Mind Clearer (instantly moves 1000 current field exp into their absorbed exp pool. It does not apply any RPA, XXX, or other modifiers to this amount)
|-
|align="center"| 21||1 [[Death's Sting|Deathsting]] Reducer (reduces deathsting penalties by 1 priestess potion sip per use)
|-
|align="center"| 22||2 hours of Bounty Waivers. Can stockpile up to 10 uses at once.
|-
|align="center"| 23||1 Major Loot Boost(Larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another)
|-
|align="center"| 24||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 25||2 Item Superchargers (when activated, any standard flaring gear that the character uses will flare more often, any weighted/padded/sighted gear will gain bonus additional weighting/padding/sighting, and any item's enchantment bonus will provide an extra 50% bonus to AS/DS for 15 minutes)
|-
|align="center"| 26||2 Luck Boosters (When activated, all standard offensive combat rolls made by the character will reroll d100 results of 10 or less (keeping the new number if it is higher) for 15 minutes)
|-
|align="center"| 27||3-day [[society]] pass
|-
|align="center"| 28||2 Major Loot Boosts
|-
|align="center"| 29||1 Gift of the Gods. You can only choose Lorminstra (5 deeds) and can only stockpile 1 unredeemed. Be sure to redeem it before your next 29-day reward rolls around or you will lose that one.
|-
|align="center"| 30||2 Doubled Experience Boosters (Double experience absorption for 15 minutes.) Can stockpile only '''1''' unredeemed Doubled Experience Booster. Make sure to use both of them before the next 30-day reward rolls around.
|}

==Official Message Boards==
As of May 2016, F2P accounts only have access to selected sections of the official message boards, all of which are linked here:

*[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/view Officials F2P Discussions main folder]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/Announcements/view Announcements]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Subscription/view F2P Subscription]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20General%20Discussion/view F2P General Discussion]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Game%20Mechanics/view F2P Game Mechanics]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Professions/view F2P Professions]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20World%20Discussions/view F2P World Discussions]

*[http://forums.play.net/forums/GemStone%20IV/Help%20for%20Players/view Help for Players main folder]
*[http://forums.play.net/forums/GemStone%20IV/Software%20&%20Hardware%20Help/view Software & Hardware Help main folder]
*[http://forums.play.net/forums/GemStone%20IV/Socializing/view Socializing main folder]
*[http://forums.play.net/forums/GemStone%20IV/The%20Marketplace/view The Marketplace main folder]

==Resources==
*[[Login Rewards]]
*[http://forum.gsplayers.com/showthread.php?94776-Getting-Lich-to-work-with-F2P-accounts Getting Lich to work with F2P]
*[http://forum.gsplayers.com/showthread.php?95891-F2P-Experience&p=1773183#post1773183 F2P Experience Penalty Analysis]
*[http://forum.gsplayers.com/showthread.php?96614-F2P-Spell-Research Maerit's F2P Spell Research]
*[http://forum.gsplayers.com/showthread.php?94753-F2P-thread Unofficial's general F2P thread]

[[category: Subscriptions]]

F2P subscription

2021-06-17T13:14:07Z

DOUG: /* Login Rewards */ - Adding limit for Day 15 rewards F2P (10 Bounty Boosts)

'''F2P subscriptions''' were created in 2015 as an option for new accounts only, with no character transfers allowed. This subscription is highly restricted (see specifics below), with passes around the restrictions available through the [[SimuCoin#F2P_Subscription_Items|SimuCoin Store]]. None of these items, however, will provide a greater mechanical benefit than what can be obtained by having a [[standard subscription]].

Once an account is upgraded to a monthly paying subscription (standard or [[premium]]), it cannot be reverted back.

==Experience==
*The weekly Gift of Lumnis does not occur. It is accessible via a pass.
*Experience absorption is less efficient on a sliding scale. The first 10 levels are unchanged. After level 10, the efficiency of absorption gradually decreases. This can be fully or partially offset with [[experience pass]]es.
*Experience gained per monster killed is also reduced under same scale.
*Field experience cannot be absorbed while logged off.
*There is no bonus experience point per pulse absorbed while grouped with a non-F2P character.
*No yearly [[fixskills]].

The exact formula of exp loss is not yet known, but so far research tends to favor the formula for on-node exp loss: Exp Loss Per Pulse = (Level - 10) / 1.75 .
So for instance, a typical character will see loss per pulse similar to this table...
:{| {{prettytable|1=text-align:center}}
!align="right"|Level||10||15||20||25||30
|-
|align="right"|Exp Loss Per Pulse On-Node||0||3||6||10||13
|}
This is a severely debilitating loss above level 25ish. Beyond that point levels will take 50+ hours of gametime to achieve.

==Organization Access==
*One task per hour will be available from the [[Adventurer's Guild]]. This can be upgraded to 1 task per 30 minutes with an Adventure Boost.
*Cannot gain [[Artisan Guild]] ranks. Will allow access purchases down the line.
*Can gain the first rank of a [[society]] and advance to the cusp of the 2nd rank. A society pass is required to gain rank 2 and beyond, as well as use any powers beyond 2nd rank. (Any ranks above 2 earned during Society Pass will remain but unusable after boost expires with no penalties or down ranking will occurring due to lack of attendance to duties. Last gained rank returned on pass renewal.)
*Cannot join a profession [[guild]]. Will allow access purchases down the line.
*Cannot join [[CHE]]s.

==Combat/Magic==
*No direct PvP attacks allowed. Mass Attack spells like [[Elemental Wave (410)]] that can hit players as well as creatures have a 30 second cooldown (to prevent careless spamming). If actually used to attack another player, this cooldown increases to 5 minutes (cooldown can be removed with a cooldown remover).
*Spells that significantly impact a room without attacking a player (notably [[Minor Sanctuary]]) are restricted from use.
*Attack spells (vs. creatures) are largely unrestricted, aside from the mass attack spell limitations noted above. Sorcerers may cast [[Focused Implosion]].
*All beneficial spells are self-cast only, except for [[Spirit Warding I (101)]], [[Elemental Defense I (401)]], and [[Foresight (1204)]] which may be cast on others up to the 2 hour duration limit. Mass spells [[Mass Blur (911)]], [[Natural Colors (601)]] (evoked), and [[Mass Elemental Defense (419)]] will buff yourself but not your party. [[ARMOR]] abilities are also self-cast only. A casting pass allows casting on anyone else. If the caster does not have a casting pass, the receiving player can choose to purchase a receiving pass to allow any F2P caster to cast upon them. Only one pass needs to be present.
*All beneficial spell [[duration]]s cap at 2 hours.
*Permanent/Long-term item boosts have complete/partial restrictions ([[Enchant Item]], [[Charge Item]], [[Magic Item Creation]], [[Imbue]], [[Resist Nature]], [[Scroll Infusion]], [[Holy Receptacle]], [[Ensorcell]], Damage Specializations, etc.).
*Utility spells such as teleportation, locate, and such have a four hour cooldown period between each use. These cooldowns can be removed with a cooldown remover.
*Only access to random attunement, unless a purchase is made to select one.
*Only access to one particular sort of pet for pet spells (Call Familiar, Animal Companion, etc).
*[[Loresinging]] is restricted, unless a pass is purchased which allows loresinging on a per item basis.
*Cannot [[SEND]] mana. A casting pass purchased by one of the parties will remove this restriction.
*Warriors cannot protect another player using {{boldmono|[[GUARD (verb)|GUARD]]}} or {{boldmono|[[PROTECT (verb)|PROTECT]]}}

Listed above are the general rules for casting, and these are the exceptions found so far...
*[[Spirit Fog (106)]] is unrestricted, you may fog up rooms as you wish.
*[[Stun Relief (108)]] is unrestricted, you may unstun as many players as you wish.
*[[Undisease (113)]] is unrestricted, you may undisease as many players as you wish.
*[[Unpoison (114)]] is unrestricted, you may unpoison as many players as you wish.
*[[Manna (203)]] is unrestricted, you may create this and give to anyone.
*[[Light (205)]] is unrestricted, you may brighten/darken a room as you wish.
*[[Untrammel (209)]] is unrestricted, you may unweb as many players as you wish.
*[[Bless (304)]] is unrestricted, you may bless as many items as you like but each bless is capped at 50 swings.
*[[Preservation (305)]] is unrestricted, you may lifekeep as many players as you like.
*[[Holy Receptacle (325)]] is completely unusable even for yourself.
*[[Elemental Detection (405)]] is unrestricted, you may detect spells on players and in items.
*[[Elemental Blade (411)]] is unrestricted, you may eblade your weapons and those of others.
*[[Herb Production (1118)]] is unrestricted, you may grow all the herbs you want.
*[[Troll's Blood (1125)]] does in fact buff your party, and can even be cast over the 2 hour limit.
*[[Vertigo (1219)]] does not suffer from the normal AOE limit of 4 hours.
*[[Consecrate (1604)]] is unrestricted, you may consecrate all you want.
*[[Arm of the Arkati (1605)]] extends to your group.
*Paladin auras extend to your group: [[Divine Shield (1609)]], [[Zealot (1617)]], [[Fervor (1618)]].

==Healing/Raising==
*The last 10 players healed are kept track of. Each time a new person is healed, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A healing pass increases this to 4 times.
*An empath must first [[empathic linking|link]] (via [[TOUCH]]) to their prospective client. This linking process takes 30 seconds (15 with a healing pass). Once established, the link lasts for 3 minutes. All wound transfers done during this link are considered part of a single healing session (one entry on the above list).
*The last 10 players raised are kept track of. Each time a new person is raised, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A pass removes this restriction.
*A cleric must have a Resurrection Pass active to use a [[chrism]].

==Treasure/Items/Banks==
*Creatures which are more than 10 levels below the player's level are not eligible for ANY treasure production, including but not limited to any treasure generated when searching, looting, or skinning.
*In-bank limits start at 100,000 and can be permanently increased in 100,000 silver increments pretty cheaply.
*5k in-pocket silver maximum to hunt with (can carry as much as desired outside of combat). Waived with a Treasure Boost.
*One bank account (F2P accounts will receive a warning before using a bank for the first time as they need to pay to move it from town to town).
*Notes cost 1% more.
*Silvers apply twice as much encumbrance.
*50k daily treasure cap. Cap can be reset with a Treasure Cap Reset. Lowered treasure per kill. Expanded to 100k cap with a Treasure Boost, and increased treasure. Limits on Purify silver value boosts and increased difficulty.
*Shop prices are less favorable.
*No base access to a [[locker]]. Can purchase a temporary 10 item locker pass, or the existing locker upgrades (both permanent and temporary).
*100 item personal carry limit. Can be expanded to 300 items with a pass.
*Can use up to 5x (+25) gear (any additional bonus is not applied). Similarly limited to "somewhat" padding/weighting/sighting. Gear passes are available that allow the full benefit of any equipment's enchantment, weighting, padding, sighting, TD enhancement, or Defensive Bonus (DB), just like a paid subscriber.

==Geography==
*During the release, transportation to [[River's Rest]] and [[Teras Isle]] was said to restricted by boat or teleportation. [[Chronomage]] orb purchases are similarly restricted in-game and thus, the player must purchase one from the SimuCoin store.
* The boot to River's Rest prevents F2P travel by foot and directs the player to purchase a Chronomage orb from the store.
* Passage on the smuggler's cutter to River's Rest is not restricted.
* TBD on whether Teras ticket purchase is also restricted.

==Miscellaneous==
*Lockpicking (and popping/bashing) limited to self-found boxes only. Plans for this to change based on how the rotating lists for healing/raising work.
*Foraging is harder. F2P cannot take the last two forageables out of a room. Max 15 items per hour. Foraging pass removes restrictions and makes foraging easier.
*Pickpocketing skill cannot be used to steal from other player characters.

==Login Rewards==
[[Login Rewards]] are awarded to characters that login daily on all types of accounts, but F2P subscribers receive fewer or a lesser form of what paying subscribers receive, as well as limits on the amount of rewards that can be stockpiled. Also, F2P subscribers must logout and login each day (past 00:00 on game [[TIME]]) as the system will not keep track automatically for them.

Currently F2P is limited to stockpile 1 Gift of the Gods and 1 Experience Booster, so they should be spent every month. In addition, only 2 daily [[Login bridge|login bridges]] may be stockpiled through login rewards, so at most one can only miss 2 consecutive days of logins to maintain a streak (without obtaining bridges from an alternate source).
{| {{prettytable}} width="80%"
|-bgcolor="lightblue"
!width="7%"|DAY
!REWARD
|-
|align="center"| 1||500 fame
|-
|align="center"| 2||1 random magical crystal ([[blue crystal|blue]]/[[white crystal|white]]/[[black crystal|black]]). Can stockpile up to 5 uses at once.
|-
|align="center"| 3||1 Minor Loot Boost (small boost on [[LOOT]] rolls for 15 minutes)
|-
|align="center"| 4||1 Temporary Urchin Guide access (access to the [[URCHIN]] guides for 15 minutes)
|-
|align="center"| 5||1 Bounty Boost (reduces all bounty wait times (to a nominal few seconds) until the character shares a task or successfully completes it, max 1 hour)
|-
|align="center"| 6||1 Enhancive Boost (player's choice of either 5 enhancive pauses, or 15 minutes of +5 to all Base Stat Bonuses, or 15 minutes of +15 to Stamina and Mana Regen)
|-
|align="center"| 7||1 Urchin Runner (allows characters to use the remote [[BANK (verb)|BANK]] and [[LOCKER]] access commands. Comes with a free 15 minutes of LOCKER MANIFEST access)
|-
|align="center"| 8||1 Encumbrance Boost (minus 50 lbs to effective encumbrance for 15 minutes)
|-
|align="center"| 9||1 Guild Boost (player's choice of either doubled TPs earned for each profession guild task or another use of the Bounty Boosts)
|-
|align="center"| 10||1 Lesser Experience Pass (60 minute Exp Pass)
|-
|align="center"| 11||2 hours of Bounty Waivers (choose one Adventurer Guild task type (Forage Herbs, Escort NPC, etc) that they do not want to get assigned for the duration). Can stockpile up to 10 unredeemed Bounty Waivers.
|-
|align="center"| 12||1 Major Loot Boost (larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another.) Can stockpile up to 10 unredeemed Major Loot Boosts.
|-
|align="center"| 13||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 14||1 Minor Loot Boost. Can stockpile up to 10 unredeemed Minor Loot Boosts.
|-
|align="center"| 15||1 Bounty Boost. Can stockpile up to 10 unredeemed Bounty Boosts.
|-
|align="center"| 16||1 Enhancive Boost
|-
|align="center"| 17||2 uses of the Urchin Runners
|-
|align="center"| 18||1 Encumbrance Boost
|-
|align="center"| 19||1 Guild Boost
|-
|align="center"| 20||1 Instant Mind Clearer (instantly moves 1000 current field exp into their absorbed exp pool. It does not apply any RPA, XXX, or other modifiers to this amount)
|-
|align="center"| 21||1 [[Death's Sting|Deathsting]] Reducer (reduces deathsting penalties by 1 priestess potion sip per use)
|-
|align="center"| 22||2 hours of Bounty Waivers. Can stockpile up to 10 uses at once.
|-
|align="center"| 23||1 Major Loot Boost(Larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another)
|-
|align="center"| 24||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 25||2 Item Superchargers (when activated, any standard flaring gear that the character uses will flare more often, any weighted/padded/sighted gear will gain bonus additional weighting/padding/sighting, and any item's enchantment bonus will provide an extra 50% bonus to AS/DS for 15 minutes)
|-
|align="center"| 26||2 Luck Boosters (When activated, all standard offensive combat rolls made by the character will reroll d100 results of 10 or less (keeping the new number if it is higher) for 15 minutes)
|-
|align="center"| 27||3-day [[society]] pass
|-
|align="center"| 28||2 Major Loot Boosts
|-
|align="center"| 29||1 Gift of the Gods. You can only choose Lorminstra (5 deeds) and can only stockpile 1 unredeemed. Be sure to redeem it before your next 29-day reward rolls around or you will lose that one.
|-
|align="center"| 30||2 Doubled Experience Boosters (Double experience absorption for 15 minutes.) Can stockpile only '''1''' unredeemed Doubled Experience Booster. Make sure to use both of them before the next 30-day reward rolls around.
|}

==Official Message Boards==
As of May 2016, F2P accounts only have access to selected sections of the official message boards, all of which are linked here:

*[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/view Officials F2P Discussions main folder]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/Announcements/view Announcements]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Subscription/view F2P Subscription]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20General%20Discussion/view F2P General Discussion]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Game%20Mechanics/view F2P Game Mechanics]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Professions/view F2P Professions]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20World%20Discussions/view F2P World Discussions]

*[http://forums.play.net/forums/GemStone%20IV/Help%20for%20Players/view Help for Players main folder]
*[http://forums.play.net/forums/GemStone%20IV/Software%20&%20Hardware%20Help/view Software & Hardware Help main folder]
*[http://forums.play.net/forums/GemStone%20IV/Socializing/view Socializing main folder]
*[http://forums.play.net/forums/GemStone%20IV/The%20Marketplace/view The Marketplace main folder]

==Resources==
*[[Login Rewards]]
*[http://forum.gsplayers.com/showthread.php?94776-Getting-Lich-to-work-with-F2P-accounts Getting Lich to work with F2P]
*[http://forum.gsplayers.com/showthread.php?95891-F2P-Experience&p=1773183#post1773183 F2P Experience Penalty Analysis]
*[http://forum.gsplayers.com/showthread.php?96614-F2P-Spell-Research Maerit's F2P Spell Research]
*[http://forum.gsplayers.com/showthread.php?94753-F2P-thread Unofficial's general F2P thread]

[[category: Subscriptions]]

F2P subscription

2021-06-16T21:09:39Z

DOUG: /* Login Rewards */ - Adding limit for Day 14 rewards F2P (10 Minor Loot Boosts) and consistent-ifying phrases

'''F2P subscriptions''' were created in 2015 as an option for new accounts only, with no character transfers allowed. This subscription is highly restricted (see specifics below), with passes around the restrictions available through the [[SimuCoin#F2P_Subscription_Items|SimuCoin Store]]. None of these items, however, will provide a greater mechanical benefit than what can be obtained by having a [[standard subscription]].

Once an account is upgraded to a monthly paying subscription (standard or [[premium]]), it cannot be reverted back.

==Experience==
*The weekly Gift of Lumnis does not occur. It is accessible via a pass.
*Experience absorption is less efficient on a sliding scale. The first 10 levels are unchanged. After level 10, the efficiency of absorption gradually decreases. This can be fully or partially offset with [[experience pass]]es.
*Experience gained per monster killed is also reduced under same scale.
*Field experience cannot be absorbed while logged off.
*There is no bonus experience point per pulse absorbed while grouped with a non-F2P character.
*No yearly [[fixskills]].

The exact formula of exp loss is not yet known, but so far research tends to favor the formula for on-node exp loss: Exp Loss Per Pulse = (Level - 10) / 1.75 .
So for instance, a typical character will see loss per pulse similar to this table...
:{| {{prettytable|1=text-align:center}}
!align="right"|Level||10||15||20||25||30
|-
|align="right"|Exp Loss Per Pulse On-Node||0||3||6||10||13
|}
This is a severely debilitating loss above level 25ish. Beyond that point levels will take 50+ hours of gametime to achieve.

==Organization Access==
*One task per hour will be available from the [[Adventurer's Guild]]. This can be upgraded to 1 task per 30 minutes with an Adventure Boost.
*Cannot gain [[Artisan Guild]] ranks. Will allow access purchases down the line.
*Can gain the first rank of a [[society]] and advance to the cusp of the 2nd rank. A society pass is required to gain rank 2 and beyond, as well as use any powers beyond 2nd rank. (Any ranks above 2 earned during Society Pass will remain but unusable after boost expires with no penalties or down ranking will occurring due to lack of attendance to duties. Last gained rank returned on pass renewal.)
*Cannot join a profession [[guild]]. Will allow access purchases down the line.
*Cannot join [[CHE]]s.

==Combat/Magic==
*No direct PvP attacks allowed. Mass Attack spells like [[Elemental Wave (410)]] that can hit players as well as creatures have a 30 second cooldown (to prevent careless spamming). If actually used to attack another player, this cooldown increases to 5 minutes (cooldown can be removed with a cooldown remover).
*Spells that significantly impact a room without attacking a player (notably [[Minor Sanctuary]]) are restricted from use.
*Attack spells (vs. creatures) are largely unrestricted, aside from the mass attack spell limitations noted above. Sorcerers may cast [[Focused Implosion]].
*All beneficial spells are self-cast only, except for [[Spirit Warding I (101)]], [[Elemental Defense I (401)]], and [[Foresight (1204)]] which may be cast on others up to the 2 hour duration limit. Mass spells [[Mass Blur (911)]], [[Natural Colors (601)]] (evoked), and [[Mass Elemental Defense (419)]] will buff yourself but not your party. [[ARMOR]] abilities are also self-cast only. A casting pass allows casting on anyone else. If the caster does not have a casting pass, the receiving player can choose to purchase a receiving pass to allow any F2P caster to cast upon them. Only one pass needs to be present.
*All beneficial spell [[duration]]s cap at 2 hours.
*Permanent/Long-term item boosts have complete/partial restrictions ([[Enchant Item]], [[Charge Item]], [[Magic Item Creation]], [[Imbue]], [[Resist Nature]], [[Scroll Infusion]], [[Holy Receptacle]], [[Ensorcell]], Damage Specializations, etc.).
*Utility spells such as teleportation, locate, and such have a four hour cooldown period between each use. These cooldowns can be removed with a cooldown remover.
*Only access to random attunement, unless a purchase is made to select one.
*Only access to one particular sort of pet for pet spells (Call Familiar, Animal Companion, etc).
*[[Loresinging]] is restricted, unless a pass is purchased which allows loresinging on a per item basis.
*Cannot [[SEND]] mana. A casting pass purchased by one of the parties will remove this restriction.
*Warriors cannot protect another player using {{boldmono|[[GUARD (verb)|GUARD]]}} or {{boldmono|[[PROTECT (verb)|PROTECT]]}}

Listed above are the general rules for casting, and these are the exceptions found so far...
*[[Spirit Fog (106)]] is unrestricted, you may fog up rooms as you wish.
*[[Stun Relief (108)]] is unrestricted, you may unstun as many players as you wish.
*[[Undisease (113)]] is unrestricted, you may undisease as many players as you wish.
*[[Unpoison (114)]] is unrestricted, you may unpoison as many players as you wish.
*[[Manna (203)]] is unrestricted, you may create this and give to anyone.
*[[Light (205)]] is unrestricted, you may brighten/darken a room as you wish.
*[[Untrammel (209)]] is unrestricted, you may unweb as many players as you wish.
*[[Bless (304)]] is unrestricted, you may bless as many items as you like but each bless is capped at 50 swings.
*[[Preservation (305)]] is unrestricted, you may lifekeep as many players as you like.
*[[Holy Receptacle (325)]] is completely unusable even for yourself.
*[[Elemental Detection (405)]] is unrestricted, you may detect spells on players and in items.
*[[Elemental Blade (411)]] is unrestricted, you may eblade your weapons and those of others.
*[[Herb Production (1118)]] is unrestricted, you may grow all the herbs you want.
*[[Troll's Blood (1125)]] does in fact buff your party, and can even be cast over the 2 hour limit.
*[[Vertigo (1219)]] does not suffer from the normal AOE limit of 4 hours.
*[[Consecrate (1604)]] is unrestricted, you may consecrate all you want.
*[[Arm of the Arkati (1605)]] extends to your group.
*Paladin auras extend to your group: [[Divine Shield (1609)]], [[Zealot (1617)]], [[Fervor (1618)]].

==Healing/Raising==
*The last 10 players healed are kept track of. Each time a new person is healed, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A healing pass increases this to 4 times.
*An empath must first [[empathic linking|link]] (via [[TOUCH]]) to their prospective client. This linking process takes 30 seconds (15 with a healing pass). Once established, the link lasts for 3 minutes. All wound transfers done during this link are considered part of a single healing session (one entry on the above list).
*The last 10 players raised are kept track of. Each time a new person is raised, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A pass removes this restriction.
*A cleric must have a Resurrection Pass active to use a [[chrism]].

==Treasure/Items/Banks==
*Creatures which are more than 10 levels below the player's level are not eligible for ANY treasure production, including but not limited to any treasure generated when searching, looting, or skinning.
*In-bank limits start at 100,000 and can be permanently increased in 100,000 silver increments pretty cheaply.
*5k in-pocket silver maximum to hunt with (can carry as much as desired outside of combat). Waived with a Treasure Boost.
*One bank account (F2P accounts will receive a warning before using a bank for the first time as they need to pay to move it from town to town).
*Notes cost 1% more.
*Silvers apply twice as much encumbrance.
*50k daily treasure cap. Cap can be reset with a Treasure Cap Reset. Lowered treasure per kill. Expanded to 100k cap with a Treasure Boost, and increased treasure. Limits on Purify silver value boosts and increased difficulty.
*Shop prices are less favorable.
*No base access to a [[locker]]. Can purchase a temporary 10 item locker pass, or the existing locker upgrades (both permanent and temporary).
*100 item personal carry limit. Can be expanded to 300 items with a pass.
*Can use up to 5x (+25) gear (any additional bonus is not applied). Similarly limited to "somewhat" padding/weighting/sighting. Gear passes are available that allow the full benefit of any equipment's enchantment, weighting, padding, sighting, TD enhancement, or Defensive Bonus (DB), just like a paid subscriber.

==Geography==
*During the release, transportation to [[River's Rest]] and [[Teras Isle]] was said to restricted by boat or teleportation. [[Chronomage]] orb purchases are similarly restricted in-game and thus, the player must purchase one from the SimuCoin store.
* The boot to River's Rest prevents F2P travel by foot and directs the player to purchase a Chronomage orb from the store.
* Passage on the smuggler's cutter to River's Rest is not restricted.
* TBD on whether Teras ticket purchase is also restricted.

==Miscellaneous==
*Lockpicking (and popping/bashing) limited to self-found boxes only. Plans for this to change based on how the rotating lists for healing/raising work.
*Foraging is harder. F2P cannot take the last two forageables out of a room. Max 15 items per hour. Foraging pass removes restrictions and makes foraging easier.
*Pickpocketing skill cannot be used to steal from other player characters.

==Login Rewards==
[[Login Rewards]] are awarded to characters that login daily on all types of accounts, but F2P subscribers receive fewer or a lesser form of what paying subscribers receive, as well as limits on the amount of rewards that can be stockpiled. Also, F2P subscribers must logout and login each day (past 00:00 on game [[TIME]]) as the system will not keep track automatically for them.

Currently F2P is limited to stockpile 1 Gift of the Gods and 1 Experience Booster, so they should be spent every month. In addition, only 2 daily [[Login bridge|login bridges]] may be stockpiled through login rewards, so at most one can only miss 2 consecutive days of logins to maintain a streak (without obtaining bridges from an alternate source).
{| {{prettytable}} width="80%"
|-bgcolor="lightblue"
!width="7%"|DAY
!REWARD
|-
|align="center"| 1||500 fame
|-
|align="center"| 2||1 random magical crystal ([[blue crystal|blue]]/[[white crystal|white]]/[[black crystal|black]]). Can stockpile up to 5 uses at once.
|-
|align="center"| 3||1 Minor Loot Boost (small boost on [[LOOT]] rolls for 15 minutes)
|-
|align="center"| 4||1 Temporary Urchin Guide access (access to the [[URCHIN]] guides for 15 minutes)
|-
|align="center"| 5||1 Bounty Boost (reduces all bounty wait times (to a nominal few seconds) until the character shares a task or successfully completes it, max 1 hour)
|-
|align="center"| 6||1 Enhancive Boost (player's choice of either 5 enhancive pauses, or 15 minutes of +5 to all Base Stat Bonuses, or 15 minutes of +15 to Stamina and Mana Regen)
|-
|align="center"| 7||1 Urchin Runner (allows characters to use the remote [[BANK (verb)|BANK]] and [[LOCKER]] access commands. Comes with a free 15 minutes of LOCKER MANIFEST access)
|-
|align="center"| 8||1 Encumbrance Boost (minus 50 lbs to effective encumbrance for 15 minutes)
|-
|align="center"| 9||1 Guild Boost (player's choice of either doubled TPs earned for each profession guild task or another use of the Bounty Boosts)
|-
|align="center"| 10||1 Lesser Experience Pass (60 minute Exp Pass)
|-
|align="center"| 11||2 hours of Bounty Waivers (choose one Adventurer Guild task type (Forage Herbs, Escort NPC, etc) that they do not want to get assigned for the duration). Can stockpile up to 10 unredeemed Bounty Waivers.
|-
|align="center"| 12||1 Major Loot Boost (larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another.) Can stockpile up to 10 Major Loot Boosts.
|-
|align="center"| 13||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 14||1 Minor Loot Boost. Can stockpile up to 10 unredeemed Minor Loot Boosts.
|-
|align="center"| 15||1 Bounty Boost
|-
|align="center"| 16||1 Enhancive Boost
|-
|align="center"| 17||2 uses of the Urchin Runners
|-
|align="center"| 18||1 Encumbrance Boost
|-
|align="center"| 19||1 Guild Boost
|-
|align="center"| 20||1 Instant Mind Clearer (instantly moves 1000 current field exp into their absorbed exp pool. It does not apply any RPA, XXX, or other modifiers to this amount)
|-
|align="center"| 21||1 [[Death's Sting|Deathsting]] Reducer (reduces deathsting penalties by 1 priestess potion sip per use)
|-
|align="center"| 22||2 hours of Bounty Waivers. Can stockpile up to 10 uses at once.
|-
|align="center"| 23||1 Major Loot Boost(Larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another)
|-
|align="center"| 24||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 25||2 Item Superchargers (when activated, any standard flaring gear that the character uses will flare more often, any weighted/padded/sighted gear will gain bonus additional weighting/padding/sighting, and any item's enchantment bonus will provide an extra 50% bonus to AS/DS for 15 minutes)
|-
|align="center"| 26||2 Luck Boosters (When activated, all standard offensive combat rolls made by the character will reroll d100 results of 10 or less (keeping the new number if it is higher) for 15 minutes)
|-
|align="center"| 27||3-day [[society]] pass
|-
|align="center"| 28||2 Major Loot Boosts
|-
|align="center"| 29||1 Gift of the Gods. You can only choose Lorminstra (5 deeds) and can only stockpile 1 unredeemed. Be sure to redeem it before your next 29-day reward rolls around or you will lose that one.
|-
|align="center"| 30||2 Doubled Experience Boosters (Double experience absorption for 15 minutes.) Can stockpile only '''1''' unredeemed Doubled Experience Booster. Make sure to use both of them before the next 30-day reward rolls around.
|}

==Official Message Boards==
As of May 2016, F2P accounts only have access to selected sections of the official message boards, all of which are linked here:

*[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/view Officials F2P Discussions main folder]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/Announcements/view Announcements]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Subscription/view F2P Subscription]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20General%20Discussion/view F2P General Discussion]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Game%20Mechanics/view F2P Game Mechanics]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Professions/view F2P Professions]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20World%20Discussions/view F2P World Discussions]

*[http://forums.play.net/forums/GemStone%20IV/Help%20for%20Players/view Help for Players main folder]
*[http://forums.play.net/forums/GemStone%20IV/Software%20&%20Hardware%20Help/view Software & Hardware Help main folder]
*[http://forums.play.net/forums/GemStone%20IV/Socializing/view Socializing main folder]
*[http://forums.play.net/forums/GemStone%20IV/The%20Marketplace/view The Marketplace main folder]

==Resources==
*[[Login Rewards]]
*[http://forum.gsplayers.com/showthread.php?94776-Getting-Lich-to-work-with-F2P-accounts Getting Lich to work with F2P]
*[http://forum.gsplayers.com/showthread.php?95891-F2P-Experience&p=1773183#post1773183 F2P Experience Penalty Analysis]
*[http://forum.gsplayers.com/showthread.php?96614-F2P-Spell-Research Maerit's F2P Spell Research]
*[http://forum.gsplayers.com/showthread.php?94753-F2P-thread Unofficial's general F2P thread]

[[category: Subscriptions]]

F2P subscription

2021-06-14T04:24:07Z

DOUG: /* Login Rewards */ - Adding limit for Day 12 rewards F2P (stockpile 10)

'''F2P subscriptions''' were created in 2015 as an option for new accounts only, with no character transfers allowed. This subscription is highly restricted (see specifics below), with passes around the restrictions available through the [[SimuCoin#F2P_Subscription_Items|SimuCoin Store]]. None of these items, however, will provide a greater mechanical benefit than what can be obtained by having a [[standard subscription]].

Once an account is upgraded to a monthly paying subscription (standard or [[premium]]), it cannot be reverted back.

==Experience==
*The weekly Gift of Lumnis does not occur. It is accessible via a pass.
*Experience absorption is less efficient on a sliding scale. The first 10 levels are unchanged. After level 10, the efficiency of absorption gradually decreases. This can be fully or partially offset with [[experience pass]]es.
*Experience gained per monster killed is also reduced under same scale.
*Field experience cannot be absorbed while logged off.
*There is no bonus experience point per pulse absorbed while grouped with a non-F2P character.
*No yearly [[fixskills]].

The exact formula of exp loss is not yet known, but so far research tends to favor the formula for on-node exp loss: Exp Loss Per Pulse = (Level - 10) / 1.75 .
So for instance, a typical character will see loss per pulse similar to this table...
:{| {{prettytable|1=text-align:center}}
!align="right"|Level||10||15||20||25||30
|-
|align="right"|Exp Loss Per Pulse On-Node||0||3||6||10||13
|}
This is a severely debilitating loss above level 25ish. Beyond that point levels will take 50+ hours of gametime to achieve.

==Organization Access==
*One task per hour will be available from the [[Adventurer's Guild]]. This can be upgraded to 1 task per 30 minutes with an Adventure Boost.
*Cannot gain [[Artisan Guild]] ranks. Will allow access purchases down the line.
*Can gain the first rank of a [[society]] and advance to the cusp of the 2nd rank. A society pass is required to gain rank 2 and beyond, as well as use any powers beyond 2nd rank. (Any ranks above 2 earned during Society Pass will remain but unusable after boost expires with no penalties or down ranking will occurring due to lack of attendance to duties. Last gained rank returned on pass renewal.)
*Cannot join a profession [[guild]]. Will allow access purchases down the line.
*Cannot join [[CHE]]s.

==Combat/Magic==
*No direct PvP attacks allowed. Mass Attack spells like [[Elemental Wave (410)]] that can hit players as well as creatures have a 30 second cooldown (to prevent careless spamming). If actually used to attack another player, this cooldown increases to 5 minutes (cooldown can be removed with a cooldown remover).
*Spells that significantly impact a room without attacking a player (notably [[Minor Sanctuary]]) are restricted from use.
*Attack spells (vs. creatures) are largely unrestricted, aside from the mass attack spell limitations noted above. Sorcerers may cast [[Focused Implosion]].
*All beneficial spells are self-cast only, except for [[Spirit Warding I (101)]], [[Elemental Defense I (401)]], and [[Foresight (1204)]] which may be cast on others up to the 2 hour duration limit. Mass spells [[Mass Blur (911)]], [[Natural Colors (601)]] (evoked), and [[Mass Elemental Defense (419)]] will buff yourself but not your party. [[ARMOR]] abilities are also self-cast only. A casting pass allows casting on anyone else. If the caster does not have a casting pass, the receiving player can choose to purchase a receiving pass to allow any F2P caster to cast upon them. Only one pass needs to be present.
*All beneficial spell [[duration]]s cap at 2 hours.
*Permanent/Long-term item boosts have complete/partial restrictions ([[Enchant Item]], [[Charge Item]], [[Magic Item Creation]], [[Imbue]], [[Resist Nature]], [[Scroll Infusion]], [[Holy Receptacle]], [[Ensorcell]], Damage Specializations, etc.).
*Utility spells such as teleportation, locate, and such have a four hour cooldown period between each use. These cooldowns can be removed with a cooldown remover.
*Only access to random attunement, unless a purchase is made to select one.
*Only access to one particular sort of pet for pet spells (Call Familiar, Animal Companion, etc).
*[[Loresinging]] is restricted, unless a pass is purchased which allows loresinging on a per item basis.
*Cannot [[SEND]] mana. A casting pass purchased by one of the parties will remove this restriction.
*Warriors cannot protect another player using {{boldmono|[[GUARD (verb)|GUARD]]}} or {{boldmono|[[PROTECT (verb)|PROTECT]]}}

Listed above are the general rules for casting, and these are the exceptions found so far...
*[[Spirit Fog (106)]] is unrestricted, you may fog up rooms as you wish.
*[[Stun Relief (108)]] is unrestricted, you may unstun as many players as you wish.
*[[Undisease (113)]] is unrestricted, you may undisease as many players as you wish.
*[[Unpoison (114)]] is unrestricted, you may unpoison as many players as you wish.
*[[Manna (203)]] is unrestricted, you may create this and give to anyone.
*[[Light (205)]] is unrestricted, you may brighten/darken a room as you wish.
*[[Untrammel (209)]] is unrestricted, you may unweb as many players as you wish.
*[[Bless (304)]] is unrestricted, you may bless as many items as you like but each bless is capped at 50 swings.
*[[Preservation (305)]] is unrestricted, you may lifekeep as many players as you like.
*[[Holy Receptacle (325)]] is completely unusable even for yourself.
*[[Elemental Detection (405)]] is unrestricted, you may detect spells on players and in items.
*[[Elemental Blade (411)]] is unrestricted, you may eblade your weapons and those of others.
*[[Herb Production (1118)]] is unrestricted, you may grow all the herbs you want.
*[[Troll's Blood (1125)]] does in fact buff your party, and can even be cast over the 2 hour limit.
*[[Vertigo (1219)]] does not suffer from the normal AOE limit of 4 hours.
*[[Consecrate (1604)]] is unrestricted, you may consecrate all you want.
*[[Arm of the Arkati (1605)]] extends to your group.
*Paladin auras extend to your group: [[Divine Shield (1609)]], [[Zealot (1617)]], [[Fervor (1618)]].

==Healing/Raising==
*The last 10 players healed are kept track of. Each time a new person is healed, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A healing pass increases this to 4 times.
*An empath must first [[empathic linking|link]] (via [[TOUCH]]) to their prospective client. This linking process takes 30 seconds (15 with a healing pass). Once established, the link lasts for 3 minutes. All wound transfers done during this link are considered part of a single healing session (one entry on the above list).
*The last 10 players raised are kept track of. Each time a new person is raised, the oldest name on the list is bumped off. A single player can only appear 2 times on the list. A pass removes this restriction.
*A cleric must have a Resurrection Pass active to use a [[chrism]].

==Treasure/Items/Banks==
*Creatures which are more than 10 levels below the player's level are not eligible for ANY treasure production, including but not limited to any treasure generated when searching, looting, or skinning.
*In-bank limits start at 100,000 and can be permanently increased in 100,000 silver increments pretty cheaply.
*5k in-pocket silver maximum to hunt with (can carry as much as desired outside of combat). Waived with a Treasure Boost.
*One bank account (F2P accounts will receive a warning before using a bank for the first time as they need to pay to move it from town to town).
*Notes cost 1% more.
*Silvers apply twice as much encumbrance.
*50k daily treasure cap. Cap can be reset with a Treasure Cap Reset. Lowered treasure per kill. Expanded to 100k cap with a Treasure Boost, and increased treasure. Limits on Purify silver value boosts and increased difficulty.
*Shop prices are less favorable.
*No base access to a [[locker]]. Can purchase a temporary 10 item locker pass, or the existing locker upgrades (both permanent and temporary).
*100 item personal carry limit. Can be expanded to 300 items with a pass.
*Can use up to 5x (+25) gear (any additional bonus is not applied). Similarly limited to "somewhat" padding/weighting/sighting. Gear passes are available that allow the full benefit of any equipment's enchantment, weighting, padding, sighting, TD enhancement, or Defensive Bonus (DB), just like a paid subscriber.

==Geography==
*During the release, transportation to [[River's Rest]] and [[Teras Isle]] was said to restricted by boat or teleportation. [[Chronomage]] orb purchases are similarly restricted in-game and thus, the player must purchase one from the SimuCoin store.
* The boot to River's Rest prevents F2P travel by foot and directs the player to purchase a Chronomage orb from the store.
* Passage on the smuggler's cutter to River's Rest is not restricted.
* TBD on whether Teras ticket purchase is also restricted.

==Miscellaneous==
*Lockpicking (and popping/bashing) limited to self-found boxes only. Plans for this to change based on how the rotating lists for healing/raising work.
*Foraging is harder. F2P cannot take the last two forageables out of a room. Max 15 items per hour. Foraging pass removes restrictions and makes foraging easier.
*Pickpocketing skill cannot be used to steal from other player characters.

==Login Rewards==
[[Login Rewards]] are awarded to characters that login daily on all types of accounts, but F2P subscribers receive fewer or a lesser form of what paying subscribers receive, as well as limits on the amount of rewards that can be stockpiled. Also, F2P subscribers must logout and login each day (past 00:00 on game [[TIME]]) as the system will not keep track automatically for them.

Currently F2P is limited to stockpile 1 Gift of the Gods and 1 Experience Booster, so they should be spent every month. In addition, only 2 daily [[Login bridge|login bridges]] may be stockpiled through login rewards, so at most one can only miss 2 consecutive days of logins to maintain a streak (without obtaining bridges from an alternate source).
{| {{prettytable}} width="80%"
|-bgcolor="lightblue"
!width="7%"|DAY
!REWARD
|-
|align="center"| 1||500 fame
|-
|align="center"| 2||1 random magical crystal ([[blue crystal|blue]]/[[white crystal|white]]/[[black crystal|black]]). Can stockpile up to 5 uses at once.
|-
|align="center"| 3||1 Minor Loot Boost (small boost on [[LOOT]] rolls for 15 minutes)
|-
|align="center"| 4||1 Temporary Urchin Guide access (access to the [[URCHIN]] guides for 15 minutes)
|-
|align="center"| 5||1 Bounty Boost (reduces all bounty wait times (to a nominal few seconds) until the character shares a task or successfully completes it, max 1 hour)
|-
|align="center"| 6||1 Enhancive Boost (player's choice of either 5 enhancive pauses, or 15 minutes of +5 to all Base Stat Bonuses, or 15 minutes of +15 to Stamina and Mana Regen)
|-
|align="center"| 7||1 Urchin Runner (allows characters to use the remote [[BANK (verb)|BANK]] and [[LOCKER]] access commands. Comes with a free 15 minutes of LOCKER MANIFEST access)
|-
|align="center"| 8||1 Encumbrance Boost (minus 50 lbs to effective encumbrance for 15 minutes)
|-
|align="center"| 9||1 Guild Boost (player's choice of either doubled TPs earned for each profession guild task or another use of the Bounty Boosts)
|-
|align="center"| 10||1 Lesser Experience Pass (60 minute Exp Pass)
|-
|align="center"| 11||2 hours of Bounty Waivers (choose one Adventurer Guild task type (Forage Herbs, Escort NPC, etc) that they do not want to get assigned for the duration). Can stockpile up to 10 uses at once.
|-
|align="center"| 12||1 Major Loot Boost (larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another.) Can stockpile up to 10 uses at once.
|-
|align="center"| 13||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 14||1 Minor Loot Boost
|-
|align="center"| 15||1 Bounty Boost
|-
|align="center"| 16||1 Enhancive Boost
|-
|align="center"| 17||2 uses of the Urchin Runners
|-
|align="center"| 18||1 Encumbrance Boost
|-
|align="center"| 19||1 Guild Boost
|-
|align="center"| 20||1 Instant Mind Clearer (instantly moves 1000 current field exp into their absorbed exp pool. It does not apply any RPA, XXX, or other modifiers to this amount)
|-
|align="center"| 21||1 [[Death's Sting|Deathsting]] Reducer (reduces deathsting penalties by 1 priestess potion sip per use)
|-
|align="center"| 22||2 hours of Bounty Waivers. Can stockpile up to 10 uses at once.
|-
|align="center"| 23||1 Major Loot Boost(Larger boost on LOOT rolls. Minor and Major Loot Boosts don't stack with one another)
|-
|align="center"| 24||1 Login Bridge. Can stockpile up to 2 unredeemed Login Bridges.
|-
|align="center"| 25||2 Item Superchargers (when activated, any standard flaring gear that the character uses will flare more often, any weighted/padded/sighted gear will gain bonus additional weighting/padding/sighting, and any item's enchantment bonus will provide an extra 50% bonus to AS/DS for 15 minutes)
|-
|align="center"| 26||2 Luck Boosters (When activated, all standard offensive combat rolls made by the character will reroll d100 results of 10 or less (keeping the new number if it is higher) for 15 minutes)
|-
|align="center"| 27||3-day [[society]] pass
|-
|align="center"| 28||2 Major Loot Boosts
|-
|align="center"| 29||1 Gift of the Gods. You can only choose Lorminstra (5 deeds) and can only stockpile 1 unredeemed. Be sure to redeem it before your next 29-day reward rolls around or you will lose that one.
|-
|align="center"| 30||2 Doubled Experience Boosters (Double experience absorption for 15 minutes.) Can stockpile only '''1''' unredeemed Doubled Experience Booster. Make sure to use both of them before the next 30-day reward rolls around.
|}

==Official Message Boards==
As of May 2016, F2P accounts only have access to selected sections of the official message boards, all of which are linked here:

*[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/view Officials F2P Discussions main folder]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/Announcements/view Announcements]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Subscription/view F2P Subscription]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20General%20Discussion/view F2P General Discussion]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Game%20Mechanics/view F2P Game Mechanics]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20Professions/view F2P Professions]
**[http://forums.play.net/forums/GemStone%20IV/F2P%20Discussions/F2P%20World%20Discussions/view F2P World Discussions]

*[http://forums.play.net/forums/GemStone%20IV/Help%20for%20Players/view Help for Players main folder]
*[http://forums.play.net/forums/GemStone%20IV/Software%20&%20Hardware%20Help/view Software & Hardware Help main folder]
*[http://forums.play.net/forums/GemStone%20IV/Socializing/view Socializing main folder]
*[http://forums.play.net/forums/GemStone%20IV/The%20Marketplace/view The Marketplace main folder]

==Resources==
*[[Login Rewards]]
*[http://forum.gsplayers.com/showthread.php?94776-Getting-Lich-to-work-with-F2P-accounts Getting Lich to work with F2P]
*[http://forum.gsplayers.com/showthread.php?95891-F2P-Experience&p=1773183#post1773183 F2P Experience Penalty Analysis]
*[http://forum.gsplayers.com/showthread.php?96614-F2P-Spell-Research Maerit's F2P Spell Research]
*[http://forum.gsplayers.com/showthread.php?94753-F2P-thread Unofficial's general F2P thread]

[[category: Subscriptions]]

Lich:Software/Mac Installation

2021-04-12T03:38:45Z

DOUG: /* The Process */

To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one. Note: Ruby 3.0 and higher does not support Lich presently. The most tested Ruby version is 2.6.6.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 2.6.6</code>
# <code>rbenv global 2.6.6</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 2.6.6p146 (2020-03-31 revision 67876) [x86_64-darwin19]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin20]</code>
seek assistance.

The key is the ruby 2.6 part -> it either reads 2.6.6 or 2.6.3.

'''2.6.6 is expected'''. If your version reflects 2.6.6, proceed to the next steps. Enter these commands, one at a time, and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install sqlite3 --no-document</code>
# <code>gem install gtk3 --no-document</code>

Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://www.dropbox.com/s/cbdhey4fp6i96e4/Lich5.zip?dl=1 Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

No guides are available at this time, please email doug@play.net for help.

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}
[[Category:Third-Party Software]]

Lich:Software/Installation

2021-03-30T21:35:16Z

DOUG: /* New Installation for Lich 5 (3/6/2021) */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-scripts/tree/master/scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The StormFront FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic. After you've logged in, log out and continue.
# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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.

'''Note4:''' The script 'sloot' is very popular, and it is confusing to keep track of which sloot variant out there is best, presently. Do yourself a favor - after everything is setup but before you run sloot: Delete sloot. <code>;repo download gtk3-sloot</code>. Rename gtk3-sloot to sloot. Profit.

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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===

Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help.

This process works well for Mac OS Catalina and Big Sur.

If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/matt-lowe/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel libyaml-devel \
libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4. Download Lich:
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/ondreian/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Ecosystem Information===

* DragonRealms Variant

This can be downloaded directly from Github at [https://github.com/dragon-realms/dr-lich dragon-realms-lich]

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software/Installation

2021-03-19T20:24:17Z

DOUG: /* Upgrade Installation for Lich 5 (3/6/2021) */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-scripts/tree/master/scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The StormFront FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic.
# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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.

'''Note4:''' The script 'sloot' is very popular, and it is confusing to keep track of which sloot variant out there is best, presently. Do yourself a favor - after everything is setup but before you run sloot: Delete sloot. <code>;repo download gtk3-sloot</code>. Rename gtk3-sloot to sloot. Profit.

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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===

Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help.

This process works well for Mac OS Catalina and Big Sur.

If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/matt-lowe/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel libyaml-devel \
libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4. Download Lich:
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/ondreian/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Ecosystem Information===

* DragonRealms Variant

This can be downloaded directly from Github at [https://github.com/dragon-realms/dr-lich dragon-realms-lich]

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software/Installation

2021-03-19T20:23:35Z

DOUG: /* Upgrade Installation for Lich 5 (3/6/2021) */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-scripts/tree/master/scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The StormFront FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic.
# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

'''Note4:''' The script 'sloot' is very popular, and it is confusing to keep track of which sloot variant out there is best, presently. Do yourself a favor - after everything is setup but before you run sloot: Delete sloot. <code>;repo download gtk3-sloot</code>. Rename gtk3-sloot to sloot. Profit.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===

Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help.

This process works well for Mac OS Catalina and Big Sur.

If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/matt-lowe/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel libyaml-devel \
libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4. Download Lich:
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/ondreian/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Ecosystem Information===

* DragonRealms Variant

This can be downloaded directly from Github at [https://github.com/dragon-realms/dr-lich dragon-realms-lich]

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software

2021-03-12T21:14:04Z

DOUG: /* Resources */

<div class="alert alert-info"><center>'''{{mono|;TUNE TOWNCRIER }}to join the TownCrier channel and get GS news and tips every five minutes. There is no chat on this channel.'''</center></div>

==About==
<section begin=About />
'''The Lich''' is third-party software that expands scripting capabilities on Simutronics front end clients ([[Wizard (front end)|The Wizard]] and [[StormFront]] for Windows users, and [[Avalon]] for Mac OS X users), 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. <section end=About />

<div {{prettydiv}}>

<CENTER>{{boldmono|<tt>Quick Start & Installation Guides</tt>}}</CENTER>

* '''Windows'''
** [[Lich_(software)/Installation#Windows|Windows]]
*'''Mac'''
** [[Mac_Installation_-_Lich_(software)|Mac OS X]]
* '''Linux'''
** [[Lich_(software)/Installation#Chromebook_.26_Debian_variants|Chromebook & Debian Variants]]
** [[Lich_(software)/Installation#Fedora|Fedora Installation - Lich (software)]]
</div>

===What is "Lich"?===
Lich is an open source scripting engine for text-based MUDs. It is not a complete front-end in and of itself: it operates much like a proxy server and communicates with the user through their chosen front-end (effectively giving the appearance of expanding the front-end's features with its own). It allows you to write and run scripts for a text-based MUD in the Ruby language.

Lich was originally created by [http://lichproject.sourceforge.net/ Shaelun], who brought it up from an idea to version 3.57. Starting with version 3.58, Lich is maintained by [http://lichproject.org/ Tillmen]. Tillmen's versions focus more heavily on Simutronics games, specifically Gemstone IV. If you are interested in non-Simutronics games, you might be better served with Shaelun's version.

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

===What can Lich do for me?===
The Lich program, absent of any scripts, doesn't appear to do much of anything (besides allow you to alias commands in the game). What Lich is doing behind the scenes allows you to use pretty powerful scripts, such as:

* '''[[Script Go2 | go2]]''': This script makes long and short journeys easy. It is powered by a database of 18,677 rooms with 42,695 known movements connecting those rooms (as of 10-2-2010, for Gemstone IV). Some of those movements include tasks such as navigating mazes, dealing with slippery ice, or waiting in line to use a rope bridge. It includes a large list of common locations in each town, and takes you to the closest one. For example typing ";go2 bank" will take you to whatever bank is closest to you.
* '''[[Script Narost | narost]]''': This script pops up a window to show you which room you are in on a map. The script originally used only Tsoran's maps, but since those are becoming increasingly outdated, new maps are being created and added to narost. The script continues to show you what room you are in as you move around, changing maps as needed. It allows you to click on a room to make the go2 script take you there, and some other things.
* '''[[Script Infomon | infomon]]''': This script is responsible for tracking any useful information that the main Lich program doesn't. The most useful thing it tracks is the spells that are on you, and their remaining time. It also keeps track of other peoples spell ranks that use Lich, to give more accurate spell tracking.
* '''[[Script LNet | lnet]]''': This script is a simple chat script that allows you to chat with other people using Lich. It is a great source of help for those new to Lich. It also allows scripts to transfer information to other characters (disabled by default) to allow, for example, a spellup script (waggle) to know exactly how many casts of what spells another character needs.
* '''[[Script Repository | repository]]''': This script allows you to upload and download scripts from the Lich server. There are many, many more scripts available for tasks big and small.

In addition to the powerful Ruby scripts, Lich can run most WizardFE/Stormfront scripts unaltered. This allows you to use the scripts you already have, but since Lich is running them, you can have any number of them going at once. However, learning a little Ruby goes a long way. Scripts that take a hundred lines in WizardFE/Stormfront can usually be rewritten as a dozen or so lines in Ruby, and work much better.

===What operating systems does it work with?===
Starting in version 3.58, Lich is written completely in Ruby. This means it should it should run on any platform that can run the Ruby interpreter. Lich is developed on Linux, but the majority of the user base uses Windows (XP, Vista, Win7, Win8).

==Installation==

Please review the [[Lich_(software)/Installation]] page.

==Jinx (;repository alternative)==

Jinx is a project that is an alternative form of script installation from the default ;repository. It can serve up scripts for download similar to the ;repo however it is not dependent on a single server that may be prone to outages. Any one can set up their own script library, and then users can add it as a source for the ;jinx script to search and download from.

Jinx can be downloaded and installed into your scripts folder from the Elanthia Online github:

https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/jinx.lic

Right-click the above link and save it into the scripts folder in your lich directory.

Alternatively, the following command can be issued in game via lich to attempt to download the script to the proper directory for you (this command is for when the repository is down and the script cannot be downloaded naturally):
<syntaxhighlight lang="ruby">
;e require 'open-uri';begin;jinx_remote = open("https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/jinx.lic"); jinx_local = File.open(File.join(SCRIPT_DIR, 'jinx.lic'), "wb"); jinx_local.write(jinx_remote.read);ensure; jinx_remote.close(); jinx_local.close();end</syntaxhighlight>

once installed you can issue:

<pre>;jinx help</pre>

for basic usage information.

===Jinx Lich Repository Mirror===
In the event the main <code>;repository</code> is unavailable, there is currently an actively maintained <code>;jinx</code> repository that is a direct mirror.

https://github.com/FarFigNewGut/lich_repo_mirror

Scripts can be manually retrieved from this Github repository (they are all located in the lib folder). The repository is also packaged and published for use directly with Jinx:

<syntaxhighlight lang="ruby">
;jinx repo add ffnglichrepoarchive https://ffnglichrepoarchive.netlify.app
</syntaxhighlight>
(You can use something shorter instead of "ffnglichrepoarchive" for the repo name if you'd like.)

Once it is setup as a source for <code>;jinx</code> you can install any scripts from the repo with:

<syntaxhighlight lang="ruby">
# install script for the first time
;jinx script install --repo=ffnglichrepoarchive <script name>

# update previously installed script
;jinx script update --repo=ffnglichrepoarchive <script name>
</syntaxhighlight>

For example if you wanted to download or update xnarost.lic:
<syntaxhighlight lang="ruby">
# first install
;jinx script install --repo=ffnglichrepoarchive xnarost

# update if you had previously downloaded xnarost
;jinx script update --repo=ffnglichrepoarchive xnarost
</syntaxhighlight>

==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.

'''Q: Why do I keep disconnecting immediately after login?'''
: A: This generally happens on only one character, and affects only Stormfront. It seems to be caused by Stormfront downloading a characters settings from the Simu server. To fix it, change Stormfront to store scripts/highlights/macros/etc locally, or log in once on Stormfront without Lich to allow it to do whatever it’s trying to do.

'''Q: How come when I cast spells on people it doesn't tell the correct duration for the spell?'''
: A: This is due to not setting permissions correctly with LNet once logged in. In general, most people should be fine with typing: ;LNET ALLOW ALL ALL. This should allow anyone with Lich installed to detect your spell durations. It also allows other things, to see exactly what you can do type ;LNET HELP ingame and read over the output it provides.

{{#lst:User:DOUG/Sandbox Lich Stuff|GTK3PublicBeta}}

==Resources==
* [[Lich scripting reference]]
* [[Mac Installation - Lich (software)]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

User:DOUG/Sandbox Lich Stuff

2021-03-12T20:51:48Z

DOUG: /* GTK3 Beta Test */

<section begin=GTK3PublicBeta />

==GTK3 Beta Test==

The GTK3 Beta Test period is over, and has been released to the public for general use. Please see the [[Lich_(software)/Installation]] page.

Lich:Software/Installation

2021-03-10T15:20:22Z

DOUG: /* Mac OS X */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-scripts/tree/master/scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The StormFront FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic.
# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===

Players with Macs can use [[Mac_Installation_-_Lich_(software) | Installing Lich on Macs]] for installation help.

This process works well for Mac OS Catalina and Big Sur.

If you have not updated your Mac OS yet, these instructions may work depending on your actual version. If you run into a snag, follow the contact instructions provided.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/matt-lowe/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel libyaml-devel \
libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4. Download Lich:
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/ondreian/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Ecosystem Information===

* DragonRealms Variant

This can be downloaded directly from Github at [https://github.com/dragon-realms/dr-lich dragon-realms-lich]

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software/Mac Installation

2021-03-10T15:16:50Z

DOUG: Updating to latest Lich5 and cleaner Mac Install process

To install Lich on newer versions of Mac OS, you will need a bit of familiarity with the Mac Terminal application. Some familiarity with Homebrew will help, although you should be able to follow the steps below without any prior knowledge of Homebrew.

This guide will attempt to install Lich for the Avalon Front End only. The entire process will take 60-90 minutes to complete, but the time required will depend on how many prerequisites you need to install and how many errors you encounter. If you get stuck, see any errors or run into any problems, or for information about other front ends, please contact Doug (doug@play.net or Doug#6198 on Discord) for help.

Please note that this guide will involve changing settings on your device for the technologies involved. You will need to decide whether it’s safe for you to customize these tools to work with Lich. If you have no idea what any of these technologies are, then you probably aren’t using them for any other purpose, but proceed at your own risk.

==Before You Start==

You will need to install a few things.

# Install the [https://www.play.net/gs4/play/avalon-info.asp Avalon Front End] from the play.net site.
# Install [https://brew.sh Homebrew] by following the instructions at the Homebrew site. You will be asked to supply your sudo password at least once, and perhaps a couple of times through this process.
# The Hombrew setup will also install Apple's Command Line Tools. You will be asked to accept the Apple license.

When you are finished with these steps and Hombrew has installed, in the Terminal application you should run this command <code>brew doctor</code>

Your system should respond with <code>Ready to brew</code>. If you get any other result, please seek assistance.

==The Process==

There are three general steps to installing all the packages and software needed to run Lich on Mac.

* First we will install various packages through Homebrew. This will include installing a different version of Ruby. Apple's version of Ruby does not work well with Lich.

* Second, we will install the gems in the new Ruby that we installed.

* Finally, we will download and unzip the current Lich software so that we can run Lich.

To get started, enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>brew install gtk+3</code>
# <code>brew install rbenv</code>
# <code>brew install adwaita-icon-theme</code>

Now we need to set up your SHELL environment to take advantage of these packages.

Enter the following command to check your shell: <p><code>echo $SHELL</code></p>

* If the Terminal displays <code>/bin/bash</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.bash_profile</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.bash_profile</code></p><p><code>source ~/.bash_profile</code></p>
* If the Terminal displays <code>/bin/zsh</code>, run the following commands: <p><code>echo 'eval "$(rbenv init -)"' >> ~/.zshrc</code></p><p><code>echo 'if [ -z $DISPLAY ]; then export DISPLAY=:0.0; fi' >> ~/.zshrc</code></p><p><code>source ~/.zshrc</code></p>

This completes the installation of the core packages you will need. Now we'll use rbenv to install the new Ruby. You're welcome to select a Ruby version if you are comfortable with any particular one. Note: Ruby 3.0 and higher does not support Lich presently. The most tested Ruby version is 2.6.6.

Before we begin, let's check to be sure rbenv is working properly. Enter this command in Terminal and press ENTER.

* <code>rbenv versions</code>

This should return one line that looks like <code>* system</code>. If you see that line, you can proceed. If not, seek assistance. If you are proceeding, then enter these commands in Terminal, one at a time, and press ENTER. Allow the system to complete the command before moving on to the next one.

# <code>rbenv install 2.6.6</code>
# <code>rbenv global 2.6.6</code>
# <code>ruby -v</code>

If everything worked, the last line will return the version of Ruby that is currently active. It should look something like this:
<code>ruby 2.6.6p146 (2020-03-31 revision 67876) [x86_64-darwin19]</code>

If you did not receive that line, or if you received a line like this:
<code>ruby 2.6.3p62 (2019-04-16 revision 67580) [universal.x86_64-darwin20]</code>
seek assistance.

The key is the ruby 2.6 part -> it either reads 2.6.6 or 2.6.3.

'''2.6.6 is expected'''. If your version reflects 2.6.6, proceed to the next steps. Enter these commands, one at a time, and press ENTER. Wait for the system to finish before moving on to the next.

# <code>gem install sqlite3 --no-document</code>
# <code>gem install gtk3 --no-document</code>

Now run a quick test to see if things work:

* Run the following command to start the Ruby shell (you will see the command prompt change): <p><code>Irb</code></p>
# Run this command to test if the first gem is working: <p><code>require 'sqlite3'</code></p><p>The system should respond <code>true</code></p>
# Run this command to test if the second gem is working: <p><code>require 'gtk3'</code></p><p>This should also respond <code>true</code> in the Terminal. It might take a second or two.</p>
# Now, run this command to return to your regular shell prompt: <p><code>exit</code></p>

If all of these activities show the right results, the hard part is behind you. Now we simply need to get the Lich files:
# Download the [https://www.dropbox.com/s/cbdhey4fp6i96e4/Lich5.zip?dl=1 Lich5] files. (Windows/Mac all run the same files).
# Unzip it the file in your Downloads folder. This will create a folder called Lich5. Drag the Lich5 folder (not the zip file, the folder) to your Desktop.

'''That's it!''' You will start / access Lich and the game from the Terminal window.

# Run the following command in the Terminal: <p><code>ruby ~/Desktop/Lich5/lich.rbw</code></p>
# After a couple seconds, you should see the Lich login window.
# Enter your login information, and click CONNECT.
# Select your character, select the Avalon Front End, and click PLAY.
# The game will start! You will see some new Lich-related text in the scroll, including a repository error (normal).

Lich5 will then automatically start downloading the map database and associated image files for the game. After that's complete, you're ready to play. Good luck and have fun!

==Lich for Other Front Ends==

No guides are available at this time, please email doug@play.net for help.

==Resources==
* [[Lich scripting reference]]
* Playershops by Lich: https://ps.lichproject.org/
* Unofficial Support for Lich: http://forum.gsplayers.com/forumdisplay.php?f=104
* Popular Lich script thread: http://forum.gsplayers.com/showthread.php?81229-What-Lich-Scripts-Do-You-Regularly-Use

{{Third-Party Software}}
[[Category:Third-Party Software]]

Lich:Software/Installation

2021-03-10T14:19:31Z

DOUG: /* Windows */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-scripts/tree/master/scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The StormFront FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic.
# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===

Max OS X support is incoming with GTK3 Beta Lich. Installation and details on this are still incoming - Please stand by.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/matt-lowe/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel libyaml-devel \
libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4. Download Lich:
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/ondreian/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Ecosystem Information===

* DragonRealms Variant

This can be downloaded directly from Github at [https://github.com/dragon-realms/dr-lich dragon-realms-lich]

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software/Installation

2021-03-10T14:17:40Z

DOUG: /* New Installation for Lich 5 (3/6/2021) */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-lich/tree/master/gtk3-scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# '''Please log into the game of your choice through the Simutronics website first'''. Install the launcher (not SGE), and install your FrontEnd of Choice. The StormFront FrontEnd is presently the supported FrontEnd, but Wizard will work as well, if you are nostalgic.
# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===

Max OS X support is incoming with GTK3 Beta Lich. Installation and details on this are still incoming - Please stand by.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/matt-lowe/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel libyaml-devel \
libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4. Download Lich:
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/ondreian/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Ecosystem Information===

* DragonRealms Variant

This can be downloaded directly from Github at [https://github.com/dragon-realms/dr-lich dragon-realms-lich]

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software/Installation

2021-03-09T19:15:59Z

DOUG: /* Upgrade Installation for Lich 5 (3/6/2021) */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-lich/tree/master/gtk3-scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# Download and Run the [https://bit.ly/WinLich5 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.
# '''If you have been in the game already with Simutronics software, the default installation is fine'''. If you have not yet been in the game with Simutronics software, then you should check the box to add the Launcher, and then select a FrontEnd. StormFront is the current FE supported by Simutronics.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===

Max OS X support is incoming with GTK3 Beta Lich. Installation and details on this are still incoming - Please stand by.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/matt-lowe/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel libyaml-devel \
libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4. Download Lich:
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/ondreian/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Ecosystem Information===

* DragonRealms Variant

This can be downloaded directly from Github at [https://github.com/dragon-realms/dr-lich dragon-realms-lich]

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]

Lich:Software/Installation

2021-03-09T19:12:17Z

DOUG: /* Windows */

==About==

Lich is an add-on scripting engine that works alongside existing front ends. The most common installation is a combination of Lich on Windows using the Stormfront or Wizard FE. Despite this, Lich is also used by many on both MacOS and multiple Linux distributions.

==Installing the Latest Stable Release==

===Windows===

'''For Windows 10 / 8 / 7''' users: you can download the [https://bit.ly/WinLich5 Installer] and install everything you need automatically. If you have never played before, follow the 'New Installation' instructions. If you have played before, and have used Lich before, follow the 'Upgrade Installation' instructions.

Several very popular scripts have been updated to work with the new Lich version. '''If your favorite script doesn't work right, and if downloading the author's latest (since 03/2020) doesn't fix it, check out this [https://github.com/elanthia-online/gtk3-lich/tree/master/gtk3-scripts link] for an updated copy.''' Always try the repo first - authors may be updating their scripts and adding cool new features that are not included at this link.

====New Installation for Lich 5 (3/6/2021)====

# Download and Run the [https://bit.ly/WinLich5 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.
# '''If you have been in the game already with Simutronics software, the default installation is fine'''. If you have not yet been in the game with Simutronics software, then you should check the box to add the Launcher, and then select a FrontEnd. StormFront is the current FE supported by Simutronics.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished, open that folder and double click the lich.rbw file contained inside to start Lich's Game Entry window.
# Use your existing Simutronics Account and Password and click connect. Then select the character you wish to play, and select the FrontEnd you wish to use. Then click the Play button.
# Your game FrontEnd should start, and you should see Lich5 initializing. You will see it downloading files - these are the map files, wait for the download to finish.
# You should see a window open titled 'xNarost', this is the map window.
# In the game command line enter -> <code>;repo download jinx</code> <- 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.

====Upgrade Installation for Lich 5 (3/6/2021)====

'''Developers:''' This installer will associate all .rb and .rbw files to this installation. You may want to just check in with the [https://discord.gg/KF9Wr8u Discord] scripting channel to get the latest Lich files and roll your own Ruby.

'''Note:''' Back up your existing lich folder for a failsafe experience. Seriously. Put a copy somewhere safe.

'''Note2:''' You are updating to Ruby 2.6.6 and GTK3 - smoother running and more stable. This means that some of your existing scripts may need to be updated. At the present moment, the only script that is known to not be available is the Wizard script <code>;uberbarwiz</code>. If that script is critical to your gaming, do not upgrade yet. When this note changes, that will mean an updated script is available.

'''Note3:''' This installer is safe to run with existing installations of Ruby. This is done to facilitate a rapid return to the prior version, if something doesn't work right. Remember to uninstall your older Ruby if you are satisfied with this new installation to get back precious disk space.

# Download and Run the [https://bit.ly/WinLich5 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.
# The installation may take a few minutes, especially on non-SSD harddrives.
# A Lich5 folder will be placed on your desktop after the install is finished.
# 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?
# 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 [https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/ here].

Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

===Mac OS X===

Max OS X support is incoming with GTK3 Beta Lich. Installation and details on this are still incoming - Please stand by.

===Chromebook & Debian variants===
The following steps should install Lich and Profanity for users of Debian/Chromebooks. Profanity is a terminal-based Front-End that will let you play the game (in lieu of The Wizard or Stormfront).

Update the list of available software and make sure some requirements are installed:

<pre>
sudo apt-get -y update
sudo apt-get -y install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libsqlite3-dev unzip
</pre>

Install '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''', a Ruby version manager. Add it to the <tt>PATH</tt> so that it will work outside of its own directory, and set it up to work when you launch the shell (terminal):
<pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
</pre>

Run the shell's launch script now to enable those two changes and get rbenv working:
<pre>
source ~/.bashrc
</pre>

Download the tools to let rbenv install Ruby on its own, then install Ruby 2.5.1 and set it to be our default version of Ruby system-wide:
<pre>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.5.1 -v
rbenv global 2.5.1
</pre>

Tell Ruby not to create documentation for its gems (plugins/packages) unless asked, because it takes a long time and they are available online. Then install the dependencies for Lich and Profanity:
<pre>
echo "gem: --no-document" > ~/.gemrc
gem install sqlite3 gtk2 curses
</pre>

Install Lich and Profanity:
<pre>
curl --remote-name https://lichproject.org/download/lich-4.6.49.zip
unzip lich-*.zip
git clone https://github.com/matt-lowe/ProfanityFE.git
</pre>

===Fedora===

There are notable differences between the versions of Fedora that are commonly available:

* Fedora 31 uses Ruby version 2.6.5 which has no compatibility issues with the base lich version or the Beta GTK3 variant.
* Fedora 32 uses Ruby version 2.7.1 which requires modification of scripts to match SAFE commands. This is a minor version difference, but is notable.

1. Update The Base Installation:
<pre>
$ sudo dnf -y update
$ sudo dnf -y install vim git
</pre>

2. Install required Ruby and Development packages:
<pre>
$ sudo dnf install -y autoconf bison gcc gdbm gdbm-devel libyaml-devel \
libffi-devel make ncurses-devel openssl-devel readline-devel redhat-rpm-config \
ruby ruby-devel sqlite-devel unzip zlib-devel
</pre>

3. Perform Ruby Gem Installations:
<pre>
$ gem install rake
$ gem update
</pre>

3.a. For GTK2 (base Lich)
<pre>
$ gem install sqlite3 gtk2 curses
</pre>

3.b. For GTK3 Beta
<pre>
$ gem install sqlite3 gtk3 curses
</pre>

4. Download Lich:
<pre>
$ cd ~
$ curl --remote-name https://lichproject.org/download/lich-4.6.52.zip
$ unzip lich-4.6.52.zip
</pre>

5. Clone Profanity:
<pre>
$ cd ~
$ git clone https://github.com/ondreian/ProfanityFE.git
</pre>

Please refer to the '''[[Profanity | Profanity FE]]''' page for initial configuration and additional instructions.

===Ecosystem Information===

* DragonRealms Variant

This can be downloaded directly from Github at [https://github.com/dragon-realms/dr-lich dragon-realms-lich]

==Resources==
* [[Mac Installation - Lich (software)]]

{{Third-Party Software}}
[[Category:Third-Party Software]]
[[Category:New Player]]