GemStone IV Wiki - User contributions [en]

Huge mein golem

2024-01-21T23:25:59Z

IPITTMAN:

{{Creature start2 
| picture = Huge_mein_golem_Colored.jpg
| level = 37
| family = Golem
| type = Biped
| otherclass = Magical
| otherclass2 =
| area = Darkstone Castle
| area2 =
| area3 =
| area4 =
| area5 =
| area6 =
| area7 =
| bcs = Yes 
| hitpoints =
| roundtime = 
}}
{{Creature attack attributes2 
| PA1 = 
| PAA =
| PA2 =
| PAB =
| PA3 =
| PAC =
| BT1 = 
| BTA =
| WD1 = 
| WDA =
| WD2 =
| WDB =
| WD3 =
| WDC =
| OS1 = 
| MN1 = 
| MN2 =
| AB1 = 
| ABA = 
}}
{{Creature defense attributes2 
| asg = 
| IMM1 = 
| Melee = 267
| Ranged =
| Bolt = 85 - 125
| UDF =
| BarTD =
| CleTD =
| EmpTD =
| PalTD =
| RanTD =
| SorTD =
| WizTD =
| MjETD =
| MnETD =
| MjSTD =
| MnSTD =
| MnMTD =
| DSP1 = 
| DSP2 =
| DSP3 =
| DSP4 =
| DSP5 =
| SDA1 = 
}}
{{Creature treasure
| coins =
| magic items =
| gems =
| boxes =
| other = mein shards
| skin = None
}}
{{Creature end}}

A towering, animated, glass-like creature, the huge mein golem is comprised entirely of mein. Taller than a giantman by half again and nearly as wide as tall, the mein golem displays a barrel chest, massive legs and arms, and a flattened, cylindrical head with almost no neck apparent. Animated by someone with a unique sense of humor, the huge mein golem contains many surprises for the unwary adventurer.

==Hunting strategies==
Seems impossible or very difficult to knock over. Tremors(909) and E-Wave(410) seemed to have no effect.

It has an SMR attack, stomp, that knocks you prone with roundtime but no damage.

It often does two attacks at once, left fist and right fist.

