Lich:Software/Installation - Revision history

WHIGHTCNIGHT: /* Lich Changelog */ update to 5.23.0

2026-10-28T17:28:14Z

Lich Changelog: update to 5.23.0

@@ Line 306: / Line 306: @@
 <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.22.0'''
 <PRE>

WHIGHTCNIGHT: /* Installing the Latest Stable Release */ update to 5.23.0

2026-10-28T17:27:14Z

Installing the Latest Stable Release: update to 5.23.0

← Older revision		Revision as of 11:27, 28 October 2026
Line 6:		Line 6:
	=Installing the Latest Stable Release=		=Installing the Latest Stable Release=

	'''The latest stable lich version is 5.22.0 supporting Ruby 4.0 - published October 8, 2026'''		'''The latest stable lich version is 5.23.0 supporting Ruby 4.0 - published October 28, 2026'''

	==In-Place Upgrade==		==In-Place Upgrade==

WHIGHTCNIGHT: /* Saga */ linux version does update itself

2026-10-28T13:15:21Z

Saga: linux version does update itself

← Older revision		Revision as of 07:15, 28 October 2026
Line 265:		Line 265:

	If Saga will not start and mentions FUSE or <tt>libfuse.so.2</tt>, install FUSE 2 and try again: <tt>sudo apt-get install libfuse2</tt> on Debian/Chromebook (on Debian 13 and newer, <tt>libfuse2t64</tt>), <tt>sudo pacman -S fuse2</tt> on Arch, or <tt>sudo dnf install fuse-libs</tt> on Fedora.		If Saga will not start and mentions FUSE or <tt>libfuse.so.2</tt>, install FUSE 2 and try again: <tt>sudo apt-get install libfuse2</tt> on Debian/Chromebook (on Debian 13 and newer, <tt>libfuse2t64</tt>), <tt>sudo pacman -S fuse2</tt> on Arch, or <tt>sudo dnf install fuse-libs</tt> on Fedora.

	The Linux build of Saga does not update itself yet. Check the Saga info page now and then, download the newest AppImage, and repeat the <tt>sudo mv</tt> and <tt>sudo chmod</tt> steps.

	'''Use Saga with Lich'''		'''Use Saga with Lich'''

WHIGHTCNIGHT: update to include mention of Saga for MacOS and Linux

2026-10-28T13:13:26Z

update to include mention of Saga for MacOS and Linux

← Older revision		Revision as of 07:13, 28 October 2026
Line 51:		Line 51:
	'''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.		'''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.		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)===		===New Installation for Lich 5 (11/14/2023)===
Line 61:		Line 60:
	# 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.		# 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.		# 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)===		===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.		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].		Additional assistance in installation can be found in the scripting channel of the GemStone [https://discord.gg/KF9Wr8u Discord].

	==MacOS==		==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.		There are two common options for playing Gemstone IV on a Mac: play natively with Saga (the official front end) or Avalon, or use virtualization software such as Parallels with Wrayth/WizardFE. Below are the options on how to do that.

	===Native Avalon===		===Native (Saga or 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.		Players with Macs can use [[Mac_Installation_-_Lich_(software) \| Installing Lich on Macs]] for installation help. That guide sets Lich up with [[Saga]], the official Simutronics front end (currently in beta), and also covers [[Avalon]]. 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===		===Parallels Windows===
Line 86:		Line 83:

	==Linux==		==Linux==
	Pick the subsection for your distribution below. Each one installs Ruby and Lich; front ends (Profanity and Warlock) are covered once in [[#Frontends\|Frontends]] at the end, since their steps are the same on every distribution.		Pick the subsection for your distribution below. Each one installs Ruby and Lich; front ends (Saga, Profanity and Warlock) are covered once in [[#Frontends\|Frontends]] at the end, since their steps are the same on every distribution.

	===Chromebook & Debian variants===		===Chromebook & Debian variants===
	<div class="mw-customtoggle-debian" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>		<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">		<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">
	The following steps should install Lich for users of Debian/Chromebooks. To also install a front end such as Profanity or Warlock, see [[#Frontends\|Frontends]] at the end of the Linux section.		The following steps should install Lich for users of Debian/Chromebooks. To also install a front end such as Saga, Profanity or Warlock, see [[#Frontends\|Frontends]] at the end of the Linux section.

	'''Step 1.'''		'''Step 1.'''
Line 150:		Line 147:
	<div class="mw-customtoggle-arch" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>		<div class="mw-customtoggle-arch" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
	<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-arch">		<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-arch">
	The following steps should install Lich for users of Arch Linux and Arch-based distributions (Manjaro, EndeavourOS, etc.). To also install a front end such as Profanity or Warlock, see [[#Frontends\|Frontends]] at the end of the Linux section.		The following steps should install Lich for users of Arch Linux and Arch-based distributions (Manjaro, EndeavourOS, etc.). To also install a front end such as Saga, Profanity or Warlock, see [[#Frontends\|Frontends]] at the end of the Linux section.

	Update the system and install required dependencies:		Update the system and install required dependencies:
Line 196:		Line 193:
	<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>		<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">		<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
	The following steps should install Lich for users of Fedora. To also install a front end such as Profanity or Warlock, see [[#Frontends\|Frontends]] at the end of the Linux section.		The following steps should install Lich for users of Fedora. To also install a front end such as Saga, Profanity or Warlock, see [[#Frontends\|Frontends]] at the end of the Linux section.

	Lich 5 requires Ruby 4.0 or newer. The Ruby that ships with currently supported versions of Fedora is older than that (41 uses Ruby 3.3; 42 and 43 use Ruby 3.4), so these steps install Ruby 4.0.9 with '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''' instead of using Fedora's Ruby.		Lich 5 requires Ruby 4.0 or newer. The Ruby that ships with currently supported versions of Fedora is older than that (41 uses Ruby 3.3; 42 and 43 use Ruby 3.4), so these steps install Ruby 4.0.9 with '''<tt>[https://github.com/rbenv/rbenv rbenv]</tt>''' instead of using Fedora's Ruby.
Line 248:		Line 245:
	<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-frontends">		<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-frontends">
	Finish the Lich installation for your distribution above first, then set up one of these front ends.		Finish the Lich installation for your distribution above first, then set up one of these front ends.

			====Saga====
			[[Saga]] is the official Simutronics front end for GemStone IV and DragonRealms (currently in beta), and it works with Lich. On Linux it comes as a single AppImage file.

			'''Install Saga'''

			Go to the [https://www.play.net/gs4/play/saga-info.asp Saga info page] and click '''Download for Linux''' (AppImage, x86_64). On a Chromebook, move the downloaded file into the '''Linux files''' folder with the Files app so Linux can see it.

			Then put it where Lich looks for Saga, make it runnable, and start it:
			<pre>
			sudo mkdir -p /opt/Saga
			sudo mv ~/Downloads/Saga-*.AppImage /opt/Saga/saga
			sudo chmod +x /opt/Saga/saga
			/opt/Saga/saga
			</pre>
			:<small>On a Chromebook use <tt>~/Saga-.AppImage</tt> in place of <tt>~/Downloads/Saga-.AppImage</tt>.</small>

			Log in to the game from inside Saga once, without Lich, to make sure Saga itself works.

			If Saga will not start and mentions FUSE or <tt>libfuse.so.2</tt>, install FUSE 2 and try again: <tt>sudo apt-get install libfuse2</tt> on Debian/Chromebook (on Debian 13 and newer, <tt>libfuse2t64</tt>), <tt>sudo pacman -S fuse2</tt> on Arch, or <tt>sudo dnf install fuse-libs</tt> on Fedora.

			The Linux build of Saga does not update itself yet. Check the Saga info page now and then, download the newest AppImage, and repeat the <tt>sudo mv</tt> and <tt>sudo chmod</tt> steps.

			'''Use Saga with Lich'''

			Saga starts Lich for you:
			# Log in with Saga normally, then choose '''File → Enable Login with Lich'''.
			# Choose '''File → Return to login'''.
			# Click '''Connect''', then '''Via Lich''', and point it to your Lich folder (<tt>~/Lich5</tt>).
			# If Saga asks where Ruby is, or Lich will not start, run <tt>rbenv which ruby</tt> and give Saga the path it prints (it ends in <tt>.rbenv/versions/4.0.9/bin/ruby</tt>).
			# Log in. The game will start in Saga with Lich running.

			Once that works, you can also start from the Lich login window (<tt>ruby ~/Lich5/lich.rbw</tt>): select your character, choose '''Saga''' as the front end, and click '''Play'''. Lich will open Saga and Saga logs in with its own saved login, so make sure Saga has saved your account and quit Saga before you do this.

			See the [[Saga]] page for more about Saga, including importing Wrayth settings.

	====Profanity====		====Profanity====

WHIGHTCNIGHT: collapse frontend section

2026-10-28T12:53:19Z

collapse frontend section

← Older revision		Revision as of 06:53, 28 October 2026
Line 86:		Line 86:

	==Linux==		==Linux==
	Pick the subsection for your distribution below. Each one installs Ruby and Lich; front ends (~~[[#~~Profanity~~\|Profanity]]~~ and ~~[[#Warlock\|~~Warlock]]) are covered once in [[#Frontends\|Frontends]] at the end, since their steps are the same on every distribution.		Pick the subsection for your distribution below. Each one installs Ruby and Lich; front ends (Profanity and Warlock) are covered once in [[#Frontends\|Frontends]] at the end, since their steps are the same on every distribution.

	===Chromebook & Debian variants===		===Chromebook & Debian variants===
Line 245:		Line 245:

	===Frontends===		===Frontends===
			<div class="mw-customtoggle-frontends" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
			<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-frontends">
	Finish the Lich installation for your distribution above first, then set up one of these front ends.		Finish the Lich installation for your distribution above first, then set up one of these front ends.

Line 262:		Line 264:
	</pre>		</pre>
	Use your login information with these settings to use the Lich launcher: https://github.com/sproctor/warlock3/wiki/Lich-support		Use your login information with these settings to use the Lich launcher: https://github.com/sproctor/warlock3/wiki/Lich-support
			</div>

	=Popular Scripts=		=Popular Scripts=

WHIGHTCNIGHT: /* Linux */ spacing

2026-10-28T12:52:19Z

Linux: spacing

← Older revision		Revision as of 06:52, 28 October 2026
Line 192:		Line 192:
	:<small>Note: <tt>bundle install --without ...</tt> no longer works; that flag was removed from the version of Bundler that ships with Ruby 4.0. Use <tt>bundle config set</tt> as shown above.</small>		:<small>Note: <tt>bundle install --without ...</tt> no longer works; that flag was removed from the version of Bundler that ships with Ruby 4.0. Use <tt>bundle config set</tt> as shown above.</small>
	</div>		</div>


	===Fedora===		===Fedora===

WHIGHTCNIGHT: update Linux instructions to 4.0.9 Ruby

2026-10-28T12:50:39Z

update Linux instructions to 4.0.9 Ruby

Show changes

HORIBU1: /* Lich Changelog */ add changelog for 5.21.0 and 5.22.0

2026-10-08T21:29:11Z

Lich Changelog: add changelog for 5.21.0 and 5.22.0

@@ Line 282: / Line 282: @@
 <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.20.1'''
 <PRE>

HORIBU1: /* Installing the Latest Stable Release */ update to 5.22.0

2026-10-08T21:27:21Z

Installing the Latest Stable Release: update to 5.22.0

← Older revision		Revision as of 15:27, 8 October 2026
Line 6:		Line 6:
	=Installing the Latest Stable Release=		=Installing the Latest Stable Release=

	'''The latest stable lich version is 5.21.0 supporting Ruby 4.0 - published ~~September~~ 10, 2026'''		'''The latest stable lich version is 5.22.0 supporting Ruby 4.0 - published October 8, 2026'''

	==In-Place Upgrade==		==In-Place Upgrade==

HORIBU1: /* Installing the Latest Stable Release */ typo in version

2026-09-11T00:45:05Z

Installing the Latest Stable Release: typo in version

← Older revision		Revision as of 18:45, 10 September 2026
Line 6:		Line 6:
	=Installing the Latest Stable Release=		=Installing the Latest Stable Release=

	'''The latest stable lich version is 5.21.9 supporting Ruby 4.0 - published September 10, 2026'''		'''The latest stable lich version is 5.21.0 supporting Ruby 4.0 - published September 10, 2026'''

	==In-Place Upgrade==		==In-Place Upgrade==