GemStone IV Wiki - User contributions [en]

Ruby

2025-02-23T02:10:57Z

SDANIEL: /* List of Rubies */

'''Rubies''' are very similar to [[sapphire]]s, the only difference being the impurity that causes the ruby to become red rather than the various other hues of a sapphire. Like the sapphire, a ruby is comprised primarily of a compound of aluminum oxide, or corundum. The impurity that imparts the red color to ruby is chromium.

= Ruby Material =
{{material
| image =
| bonus = -10
| str = 69
| dur = 665
| weight = 100%
| use = Weapons, Armor
| rarity = Uncommon
| special = Non-Metallic
| color = Red
| dye = No
}}
'''Ruby''' is an uncommon material that can be used for combat gear. It is one of the custom material options available via the standard weapon shop [[Verb:ORDER|ORDER]] system. Until April of 2024 '''ruby''' was also a custom material option for the standard armor shop [[Verb:ORDER|ORDER]] system, but has since been removed.

== Related Articles ==
*[[:Category:Materials|Materials Category]]
*[[Material/saved posts|Material saved posts]]

[[Category:Materials]]
[[Category:Metals]]

----

= Ruby Gemstones =
[[Image:Ruby cristal.jpg|right|thumb|A ruby crystal prior to being cut.]]
Asterism, a rare property sometimes exhibited in rubies when cut in cabochon, causes a visible six or twelve pointed star to appear within a ruby when viewed in light. This property, due to its rarity, makes a ruby more valuble, however, this is not the case in the world of [[Elanthia]].<sup>[http://en.wikipedia.org/wiki/Ruby]</sup>
== List of Rubies ==
{{Gem disclaimer}}
<br style="clear:both;">
{{Gem
|name = a dragon's-tear ruby
|rarity =
|value =
|location = [[Elven Nations]]
|description = This octagonal piece of stone has not been polished,but even the pitting and pocking of its exteriorcannot hide its value and beauty. The translucent gem glistens with the same dark red as a coagulating drop of blood. When light glances over its exterior, it reflects back in a startling sky-blue shade rather than white, but the fire that blazes in the jewel's dark heart is of an unmistakable crimson hue.}}
<br style="clear:both;">
{{Gem
|name = a dwarf-cut ruby
|rarity = Common
|value = 4500
|location = Northern Caravansary
|description = Minute flecks of golden imflass contaminate the ruby, but, rather than detracting from the deep red gem's beauty, they enhance it -- for each fleck is shaped like a tiny fern frond, and the miniscule golden shapes swirl like a whirlwind around the incandescent heart of the jewel.}}
<br style="clear:both;">
{{Gem
|name = a faceted blood red sandruby
|rarity =
|value =
|location = [[Sanctum of Scales]]
|description = A constellation of golden motes flashes like fire in the core of the ruby. The dark red hue of the gem is enhanced by swirls of sunny yellow that drift through it like veils of sand blown by a desert breeze.}}
<br style="clear:both;">
{{Gem
|name = a flickering snowfire ruby
|rarity =
|value = 5000
|location = [[Icemule Trace]]
|description = The snowfire ruby sparkles with flickers of frosty iridescence, as if its heart were a flame frozen in crystalline form. Intricately cut, the gem is graced with hints of cobalt blue along the edges of its facets, lending complexity to its rich color.}}
<br style="clear:both;">
{{Gem
|name = an impure blood red ruby
|rarity =
|value =
|location = [[Sanctum of Scales]]
|description = Blackish impurities cloud the interior of the ruby, swirling like a sky in storm. They lend a tenebrous darkness to the jewel's predominant bloody hue.}}
<br style="clear:both;">
{{Gem
|name = a pale pink mistvein ruby
|rarity =
|value =
|location = [[Isle of the Four Winds]]
|description = The small chunk of cloudy pink ruby is laced with shimmering strands of misty silver. Each metallic inclusion is composed of hundreds of miniscule flecks that reflect light like a hazy web of tiny dewdrops.}}
<br style="clear:both;">
{{Gem
|name = a star ruby
|rarity =
|value = 1200 
|location = Any
|description = Cut into a simple cabochon, the top of this ruby displays a silvery six-legged star that follows the light and appears to hover above the surface of the gem. The stone itself is dark pink, and only partially translucent due to the rutile needles that create the stunning asterism.}}
<br style="clear:both;">
{{Gem
|name = an uncut ruby
|rarity =
|value = 2700
|location = Any
|description = A deep, pigeon blood red, the ruby is a barrel-shaped hexagon with tiny parallel grooves on all surfaces. A stream-polished spot on one side reveals the translucency of the gem's interior.}}
<br style="clear:both;">
{{Gem
|name = a sylvarraend ruby
|rarity =
|value = 3800 - 4300
|location = [[Elven Nations]]
|description = Minute flecks of golden imflass contaminate the ruby, but, rather than detracting from the deep red gem's beauty, they enhance it -- for each fleck is shaped like a tiny fern frond, and the miniscule golden shapes swirl like a whirlwind around the incandescent heart of the jewel.}}
<br style="clear:both;">
{{Gem
|name = a vinous gigasblood ruby
|rarity =
|value = 4900
|location = [[Hinterwilds]]
|description = Roughly the size of a giantman's fist, the ruby is a deep red of fine wine. Though its hue is surpassingly dark, the jewel is surprisingly clear, its facets collecting ambient light to suffuse its core with incarnadine fire.}}

==References==
*[https://www.play.net/gs4/info/gems/gem8.asp#ruby Ruby on Play.net]

Talk:Realm Weapon

2025-02-09T22:01:14Z

SDANIEL:

Just as a note because this has been reported a few times: The flares are set when you GET the weapon, not when you swing it. So it you GET the weapon on Four Winds, it will be set to steam flares. If you then transport back to your original town, you will still have the steam flare unless you store and re-equip the weapon. Same if you use the Chronomage or walk to a different realm. This is a feature, not a bug. [[User:GS4-VANAH|GameMaster Vanah]] ([[User talk:GS4-VANAH|talk]]) 13:58, 28 April 2016 (CDT)

For UAC gloves and boots, its also set when you JAB, PUNCH, GRAPPLE, and KICK. [[User:HAZADO22|HAZADO22]] ([[User talk:HAZADO22|talk]]) 14:07, 28 April 2016 (CDT)
<pre{{log2}}>
Pulled out in Landing.

You get a pair of rolaren-studded gauntlets from inside your shredded-edged greatcloak. '''They emit a low, rumbling tone.'''
You get a pair of rolaren-toed boots from inside your shredded-edged greatcloak. '''They emit a low, rumbling tone.'''

JAB and KICK in Solhaven.

You concentrate intently, focusing all your energies.
With instinctive motions, you weave to and fro striking with deliberate and unrelenting fury!
You attempt to jab a werebear!
'''Your rolaren-studded gauntlets emit a high-pitched thrumming sound.'''
You have decent positioning against a werebear.
UAF: 96 vs UDF: 85 = 1.129 * MM: 93 + d100: 9 = 114
... and hit for 1 point of damage!
Lackluster jab to the mid-back.
You attempt to jab a werebear!
You have decent positioning against a werebear.
UAF: 96 vs UDF: 85 = 1.129 * MM: 100 + d100: 33 = 145
... and hit for 4 points of damage!
Downward-swinging jab lands a swift blow against the right ankle!
Strike leaves foe vulnerable to a followup jab attack!
Your series of strikes and ripostes leaves you off-balance and out of position.
You are beginning to feel a little fatigued.
Roundtime: 7 sec.
Roundtime changed to 3 seconds.

You attempt to kick a werebear!
'''Your rolaren-toed boots emit a high-pitched thrumming sound.'''
You have excellent positioning against a werebear.
UAF: 96 vs UDF: 85 = 1.129 * MM: 101 + d100: 1 = 115
... and hit for 5 points of damage!
Fast kick to chest doesn't even make the werebear blink.
Roundtime: 4 sec.
</pre>

Realm Flaring weapons can't be blessed, article needs to be updated. [[User:HAZADO22|HAZADO22]] ([[User talk:HAZADO22|talk]]) 14:29, 28 April 2016 (CDT)
<pre{{log2}}>
You deeply say, "These are realm flaring."
You deeply say, "So not sure it will work."

A wave of power flows out of Dirvy towards a pair of rolaren-studded gauntlets.
A soft white glow surrounds the gauntlets. Suddenly you are blinded by a brilliant flash of light as the gauntlets is forcibly wrenched from the hand of Dirvy, sending it clattering to the ground where it returns to its original color.

Dirvy softly says, "That would be no."

You nod.

Dirvy picks up a pair of rolaren-studded gauntlets. They emit a cloud of heated steam.
Dirvy offers you a pair of rolaren-studded gauntlets. Click ACCEPT to accept the offer or DECLINE to decline it. The offer will expire in 30 seconds.
</pre>

:The blessing aspect comes directly from a Tamuz post, which I may have misread. [[User:VANKRASN39|VANKRASN39]] ([[User talk:VANKRASN39|talk]]) 16:25, 28 April 2016 (CDT)

In addition to not being blessable, realm flare weapons are VERY hard to ensorcell. I (level 48 sorcerer) tried and it "would require a miracle to do so". Womp womp. --[[User:SDANIEL|SDANIEL]] ([[User talk:SDANIEL|talk]]) 16:00, 9 February 2025 (CST)

Lich:Profanity

2025-01-13T23:01:20Z

SDANIEL: /* The power of scripting */ commas are not good for bash arrays

{{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 ~/lich5/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 ~/lich5/lich.rbw --login Rinualdo --without-frontend --detachable-client=8000 &
</pre>

A default installation will need a template. Two default templates are provided. Make sure to rename your template after your character name ProfanityFE/templates/charname.xml and is not empty. If you do not have a template, it will default to load the default.xml template. You can copy the template tysong.xml file with the character name you are logging in as:
<pre{{log2|margin-right=35%}}>
cp ~/ProfanityFE/templates/tysong.xml ~/ProfanityFE/templates/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/lich5/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/lich5/lich.rbw
RUBY_BIN=/home/servermc/.rbenv/versions/3.3.3/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://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip
unzip lich-5.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/elanthia-online/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 ~/lich5/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]]