Seems immune to [[Minor Shock (901)]], [[Minor Water (903)]], [[Minor Fire (906)]], and probably other minor bolts. (Message says it "reflects" the attack, but it doesn't actually go back to you.) Other bolt spells such as [[Major Fire (908)]] worked fine and they have low bolt DS.

It is immune to electrical stun from [[Mage Armor (520)]].

Searching will cause it to explode in a maneuver attack a couple of seconds later, leaving behind "a mein shard" worth about 500 at the gemshop. No treasure.

Seems immune to crits.
==Other information==
* Puncture resistant

== References ==
* [http://www.play.net/gs4/info/bestiary/creature.asp?creature=1463 Huge mein golem on Play.net bestiary]

{{Nearlevel
|levelm2 = 35
|levelm1 = 36
|level = 37
|levelp1 = 38
|levelp2 = 39
}}

Huge mein golem

2024-01-21T23:20:28Z

IPITTMAN: /* Hunting strategies */

{{Creature start2 
| picture = Huge_mein_golem_Colored.jpg
| level = 37
| family = Golem
| type = Biped
| otherclass = Magical
| otherclass2 =
| area = Darkstone Castle
| area2 =
| area3 =
| area4 =
| area5 =
| area6 =
| area7 =
| bcs = Yes 
| hitpoints =
| roundtime = 
}}
{{Creature attack attributes2 
| PA1 = 
| PAA =
| PA2 =
| PAB =
| PA3 =
| PAC =
| BT1 = 
| BTA =
| WD1 = 
| WDA =
| WD2 =
| WDB =
| WD3 =
| WDC =
| OS1 = 
| MN1 = 
| MN2 =
| AB1 = 
| ABA = 
}}
{{Creature defense attributes2 
| asg = 
| IMM1 = 
| Melee = 267
| Ranged =
| Bolt = 85 - 125
| UDF =
| BarTD =
| CleTD =
| EmpTD =
| PalTD =
| RanTD =
| SorTD =
| WizTD =
| MjETD =
| MnETD =
| MjSTD =
| MnSTD =
| MnMTD =
| DSP1 = 
| DSP2 =
| DSP3 =
| DSP4 =
| DSP5 =
| SDA1 = 
}}
{{Creature treasure
| coins =
| magic items =
| gems =
| boxes =
| other = mein shards
| skin = None
}}
{{Creature end}}

A towering, animated, glass-like creature, the huge mein golem is comprised entirely of mein. Taller than a giantman by half again and nearly as wide as tall, the mein golem displays a barrel chest, massive legs and arms, and a flattened, cylindrical head with almost no neck apparent. Animated by someone with a unique sense of humor, the huge mein golem contains many surprises for the unwary adventurer.

==Hunting strategies==
Seems impossible or very difficult to knock over. Tremors(909) and E-Wave(410) seemed to have no effect.

It has an SMR attack, stomp, that knocks you prone with roundtime but no damage.

It often does two attacks at once, left fist and right fist.

Seems immune to [[Minor Shock (901)]], [[Minor Water (903)]], [[Minor Fire (906)]], and probably other minor bolts. (Message says it "reflects" the attack, but it doesn't actually go back to you.) Other bolt spells such as [[Major Fire (908)]] worked fine and they have low bolt DS.

It is immune to electrical stun from [[Mage Armor (520)]].

Searching will cause it to explode in a maneuver attack a couple of seconds later, leaving behind "a mein shard". (No treasure?)

Seems immune to crits.
==Other information==
* Puncture resistant

== References ==
* [http://www.play.net/gs4/info/bestiary/creature.asp?creature=1463 Huge mein golem on Play.net bestiary]

{{Nearlevel
|levelm2 = 35
|levelm1 = 36
|level = 37
|levelp1 = 38
|levelp2 = 39
}}

Huge mein golem

2024-01-21T23:05:38Z

IPITTMAN: Mention stomp and two-fisted attack

{{Creature start2 
| picture = Huge_mein_golem_Colored.jpg
| level = 37
| family = Golem
| type = Biped
| otherclass = Magical
| otherclass2 =
| area = Darkstone Castle
| area2 =
| area3 =
| area4 =
| area5 =
| area6 =
| area7 =
| bcs = Yes 
| hitpoints =
| roundtime = 
}}
{{Creature attack attributes2 
| PA1 = 
| PAA =
| PA2 =
| PAB =
| PA3 =
| PAC =
| BT1 = 
| BTA =
| WD1 = 
| WDA =
| WD2 =
| WDB =
| WD3 =
| WDC =
| OS1 = 
| MN1 = 
| MN2 =
| AB1 = 
| ABA = 
}}
{{Creature defense attributes2 
| asg = 
| IMM1 = 
| Melee = 267
| Ranged =
| Bolt = 85 - 125
| UDF =
| BarTD =
| CleTD =
| EmpTD =
| PalTD =
| RanTD =
| SorTD =
| WizTD =
| MjETD =
| MnETD =
| MjSTD =
| MnSTD =
| MnMTD =
| DSP1 = 
| DSP2 =
| DSP3 =
| DSP4 =
| DSP5 =
| SDA1 = 
}}
{{Creature treasure
| coins =
| magic items =
| gems =
| boxes =
| other = mein shards
| skin = None
}}
{{Creature end}}

A towering, animated, glass-like creature, the huge mein golem is comprised entirely of mein. Taller than a giantman by half again and nearly as wide as tall, the mein golem displays a barrel chest, massive legs and arms, and a flattened, cylindrical head with almost no neck apparent. Animated by someone with a unique sense of humor, the huge mein golem contains many surprises for the unwary adventurer.

==Hunting strategies==
Seems impossible or very difficult to knock over. Tremors(909) and E-Wave(410) seemed to have no effect.

It has an SMR attack, stomp, that knocks you prone with roundtime but no damage.

It often does two attacks at once, left fist and right fist.

Seems immune to [[Minor Shock (901)]], [[Minor Water (903)]], [[Minor Fire (906)]], and probably other minor bolts. (Message says it "reflects" the attack, but it doesn't actually go back to you.) Other bolt spells such as [[Major Fire (908)]] worked fine and they have low bolt DS.

Searching will cause it to explode in a maneuver attack a couple of seconds later, leaving behind "a mein shard". (No treasure?)

Seems immune to crits.
==Other information==
* Puncture resistant

== References ==
* [http://www.play.net/gs4/info/bestiary/creature.asp?creature=1463 Huge mein golem on Play.net bestiary]

{{Nearlevel
|levelm2 = 35
|levelm1 = 36
|level = 37
|levelp1 = 38
|levelp2 = 39
}}

Huge mein golem

2024-01-21T23:01:44Z

IPITTMAN: Add list of spells it's immune to. Mention "mein shard".

{{Creature start2 
| picture = Huge_mein_golem_Colored.jpg
| level = 37
| family = Golem
| type = Biped
| otherclass = Magical
| otherclass2 =
| area = Darkstone Castle
| area2 =
| area3 =
| area4 =
| area5 =
| area6 =
| area7 =
| bcs = Yes 
| hitpoints =
| roundtime = 
}}
{{Creature attack attributes2 
| PA1 = 
| PAA =
| PA2 =
| PAB =
| PA3 =
| PAC =
| BT1 = 
| BTA =
| WD1 = 
| WDA =
| WD2 =
| WDB =
| WD3 =
| WDC =
| OS1 = 
| MN1 = 
| MN2 =
| AB1 = 
| ABA = 
}}
{{Creature defense attributes2 
| asg = 
| IMM1 = 
| Melee = 267
| Ranged =
| Bolt = 85 - 125
| UDF =
| BarTD =
| CleTD =
| EmpTD =
| PalTD =
| RanTD =
| SorTD =
| WizTD =
| MjETD =
| MnETD =
| MjSTD =
| MnSTD =
| MnMTD =
| DSP1 = 
| DSP2 =
| DSP3 =
| DSP4 =
| DSP5 =
| SDA1 = 
}}
{{Creature treasure
| coins =
| magic items =
| gems =
| boxes =
| other = mein shards
| skin = None
}}
{{Creature end}}

A towering, animated, glass-like creature, the huge mein golem is comprised entirely of mein. Taller than a giantman by half again and nearly as wide as tall, the mein golem displays a barrel chest, massive legs and arms, and a flattened, cylindrical head with almost no neck apparent. Animated by someone with a unique sense of humor, the huge mein golem contains many surprises for the unwary adventurer.

==Hunting strategies==
Seems impossible or very difficult to knock over. Tremors(909) and E-Wave(410) seemed to have no effect.

Seems immune to [[Minor Shock (901)]], [[Minor Water (903)]], [[Minor Fire (906)]], and probably other minor bolts. (Message says it "reflects" the attack, but it doesn't actually go back to you.) Other bolt spells such as [[Major Fire (908)]] worked fine and they have low bolt DS.

Searching will cause it to explode in a maneuver attack a couple of seconds later, leaving behind "a mein shard". (No treasure?)

Seems immune to crits.
==Other information==
* Puncture resistant

== References ==
* [http://www.play.net/gs4/info/bestiary/creature.asp?creature=1463 Huge mein golem on Play.net bestiary]

{{Nearlevel
|levelm2 = 35
|levelm1 = 36
|level = 37
|levelp1 = 38
|levelp2 = 39
}}

Lich:Profanity

2024-01-12T00:47:33Z

IPITTMAN: Ditto

{{3rd-party}}
[[File:Profanity-screenshot.png|thumb|right|Screenshot of Profanity with ;narost]]
'''Profanity''' is a lightweight, unofficial front end (FE) written in Ruby by Tillmen. Its name likely reflects the author's sense of humor, or possibly the response of most people the first time they encounter it. Snarky speculation aside, it remains a fact that '''Profanity''' relies on the [https://en.wikipedia.org/wiki/Curses_(programming_library) curses library], perhaps being the true origin of the name. That is important, because the user will need a Ruby gem for curses to run '''Profanity''' (e.g., "gem install curses").

* Updated: https://github.com/elanthia-online/ProfanityFE
* Original: https://github.com/matt-lowe/ProfanityFE (not maintained)

==Overview==
The main features and advantages of Profanity compared to other FEs are generally:
*Free software (the user can freely see and modify all code)
*Lightweight with a minimalist look-and-feel (i.e. no graphics)
*Runs natively in most operating systems
*Regular expression highlighting
*Easily launched by other programs (e.g. for bots)
*Optimized screen real-estate usage

Because Profanity is a script and not compiled software, ''it can easily be run on any computer'' which has a proper version of the Ruby interpreter installed. Anyone using [[Lich (software)|Lich]] will already have most if not all the necessary tools available on their computer. This is important because Simutronics only releases FEs for Windows and macOS; thus, Profanity is particularly popular among users of other operating systems, such as GNU/Linux. It it also used by player-created robots, such as [[TownCrier]] and the [https://twitter.com/GSIVDeathLog GSIVDeathLog], owing to the minimal resources it consumes as well as the ease with which it can be launched from a [https://en.wikipedia.org/wiki/Command-line_interface command-line interface] (e.g. directly from another program or script written by the author). It is also one of the easiest interfaces to play via a tablet or smartphone because it does not waste screen real-estate with bells and whistles; Profanity automatically resolves the dimensions of the window it is called from, for instance automagically moving death messaging directly into the main game feed if the screen is under a certain size. To play via a smartphone, the best approach would be running Lich and Profanity remotely (such as on one's home PC) and then accessing the game via [https://en.wikipedia.org/wiki/Secure_Shell ssh].

Owing to its minimalist approach, Profanity could be considered slightly more difficult to install and configure than other FEs. Another possible disadvantage is that it is not officially supported, thus some game defaults give blind errors (the user can tell there is a problem but there is no feedback to indicate what went wrong) or simply behave in an unusual manner. Conversely, as free software, any person can improve it unlike official FEs which are only developed by a small number of Simutronics contractors and/or employees. At present, this article assumes some basic familiarity with the command line and UNIX-like operating systems, but it may be expanded in the future with clear instructions even for a novice who has never used the command line before.

==Launching Profanity==
Profanity is not a full FE itself as it requires Lich to be installed. Lich is used to login to GemStone, as well as for many of the features such as scripting, logging, squelching, etc. Profanity might be best thought of as an add-on to Lich which together create a full FE. Profanity must be downloaded first as outlined in the [[Lich (software)/Installation|Lich installation]] page.

===Saving login data with Lich===
[[File:Lich-login.png|thumb|right|Lich Game Entry]]
*'''Because Profanity cannot login to GemStone, one must login via Lich's Game Entry and ''save'' the information.'''
<pre{{log2|margin-right=35%}}>
ruby ~/lich-5/lich.rbw
</pre>
A graphical interface will pop up (shown on the right), and one should navigate to the Game Entry tab at the top, enter their Simutronics user name and password, and hit 'Connect'. Assuming the user name and password are correct, the list will then be populated with the player's characters to choose from. ''The most important step is to check the box 'Save this info for quick game entry'''. It doesn't matter what is done with the radio buttons for Wizard / Stormfront (we won't be using either one) nor the 'Custom launch command'. The present step is only done once, simply to tell Lich (and thus Profanity) how to login a character, not to actually perform said login. As the Wizard radio button is selected by default, it is assumed the user simply leaves it as it is. Once these things are done, simply hit 'Play' and the pop-up will close, saving your login details.

This step must be done for each character a player wishes to play. ''Note that the login data are saved only based on the character's name and not the game instance (Prime, Platinum, Shattered, Test); thus if a player has characters with the same name in different instances—which is always the case for the Test server—the above login step must be performed each time the player wants to switch game instances.

===Logging in===
To log in the character Rinualdo, one would firstly issue a command like:
<pre{{log2|margin-right=35%}}>
ruby ~/lich-5/lich.rbw --login Rinualdo --without-frontend --detachable-client=8000 &
</pre>

A default installation will need a template. Two default templates are provided. Make sure your ~/.profanity/charname.xml file exists and is not empty. You can copy the template tysong.xml file into your ~/.profanity directory with the character name you are logging in as:
<pre{{log2|margin-right=35%}}>
mkdir ~/.profanity
cp ~/ProfanityFE/templates/tysong.xml ~/.profanity/rinualdo.xml
</pre>
After which, one can now launch Profanity to connect to the previously previously ran Lich login:
<pre{{log2|margin-right=35%}}>
ruby ~/ProfanityFE/profanity.rb --port=8000 --char=Rinualdo
</pre>

To see any existing running Lich sessions prior to launching Profanity to connect to one, use the following:
<pre{{log2|margin-right=35%}}>
ps aux | grep ruby
</pre>

The above command might not connect, depending on whether or not the game entry was completed in the previous step or not, thus one either needs to wait a few seconds, or simply issue the command until a game connection is established.

Of course, one probably does not want to type all the above commands in full every time s/he wants to play. Thus it can be easily scripted. One can create executables somewhere in their PATH.

To perform the game login, one might create a script called ''gsiv.sh'' as follows:
<pre{{log2|margin-right=35%}}>
#!/usr/bin/env bash
# Script to automate login to Tillmen's lich in detached mode
# Author: daid

character="$1"

if [ -z "$character" ];then
echo "Usage: $0 character_name"
exit
fi
echo "Logging in $character in detached mode."
echo "call profanity in another terminal"
ruby $HOME/lich-5/lich.rbw --login $character --without-frontend --detachable-client=8000
</pre>

To launch Profanity repeatedly until a connection is established, one can create a script called ''profanity.sh'':
<pre{{log2|margin-right=35%}}>
#!/usr/bin/env bash
# Profanity login wrapper
# Author: daid

character="$1"

if [ -z "$character" ];then
echo "Usage: $0 character_name"
exit
fi

$(exit 1)
until ruby $HOME/ProfanityFE/profanity.rb --port=8000 --char=$character 2> /dev/null ;do
printf "."
sleep 1
done
</pre>
{{top}}

==Features and Customization==
All of Profanity's macros and highlights are controlled with XML in a file called $HOME/.profanity.xml which will be created with some defaults the first time you launch Profanity. One can use the default examples to create their own.

===Status Displays===
As Profanity runs through a terminal emulator, all information is displayed via ASCII (unless a lich script popout is used), including the character's status. Numerical data are underlayed with a color bar graph for:
*[[Stance]] ('stance')
*[[Experience]] ('mind')
*[[Hitpoint]]s ('health')
*[[Spirit]] ('spirit')
*[[Mana]] ('mana')
*[[Stamina]] ('stam')
*[[Encumbrance]] ('load')
*[[Stun]] ('stun')
*[[Roundtime]] and [[Cast roundtime]] ('rndtime' as different colors)

====Health====

[[Wounds]] are displayed in different colors as a stick figure framed with indicators for specialized locations as well as general ailments such as [[disease]]d, [[poison]]ed and [[bleeding]]. Even with perfect [[health]], the indicator characters will be displayed by default in a dark grey as:

<pre{{log2|margin-right=60%}}>
e e ns
O
/|\ nk
o | o
/ \ bk
o o
dis psn bld
</pre>

Minor injuries appear in yellow with more severe injuries progressing into light and dark red, respectively. Scars appear in light to deeper shades of blue. It should be noted that nervous system scars and injuries are sent through the game data stream in the same manner, so Profanity does not distinguish between an injury and a scar and a nervous scar always appears in the color of an injury. All of these characters and colors are fully customizable in .profanity.xml.

As a silly example, why have "dis psn bld" when it can read "113 114 !!!". It can be fun to customize for yourself. We have matched the character length and replaced it with the issue. Ideally back-highlighted (rather than foreground highlighting) with eye-bleeding read. We can see the problem and also the solution straight up!

====Directional Movements====
A directional compass indicator displays what movements are available from the current room, normally in yellow:
<pre{{log2|margin-right=60%}}>
^ * ^ *
o < >
v * v *
</pre>

A sample customization, where slashes and backslashes are used for the diagonal directions (ne, se, sw, & nw) would look like:
<pre{{log2|margin-right=60%}}>
^ \ ^ /
o < >
v / v \
</pre>

===Macros and Key Shortcuts===
Macros in Profanity work much the same as in other FEs, and the default XML config file shows examples. It should be noted, however, that many terminal emulators have their own hot-keys which, by default, would override or get mixed up with Profanity's own macros. These will vary somewhat based on one's terminal program and operating system. There may be ways to disable said terminal hot keys, but this would disable them for all terminal instances, so one either would want a dedicated terminal program for Profanity or to create a profile. Another alternative is to avoid macros on said keys. A third option is to mix and match them in an interesting way.

A few examples of common terminal macros are:

*Shift+Insert: This will paste the normal paste buffer (since Ctrl+V doesn't usually work)
*Ctrl+U: This normally clears the line, much like the GSIV down arrow
*Ctrl+I: This is the same as the Tab key (ordinarily used for auto-completion). This is an interesting feature since it means we can make a macro on the Tab key by mapping a macro to Ctrl+I, such as [[TARGET (verb)|TARGET NEXT]]. However, note that the Tab key is ordinarily used in Profanity to switch the focus of the scrollbar (e.g. from the game feed to thought window)
*Ctrl+Z: This will suspend the program.
*Ctrl+C: This will kill the program (i.e. quit Profanity!)

===Highlights===
One of the beauties of Profanity is not only that regular expression highlighting is supported, but sharing highlights with friends is as easy as copy and pasting XML into the config file. As it is in XML, it even allows for comments to explain the purpose or origin of the highlights, which can be readily grouped into sensible blocks. Below are some common examples.

====Herbs====
Ever move to a new location and don't recognize what items are herbs? Click on [<font color=blue>Expand</font>] to the right!
<div class="mw-collapsible mw-collapsed" style="border: none; text-align:left; background: #FFF; padding: 0px 10px; margin: 0px 5px; background: #FFF;">
{| class="mw-collapsible-content"
|
<source lang="xml">

<highlight fg='399900'> bolmara potion| brostheras potion| bur-clover potion| rose-marrow potion| talneo potion| wingstem potion| acantha leaf| aloeas stem| ambrominas leaf| basal moss| calamia fruit| cothinar flower| cactacae spine| cuctucae berry| ephlox moss| strigae cactus| haphip root| marallis berry| pothinir grass| sovyn clove| spearmint leaf| torban leaf| tkaro root| wolifrew lichen| yabathilium fruit| woth flower</highlight>

<highlight fg='399900'>a crystalline rose-marrow elixir|a crystalline talneo elixir|a crystalline brostheras elixir|a crystalline bolmara elixir|a crystalline wingstem elixir|a crystalline bur-clover elixir</highlight>

<highlight fg='399900'> flower-shaped tart| iceberry tart| Leaftoe's lichen tart| musk ox tart| Dabbings Family special tart| gelatinous elk fat tart| elk fat gel| frog's bone porridge| Ma Leaftoe's spiced torban tart| polar bear fat soup| ram's bladder| sparrowhawk pie| walrus blubber| earthworm potion| elk horn potion| rock lizard potion| snowflake elixir| starfish potion| tundra grass| rock ptarmigan feathers| arctic moss</highlight>

<highlight fg='399900'> olak's Ol'style ale| bloody Krolvin ale| orc's head ale| kenar's dropjaw ale| miner's muddy ale| dacra's Dream ale| lost dogwater ale| golden goose ale| bearded ladies' ale| mad mutt frothy ale| captn' Pegleg's ale| mama dwarf's ale| aged schooner ale| gert's homemade ale| wort's winter ale| volcano vision ale| semak's smooth ale| dark swampwater ale| agrak's amber ale| reaper's red ale</highlight>

<highlight fg='399900'> acantha leaf tea| sassafras tea| red lichen tea| red lichen potion| valerian root tea| valerian root potion| sweetfern tea| sweetfern potion| manroot tea| manroot potion| angelica root potion| gingko nut tea| gingko nut potion| wyrmwood tea| wyrmwood potion| daggit root potion| feverfew tea| feverfew potion| pennyroyal tea| pennyroyal potion</highlight>

<highlight fg='399900'> tincture of acantha| tincture of rose-marrow| tincture of tkaro| tincture of bolmara| tincture of aloeas| tincture of ambrominas| tincture of basal| tincture of cactacae| tincture of calamia| tincture of cothinar| tincture of cuctucae| tincture of ephlox| tincture of haphip| tincture of pothinir| tincture of sovyn| tincture of torban| tincture of wolifrew| tincture of talneo| tincture of woth| tincture of yabathilium| tincture of brostheras| tincture of bur-clover| tincture of wingstem</highlight>

<highlight fg='399900'> grey mushroom potion| green mushroom potion| thick foggy ale| glowing mold tea| dark frothing ale| stalagmite brew| bubbling brown ale| crushed cavegrass tea| spotted toadstool ale| stalactite brew| grainy black potion| chunky black ale| roasted ratweed tea| brown weedroot ale| dirty crevice brew| dirty rat fur potion| resty red ale| sticky lichen tea| dull crimson ale| stone soot brew</highlight>
</source>
|}</div>
{{clear}}

====Buff spells falling====
Want (nearly) all the [[buff spells]] highlighted in red when they drop? Blue for positive effects? Click on [<font color=blue>Expand</font>] to the right!
<div class="mw-collapsible mw-collapsed" style="border: none; text-align:left; background: #FFF; padding: 0px 10px; margin: 0px 5px; background: #FFF;">
{| class="mw-collapsible-content"
|
<source lang='xml'>

<highlight fg='0000ff'>^The feeling of weakness leaves you. Your spirits are somewhat rejuvenated\.$</highlight>

<highlight fg='0000ff'>^You wake from your meditation, yet a deep feeling of relaxation remains present\.$</highlight>

<highlight bg='ff0000'>There is a soft pulse in the essence\.$</highlight>

<highlight fg='0000ff'>^You feel more refreshed\.$</highlight>

<highlight fg='ff0000'>^The lingering effects of your meditation fade away\.$</highlight>

<highlight fg='0000ff'>^Your form blurs\.$|^You seem to blend into the surroundings better\.$|^A brilliant luminescence surrounds you\.$</highlight>

<highlight fg='ff0000'>^The (light|deep) blue glow leaves you\.$|^Deep blue motes swirl away from you and fade\.$|^The air calms down around you\.$|^The (powerful|very powerful) look leaves you\.$|^You lose your extra internal fortitude\.$|^You notice your blood flow go back to normal\.$|^The misty halo fades from you\.$|^The dull golden nimbus fades from around you\.$|^The guiding force leaves you\.$|^The white light leaves you\.$|^The wall of force disappears from around you\.$</highlight>

<highlight fg='0000ff'>^The invisible force draws back to guide you once more\.$</highlight>

<highlight fg='ff0000'>^The dim aura fades from around you\.$|^The replenishing effect fades, but you are left with a feeling of well-being\.$|^You feel less secure\.$|^You feel the knowledge of the treatment of injuries dissipate\.$|^Your breathing becomes more shallow\.$|^You feel less confident\.$|^The brilliant aura fades away from you\.$|^The opalescent aura fades from around you\.$</highlight>

<highlight fg='ff0000'>^A white glow rushes away from you\.$|^Your .* returns to normal\.$|^Your sense of faith and conviction wanes\. You are less sure of yourself\.$|^You suddenly feel less protected\.$|^You feel the protection of your deity's influence fade\.$|^An ethereal golden collection bowl drifts out of your body, then vanishes\.$</highlight>

<highlight fg='ff0000'>^The (silvery|bright|brilliant) luminescence fades from around you\.$|^Your senses are no longer as sharp\.$|^The scintillating light fades from your hands\.$|^The focused look leaves you\.$|^You feel less confident than before\.$|^The tingling sensation and sense of security leaves you\.$</highlight>

<highlight fg='ff0000'>^The glowing specks of energy surrounding you suddenly shoot off in all directions, then quickly fade away\.$|^You suddenly feel less light-footed\.$|^You feel a slight tingling as the shimmering field fades away\.$|^You feel your extra magical awareness leave you\.$|^You feel your extra strength departing\.$|^You no longer bristle with energy\.$|^The layer of raw elemental energy surrounding you dissipates\.$|^You notice that things have returned to their normal speed\.$</highlight>

<highlight fg='ff0000'>^You return to normal color\.$|^The air about you stops shimmering\.$|^You feel less in tune with your natural surroundings\.$|^You feel your vision return to normal\.$|^You feel less nimble\.$|^The knobby layer of bark on you creaks and twists briefly before disintegrating\.$|^You feel the inner strength leave you\.$|^The swirling breeze around you finally settles\.$|^Nature\'s blessing of vitality departs as your arcane prowess returns to normal\.$|^You feel the aura of confidence leave you\.$|^You are no longer moving silently\.$|^You no longer feel so dextrous\.$|^You feel the gathering of nature\'s power leave you\.$|^You seem to lose the thorny barrier that surrounds you\.$</highlight>
<highlight fg='0000ff'>^Vital energy infuses you, hastening your arcane reflexes|is buffeted by a sudden gust of wind</highlight>

<highlight bg='ff0000'>^A dark shadow seems to detach itself from your body, swiftly dissipating into the air\.$</highlight>
<highlight fg='ff0000'>^Your body pulses momentarily into semi transparency and then returns to normal\.$|^Your murky complexion fades away, and you feel less deft\.$|^You exhale the last of a virulent green mist\.$</highlight>
<highlight fg='0000ff'>^You are seized by a sudden premonition of his demise\.$|^You acquire a certain murky complexion, and you feel more deft\.$|^Your complexion grows murkier\.$|^You feel refreshed enough to sacrifice another animus\.$</highlight>
<highlight fg='00ffff'>^The blood red haze dissipates from around</highlight>
<highlight fg='00ffff'>^The mana about you is temporarily disrupted as your magic starts to falter\.\.\.$</highlight>

<highlight fg='ff0000'>^Your .* stops glowing\.$|^The shimmering multicolored sphere fades from around you\.$|^Faint ripples in the floor beneath you become apparent before quickly dissipating\.$|^You become solid again\.$|^A luminescent aura fades from around you\.$|^The translucent sphere fades from around you\.|it is not well suited for duplicating\.$|It is currently tempering</highlight>

<highlight fg='0000ff'>It is currently tempered and ready to be enchanted\.|You feel a soft pulse in the essence around you\.</highlight>

<highlight bg='ff0000'>faintly pulses with light and you sense its enhancive magic will be depleted soon</highlight>

<highlight fg='ff0000'>^You no longer feel a sense of confidence\.$|^You no longer feel a sense of protection\.$|^Your spirits are no longer lifted by stories of Kai's Triumphs\.$|^The mirror images surrounding you undulate and fade away\.$</highlight>

<highlight fg='ff0000'>^Your mind's keen focus fades away\.$|^Your aura of resolve dissipates\.$|^You release your pinpoint focus on your healing energies and allow their stimulated flow to settle to normal rates\.$|^Your heart staggers briefly before slowing to a more regular speed\. Dark red droplets seep out of your skin and evaporate as the influence of Troll's Blood leaves you\.$</highlight>

<highlight fg='ff0000'>^You feel the tension in your skin ease and notice that your complexion returns to normal\.$|^Like sand through an hourglass, your visions of the future slip away and fade from your mind\.$|^You feel your forehead pulse as your mind relaxes\.$|^The scales covering your hands turn brittle and flake away\.$|^You feel your muscles begin to strain for an instant\. The sense of body control has left you\.$|^The thick plates of bone around your forearms begin to crack, then shatter into a fine white dust\.$|^Darkness punctuated by a constellation of starry pinpoints wells up to the surface of your skin and splinters away with a sound like shattering crystal\.$|^The barrier of force around you dissipates\.$</highlight>

<highlight fg='ff0000'>^The dully illuminated mantle protecting you begins to falter, then completely fades away\.$|^Your sense of clarity fades\.$|^The subdued warmth embracing you fades along with the spiritual force surrounding your arms\.$|^Your boosted confidence and fearlessness fade\.$|^Your skin grows slightly numb for a moment as the warm glow fades from around you\.$|^You lose a bit of focus as the knowledge of future battles drifts from your mind\.$|^You feel your abilities diminish as the energy provided by your patron fades from around you\.$|^The dim celadon wisps about your hands flare up once more and fade completely away\.$|^The subdued warmth embracing you fades along with the spiritual force surrounding your arms\.$|^You feel slightly weakened as the blood in your veins thins\.$|^You feel less resolved as the divine urging subsides, fading into obscurity\.$|^Your bolstered defenses fade with the soft glow about you\.$|^The divine force surrounding you slowly fades away\.$|^The muted pale blue sphere surrounding you flickers once and shudders before fading completely\.$</highlight>
<highlight fg='ff0000'>The dully illuminated mantle protecting .* begins to falter, then completely fades away.</highlight>

<highlight fg='ff0000'>^The brilliant, rapidly shifting aura around you shimmers and flickers briefly before fading\.$|^The brilliant, rapidly shifting aura around you shimmers and bursts in a bright flash!$|^The licks of blue flame surrounding you flare up one last time before vanishing with a staticky crackle\.$|^Like a faint wisp of a barely-remembered dream, your brief, enhanced comprehension of arcane mysteries slips away\.$|^A faint silvery glow fades from around you\.$</highlight>

</source>
|}</div>
{{clear}}

{{top}}

==Special Commands==

A series of commands specific to Profanity are built in. They are accessed beginning the command with a period ('.'). Below is a list of known Profanity commands and their function:

*.arrow : Switches between the two arrow modes. By default, up and down arrows scroll the command history. The alternate mode is to scroll the active feed.
*.copy : (Does nothing. Has fixme note in code.)
*.fixcolor : Related with loading CUSTOM_COLORS which are not set by default.
*.layout $1 : Loads the layout $1.
*.quit : Quits Profanity (but does not exit the game).
*.reload : Reloads highlights only. Can sometimes fix buffer issues.
*.resync : Forces a synchronization between Lich server and Profanity.

==Common problems==
As mentioned above, because Profanity is not an official FE nor widely used, there are some quirks which should be considered.

===Dialogs===
Some aspects of the game use pop-up dialogs. However, the game will silently fail if your FE does not support dialogs; that is, if dialogs are enabled, and you happen to issue a command that has dialog support, literally nothing will happen at all. There is no failure message because the game apparently does not detect if a dialog was launched successfully or not, nor even if your FE can even support them. '''To make matters worse, this feature is enabled by default for all characters.''' An example of such a command is [[PROFILE (verb)|Profile]]. To fix this, issue the game command
<pre{{log2|margin-right=35%}}>
>[[FLAG]] Dialogs Off
</pre>

===Training===
Training via the traditional means of going to a local inn and [[CHECK IN (verb)|check in]] works fine. However, if one instead wishes to use the modern web-browser approach offered by [[GOALS (verb)|GOALS]] then sometimes Profanity's display will get filled with some of the feedback which does not scroll nor get cleared correctly. To rectify this, simply quit profanity (''not the game, note the preceding period below'') and re-launch Profanity

<pre{{log2|margin-right=35%}}>
>.quit
% profanity.sh
</pre>

===Strange markup===
For some reason, sometimes the game feed's markup is not handled correctly by Profanity. A known instance of this is when the character is idle, which is sandwiched between nonsense ('^G') which is probably used in official FEs to produce some sort of added emphasis. So far there is no solution, and a Profanity user should simply know that this is SNAFU:

<pre{{log2|margin-right=35%}}>
^GYOU HAVE BEEN IDLE TOO LONG. PLEASE RESPOND.^G
</pre>

===Lich scripts with fancy output===

Lich scripts that use the <tt>echo</tt> call for fancy output will unfortunately output to the window which connected to GemStone not to the attached window. Thus all such messages appear in the login window rather than the game feed. There is no known solution, and script writers should be aware of this inconsistent behavior of the <tt>echo</tt> call and avoid using it. This includes [[Script Bigshot|;bigshot]] and ;zzherb for example.

===Failure to update resource bars===

Profanity assumes that the player has never customized the formatting of the resource bars in StormFront. This can produce failures to update mana, health, stamina, and/or spirit trackers in Profanity. A workaround is to remove all such customizations. These are literal game commands (as though _progba was a verb) that can be typed by the player or Lich scripted using a "put":

<pre{{log2|margin-right=35%}}>
_progba health 0
_progba stamina 0
_progba spirit 0
_progba mana 0
</pre>

{{top}}

==Useful Lich scripts==
Due to its simplicity, Profanity does not support common features of other FEs such as squelching and highlighting nouns. These are instead accomplished by Lich scripts

===Link highlighting===
Since Profanity is a strictly text-based, then of course the mouse is useless and one cannot click on any links to access verbs etc. However, at least in room descriptions it is often nice to see which items are links, because it distinguishes items which can be interacted with from the flowery description, for example looking for the entrance to a hidden room. '''The Lich script ;linktothefast makes this possible''' by wrapping links around a "link" preset, which can then be colored with:

<pre{{log2|margin-right=35%}}>
<preset id='link' fg='ff0000'/>
</pre>

'''Alternatively, one can use ;roomlinks, which was written for exactly this purpose.''' As its default is to sandwich such nouns between % symbols (underlined font is not supported), then one can add a highlight for them:

<pre{{log2|margin-right=35%}}>
<highlight fg='88aaff'>%.*?%</highlight>
</pre>

The above highlight may erroneously highlight parts of links to websites, but these should generally only be occurring in [[Out of character|OOC ]] whispers and [[Script LNet|;lnet]] chats and is this not too obnoxious. If one wishes to instead highlight all links, s/he is encouraged to check out the script ;drizzleback from which ;roomlinks was inspired. Be warned that your eyes will probably bleed.

===Logging===
To get game logs, simply download Tillmen's ;log script from the repo and add it to the global autostart.

===Squelching===
{{addmetext}}

(In the mean time, one can check out other scripts with squelching behavior, such as ;dreavening, ;carousel2016, ;squelch, etc. Note the ;squelch script is specifically for squelching given characters without removing the 'Also here' line when they are in the room, which is a common problem of squelching in other FEs, and is not a generalized squelching script.)

{{top}}

==The power of scripting==
Here we show a simple example to showcase the power of using Lich in detached mode. With the advent of [[Login Rewards]], one likely wishes to log in all their characters each day, yet this is a tedious process. It can be easily scripted.

Create a lich script in your scripts folder called ''quit.lic'' and fill it with something simple like:
<pre{{log2|margin-right=35%}}>
puts "#{Time.now} - #{Char.name} - Logged in successfully!"
sleep(5)
multifput "info", "skills full", "inventory", "bank account", "resource", "ticket balance", "boost info"
Script.run("invdb", "refresh")
puts "#{Time.now} - #{Char.name} - Login finished, exiting!"
fput "exit"
</pre>

Then create an shell script, for example ''gsiv-login.sh'' and simply fill the array CHAR_LIST with all the characters you want to log in. Then add that script to your crontab. With the shell script consisting of:
<pre{{log2|margin-right=35%}}>
#!/bin/bash
set -e

port=8000
LICH_BIN=/home/servermc/lich-gs/lich.rbw
RUBY_BIN=/home/servermc/.rbenv/versions/3.2.2/bin/ruby
CHAR_LIST=("Character1", "Character2", "Character3")

echo ""
echo "Daily logins beginning!"
/bin/date

for i in "${CHAR_LIST[@]}"
do
echo ""
echo "Attempting to login as $i..."
if ps a | \grep [d]etachable-client; then
max_port=$(ps a | grep -Eo "\-\-detachable-client=([0-9]+)" | egrep -o "[0-9]+" | sort | tail -n1)
port=$(expr $max_port + 1)
fi
echo "Launching with: $RUBY_BIN $LICH_BIN --login $i --detachable-client=$port --without-frontend --start-scripts=quit &"
$RUBY_BIN $LICH_BIN --login $i --detachable-client=$port --without-frontend --start-scripts=quit &
sleep 30
done

echo ""
echo "Daily logins finished."

</pre>

{{top}}

==Quick and Dirty: What to do for a GUI-less VM==

If you want to install Profanity on a VM (like an AWS EC2 machine or Google VM) without a GUI, there are a couple things you must do:

1. Install the appropriate ruby packages and gems from the lich instructions -- HOWEVER -- do NOT install gtk2 or wine. I used the following:
<pre{{log2}}>
sudo apt-get install ruby-dev libsqlite3-dev
sudo gem install sqlite3 --no-ri --no-rdoc
</pre>

2. Grab lich and unzip it
<pre{{log2}}>
wget https://lichproject.org/download/lich-4.6.44.zip
unzip lich-4.6.44.zip
</pre>

3. Grab profanity from GitHub and unzip it, and copy it into your lich folder
<pre{{log2}}>
cd ~/
git clone https://github.com/matt-lowe/ProfanityFE.git
cp ~/ProfanityFE/profanity.rb ~/lich
</pre>

4. This is an important step. You will not be able to run the GUI configuration interface for lich from the VM. You '''MUST''' first run the GUI config from another computer and save your settings. Go to lichproject.org and follow the instructions and connect to the game at least once from a Windows, Mac, Linux or other computer with a GUI interface to lich.

5. Next, you need to zip up the ''data'' folder on the GUI computer located at lich/data. Then you need to SFTP it to your VM, unzip it, and copy it over your ~/lich/data folder. I cannot give specific instructions here because everyone has a different way of doing this.

6. Lastly, you can run lich and profanity as shown above now that you have a character profile saved in the data folder.
<pre{{log2}}>
ruby ~/lich/lich.rb --login <character> --without-frontend --detachable-client=8000 2> /dev/null &
ruby ~/profanity.rb --port=8000
</pre>

A couple more things:

You'll want to modify lich because the newer version of ruby doesn't play well with lich. cd into your lich folder and run
<pre{{log2}}>
sed -i -e 's/$SAFE [<=]$ 3/\1 1/' lich.rbw
</pre>
to update lich.rbw.

You'll also want to keep lich from updating itself and overwriting your updates, so in the game run
<pre{{log2}}>
;repo unset-lich-updatable
</pre>
and also in the filesystem set lich.rbw to read-only for the everyone group.

[[Category:Front Ends]]

Lich:Profanity

2024-01-12T00:46:18Z

IPITTMAN: Cleanup and update the gsiv.sh and profanity.sh script examples

{{3rd-party}}
[[File:Profanity-screenshot.png|thumb|right|Screenshot of Profanity with ;narost]]
'''Profanity''' is a lightweight, unofficial front end (FE) written in Ruby by Tillmen. Its name likely reflects the author's sense of humor, or possibly the response of most people the first time they encounter it. Snarky speculation aside, it remains a fact that '''Profanity''' relies on the [https://en.wikipedia.org/wiki/Curses_(programming_library) curses library], perhaps being the true origin of the name. That is important, because the user will need a Ruby gem for curses to run '''Profanity''' (e.g., "gem install curses").

* Updated: https://github.com/elanthia-online/ProfanityFE
* Original: https://github.com/matt-lowe/ProfanityFE (not maintained)

==Overview==
The main features and advantages of Profanity compared to other FEs are generally:
*Free software (the user can freely see and modify all code)
*Lightweight with a minimalist look-and-feel (i.e. no graphics)
*Runs natively in most operating systems
*Regular expression highlighting
*Easily launched by other programs (e.g. for bots)
*Optimized screen real-estate usage

Because Profanity is a script and not compiled software, ''it can easily be run on any computer'' which has a proper version of the Ruby interpreter installed. Anyone using [[Lich (software)|Lich]] will already have most if not all the necessary tools available on their computer. This is important because Simutronics only releases FEs for Windows and macOS; thus, Profanity is particularly popular among users of other operating systems, such as GNU/Linux. It it also used by player-created robots, such as [[TownCrier]] and the [https://twitter.com/GSIVDeathLog GSIVDeathLog], owing to the minimal resources it consumes as well as the ease with which it can be launched from a [https://en.wikipedia.org/wiki/Command-line_interface command-line interface] (e.g. directly from another program or script written by the author). It is also one of the easiest interfaces to play via a tablet or smartphone because it does not waste screen real-estate with bells and whistles; Profanity automatically resolves the dimensions of the window it is called from, for instance automagically moving death messaging directly into the main game feed if the screen is under a certain size. To play via a smartphone, the best approach would be running Lich and Profanity remotely (such as on one's home PC) and then accessing the game via [https://en.wikipedia.org/wiki/Secure_Shell ssh].

Owing to its minimalist approach, Profanity could be considered slightly more difficult to install and configure than other FEs. Another possible disadvantage is that it is not officially supported, thus some game defaults give blind errors (the user can tell there is a problem but there is no feedback to indicate what went wrong) or simply behave in an unusual manner. Conversely, as free software, any person can improve it unlike official FEs which are only developed by a small number of Simutronics contractors and/or employees. At present, this article assumes some basic familiarity with the command line and UNIX-like operating systems, but it may be expanded in the future with clear instructions even for a novice who has never used the command line before.

==Launching Profanity==
Profanity is not a full FE itself as it requires Lich to be installed. Lich is used to login to GemStone, as well as for many of the features such as scripting, logging, squelching, etc. Profanity might be best thought of as an add-on to Lich which together create a full FE. Profanity must be downloaded first as outlined in the [[Lich (software)/Installation|Lich installation]] page.

===Saving login data with Lich===
[[File:Lich-login.png|thumb|right|Lich Game Entry]]
*'''Because Profanity cannot login to GemStone, one must login via Lich's Game Entry and ''save'' the information.'''
<pre{{log2|margin-right=35%}}>
ruby ~/lich-5/lich.rbw
</pre>
A graphical interface will pop up (shown on the right), and one should navigate to the Game Entry tab at the top, enter their Simutronics user name and password, and hit 'Connect'. Assuming the user name and password are correct, the list will then be populated with the player's characters to choose from. ''The most important step is to check the box 'Save this info for quick game entry'''. It doesn't matter what is done with the radio buttons for Wizard / Stormfront (we won't be using either one) nor the 'Custom launch command'. The present step is only done once, simply to tell Lich (and thus Profanity) how to login a character, not to actually perform said login. As the Wizard radio button is selected by default, it is assumed the user simply leaves it as it is. Once these things are done, simply hit 'Play' and the pop-up will close, saving your login details.

This step must be done for each character a player wishes to play. ''Note that the login data are saved only based on the character's name and not the game instance (Prime, Platinum, Shattered, Test); thus if a player has characters with the same name in different instances—which is always the case for the Test server—the above login step must be performed each time the player wants to switch game instances.

===Logging in===
To log in the character Rinualdo, one would firstly issue a command like:
<pre{{log2|margin-right=35%}}>
ruby ~/lich-5/lich.rbw --login Rinualdo --without-frontend --detachable-client=8000 &
</pre>

A default installation will need a template. Two default templates are provided. Make sure your ~/.profanity/charname.xml file exists and is not empty. You can copy the template tysong.xml file into your ~/.profanity directory with the character name you are logging in as:
<pre{{log2|margin-right=35%}}>
mkdir ~/.profanity
cp ~/ProfanityFE/templates/tysong.xml ~/.profanity/rinualdo.xml
</pre>
After which, one can now launch Profanity to connect to the previously previously ran Lich login:
<pre{{log2|margin-right=35%}}>
ruby ~/ProfanityFE/profanity.rb --port=8000 --char=Rinualdo
</pre>

To see any existing running Lich sessions prior to launching Profanity to connect to one, use the following:
<pre{{log2|margin-right=35%}}>
ps aux | grep ruby
</pre>

The above command might not connect, depending on whether or not the game entry was completed in the previous step or not, thus one either needs to wait a few seconds, or simply issue the command until a game connection is established.

Of course, one probably does not want to type all the above commands in full every time s/he wants to play. Thus it can be easily scripted. One can create executables somewhere in their PATH.

To perform the game login, one might create a script called ''gsiv.sh'' as follows:
<pre{{log2|margin-right=35%}}>
#!/usr/bin/env bash
# Script to automate login to Tillmen's lich in detached mode
# Author: daid

character="$1"

if [ -z "$character" ];then
exit
fi
echo "Logging in $character in detached mode."
echo "call profanity in another terminal"
ruby $HOME/lich-5/lich.rbw --login $character --without-frontend --detachable-client=8000
</pre>

To launch Profanity repeatedly until a connection is established, one can create a script called ''profanity.sh'':
<pre{{log2|margin-right=35%}}>
#!/usr/bin/env bash
# Profanity login wrapper
# Author: daid

character="$1"

if [ -z "$character" ];then
echo "Usage: $0 character_name"
exit
fi

$(exit 1)
until ruby $HOME/ProfanityFE/profanity.rb --port=8000 --char=$character 2> /dev/null ;do
printf "."
sleep 1
done
</pre>
{{top}}

==Features and Customization==
All of Profanity's macros and highlights are controlled with XML in a file called $HOME/.profanity.xml which will be created with some defaults the first time you launch Profanity. One can use the default examples to create their own.

===Status Displays===
As Profanity runs through a terminal emulator, all information is displayed via ASCII (unless a lich script popout is used), including the character's status. Numerical data are underlayed with a color bar graph for:
*[[Stance]] ('stance')
*[[Experience]] ('mind')
*[[Hitpoint]]s ('health')
*[[Spirit]] ('spirit')
*[[Mana]] ('mana')
*[[Stamina]] ('stam')
*[[Encumbrance]] ('load')
*[[Stun]] ('stun')
*[[Roundtime]] and [[Cast roundtime]] ('rndtime' as different colors)

====Health====

[[Wounds]] are displayed in different colors as a stick figure framed with indicators for specialized locations as well as general ailments such as [[disease]]d, [[poison]]ed and [[bleeding]]. Even with perfect [[health]], the indicator characters will be displayed by default in a dark grey as:

<pre{{log2|margin-right=60%}}>
e e ns
O
/|\ nk
o | o
/ \ bk
o o
dis psn bld
</pre>

Minor injuries appear in yellow with more severe injuries progressing into light and dark red, respectively. Scars appear in light to deeper shades of blue. It should be noted that nervous system scars and injuries are sent through the game data stream in the same manner, so Profanity does not distinguish between an injury and a scar and a nervous scar always appears in the color of an injury. All of these characters and colors are fully customizable in .profanity.xml.

As a silly example, why have "dis psn bld" when it can read "113 114 !!!". It can be fun to customize for yourself. We have matched the character length and replaced it with the issue. Ideally back-highlighted (rather than foreground highlighting) with eye-bleeding read. We can see the problem and also the solution straight up!

====Directional Movements====
A directional compass indicator displays what movements are available from the current room, normally in yellow:
<pre{{log2|margin-right=60%}}>
^ * ^ *
o < >
v * v *
</pre>

A sample customization, where slashes and backslashes are used for the diagonal directions (ne, se, sw, & nw) would look like:
<pre{{log2|margin-right=60%}}>
^ \ ^ /
o < >
v / v \
</pre>

===Macros and Key Shortcuts===
Macros in Profanity work much the same as in other FEs, and the default XML config file shows examples. It should be noted, however, that many terminal emulators have their own hot-keys which, by default, would override or get mixed up with Profanity's own macros. These will vary somewhat based on one's terminal program and operating system. There may be ways to disable said terminal hot keys, but this would disable them for all terminal instances, so one either would want a dedicated terminal program for Profanity or to create a profile. Another alternative is to avoid macros on said keys. A third option is to mix and match them in an interesting way.

A few examples of common terminal macros are:

*Shift+Insert: This will paste the normal paste buffer (since Ctrl+V doesn't usually work)
*Ctrl+U: This normally clears the line, much like the GSIV down arrow
*Ctrl+I: This is the same as the Tab key (ordinarily used for auto-completion). This is an interesting feature since it means we can make a macro on the Tab key by mapping a macro to Ctrl+I, such as [[TARGET (verb)|TARGET NEXT]]. However, note that the Tab key is ordinarily used in Profanity to switch the focus of the scrollbar (e.g. from the game feed to thought window)
*Ctrl+Z: This will suspend the program.
*Ctrl+C: This will kill the program (i.e. quit Profanity!)

===Highlights===
One of the beauties of Profanity is not only that regular expression highlighting is supported, but sharing highlights with friends is as easy as copy and pasting XML into the config file. As it is in XML, it even allows for comments to explain the purpose or origin of the highlights, which can be readily grouped into sensible blocks. Below are some common examples.

====Herbs====
Ever move to a new location and don't recognize what items are herbs? Click on [<font color=blue>Expand</font>] to the right!
<div class="mw-collapsible mw-collapsed" style="border: none; text-align:left; background: #FFF; padding: 0px 10px; margin: 0px 5px; background: #FFF;">
{| class="mw-collapsible-content"
|
<source lang="xml">

<highlight fg='399900'> bolmara potion| brostheras potion| bur-clover potion| rose-marrow potion| talneo potion| wingstem potion| acantha leaf| aloeas stem| ambrominas leaf| basal moss| calamia fruit| cothinar flower| cactacae spine| cuctucae berry| ephlox moss| strigae cactus| haphip root| marallis berry| pothinir grass| sovyn clove| spearmint leaf| torban leaf| tkaro root| wolifrew lichen| yabathilium fruit| woth flower</highlight>

<highlight fg='399900'>a crystalline rose-marrow elixir|a crystalline talneo elixir|a crystalline brostheras elixir|a crystalline bolmara elixir|a crystalline wingstem elixir|a crystalline bur-clover elixir</highlight>

<highlight fg='399900'> flower-shaped tart| iceberry tart| Leaftoe's lichen tart| musk ox tart| Dabbings Family special tart| gelatinous elk fat tart| elk fat gel| frog's bone porridge| Ma Leaftoe's spiced torban tart| polar bear fat soup| ram's bladder| sparrowhawk pie| walrus blubber| earthworm potion| elk horn potion| rock lizard potion| snowflake elixir| starfish potion| tundra grass| rock ptarmigan feathers| arctic moss</highlight>

<highlight fg='399900'> olak's Ol'style ale| bloody Krolvin ale| orc's head ale| kenar's dropjaw ale| miner's muddy ale| dacra's Dream ale| lost dogwater ale| golden goose ale| bearded ladies' ale| mad mutt frothy ale| captn' Pegleg's ale| mama dwarf's ale| aged schooner ale| gert's homemade ale| wort's winter ale| volcano vision ale| semak's smooth ale| dark swampwater ale| agrak's amber ale| reaper's red ale</highlight>

<highlight fg='399900'> acantha leaf tea| sassafras tea| red lichen tea| red lichen potion| valerian root tea| valerian root potion| sweetfern tea| sweetfern potion| manroot tea| manroot potion| angelica root potion| gingko nut tea| gingko nut potion| wyrmwood tea| wyrmwood potion| daggit root potion| feverfew tea| feverfew potion| pennyroyal tea| pennyroyal potion</highlight>

<highlight fg='399900'> tincture of acantha| tincture of rose-marrow| tincture of tkaro| tincture of bolmara| tincture of aloeas| tincture of ambrominas| tincture of basal| tincture of cactacae| tincture of calamia| tincture of cothinar| tincture of cuctucae| tincture of ephlox| tincture of haphip| tincture of pothinir| tincture of sovyn| tincture of torban| tincture of wolifrew| tincture of talneo| tincture of woth| tincture of yabathilium| tincture of brostheras| tincture of bur-clover| tincture of wingstem</highlight>

<highlight fg='399900'> grey mushroom potion| green mushroom potion| thick foggy ale| glowing mold tea| dark frothing ale| stalagmite brew| bubbling brown ale| crushed cavegrass tea| spotted toadstool ale| stalactite brew| grainy black potion| chunky black ale| roasted ratweed tea| brown weedroot ale| dirty crevice brew| dirty rat fur potion| resty red ale| sticky lichen tea| dull crimson ale| stone soot brew</highlight>
</source>
|}</div>
{{clear}}

====Buff spells falling====
Want (nearly) all the [[buff spells]] highlighted in red when they drop? Blue for positive effects? Click on [<font color=blue>Expand</font>] to the right!
<div class="mw-collapsible mw-collapsed" style="border: none; text-align:left; background: #FFF; padding: 0px 10px; margin: 0px 5px; background: #FFF;">
{| class="mw-collapsible-content"
|
<source lang='xml'>

<highlight fg='0000ff'>^The feeling of weakness leaves you. Your spirits are somewhat rejuvenated\.$</highlight>

<highlight fg='0000ff'>^You wake from your meditation, yet a deep feeling of relaxation remains present\.$</highlight>

<highlight bg='ff0000'>There is a soft pulse in the essence\.$</highlight>

<highlight fg='0000ff'>^You feel more refreshed\.$</highlight>

<highlight fg='ff0000'>^The lingering effects of your meditation fade away\.$</highlight>

<highlight fg='0000ff'>^Your form blurs\.$|^You seem to blend into the surroundings better\.$|^A brilliant luminescence surrounds you\.$</highlight>

<highlight fg='ff0000'>^The (light|deep) blue glow leaves you\.$|^Deep blue motes swirl away from you and fade\.$|^The air calms down around you\.$|^The (powerful|very powerful) look leaves you\.$|^You lose your extra internal fortitude\.$|^You notice your blood flow go back to normal\.$|^The misty halo fades from you\.$|^The dull golden nimbus fades from around you\.$|^The guiding force leaves you\.$|^The white light leaves you\.$|^The wall of force disappears from around you\.$</highlight>

<highlight fg='0000ff'>^The invisible force draws back to guide you once more\.$</highlight>

<highlight fg='ff0000'>^The dim aura fades from around you\.$|^The replenishing effect fades, but you are left with a feeling of well-being\.$|^You feel less secure\.$|^You feel the knowledge of the treatment of injuries dissipate\.$|^Your breathing becomes more shallow\.$|^You feel less confident\.$|^The brilliant aura fades away from you\.$|^The opalescent aura fades from around you\.$</highlight>

<highlight fg='ff0000'>^A white glow rushes away from you\.$|^Your .* returns to normal\.$|^Your sense of faith and conviction wanes\. You are less sure of yourself\.$|^You suddenly feel less protected\.$|^You feel the protection of your deity's influence fade\.$|^An ethereal golden collection bowl drifts out of your body, then vanishes\.$</highlight>

<highlight fg='ff0000'>^The (silvery|bright|brilliant) luminescence fades from around you\.$|^Your senses are no longer as sharp\.$|^The scintillating light fades from your hands\.$|^The focused look leaves you\.$|^You feel less confident than before\.$|^The tingling sensation and sense of security leaves you\.$</highlight>

<highlight fg='ff0000'>^The glowing specks of energy surrounding you suddenly shoot off in all directions, then quickly fade away\.$|^You suddenly feel less light-footed\.$|^You feel a slight tingling as the shimmering field fades away\.$|^You feel your extra magical awareness leave you\.$|^You feel your extra strength departing\.$|^You no longer bristle with energy\.$|^The layer of raw elemental energy surrounding you dissipates\.$|^You notice that things have returned to their normal speed\.$</highlight>

<highlight fg='ff0000'>^You return to normal color\.$|^The air about you stops shimmering\.$|^You feel less in tune with your natural surroundings\.$|^You feel your vision return to normal\.$|^You feel less nimble\.$|^The knobby layer of bark on you creaks and twists briefly before disintegrating\.$|^You feel the inner strength leave you\.$|^The swirling breeze around you finally settles\.$|^Nature\'s blessing of vitality departs as your arcane prowess returns to normal\.$|^You feel the aura of confidence leave you\.$|^You are no longer moving silently\.$|^You no longer feel so dextrous\.$|^You feel the gathering of nature\'s power leave you\.$|^You seem to lose the thorny barrier that surrounds you\.$</highlight>
<highlight fg='0000ff'>^Vital energy infuses you, hastening your arcane reflexes|is buffeted by a sudden gust of wind</highlight>

<highlight bg='ff0000'>^A dark shadow seems to detach itself from your body, swiftly dissipating into the air\.$</highlight>
<highlight fg='ff0000'>^Your body pulses momentarily into semi transparency and then returns to normal\.$|^Your murky complexion fades away, and you feel less deft\.$|^You exhale the last of a virulent green mist\.$</highlight>
<highlight fg='0000ff'>^You are seized by a sudden premonition of his demise\.$|^You acquire a certain murky complexion, and you feel more deft\.$|^Your complexion grows murkier\.$|^You feel refreshed enough to sacrifice another animus\.$</highlight>
<highlight fg='00ffff'>^The blood red haze dissipates from around</highlight>
<highlight fg='00ffff'>^The mana about you is temporarily disrupted as your magic starts to falter\.\.\.$</highlight>

<highlight fg='ff0000'>^Your .* stops glowing\.$|^The shimmering multicolored sphere fades from around you\.$|^Faint ripples in the floor beneath you become apparent before quickly dissipating\.$|^You become solid again\.$|^A luminescent aura fades from around you\.$|^The translucent sphere fades from around you\.|it is not well suited for duplicating\.$|It is currently tempering</highlight>

<highlight fg='0000ff'>It is currently tempered and ready to be enchanted\.|You feel a soft pulse in the essence around you\.</highlight>

<highlight bg='ff0000'>faintly pulses with light and you sense its enhancive magic will be depleted soon</highlight>

<highlight fg='ff0000'>^You no longer feel a sense of confidence\.$|^You no longer feel a sense of protection\.$|^Your spirits are no longer lifted by stories of Kai's Triumphs\.$|^The mirror images surrounding you undulate and fade away\.$</highlight>

<highlight fg='ff0000'>^Your mind's keen focus fades away\.$|^Your aura of resolve dissipates\.$|^You release your pinpoint focus on your healing energies and allow their stimulated flow to settle to normal rates\.$|^Your heart staggers briefly before slowing to a more regular speed\. Dark red droplets seep out of your skin and evaporate as the influence of Troll's Blood leaves you\.$</highlight>

<highlight fg='ff0000'>^You feel the tension in your skin ease and notice that your complexion returns to normal\.$|^Like sand through an hourglass, your visions of the future slip away and fade from your mind\.$|^You feel your forehead pulse as your mind relaxes\.$|^The scales covering your hands turn brittle and flake away\.$|^You feel your muscles begin to strain for an instant\. The sense of body control has left you\.$|^The thick plates of bone around your forearms begin to crack, then shatter into a fine white dust\.$|^Darkness punctuated by a constellation of starry pinpoints wells up to the surface of your skin and splinters away with a sound like shattering crystal\.$|^The barrier of force around you dissipates\.$</highlight>

<highlight fg='ff0000'>^The dully illuminated mantle protecting you begins to falter, then completely fades away\.$|^Your sense of clarity fades\.$|^The subdued warmth embracing you fades along with the spiritual force surrounding your arms\.$|^Your boosted confidence and fearlessness fade\.$|^Your skin grows slightly numb for a moment as the warm glow fades from around you\.$|^You lose a bit of focus as the knowledge of future battles drifts from your mind\.$|^You feel your abilities diminish as the energy provided by your patron fades from around you\.$|^The dim celadon wisps about your hands flare up once more and fade completely away\.$|^The subdued warmth embracing you fades along with the spiritual force surrounding your arms\.$|^You feel slightly weakened as the blood in your veins thins\.$|^You feel less resolved as the divine urging subsides, fading into obscurity\.$|^Your bolstered defenses fade with the soft glow about you\.$|^The divine force surrounding you slowly fades away\.$|^The muted pale blue sphere surrounding you flickers once and shudders before fading completely\.$</highlight>
<highlight fg='ff0000'>The dully illuminated mantle protecting .* begins to falter, then completely fades away.</highlight>

<highlight fg='ff0000'>^The brilliant, rapidly shifting aura around you shimmers and flickers briefly before fading\.$|^The brilliant, rapidly shifting aura around you shimmers and bursts in a bright flash!$|^The licks of blue flame surrounding you flare up one last time before vanishing with a staticky crackle\.$|^Like a faint wisp of a barely-remembered dream, your brief, enhanced comprehension of arcane mysteries slips away\.$|^A faint silvery glow fades from around you\.$</highlight>

</source>
|}</div>
{{clear}}

{{top}}

==Special Commands==

A series of commands specific to Profanity are built in. They are accessed beginning the command with a period ('.'). Below is a list of known Profanity commands and their function:

*.arrow : Switches between the two arrow modes. By default, up and down arrows scroll the command history. The alternate mode is to scroll the active feed.
*.copy : (Does nothing. Has fixme note in code.)
*.fixcolor : Related with loading CUSTOM_COLORS which are not set by default.
*.layout $1 : Loads the layout $1.
*.quit : Quits Profanity (but does not exit the game).
*.reload : Reloads highlights only. Can sometimes fix buffer issues.
*.resync : Forces a synchronization between Lich server and Profanity.

==Common problems==
As mentioned above, because Profanity is not an official FE nor widely used, there are some quirks which should be considered.

===Dialogs===
Some aspects of the game use pop-up dialogs. However, the game will silently fail if your FE does not support dialogs; that is, if dialogs are enabled, and you happen to issue a command that has dialog support, literally nothing will happen at all. There is no failure message because the game apparently does not detect if a dialog was launched successfully or not, nor even if your FE can even support them. '''To make matters worse, this feature is enabled by default for all characters.''' An example of such a command is [[PROFILE (verb)|Profile]]. To fix this, issue the game command
<pre{{log2|margin-right=35%}}>
>[[FLAG]] Dialogs Off
</pre>

===Training===
Training via the traditional means of going to a local inn and [[CHECK IN (verb)|check in]] works fine. However, if one instead wishes to use the modern web-browser approach offered by [[GOALS (verb)|GOALS]] then sometimes Profanity's display will get filled with some of the feedback which does not scroll nor get cleared correctly. To rectify this, simply quit profanity (''not the game, note the preceding period below'') and re-launch Profanity

<pre{{log2|margin-right=35%}}>
>.quit
% profanity.sh
</pre>

===Strange markup===
For some reason, sometimes the game feed's markup is not handled correctly by Profanity. A known instance of this is when the character is idle, which is sandwiched between nonsense ('^G') which is probably used in official FEs to produce some sort of added emphasis. So far there is no solution, and a Profanity user should simply know that this is SNAFU:

<pre{{log2|margin-right=35%}}>
^GYOU HAVE BEEN IDLE TOO LONG. PLEASE RESPOND.^G
</pre>

===Lich scripts with fancy output===

Lich scripts that use the <tt>echo</tt> call for fancy output will unfortunately output to the window which connected to GemStone not to the attached window. Thus all such messages appear in the login window rather than the game feed. There is no known solution, and script writers should be aware of this inconsistent behavior of the <tt>echo</tt> call and avoid using it. This includes [[Script Bigshot|;bigshot]] and ;zzherb for example.

===Failure to update resource bars===

Profanity assumes that the player has never customized the formatting of the resource bars in StormFront. This can produce failures to update mana, health, stamina, and/or spirit trackers in Profanity. A workaround is to remove all such customizations. These are literal game commands (as though _progba was a verb) that can be typed by the player or Lich scripted using a "put":

<pre{{log2|margin-right=35%}}>
_progba health 0
_progba stamina 0
_progba spirit 0
_progba mana 0
</pre>

{{top}}

==Useful Lich scripts==
Due to its simplicity, Profanity does not support common features of other FEs such as squelching and highlighting nouns. These are instead accomplished by Lich scripts

===Link highlighting===
Since Profanity is a strictly text-based, then of course the mouse is useless and one cannot click on any links to access verbs etc. However, at least in room descriptions it is often nice to see which items are links, because it distinguishes items which can be interacted with from the flowery description, for example looking for the entrance to a hidden room. '''The Lich script ;linktothefast makes this possible''' by wrapping links around a "link" preset, which can then be colored with:

<pre{{log2|margin-right=35%}}>
<preset id='link' fg='ff0000'/>
</pre>

'''Alternatively, one can use ;roomlinks, which was written for exactly this purpose.''' As its default is to sandwich such nouns between % symbols (underlined font is not supported), then one can add a highlight for them:

<pre{{log2|margin-right=35%}}>
<highlight fg='88aaff'>%.*?%</highlight>
</pre>

The above highlight may erroneously highlight parts of links to websites, but these should generally only be occurring in [[Out of character|OOC ]] whispers and [[Script LNet|;lnet]] chats and is this not too obnoxious. If one wishes to instead highlight all links, s/he is encouraged to check out the script ;drizzleback from which ;roomlinks was inspired. Be warned that your eyes will probably bleed.

===Logging===
To get game logs, simply download Tillmen's ;log script from the repo and add it to the global autostart.

===Squelching===
{{addmetext}}

(In the mean time, one can check out other scripts with squelching behavior, such as ;dreavening, ;carousel2016, ;squelch, etc. Note the ;squelch script is specifically for squelching given characters without removing the 'Also here' line when they are in the room, which is a common problem of squelching in other FEs, and is not a generalized squelching script.)

{{top}}

==The power of scripting==
Here we show a simple example to showcase the power of using Lich in detached mode. With the advent of [[Login Rewards]], one likely wishes to log in all their characters each day, yet this is a tedious process. It can be easily scripted.

Create a lich script in your scripts folder called ''quit.lic'' and fill it with something simple like:
<pre{{log2|margin-right=35%}}>
puts "#{Time.now} - #{Char.name} - Logged in successfully!"
sleep(5)
multifput "info", "skills full", "inventory", "bank account", "resource", "ticket balance", "boost info"
Script.run("invdb", "refresh")
puts "#{Time.now} - #{Char.name} - Login finished, exiting!"
fput "exit"
</pre>

Then create an shell script, for example ''gsiv-login.sh'' and simply fill the array CHAR_LIST with all the characters you want to log in. Then add that script to your crontab. With the shell script consisting of:
<pre{{log2|margin-right=35%}}>
#!/bin/bash
set -e

port=8000
LICH_BIN=/home/servermc/lich-gs/lich.rbw
RUBY_BIN=/home/servermc/.rbenv/versions/3.2.2/bin/ruby
CHAR_LIST=("Character1", "Character2", "Character3")

echo ""
echo "Daily logins beginning!"
/bin/date

for i in "${CHAR_LIST[@]}"
do
echo ""
echo "Attempting to login as $i..."
if ps a | \grep [d]etachable-client; then
max_port=$(ps a | grep -Eo "\-\-detachable-client=([0-9]+)" | egrep -o "[0-9]+" | sort | tail -n1)
port=$(expr $max_port + 1)
fi
echo "Launching with: $RUBY_BIN $LICH_BIN --login $i --detachable-client=$port --without-frontend --start-scripts=quit &"
$RUBY_BIN $LICH_BIN --login $i --detachable-client=$port --without-frontend --start-scripts=quit &
sleep 30
done

echo ""
echo "Daily logins finished."

</pre>

{{top}}

==Quick and Dirty: What to do for a GUI-less VM==

If you want to install Profanity on a VM (like an AWS EC2 machine or Google VM) without a GUI, there are a couple things you must do:

1. Install the appropriate ruby packages and gems from the lich instructions -- HOWEVER -- do NOT install gtk2 or wine. I used the following:
<pre{{log2}}>
sudo apt-get install ruby-dev libsqlite3-dev
sudo gem install sqlite3 --no-ri --no-rdoc
</pre>

2. Grab lich and unzip it
<pre{{log2}}>
wget https://lichproject.org/download/lich-4.6.44.zip
unzip lich-4.6.44.zip
</pre>

3. Grab profanity from GitHub and unzip it, and copy it into your lich folder
<pre{{log2}}>
cd ~/
git clone https://github.com/matt-lowe/ProfanityFE.git
cp ~/ProfanityFE/profanity.rb ~/lich
</pre>

4. This is an important step. You will not be able to run the GUI configuration interface for lich from the VM. You '''MUST''' first run the GUI config from another computer and save your settings. Go to lichproject.org and follow the instructions and connect to the game at least once from a Windows, Mac, Linux or other computer with a GUI interface to lich.

5. Next, you need to zip up the ''data'' folder on the GUI computer located at lich/data. Then you need to SFTP it to your VM, unzip it, and copy it over your ~/lich/data folder. I cannot give specific instructions here because everyone has a different way of doing this.

6. Lastly, you can run lich and profanity as shown above now that you have a character profile saved in the data folder.
<pre{{log2}}>
ruby ~/lich/lich.rb --login <character> --without-frontend --detachable-client=8000 2> /dev/null &
ruby ~/profanity.rb --port=8000
</pre>

A couple more things:

You'll want to modify lich because the newer version of ruby doesn't play well with lich. cd into your lich folder and run
<pre{{log2}}>
sed -i -e 's/$SAFE [<=]$ 3/\1 1/' lich.rbw
</pre>
to update lich.rbw.

You'll also want to keep lich from updating itself and overwriting your updates, so in the game run
<pre{{log2}}>
;repo unset-lich-updatable
</pre>
and also in the filesystem set lich.rbw to read-only for the everyone group.

[[Category:Front Ends]]

Lich:Software/Installation

2024-01-09T23:42:08Z

IPITTMAN: lich-5/.ruby-version is currently at 3.3.0

{{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 supporting Ruby 3.2 - published Nov 17, 2023'''

==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===

# '''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 Lich 5.7.0

===Ruby 3.2 & 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 Ruby4Lich5old. (Defaults to C:\Ruby4Lich5)
# Download the latest [https://github.com/elanthia-online/lich-5/releases/latest Ruby4Lich5.exe Installer]
# Run the installer and be sure to have both Ruby and Lich 5 option selected
# Congratulations - you're now running on Lich 5.7.0 & Ruby 3.2

==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 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==
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.

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

==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 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 3.3.0 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.3.0 -v
rbenv global 3.3.0
</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
mkdir lich-5/scripts
mkdir lich-5/data
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/alias.lic > lich-5/scripts/alias.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/autostart.lic > lich-5/scripts/autostart.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/ewaggle.lic > lich-5/scripts/ewaggle.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/go2.lic > lich-5/scripts/go2.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/jinx.lic > lich-5/scripts/jinx.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/lich5-update.lic > lich-5/scripts/lich5-update.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/log.lic > lich-5/scripts/log.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/map.lic > lich-5/scripts/map.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/repository.lic > lich-5/scripts/repository.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/vars.lic > lich-5/scripts/vars.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/version.lic > lich-5/scripts/version.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/effect-list.xml > lich-5/data/effect-list.xml
</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">
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
mkdir lich-5/scripts
mkdir lich-5/data
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/alias.lic > lich-5/scripts/alias.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/autostart.lic > lich-5/scripts/autostart.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/ewaggle.lic > lich-5/scripts/ewaggle.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/go2.lic > lich-5/scripts/go2.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/jinx.lic > lich-5/scripts/jinx.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/lich5-update.lic > lich-5/scripts/lich5-update.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/log.lic > lich-5/scripts/log.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/map.lic > lich-5/scripts/map.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/repository.lic > lich-5/scripts/repository.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/vars.lic > lich-5/scripts/vars.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/version.lic > lich-5/scripts/version.lic
curl https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/effect-list.xml > lich-5/data/effect-list.xml
</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.7.0''' (current)
<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]]

Twilight Hall

2020-01-07T03:52:22Z

IPITTMAN: Added RR annex

[[File:Twilight hall.jpg|170px|thumb|right|Veiled in the darkness or aglow in the light, the magic of Twilight beckons all]]

'''Twilight Hall''' is located in '''a rune-carved fieldstone house''' on the northernmost block of West Ring Road in [[Wehnimer's Landing]]. It also has an annex in every major town. The annex on [[Teras Isle]] is located on the Logging Road north of town in the ornate stone tower. The annex near [[Ta'Illistim]] is in the forest off of Gyldemar Road three rooms from the intersection with Sylvarraend Road.

''The locker entrance in the Ta'Illistim annex (Gyldemar Road) is behind the mosaic.''

==Statement of Purpose==

Twilight Hall serves as a safe haven for those who wish to study and practice magic. Our goal is to promote the greater understanding of the magical arts through education and example. We aim to provide a politically, religiously and racially neutral home to adventurers dedicated to the study of magic in Elanthia.

==How to Join==

Attend a regularly scheduled tour or meeting (see calendar link below) and express a desire to join. Initiates must:
*be level 5
*not belong to any other House
*demonstrate a minimal knowledge of magic by casting (or singing, chanting, etc.) one spell without the use of magic items or societal powers
*pay an Initiation Fee of 20,000 silvers
*pledge an oath to the dedication of magic and to uphold the principles of Twilight Hall

==Annexes==
{| {{prettytable}}
!width=220; style="background:#DDDDDD"|Name
!width=120; style="background:#DDDDDD"|Location
|-
|Blackberry Room (Lich ID: 19259)
|[[Icemule Trace]]
|-
|Twilight Tower, Observatory (Lich ID: 23239)
|[[Kharam Dzu]]
|-
|Atrium Annex (Lich ID:12296)
|[[Mist Harbor]]
|-
|Twilight Hall Annex (Lich ID:23195)
|[[River's Rest]]
|-
|Twilight Lodge (Lich ID:24507)
|[[Ta'Illistim]]
|-
|
|[[Ta'Vaalor]]
|-
|
|[[Solhaven]]
|-
|
|[[Zul Logoth]]
|}

==Map==
[[File:Twilight Hall2.jpg|900px]]

==Resources==
*[http://twilight.theyeti.org/ Twilight Hall Website]
*[http://www.google.com/calendar/embed?src=gstwilighthall@gmail.com&ctz=America/New_York Event Calendar]
*[http://forums.play.net/forums/GemStone%20IV/Cooperative%20Houses%20of%20Elanthia%20(CHE%60Great%20Houses)/Twilight%20Hall/view Officials folder]
*[https://ps.lichproject.org/shops/6603 The Scarlet Owl (Twilight Hall's Landing shop)]
*[https://ps.lichproject.org/shops/4985 Whorten's Shop (Twilight Hall's Teras shop)]
*[https://twilightlibrary.weebly.com/ Historical Library of Twilight Hall (Twilight Hall's Online Library)]
[[Category:CHE]]