GemStone IV Wiki - User contributions [en]

Bloodrune

2026-03-23T19:52:17Z

HORIBU1: additional div changes for sectional inclusion

<table><tr valign="top"><td>
A '''[[#Bloodrune|bloodrune]]''' can be used in conjunction with a [[MoonShard pendant]] in order alter the appearance of its glamour or with a [[Bloodrune Holder]] to create an illusion. Using [[#Flat Etched Stone|stones]] found in the sewers and a [[#Chisel|chisel]], they can be created by carving an [[#Ur-Barath Totem|ur-barath totem]]. When a bloodrune is in use, it adds an additional line to the pendant's {{boldmono|LOOK}}/{{boldmono|SHOW}} description and alters the glamour that the pendant projects based on its tier.

Bloodrunes can be {{boldmono|TURNed}} to prevent them from being sold to the archaeologist NPC. {{boldmono|MARK}} does not work with this item.
{{TOC limit|2}}
{{itemtiermulti 
|item=Ur-Barath Totem 
|itemsummary= 
An '''ur-barath totem''' serves as the starting form of a [[#Bloodrune|bloodrune]]. When {{boldmono|CARVEd}} with a [[#Chisel|chisel]], the ur-barath totem is transformed into a bloodrune.
|analyze= 
You analyze your ur-barath totem and sense that the item is largely free from merchant alteration restrictions.

The creator has also provided the following information:
This totem is not suitable for alterations or fodder. It appears as if it might be suitable for carving with a chisel. You should find a jagged stone which can be found within the Duskruin tunnels.

You get no sense of whether or not the totem may be further lightened.
|inspect= 
|show= 
|affinity= 
|itemverbtable= 
}}
{{itemtiermulti 
|item=Flat Etched Stone 
|itemsummary= '''Flat etched stones''' are found in the [[Bloodriven Sewers]] of Duskruin. Using a [[#Chisel|chisel]] sold at [[BVShop:The Mar and Scar|The Mar and Scar]], along with an [[#Ur-Barath Totem|ur-barath totem]], you can {{boldmono|READ}} the stone to commit the rune to memory before you {{boldmono|CARVE}} the totem with the chisel.
|analyze= 
This etched stone is of the ''<type>'' tier. To learn more about it, you should ask the dwarven archaeologist around the Underground Temple of Bloodriven Village. Or, you can READ the stone to burn the image to your memory for a short time.

Your etched stone can be purchased by the Archaeologist in Bloodriven Village. Use TURN to mark it as unsellable.
|inspect= 
|affinity= 
|itemverbtable= Yes
}}
{| {{verbtable}} 
|- {{verbtableheader|90}}
! scope="col" style="width:5em;"|Verb
! scope="col" style="width: 45%"|First
! scope="col" style="width: 45%"|Third
|-
! scope="row" role="rowheader"|LOOK
| This smooth stone bears unfamiliar markings along its flat surface. Thin veins of crimson create a web-like pattern across its exterior.
There appears to be something written on it.
| N/A
|-
! scope="row" role="rowheader"|READ
| Carved into the top of the stone is the "''<rune>''" rune. While unfamiliar, you sense that reading it again will set its design to memory and cause the stone to crumble.

{{blue|If you are ready to study this stone, READ the stone again within 15 seconds.<br>
[NOTE: You must have a totem and a chisel in order to carve.]}}
| N/A
|-
! scope="row" role="rowheader" rowspan="3" |TURN
| You flip a flat etched stone over in your hand and scratch the stone with your fingernail, creating a small "X" along its surface.
| {{addmetext}}
|-
| You flip a flat etched stone over in your hand and scratch the stone with your fingernail, scraping off a small "X" along its surface.
| {{addmetext}}
|-
| colspan="2" style="text-align:center"|This toggles if the stone can be sold to the archaelogist in the Arena for bloodscrip.
|}
{{itemtiermulti 
|item=Chisel 
|itemsummary= A '''primitive metal chisel''' sold at [[BVShop:The Mar and Scar|The Mar and Scar]] can be used to carve a rune into an [[#Ur-Barath Totem|ur-barath totem]]. The rune's appearance must be taken from a [[#Flat Etched Stone|flat etched stone]] found in the [[Bloodriven Sewers]].
|analyze= 
This single-use chisel can be used to carve ur-barath totems found during Duskruin Dig. <CARVE TOTEM WITH CHISEL> You should look for stones in Duskruin's tunnels. These items cannot be altered.
|inspect= 
|affinity= 
|itemverbtable=Yes 
}}
{| {{verbtable}} 
|- {{verbtableheader|90}}
! scope="col" style="width:5em;"|Verb
! scope="col" style="width: 45%"|First
! scope="col" style="width: 45%"|Third
|-
! scope="row" role="rowheader"|CARVE {TOTEM} WITH {CHISEL}
| {{addmetext}}
| {{addmetext}}
|}
{{itemtiermulti 
|item= Bloodrune
|itemsummary= '''Bloodrunes''' are created when a [[#Ur-Barath Totem|totem]] has been carved with a [[#Chisel|chisel]] after the [[#Flat Etched Stone|stone]] has been read and crumbles.

There are multiple tiers: [[{{PAGENAME}}#Classic|Classic]], [[{{PAGENAME}}#Divine|Divine]], [[{{PAGENAME}}#Arcane|Arcane]], [[{{PAGENAME}}#Mystic|Mystic]], and [[{{PAGENAME}}#Legendary|Legendary]]. Verb usage for the bloodrune is similar to its flat etched stone version.
|analyze= The creator has also provided the following information:

This moss-covered bloodrune is of the ''<type>'' tier. Using PUSH (pendant) while holding a ''ragged moss-covered'' bloodrune you can add it to the pendant. Likewise, you can PULL (pendant) to remove a bloodrune that has been added. Speak to the dwarven archaeologist around the Underground Temple of Bloodriven Village for more information.

Your moss-covered bloodrune can be purchased by the Archaeologist in Bloodriven Village. Use TURN to mark it as unsellable.
|inspect= 
|affinity= 
|itemverbtable= 
}}
==Additional Information==
===Classic===
Classic bloodrunes are the most common tier available. When added, the bloodrune adds an additional line to the glamour illusion of the pendant.

* '''Bloodrune Holder'''
: ''Effect: (He/She) gives off a(n) <rune> semblance.''

* '''MoonShard Pendant'''
: ''Effect: A(n) <rune> look washes over (his/her) face.''
<section begin=classic /><div><ul>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2016
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>^v^</nowiki>}}'''
| bloodthirsty
|-
|role="rowheader" | '''{{big|<nowiki>OXO</nowiki>}}'''
| enraged
|-
|role="rowheader" | '''{{big|<nowiki>| | |</nowiki>}}'''
| savage
|-
|role="rowheader" | '''{{big|<nowiki>)|(</nowiki>}}'''
| tempestuous
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released April 2017
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>v-o-v</nowiki>}}'''
| ferocious
|-
|role="rowheader" | '''{{big|<nowiki>X</nowiki>}}'''
| fierce
|-
|role="rowheader" | '''{{big|<nowiki>^w^</nowiki>}}'''
| menacing
|-
|role="rowheader" | '''{{big|<nowiki>)*(</nowiki>}}'''
| persuasive
|-
|role="rowheader" | '''{{big|<nowiki>- - -</nowiki>}}'''
| serene
|-
|role="rowheader" | '''{{big|<nowiki>|OO|</nowiki>}}'''
| solemn
|-
|role="rowheader" | '''{{big|<nowiki>/ / /</nowiki>}}'''
| troubled
|-
|role="rowheader" | '''{{big|<nowiki>v--v</nowiki>}}'''
| vicious
|-
|role="rowheader" | '''{{big|<nowiki>OoO</nowiki>}}'''
| wild
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2017
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>/o\</nowiki>}}'''
| melancholy
|-
|role="rowheader" | '''{{big|<nowiki>| oo |</nowiki>}}'''
| tormented
|-
|role="rowheader" | '''{{big|<nowiki>O/\O</nowiki>}}'''
| vengeful
|-
|}
<br>
{| class="wikitable alternating" style="text-align:center;"
|+ Released June 2018
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>*Sss</nowiki>}}'''
| enraptured
|-
|role="rowheader" | '''{{big|<nowiki>!i!-</nowiki>}}'''
| imperious
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2020
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>/--/</nowiki>}}'''
| devious
|-
|role="rowheader" | '''{{big|<nowiki>~\-</nowiki>}}'''
| pitiless
|-
|role="rowheader" | '''{{big|<nowiki>~\o</nowiki>}}'''
| pitiful
|-
|role="rowheader" | '''{{big|<nowiki>Vv|</nowiki>}}'''
| sadistic
|-
|}

{| class="wikitable alternating" style="text-align:center;"
|+ Released February 2022
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>O|O</nowiki>}}'''
| contemplative
|-
|} </li>
</ul></div><section end=classic />
{{top}}

===Divine===
Divine bloodrunes are the second most common tier able to be found in the sewers. Similar to the [[Bloodrune#Classic | classic]] tier, they add a line to the MoonShard pendant's original glamour effect, and align with specific deities. A [[Blood-infused crystal#Divine | blood-infused crystal]] can be used to slightly alter the rune on divine bloodrunes, changing the moonshard pendant's base glamour.

* '''Bloodrune Holder'''
: ''Effect: Miniature <item> spiral outward from (him/her) before fading away.''

* '''MoonShard Pendant'''
: ''Effect: Interspersed within the dim aura are miniature <item> that float around (him/her).''
<section begin=divine />
<div><ul>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Liabo
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>^~^~^</nowiki>}}'''
|[[Charl]]
| jade tridents
|-
| role="rowheader" | '''{{big|<nowiki>o|`</nowiki>}}'''
| [[Cholen]]
| music notes
|-
| role="rowheader" | '''{{big|<nowiki>/--\</nowiki>}}'''
| [[Eonak]]
| iron anvils
|-
| role="rowheader" | '''{{big|<nowiki>\__/</nowiki>}}'''
| [[Imaera]]
| sheafs of grain
|-
| role="rowheader" | '''{{big|<nowiki>O</nowiki>}}'''
| [[Jastev]]
| crystal balls
|-
| role="rowheader" | '''{{big|<nowiki>/v\</nowiki>}}'''
| [[Jaston]]
| bird feathers
|-
| role="rowheader" | '''{{big|<nowiki>---O</nowiki>}}'''
| [[Kai]]
| clenched fists
|-
| role="rowheader" | '''{{big|<nowiki>O-O-O</nowiki>}}'''
| [[Koar]]
| golden crowns
|-
| role="rowheader" | '''{{big|<nowiki>_|_|_</nowiki>}}'''
| [[Kuon]]
| golden leaves
|-
| role="rowheader" | '''{{big|<nowiki>\ \</nowiki>}}'''
| [[Laethe]]
| black rose petals
|-
| role="rowheader" | '''{{big|<nowiki>XX</nowiki>}}'''
| [[Leya]]
| ivory-hilted daggers
|-
| role="rowheader" | '''{{big|<nowiki>|-|-|-|</nowiki>}}'''
| [[Lorminstra]]
| golden keys
|-
| role="rowheader" style="white-space: nowrap;"| '''{{big|<nowiki>~-o-o-~</nowiki>}}'''
| [[Lumnis]]
| tomes
|-
| role="rowheader" | '''{{big|<nowiki>~~~~</nowiki>}}'''
| [[Niima]]
| silver dolphins
|-
| role="rowheader" | '''{{big|<nowiki>|^|</nowiki>}}'''
| [[Oleani]]
| hearts
|-
| role="rowheader" | '''{{big|<nowiki>|*|</nowiki>}}'''
| [[Phoen]]
| brilliant sunbursts
|-
| role="rowheader" | '''{{big|<nowiki>* * *</nowiki>}}'''
| [[Ronan]]
| shimmering stars
|-
| role="rowheader" | '''{{big|<nowiki>*|o</nowiki>}}'''
| [[Tilamaire]]
| yellow treble clefs
|-
| role="rowheader" | '''{{big|<nowiki>|^*|</nowiki>}}'''
| [[Tonis]]
| pegasi
|-
| role="rowheader" | '''{{big|<nowiki>/ /</nowiki>}}'''
| [[Voaris]]
| yellow rose petals
|-
| role="rowheader" | '''{{big|<nowiki>)X(</nowiki>}}'''
| [[Voln]]
| white shields
|-
|}
</li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Lornon
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>O--O</nowiki>}}'''
| [[Amasalen]]
| two-headed serpents
|-
| role="rowheader" | '''{{big|<nowiki>^--^</nowiki>}}'''
| [[Andelas]]
| black cats
|-
| role="rowheader" | '''{{big|<nowiki>)O(</nowiki>}}'''
| [[Eorgina]]
| red flames
|-
| role="rowheader" | '''{{big|<nowiki>(-)(-)</nowiki>}}'''
| [[Fash'lo'nae]]
| slit-pupiled eyes
|-
| role="rowheader" | '''{{big|<nowiki>s-S</nowiki>}}'''
| [[Ghezresh]]|| sinuous eels
|-
| role="rowheader" | '''{{big|<nowiki>((O))</nowiki>}}'''
| [[Ivas]]
| wisps of green
|-
| role="rowheader" | '''{{big|<nowiki>~S~</nowiki>}}'''
| [[Luukos]]
| green serpents
|-
| role="rowheader" | '''{{big|<nowiki>~(o)~</nowiki>}}'''
| [[Marlu]]
| six-tentacled stars
|-
| role="rowheader" | '''{{big|<nowiki>\ X /</nowiki>}}'''
| [[Mularos]]
| rusted shackles
|-
| role="rowheader" | '''{{big|<nowiki>(-o-)</nowiki>}}'''
| [[Onar]]
| white skulls
|-
| role="rowheader" | '''{{big|<nowiki>O||O</nowiki>}}'''
| [[Sheru]]
| jackal heads
|-
| role="rowheader" | '''{{big|<nowiki>---^</nowiki>}}'''
| [[V'tull]]
| black scimitars
|-
|}
<br>
{| class="wikitable alternating" style="text-align:center;"
|+ Neutral
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>**|~~</nowiki>}}'''
|[[Aeia]]
| white lilies
|-
| role="rowheader" | '''{{big|<nowiki>=O=</nowiki>}}'''
| [[Arachne]]
| spiders
|-
| role="rowheader" | '''{{big|<nowiki>~o~</nowiki>}}'''
| [[Gosaena]]
| white feathers
|-
| role="rowheader" | '''{{big|<nowiki>~|-|~</nowiki>}}'''
| [[The Huntress]]
| eight-pointed stars
|-
| role="rowheader" | '''{{big|<nowiki>oOo</nowiki>}}'''
| [[Zelia]]
| grey chariots
|}</li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Other
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>OOO</nowiki>}}'''
| [[Illoke]]
| boulders
|-
| role="rowheader" | '''{{big|<nowiki>.o.</nowiki>}}'''
| [[Khaarne]]
| stones
|-
| role="rowheader" | '''{{big|<nowiki>|=|</nowiki>}}'''
| [[Meyno]]
| slabs of rock
|-
|} </li>
</ul></div>
<section end=divine />
{{top}}

===Arcane===
Arcane bloodrunes are the third tier available, and were initially introduced during the August 2017 Duskruin run. Unlike the [[Bloodrune#classic|classic]] or [[Bloodrune#Divine|divine]], arcane bloodrunes change the entire glamour affect of the MoonShard pendant instead of adding a line at the end of it. [[Blood-infused crystal#Arcane | Blood-infused crystals]] can be used to change the location in the pendant's glamour from '''Bloodriven Village''' to the location associated with the rune on the crystal.

* '''Bloodrune Holder'''
: ''Effect: <Rune Type> arcane sigils glow in front of (him/her).''

* '''MoonShard Pendant:'''
<section begin=arcane /><div><ul><li style="display: block;">
: <h4>Released August 2017</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>,,-,'</nowiki>'''}}
| '''Anatomical'''
|align=left| Through a <pendant color> haze, you see an Anatomical Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Murky golden tendrils wrap possessively around <his/her> shadowed figure, which is covered in rapidly healing and unhealing wounds.
| <Thin>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>o|-</nowiki>'''}}
| '''Animation'''
|align=left| Through a <pendant color> haze, you see an Animation Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A sickly green miasma writhes riotously around <his/her> shadowed figure, which is covered in arabesque patterns framed by an unnatural glow.
| <Bold>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>^-z_</nowiki>'''}}
| '''Blood'''
|align=left| Through a <pendant color> haze, you see a Blood Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Blood red mist swirls threateningly around <his/her> shadowed figure, which is covered in jagged scars.
| <Sanguine>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>+ =Y</nowiki>'''}}
| '''Chaos'''
|align=left| Through a <pendant color> haze, you see a Chaos Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Thick black smoke spirals turbulently around <his/her> dark figure, which is covered in stylized lubricious streaks of ebon.
| <Erratic>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>*Oo**%</nowiki>'''}}
| '''Cosmology'''
|align=left| Through a <pendant color> haze, you see a Cosmology Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Streaks of black and golden energy flash violently around <his/her> pale figure, which is covered in veins that glow with white light.
| <Nebulous>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>x_ _X</nowiki>'''}}
| '''Death'''
|align=left| Through a <pendant color> haze, you see a Death Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Unctuous black locusts flit savagely around <his/her> shadowed figure, which is covered in charred-edged stylized characters.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>Q__Q</nowiki>'''}}
| '''Divination'''
|align=left|Through a <pendant color> haze, you see a Divination Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Nebulous golden clouds meander aimlessly around <his/her> shadowed figure, which is covered in a spray of glistening dewdrops.
| <Violet-streaked>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>|o~o|</nowiki>'''}}
| '''Elemental'''
|align=left| Through a <pendant color> haze, you see an Elemental Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Lightning-streaked violet gloom twists haphazardly around <his/her> dark figure, which is covered in constantly sparking lines of electricity.
| <Flashing>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>;~-- ~~</nowiki>'''}}
| '''Energy'''
|align=left|Through a <pendant color> haze, you see an Energy Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Shimmering rainbow light flashes intermittently around <his/her> pale figure, which is covered in powdery white arcane lettering.
| <Pulsating>
|-
| role="rowheader" scope="row" style="white-space: nowrap"| {{big|'''<nowiki>__%=__ </nowiki>'''}}
| '''Extraplanar'''
|align=left| You see an Extraplanar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Sparks of gold infuse the deep grey brume that twirls rapidly around <his/her> pale figure, which is covered in burnt skin and scorch marks.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>:'`||':</nowiki>'''}}
| '''Mental'''
|align=left|Through a <pendant color> haze, you see a Mental Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Soft sky blue fog gently wafts to and fro around <his/her> illuminated figure, which is covered in constantly shifting esoteric runes.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>~~s*</nowiki>'''}}
| '''Spirit'''
|align=left| Through a <pendant color> haze, you see a Spirit Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A cloud of innocuous white smoke winds lazily around his dark figure, which is covered in long, blood-streaked scratches.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>^`\`/-</nowiki>'''}}
| '''Supernatural'''
|align=left| Through a <pendant color> haze, you see a Supernatural Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A darkly shaded film bends loosely around <his/her> dark figure, which is covered in a glaze of misty, elaborately constructed shapes.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>](*)[</nowiki>'''}}
| '''Symbology'''
|align=left| Through a <pendant color> haze, you see a Symbology Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A whirlwind of books and scrolls churns wildly around <his/her> shadowed figure, which is covered in an array of archaic runes.
| <Searing>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>~~/~~</nowiki>'''}}
| '''Temporal'''
|align=left| Through a <pendant color> haze, you see a Temporal Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A veil of visibly distorted air curls closely around <his/her> illuminated figure, which is covered in contorting geometric forms.
|
|-
|}

: <h4>Released February 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" style="white-space: nowrap" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>*^_v*</nowiki>'''}}
| '''Mesmerism'''
|align=left|Through a <pendant color> haze, you see a Mesmerism Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Hypnotically bright sparks of gold and silver dance around <his/her> illuminated figure, which is covered in a glimmering opaline sheen.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>[[]-[]-[]]</nowiki>'''}}
| '''Occlusion'''
|align=left|Through a <pendant color> haze, you see a Occlusion Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Occasionally smeared with darkness, an otherwise nearly translucent barrier continually folds in and out of existence around <his/her> illuminated figure, which is covered in distinctive chalky white sigils.
| <Frost-tinged>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>,~YvY~`</nowiki>'''}}
| '''Ritual'''
|align=left|Through a <pendant color> haze, you see a Ritual Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Unnaturally flickering candlelight flares erratically around <his/her> shadowed figure, which is covered in myriad precise symbols slashed into his skin.
| <Rigid>
|-
|}

: <h4>Released June 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" style="white-space: nowrap" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>-|T|-</nowiki>'''}}
| '''Construct'''
|align=left|Through a silver-flecked light azure haze, you see a Construct Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. An encompassing golden aura sends streamers of flashing light ricocheting around <his/her> illuminated figure, which is covered in patches of skin with a granite-like white alabaster stone apperance.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>|(C0</nowiki>'''}}
| '''Lunar'''
|align=left|Through a <pendant color> haze, you see a Lunar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Fading in and out of sight, pale moonbeams fancifully float to and fro around <his/her> pale figure, which is covered in a wash of silvery white moonlight.
| <Pale silver>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>=0=</nowiki>'''}}
| '''Solar'''
|align=left|Through a radiant golden haze, you see <a/an> Solar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Nearly blindingly billiant, fiery sunrays radiate out from around <his/her> illuminated figure, which is covered in a wash of reddish gold sunlight.
|
|-
|}

: <h4>Released August 2020</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>0*8t</nowiki>'''}}
| '''Augury'''
|align=left|Through a silver-flecked light azure haze, you see <a/an> Augury Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A clustered miasma of faint, ever-changing images hovers around <his/her> illuminated figure, which is covered in a dark, prismatic material.
| <Rippling>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>{[:</nowiki>'''}}
| '''Enchantment'''
|align=left|Through a silver-flecked light azure haze, you see <a/an> Enchantment Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A cloud of elemental energy pulses around <his/her> illuminated figure, which is covered in runic brands interspersed with singe marks.
| <Rippling>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>xO|</nowiki>'''}}
| '''Hexeri'''
|align=left|Through an ethereal white haze, you see <a/an> Hexeri Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Rough-shod charms and talismans hover in mid-air, swinging back and forth around <his/her> illuminated figure, which is covered in scarlet-leaking black veins.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>c--</nowiki>'''}}
| '''Metallurgy'''
|align=left|Through an ethereal white haze, you see <a/an> Metallurgy Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Tiny, razor-thin scraps of metal flit around his illuminated figure, which is covered in a medley of shifting, metallic-inked tattoos.
|
|-
|}
</li></ul></div><section end=arcane />

{{top}}

===Mystic===
Mystic bloodrunes are the final tier of more widely available bloodrunes. Similar to [[Bloodrune#Arcane | arcane]] bloodrunes, they were released in August 2017 and change the entire glamour effect of the MoonShard pendant. However, mystic bloodrunes have 4-5 versions that shift when worn with a Pendant. When used in a Bloodrune Holder, it creates an illusion which is custom to each bloodrune - ''Effect: Mystical energies wash over him, [custom for each Mystic bloodrune].''

<section begin=mystic /><div><ul><li style="display: block;">
: <h4>Released August 2017</h4>
<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>8~~8</nowiki>       Continuance
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Afternoon Sky'''
|Through a <pendant color> haze, you see <character> ensconced in a shroud of pure sunlight. <His/Her> eyes are pools of deep blue reminiscent of an afternoon sky. Misty clouds of white occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...ensconcing <him/her> in a steady shroud of calm.
|-
| role="rowheader" scope="row" | '''Sunset'''
|Through a <pendant color> haze, you see <character> ensconced in a shroud of sunset. <His/Her> eyes are pools of vibrantly streaked hues reminiscent of an impending twilight. A shower of moonbeams occasionally flows across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Moonlight'''
|Through a <pendant color> haze, you see <character name> ensconced in a shroud of a dark night sky. <His/Her> eyes are pools of glowing silvery white reminiscent of moonlight. A shower of stars occasionally shoots across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Midnight'''
|Through a <pendant color> haze, you see <character name> ensconced in a shroud of midnight's black. <His/her> eyes are pools of pitch reminiscent of a starless night. Tendrils of darkness occasionally slither across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>*Oo**</nowiki>        Cosmos
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Lornon'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of ice-fringed dark moonlight. <His/Her> eyes are pools of swirling grey reminiscent of Lornon's surface. A sickly blood red hue occasionally washes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...draping <him/her> in a nebulous shroud tinged with cosmic dust.
|-
| role="rowheader" scope="row" | '''Makiri'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of darkness. <His/Her> eyes are pools of pale golden light reminiscent of starlight. Shifting constellations occasionally ebb and flow across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Liabo'''
|Through a <pendant color> haze, you see <character> swathed in a shroud of brilliant silvery white moonlight. <His/Her> eyes are pools of pure ivory reminiscent of Liabo's surface. A pale golden glow occasionally washes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Tilaok'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of fiery moonlight. <His/Her> eyes are pools of reddish-orange reminiscent of Tilaok's surface. A silvery white wash of light occasionally dances across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Star Field'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of a swirling star field. <her/His> eyes are pools of circularly graduated star-shot color reminiscent of nebulae. Asteroids and resplendent galaxy clusters occasionally twirl across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>_-_-</nowiki>        Cycle of Age
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Child'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that brings out <his/her> child-like appearance. <His/her> eyes are pools of blindingly brilliant light reminiscent of a firestorm. A velvety texture and natural glow infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...cocooning <him/her> in a cyclical shroud that ages and rejuvenates <his/her> countenance.
|-
| role="rowheader" scope="row" | '''Youth'''
| Through a radiant golden haze, you see <character> cocooned in a shroud that highlights <his/her> youthful appearance. <His/her> eyes are pools of blazing light reminiscent of a strongly burning flame. A satiny smooth, supple texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Middle-Aged'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that highlights <his/her> middle-aged appearance. <His/her> eyes are pools of bright light reminiscent of a steadily burning flame. A grainy, pebbled texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Ancient'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that highlights <his/her> ancient and stooped appearance. <His/Her> eyes are pools of dim light reminiscent of a weakly flickering flame. A wrinkled, withered texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Death'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that brings out <his/her> cadaver-like appearance. <His/Her> eyes are pools of matte black, reminiscent of a void. A disintegrating, mushy texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>||o~o||</nowiki>        Elements
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Water'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of vivid blue water. <His/Her> eyes are pools of sparkling icy white reminiscent of icicles reflecting light. White-crested sea green waves occasionally crash across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...surrounding him/her in an elemental shroud of swirling ethereal lights.
|-
| role="rowheader" scope="row" | '''Earth'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of cracked, stone earth. <His/her> eyes are pools of dark brown reminiscent of muddy flats. Flows of magma gradually solidifying into black formations occasionally creep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Fire'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of brilliant orange-red fire. <His/her> eyes are pools of blazing white reminiscent of heated metal. Bright blue flames occasionally flare across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Air'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of colorful flows of air. <His/her> eyes are pools of swirling, flashing light reminiscent of a violent maelstrom. Aurora-like swaths of shimmering air occasionally sweep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>``\`/</nowiki>        Nature
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Mountains'''
|Through a <pendant color> haze, you see <character name> enveloped in a shroud of snow-capped mountains. <His/Her> eyes are pools of pure pale blue reminiscent of glacial waters. Stormy grey clouds flashing with lightning occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...enveloping him/her in a light shroud of fluctuating winds.
|-
| role="rowheader" scope="row" | '''Highlands'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of rolling, green highlands. <His/Her> eyes are pools of vibrant variegated colors reminiscent of patches of wildflowers. The thin flow of a babbling brook occasionally streams across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Jungle'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of tropical jungle. <His/her> eyes are pools of deep, dark green reminiscent of verdant wilderness. Tiny, colorful birds and vibrant, glossy bugs occasionally flit and skitter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Desert'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of dusky, arid desert. <His/Her> eyes are pools of hazy deep blue reminiscent of heat rippling across a clear, unbroken horizon. Grains of reddish sand occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Cliffs'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of rocky ocean cliffs. <His/Her> eyes are pools of misty white reminiscent of sea foam. Waves of dark blue water occasionally crash across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>=X=-</nowiki>        Plague
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" | '''Hives'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of bright red hives. <His/her> eyes are pools of red-glazed grey reminiscent of taint and toxins. Dark red spots of scarlet plasma occasionally spurt out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...trussing him/her in a shroud of pestilence and decay.
|-
| role="rowheader" scope="row" | '''Sores'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of festering sores. <His/her> eyes are pools of white-laced black and scarlet reminiscent of infection and malady. Goopy yellowish secretions occasionally seep out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Pustules'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of oozing pustules. <His/Her> eyes are pools of viridian-veined yellow reminiscent of poison and jaundice. A thick, sickly green liquid occasionally oozes out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Scabs'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of variegated scabs. <His/Her> eyes are pools of black-infused blood reminiscent of injury and disease. Sanguine clotted matter occasionally leaks out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Decay'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of decay and rot. <His/her> eyes are pools of white maggots reminiscent of corpses and necrosis. Black coffin flies and grey beetles occasionally squirm out of <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>.|.|.|.</nowiki>        Seasons
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Summer'''
|Through an <pendant color>, you see <character> wrapped in a shroud of the summer season. <His/Her> eyes are pools of black-rimmed gold reminiscent of the sun's scorching heat. Fireflies occasionally flit to and fro, their lights sparking brightly, across across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ... wrapping him/her in an ever-changing shroud of seasonal leaves.
|-
| role="rowheader" scope="row" | '''Spring'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the spring in full bloom. <His/Her> eyes are pools of mossy green reminiscent of new, verdant growth. Scatterings of seeds, followed by a swirl of colorful blossoms, occasionally whirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Autumn'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the season of autumn. <His/Her> eyes are pools of variegated grey reminiscent of decay after the harvest. Handfuls of reddish-orange leaves occasionally whirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Winter'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the chilly dead of winter. <His/Her> eyes are pools of silver-sheened ebon reminiscent of death. White drifts of snow interspersed with light swirls of snowflakes occasionally swirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

: <h4>Released February 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>q_|-</nowiki>        Integument
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Muscle'''
|Through <pendant color> haze, you see <character> encompassed by a shroud that reflects <his/her> underlying muscles and connective tissue. <His/Her> eyes are pools of whitish yellow reminiscent of fatty tissue. The various muscles, ligaments, and tendons tighten and loosen, shifting to mimic any of <his/her> movements, and suspended over where <his/her> forehead should be are mystical runes glowing with power.
| rowspan="3" | ...encompassing <his/her> visage in an organic shroud of connective tissues and sinew.
|-
| role="rowheader" scope="row" | '''Organs'''
| Through <pendant color> haze, you see <character> encompassed by a shroud that reflects <his/her> underlying internal organs. <His/Her> eyes are pools of reddish brown reminiscent of a healthy liver. The heart beats with consistent regularity, while the other organs occasionally pulse or spasm in an odd show of life, and suspended over where his neck should be are mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Flesh'''
| Through <pendant color> haze, you see <character> encompassed by a shroud that reflects patches of his skin as partially atrophied. <His/Her> eyes are pools of whitish grey reminiscent of dead flesh. Bits of <his/her> epidermis visibly disintegrate on occasion, crumbling away to reveal the underlying layers of dermis and hypodermis, before regenerating into fresh, whole areas of veniom skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>~*=*~**</nowiki>        Wild Weather
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Blizzard'''
|Through <pendant color> haze, you see <character> draped in a shroud of a swiftly swirling blizzard. Her/His eyes are pools of pale whitish blue reminiscent of the onset of a cold chill. Every few seconds, the blizzard reverses directions, slowing just long enough to send hordes of snowflakes dancing to and fro across his/her <skin>, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...draping him/her in an erratic shroud of wild zephyrs.
|-
| role="rowheader" scope="row" | '''Ice Storm'''
|Through <pendant color> haze, you see <character> draped in a shroud of a severely raging ice storm. Her/His eyes are pools of tempestuous silver reminiscent of freezing rain. Every so often, the ice storm reverses direction, sending a spray of ice needles and hailstones across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Hurricane'''
|Through <pendant color> haze, you see <character> draped in a shroud of a rapidly rotating hurricane. Her/His eyes are pools of marbled white reminiscent of a whirlpool-like cloud cover over the eye the storm. With alarming regularity, sprays of pelting rain followed by a rush of blue-green water flow across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Thunderstorm'''
|Through <pendant color> haze, you see <character> draped in a shroud of dark, angry thunderheads. Her/His eyes are pools of white-rimmed deep grey reminiscent of a stormy sky-laden shelf cloud. With alarming regularity, flashes of blindingly bright lightning streak across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
|}

: <h4>Released June 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>^+</nowiki>        Emotions
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Happiness'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the bright yellow hue of happiness. His/Her eyes are pools of prismatic color that occasionally refracts rainbow hues. Glistening, iridescent light shimmers across his/her <skin>, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...swathing him/her in a heavy shroud of emotional vibrancy.
|-
| role="rowheader" scope="row" | '''Rage'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the of the dark red hue of rage. His/Her eyes are pools of black speared with crimson veins that flash in and out of visibility. Bursts of electrical energy angrily and visibly spark around him/her, the shower of light disappearing into his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Tranquility'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the pale blue hue of tranquility. His/Her eyes are pools of pastel ringed in a soft ivory white. Small, nearly translucent concentric circles of light occasionally spread outward across his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Sorrow'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the deep violet-black hue of deep sorrow. His/Her eyes are pools of dark clouds suffused with silvery tears. Ebon hues fold across one another, creating dark voids that collapse in on themselves, as they shift across his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>MWM</nowiki>        Metamorphosis
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Caterpillar'''
| Through a <pendant color> haze, you see <character name> cloaked in a leaf green shroud woven in multitudinous horizontal-spanning segments. <His/Her> eyes are pools of bright orange and yellow and shaped to lend <him/her> a vaguely bug-like appearance. Countless tiny caterpillars crawl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...cloaking him/her in a gossamer shroud of constant transformation.
|-
| role="rowheader" scope="row" | '''Butterfly'''
|Through a <pendant color> haze, you see <character name> cloaked in a rainbow-hued shroud sprouting vivid long-tailed butterfly wings. <His/Her> eyes are pools of shiny black, the compound eye-shaped orbs distinctly insect in appearance. In a spray of vibrant color, a plethora of butterflies wing to and fro, swirling and sweeping in ever-changing patterns across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Cocoon'''
|Through a <pendant color> haze, you see <character name> cloaked in a dull brown shroud fitted around <him/her> like a cocoon. <His/Her> eyes are pools of gradually modulating color that shifts from dark hues to light and back again. Slow transformations in hue and texture spreads across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Chrysallis'''
|Through <pendant color> haze, you see <character name> cloaked in a dull brown shroud split open along one side to reveal a wealth of color that slowly streams outward before dissipating into the air. <His/Her> eyes are pools of crystalline-like specks of color that constantly change. As <His/Her> flesh transforms in hue in hue and texture, colorful patterns suffuse and sink across <His/Her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

: <h4>Released August 2020</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>_-~*</nowiki>        Ascendant
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Magma'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of magma-hemmed murk. <His/Her> eyes are pools of black reminiscent of lightless cavern depths deep underground. A wave of movement, like the air itself is visibly vibrating, occasionally ripples across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...cloaking <him/her> in an ethereal shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Ocean'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of churning, deep blue ocean. <His/Her> eyes are pools of vibrant aquamarine hue reminiscent of undersea jewel tones. A wash of murky water occasionally splashes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Sand'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of golden sand. <His/Her> eyes are pools of melded browns, yellows, and oranges, the combination reminiscent of a range of earthen tones. Tiny pebbles and granules of green sand occasionally sweep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Horizon'''
|Through a <pendant color> haze, you see <character> trussed in a trailing shroud of a constantly shifting horizon. <His/Her> eyes are pools of white-on-blue reminiscent of puffy clouds drifting across the sky. Rays of bright sunlight, then moonlight, occasionally filter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Stars'''
|Through a <pendant color> haze, you see <character> trussed in a trailing shroud of twinkling stars. <His/Her> eyes are pools of pure light reminiscent of the bright light of the sun. A bleak darkness, like the center of a void, occasionally steals across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>*zz*</nowiki>        Electricity
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Violet'''
|Through an <pendant color> haze you see <character> wrapped in a shroud of sparking vivid violet radiance. His eyes are pools of gleaming incandescence. Tendrils of purple electricity skitter across his pale tan sand-hued skin, which is chiseled with mystical runes glowing with power, before careening outward into almost blindingly bright bursts of sparks.
| rowspan="6" | ...cloaking <him/her> in a shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Golden'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of crackling golden radiance. His eyes are pools of gleaming incandescence. Tendrils of bright white electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before splintering off into jagged spears of flame-laced lightning.
|-
| role="rowheader" scope="row" | '''Viridian'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of flickering vibrant viridian radiance. His eyes are pools of gleaming incandescence. Tendrils of emerald green electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before hurtling outward into concentrated explosions of sizzling sparks.
|-
| role="rowheader" scope="row" | '''Scarlet'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of crackling scarlet radiance. His eyes are pools of gleaming incandescence. Tendrils of red electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before shooting outward into an explosion of forked lightning bolts.
|-
| role="rowheader" scope="row" | '''Ebon'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of flaring ebon radiance. His eyes are pools of black that leak an opalescent incandescence around the edges. Tendrils of stygian electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before darting outward in twisted spires of shadow-chased electrical energy.
|-
| role="rowheader" scope="row" | '''Blue'''
| Through a <pendant color> haze, you see <character name> wrapped in a shroud of crackling bright blue radiance. <His/Her> pools of gleaming incandescence. Tendrils of azure electricity skitter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power, before bursting outward into multi-pronged streaks of silvered lightning.
|-
|}

: <h4>Released February 2021</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>[8]</nowiki>        Jewel
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Diamonds'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black diamonds. <His/Her> eyes are perfectly matched malachite stones inset with white-point diamond irises. Thin, vivid green rivulets of malachite bleed down from <his/her> eyes to spread out like parasitic veins across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="6" | ...cloaking him/her in an ethereal shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Opals'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black opals. <His/Her> eyes are perfectly matched sapphires inset with cloud opal irises. Thin, deep blue rivulets of sapphire drip down from <his/her> eyes to spread out like watercolor veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Pearls'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black pearls. <His/Her> eyes are mismatched despanals inset with iridescent pearl irises. Thin, rich-hued scarlet rivulets of despanal seep down from <his/her> eyes to spread out like discolored veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Jaspers'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black jaspers. <His/Her> eyes are roughly carved moonstones inset with yellow jasper irises. Thin, silvery rivulets of moonstone stream down from <his/her> eyes to spread out like misty opaline veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Dreamstones'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black dreamstones. <His/Her> eyes are two large, flawless sunstones inset with dark grey dreamstone irises. Thin, yellow-haloed rivulets of sunstone trail down from <his/her> eyes to spread out like fire-riddled veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Deathstones'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black deathstones. <His/Her> eyes are a pair of jagged smoldereyes inset with black deathstone irises. Thin, smoky violet rivulets of smoldereye cascade down from <his/her> eyes to spread out like darkly glimmering veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
|}
</li></ul></div><section end=mystic />

{{top}}

===Legendary===
Legendary bloodrunes are the final tier of bloodrunes and are limited to a release of '''1''' per instance. Similar to [[Bloodrune#Arcane|arcane]] and [[Bloodrune#Mystic|mystic]] tiers, they change the glamour projected by a moonshard pendant. Additionally, they work with corresponding cloaks that are released during the same run but in alternate methods, such as the [[Duskruin Treasure Trove|Treasure Trove]].

* '''Bloodrune Holder'''
: {{addmetext}}

* '''MoonShard Pendant'''
<section begin=legendary /><div><ul><li style="display: block;">
<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! Symbol
! Meaning
! Release
! Cloak
! Appearance
|-
| role="rowheader" | {{big|'''<nowiki>~OO~</nowiki>'''}}
| '''Minotaur'''
| August 2016
| [[Legendary Bloodrune Cloak|Rough Leather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a minotaur. Two thick horns protrude from the top of <his/her> head and taper to extreme points. <His|Her> menacing golden eyes appear to flash intermittently but exude a great sense of intelligence. A thick gold ring dangles from <his|her> nose, and a slightly muffled snort-grunt is occasionally heard coming from <his|her> direction.
|-
| role="rowheader" | {{big|'''<nowiki>^O==</nowiki>'''}}
| '''Black Yeti'''
| December 2016
| [[Legendary Bloodrune Cloak|Shaggy Fur Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a yeti. Barely recognizable, <he|she> is covered in long, gristly hair tinged from deep scarlet to stark black. Clumps of dirt imbedded with twigs and leaves cover <his|her> domed head, and a single bushy eyebrow creates a thick ledge of fur over <his|her> tiny black eyes. Massive ivory teeth stained with traces of crimson protrude from <his|her> darkened leathery lips.
|-
| role="rowheader" | {{big|'''<nowiki>==O^</nowiki>'''}}
| '''White Yeti'''
| December 2016
| [[Legendary Bloodrune Cloak|Shaggy Fur Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a yeti. Barely recognizable, <he|she> is covered in long, gristly hair tinged from pale grey to stark white. Clumps of dirt imbedded with twigs and leaves cover <his|her> domed head, and a single bushy eyebrow creates a thick ledge of fur over <his|her> tiny black eyes. Massive ivory teeth stained with traces of crimson protrude from <his|her> darkened leathery lips.
|-
| role="rowheader" | {{big|'''<nowiki>|O|</nowiki>'''}}
| '''Cave Troll'''
| April 2017
| [[Legendary Bloodrune Cloak|Trollhide Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a cave troll. Towering above most giantmen, <his|her> hulking stature alone is intimidating. Wide splits in <his|her> grey leathery skin sprout tufts of coarse dark hair, and rows of oversized fangs protrude from <his|her> mouth, forcing <his|her> lips into a permanent menacing grin. An overwhelming stench of decay lingers around <him|her>.
|-
| role="rowheader" | {{big|'''<nowiki>|X|</nowiki>'''}}
| '''Troll King'''
| April 2017
| [[Legendary Bloodrune Cloak|Trollhide Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a troll king. With arms like enormous tree branches and claws sharp as razors, <he|she> appears quite a formidable opponent. Grotesque clusters of scab-ridden warts along <his|her> dark green leathery skin are slightly overshadowed by bits of bloodied flesh that dangle from <his|her> oversized incisors. While <his|her> size and appearance is quite intimidating, a vacant look exists in <his|her> eyes.
|-
| role="rowheader" | {{big|'''<nowiki>~\\O//~</nowiki>'''}}
| '''Storm Griffin'''
| February 2018
| [[Legendary Bloodrune Cloak|Feather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a storm griffin. In contradiction, large powder-blue feathers gracefully frame <his|her> face, but <his|her> aquiline nose presents validity to <his|her> ability to slice through the thickest of flesh with ease. <His|Her> muscular and powerful hindquarters are only slightly less intimidating than the massive claws that could assassinate any opponent in one brutal swipe. An elongated, sandy blonde feline tail with a tuft of a darker-hued fur swats tirelessly at the air around <him|her>, and <he|she> seems to almost hover a few inches off the ground, propelled by <his|her> daunting, but magnificent, wings.
|-
| role="rowheader" | {{big|'''<nowiki>~\\X//~</nowiki>'''}}
| '''War Griffin'''
| February 2018
| [[Legendary Bloodrune Cloak|Feather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a war griffin. In contradiction, large golden feathers gracefully frame <his|her> face, but <his|her> aquiline nose presents validity to <his|her> ability to slice through the thickest of flesh with ease. <His|Her> muscular and powerful hindquarters are only slightly less intimidating than the massive claws that could assassinate any opponent in one brutal swipe. An elongated, white feline tail with a tuft of a darker-hued fur swats tirelessly at the air around <him|her>, and <he|she> seems to almost hover a few inches off the ground, propelled by <his|her> daunting, but magnificent, wings.
|-
| role="rowheader" | {{big|'''<nowiki>\\~oOo~//</nowiki>'''}}
| '''Vesperti'''
| June 2018
| [[Legendary Bloodrune Cloak|Tenebrous Cloak]]
| align=left | Through a <pendant color> haze, <your name>'s features appear transformed into those of a vesperti. Willowy thin and tall, <his|her> lithe form is covered in coarse black fur. Intense grey eyes stare out from beneath a mane of tousled hair, while the fine features of <his|her> face resemble an elven ancestry. A veined membrane of skin extends from <his|her> ankles up to his wrists, their edges scalloped like those of a bat's wings. Tapered digits bearing glossy black claws cap the wings at taloned feet and hands.
|-
| role="rowheader" | {{big|'''<nowiki>`x-^-x`</nowiki>'''}}
| '''Abyran'ra'''
| August 2019
| [[Legendary Bloodrune Cloak|Black Snakeskin Cloak]]
| align=left | Through a/n <pendant color> haze, <character name>'s features appear transformed into those of an abyran'ra. Thirteen <hair color> serpents ring <his|her> head, bestowing <her|him> a full crown of the twisting vipers as they writhe back and forth in an undulating, hypnotic fashion. <His|Her> pale, lidless eyes are devoid of pupils -- merely rippling with faint hints of <eye color> every few moments. Twin pairs of fangs peek out from beneath <his|her> thin lips, and the smoothness of <his|her> skin fades away into sleek scales below <his|her> abdomen, <his|her> lower body tapering into a massive, sinuous tail like that of a snake.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>.-'', _( )____</nowiki>'''}}
| '''Giant Rat'''
| August 2020
| [[Legendary Bloodrune Cloak|Scraggly Rat Fur Cloak]]
| align=left | Through an <pendant color> haze, <character> features appear to be transformed into those of a giant rat. Dark, scruffy amber fur dominates his pot-bellied form, while beady crystal green eyes gaze over a pointed snout with two very large, white front teeth. Two naked pink ears, the right of which is missing a large chunk, twitch as he listens to everything around him. A long, seemingly bald tail stretches out behind him.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>==||==</nowiki>'''}}
| '''Colossus'''
| August 2021
| [[Legendary Bloodrune Cloak|Granite-hued oilcloth cloak]]
| align=left | Towering over her surroundings, Thandiwe has a stony countenance with an impassive expression and an unyielding hazel gaze. Chiseled features with chips and pits due to aging and erosion make it impossible to determine her race, while skins of moss in shades of rust red provide the hint of natural hair. Her hands stand out the most, the large digits at once smooth from exposure to weather and yet cracked with age, hinting at a hidden strength beneath a calm exterior.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>./*~*\.</nowiki>'''}}
| '''Snow Spectre'''
| February 2022
| [[Legendary Bloodrune Cloak|Frosty gossamer shroud]]
| align=left | Haunting winter grey eyes gaze with a disturbing vacancy from Thandiwe's eerie visage, which morphs between expressions of abject horror and fractured sanity from one moment to the next. His waif-like limbs float in a current of frosty air that spirals around him, transforming his appearance between states of flickering, semi-translucency to near blinding white and icy solidity. A mane of coppery red hair frames his gaunt head, the scraggly tendrils falling away from his gaunt face in erratic lengths.
|-
|}
</li></ul></div><section end=legendary />

{{top}}

==See Also==
* [[/saved posts|Saved posts]]
* [[MoonShard pendant]]
* [[Legendary Bloodrune Cloak]]
* [[Blood-infused crystal]]
* [[Bloodrune Holder]]
* [[Duskruin Arena]]
</td><td>
{{iteminfo
|type=Fluff 
|itemclass=Miscellaneous 
|itemtype=Bloodrune 
|itemtype2=Totem
|itemtype3=Stone
|itemtype4=Chisel
|alter=No 
|ld=No 
|feature= 
|customize= 
|custom= 
|origmerch= 
|releasevenue=Duskruin 
|releaseyear=2016 
|questitem= 
|tiered= 
|tiersnumber= 
|unlock= 
|legendary= 
|demeanor= 
|loresong= 
|corrscript=MoonShard pendant 
|corrscript2=Bloodrune Holder
|attune= 
|attunement= 
|affinity= 
|spell= 
|enhancive= 
|swap= 
|add= 
|restrictions=Bloodrunes must be carved from stones. Only useful with [[MoonShard pendant|MoonShard Pendant]]s and [[Bloodrune Holder]]s. 
}}
{{itemverb
|verb=CARVE 
|verb2=LOOK
|verb3=READ
|verb4=TURN
}}
</td></tr></table>
[[Category:Duskruin collectible items]]

Bloodrune

2026-03-23T19:40:56Z

HORIBU1: add div sections to bloodrune sections

<table><tr valign="top"><td>
A '''[[#Bloodrune|bloodrune]]''' can be used in conjunction with a [[MoonShard pendant]] in order alter the appearance of its glamour or with a [[Bloodrune Holder]] to create an illusion. Using [[#Flat Etched Stone|stones]] found in the sewers and a [[#Chisel|chisel]], they can be created by carving an [[#Ur-Barath Totem|ur-barath totem]]. When a bloodrune is in use, it adds an additional line to the pendant's {{boldmono|LOOK}}/{{boldmono|SHOW}} description and alters the glamour that the pendant projects based on its tier.

Bloodrunes can be {{boldmono|TURNed}} to prevent them from being sold to the archaeologist NPC. {{boldmono|MARK}} does not work with this item.
{{TOC limit|2}}
{{itemtiermulti 
|item=Ur-Barath Totem 
|itemsummary= 
An '''ur-barath totem''' serves as the starting form of a [[#Bloodrune|bloodrune]]. When {{boldmono|CARVEd}} with a [[#Chisel|chisel]], the ur-barath totem is transformed into a bloodrune.
|analyze= 
You analyze your ur-barath totem and sense that the item is largely free from merchant alteration restrictions.

The creator has also provided the following information:
This totem is not suitable for alterations or fodder. It appears as if it might be suitable for carving with a chisel. You should find a jagged stone which can be found within the Duskruin tunnels.

You get no sense of whether or not the totem may be further lightened.
|inspect= 
|show= 
|affinity= 
|itemverbtable= 
}}
{{itemtiermulti 
|item=Flat Etched Stone 
|itemsummary= '''Flat etched stones''' are found in the [[Bloodriven Sewers]] of Duskruin. Using a [[#Chisel|chisel]] sold at [[BVShop:The Mar and Scar|The Mar and Scar]], along with an [[#Ur-Barath Totem|ur-barath totem]], you can {{boldmono|READ}} the stone to commit the rune to memory before you {{boldmono|CARVE}} the totem with the chisel.
|analyze= 
This etched stone is of the ''<type>'' tier. To learn more about it, you should ask the dwarven archaeologist around the Underground Temple of Bloodriven Village. Or, you can READ the stone to burn the image to your memory for a short time.

Your etched stone can be purchased by the Archaeologist in Bloodriven Village. Use TURN to mark it as unsellable.
|inspect= 
|affinity= 
|itemverbtable= Yes
}}
{| {{verbtable}} 
|- {{verbtableheader|90}}
! scope="col" style="width:5em;"|Verb
! scope="col" style="width: 45%"|First
! scope="col" style="width: 45%"|Third
|-
! scope="row" role="rowheader"|LOOK
| This smooth stone bears unfamiliar markings along its flat surface. Thin veins of crimson create a web-like pattern across its exterior.
There appears to be something written on it.
| N/A
|-
! scope="row" role="rowheader"|READ
| Carved into the top of the stone is the "''<rune>''" rune. While unfamiliar, you sense that reading it again will set its design to memory and cause the stone to crumble.

{{blue|If you are ready to study this stone, READ the stone again within 15 seconds.<br>
[NOTE: You must have a totem and a chisel in order to carve.]}}
| N/A
|-
! scope="row" role="rowheader" rowspan="3" |TURN
| You flip a flat etched stone over in your hand and scratch the stone with your fingernail, creating a small "X" along its surface.
| {{addmetext}}
|-
| You flip a flat etched stone over in your hand and scratch the stone with your fingernail, scraping off a small "X" along its surface.
| {{addmetext}}
|-
| colspan="2" style="text-align:center"|This toggles if the stone can be sold to the archaelogist in the Arena for bloodscrip.
|}
{{itemtiermulti 
|item=Chisel 
|itemsummary= A '''primitive metal chisel''' sold at [[BVShop:The Mar and Scar|The Mar and Scar]] can be used to carve a rune into an [[#Ur-Barath Totem|ur-barath totem]]. The rune's appearance must be taken from a [[#Flat Etched Stone|flat etched stone]] found in the [[Bloodriven Sewers]].
|analyze= 
This single-use chisel can be used to carve ur-barath totems found during Duskruin Dig. <CARVE TOTEM WITH CHISEL> You should look for stones in Duskruin's tunnels. These items cannot be altered.
|inspect= 
|affinity= 
|itemverbtable=Yes 
}}
{| {{verbtable}} 
|- {{verbtableheader|90}}
! scope="col" style="width:5em;"|Verb
! scope="col" style="width: 45%"|First
! scope="col" style="width: 45%"|Third
|-
! scope="row" role="rowheader"|CARVE {TOTEM} WITH {CHISEL}
| {{addmetext}}
| {{addmetext}}
|}
{{itemtiermulti 
|item= Bloodrune
|itemsummary= '''Bloodrunes''' are created when a [[#Ur-Barath Totem|totem]] has been carved with a [[#Chisel|chisel]] after the [[#Flat Etched Stone|stone]] has been read and crumbles.

There are multiple tiers: [[{{PAGENAME}}#Classic|Classic]], [[{{PAGENAME}}#Divine|Divine]], [[{{PAGENAME}}#Arcane|Arcane]], [[{{PAGENAME}}#Mystic|Mystic]], and [[{{PAGENAME}}#Legendary|Legendary]]. Verb usage for the bloodrune is similar to its flat etched stone version.
|analyze= The creator has also provided the following information:

This moss-covered bloodrune is of the ''<type>'' tier. Using PUSH (pendant) while holding a ''ragged moss-covered'' bloodrune you can add it to the pendant. Likewise, you can PULL (pendant) to remove a bloodrune that has been added. Speak to the dwarven archaeologist around the Underground Temple of Bloodriven Village for more information.

Your moss-covered bloodrune can be purchased by the Archaeologist in Bloodriven Village. Use TURN to mark it as unsellable.
|inspect= 
|affinity= 
|itemverbtable= 
}}
==Additional Information==
===Classic===
Classic bloodrunes are the most common tier available. When added, the bloodrune adds an additional line to the glamour illusion of the pendant.

* '''Bloodrune Holder'''
: ''Effect: (He/She) gives off a(n) <rune> semblance.''

* '''MoonShard Pendant'''
: ''Effect: A(n) <rune> look washes over (his/her) face.''
<section begin=classic /><div><ul>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2016
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>^v^</nowiki>}}'''
| bloodthirsty
|-
|role="rowheader" | '''{{big|<nowiki>OXO</nowiki>}}'''
| enraged
|-
|role="rowheader" | '''{{big|<nowiki>| | |</nowiki>}}'''
| savage
|-
|role="rowheader" | '''{{big|<nowiki>)|(</nowiki>}}'''
| tempestuous
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released April 2017
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>v-o-v</nowiki>}}'''
| ferocious
|-
|role="rowheader" | '''{{big|<nowiki>X</nowiki>}}'''
| fierce
|-
|role="rowheader" | '''{{big|<nowiki>^w^</nowiki>}}'''
| menacing
|-
|role="rowheader" | '''{{big|<nowiki>)*(</nowiki>}}'''
| persuasive
|-
|role="rowheader" | '''{{big|<nowiki>- - -</nowiki>}}'''
| serene
|-
|role="rowheader" | '''{{big|<nowiki>|OO|</nowiki>}}'''
| solemn
|-
|role="rowheader" | '''{{big|<nowiki>/ / /</nowiki>}}'''
| troubled
|-
|role="rowheader" | '''{{big|<nowiki>v--v</nowiki>}}'''
| vicious
|-
|role="rowheader" | '''{{big|<nowiki>OoO</nowiki>}}'''
| wild
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2017
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>/o\</nowiki>}}'''
| melancholy
|-
|role="rowheader" | '''{{big|<nowiki>| oo |</nowiki>}}'''
| tormented
|-
|role="rowheader" | '''{{big|<nowiki>O/\O</nowiki>}}'''
| vengeful
|-
|}
<br>
{| class="wikitable alternating" style="text-align:center;"
|+ Released June 2018
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>*Sss</nowiki>}}'''
| enraptured
|-
|role="rowheader" | '''{{big|<nowiki>!i!-</nowiki>}}'''
| imperious
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2020
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>/--/</nowiki>}}'''
| devious
|-
|role="rowheader" | '''{{big|<nowiki>~\-</nowiki>}}'''
| pitiless
|-
|role="rowheader" | '''{{big|<nowiki>~\o</nowiki>}}'''
| pitiful
|-
|role="rowheader" | '''{{big|<nowiki>Vv|</nowiki>}}'''
| sadistic
|-
|}

{| class="wikitable alternating" style="text-align:center;"
|+ Released February 2022
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>O|O</nowiki>}}'''
| contemplative
|-
|} </li>
</ul></div><section end=classic />
{{top}}

===Divine===
Divine bloodrunes are the second most common tier able to be found in the sewers. Similar to the [[Bloodrune#Classic | classic]] tier, they add a line to the MoonShard pendant's original glamour effect, and align with specific deities. A [[Blood-infused crystal#Divine | blood-infused crystal]] can be used to slightly alter the rune on divine bloodrunes, changing the moonshard pendant's base glamour.

* '''Bloodrune Holder'''
: ''Effect: Miniature <item> spiral outward from (him/her) before fading away.''

* '''MoonShard Pendant'''
: ''Effect: Interspersed within the dim aura are miniature <item> that float around (him/her).''
<section begin=divine />
<div><ul>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Liabo
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>^~^~^</nowiki>}}'''
|[[Charl]]
| jade tridents
|-
| role="rowheader" | '''{{big|<nowiki>o|`</nowiki>}}'''
| [[Cholen]]
| music notes
|-
| role="rowheader" | '''{{big|<nowiki>/--\</nowiki>}}'''
| [[Eonak]]
| iron anvils
|-
| role="rowheader" | '''{{big|<nowiki>\__/</nowiki>}}'''
| [[Imaera]]
| sheafs of grain
|-
| role="rowheader" | '''{{big|<nowiki>O</nowiki>}}'''
| [[Jastev]]
| crystal balls
|-
| role="rowheader" | '''{{big|<nowiki>/v\</nowiki>}}'''
| [[Jaston]]
| bird feathers
|-
| role="rowheader" | '''{{big|<nowiki>---O</nowiki>}}'''
| [[Kai]]
| clenched fists
|-
| role="rowheader" | '''{{big|<nowiki>O-O-O</nowiki>}}'''
| [[Koar]]
| golden crowns
|-
| role="rowheader" | '''{{big|<nowiki>_|_|_</nowiki>}}'''
| [[Kuon]]
| golden leaves
|-
| role="rowheader" | '''{{big|<nowiki>\ \</nowiki>}}'''
| [[Laethe]]
| black rose petals
|-
| role="rowheader" | '''{{big|<nowiki>XX</nowiki>}}'''
| [[Leya]]
| ivory-hilted daggers
|-
| role="rowheader" | '''{{big|<nowiki>|-|-|-|</nowiki>}}'''
| [[Lorminstra]]
| golden keys
|-
| role="rowheader" style="white-space: nowrap;"| '''{{big|<nowiki>~-o-o-~</nowiki>}}'''
| [[Lumnis]]
| tomes
|-
| role="rowheader" | '''{{big|<nowiki>~~~~</nowiki>}}'''
| [[Niima]]
| silver dolphins
|-
| role="rowheader" | '''{{big|<nowiki>|^|</nowiki>}}'''
| [[Oleani]]
| hearts
|-
| role="rowheader" | '''{{big|<nowiki>|*|</nowiki>}}'''
| [[Phoen]]
| brilliant sunbursts
|-
| role="rowheader" | '''{{big|<nowiki>* * *</nowiki>}}'''
| [[Ronan]]
| shimmering stars
|-
| role="rowheader" | '''{{big|<nowiki>*|o</nowiki>}}'''
| [[Tilamaire]]
| yellow treble clefs
|-
| role="rowheader" | '''{{big|<nowiki>|^*|</nowiki>}}'''
| [[Tonis]]
| pegasi
|-
| role="rowheader" | '''{{big|<nowiki>/ /</nowiki>}}'''
| [[Voaris]]
| yellow rose petals
|-
| role="rowheader" | '''{{big|<nowiki>)X(</nowiki>}}'''
| [[Voln]]
| white shields
|-
|}
</li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Lornon
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>O--O</nowiki>}}'''
| [[Amasalen]]
| two-headed serpents
|-
| role="rowheader" | '''{{big|<nowiki>^--^</nowiki>}}'''
| [[Andelas]]
| black cats
|-
| role="rowheader" | '''{{big|<nowiki>)O(</nowiki>}}'''
| [[Eorgina]]
| red flames
|-
| role="rowheader" | '''{{big|<nowiki>(-)(-)</nowiki>}}'''
| [[Fash'lo'nae]]
| slit-pupiled eyes
|-
| role="rowheader" | '''{{big|<nowiki>s-S</nowiki>}}'''
| [[Ghezresh]]|| sinuous eels
|-
| role="rowheader" | '''{{big|<nowiki>((O))</nowiki>}}'''
| [[Ivas]]
| wisps of green
|-
| role="rowheader" | '''{{big|<nowiki>~S~</nowiki>}}'''
| [[Luukos]]
| green serpents
|-
| role="rowheader" | '''{{big|<nowiki>~(o)~</nowiki>}}'''
| [[Marlu]]
| six-tentacled stars
|-
| role="rowheader" | '''{{big|<nowiki>\ X /</nowiki>}}'''
| [[Mularos]]
| rusted shackles
|-
| role="rowheader" | '''{{big|<nowiki>(-o-)</nowiki>}}'''
| [[Onar]]
| white skulls
|-
| role="rowheader" | '''{{big|<nowiki>O||O</nowiki>}}'''
| [[Sheru]]
| jackal heads
|-
| role="rowheader" | '''{{big|<nowiki>---^</nowiki>}}'''
| [[V'tull]]
| black scimitars
|-
|}
<br>
{| class="wikitable alternating" style="text-align:center;"
|+ Neutral
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>**|~~</nowiki>}}'''
|[[Aeia]]
| white lilies
|-
| role="rowheader" | '''{{big|<nowiki>=O=</nowiki>}}'''
| [[Arachne]]
| spiders
|-
| role="rowheader" | '''{{big|<nowiki>~o~</nowiki>}}'''
| [[Gosaena]]
| white feathers
|-
| role="rowheader" | '''{{big|<nowiki>~|-|~</nowiki>}}'''
| [[The Huntress]]
| eight-pointed stars
|-
| role="rowheader" | '''{{big|<nowiki>oOo</nowiki>}}'''
| [[Zelia]]
| grey chariots
|}</li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Other
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>OOO</nowiki>}}'''
| [[Illoke]]
| boulders
|-
| role="rowheader" | '''{{big|<nowiki>.o.</nowiki>}}'''
| [[Khaarne]]
| stones
|-
| role="rowheader" | '''{{big|<nowiki>|=|</nowiki>}}'''
| [[Meyno]]
| slabs of rock
|-
|} </li>
</ul></div>
<section end=divine />
{{top}}

===Arcane===
Arcane bloodrunes are the third tier available, and were initially introduced during the August 2017 Duskruin run. Unlike the [[Bloodrune#classic|classic]] or [[Bloodrune#Divine|divine]], arcane bloodrunes change the entire glamour affect of the MoonShard pendant instead of adding a line at the end of it. [[Blood-infused crystal#Arcane | Blood-infused crystals]] can be used to change the location in the pendant's glamour from '''Bloodriven Village''' to the location associated with the rune on the crystal.

* '''Bloodrune Holder'''
: ''Effect: <Rune Type> arcane sigils glow in front of (him/her).''

* '''MoonShard Pendant:'''
<section begin=arcane /><div>
: <h4>Released August 2017</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>,,-,'</nowiki>'''}}
| '''Anatomical'''
|align=left| Through a <pendant color> haze, you see an Anatomical Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Murky golden tendrils wrap possessively around <his/her> shadowed figure, which is covered in rapidly healing and unhealing wounds.
| <Thin>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>o|-</nowiki>'''}}
| '''Animation'''
|align=left| Through a <pendant color> haze, you see an Animation Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A sickly green miasma writhes riotously around <his/her> shadowed figure, which is covered in arabesque patterns framed by an unnatural glow.
| <Bold>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>^-z_</nowiki>'''}}
| '''Blood'''
|align=left| Through a <pendant color> haze, you see a Blood Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Blood red mist swirls threateningly around <his/her> shadowed figure, which is covered in jagged scars.
| <Sanguine>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>+ =Y</nowiki>'''}}
| '''Chaos'''
|align=left| Through a <pendant color> haze, you see a Chaos Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Thick black smoke spirals turbulently around <his/her> dark figure, which is covered in stylized lubricious streaks of ebon.
| <Erratic>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>*Oo**%</nowiki>'''}}
| '''Cosmology'''
|align=left| Through a <pendant color> haze, you see a Cosmology Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Streaks of black and golden energy flash violently around <his/her> pale figure, which is covered in veins that glow with white light.
| <Nebulous>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>x_ _X</nowiki>'''}}
| '''Death'''
|align=left| Through a <pendant color> haze, you see a Death Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Unctuous black locusts flit savagely around <his/her> shadowed figure, which is covered in charred-edged stylized characters.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>Q__Q</nowiki>'''}}
| '''Divination'''
|align=left|Through a <pendant color> haze, you see a Divination Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Nebulous golden clouds meander aimlessly around <his/her> shadowed figure, which is covered in a spray of glistening dewdrops.
| <Violet-streaked>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>|o~o|</nowiki>'''}}
| '''Elemental'''
|align=left| Through a <pendant color> haze, you see an Elemental Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Lightning-streaked violet gloom twists haphazardly around <his/her> dark figure, which is covered in constantly sparking lines of electricity.
| <Flashing>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>;~-- ~~</nowiki>'''}}
| '''Energy'''
|align=left|Through a <pendant color> haze, you see an Energy Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Shimmering rainbow light flashes intermittently around <his/her> pale figure, which is covered in powdery white arcane lettering.
| <Pulsating>
|-
| role="rowheader" scope="row" style="white-space: nowrap"| {{big|'''<nowiki>__%=__ </nowiki>'''}}
| '''Extraplanar'''
|align=left| You see an Extraplanar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Sparks of gold infuse the deep grey brume that twirls rapidly around <his/her> pale figure, which is covered in burnt skin and scorch marks.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>:'`||':</nowiki>'''}}
| '''Mental'''
|align=left|Through a <pendant color> haze, you see a Mental Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Soft sky blue fog gently wafts to and fro around <his/her> illuminated figure, which is covered in constantly shifting esoteric runes.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>~~s*</nowiki>'''}}
| '''Spirit'''
|align=left| Through a <pendant color> haze, you see a Spirit Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A cloud of innocuous white smoke winds lazily around his dark figure, which is covered in long, blood-streaked scratches.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>^`\`/-</nowiki>'''}}
| '''Supernatural'''
|align=left| Through a <pendant color> haze, you see a Supernatural Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A darkly shaded film bends loosely around <his/her> dark figure, which is covered in a glaze of misty, elaborately constructed shapes.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>](*)[</nowiki>'''}}
| '''Symbology'''
|align=left| Through a <pendant color> haze, you see a Symbology Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A whirlwind of books and scrolls churns wildly around <his/her> shadowed figure, which is covered in an array of archaic runes.
| <Searing>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>~~/~~</nowiki>'''}}
| '''Temporal'''
|align=left| Through a <pendant color> haze, you see a Temporal Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A veil of visibly distorted air curls closely around <his/her> illuminated figure, which is covered in contorting geometric forms.
|
|-
|}

: <h4>Released February 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" style="white-space: nowrap" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>*^_v*</nowiki>'''}}
| '''Mesmerism'''
|align=left|Through a <pendant color> haze, you see a Mesmerism Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Hypnotically bright sparks of gold and silver dance around <his/her> illuminated figure, which is covered in a glimmering opaline sheen.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>[[]-[]-[]]</nowiki>'''}}
| '''Occlusion'''
|align=left|Through a <pendant color> haze, you see a Occlusion Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Occasionally smeared with darkness, an otherwise nearly translucent barrier continually folds in and out of existence around <his/her> illuminated figure, which is covered in distinctive chalky white sigils.
| <Frost-tinged>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>,~YvY~`</nowiki>'''}}
| '''Ritual'''
|align=left|Through a <pendant color> haze, you see a Ritual Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Unnaturally flickering candlelight flares erratically around <his/her> shadowed figure, which is covered in myriad precise symbols slashed into his skin.
| <Rigid>
|-
|}

: <h4>Released June 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" style="white-space: nowrap" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>-|T|-</nowiki>'''}}
| '''Construct'''
|align=left|Through a silver-flecked light azure haze, you see a Construct Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. An encompassing golden aura sends streamers of flashing light ricocheting around <his/her> illuminated figure, which is covered in patches of skin with a granite-like white alabaster stone apperance.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>|(C0</nowiki>'''}}
| '''Lunar'''
|align=left|Through a <pendant color> haze, you see a Lunar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Fading in and out of sight, pale moonbeams fancifully float to and fro around <his/her> pale figure, which is covered in a wash of silvery white moonlight.
| <Pale silver>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>=0=</nowiki>'''}}
| '''Solar'''
|align=left|Through a radiant golden haze, you see <a/an> Solar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Nearly blindingly billiant, fiery sunrays radiate out from around <his/her> illuminated figure, which is covered in a wash of reddish gold sunlight.
|
|-
|}

: <h4>Released August 2020</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>0*8t</nowiki>'''}}
| '''Augury'''
|align=left|Through a silver-flecked light azure haze, you see <a/an> Augury Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A clustered miasma of faint, ever-changing images hovers around <his/her> illuminated figure, which is covered in a dark, prismatic material.
| <Rippling>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>{[:</nowiki>'''}}
| '''Enchantment'''
|align=left|Through a silver-flecked light azure haze, you see <a/an> Enchantment Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A cloud of elemental energy pulses around <his/her> illuminated figure, which is covered in runic brands interspersed with singe marks.
| <Rippling>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>xO|</nowiki>'''}}
| '''Hexeri'''
|align=left|Through an ethereal white haze, you see <a/an> Hexeri Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Rough-shod charms and talismans hover in mid-air, swinging back and forth around <his/her> illuminated figure, which is covered in scarlet-leaking black veins.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>c--</nowiki>'''}}
| '''Metallurgy'''
|align=left|Through an ethereal white haze, you see <a/an> Metallurgy Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Tiny, razor-thin scraps of metal flit around his illuminated figure, which is covered in a medley of shifting, metallic-inked tattoos.
|
|-
|}
</div><section end=arcane />

{{top}}

===Mystic===
Mystic bloodrunes are the final tier of more widely available bloodrunes. Similar to [[Bloodrune#Arcane | arcane]] bloodrunes, they were released in August 2017 and change the entire glamour effect of the MoonShard pendant. However, mystic bloodrunes have 4-5 versions that shift when worn with a Pendant. When used in a Bloodrune Holder, it creates an illusion which is custom to each bloodrune - ''Effect: Mystical energies wash over him, [custom for each Mystic bloodrune].''

<section begin=mystic /><div>
: <h4>Released August 2017</h4>
<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>8~~8</nowiki>       Continuance
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Afternoon Sky'''
|Through a <pendant color> haze, you see <character> ensconced in a shroud of pure sunlight. <His/Her> eyes are pools of deep blue reminiscent of an afternoon sky. Misty clouds of white occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...ensconcing <him/her> in a steady shroud of calm.
|-
| role="rowheader" scope="row" | '''Sunset'''
|Through a <pendant color> haze, you see <character> ensconced in a shroud of sunset. <His/Her> eyes are pools of vibrantly streaked hues reminiscent of an impending twilight. A shower of moonbeams occasionally flows across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Moonlight'''
|Through a <pendant color> haze, you see <character name> ensconced in a shroud of a dark night sky. <His/Her> eyes are pools of glowing silvery white reminiscent of moonlight. A shower of stars occasionally shoots across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Midnight'''
|Through a <pendant color> haze, you see <character name> ensconced in a shroud of midnight's black. <His/her> eyes are pools of pitch reminiscent of a starless night. Tendrils of darkness occasionally slither across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>*Oo**</nowiki>        Cosmos
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Lornon'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of ice-fringed dark moonlight. <His/Her> eyes are pools of swirling grey reminiscent of Lornon's surface. A sickly blood red hue occasionally washes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...draping <him/her> in a nebulous shroud tinged with cosmic dust.
|-
| role="rowheader" scope="row" | '''Makiri'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of darkness. <His/Her> eyes are pools of pale golden light reminiscent of starlight. Shifting constellations occasionally ebb and flow across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Liabo'''
|Through a <pendant color> haze, you see <character> swathed in a shroud of brilliant silvery white moonlight. <His/Her> eyes are pools of pure ivory reminiscent of Liabo's surface. A pale golden glow occasionally washes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Tilaok'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of fiery moonlight. <His/Her> eyes are pools of reddish-orange reminiscent of Tilaok's surface. A silvery white wash of light occasionally dances across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Star Field'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of a swirling star field. <her/His> eyes are pools of circularly graduated star-shot color reminiscent of nebulae. Asteroids and resplendent galaxy clusters occasionally twirl across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>_-_-</nowiki>        Cycle of Age
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Child'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that brings out <his/her> child-like appearance. <His/her> eyes are pools of blindingly brilliant light reminiscent of a firestorm. A velvety texture and natural glow infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...cocooning <him/her> in a cyclical shroud that ages and rejuvenates <his/her> countenance.
|-
| role="rowheader" scope="row" | '''Youth'''
| Through a radiant golden haze, you see <character> cocooned in a shroud that highlights <his/her> youthful appearance. <His/her> eyes are pools of blazing light reminiscent of a strongly burning flame. A satiny smooth, supple texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Middle-Aged'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that highlights <his/her> middle-aged appearance. <His/her> eyes are pools of bright light reminiscent of a steadily burning flame. A grainy, pebbled texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Ancient'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that highlights <his/her> ancient and stooped appearance. <His/Her> eyes are pools of dim light reminiscent of a weakly flickering flame. A wrinkled, withered texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Death'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that brings out <his/her> cadaver-like appearance. <His/Her> eyes are pools of matte black, reminiscent of a void. A disintegrating, mushy texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>||o~o||</nowiki>        Elements
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Water'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of vivid blue water. <His/Her> eyes are pools of sparkling icy white reminiscent of icicles reflecting light. White-crested sea green waves occasionally crash across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...surrounding him/her in an elemental shroud of swirling ethereal lights.
|-
| role="rowheader" scope="row" | '''Earth'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of cracked, stone earth. <His/her> eyes are pools of dark brown reminiscent of muddy flats. Flows of magma gradually solidifying into black formations occasionally creep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Fire'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of brilliant orange-red fire. <His/her> eyes are pools of blazing white reminiscent of heated metal. Bright blue flames occasionally flare across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Air'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of colorful flows of air. <His/her> eyes are pools of swirling, flashing light reminiscent of a violent maelstrom. Aurora-like swaths of shimmering air occasionally sweep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>``\`/</nowiki>        Nature
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Mountains'''
|Through a <pendant color> haze, you see <character name> enveloped in a shroud of snow-capped mountains. <His/Her> eyes are pools of pure pale blue reminiscent of glacial waters. Stormy grey clouds flashing with lightning occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...enveloping him/her in a light shroud of fluctuating winds.
|-
| role="rowheader" scope="row" | '''Highlands'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of rolling, green highlands. <His/Her> eyes are pools of vibrant variegated colors reminiscent of patches of wildflowers. The thin flow of a babbling brook occasionally streams across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Jungle'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of tropical jungle. <His/her> eyes are pools of deep, dark green reminiscent of verdant wilderness. Tiny, colorful birds and vibrant, glossy bugs occasionally flit and skitter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Desert'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of dusky, arid desert. <His/Her> eyes are pools of hazy deep blue reminiscent of heat rippling across a clear, unbroken horizon. Grains of reddish sand occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Cliffs'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of rocky ocean cliffs. <His/Her> eyes are pools of misty white reminiscent of sea foam. Waves of dark blue water occasionally crash across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>=X=-</nowiki>        Plague
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" | '''Hives'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of bright red hives. <His/her> eyes are pools of red-glazed grey reminiscent of taint and toxins. Dark red spots of scarlet plasma occasionally spurt out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...trussing him/her in a shroud of pestilence and decay.
|-
| role="rowheader" scope="row" | '''Sores'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of festering sores. <His/her> eyes are pools of white-laced black and scarlet reminiscent of infection and malady. Goopy yellowish secretions occasionally seep out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Pustules'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of oozing pustules. <His/Her> eyes are pools of viridian-veined yellow reminiscent of poison and jaundice. A thick, sickly green liquid occasionally oozes out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Scabs'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of variegated scabs. <His/Her> eyes are pools of black-infused blood reminiscent of injury and disease. Sanguine clotted matter occasionally leaks out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Decay'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of decay and rot. <His/her> eyes are pools of white maggots reminiscent of corpses and necrosis. Black coffin flies and grey beetles occasionally squirm out of <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>.|.|.|.</nowiki>        Seasons
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Summer'''
|Through an <pendant color>, you see <character> wrapped in a shroud of the summer season. <His/Her> eyes are pools of black-rimmed gold reminiscent of the sun's scorching heat. Fireflies occasionally flit to and fro, their lights sparking brightly, across across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ... wrapping him/her in an ever-changing shroud of seasonal leaves.
|-
| role="rowheader" scope="row" | '''Spring'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the spring in full bloom. <His/Her> eyes are pools of mossy green reminiscent of new, verdant growth. Scatterings of seeds, followed by a swirl of colorful blossoms, occasionally whirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Autumn'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the season of autumn. <His/Her> eyes are pools of variegated grey reminiscent of decay after the harvest. Handfuls of reddish-orange leaves occasionally whirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Winter'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the chilly dead of winter. <His/Her> eyes are pools of silver-sheened ebon reminiscent of death. White drifts of snow interspersed with light swirls of snowflakes occasionally swirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

: <h4>Released February 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>q_|-</nowiki>        Integument
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Muscle'''
|Through <pendant color> haze, you see <character> encompassed by a shroud that reflects <his/her> underlying muscles and connective tissue. <His/Her> eyes are pools of whitish yellow reminiscent of fatty tissue. The various muscles, ligaments, and tendons tighten and loosen, shifting to mimic any of <his/her> movements, and suspended over where <his/her> forehead should be are mystical runes glowing with power.
| rowspan="3" | ...encompassing <his/her> visage in an organic shroud of connective tissues and sinew.
|-
| role="rowheader" scope="row" | '''Organs'''
| Through <pendant color> haze, you see <character> encompassed by a shroud that reflects <his/her> underlying internal organs. <His/Her> eyes are pools of reddish brown reminiscent of a healthy liver. The heart beats with consistent regularity, while the other organs occasionally pulse or spasm in an odd show of life, and suspended over where his neck should be are mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Flesh'''
| Through <pendant color> haze, you see <character> encompassed by a shroud that reflects patches of his skin as partially atrophied. <His/Her> eyes are pools of whitish grey reminiscent of dead flesh. Bits of <his/her> epidermis visibly disintegrate on occasion, crumbling away to reveal the underlying layers of dermis and hypodermis, before regenerating into fresh, whole areas of veniom skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>~*=*~**</nowiki>        Wild Weather
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Blizzard'''
|Through <pendant color> haze, you see <character> draped in a shroud of a swiftly swirling blizzard. Her/His eyes are pools of pale whitish blue reminiscent of the onset of a cold chill. Every few seconds, the blizzard reverses directions, slowing just long enough to send hordes of snowflakes dancing to and fro across his/her <skin>, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...draping him/her in an erratic shroud of wild zephyrs.
|-
| role="rowheader" scope="row" | '''Ice Storm'''
|Through <pendant color> haze, you see <character> draped in a shroud of a severely raging ice storm. Her/His eyes are pools of tempestuous silver reminiscent of freezing rain. Every so often, the ice storm reverses direction, sending a spray of ice needles and hailstones across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Hurricane'''
|Through <pendant color> haze, you see <character> draped in a shroud of a rapidly rotating hurricane. Her/His eyes are pools of marbled white reminiscent of a whirlpool-like cloud cover over the eye the storm. With alarming regularity, sprays of pelting rain followed by a rush of blue-green water flow across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Thunderstorm'''
|Through <pendant color> haze, you see <character> draped in a shroud of dark, angry thunderheads. Her/His eyes are pools of white-rimmed deep grey reminiscent of a stormy sky-laden shelf cloud. With alarming regularity, flashes of blindingly bright lightning streak across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
|}

: <h4>Released June 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>^+</nowiki>        Emotions
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Happiness'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the bright yellow hue of happiness. His/Her eyes are pools of prismatic color that occasionally refracts rainbow hues. Glistening, iridescent light shimmers across his/her <skin>, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...swathing him/her in a heavy shroud of emotional vibrancy.
|-
| role="rowheader" scope="row" | '''Rage'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the of the dark red hue of rage. His/Her eyes are pools of black speared with crimson veins that flash in and out of visibility. Bursts of electrical energy angrily and visibly spark around him/her, the shower of light disappearing into his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Tranquility'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the pale blue hue of tranquility. His/Her eyes are pools of pastel ringed in a soft ivory white. Small, nearly translucent concentric circles of light occasionally spread outward across his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Sorrow'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the deep violet-black hue of deep sorrow. His/Her eyes are pools of dark clouds suffused with silvery tears. Ebon hues fold across one another, creating dark voids that collapse in on themselves, as they shift across his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>MWM</nowiki>        Metamorphosis
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Caterpillar'''
| Through a <pendant color> haze, you see <character name> cloaked in a leaf green shroud woven in multitudinous horizontal-spanning segments. <His/Her> eyes are pools of bright orange and yellow and shaped to lend <him/her> a vaguely bug-like appearance. Countless tiny caterpillars crawl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...cloaking him/her in a gossamer shroud of constant transformation.
|-
| role="rowheader" scope="row" | '''Butterfly'''
|Through a <pendant color> haze, you see <character name> cloaked in a rainbow-hued shroud sprouting vivid long-tailed butterfly wings. <His/Her> eyes are pools of shiny black, the compound eye-shaped orbs distinctly insect in appearance. In a spray of vibrant color, a plethora of butterflies wing to and fro, swirling and sweeping in ever-changing patterns across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Cocoon'''
|Through a <pendant color> haze, you see <character name> cloaked in a dull brown shroud fitted around <him/her> like a cocoon. <His/Her> eyes are pools of gradually modulating color that shifts from dark hues to light and back again. Slow transformations in hue and texture spreads across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Chrysallis'''
|Through <pendant color> haze, you see <character name> cloaked in a dull brown shroud split open along one side to reveal a wealth of color that slowly streams outward before dissipating into the air. <His/Her> eyes are pools of crystalline-like specks of color that constantly change. As <His/Her> flesh transforms in hue in hue and texture, colorful patterns suffuse and sink across <His/Her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

: <h4>Released August 2020</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>_-~*</nowiki>        Ascendant
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Magma'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of magma-hemmed murk. <His/Her> eyes are pools of black reminiscent of lightless cavern depths deep underground. A wave of movement, like the air itself is visibly vibrating, occasionally ripples across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...cloaking <him/her> in an ethereal shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Ocean'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of churning, deep blue ocean. <His/Her> eyes are pools of vibrant aquamarine hue reminiscent of undersea jewel tones. A wash of murky water occasionally splashes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Sand'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of golden sand. <His/Her> eyes are pools of melded browns, yellows, and oranges, the combination reminiscent of a range of earthen tones. Tiny pebbles and granules of green sand occasionally sweep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Horizon'''
|Through a <pendant color> haze, you see <character> trussed in a trailing shroud of a constantly shifting horizon. <His/Her> eyes are pools of white-on-blue reminiscent of puffy clouds drifting across the sky. Rays of bright sunlight, then moonlight, occasionally filter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Stars'''
|Through a <pendant color> haze, you see <character> trussed in a trailing shroud of twinkling stars. <His/Her> eyes are pools of pure light reminiscent of the bright light of the sun. A bleak darkness, like the center of a void, occasionally steals across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>*zz*</nowiki>        Electricity
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Violet'''
|Through an <pendant color> haze you see <character> wrapped in a shroud of sparking vivid violet radiance. His eyes are pools of gleaming incandescence. Tendrils of purple electricity skitter across his pale tan sand-hued skin, which is chiseled with mystical runes glowing with power, before careening outward into almost blindingly bright bursts of sparks.
| rowspan="6" | ...cloaking <him/her> in a shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Golden'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of crackling golden radiance. His eyes are pools of gleaming incandescence. Tendrils of bright white electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before splintering off into jagged spears of flame-laced lightning.
|-
| role="rowheader" scope="row" | '''Viridian'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of flickering vibrant viridian radiance. His eyes are pools of gleaming incandescence. Tendrils of emerald green electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before hurtling outward into concentrated explosions of sizzling sparks.
|-
| role="rowheader" scope="row" | '''Scarlet'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of crackling scarlet radiance. His eyes are pools of gleaming incandescence. Tendrils of red electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before shooting outward into an explosion of forked lightning bolts.
|-
| role="rowheader" scope="row" | '''Ebon'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of flaring ebon radiance. His eyes are pools of black that leak an opalescent incandescence around the edges. Tendrils of stygian electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before darting outward in twisted spires of shadow-chased electrical energy.
|-
| role="rowheader" scope="row" | '''Blue'''
| Through a <pendant color> haze, you see <character name> wrapped in a shroud of crackling bright blue radiance. <His/Her> pools of gleaming incandescence. Tendrils of azure electricity skitter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power, before bursting outward into multi-pronged streaks of silvered lightning.
|-
|}

: <h4>Released February 2021</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>[8]</nowiki>        Jewel
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Diamonds'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black diamonds. <His/Her> eyes are perfectly matched malachite stones inset with white-point diamond irises. Thin, vivid green rivulets of malachite bleed down from <his/her> eyes to spread out like parasitic veins across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="6" | ...cloaking him/her in an ethereal shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Opals'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black opals. <His/Her> eyes are perfectly matched sapphires inset with cloud opal irises. Thin, deep blue rivulets of sapphire drip down from <his/her> eyes to spread out like watercolor veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Pearls'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black pearls. <His/Her> eyes are mismatched despanals inset with iridescent pearl irises. Thin, rich-hued scarlet rivulets of despanal seep down from <his/her> eyes to spread out like discolored veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Jaspers'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black jaspers. <His/Her> eyes are roughly carved moonstones inset with yellow jasper irises. Thin, silvery rivulets of moonstone stream down from <his/her> eyes to spread out like misty opaline veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Dreamstones'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black dreamstones. <His/Her> eyes are two large, flawless sunstones inset with dark grey dreamstone irises. Thin, yellow-haloed rivulets of sunstone trail down from <his/her> eyes to spread out like fire-riddled veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Deathstones'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black deathstones. <His/Her> eyes are a pair of jagged smoldereyes inset with black deathstone irises. Thin, smoky violet rivulets of smoldereye cascade down from <his/her> eyes to spread out like darkly glimmering veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
|}
</div><section end=mystic />

{{top}}

===Legendary===
Legendary bloodrunes are the final tier of bloodrunes and are limited to a release of '''1''' per instance. Similar to [[Bloodrune#Arcane|arcane]] and [[Bloodrune#Mystic|mystic]] tiers, they change the glamour projected by a moonshard pendant. Additionally, they work with corresponding cloaks that are released during the same run but in alternate methods, such as the [[Duskruin Treasure Trove|Treasure Trove]].

* '''Bloodrune Holder'''
: {{addmetext}}

* '''MoonShard Pendant'''
<section begin=legendary /><div>
<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! Symbol
! Meaning
! Release
! Cloak
! Appearance
|-
| role="rowheader" | {{big|'''<nowiki>~OO~</nowiki>'''}}
| '''Minotaur'''
| August 2016
| [[Legendary Bloodrune Cloak|Rough Leather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a minotaur. Two thick horns protrude from the top of <his/her> head and taper to extreme points. <His|Her> menacing golden eyes appear to flash intermittently but exude a great sense of intelligence. A thick gold ring dangles from <his|her> nose, and a slightly muffled snort-grunt is occasionally heard coming from <his|her> direction.
|-
| role="rowheader" | {{big|'''<nowiki>^O==</nowiki>'''}}
| '''Black Yeti'''
| December 2016
| [[Legendary Bloodrune Cloak|Shaggy Fur Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a yeti. Barely recognizable, <he|she> is covered in long, gristly hair tinged from deep scarlet to stark black. Clumps of dirt imbedded with twigs and leaves cover <his|her> domed head, and a single bushy eyebrow creates a thick ledge of fur over <his|her> tiny black eyes. Massive ivory teeth stained with traces of crimson protrude from <his|her> darkened leathery lips.
|-
| role="rowheader" | {{big|'''<nowiki>==O^</nowiki>'''}}
| '''White Yeti'''
| December 2016
| [[Legendary Bloodrune Cloak|Shaggy Fur Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a yeti. Barely recognizable, <he|she> is covered in long, gristly hair tinged from pale grey to stark white. Clumps of dirt imbedded with twigs and leaves cover <his|her> domed head, and a single bushy eyebrow creates a thick ledge of fur over <his|her> tiny black eyes. Massive ivory teeth stained with traces of crimson protrude from <his|her> darkened leathery lips.
|-
| role="rowheader" | {{big|'''<nowiki>|O|</nowiki>'''}}
| '''Cave Troll'''
| April 2017
| [[Legendary Bloodrune Cloak|Trollhide Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a cave troll. Towering above most giantmen, <his|her> hulking stature alone is intimidating. Wide splits in <his|her> grey leathery skin sprout tufts of coarse dark hair, and rows of oversized fangs protrude from <his|her> mouth, forcing <his|her> lips into a permanent menacing grin. An overwhelming stench of decay lingers around <him|her>.
|-
| role="rowheader" | {{big|'''<nowiki>|X|</nowiki>'''}}
| '''Troll King'''
| April 2017
| [[Legendary Bloodrune Cloak|Trollhide Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a troll king. With arms like enormous tree branches and claws sharp as razors, <he|she> appears quite a formidable opponent. Grotesque clusters of scab-ridden warts along <his|her> dark green leathery skin are slightly overshadowed by bits of bloodied flesh that dangle from <his|her> oversized incisors. While <his|her> size and appearance is quite intimidating, a vacant look exists in <his|her> eyes.
|-
| role="rowheader" | {{big|'''<nowiki>~\\O//~</nowiki>'''}}
| '''Storm Griffin'''
| February 2018
| [[Legendary Bloodrune Cloak|Feather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a storm griffin. In contradiction, large powder-blue feathers gracefully frame <his|her> face, but <his|her> aquiline nose presents validity to <his|her> ability to slice through the thickest of flesh with ease. <His|Her> muscular and powerful hindquarters are only slightly less intimidating than the massive claws that could assassinate any opponent in one brutal swipe. An elongated, sandy blonde feline tail with a tuft of a darker-hued fur swats tirelessly at the air around <him|her>, and <he|she> seems to almost hover a few inches off the ground, propelled by <his|her> daunting, but magnificent, wings.
|-
| role="rowheader" | {{big|'''<nowiki>~\\X//~</nowiki>'''}}
| '''War Griffin'''
| February 2018
| [[Legendary Bloodrune Cloak|Feather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a war griffin. In contradiction, large golden feathers gracefully frame <his|her> face, but <his|her> aquiline nose presents validity to <his|her> ability to slice through the thickest of flesh with ease. <His|Her> muscular and powerful hindquarters are only slightly less intimidating than the massive claws that could assassinate any opponent in one brutal swipe. An elongated, white feline tail with a tuft of a darker-hued fur swats tirelessly at the air around <him|her>, and <he|she> seems to almost hover a few inches off the ground, propelled by <his|her> daunting, but magnificent, wings.
|-
| role="rowheader" | {{big|'''<nowiki>\\~oOo~//</nowiki>'''}}
| '''Vesperti'''
| June 2018
| [[Legendary Bloodrune Cloak|Tenebrous Cloak]]
| align=left | Through a <pendant color> haze, <your name>'s features appear transformed into those of a vesperti. Willowy thin and tall, <his|her> lithe form is covered in coarse black fur. Intense grey eyes stare out from beneath a mane of tousled hair, while the fine features of <his|her> face resemble an elven ancestry. A veined membrane of skin extends from <his|her> ankles up to his wrists, their edges scalloped like those of a bat's wings. Tapered digits bearing glossy black claws cap the wings at taloned feet and hands.
|-
| role="rowheader" | {{big|'''<nowiki>`x-^-x`</nowiki>'''}}
| '''Abyran'ra'''
| August 2019
| [[Legendary Bloodrune Cloak|Black Snakeskin Cloak]]
| align=left | Through a/n <pendant color> haze, <character name>'s features appear transformed into those of an abyran'ra. Thirteen <hair color> serpents ring <his|her> head, bestowing <her|him> a full crown of the twisting vipers as they writhe back and forth in an undulating, hypnotic fashion. <His|Her> pale, lidless eyes are devoid of pupils -- merely rippling with faint hints of <eye color> every few moments. Twin pairs of fangs peek out from beneath <his|her> thin lips, and the smoothness of <his|her> skin fades away into sleek scales below <his|her> abdomen, <his|her> lower body tapering into a massive, sinuous tail like that of a snake.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>.-'', _( )____</nowiki>'''}}
| '''Giant Rat'''
| August 2020
| [[Legendary Bloodrune Cloak|Scraggly Rat Fur Cloak]]
| align=left | Through an <pendant color> haze, <character> features appear to be transformed into those of a giant rat. Dark, scruffy amber fur dominates his pot-bellied form, while beady crystal green eyes gaze over a pointed snout with two very large, white front teeth. Two naked pink ears, the right of which is missing a large chunk, twitch as he listens to everything around him. A long, seemingly bald tail stretches out behind him.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>==||==</nowiki>'''}}
| '''Colossus'''
| August 2021
| [[Legendary Bloodrune Cloak|Granite-hued oilcloth cloak]]
| align=left | Towering over her surroundings, Thandiwe has a stony countenance with an impassive expression and an unyielding hazel gaze. Chiseled features with chips and pits due to aging and erosion make it impossible to determine her race, while skins of moss in shades of rust red provide the hint of natural hair. Her hands stand out the most, the large digits at once smooth from exposure to weather and yet cracked with age, hinting at a hidden strength beneath a calm exterior.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>./*~*\.</nowiki>'''}}
| '''Snow Spectre'''
| February 2022
| [[Legendary Bloodrune Cloak|Frosty gossamer shroud]]
| align=left | Haunting winter grey eyes gaze with a disturbing vacancy from Thandiwe's eerie visage, which morphs between expressions of abject horror and fractured sanity from one moment to the next. His waif-like limbs float in a current of frosty air that spirals around him, transforming his appearance between states of flickering, semi-translucency to near blinding white and icy solidity. A mane of coppery red hair frames his gaunt head, the scraggly tendrils falling away from his gaunt face in erratic lengths.
|-
|}
</div><section end=legendary />

{{top}}

==See Also==
* [[/saved posts|Saved posts]]
* [[MoonShard pendant]]
* [[Legendary Bloodrune Cloak]]
* [[Blood-infused crystal]]
* [[Bloodrune Holder]]
* [[Duskruin Arena]]
</td><td>
{{iteminfo
|type=Fluff 
|itemclass=Miscellaneous 
|itemtype=Bloodrune 
|itemtype2=Totem
|itemtype3=Stone
|itemtype4=Chisel
|alter=No 
|ld=No 
|feature= 
|customize= 
|custom= 
|origmerch= 
|releasevenue=Duskruin 
|releaseyear=2016 
|questitem= 
|tiered= 
|tiersnumber= 
|unlock= 
|legendary= 
|demeanor= 
|loresong= 
|corrscript=MoonShard pendant 
|corrscript2=Bloodrune Holder
|attune= 
|attunement= 
|affinity= 
|spell= 
|enhancive= 
|swap= 
|add= 
|restrictions=Bloodrunes must be carved from stones. Only useful with [[MoonShard pendant|MoonShard Pendant]]s and [[Bloodrune Holder]]s. 
}}
{{itemverb
|verb=CARVE 
|verb2=LOOK
|verb3=READ
|verb4=TURN
}}
</td></tr></table>
[[Category:Duskruin collectible items]]

Bloodrune

2026-03-23T19:14:53Z

HORIBU1: minor formatting changes

<table><tr valign="top"><td>
A '''[[#Bloodrune|bloodrune]]''' can be used in conjunction with a [[MoonShard pendant]] in order alter the appearance of its glamour or with a [[Bloodrune Holder]] to create an illusion. Using [[#Flat Etched Stone|stones]] found in the sewers and a [[#Chisel|chisel]], they can be created by carving an [[#Ur-Barath Totem|ur-barath totem]]. When a bloodrune is in use, it adds an additional line to the pendant's {{boldmono|LOOK}}/{{boldmono|SHOW}} description and alters the glamour that the pendant projects based on its tier.

Bloodrunes can be {{boldmono|TURNed}} to prevent them from being sold to the archaeologist NPC. {{boldmono|MARK}} does not work with this item.
{{TOC limit|2}}
{{itemtiermulti 
|item=Ur-Barath Totem 
|itemsummary= 
An '''ur-barath totem''' serves as the starting form of a [[#Bloodrune|bloodrune]]. When {{boldmono|CARVEd}} with a [[#Chisel|chisel]], the ur-barath totem is transformed into a bloodrune.
|analyze= 
You analyze your ur-barath totem and sense that the item is largely free from merchant alteration restrictions.

The creator has also provided the following information:
This totem is not suitable for alterations or fodder. It appears as if it might be suitable for carving with a chisel. You should find a jagged stone which can be found within the Duskruin tunnels.

You get no sense of whether or not the totem may be further lightened.
|inspect= 
|show= 
|affinity= 
|itemverbtable= 
}}
{{itemtiermulti 
|item=Flat Etched Stone 
|itemsummary= '''Flat etched stones''' are found in the [[Bloodriven Sewers]] of Duskruin. Using a [[#Chisel|chisel]] sold at [[BVShop:The Mar and Scar|The Mar and Scar]], along with an [[#Ur-Barath Totem|ur-barath totem]], you can {{boldmono|READ}} the stone to commit the rune to memory before you {{boldmono|CARVE}} the totem with the chisel.
|analyze= 
This etched stone is of the ''<type>'' tier. To learn more about it, you should ask the dwarven archaeologist around the Underground Temple of Bloodriven Village. Or, you can READ the stone to burn the image to your memory for a short time.

Your etched stone can be purchased by the Archaeologist in Bloodriven Village. Use TURN to mark it as unsellable.
|inspect= 
|affinity= 
|itemverbtable= Yes
}}
{| {{verbtable}} 
|- {{verbtableheader|90}}
! scope="col" style="width:5em;"|Verb
! scope="col" style="width: 45%"|First
! scope="col" style="width: 45%"|Third
|-
! scope="row" role="rowheader"|LOOK
| This smooth stone bears unfamiliar markings along its flat surface. Thin veins of crimson create a web-like pattern across its exterior.
There appears to be something written on it.
| N/A
|-
! scope="row" role="rowheader"|READ
| Carved into the top of the stone is the "''<rune>''" rune. While unfamiliar, you sense that reading it again will set its design to memory and cause the stone to crumble.

{{blue|If you are ready to study this stone, READ the stone again within 15 seconds.<br>
[NOTE: You must have a totem and a chisel in order to carve.]}}
| N/A
|-
! scope="row" role="rowheader" rowspan="3" |TURN
| You flip a flat etched stone over in your hand and scratch the stone with your fingernail, creating a small "X" along its surface.
| {{addmetext}}
|-
| You flip a flat etched stone over in your hand and scratch the stone with your fingernail, scraping off a small "X" along its surface.
| {{addmetext}}
|-
| colspan="2" style="text-align:center"|This toggles if the stone can be sold to the archaelogist in the Arena for bloodscrip.
|}
{{itemtiermulti 
|item=Chisel 
|itemsummary= A '''primitive metal chisel''' sold at [[BVShop:The Mar and Scar|The Mar and Scar]] can be used to carve a rune into an [[#Ur-Barath Totem|ur-barath totem]]. The rune's appearance must be taken from a [[#Flat Etched Stone|flat etched stone]] found in the [[Bloodriven Sewers]].
|analyze= 
This single-use chisel can be used to carve ur-barath totems found during Duskruin Dig. <CARVE TOTEM WITH CHISEL> You should look for stones in Duskruin's tunnels. These items cannot be altered.
|inspect= 
|affinity= 
|itemverbtable=Yes 
}}
{| {{verbtable}} 
|- {{verbtableheader|90}}
! scope="col" style="width:5em;"|Verb
! scope="col" style="width: 45%"|First
! scope="col" style="width: 45%"|Third
|-
! scope="row" role="rowheader"|CARVE {TOTEM} WITH {CHISEL}
| {{addmetext}}
| {{addmetext}}
|}
{{itemtiermulti 
|item= Bloodrune
|itemsummary= '''Bloodrunes''' are created when a [[#Ur-Barath Totem|totem]] has been carved with a [[#Chisel|chisel]] after the [[#Flat Etched Stone|stone]] has been read and crumbles.

There are multiple tiers: [[{{PAGENAME}}#Classic|Classic]], [[{{PAGENAME}}#Divine|Divine]], [[{{PAGENAME}}#Arcane|Arcane]], [[{{PAGENAME}}#Mystic|Mystic]], and [[{{PAGENAME}}#Legendary|Legendary]]. Verb usage for the bloodrune is similar to its flat etched stone version.
|analyze= The creator has also provided the following information:

This moss-covered bloodrune is of the ''<type>'' tier. Using PUSH (pendant) while holding a ''ragged moss-covered'' bloodrune you can add it to the pendant. Likewise, you can PULL (pendant) to remove a bloodrune that has been added. Speak to the dwarven archaeologist around the Underground Temple of Bloodriven Village for more information.

Your moss-covered bloodrune can be purchased by the Archaeologist in Bloodriven Village. Use TURN to mark it as unsellable.
|inspect= 
|affinity= 
|itemverbtable= 
}}
==Additional Information==
===Classic===
Classic bloodrunes are the most common tier available. When added, the bloodrune adds an additional line to the glamour illusion of the pendant.

* '''Bloodrune Holder'''
: ''Effect: (He/She) gives off a(n) <rune> semblance.''

* '''MoonShard Pendant'''
: ''Effect: A(n) <rune> look washes over (his/her) face.''
<section begin=classic /><div><ul>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2016
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>^v^</nowiki>}}'''
| bloodthirsty
|-
|role="rowheader" | '''{{big|<nowiki>OXO</nowiki>}}'''
| enraged
|-
|role="rowheader" | '''{{big|<nowiki>| | |</nowiki>}}'''
| savage
|-
|role="rowheader" | '''{{big|<nowiki>)|(</nowiki>}}'''
| tempestuous
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released April 2017
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>v-o-v</nowiki>}}'''
| ferocious
|-
|role="rowheader" | '''{{big|<nowiki>X</nowiki>}}'''
| fierce
|-
|role="rowheader" | '''{{big|<nowiki>^w^</nowiki>}}'''
| menacing
|-
|role="rowheader" | '''{{big|<nowiki>)*(</nowiki>}}'''
| persuasive
|-
|role="rowheader" | '''{{big|<nowiki>- - -</nowiki>}}'''
| serene
|-
|role="rowheader" | '''{{big|<nowiki>|OO|</nowiki>}}'''
| solemn
|-
|role="rowheader" | '''{{big|<nowiki>/ / /</nowiki>}}'''
| troubled
|-
|role="rowheader" | '''{{big|<nowiki>v--v</nowiki>}}'''
| vicious
|-
|role="rowheader" | '''{{big|<nowiki>OoO</nowiki>}}'''
| wild
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2017
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>/o\</nowiki>}}'''
| melancholy
|-
|role="rowheader" | '''{{big|<nowiki>| oo |</nowiki>}}'''
| tormented
|-
|role="rowheader" | '''{{big|<nowiki>O/\O</nowiki>}}'''
| vengeful
|-
|}
<br>
{| class="wikitable alternating" style="text-align:center;"
|+ Released June 2018
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>*Sss</nowiki>}}'''
| enraptured
|-
|role="rowheader" | '''{{big|<nowiki>!i!-</nowiki>}}'''
| imperious
|-
|} </li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Released August 2020
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>/--/</nowiki>}}'''
| devious
|-
|role="rowheader" | '''{{big|<nowiki>~\-</nowiki>}}'''
| pitiless
|-
|role="rowheader" | '''{{big|<nowiki>~\o</nowiki>}}'''
| pitiful
|-
|role="rowheader" | '''{{big|<nowiki>Vv|</nowiki>}}'''
| sadistic
|-
|}

{| class="wikitable alternating" style="text-align:center;"
|+ Released February 2022
! Symbol
! Appearance
|-
|role="rowheader" | '''{{big|<nowiki>O|O</nowiki>}}'''
| contemplative
|-
|} </li>
</ul></div><section end=classic />
{{top}}

===Divine===
Divine bloodrunes are the second most common tier able to be found in the sewers. Similar to the [[Bloodrune#Classic | classic]] tier, they add a line to the MoonShard pendant's original glamour effect, and align with specific deities. A [[Blood-infused crystal#Divine | blood-infused crystal]] can be used to slightly alter the rune on divine bloodrunes, changing the moonshard pendant's base glamour.

* '''Bloodrune Holder'''
: ''Effect: Miniature <item> spiral outward from (him/her) before fading away.''

* '''MoonShard Pendant'''
: ''Effect: Interspersed within the dim aura are miniature <item> that float around (him/her).''
<section begin=divine />
<div><ul>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Liabo
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>^~^~^</nowiki>}}'''
|[[Charl]]
| jade tridents
|-
| role="rowheader" | '''{{big|<nowiki>o|`</nowiki>}}'''
| [[Cholen]]
| music notes
|-
| role="rowheader" | '''{{big|<nowiki>/--\</nowiki>}}'''
| [[Eonak]]
| iron anvils
|-
| role="rowheader" | '''{{big|<nowiki>\__/</nowiki>}}'''
| [[Imaera]]
| sheafs of grain
|-
| role="rowheader" | '''{{big|<nowiki>O</nowiki>}}'''
| [[Jastev]]
| crystal balls
|-
| role="rowheader" | '''{{big|<nowiki>/v\</nowiki>}}'''
| [[Jaston]]
| bird feathers
|-
| role="rowheader" | '''{{big|<nowiki>---O</nowiki>}}'''
| [[Kai]]
| clenched fists
|-
| role="rowheader" | '''{{big|<nowiki>O-O-O</nowiki>}}'''
| [[Koar]]
| golden crowns
|-
| role="rowheader" | '''{{big|<nowiki>_|_|_</nowiki>}}'''
| [[Kuon]]
| golden leaves
|-
| role="rowheader" | '''{{big|<nowiki>\ \</nowiki>}}'''
| [[Laethe]]
| black rose petals
|-
| role="rowheader" | '''{{big|<nowiki>XX</nowiki>}}'''
| [[Leya]]
| ivory-hilted daggers
|-
| role="rowheader" | '''{{big|<nowiki>|-|-|-|</nowiki>}}'''
| [[Lorminstra]]
| golden keys
|-
| role="rowheader" style="white-space: nowrap;"| '''{{big|<nowiki>~-o-o-~</nowiki>}}'''
| [[Lumnis]]
| tomes
|-
| role="rowheader" | '''{{big|<nowiki>~~~~</nowiki>}}'''
| [[Niima]]
| silver dolphins
|-
| role="rowheader" | '''{{big|<nowiki>|^|</nowiki>}}'''
| [[Oleani]]
| hearts
|-
| role="rowheader" | '''{{big|<nowiki>|*|</nowiki>}}'''
| [[Phoen]]
| brilliant sunbursts
|-
| role="rowheader" | '''{{big|<nowiki>* * *</nowiki>}}'''
| [[Ronan]]
| shimmering stars
|-
| role="rowheader" | '''{{big|<nowiki>*|o</nowiki>}}'''
| [[Tilamaire]]
| yellow treble clefs
|-
| role="rowheader" | '''{{big|<nowiki>|^*|</nowiki>}}'''
| [[Tonis]]
| pegasi
|-
| role="rowheader" | '''{{big|<nowiki>/ /</nowiki>}}'''
| [[Voaris]]
| yellow rose petals
|-
| role="rowheader" | '''{{big|<nowiki>)X(</nowiki>}}'''
| [[Voln]]
| white shields
|-
|}
</li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Lornon
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>O--O</nowiki>}}'''
| [[Amasalen]]
| two-headed serpents
|-
| role="rowheader" | '''{{big|<nowiki>^--^</nowiki>}}'''
| [[Andelas]]
| black cats
|-
| role="rowheader" | '''{{big|<nowiki>)O(</nowiki>}}'''
| [[Eorgina]]
| red flames
|-
| role="rowheader" | '''{{big|<nowiki>(-)(-)</nowiki>}}'''
| [[Fash'lo'nae]]
| slit-pupiled eyes
|-
| role="rowheader" | '''{{big|<nowiki>s-S</nowiki>}}'''
| [[Ghezresh]]|| sinuous eels
|-
| role="rowheader" | '''{{big|<nowiki>((O))</nowiki>}}'''
| [[Ivas]]
| wisps of green
|-
| role="rowheader" | '''{{big|<nowiki>~S~</nowiki>}}'''
| [[Luukos]]
| green serpents
|-
| role="rowheader" | '''{{big|<nowiki>~(o)~</nowiki>}}'''
| [[Marlu]]
| six-tentacled stars
|-
| role="rowheader" | '''{{big|<nowiki>\ X /</nowiki>}}'''
| [[Mularos]]
| rusted shackles
|-
| role="rowheader" | '''{{big|<nowiki>(-o-)</nowiki>}}'''
| [[Onar]]
| white skulls
|-
| role="rowheader" | '''{{big|<nowiki>O||O</nowiki>}}'''
| [[Sheru]]
| jackal heads
|-
| role="rowheader" | '''{{big|<nowiki>---^</nowiki>}}'''
| [[V'tull]]
| black scimitars
|-
|}
<br>
{| class="wikitable alternating" style="text-align:center;"
|+ Neutral
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>**|~~</nowiki>}}'''
|[[Aeia]]
| white lilies
|-
| role="rowheader" | '''{{big|<nowiki>=O=</nowiki>}}'''
| [[Arachne]]
| spiders
|-
| role="rowheader" | '''{{big|<nowiki>~o~</nowiki>}}'''
| [[Gosaena]]
| white feathers
|-
| role="rowheader" | '''{{big|<nowiki>~|-|~</nowiki>}}'''
| [[The Huntress]]
| eight-pointed stars
|-
| role="rowheader" | '''{{big|<nowiki>oOo</nowiki>}}'''
| [[Zelia]]
| grey chariots
|}</li>
<li style="display: inline-table;">
{| class="wikitable alternating" style="text-align:center;"
|+ Other
! Symbol
! Deity
! Appearance
|-
| role="rowheader" | '''{{big|<nowiki>OOO</nowiki>}}'''
| [[Illoke]]
| boulders
|-
| role="rowheader" | '''{{big|<nowiki>.o.</nowiki>}}'''
| [[Khaarne]]
| stones
|-
| role="rowheader" | '''{{big|<nowiki>|=|</nowiki>}}'''
| [[Meyno]]
| slabs of rock
|-
|} </li>
</ul></div>
<section end=divine />
{{top}}

===Arcane===
Arcane bloodrunes are the third tier available, and were initially introduced during the August 2017 Duskruin run. Unlike the [[Bloodrune#classic|classic]] or [[Bloodrune#Divine|divine]], arcane bloodrunes change the entire glamour affect of the MoonShard pendant instead of adding a line at the end of it. [[Blood-infused crystal#Arcane | Blood-infused crystals]] can be used to change the location in the pendant's glamour from '''Bloodriven Village''' to the location associated with the rune on the crystal.

* '''Bloodrune Holder'''
: ''Effect: <Rune Type> arcane sigils glow in front of (him/her).''

* '''MoonShard Pendant:'''
<section begin=arcane />
: <h4>Released August 2017</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>,,-,'</nowiki>'''}}
| '''Anatomical'''
|align=left| Through a <pendant color> haze, you see an Anatomical Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Murky golden tendrils wrap possessively around <his/her> shadowed figure, which is covered in rapidly healing and unhealing wounds.
| <Thin>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>o|-</nowiki>'''}}
| '''Animation'''
|align=left| Through a <pendant color> haze, you see an Animation Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A sickly green miasma writhes riotously around <his/her> shadowed figure, which is covered in arabesque patterns framed by an unnatural glow.
| <Bold>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>^-z_</nowiki>'''}}
| '''Blood'''
|align=left| Through a <pendant color> haze, you see a Blood Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Blood red mist swirls threateningly around <his/her> shadowed figure, which is covered in jagged scars.
| <Sanguine>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>+ =Y</nowiki>'''}}
| '''Chaos'''
|align=left| Through a <pendant color> haze, you see a Chaos Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Thick black smoke spirals turbulently around <his/her> dark figure, which is covered in stylized lubricious streaks of ebon.
| <Erratic>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>*Oo**%</nowiki>'''}}
| '''Cosmology'''
|align=left| Through a <pendant color> haze, you see a Cosmology Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Streaks of black and golden energy flash violently around <his/her> pale figure, which is covered in veins that glow with white light.
| <Nebulous>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>x_ _X</nowiki>'''}}
| '''Death'''
|align=left| Through a <pendant color> haze, you see a Death Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Unctuous black locusts flit savagely around <his/her> shadowed figure, which is covered in charred-edged stylized characters.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>Q__Q</nowiki>'''}}
| '''Divination'''
|align=left|Through a <pendant color> haze, you see a Divination Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Nebulous golden clouds meander aimlessly around <his/her> shadowed figure, which is covered in a spray of glistening dewdrops.
| <Violet-streaked>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>|o~o|</nowiki>'''}}
| '''Elemental'''
|align=left| Through a <pendant color> haze, you see an Elemental Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Lightning-streaked violet gloom twists haphazardly around <his/her> dark figure, which is covered in constantly sparking lines of electricity.
| <Flashing>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>;~-- ~~</nowiki>'''}}
| '''Energy'''
|align=left|Through a <pendant color> haze, you see an Energy Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Shimmering rainbow light flashes intermittently around <his/her> pale figure, which is covered in powdery white arcane lettering.
| <Pulsating>
|-
| role="rowheader" scope="row" style="white-space: nowrap"| {{big|'''<nowiki>__%=__ </nowiki>'''}}
| '''Extraplanar'''
|align=left| You see an Extraplanar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Sparks of gold infuse the deep grey brume that twirls rapidly around <his/her> pale figure, which is covered in burnt skin and scorch marks.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>:'`||':</nowiki>'''}}
| '''Mental'''
|align=left|Through a <pendant color> haze, you see a Mental Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Soft sky blue fog gently wafts to and fro around <his/her> illuminated figure, which is covered in constantly shifting esoteric runes.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>~~s*</nowiki>'''}}
| '''Spirit'''
|align=left| Through a <pendant color> haze, you see a Spirit Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A cloud of innocuous white smoke winds lazily around his dark figure, which is covered in long, blood-streaked scratches.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>^`\`/-</nowiki>'''}}
| '''Supernatural'''
|align=left| Through a <pendant color> haze, you see a Supernatural Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A darkly shaded film bends loosely around <his/her> dark figure, which is covered in a glaze of misty, elaborately constructed shapes.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>](*)[</nowiki>'''}}
| '''Symbology'''
|align=left| Through a <pendant color> haze, you see a Symbology Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A whirlwind of books and scrolls churns wildly around <his/her> shadowed figure, which is covered in an array of archaic runes.
| <Searing>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>~~/~~</nowiki>'''}}
| '''Temporal'''
|align=left| Through a <pendant color> haze, you see a Temporal Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A veil of visibly distorted air curls closely around <his/her> illuminated figure, which is covered in contorting geometric forms.
|
|-
|}

: <h4>Released February 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" style="white-space: nowrap" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>*^_v*</nowiki>'''}}
| '''Mesmerism'''
|align=left|Through a <pendant color> haze, you see a Mesmerism Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Hypnotically bright sparks of gold and silver dance around <his/her> illuminated figure, which is covered in a glimmering opaline sheen.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>[[]-[]-[]]</nowiki>'''}}
| '''Occlusion'''
|align=left|Through a <pendant color> haze, you see a Occlusion Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Occasionally smeared with darkness, an otherwise nearly translucent barrier continually folds in and out of existence around <his/her> illuminated figure, which is covered in distinctive chalky white sigils.
| <Frost-tinged>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>,~YvY~`</nowiki>'''}}
| '''Ritual'''
|align=left|Through a <pendant color> haze, you see a Ritual Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Unnaturally flickering candlelight flares erratically around <his/her> shadowed figure, which is covered in myriad precise symbols slashed into his skin.
| <Rigid>
|-
|}

: <h4>Released June 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" style="white-space: nowrap" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>-|T|-</nowiki>'''}}
| '''Construct'''
|align=left|Through a silver-flecked light azure haze, you see a Construct Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. An encompassing golden aura sends streamers of flashing light ricocheting around <his/her> illuminated figure, which is covered in patches of skin with a granite-like white alabaster stone apperance.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>|(C0</nowiki>'''}}
| '''Lunar'''
|align=left|Through a <pendant color> haze, you see a Lunar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Fading in and out of sight, pale moonbeams fancifully float to and fro around <his/her> pale figure, which is covered in a wash of silvery white moonlight.
| <Pale silver>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>=0=</nowiki>'''}}
| '''Solar'''
|align=left|Through a radiant golden haze, you see <a/an> Solar Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Nearly blindingly billiant, fiery sunrays radiate out from around <his/her> illuminated figure, which is covered in a wash of reddish gold sunlight.
|
|-
|}

: <h4>Released August 2020</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! rowspan="2" scope="col" | Symbol
! rowspan="2" scope="col" | Meaning
! colspan="2" scope="col" | Appearance
|-
! scope="col" | MoonShard pendant
! scope="col" | Bloodrune Holder
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>0*8t</nowiki>'''}}
| '''Augury'''
|align=left|Through a silver-flecked light azure haze, you see <a/an> Augury Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A clustered miasma of faint, ever-changing images hovers around <his/her> illuminated figure, which is covered in a dark, prismatic material.
| <Rippling>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>{[:</nowiki>'''}}
| '''Enchantment'''
|align=left|Through a silver-flecked light azure haze, you see <a/an> Enchantment Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. A cloud of elemental energy pulses around <his/her> illuminated figure, which is covered in runic brands interspersed with singe marks.
| <Rippling>
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>xO|</nowiki>'''}}
| '''Hexeri'''
|align=left|Through an ethereal white haze, you see <a/an> Hexeri Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Rough-shod charms and talismans hover in mid-air, swinging back and forth around <his/her> illuminated figure, which is covered in scarlet-leaking black veins.
|
|-
| role="rowheader" scope="row" | {{big|'''<nowiki>c--</nowiki>'''}}
| '''Metallurgy'''
|align=left|Through an ethereal white haze, you see <a/an> Metallurgy Arcanist of Bloodriven Village with faintly luminous <eye color> eyes. Tiny, razor-thin scraps of metal flit around his illuminated figure, which is covered in a medley of shifting, metallic-inked tattoos.
|
|-
|}
<section end=arcane />

{{top}}

===Mystic===
Mystic bloodrunes are the final tier of more widely available bloodrunes. Similar to [[Bloodrune#Arcane | arcane]] bloodrunes, they were released in August 2017 and change the entire glamour effect of the MoonShard pendant. However, mystic bloodrunes have 4-5 versions that shift when worn with a Pendant. When used in a Bloodrune Holder, it creates an illusion which is custom to each bloodrune - ''Effect: Mystical energies wash over him, [custom for each Mystic bloodrune].''

<section begin=mystic />: <h4>Released August 2017</h4>
<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>8~~8</nowiki>       Continuance
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Afternoon Sky'''
|Through a <pendant color> haze, you see <character> ensconced in a shroud of pure sunlight. <His/Her> eyes are pools of deep blue reminiscent of an afternoon sky. Misty clouds of white occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...ensconcing <him/her> in a steady shroud of calm.
|-
| role="rowheader" scope="row" | '''Sunset'''
|Through a <pendant color> haze, you see <character> ensconced in a shroud of sunset. <His/Her> eyes are pools of vibrantly streaked hues reminiscent of an impending twilight. A shower of moonbeams occasionally flows across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Moonlight'''
|Through a <pendant color> haze, you see <character name> ensconced in a shroud of a dark night sky. <His/Her> eyes are pools of glowing silvery white reminiscent of moonlight. A shower of stars occasionally shoots across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Midnight'''
|Through a <pendant color> haze, you see <character name> ensconced in a shroud of midnight's black. <His/her> eyes are pools of pitch reminiscent of a starless night. Tendrils of darkness occasionally slither across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>*Oo**</nowiki>        Cosmos
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Lornon'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of ice-fringed dark moonlight. <His/Her> eyes are pools of swirling grey reminiscent of Lornon's surface. A sickly blood red hue occasionally washes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...draping <him/her> in a nebulous shroud tinged with cosmic dust.
|-
| role="rowheader" scope="row" | '''Makiri'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of darkness. <His/Her> eyes are pools of pale golden light reminiscent of starlight. Shifting constellations occasionally ebb and flow across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Liabo'''
|Through a <pendant color> haze, you see <character> swathed in a shroud of brilliant silvery white moonlight. <His/Her> eyes are pools of pure ivory reminiscent of Liabo's surface. A pale golden glow occasionally washes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Tilaok'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of fiery moonlight. <His/Her> eyes are pools of reddish-orange reminiscent of Tilaok's surface. A silvery white wash of light occasionally dances across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Star Field'''
|Through a <pendant color> haze, you see <character name> swathed in a shroud of a swirling star field. <her/His> eyes are pools of circularly graduated star-shot color reminiscent of nebulae. Asteroids and resplendent galaxy clusters occasionally twirl across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>_-_-</nowiki>        Cycle of Age
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Child'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that brings out <his/her> child-like appearance. <His/her> eyes are pools of blindingly brilliant light reminiscent of a firestorm. A velvety texture and natural glow infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...cocooning <him/her> in a cyclical shroud that ages and rejuvenates <his/her> countenance.
|-
| role="rowheader" scope="row" | '''Youth'''
| Through a radiant golden haze, you see <character> cocooned in a shroud that highlights <his/her> youthful appearance. <His/her> eyes are pools of blazing light reminiscent of a strongly burning flame. A satiny smooth, supple texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Middle-Aged'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that highlights <his/her> middle-aged appearance. <His/her> eyes are pools of bright light reminiscent of a steadily burning flame. A grainy, pebbled texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Ancient'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that highlights <his/her> ancient and stooped appearance. <His/Her> eyes are pools of dim light reminiscent of a weakly flickering flame. A wrinkled, withered texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Death'''
| Through a <pendant color> haze, you see <character> cocooned in a shroud that brings out <his/her> cadaver-like appearance. <His/Her> eyes are pools of matte black, reminiscent of a void. A disintegrating, mushy texture infuses <his/her> skin, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>||o~o||</nowiki>        Elements
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Water'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of vivid blue water. <His/Her> eyes are pools of sparkling icy white reminiscent of icicles reflecting light. White-crested sea green waves occasionally crash across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...surrounding him/her in an elemental shroud of swirling ethereal lights.
|-
| role="rowheader" scope="row" | '''Earth'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of cracked, stone earth. <His/her> eyes are pools of dark brown reminiscent of muddy flats. Flows of magma gradually solidifying into black formations occasionally creep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Fire'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of brilliant orange-red fire. <His/her> eyes are pools of blazing white reminiscent of heated metal. Bright blue flames occasionally flare across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Air'''
|Through a <pendant color> haze, you see <character> surrounded by a shroud of colorful flows of air. <His/her> eyes are pools of swirling, flashing light reminiscent of a violent maelstrom. Aurora-like swaths of shimmering air occasionally sweep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>``\`/</nowiki>        Nature
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Mountains'''
|Through a <pendant color> haze, you see <character name> enveloped in a shroud of snow-capped mountains. <His/Her> eyes are pools of pure pale blue reminiscent of glacial waters. Stormy grey clouds flashing with lightning occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...enveloping him/her in a light shroud of fluctuating winds.
|-
| role="rowheader" scope="row" | '''Highlands'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of rolling, green highlands. <His/Her> eyes are pools of vibrant variegated colors reminiscent of patches of wildflowers. The thin flow of a babbling brook occasionally streams across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Jungle'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of tropical jungle. <His/her> eyes are pools of deep, dark green reminiscent of verdant wilderness. Tiny, colorful birds and vibrant, glossy bugs occasionally flit and skitter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Desert'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of dusky, arid desert. <His/Her> eyes are pools of hazy deep blue reminiscent of heat rippling across a clear, unbroken horizon. Grains of reddish sand occasionally drift across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Cliffs'''
|Through a <pendant color> haze, you see <character> enveloped in a shroud of rocky ocean cliffs. <His/Her> eyes are pools of misty white reminiscent of sea foam. Waves of dark blue water occasionally crash across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>=X=-</nowiki>        Plague
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" | '''Hives'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of bright red hives. <His/her> eyes are pools of red-glazed grey reminiscent of taint and toxins. Dark red spots of scarlet plasma occasionally spurt out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...trussing him/her in a shroud of pestilence and decay.
|-
| role="rowheader" scope="row" | '''Sores'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of festering sores. <His/her> eyes are pools of white-laced black and scarlet reminiscent of infection and malady. Goopy yellowish secretions occasionally seep out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Pustules'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of oozing pustules. <His/Her> eyes are pools of viridian-veined yellow reminiscent of poison and jaundice. A thick, sickly green liquid occasionally oozes out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Scabs'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of variegated scabs. <His/Her> eyes are pools of black-infused blood reminiscent of injury and disease. Sanguine clotted matter occasionally leaks out of <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Decay'''
|Through a <pendant color> haze, you see <character> trussed in a shroud of decay and rot. <His/her> eyes are pools of white maggots reminiscent of corpses and necrosis. Black coffin flies and grey beetles occasionally squirm out of <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger"| <nowiki>.|.|.|.</nowiki>        Seasons
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Summer'''
|Through an <pendant color>, you see <character> wrapped in a shroud of the summer season. <His/Her> eyes are pools of black-rimmed gold reminiscent of the sun's scorching heat. Fireflies occasionally flit to and fro, their lights sparking brightly, across across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ... wrapping him/her in an ever-changing shroud of seasonal leaves.
|-
| role="rowheader" scope="row" | '''Spring'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the spring in full bloom. <His/Her> eyes are pools of mossy green reminiscent of new, verdant growth. Scatterings of seeds, followed by a swirl of colorful blossoms, occasionally whirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Autumn'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the season of autumn. <His/Her> eyes are pools of variegated grey reminiscent of decay after the harvest. Handfuls of reddish-orange leaves occasionally whirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Winter'''
|Through a <pendant color> haze, you see <character> wrapped in a shroud of the chilly dead of winter. <His/Her> eyes are pools of silver-sheened ebon reminiscent of death. White drifts of snow interspersed with light swirls of snowflakes occasionally swirl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

: <h4>Released February 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>q_|-</nowiki>        Integument
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Muscle'''
|Through <pendant color> haze, you see <character> encompassed by a shroud that reflects <his/her> underlying muscles and connective tissue. <His/Her> eyes are pools of whitish yellow reminiscent of fatty tissue. The various muscles, ligaments, and tendons tighten and loosen, shifting to mimic any of <his/her> movements, and suspended over where <his/her> forehead should be are mystical runes glowing with power.
| rowspan="3" | ...encompassing <his/her> visage in an organic shroud of connective tissues and sinew.
|-
| role="rowheader" scope="row" | '''Organs'''
| Through <pendant color> haze, you see <character> encompassed by a shroud that reflects <his/her> underlying internal organs. <His/Her> eyes are pools of reddish brown reminiscent of a healthy liver. The heart beats with consistent regularity, while the other organs occasionally pulse or spasm in an odd show of life, and suspended over where his neck should be are mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Flesh'''
| Through <pendant color> haze, you see <character> encompassed by a shroud that reflects patches of his skin as partially atrophied. <His/Her> eyes are pools of whitish grey reminiscent of dead flesh. Bits of <his/her> epidermis visibly disintegrate on occasion, crumbling away to reveal the underlying layers of dermis and hypodermis, before regenerating into fresh, whole areas of veniom skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>~*=*~**</nowiki>        Wild Weather
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Blizzard'''
|Through <pendant color> haze, you see <character> draped in a shroud of a swiftly swirling blizzard. Her/His eyes are pools of pale whitish blue reminiscent of the onset of a cold chill. Every few seconds, the blizzard reverses directions, slowing just long enough to send hordes of snowflakes dancing to and fro across his/her <skin>, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...draping him/her in an erratic shroud of wild zephyrs.
|-
| role="rowheader" scope="row" | '''Ice Storm'''
|Through <pendant color> haze, you see <character> draped in a shroud of a severely raging ice storm. Her/His eyes are pools of tempestuous silver reminiscent of freezing rain. Every so often, the ice storm reverses direction, sending a spray of ice needles and hailstones across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Hurricane'''
|Through <pendant color> haze, you see <character> draped in a shroud of a rapidly rotating hurricane. Her/His eyes are pools of marbled white reminiscent of a whirlpool-like cloud cover over the eye the storm. With alarming regularity, sprays of pelting rain followed by a rush of blue-green water flow across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Thunderstorm'''
|Through <pendant color> haze, you see <character> draped in a shroud of dark, angry thunderheads. Her/His eyes are pools of white-rimmed deep grey reminiscent of a stormy sky-laden shelf cloud. With alarming regularity, flashes of blindingly bright lightning streak across her/his <skin>, which is chiseled with mystical runes glowing with power.
|-
|}

: <h4>Released June 2018</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>^+</nowiki>        Emotions
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Happiness'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the bright yellow hue of happiness. His/Her eyes are pools of prismatic color that occasionally refracts rainbow hues. Glistening, iridescent light shimmers across his/her <skin>, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...swathing him/her in a heavy shroud of emotional vibrancy.
|-
| role="rowheader" scope="row" | '''Rage'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the of the dark red hue of rage. His/Her eyes are pools of black speared with crimson veins that flash in and out of visibility. Bursts of electrical energy angrily and visibly spark around him/her, the shower of light disappearing into his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Tranquility'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the pale blue hue of tranquility. His/Her eyes are pools of pastel ringed in a soft ivory white. Small, nearly translucent concentric circles of light occasionally spread outward across his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Sorrow'''
|Through a <pendant color> haze, you see <character> cloaked in a shroud of the deep violet-black hue of deep sorrow. His/Her eyes are pools of dark clouds suffused with silvery tears. Ebon hues fold across one another, creating dark voids that collapse in on themselves, as they shift across his/her <skin>, which is chiseled with mystical runes glowing with power.
|-
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>MWM</nowiki>        Metamorphosis
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Caterpillar'''
| Through a <pendant color> haze, you see <character name> cloaked in a leaf green shroud woven in multitudinous horizontal-spanning segments. <His/Her> eyes are pools of bright orange and yellow and shaped to lend <him/her> a vaguely bug-like appearance. Countless tiny caterpillars crawl across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="4" | ...cloaking him/her in a gossamer shroud of constant transformation.
|-
| role="rowheader" scope="row" | '''Butterfly'''
|Through a <pendant color> haze, you see <character name> cloaked in a rainbow-hued shroud sprouting vivid long-tailed butterfly wings. <His/Her> eyes are pools of shiny black, the compound eye-shaped orbs distinctly insect in appearance. In a spray of vibrant color, a plethora of butterflies wing to and fro, swirling and sweeping in ever-changing patterns across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Cocoon'''
|Through a <pendant color> haze, you see <character name> cloaked in a dull brown shroud fitted around <him/her> like a cocoon. <His/Her> eyes are pools of gradually modulating color that shifts from dark hues to light and back again. Slow transformations in hue and texture spreads across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Chrysallis'''
|Through <pendant color> haze, you see <character name> cloaked in a dull brown shroud split open along one side to reveal a wealth of color that slowly streams outward before dissipating into the air. <His/Her> eyes are pools of crystalline-like specks of color that constantly change. As <His/Her> flesh transforms in hue in hue and texture, colorful patterns suffuse and sink across <His/Her> <skin color>, which is chiseled with mystical runes glowing with power.
|}

: <h4>Released August 2020</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>_-~*</nowiki>        Ascendant
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Magma'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of magma-hemmed murk. <His/Her> eyes are pools of black reminiscent of lightless cavern depths deep underground. A wave of movement, like the air itself is visibly vibrating, occasionally ripples across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="5" | ...cloaking <him/her> in an ethereal shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Ocean'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of churning, deep blue ocean. <His/Her> eyes are pools of vibrant aquamarine hue reminiscent of undersea jewel tones. A wash of murky water occasionally splashes across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Sand'''
| Through a <pendant color> haze, you see <character name> trussed in a trailing shroud of golden sand. <His/Her> eyes are pools of melded browns, yellows, and oranges, the combination reminiscent of a range of earthen tones. Tiny pebbles and granules of green sand occasionally sweep across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Horizon'''
|Through a <pendant color> haze, you see <character> trussed in a trailing shroud of a constantly shifting horizon. <His/Her> eyes are pools of white-on-blue reminiscent of puffy clouds drifting across the sky. Rays of bright sunlight, then moonlight, occasionally filter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Stars'''
|Through a <pendant color> haze, you see <character> trussed in a trailing shroud of twinkling stars. <His/Her> eyes are pools of pure light reminiscent of the bright light of the sun. A bleak darkness, like the center of a void, occasionally steals across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
|}

<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>*zz*</nowiki>        Electricity
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Violet'''
|Through an <pendant color> haze you see <character> wrapped in a shroud of sparking vivid violet radiance. His eyes are pools of gleaming incandescence. Tendrils of purple electricity skitter across his pale tan sand-hued skin, which is chiseled with mystical runes glowing with power, before careening outward into almost blindingly bright bursts of sparks.
| rowspan="6" | ...cloaking <him/her> in a shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Golden'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of crackling golden radiance. His eyes are pools of gleaming incandescence. Tendrils of bright white electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before splintering off into jagged spears of flame-laced lightning.
|-
| role="rowheader" scope="row" | '''Viridian'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of flickering vibrant viridian radiance. His eyes are pools of gleaming incandescence. Tendrils of emerald green electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before hurtling outward into concentrated explosions of sizzling sparks.
|-
| role="rowheader" scope="row" | '''Scarlet'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of crackling scarlet radiance. His eyes are pools of gleaming incandescence. Tendrils of red electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before shooting outward into an explosion of forked lightning bolts.
|-
| role="rowheader" scope="row" | '''Ebon'''
|Through an <pendant color> haze, you see <character> wrapped in a shroud of flaring ebon radiance. His eyes are pools of black that leak an opalescent incandescence around the edges. Tendrils of stygian electricity skitter across his silky-looking fair skin, which is chiseled with mystical runes glowing with power, before darting outward in twisted spires of shadow-chased electrical energy.
|-
| role="rowheader" scope="row" | '''Blue'''
| Through a <pendant color> haze, you see <character name> wrapped in a shroud of crackling bright blue radiance. <His/Her> pools of gleaming incandescence. Tendrils of azure electricity skitter across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power, before bursting outward into multi-pronged streaks of silvered lightning.
|-
|}

: <h4>Released February 2021</h4> <noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! colspan="3" scope="col" style="font-size:larger" | <nowiki>[8]</nowiki>        Jewel
|-
! colspan="2" scope="col" | MoonShard Pendant Glamour
! scope ="col" style="width:15em" | Bloodrune Illusion
|-
| role="rowheader" scope="row" | '''Diamonds'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black diamonds. <His/Her> eyes are perfectly matched malachite stones inset with white-point diamond irises. Thin, vivid green rivulets of malachite bleed down from <his/her> eyes to spread out like parasitic veins across <his/her> <skin color> skin, which is chiseled with mystical runes glowing with power.
| rowspan="6" | ...cloaking him/her in an ethereal shroud of vivacity.
|-
| role="rowheader" scope="row" | '''Opals'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black opals. <His/Her> eyes are perfectly matched sapphires inset with cloud opal irises. Thin, deep blue rivulets of sapphire drip down from <his/her> eyes to spread out like watercolor veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Pearls'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black pearls. <His/Her> eyes are mismatched despanals inset with iridescent pearl irises. Thin, rich-hued scarlet rivulets of despanal seep down from <his/her> eyes to spread out like discolored veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Jaspers'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black jaspers. <His/Her> eyes are roughly carved moonstones inset with yellow jasper irises. Thin, silvery rivulets of moonstone stream down from <his/her> eyes to spread out like misty opaline veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Dreamstones'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black dreamstones. <His/Her> eyes are two large, flawless sunstones inset with dark grey dreamstone irises. Thin, yellow-haloed rivulets of sunstone trail down from <his/her> eyes to spread out like fire-riddled veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
| role="rowheader" scope="row" | '''Deathstones'''
|Through an <pendant color> haze, you see <character> draped in a trailing shroud of liquid-like black deathstones. <His/Her> eyes are a pair of jagged smoldereyes inset with black deathstone irises. Thin, smoky violet rivulets of smoldereye cascade down from <his/her> eyes to spread out like darkly glimmering veins across <his/her> <skin color>, which is chiseled with mystical runes glowing with power.
|-
|}
<section end=mystic />

{{top}}

===Legendary===
Legendary bloodrunes are the final tier of bloodrunes and are limited to a release of '''1''' per instance. Similar to [[Bloodrune#Arcane|arcane]] and [[Bloodrune#Mystic|mystic]] tiers, they change the glamour projected by a moonshard pendant. Additionally, they work with corresponding cloaks that are released during the same run but in alternate methods, such as the [[Duskruin Treasure Trove|Treasure Trove]].

* '''Bloodrune Holder'''
: {{addmetext}}

* '''MoonShard Pendant'''
<section begin=legendary />
<noinclude>
::</noinclude><includeonly>:</includeonly>{| class="wikitable alternating" style="text-align:center;"
|-
! Symbol
! Meaning
! Release
! Cloak
! Appearance
|-
| role="rowheader" | {{big|'''<nowiki>~OO~</nowiki>'''}}
| '''Minotaur'''
| August 2016
| [[Legendary Bloodrune Cloak|Rough Leather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a minotaur. Two thick horns protrude from the top of <his/her> head and taper to extreme points. <His|Her> menacing golden eyes appear to flash intermittently but exude a great sense of intelligence. A thick gold ring dangles from <his|her> nose, and a slightly muffled snort-grunt is occasionally heard coming from <his|her> direction.
|-
| role="rowheader" | {{big|'''<nowiki>^O==</nowiki>'''}}
| '''Black Yeti'''
| December 2016
| [[Legendary Bloodrune Cloak|Shaggy Fur Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a yeti. Barely recognizable, <he|she> is covered in long, gristly hair tinged from deep scarlet to stark black. Clumps of dirt imbedded with twigs and leaves cover <his|her> domed head, and a single bushy eyebrow creates a thick ledge of fur over <his|her> tiny black eyes. Massive ivory teeth stained with traces of crimson protrude from <his|her> darkened leathery lips.
|-
| role="rowheader" | {{big|'''<nowiki>==O^</nowiki>'''}}
| '''White Yeti'''
| December 2016
| [[Legendary Bloodrune Cloak|Shaggy Fur Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a yeti. Barely recognizable, <he|she> is covered in long, gristly hair tinged from pale grey to stark white. Clumps of dirt imbedded with twigs and leaves cover <his|her> domed head, and a single bushy eyebrow creates a thick ledge of fur over <his|her> tiny black eyes. Massive ivory teeth stained with traces of crimson protrude from <his|her> darkened leathery lips.
|-
| role="rowheader" | {{big|'''<nowiki>|O|</nowiki>'''}}
| '''Cave Troll'''
| April 2017
| [[Legendary Bloodrune Cloak|Trollhide Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a cave troll. Towering above most giantmen, <his|her> hulking stature alone is intimidating. Wide splits in <his|her> grey leathery skin sprout tufts of coarse dark hair, and rows of oversized fangs protrude from <his|her> mouth, forcing <his|her> lips into a permanent menacing grin. An overwhelming stench of decay lingers around <him|her>.
|-
| role="rowheader" | {{big|'''<nowiki>|X|</nowiki>'''}}
| '''Troll King'''
| April 2017
| [[Legendary Bloodrune Cloak|Trollhide Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a troll king. With arms like enormous tree branches and claws sharp as razors, <he|she> appears quite a formidable opponent. Grotesque clusters of scab-ridden warts along <his|her> dark green leathery skin are slightly overshadowed by bits of bloodied flesh that dangle from <his|her> oversized incisors. While <his|her> size and appearance is quite intimidating, a vacant look exists in <his|her> eyes.
|-
| role="rowheader" | {{big|'''<nowiki>~\\O//~</nowiki>'''}}
| '''Storm Griffin'''
| February 2018
| [[Legendary Bloodrune Cloak|Feather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a storm griffin. In contradiction, large powder-blue feathers gracefully frame <his|her> face, but <his|her> aquiline nose presents validity to <his|her> ability to slice through the thickest of flesh with ease. <His|Her> muscular and powerful hindquarters are only slightly less intimidating than the massive claws that could assassinate any opponent in one brutal swipe. An elongated, sandy blonde feline tail with a tuft of a darker-hued fur swats tirelessly at the air around <him|her>, and <he|she> seems to almost hover a few inches off the ground, propelled by <his|her> daunting, but magnificent, wings.
|-
| role="rowheader" | {{big|'''<nowiki>~\\X//~</nowiki>'''}}
| '''War Griffin'''
| February 2018
| [[Legendary Bloodrune Cloak|Feather Cloak]]
| style="text-align: left;" | Through a <pendant color> haze, <your name>'s features appear transformed into those of a war griffin. In contradiction, large golden feathers gracefully frame <his|her> face, but <his|her> aquiline nose presents validity to <his|her> ability to slice through the thickest of flesh with ease. <His|Her> muscular and powerful hindquarters are only slightly less intimidating than the massive claws that could assassinate any opponent in one brutal swipe. An elongated, white feline tail with a tuft of a darker-hued fur swats tirelessly at the air around <him|her>, and <he|she> seems to almost hover a few inches off the ground, propelled by <his|her> daunting, but magnificent, wings.
|-
| role="rowheader" | {{big|'''<nowiki>\\~oOo~//</nowiki>'''}}
| '''Vesperti'''
| June 2018
| [[Legendary Bloodrune Cloak|Tenebrous Cloak]]
| align=left | Through a <pendant color> haze, <your name>'s features appear transformed into those of a vesperti. Willowy thin and tall, <his|her> lithe form is covered in coarse black fur. Intense grey eyes stare out from beneath a mane of tousled hair, while the fine features of <his|her> face resemble an elven ancestry. A veined membrane of skin extends from <his|her> ankles up to his wrists, their edges scalloped like those of a bat's wings. Tapered digits bearing glossy black claws cap the wings at taloned feet and hands.
|-
| role="rowheader" | {{big|'''<nowiki>`x-^-x`</nowiki>'''}}
| '''Abyran'ra'''
| August 2019
| [[Legendary Bloodrune Cloak|Black Snakeskin Cloak]]
| align=left | Through a/n <pendant color> haze, <character name>'s features appear transformed into those of an abyran'ra. Thirteen <hair color> serpents ring <his|her> head, bestowing <her|him> a full crown of the twisting vipers as they writhe back and forth in an undulating, hypnotic fashion. <His|Her> pale, lidless eyes are devoid of pupils -- merely rippling with faint hints of <eye color> every few moments. Twin pairs of fangs peek out from beneath <his|her> thin lips, and the smoothness of <his|her> skin fades away into sleek scales below <his|her> abdomen, <his|her> lower body tapering into a massive, sinuous tail like that of a snake.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>.-'', _( )____</nowiki>'''}}
| '''Giant Rat'''
| August 2020
| [[Legendary Bloodrune Cloak|Scraggly Rat Fur Cloak]]
| align=left | Through an <pendant color> haze, <character> features appear to be transformed into those of a giant rat. Dark, scruffy amber fur dominates his pot-bellied form, while beady crystal green eyes gaze over a pointed snout with two very large, white front teeth. Two naked pink ears, the right of which is missing a large chunk, twitch as he listens to everything around him. A long, seemingly bald tail stretches out behind him.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>==||==</nowiki>'''}}
| '''Colossus'''
| August 2021
| [[Legendary Bloodrune Cloak|Granite-hued oilcloth cloak]]
| align=left | Towering over her surroundings, Thandiwe has a stony countenance with an impassive expression and an unyielding hazel gaze. Chiseled features with chips and pits due to aging and erosion make it impossible to determine her race, while skins of moss in shades of rust red provide the hint of natural hair. Her hands stand out the most, the large digits at once smooth from exposure to weather and yet cracked with age, hinting at a hidden strength beneath a calm exterior.
|-
| role="rowheader" style="white-space: nowrap;" | {{big|'''<nowiki>./*~*\.</nowiki>'''}}
| '''Snow Spectre'''
| February 2022
| [[Legendary Bloodrune Cloak|Frosty gossamer shroud]]
| align=left | Haunting winter grey eyes gaze with a disturbing vacancy from Thandiwe's eerie visage, which morphs between expressions of abject horror and fractured sanity from one moment to the next. His waif-like limbs float in a current of frosty air that spirals around him, transforming his appearance between states of flickering, semi-translucency to near blinding white and icy solidity. A mane of coppery red hair frames his gaunt head, the scraggly tendrils falling away from his gaunt face in erratic lengths.
|-
|}
<section end=legendary />

{{top}}

==See Also==
* [[/saved posts|Saved posts]]
* [[MoonShard pendant]]
* [[Legendary Bloodrune Cloak]]
* [[Blood-infused crystal]]
* [[Bloodrune Holder]]
* [[Duskruin Arena]]
</td><td>
{{iteminfo
|type=Fluff 
|itemclass=Miscellaneous 
|itemtype=Bloodrune 
|itemtype2=Totem
|itemtype3=Stone
|itemtype4=Chisel
|alter=No 
|ld=No 
|feature= 
|customize= 
|custom= 
|origmerch= 
|releasevenue=Duskruin 
|releaseyear=2016 
|questitem= 
|tiered= 
|tiersnumber= 
|unlock= 
|legendary= 
|demeanor= 
|loresong= 
|corrscript=MoonShard pendant 
|corrscript2=Bloodrune Holder
|attune= 
|attunement= 
|affinity= 
|spell= 
|enhancive= 
|swap= 
|add= 
|restrictions=Bloodrunes must be carved from stones. Only useful with [[MoonShard pendant|MoonShard Pendant]]s and [[Bloodrune Holder]]s. 
}}
{{itemverb
|verb=CARVE 
|verb2=LOOK
|verb3=READ
|verb4=TURN
}}
</td></tr></table>
[[Category:Duskruin collectible items]]

MoonShard pendant

2026-03-23T19:06:49Z

HORIBU1: fix unclosed tags

{{iteminfo
|type= Fluff
|type2= Feature altering
|itemclass= Accessory
|itemtype= Neckworn
|alter= No
|ld= No
|feature= Full Glamour
|releasevenue= Duskruin Arena
|loresong= Yes
|hide= RUB
|restrictions= 
}}
{{itemverb
|verb= SPIN
|verb2= TOSS
|verb3=
|verb4=
|verb5= COVER
|verb6= EXHALE
|verb7= FIDGET
|verb8= PROD
|verb9= RAISE
|verb10= RUB
|verb11= SHAKE
|verb12= LOOK
}}
Initially released during the April 2016 [[Duskruin Arena]], this pendant acts like a [[Glamour crystal|glamour crystal]] when used. The pendant itself is useless without the accompanying [[Moon-Filled Pendant#Moon Shards|moon shards]] found only in the [[Bloodriven Sewers]]. During the August 2016 run, a new feature was added with [[Moon-Filled Pendant#Bloodrunes|bloodrunes]] that add an additional description to the glamoured affect. Moonshard parts are no longer available in the sewers.<br>
<small>''This page contains collapsed sections. To view, click to <span class="mw-customtoggle-classic mw-customtoggle-divine mw-customtoggle-arcane mw-customtoggle-mystic mw-customtoggle-legendary mw-customtoggle-divinecrystal mw-customtoggle-arcanecrystal" role="link" style="color:#0000ff">'''toggle all content'''</span>.''</small>
{{TOC limit|2}}

{{itemtiermulti 
|item= MoonShards
|itemsummary= '''MoonShards''' were found in the sewers, and are required to complete the MoonShard pendant. They need to be {{boldmono|[[BUNDLE]]}}d with appropriate matching MoonShards to create one of four miniature moons based on [[Liabo]], [[Lornon]], [[Tilaok]], and [[Makiri]]. They change to cluster, sphere, then a completed moon with each combination and are all a different color for the bundles. The old dwarven archaeologist inside the Underground Temple in the Duskruin Arena exchanges [[bloodscrip]] for moonshard parts.
{{MoonShards}}
|analyze= You analyze your Liabo moon and sense that the item cannot be altered in any way.

The creator has also provided the following information:
You have successfully combined all the items necessary to craft a miniature Liabo moon! You can either keep this finished item, or you can use it in conjunction with the pendant found on the Duskruin grounds.

Usage: SPIN and TOSS

You get no sense of whether or not the moon may be further lightened.
|itemverbtable= Yes
}}
: {| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em"|VERB
! FIRST
! THIRD
|-
! SPIN
| You deftly balance the miniature <name> moon on the tip of your forefinger and with the opposite hand, spin it gently. <Colored> sparks radiate outward for the duration of the sphere's rotations and dissipate as the ball ceases spinning and falls into your hand.|| Character deftly balances his miniature <name> moon on the tip of his forefinger and with his other hand, spins it gently. <Colored> sparks radiate outward for the duration of the sphere's rotations and dissipate as the ball ceases spinning and falls into his hand.
|-
! TOSS
| You toss the miniature <name> moon into the air. It hovers weightlessly for a moment, a tail of <colored> mist in its wake. Slowly, it falls to your waiting hand.|| Character tosses his miniature <name> moon into the air. It hovers weightlessly for a moment, a tail of <colored> mist in its wake. Slowly, it falls to his waiting hand.
|-
|}
{{top}}

{{itemtiermulti
|item= MoonShard Pendant
|itemsummary= Upon placing the four completed miniature moons into a '''four-ringed metal pendant''', it will randomly transform into a moon-filled pendant with one of fifteen possible metals, and is a fully functioning [[glamour crystal]]. The metal dictates the color of the haze for the glamour, as well as the base and show description of the pendant.

<blockquote>
<big>{{boldmono|LOOK}}</big>
<pre{{log2}}>
Long strands of silver and <metal> have been twisted together in a double rope pattern to create a sturdy, but elegant, neckchain. Four unembellished rings situated side-by-side dangle from the centermost point of the metal strands. All four rings contain a small glowing sphere that appears to spin slowly.
</pre>
{{MoonShard Colors}}
</blockquote>
|analyze= You analyze your white ora pendant and sense that the item cannot be altered in any way.

The creator has also provided the following information:

This white ora pendant cannot be altered in any way. It will hold miniature moons created from individual pieces found in Bloodriven Village, Duskruin. You curently have 4 moons attached to your pendant.

USAGE: COVER (turn feature off), EXHALE, FIDGET, PROD, RAISE, RUB, and SHAKE

Since your pendant is unlocked, it can alter your LOOK description. When worn, you can RUB the pendant to activate this ability, and PROD to change what others will see when they look at you.

Through a ethereal white haze, you see a/an <race> Champion of <Duskruin/Deity> with <complexion> skin and <eye characteristic, if applicable> <eye color> eyes.

Use PROD to toggle between "Duskruin" and <your attuned deity>. Note that this pendant will not be accepted as alter fodder.

You get no sense of whether or not the pendant may be further lightened.
|inspect= 
|affinity= 
|itemverbtable= Yes
}}
: {| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em"|VERB
! FIRST
! THIRD
|-
!style="white-space:nowrap"| COVER<br>''(Glamour not active)''
|You sense that the pendant's magic is already subdued. If you want to activate it again, RUB it.||N/A
|-
! COVER<br>''(Glamour active)''
|You cover all four encircled moons on your white ora pendant with your palm. An ethereal white haze surrounding you fades.||Character covers her white ora pendant with her palm, and an ethereal white haze surrounding her form fades.
|-
! EXHALE
|Drawing the white ora pendant to your mouth, you blow against the quartet of miniature moons. A soft whirring sound resonates through the air.||Drawing her white ora pendant to her mouth, Character blows against the pendant's encircled miniature moons. A soft whirring sound resonates through the air.
|-
! FIDGET
|You fiddle distractedly with the miniature moons on your pendant, spinning each within its casing.||Character fiddles distractedly with some miniature moons on her pendant, spinning each within its casing.
|-
! PROD
|You adjust the casing surrounding each of the moons on your white ora pendant. It is now aligned with the arena setting.||Character adjusts her white ora pendant and rearranges the placement of its moons.
|-
! RAISE
|Tugging lightly, you slide the moon-filled pendant back and forth along its chain. A faint dark grey orb materializes above your head, spinning for a moment before the image fades.||Character tugs lightly against her moon-filled pendant, sliding it back and forth along its chain. A faint dark grey orb materializes above her head and spins for a moment before the image fades.
|-
! RUB<br>''(Glamour not active)''
|Making sure to cover all four moons, you position your palm against your white ora pendant and quickly snap your hand back, causing each moon to spin within its casing. An ethereal white haze radiates outward from beneath your hand and blankets you in its light.||Character positions her hand over her white ora pendant and quickly snaps her hand back, causing some moons to spin within their casing. An ethereal white haze radiates outward from beneath her hand and blankets her in its light.
|-
! RUB<br>''(Glamour active)''
|The celestial moon pendant's effect is already activated.||N/A
|-
! SHAKE
|You grasp the pendant between your fingers and shake gently. As four miniature moons begin to rotate within their encasing, your vision distorts briefly.||Character grasps her pendant between her fingers and shakes it gently. As some miniature moons begin to rotate within their encasing, her pupils transform into white orbs and then return to normal.
|-
! LOOK<br>''(Glamour active)''
|Through an ethereal white haze, you see an elven Champion of Gosaena with pale as parchment skin and large, owlish gentian blue eyes.||Through an ethereal white haze, you see an elven Champion of Duskruin Arena with pale as parchment skin and large, owlish gentian blue eyes.
|}
{{top}}

==Additional Information==
===Bloodforge===
In order to change the pendant's metal/haze, a visit to the [[Bloodforge]] is necessary.

===Loresong===
: {| {{loresong}}
|- style="background:maroon; vertical-align: top; font-size: larger; color:white;"
! Loresong
! Reaction
|-
| After the first few words of your song leave your mouth, your ears go deaf and your vision falls black. Your lips continue to move, but you hear nothing at all, not even your own voice.
Scenery unfolds around you, and you find yourself standing at the base of the DragonSpine Mountains in front of a thin section of the Locksmehr River. The water has a faint tinge of red, and you notice something protruding from its bank. You kneel down and scoop up an oily stone, gazing curiously at its crimson-laced porous surface. In an unfamiliar gravelly voice, you murmur, "The Gods have answered, and they now share with us this gift from the blood ravine."
Your breathing slows and your muscles tighten to a point of paralysis. Time seems to speed up as if hundreds of years were passing before your eyes while you remain unable to move. The moons rise and fall in the sky, and hundreds of men and women visit the water's edge only to leave with sacks full of the red flint-like substance. With a blink, time slows and you feel your breathing return to normal as your muscles relax.
You glance down to see a dried river bed, and your hand is empty, no longer holding the treasured ur-barath stone.
| After finishing her song's verse, BARD drops to her knees, gazing down. She reaches toward the floor and scoops at the air, contemplating her empty hand. She stares intently, a distant look in her eyes.
|-
| You continue to sing, but you remain unable to hear your own words. Your surroundings are unfamiliar.
Three participants clothed in ripped cloth and bloodied armor stand before you, their heads bowed in respect. Hundreds of spectators cheer eagerly as they await your confirmation of the triumphant combatants. You glance down and take note of three silver and kelyn pendants in your hand, each filled with four miniature moons. You silently approach the trio, and in a methodical and practiced production, drape a pendant around each participant's neck. The winners fall to their knees as you recite, "Your physical prowess has proven you worthy of this gift from our Gods. Wear it with pride in remembrance of this day...the day you became a true Champion!" The rest of your words are drowned out by the cheering crowds who follow the victors out of the arena and toward a great temple.
Black clouds of dust obscure your vision, and all sounds cease. You feel incredibly disoriented.
| BARD maintains her lifeless gaze. An unfamiliar, gravelly voice escapes her lips as she speaks, "Your physical prowess has proven you worthy of this gift from our Gods. Wear it with pride in remembrance of this day...the day you became a true Champion!" A distant chorus of cheers, origin unknown, drowns out any further speech.
|-
| Words spill across your lips as they've done many times before, but you are still unable to hear your own voice.
A deep ominous rumble echoes in the distance. The ground begins to tremble and shake violently. A heavy downpour soaks the terrain. Suddenly, waves of mud and debris slide across the ground and engulfs the arena. The ground splits open and swallows the surrounding buildings including the sacred temple, suffocating them in a dark ocean of dust and rubble.
Tiny particles in the air force you to blink rapidly, but you are unable to see. You shut your eyes tight and rub them with clenched fists, sandy grit scraping across your cornea. You scream out in pain, but are unable to hear your own cries. Darkness surrounds you.
| BARD begins to sweat profusely. Her knees tremble and buckle beneath her as she struggles to maintain her balance. She reaches toward her face and claws at her eyes in obvious pain. She opens her mouth as if to scream, but nothing comes out.
|-
| As the sting in your eyes dissipates, you open your eyes to see an area - empty, overgrown, and with little sign of life. You struggle to bring yourself back to the present.
Standing before the devastated lands, time once again hastens and your body becomes immobilized. Bandits flood the area, structures rise from the ground, smoke billows into the sky -- signs that life has returned to the once ruined land at the blood ravine. Laying atop a small dirt mound, a tiny chunk of ur-barath lies in wait. You try to reach toward the stone, but are still unable to move. With your last bit of energy, you open your mouth and speak, in the same unfamiliar and gravelly voice, "Bloodriven..."
With a weak gasp for air, you collapse onto the ground, exhausted.
| BARD turns her head from side to side, her eyes darting rapidly back and forth as she watches something unfold. In the unfamiliar gravelly voice, she says, "Bloodriven..." before collapsing onto the floor.
|}
{{top}}

===Bloodrunes===
'''Bloodrunes''' can be used in conjunction with the Moon-filled Pendant in order alter the appearance of the illusion. Creating a bloodrune is done by using a [[Bloodrune#Flat Etched Stone | flat etched stone]], which is found in the [[Bloodriven Sewers | Sewers]], and then carving an ur-barath totem with a chisel. When a bloodrune is in use, it adds an additional line to the pendant's {{boldmono|SHOW}} description.

Bloodrunes, while in stone form, can be {{boldmono|TURN}}ed to prevent them from being sold to the archaeologist NPC. {{boldmono|MARK }}does not work with this item.

<blockquote><big>{{boldmono|LOOK}}</big>
<pre{{log2}}>
Long strands of silver and <metal> have been twisted together in a double rope pattern to create a sturdy, but elegant, neckchain. Four unembellished rings situated side-by-side dangle from the centermost point of the metal strands. All four rings contain a small glowing sphere that appears to spin slowly. <span style="color:red">''A bloodrune rests atop the four moons, secured by a luminescent, crimson-hued thread.''</span>
</pre></blockquote>

: <h4>[[Bloodrune#Classic | Classic]]</h4>
: Classic bloodrunes are the most common tier available. When added, the bloodrune adds an additional line to the glamour illusion of the pendant.
{| class="mw-collapsible mw-collapsed" id="mw-customcollapsible-classic"
|+ style="white-space:nowrap; padding-left: 2em; text-align: left;" | '''Effect: A(n) <rune> look washes over (his/her) face. [<span class="mw-customtoggle-classic" role="link" style="color:#0000ff">Expand</span>]'''
|-
| {{#section:Bloodrune|classic}}
|}

: <h4>[[Bloodrune#Divine | Divine]]</h4>
: Divine bloodrunes are the second most common tier able to be found in the sewers. Similar to the classic tier, they add a line to the MoonShard pendant's original glamour effect, and align with specific deities. A [[Blood-infused crystal#Divine | blood-infused crystal]] can be used to slightly alter the rune on divine bloodrunes, changing the moonshard pendant's base glamour from saying '''Champion of <Deity>''' to either '''Betrayer''' or '''Zealot'''.
{| class="mw-collapsible mw-collapsed" id="mw-customcollapsible-divine"
|+ style="white-space:nowrap; padding-left: 2em; text-align: left;" | '''Effect: Interspersed within the dim aura are miniature <item> that float around (him/her). [<span class="mw-customtoggle-divine" role="link" style="color:#0000ff">Expand</span>]'''
|-
| {{#section:Bloodrune|divine}}
|}

: <h4>[[Bloodrune#Arcane | Arcane]]</h4>
: Arcane bloodrunes are the third tier available, and were initially introduced during the August 2017 Duskruin run. Unlike the classic or divine, arcane bloodrunes change the entire glamour affect of the MoonShard pendant instead of adding a line at the end of it. [[Blood-infused crystal#Arcane | Blood-infused crystals]] can be used to change the location in the pendant's glamour from '''Bloodriven Village''' to what is the location associated with the rune on the crystal.
{| class="mw-collapsible mw-collapsed" id="mw-customcollapsible-arcane"
|+ style="white-space:nowrap; padding-left: 2em; text-align: left;" | '''Effect: Varies based on rune. [<span class="mw-customtoggle-arcane" role="link" style="color:#0000ff">Expand</span>]'''
|-
| {{#section:Bloodrune|arcane}}
|}

: <h4>[[Bloodrune#Mystic | Mystic]]</h4>
: Mystic bloodrunes are the final tier of more widely available bloodrunes. Similar to arcane bloodrunes, they were released in August 2017 and change the entire glamour effect of the MoonShard pendant. However, mystic bloodrunes have 4-5 versions that shift when worn.
{| class="mw-collapsible mw-collapsed" id="mw-customcollapsible-mystic"
|+ style="white-space:nowrap; padding-left: 2em; text-align: left;" | '''Effect: Varies based on rune. [<span class="mw-customtoggle-mystic" role="link" style="color:#0000ff">Expand</span>]'''
|-
| {{#section:Bloodrune|mystic}}
|}

: <h4>[[Bloodrune#Legendary | Legendary]]</h4>
: Legendary bloodrunes are the final tier of bloodrunes and are limited to a release of 1 per instance. Similar to arcane and mystic tiers, they change the glamour projected by a moonshard pendant. Additionally, they work with corresponding cloaks that are released during the same run but in alternate methods, such as the Treasure Trove.
{| class="mw-collapsible mw-collapsed" id="mw-customcollapsible-legendary"
|+ style="white-space:nowrap; padding-left: 2em; text-align: left;" | '''Effect: Varies based on rune. [<span class="mw-customtoggle-legendary" role="link" style="color:#0000ff">Expand</span>]'''
|-
| {{#section:Bloodrune|legendary}}
|}
{{top}}

===[[Blood-infused crystal | Blood-Infused Crystals]]===
Blood-infused crystals can be used to augment [[bloodrune]]s, which in turn can change how the MoonShard pendant's glamour appears.

: <h4>[[Blood-infused crystal#Divine | Divine]]</h4>
: Divine blood-infused crystals can be used to carve [[Bloodrune#Divine | divine]] bloodrunes only. Once carved and added to a MoonShard pendant, the bloodrune changes the base glamour of the pendant.
{| class="mw-collapsible mw-collapsed" id="mw-customcollapsible-divinecrystal"
|+ style="white-space:nowrap; padding-left: 2em; text-align: left;" | '''Effect: Slightly alters base glamour. [<span class="mw-customtoggle-divinecrystal" role="link" style="color:#0000ff">Expand</span>]'''
|-
| {{#section:Blood-infused crystal|divine}}
|}

: <h4>[[Blood-infused crystal#Arcane | Arcane]]</h4>
: Arcane blood-infused crystals can be used to carve [[Bloodrune#Arcane | arcane]] bloodrunes only. Once carved and added to a MoonShard pendant, the bloodrune changes the location shown in the pendant's glamour from '''Bloodriven Village''' to the location associated with the rune on the crystal.
{| class="mw-collapsible mw-collapsed" id="mw-customcollapsible-arcanecrystal"
|+ style="white-space:nowrap; padding-left: 2em; text-align: left;" | '''Effect: Changes location in glamour based on crystal rune. [<span class="mw-customtoggle-arcanecrystal" role="link" style="color:#0000ff">Expand</span>]'''
|-
| {{#section:Blood-infused crystal|arcane}}
|}
{{top}}

===[[Legendary Bloodrune Cloak]]===
'''Legendary Bloodrune Cloaks''' were first released back in February 2018 to enhance MoonShard pendants equipped with the corresponding [[Bloodrune#Legendary|legendary bloodrune]] found in [[Duskruin Arena]].
{{top}}

===Policy 7 Warning===
'''Posted by Wyrom 2016 Jul 1:'''
<div {{prettydiv}}>
Seems I have to post about a POLICY 7 issue that has come up.

It seems a few of the pendants that went out may have caused a bug that would leave the moon you tried to place inside it still in your hand. If this happened to you, please place an ASSIST and let us know, as well as turn over any moons that didn't physically go into the pendant. As of right now, we know there is one pendant that could still be completed. It's unclear as of right now if anyone used a buggy Makiri moon to complete a pendant. If you did, please tell us.

This also means people should be very leery of purchasing a Makiri moon from another player, should you be wishing to complete that final pendant that is out there. If you have the final Makiri moon and would like to confirm with me how legitimate it is, please email me (using the link to the left). If the golvern segment hasn't been combined, that would also be helpful to let me know.
</div>
{{top}}

==See Also==
* [[/saved posts|Saved posts]]
* [[Bloodrune]]
* [[Blood-infused crystal|Blood-Infused Crystal]]
* [[Legendary Bloodrune Cloak]]
* [[Bloodrune Holder]]
* [[Duskruin Arena]]

[[Category:Duskruin collectible items]]

Lich:Software/Installation

2026-03-18T16:16:14Z

HORIBU1: /* Parallels Windows */ now that Ruby 4+ runs on apple/mac, no need for older installer, updated to use latest.

{{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.15.1 supporting Ruby 4.0 - published March 16, 2026'''

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

====Lich 5.6 or older====
Please proceed to updating both Ruby and Lich 5

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

===Parallels Windows===
With the latest releases of Ruby4Lich5 installer, you can now follow the normal Windows installation for both Intel and Apple silicon based Apple computers.

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

The following steps are to be done AFTER you've successfully installed Wrayth/WizardFE and can login normally without Lich5 on the machine. Once you've done that and can successful connect normally, then follow these steps:
# Download and install [https://github.com/elanthia-online/lich-5/releases/latest/download/Ruby4Lich5.exe Ruby4Lich5.exe Installer] and use default options presented during install
# Double click the lich.rbw file that is now located in the extracted Lich5 location you did above. Login and play as usual.

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

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

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

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

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

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

Install Lich:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
</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 using Ruby's Gemfile that in included with Lich-5 now by using `bundle install` as shown below:
<pre>
echo "gem: --no-document" > ~/.gemrc
cd ~/lich-5
bundle install
</pre>

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

Install Lich:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
</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 using Ruby's Gemfile that in included with Lich-5 now by using `bundle install` as shown below:
<pre>
echo "gem: --no-document" > ~/.gemrc
cd ~/lich-5
bundle install
</pre>

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

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

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora
* 41 uses Ruby 3.3
* 42 uses Ruby 3.4
* 43 uses Ruby 3.4
All of which are currently compatible with Lich 5.7.0 or higher.

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

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

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

4. 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 using Ruby's Gemfile that in included with Lich-5 now by using `bundle install` as shown below:
<pre>
cd ~/lich-5
bundle install
</pre>

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

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

=Ecosystem Information=

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

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.13.5'''
<PRE>
### Bug Fixes (general)
* util.rb only show gem installing debug messaging if gem mis… (#1131)
* add --gs and --dr, refactor argv_options to helpers (#1133)
* fix multiple custom entries, improvements to yaml save (#1134)
* login_tab_utils.rb expand helper text show Warlock (#1135)
* update CLI for YAML security signature, add auto-convert fo… (#1136)
* remove password parameter from debug logging in all cases (#1137)
* reduce minimum GUI window footprint for non-tabbed view (#1138)
* remove double save in YAML to preserve yaml.bak integrity (#1139)

### Bug Fixes (gs)
* stash.rb additional improvements (#1132)
</PRE>
'''5.13.4'''
<PRE>
### Bug Fixes (general)
* force system gem install if RubyGems fails (#1126)
* gui_login prevent destroying window if already destroyed (#1127)
* add window size / position saves to login GUI (#1128)
* non tabbed saved entries in reduced button / font size (not… (#1129)
</PRE>
'''5.13.3'''
<PRE>
### Bug Fixes (general)
* account manager sorting GUI fix (#1123)
</PRE>
'''5.13.2'''
<PRE>
### Bug Fixes (general)
* install_gem_requirements update available gems after install (#1120)
</PRE>
'''5.13.1'''
<PRE>
### Bug Fixes (general)
* password_cipher.rb upcase account_name for key (#1118)

### Bug Fixes (dr)
* validator.rb change sleep to should_sleep named param (#1116)

### Bug Fixes (gs)
* add base stats capture from 'info full' command (#1115)
</PRE>
'''5.13.0'''
<PRE>
### Features (general)
* Refocus Frontend (#960)
* socket configurator to better guard TCPSocket (#976)
* add simplified DB maintenance (#991)
* TextStripper module support for XML, HTML, Markdown (#1055)
* Login modernization and refactor to yaml (#1063)
* Ruby Memory Releaser module (#1066)

### Features (dr)
* support meta:trashcan tag for DRCI.dispose_trash (#966)
* Add GameObj.inv support for DR items (#1080)
* DRCS allow custom adjective for summoned weapons (#1088)
* DRParser support for new exp window xml stream elements (rested exp, tdps, favors) (#1104)

### Features (gs)
* Add Armaments (Weapon, Armor, and Shield) Module (#911)
* add creature module, including Hinterwilds creatures (#1002)
* Creature module combat tracking (#1003)
* track time of last total_experience record (#1030)
* add Injured class for checking ability to perform actions (#1035)

### Bug Fixes (general)
* map dijkstra optimization (#1061)
* update.rb keep script/data file incase of error on update (#1070)
* ensure proxy path is set for non-destructive array write-th… (#1073)
* [lib][global-defs] - move update (#1079)
* GameObj force new objects ID to be string (#1087)
* xmlparser.rb gate GSL exits sending behind @send_fake_tags (#1103)
* change Hash[] pair key conversion to use to_h for Ruby 4.0 (#1108)
* move gui-login.rb to Ruby standard gui_login.rb (#1111)
* update location for currency and move game-loader.rb to Ruby standard gameloader.rb (#1112)

### Bug Fixes (dr)
* DRCA allow custom spell prep messaging (#1089)
* Update Slackbot error handling, and lnet management (#1091)
* Fix exp mods parsing for DR (#1102)
* equipmanager.rb support for custom messaging in forester's longbow (#1105)
* Fix hang in equipment manager when game doesn't respond to commands (#1110)

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

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

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

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

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

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

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

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

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

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

Lich:Script Bigshot

2026-03-17T16:01:33Z

HORIBU1: /* PSM3 Integration */ remove rebuke/scourge/momentum as only command checks

{{3rd-party}}
Bigshot is a fully automated hunting script for GemStone IV. It handles combat routines, movement to and from hunting areas, target selection, and attack execution.
AFK scripting on any server other than Shattered is a violation of game policy.
{{TOCright| limit=2}}
==Changelog==
*[[Script Bigshot/Changelog|Script Bigshot Changelog]]
==About Bigshot==
===What Does Bigshot Do?===

Using a series of menus and command inputs, Bigshot lets you create a modular, customizable, and fully automated hunting script. With just a few clicks and tweaks, you can go from scripting rats to the Rift.

===How Do I Get It?===

Grab it from the repository: <CODE>;repository download Bigshot</CODE>

===How Do I Make It Go?===
Initial setup is accessed through <CODE>;bigshot setup</CODE>. This opens a configuration window with several tabs for setting up your hunting routine.

As with most scripts, the SETUP command opens a graphical user interface. Use <CODE>;bigshot setup</CODE> to open the dialog. The window contains the following tabs:
* '''Profile''' - Save and load profile configurations. Profiles are saved to your <CODE>\Lich5\data\<GSServer>\<charname>\bigshot_profiles</CODE> directory (e.g., <CODE>\Lich5\data\GSIV\Rinualdo\bigshot_profiles</CODE>). Note: if you previously used Bigshot, the file location has changed from the old <CODE>\Lich5\scripts\bigshot_profiles</CODE> folder. You can copy/paste your old profiles to the new location.
* '''Resting''' - Configure your resting routine, rest location, and conditions that trigger resting.
* '''Hunting''' - Create a hunting map using boundaries, set your starting room, configure attack/wander stances, and define pre-hunt behavior.
* '''Attacking''' - Configure ambush aiming, flee conditions, bless behavior, weapon reactions, and similar combat flags.
* '''Commands''' - Define your valid targets and associated attack routines. See sample routines below.
* '''Boon Creatures''' - Configure how Bigshot handles boss/boon creatures on a per-ability basis (fight, ignore, or flee).
* '''Misc''' - UAC options, MSTRIKE options, ammo/wand configuration, and MA grouping settings.
* '''Monitoring''' - Interaction monitoring, deadman's switch, depart behavior, and debug options.

Each tab is covered in detail further on.

===Other Commands===
Beyond the setup GUI, Bigshot has several command-line options:
* <CODE>;bigshot quick</CODE> - A special hunting mode that kills everything in your current room, then quits. It will not wander or attempt to rest. Uses its own separate hunting commands and targets (configured on the Commands tab).
* <CODE>;bigshot head</CODE> / <CODE>;bigshot tail</CODE> - Multi-account hunting on a single computer. All characters must be set up for the same hunting area. Following characters run <CODE>;bigshot tail</CODE>, then the leader runs <CODE>;bigshot head</CODE>. The leader can optionally specify the expected group size, e.g., <CODE>;bigshot head 3</CODE>. Head and tail can be started in any order.
* <CODE>;bigshot display</CODE> - Shows all your current settings.
* <CODE>;bigshot reset</CODE> - Resets your targetable and untargetable lists. Useful if Bigshot will not target something it should.
* <CODE>;bigshot ranger</CODE> or <CODE>;bigshot companion</CODE> - Resets the ranger companion setting so you can reconfigure it. Use this when you change your companion.
* <CODE>;bigshot profile save <name></CODE> - Saves a profile in YAML format to your character's profile folder. Also accessible via the Profiles tab.
* <CODE>;bigshot profile load <name></CODE> - Loads a profile from your character's profile folder. Also accessible via the Profiles tab.
* <CODE>;bigshot single</CODE> - Executes a single hunting routine, returns to your resting location, and then exits.
* <CODE>;bigshot list</CODE> - Displays all initialized variable values (useful for troubleshooting).
* <CODE>;bigshot test <method> <args></CODE> - Runs a specific internal method for testing purposes.
* <CODE>;bigshot <creature></CODE> - Any input that does not match the above commands defaults to ranger tracking (e.g., <CODE>;bigshot single giant rat</CODE> will track and hunt a giant rat).

==The Profile Tab==
* '''Load Profile''' - Load an existing saved profile. The dropdown will be empty if no profiles have been saved yet.
* '''Current Profile''' - Displays the name of the currently loaded profile.
* '''Save Profile''' - Enter any name for your profile and click Save. Once saved, the profile will appear in the Load Profile dropdown.
* '''Notes''' - A freeform text area for any notes you want to associate with the profile.

==The Resting Tab==
This tab controls where and how Bigshot rests between hunts. During rest mode, Bigshot checks your mind state, hit points, wound status, mana, and spirit. Once all conditions defined in the "Should Hunt?" section are met, Bigshot leaves rest mode and begins a new hunt.

===Where to Rest===
* '''room id''' - The room Bigshot returns to for resting. Uses room numbers from Map/Go2. Supports both Lich IDs and SimuIDs (prefix SimuIDs with "u", e.g., <CODE>228</CODE> for Town Square Central or <CODE>u7120</CODE>).
* '''return waypoints''' - Optional intermediate room IDs that Bigshot will pass through when returning to rest. Separate multiple waypoints with commas.
* '''pre-rest commands''' - Commands executed before entering rest mode. Example: <CODE>shea, wear shield, sit, stance offensive, rest</CODE>. This will sheathe your weapon, wear your shield, sit down, enter offensive stance, and use the REST verb. You can also call scripts here using the <CODE>script</CODE> prefix, e.g., <CODE>script go2 place</CODE>.
* '''active resting scripts''' - Scripts that run upon entering rest mode for between-hunt tasks such as selling loot, spelling up, or healing. Example: <CODE>eloot sell, waggle, eherbs</CODE>. This will sell via eloot, spell up via waggle, then use herbs from your PACK to heal wounds.
* '''Fog Option''' - Determines how Bigshot returns to rest. Options include:
** '''None''' - Walk normally (no teleportation).
** '''130''' - Uses [[Spirit Guide (130)]] first; falls back to Symbol of Return if it fails.
** '''Symbol of Return''' - Uses Voln [[Symbol of Return]] first; falls back to 130 if it fails.
** '''Traveler's Song (1020)''' - Attempts [[Traveler's Song (1020)]] once, then continues.
** '''Familiar Gate (930)''' - Attempts [[Familiar Gate (930)]] to summon a portal and walk through it. Will perform a mana pulse if not enough mana is detected.
** '''Sigil of Escape''' - Uses [[Sigil of Escape]].
** '''Custom''' - Allows a comma-separated list of custom commands to perform.
* '''Fog ONLY if wounded or encumbered''' - When checked, Bigshot will only use the fog option if you are actually wounded or encumbered. Otherwise it walks normally.
* '''Fog twice from the Rift''' - When checked, Bigshot will double-cast the fog spell when returning from the Rift (useful since the Rift requires two uses to escape).

===Should Rest?===
Bigshot evaluates these conditions to decide when to leave a hunt and return to rest.
* '''when percent mind >='''
** Triggers resting when your mind has reached this threshold. Generally set to 100 (fried). Default is 100.
* '''and extra kills >='''
** The number of additional monsters to kill after reaching your "when percent mind" threshold and after LTE boosts are used. Set to 0 to rest immediately upon reaching the mind threshold.
* '''and used lte boosts >='''
** The number of LTE (Long-Term Experience) boosts Bigshot will attempt to use after reaching the mind threshold. Set to 0 to skip LTE boosts entirely.
* '''or percent mana <='''
** Forces Bigshot to rest when your mana percentage is at or below this value. Can be set to 0, but leaving a small buffer is useful (e.g., for Unlock (406) to open the WL Graveyard gate). If you encounter an "OOM" error, try setting this to 1.
* '''or percent encumbrance >='''
** Forces Bigshot to rest when your encumbrance reaches or exceeds this percentage.
* '''or wounded eval'''
** Allows you to set a Ruby evaluation expression to determine if you are too wounded to continue. Can trigger on bleeding, specific wound levels, inability to cast, scars, and more.

The following is a wounded evaluation that will rest whenever you have any level II wounds:
<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || Char.percent_health <= 70</PRE>
The following is a wound evaluation that will take you home if you can no longer cast (bleeding, nerves, level 2 head/eyes, bad scars, etc.):
<PRE>bleeding? || Char.percent_health <= 25 || [Wounds.head, Scars.head, Wounds.leftEye, Scars.leftEye, Wounds.rightEye, Scars.rightEye, Wounds.nsys, Scars.nsys].max > 1 || [Wounds.leftArm, Wounds.leftHand, Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand, Scars.rightArm, Scars.rightHand].max > 2 || ([Wounds.leftArm, Wounds.leftHand, Scars.leftArm, Scars.leftHand].max + [Wounds.rightArm, Wounds.rightHand, Scars.rightArm, Scars.rightHand].max) >= 3</PRE>
The following can be appended to either wound evaluation above to also rest upon having popped muscles:
<PRE>|| Effects::Debuffs.active?("Overexerted")</PRE>

* '''when creeping dread >='''
** Forces Bigshot to rest when your creeping dread level reaches or exceeds this value.
* '''when crushing dread >='''
** Forces Bigshot to rest when your crushing dread level reaches or exceeds this value.
* '''Wall of Thorns Poison'''
** Forces Bigshot to rest when you are affected by Wall of Thorns poison.
* '''Confusion Debuff'''
** Forces Bigshot to rest when you are affected by the non-dispellable Confusion debuff.
* '''Box in hand'''
** Forces Bigshot to rest if looting leaves a box in your hand.

==The Hunting Tab==
This tab controls when and where Bigshot hunts, any pre-hunt preparation, and the map boundaries for wandering.

===The Hunting Map===
Your hunting map consists of '''Boundaries''' (rooms Bigshot will never enter) and a '''Starting Room''' (the first room Bigshot moves to when a hunt begins). These function similarly to the boundaries in the ;Wander script, but are stored in Bigshot's own configuration files.

* '''starting room ID''' - The first room Bigshot travels to when beginning a hunt. Set this to any room within your boundaries.
* '''boundary rooms''' - Rooms that act as walls. Bigshot will never enter a boundary room.

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>

In the diagram above, "B" is a boundary room and "A" is outside the hunting area. Rooms marked "0" are the huntable area. Bigshot will wander freely among the "0" rooms but never cross into "B" or "A".

Boundary room IDs are separated by commas. Some popular examples:

'''Rift Boundaries:'''
<PRE>
Plane 1: 2635, 12101, 12208
Plane 2: 2605, 2635, 12093
Plane 3: 2635, 12089, 12152
Plane 4: 12122, 12207, 12235
Plane 5: 2579
North Scatter: 12151, 12254, 12256, 12249, 12247, 12241
South Scatter: 12151, 12219, 12217, 12233, 12237, 12239
</PRE>

'''Maaghara Boundaries:'''
<PRE>9734</PRE>

'''Confluence Boundaries:'''
<PRE>2300, 3519, 228, 188, 1932, 10855, 3668, 1438, 1005</PRE>

Imagine a hunting area that is a six-room square. To enter this square, you must GO DOORWAY from room A. You would set room A (outside the square, before the doorway) as a boundary. Then set room B (just inside the square) as the starting room. Bigshot will move to room B and wander within the bounded area until your "Should Rest?" conditions are met.

* '''rally point rooms''' - Optional intermediate room IDs Bigshot will pass through on the way to the hunting area. Separate multiple rooms with commas.

===Hunting Settings===
* '''wait before wandering to another room''' - Time in seconds Bigshot waits before leaving a room to look for creatures. Default is 0.3. Set to 0 for fastest (but spammy) movement.
* '''attack stance''' - The stance Bigshot switches to when issuing attack commands. Bigshot remains in defensive stance until an attack is triggered, then stances to your specified attack stance. Recognizes all game stances from Offensive through Defensive.
* '''wander stance''' - The stance Bigshot uses while moving between rooms. Defaults to Defensive.
* '''stand up stance''' - The stance Bigshot enters when standing up after being knocked down. Defaults to Defensive.
* '''pre-hunt commands''' - Commands executed before Bigshot uses Go2 to travel to your starting room. Example: <CODE>gird, stance defensive</CODE>. This ensures your weapon is readied and you are in defensive stance before traveling. Use this line for short-lived combat spells like 1605 (Arm of the Arkati).
* '''active hunting scripts''' - Scripts that run while Bigshot is in hunt mode. Use these for complex behaviors that Bigshot does not natively support (e.g., keeping certain spells active or executing CMANs based on conditions).
* '''society abilities/spells/cmans''' - Abilities Bigshot keeps active during a hunt. Enter numerical designations separated by commas. For example, entering <CODE>506</CODE> keeps Haste up, recasting whenever it wears off. Hover over this field in the GUI for a list of supported values. Supported options include spells that can be ignored by rapidfire cooldown: e.g., <CODE>515 (ignore)</CODE> or <CODE>rapidfire (ignore)</CODE>.
* '''loot script''' - The script Bigshot calls to loot your kills (e.g., <CODE>eloot</CODE>). Make sure the loot script is properly configured via its own SETUP command, or Bigshot may error.
* '''wracking spirit >=''' - If your spirit is greater than or equal to this value, Bigshot will WRACK for mana. Setting it to 6 will wrack down to 5 spirit. Only functions when the wracking checkbox is enabled.
* '''Use sign of wracking/sigil of power''' - Checkbox to enable wracking.
* '''Check for favor before using Voln symbols''' - Checkbox to verify you have sufficient favor before casting Voln society symbols.
* '''Priority hunt''' - When enabled, Bigshot targets creatures in the order listed in your valid targets field. If a higher-priority creature enters the room, Bigshot switches to it. When using <CODE>;bigshot quick</CODE>, quickhunt targets take priority, followed by any remaining targets in room order.
* '''Delay looting''' - Delays the looting of creatures in a room.
* '''Defensive stance before looting''' - Switches to defensive stance before looting begins.
* '''Pull players to feet''' - Attempts to pull players to their feet when passing them.
* '''Stop for dead players''' - Pauses Bigshot if you encounter a dead player.
* '''Troubadour's Rally''' - Enables the use of Troubadour's Rally during hunts.
* '''Sneaky Sneaky''' - Sneak around while moving through the hunting area.

===Should Hunt?===
Bigshot evaluates these conditions to determine if you are ready to begin a hunt from rest.
* '''when percent mind <='''
** Setting this to 51 will wait until "Clear". Setting it to 65 will wait until "Muddled".
* '''and percent mana >='''
** The percentage of your maximum mana that must be present before hunting. Setting below 50 results in short hunts if you cast frequently. Generally set to 95 or higher.
* '''and CHECK spirit >='''
** Bigshot checks that your current spirit value is at least this amount. Make sure this is high enough that Bigshot will not immediately hunt after DEPARTing if you have the "Depart / re-run" option enabled on the Monitoring tab.
* '''and percent stamina >='''
** The percentage of your maximum stamina that must be present before hunting. Useful for melee-heavy builds that rely on stamina for CMANs and MSTRIKEs.

==The Attacking Tab==
This tab controls aiming, flee conditions, and various combat behavior toggles.

* '''Ambush aiming locations (head, etc)''' - The order Bigshot aims when ambushing. Default is head, right leg, left leg, chest. Bigshot cycles through these and skips locations that are too injured or unreachable.
* '''Archery aiming locations (head, etc)''' - The order Bigshot aims when using archery attacks. Loops through your aiming list.
* '''flee if enemy count is >''' - Flees the room if the total number of enemies exceeds this value. Set to 1 to engage only single targets.
* '''...but don't count these''' - Bigshot ignores these monsters when evaluating flee count. Useful when low-level monsters are mixed into your hunting area.
* '''...and always flee from''' - Bigshot immediately flees from these monsters. Useful when your hunting area has higher-level or dangerous monsters mixed in.
* '''flee from environment message''' - Bigshot flees whenever the game sends a message matching this text (uses XML regex matching).
* '''wait before wandering to another room''' - Time in seconds before moving to a new room. Default is 0.3. Set to 0 to move instantly (can be spammy for others in the area).
* '''Approach lone targets only''' - Forces Bigshot to only begin combat against creatures that are alone in a room.
* '''Bless weapon?''' - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on any weapon that loses its bless during hunting. If unable to bless during hunting, Bigshot returns to the rest area and quits.
* '''Activate weapon reactions''' - Initiates reactive strikes when the opportunity presents itself.
* '''Flee from clouds''' - Flees from cloud spells such as 125 (Call Lightning/Ominous Cloud), 1704 (Stun Cloud), and 1713 (Death Cloud).
* '''Flee from vines''' - Flees from vine spells such as 610 (Tangle Weed).
* '''Flee from webs''' - Flees from webs.
* '''Flee from voids''' - Flees from voids.

==Commands Tab==
This is the core of Bigshot — where you define your attack routines.

===Hunting Commands===
* '''hunting commands (a)''' - The primary commands Bigshot executes when in a room with a valid target. Commands are separated by commas. Bigshot recognizes most hunting verbs; unrecognized commands are sent directly as-is via fput. The following are recognized hunting commands:
** '''kill''' - Attacks using the KILL verb.
** '''incant <spell number>''' - Casts the specified spell with INCANT. Automatically stances into offensive for bolt and stance-sensitive spells. You can CHANNEL via <CODE>INCANT SET CHANNEL <spell></CODE> (a standard GSIV verb) or by setting <CODE>SET ChannelIncant ON</CODE>, which will CHANNEL an INCanted spell if you are in a stance higher than neutral.
** '''channel <spell number>''' - Channels the specified spell at the target. Requires a stance higher than neutral to have effect.
** '''<spell number>''' - Casts the specified spell using PREPARE and CAST.
** '''wand''' - Gets a wand from your specified container and WAVEs it at the target.
** '''wandolier''' - Similar to wand, but designed for wandoliers. Gets a wand from the fresh wand container and waves it; rubs the container if no wands are found. Default waves in offensive stance. Use <CODE>wandolier defensive</CODE> to wave in a different stance.
** '''fire''' - Gets ammunition from your specified container and FIREs at the target. Aims based on Archery aiming settings on the Attacking tab.
** '''aim <location>''' - Aims at the specified body location.
** '''ambush''' - Uses the AMBUSH verb to attack, aiming based on Attacking tab settings. Can also aim dynamically: <CODE>ambush head</CODE> overrides default settings for that attack.
** '''wait <time>''' - Stance dances by going into Defensive stance for the specified time (in seconds). Bigshot will exit early if the target swings or casts, then evaluate the rest of the attack routine from your attack stance.
** '''mstrike''' - Executes MSTRIKE based on cooldown and stamina. Has its own options page under the Misc tab. Can also be used with UAC: <CODE>mstrike punch</CODE>.
** '''berserk''' - Executes the BERSERK verb and waits until it fades.
** '''throw''' - Empties hands, attempts throw, then retrieves the items you emptied.
** '''weed/kweed''' - Casts 610 at the target. Using <CODE>kweed</CODE> forces EVOKE 610, ensuring the damage version.
** '''curse <type>''' - Preps 715 and uses the specified curse type. Valid types: Clumsy, Weakness, Darkness, Itch, Hex, Pox, Nightmare, Star. Skips "curse star" if the buff is already active.
** '''unarmed <type>''' - Uses the Bigshot UAC routine. Valid types: punch, jab, kick, grapple. The routine uses appropriate attacks to rank up and applies MSTRIKE based on MSTRIKE options. Example: <CODE>unarmed jab</CODE>.
** '''smite''' - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on the target until successful.
** '''leech''' - Performs a [[Mana Leech (516)]] on the target if cooldown is under 15 minutes.
** '''script <script name>''' - Executes a specified custom attack script.
** '''hide''' - Repeatedly attempts to hide until successful or gives up.
** '''sleep <nostance>''' - Pauses Bigshot for the specified number of seconds. Example: <CODE>sleep 10</CODE> or <CODE>sleep 10 nostance</CODE>. Useful for timed hunting, e.g., <CODE>410, sleep 15</CODE> will E-wave, then wait 15 seconds before re-evaluating.
** '''stance <stance>''' - Changes stance. Example: <CODE>stance defensive</CODE>.
** '''nudgeweapons''' - Moves all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** '''force <cmd> until <endroll>''' - Repeats a command until a desired endroll is achieved. Example: <CODE>force incant 1002 until 101</CODE>. Only works for standard swings/spells/CMANs.
** '''eachtarget <cmd>''' - Issues the command against each valid target in the room.
** '''efury <fire|cold>''' - Casts Earthen Fury (917) on the target and waits for the DOT to end or 12 seconds to pass.
** '''caststop <spell>''' - Casts the spell and immediately stops it after casting.
** '''wield <noun> <left|right>''' - Wields a new item in the specified hand and stores the current item.
** '''store''' - Stores items in left, right, or both hands (only if something is in those hands).
** '''tether <recast>''' - Casts 706 with built-in wait logic. The optional <CODE>recast</CODE> flag will auto-recast 706 on creature death and transfer DOTs to a new target.
** '''unravel <spell>''' - Casts 1013 (Song of Unravelling). Optionally specify a spell number to target against the creature.
** '''depress''' - Casts 1015 (Song of Depression) with built-in logic.
** '''phase''' - Force-casts 704 (Phase) using PREP/CAST, required for NPC targeting to convert non-corporeal to corporeal undead.

===Additional Command Sets===
* '''hunting commands (b) through (j)''' - Additional attack routines tied to creature flags. When you flag a creature in your valid targets (e.g., <CODE>niirsha(b)</CODE>), Bigshot uses the matching command set. This allows different attack strategies for different creature types.
* '''fried hunting commands''' - Commands executed specifically when your mind is fried. Useful in group hunting where you still want to contribute.
* '''quick hunting commands''' - Commands executed when using <CODE>;bigshot quick</CODE>.
* '''valid targets''' - The monsters you are hunting. Bigshot works best with creature NOUNs (e.g., <CODE>ogre</CODE> instead of <CODE>a large ogre</CODE>). Use commas to separate multiple targets: <CODE>manticore, thrak</CODE>. If left blank, Bigshot will target everything in the room. Supports regex for advanced matching.
* '''quickhunt targets''' - Designated targets for the <CODE>;bigshot quick</CODE> option.

===PSM3 Integration===
Bigshot supports weapon/shield skills and warcries. Assaults wait until they finish or are interrupted. The following are recognized PSM3 commands:

'''Assaults''' (wait until completed/interrupted):
* barrage, flurry, fury, gthrusts, pummel, thrash
* fury can specify a default attack: <CODE>fury punch</CODE> or <CODE>fury kick</CODE> (defaults to jab)

'''Setups''' (execute on cooldown — pair with prone/stun/root checks):
* charge, cripple, dizzyingswing, pindown, twinhammer

'''AOE''' (execute on cooldown — limit with mob checks):
* clash, cyclone, pulverize, volley, wblade, whirlwind

'''Warcries:'''
* '''shout''' - Performs warcry Shout. Must use a command check or it will shout every loop: <CODE>shout(!shout)</CODE> or <CODE>shout(buff10 s25)</CODE>
* '''yowlp''' - Performs warcry Yowlp. Must use a command check: <CODE>yowlp(!yowlp)</CODE> or <CODE>yowlp(buff10 s10)</CODE>
* '''holler''' - Performs warcry Holler, taunting all mobs. Example: <CODE>holler(s60)</CODE>
* '''bellow, growl, cry''' - Offensive warcries. Use with <CODE>target</CODE> for single target or <CODE>all</CODE> for AOE.

'''Shield Skills:'''
* shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw

'''Combat Maneuvers:'''
* '''surge''' - Keeps Surge of Strength active. <CODE>surge</CODE> or <CODE>surge(surge)</CODE> casts even on cooldown; <CODE>surge(!surge)</CODE> only casts when not on cooldown.
* '''bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, disarm, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kifocus, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick'''
* '''dislodge <location>''' - Dislodge from the specified location: <CODE>dislodge eye neck</CODE>
* '''stomp''' - Performs a stomp attack. Channels 909 if not already active. You can also add 909 to the society abilities field to keep it active.
* '''dhurl''' - Hurls your weapon and recovers it. Works with weapon bonding auto-return and the RECOVER verb.
* '''assume <aspect> <aspect/evoke>''' - Cycles between two aspects, or evokes a single aspect. Also works in the society abilities box: <CODE>650 <aspect> <aspect/evoke></CODE>
* '''briar <weapon>''' - Activates the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
* '''stance perfection''' - Put 10, 20, 30, etc. in your attack stance box to take advantage of stance perfection.
* '''chastise, excoriate''' - Performs the FEAT if available and affordable.

===Gemstone Activation===
To use a gemstone-activated ability, use <CODE>jewel <mnemonic></CODE>. Bigshot automatically avoids usage if the ability is on cooldown. Supported gemstone mnemonics:
* bloodboil - Blood Boil
* spellblade - Spellblade's Fury
* arcascend - Arcanist's Ascendancy
* geospite - Geomancer's Spite
* forceofwill - Force of Will
* arcaneintensity - Arcane Intensity
* arcaneopus - Arcane Opus
* bloodsiphon - Blood Siphon
* bloodwell - Blood Wellspring
* epossess - Evanescent Possession
* manawellspring - Mana Wellspring
* spiritwell - Spirit Wellspring
* stamwell - Stamina Wellspring
* terrortribute - Terror's Tribute
* arcblade - Arcanist's Blade
* arcwill - Arcanist's Will
* imaerabalm - Imaera's Balm
* reckless - Reckless Precision
* unearthchains - Unearthly Chains
* witchhunt - Witchhunter's Ascendancy
* manashield - Mana Shield
* arcaneaegis - Arcane Aegis

You may need to run '''SKILLS FULL''', '''CMAN INFO''', '''WEAPON INFO''', or '''SHIELD INFO''' if you have recently changed training or if skills are being skipped.

===Additional Options===
* '''haste''' or '''506''' - Placing this in front of any command casts 506 (Haste) before executing the command. Only casts if Haste is not currently active or has less than 3 seconds remaining.
<PRE>wait 10, haste kill (x3)</PRE>
* '''slayer''' or '''240''' - Placing this in front of any command casts 240 before executing. Will not recast if already active.
<PRE>slayer 302 (x99)</PRE>

===Command Checks===
Command checks let you add conditions to any command. The format is:
<CODE>COMMAND (CHECKS)(REPETITIONS)</CODE>

Example: <CODE>hamstring (mob1 prone)(x2)</CODE>. The (x#) repetition must be in a separate set of parentheses. Note that (xx) is shorthand for (x5), not unlimited.

Checks can be combined inside a single set of parentheses with spaces between them. Example: <CODE>kill(m20 s5 e20)</CODE>

Each check also has an inverse — prefix with <CODE>!</CODE> to negate. Example: <CODE>kill(!m20 !s5 !e20)</CODE>

====Resource and Status Checks====
* '''s#''' - Requires at least # stamina.
* '''m#''' - Requires at least # mana.
* '''h#''' - Requires health to be at or above #% (percentage, not fixed).
* '''v#''' - Requires at least # spirit.
* '''e#''' - Requires encumbrance percentage to be at or below #.
* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).

====Creature Checks====
* '''mob#''' - Requires at least # NPCs in the room. Only useful for 2 or more creatures.
<PRE>To further clarify the mob# implementation:
1 mob, mob2: 1 IS less than 2 — attack does NOT proceed.
2 mobs, mob2: 2 IS NOT less than 2 — attack CAN proceed.
1 mob, !mob2: 1 IS NOT more than 2 — attack CAN proceed.
2 mobs, !mob2: 2 IS NOT more than 2 — attack CAN proceed.
3 mobs, !mob2: 3 IS more than 2 — attack does NOT proceed.</PRE>
* '''valid#''' - Like mob#, but only counts valid targets you are actively targeting in current settings.
* '''tier#''' - Checks your current UAC tier (1, 2, 3). Performs the command if your tier is equal to or greater than #. <CODE>(!tier3)</CODE> skips the command at tier 3.
* '''prone''' - Checks that the target is NOT sleeping, webbed, stunned, kneeling, sitting, lying down, prone, frozen, or held in place. Performs the command if none of those apply.
* '''frozen''' - Similar to prone but broken out separately. Useful for archers against non-corporeal creatures that deflect ranged attacks. Corporeal creatures that are stunned will break this check.
* '''undead''' - Performs the command if the target is undead.
* '''flying''' - Performs the command if the target is flying.
* '''rooted''' - Performs the command if the target is rooted.
* '''noncorporeal''' - Performs the command if the NPC is [[noncorporeal|non-corporeal]] undead.
* '''ancient''' - Checks for grizzled/ancient creatures.

====Self Checks====
* '''hidden''' - Performs the command if you are currently hidden.
* '''poison''' - Performs the command if you are currently poisoned.
* '''disease''' - Performs the command if you are currently diseased.
* '''pcs''' - Performs the command if there are PCs in the room that are not in your group.
* '''outside''' - Performs the command if the room is outdoors.
* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.

====Timing Checks====
* '''once''' - Performs the command once per target. Resets on room change.
* '''room''' - Performs the command once per room. Resets on room change.

====Buff Checks====
* '''barrage''' - Checks for the Enhanced Dexterity buff from Barrage.
* '''fury''' - Checks for the Enhanced Constitution buff from Fury.
* '''flurry''' - Checks for the Slashing Strikes buff from Flurry.
* '''pummel''' - Checks for the Concussive Blows buff from Pummel.
* '''thrash''' - Checks for the Forceful Blows buff from Thrash.
* '''vigor''' - Checks for the Tangleweed Vigor buff.
* '''reflex''' - Checks for the Arcane Reflex buff from Nature's Touch.
* '''tailwind''' - Checks for the Tailwind buff from Breeze.
* '''shout''' - Checks for the Empowered buff from Shout.
* '''yowlp''' - Checks for Yertie's Yowlp buff from Yowlp.
* '''holler''' - Checks for Horland's Holler buff from Holler.
* '''voidweaver''' - Checks for the Voidweaver buff from Implosion (720).
* '''justice''' - Checks for charges of Swift Justice. <CODE>(justice)</CODE> acts with charges; <CODE>(!justice)</CODE> acts with no charges.
* '''surge''' - Checks for Surge of Strength buff.
* '''rebuke''' - Checks for Righteous Rebuke buff.
* '''scourge''' - Checks for Ardor of the Scourge buff.
* '''momentum''' - Checks for Glorious Momentum buff.
* '''coupdegrace''' - Checks for the Empowered buff from Coup de Grace.
* '''animate''' - Checks for whether you have an animate present.
* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds. Supported for barrage, bearhug, coupdegrace, fury, flurry, pummel, thrash, shout, yowlp, garrote.
* '''censer''' - Attempts to cast 320 before your command, checking mana and cooldown. Examples: <CODE>309(censer)</CODE>, <CODE>335(censer mob3)</CODE>, <CODE>attack(censer)</CODE>
** If the command is a spell, censer only casts if you have mana for both 320 and the spell.
** If the command is not a spell, censer only checks you have enough mana for 320.

====Effects Checks====
* '''ES"Effect to Track"''' - Checks if the Effects::Spells effect is active
* '''EB"Effect to Track"''' - Checks if the Effects::Buffs effect is active
* '''EC"Effect to Track"''' - Checks if the Effects::Cooldowns effect is active
* '''ED"Effect to Track"''' - Checks if the Effects::Debuffs effect is active

===Example Attack Routines===
<PRE>wait 10, kill (x3)</PRE>
Waits 10 seconds for the monster to swing or cast, then counter-attacks from your specified attack stance. Swings three times, then goes back to defensive and waits again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>
Waits 15 seconds, then INCants 505 (Hand of Tonis) to knock down or stun the target. Follows up with repeated casts of 903 (Minor Water) until the target is dead (up to 5 times).

<PRE>stance defensive and incant 1615, kill (x100)</PRE>
Casts 1615 (Divine Strike) from defensive stance, then uses KILL continuously until the target is dead or 100 swings (whichever comes first).

<PRE>force feint until 101, kill (x2)</PRE>
Uses FEINT against the target until a successful endroll, then hits twice before trying FEINT again.

<PRE>stance defensive and hide, ambush left leg</PRE>
Hides from defensive stance, then ambushes the target's left leg. Repeats (hides again) after roundtime.

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>
Casts 720 (Implosion) if you have 50+ mana, then INCants 708 (Limb Disruption) at the default aim location, then channels 702 (Mana Disruption) up to 5 times or until dead.

<PRE>prep 708, cast at left leg / prep 708 channel at left leg, incant 719 (m50)(x1), incant 702 (xx)</PRE>
Prepares 708 and CASTs at the left leg. The second variant prepares and CHANNELs at the left leg. Then casts 719 (Dark Catalyst) once if 50+ mana. Finally, INCants 702 until the creature is dead.

<PRE>wait 30, unarmed punch</PRE>
Waits 30 seconds or until the target attacks, then begins UAC combat using Punch to tier up.

<PRE>shield charge (s15 prone), ambush, mstrike</PRE>
Shield charges the target if you have 15+ stamina and the target is NOT prone. Then ambushes based on Attacking tab settings (cycling through configured aim locations). Then MSTRIKEs — focused if below the creature threshold, unfocused if at or above it. Use <CODE>mstrike target</CODE> to always focus, or set unfocused threshold very high.

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>
AOE bellows, then Whirling Blade if 3+ targets. Flurries if the Slashing Strikes buff is not active. Falls back to basic attack.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>
Taunts with Holler, Shield Throws if 3+ targets, Flurries on cooldown, Thrashes on cooldown, and attacks as a fallback.

<PRE>shroud(s35 !hidden mob2), divert (s25 hidden mob2), ambush(hidden), flurry, attack</PRE>
If 2+ mobs: hides with Shroud (35 stamina, not already hidden), then Diverts one target (25 stamina, must be hidden). Ambushes if hidden, Flurries on cooldown, attacks as fallback.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>
Keeps Surge active (casting only when not on cooldown). Bullrush to apply vulnerable, Bearhug (faster on vulnerable targets), Pummel on cooldown, attack as fallback.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>
Keeps Surge active (casting even during cooldown for 60 stamina). Shouts when less than 11 seconds remain on the buff. Shield Strikes, Pummels once per minute, finishes with 2 attacks.

<PRE>pindown(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 (m16 reflex), fire</PRE>
Pin Down if 4+ targets, Volley if 2+ targets. Tangleweed if missing Vigor and Reflex buffs. Barrage if missing Enhanced Dexterity. Spike Thorn (616) if 16+ mana and Arcane Reflex is active. Fire as fallback.

===Hunting Target Examples===
All examples below work for both "valid targets" and "quickhunt targets."

A simple target list using default commands (a) for each creature:
<PRE>crazed zombie, niirsha, sacristan spirit</PRE>

Using different command sets per creature — (a) for zombies and spirits, (b) for niirsha:
<PRE>crazed zombie(a), niirsha(b), sacristan spirit(a)</PRE>

Including [[:Category:Boss creatures|Boss Creature]] variations as valid targets using regex:
<PRE>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</PRE>

Advanced regex for Grimswarm hunting with different commands per class:
<PRE>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)
</PRE>

To target everything in the room: <CODE>(?:.*)</CODE>

==Boon Creatures Tab==
Boss creatures (also called the Boss Creature System) upgrades newly created creatures into bosses, minibosses, or packs. Upgraded creatures have their level and basic stats boosted, and are granted a number of special abilities called '''boons''', which are denoted by a special adjective in the creature's name. Players have alternatively called these "glam critters," "gifted creatures," or "boosted critters."

Additional details are available on the GemStone Wiki: [https://gswiki.play.net/Category:Boss_creatures Category:Boss creatures]

The Boon Creatures tab provides granular control over how Bigshot handles each boon ability. Bigshot uses the ASSESS verb to identify which boons a creature has, then checks your configuration to decide how to respond.

===How It Works===
For each boon ability, you can choose one of three actions:
* '''Common''' - Treat as a normal target and fight it. Uses your hunting commands to kill. Still requires proper valid target matching to engage. This is also the default behavior if no selection is made.
* '''Ignore''' - Skip this creature entirely; do not engage it.
* '''Flee''' - Immediately flee from the room when this boon type is detected.

===Master Toggle===
At the top of the tab is an '''All Boon Creatures''' section with Common, Ignore, and Flee checkboxes. These act as master toggles — checking one will set every individual boon ability across all groups to that action. If all individual items are already set to the same action and you uncheck the "All" toggle, everything gets unchecked.

===Boon Groups===
The individual boon abilities are organized into four collapsible groups, each with its own group-level toggle row ("Entire Group") and individual per-ability rows:

====Immunity====
Boons that make the creature resistant or immune to certain damage types or effects.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Crit Death Immune || resolute, unflinching || Similar to constructs or golems
|-
| Damage Padding || flinty, tough ||
|-
| Elem Negation || sparkling, shining || Absorbs elemental magic attacks
|-
| Magic Resistance || rune-covered, tattooed || Reduces magic damage by 50%
|-
| Physical Negation || indistinct, nebulous || Physical damage resist shield
|-
| Stun Immune || steadfast, unyielding ||
|}

====Offensive====
Boons that enhance the creature's offensive capabilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Boosted Offense || combative, belligerent ||
|-
| Cheat Death || glorious, illustrious || Raises self after death
|-
| Counter Attack || apt, ready || SMR counter-attack
|-
| Crit Weighting || shimmering, gleaming ||
|-
| Dmg Weighting || barbed, spiny ||
|-
| Dispelling || dazzling, flashy || Spirit Dispel (119) and Elem Dispel (417)
|-
| Elemental Flares || glittering ||
|-
| Frenzy || raging, frenzied ||
|-
| Mind Blast || canny, keen ||
|-
| Parting Shot || dreary, drab || Deals damage one last time upon death
|-
| Poisonous || sickly green, oozing || SMR poison gas cloud
|}

====Defensive====
Boons that enhance the creature's defensive capabilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Blink || flickering, wavering || Temporary phase ability
|-
| Bolt Shield || shielded ||
|-
| Boosted Defense || sinuous, flexile || High damage padding (+12 CER)
|-
| Confuse || blurry, shifting || May give hard RT for casting at them
|-
| Crit Padding || stout, hardy ||
|}

====Stats / Misc====
Boons that affect the creature's stats, resistances, or grant miscellaneous special abilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Boosted HP || robust, stalwart ||
|-
| Boosted Mana || luminous, lustrous ||
|-
| Diseased || pestilent, afflicted, diseased ||
|-
| Extra Spells - Elem || glowing ||
|-
| Extra Spells - Spirit || radiant ||
|-
| Extra Spells - Other || twinkling ||
|-
| Ethereal || ethereal, wispy, ghostly || Noncorporeal undead. No Sheer Fear.
|-
| Jack of All Trades || adroit, deft ||
|-
| Regeneration || slimy, muculent || Similar to Troll's Blood (1125)
|-
| Soul Stealing || tenebrous, shadowy || May possess 1204, 1601, and 1712
|-
| Terrifying || ghastly, grotesque || Pre-attack SMR can force player into defensive
|-
| Weaken || spindly, lanky || Weaker creature than normal
|}

===Usage Tips===
* If you are a melee character who struggles with '''Stun Immune''' or '''Crit Death Immune''' creatures, set those to Ignore or Flee while leaving others on Common.
* Casters may want to Flee from '''Dispelling''' and '''Magic Resistance''' boons.
* '''Weaken''' is actually beneficial — the creature is weaker than normal, so leaving it on Common is usually best.
* '''Cheat Death''' creatures will revive after dying; consider Ignore if your build cannot handle killing them twice.
* The configuration is saved per profile, so you can have different boon strategies for different hunting areas.

== Misc Tab==
Various specialized configuration options.

===UAC Options===
Options for configuring Unarmed Combat (UAC):
* '''Tier 3 Attack''' - The attack used when you have reached "excellent" positioning. Options: jab, punch, grapple, or kick.
* '''Aim at location (head, etc)''' - Used for aimed UAC combat, which requires ambush training to be effective. Leave blank if you do not want to aim.
* '''MSTRIKE when creatures equal or greater''' - How many creatures must be present before using MSTRIKE during UAC.
* '''Use Voln SMITE?''' - Will perform a Voln SMITE on [[Non-corporeal]] undead.

'''Quick Setup:''' Bigshot only requires minimal configuration for UAC to work well:
# '''UAC options:''' Set your '''Tier 3 Attack''' (jab, punch, grapple, or kick).
# '''Commands tab:''' Set your '''hunting commands (a)''' to '''unarmed jab'''.

Important notes about UAC in Bigshot:
* <CODE>unarmed jab</CODE> can be replaced with any UAC attack type (e.g., <CODE>unarmed punch</CODE>).
* UAC follow-up strikes take priority over the base or Tier 3 attack.
* Tier 3 attacks are only used when positioning is "excellent".
* There is almost no reason to use anything other than <CODE>unarmed jab</CODE> as the hunting command and either <CODE>grapple</CODE> or <CODE>kick</CODE> as the Tier 3 attack.

===MSTRIKE Options===
Options for when and how MSTRIKE should be used:
* '''MSTRIKE during cooldown stamina requirement''' - How much stamina you need before Bigshot will MSTRIKE during the MSTRIKE cooldown period. Be careful setting this too low, as it can pop your muscles. Leave blank to use your max stamina.
* '''QUICKSTRIKE stamina requirement''' - Stamina required for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater''' - Number of creatures in the room before Bigshot uses an unfocused (AOE) MSTRIKE instead of a focused one. Default is 2.
* '''MSTRIKE during cooldown''' - Toggle to allow MSTRIKEing during the cooldown period.
* '''Use QUICKSTRIKE for MSTRIKE''' - Toggle to use QUICKSTRIKE instead of normal MSTRIKE.

===Ammo/Wands===
Settings for ammunition and wand management. If your attack routine uses FIRE or WAND verbs, these fields must be configured or Bigshot will hang.

* '''find ammo in this container''' - The container holding your ammunition (quiver, backpack, etc.). Leave BLANK if using FIRE without retrieving ammo (post-Archery 2020 Update).
* '''use this ammo type''' - The noun of your ammo type. Leave BLANK to use FIRE without retrieving ammo. Be precise with the noun — Bigshot is sensitive to exact naming here.
* '''fresh wand container''' - The container Bigshot checks for fresh wands to WAVE.
* '''dead wand container''' - The container where Bigshot deposits used-up wands.
* '''use this wand type''' - The specific wand type(s) to use. Bigshot only pulls these for WAVEing. Separate multiple types with commas. Example: <CODE>aquamarine wand, bloodwood wand</CODE>
* '''Hide while waiting to pick up ammo''' - Bigshot will hide when gathering spent arrows and bolts.
* '''Use wands when out of mana''' - When out of mana, Bigshot pulls the specified wand type, stances to your attack stance, and WAVEs at valid targets until out of wands or resting conditions are met.

===MA Grouping===
Multi-account grouping options:
* '''Looter name''' - The name of the character designated as the looter in Head/Tail configuration.
* '''No-looting list''' - Comma-separated list of characters who should never be assigned looting duty.
* '''Random looting''' - Distributes looting randomly based on encumbrance rather than assigning a fixed looter.
* '''Leader final loot''' - Allows the leader to perform a final loot pass before leaving a room.
* '''Travel TO hunting grounds independently''' - When enabled, group members travel to the hunting area on their own rather than as a group. Bigshot will disband the group and force GROUP OPEN after disbanding.
* '''Travel FROM hunting grounds independently''' - When enabled, group members return from the hunting area on their own.
* '''Stop for dead group members''' - Pauses the group if a follower dies during a hunt.

==Monitoring Tab==
Options for safety, interaction monitoring, and debugging.

* '''Monitor interaction''' - Pops up a window whenever Bigshot detects that someone or something is trying to interact with you. Customizable monitor strings and safe strings can be configured.
* '''Engage deadman's switch''' - Forces Bigshot to quit GemStone IV when your character drops below 40% health, allowing you to log back on and assess the situation manually.
* '''Depart/rerun if dead''' - Forces a DEPART (waking up in the Temple with low spirit), then restarts Bigshot for a fresh hunt. Make sure your "CHECK spirit >=" value in Should Hunt? is set high enough to recover before the next hunt.
* '''Quiet followers''' - Followers wait until the leader finishes both actions and resting scripts before beginning their own.
* '''Ignore disk objects''' - Ignores disk objects when evaluating room claims and other checks.

===Debugging===
Bigshot provides detailed debug options for troubleshooting. Use these commands in-game:
<pre{{log2}}>
+---------------------------------------------------------------------------+
| Bigshot Debug Help v5.11.4 |
+---------------------------------------------------------------------------+
| Debug options have changed to be more helpful. |
+--------------------------------------+------------------------------------+
| ;bigshot debug file | Toggles logging to a file <on/off> |
| ;bigshot debug all <true/false> | Toggles true/false all the things |
| ;bigshot debug check | Lists current debug settings |
| ;bigshot debug combat <true/false> | Combat and Creature Status |
| ;bigshot debug commands <true/false> | Attacking and Casting Commands |
| ;bigshot debug status <true/false> | Status Checks of your Character |
| ;bigshot debug system <true/false> | System processes |
| | |
| Options can be combined: |
| ;bigshot debug combat commands status <true/false> |
+---------------------------------------------------------------------------+
</pre>

Debug log files are stored in your Lich5 logs directory under <CODE>debug/<Game>-<CharacterName>/bigshot.log</CODE> and rotate daily.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|Profiles
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting
File:bigshot-4.PNG|Attacking
File:bigshot-5.PNG|Commands
File:bigshot-6.PNG|Misc
File:bigshot-7.PNG|Monitoring
</gallery>

==Reference==
* Info originally taken from http://forum.gsplayers.com/showthread.php?t=57651

{{Third-Party Software}}
{{top}}

Lich:Software/Installation

2026-03-17T00:25:40Z

HORIBU1: /* Installing the Latest Stable Release */ update for 5.15.1

{{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.15.1 supporting Ruby 4.0 - published March 16, 2026'''

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

====Lich 5.6 or older====
Please proceed to updating both Ruby and Lich 5

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Install Lich:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
</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 using Ruby's Gemfile that in included with Lich-5 now by using `bundle install` as shown below:
<pre>
echo "gem: --no-document" > ~/.gemrc
cd ~/lich-5
bundle install
</pre>

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

Install Lich:
<pre>
cd ~
curl -L "https://github.com/elanthia-online/lich-5/releases/latest/download/lich-5.zip" -o temp.zip && unzip temp.zip -d ./ && rm temp.zip
</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 using Ruby's Gemfile that in included with Lich-5 now by using `bundle install` as shown below:
<pre>
echo "gem: --no-document" > ~/.gemrc
cd ~/lich-5
bundle install
</pre>

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

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

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora
* 41 uses Ruby 3.3
* 42 uses Ruby 3.4
* 43 uses Ruby 3.4
All of which are currently compatible with Lich 5.7.0 or higher.

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

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

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

4. 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 using Ruby's Gemfile that in included with Lich-5 now by using `bundle install` as shown below:
<pre>
cd ~/lich-5
bundle install
</pre>

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

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

=Ecosystem Information=

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

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.13.5'''
<PRE>
### Bug Fixes (general)
* util.rb only show gem installing debug messaging if gem mis… (#1131)
* add --gs and --dr, refactor argv_options to helpers (#1133)
* fix multiple custom entries, improvements to yaml save (#1134)
* login_tab_utils.rb expand helper text show Warlock (#1135)
* update CLI for YAML security signature, add auto-convert fo… (#1136)
* remove password parameter from debug logging in all cases (#1137)
* reduce minimum GUI window footprint for non-tabbed view (#1138)
* remove double save in YAML to preserve yaml.bak integrity (#1139)

### Bug Fixes (gs)
* stash.rb additional improvements (#1132)
</PRE>
'''5.13.4'''
<PRE>
### Bug Fixes (general)
* force system gem install if RubyGems fails (#1126)
* gui_login prevent destroying window if already destroyed (#1127)
* add window size / position saves to login GUI (#1128)
* non tabbed saved entries in reduced button / font size (not… (#1129)
</PRE>
'''5.13.3'''
<PRE>
### Bug Fixes (general)
* account manager sorting GUI fix (#1123)
</PRE>
'''5.13.2'''
<PRE>
### Bug Fixes (general)
* install_gem_requirements update available gems after install (#1120)
</PRE>
'''5.13.1'''
<PRE>
### Bug Fixes (general)
* password_cipher.rb upcase account_name for key (#1118)

### Bug Fixes (dr)
* validator.rb change sleep to should_sleep named param (#1116)

### Bug Fixes (gs)
* add base stats capture from 'info full' command (#1115)
</PRE>
'''5.13.0'''
<PRE>
### Features (general)
* Refocus Frontend (#960)
* socket configurator to better guard TCPSocket (#976)
* add simplified DB maintenance (#991)
* TextStripper module support for XML, HTML, Markdown (#1055)
* Login modernization and refactor to yaml (#1063)
* Ruby Memory Releaser module (#1066)

### Features (dr)
* support meta:trashcan tag for DRCI.dispose_trash (#966)
* Add GameObj.inv support for DR items (#1080)
* DRCS allow custom adjective for summoned weapons (#1088)
* DRParser support for new exp window xml stream elements (rested exp, tdps, favors) (#1104)

### Features (gs)
* Add Armaments (Weapon, Armor, and Shield) Module (#911)
* add creature module, including Hinterwilds creatures (#1002)
* Creature module combat tracking (#1003)
* track time of last total_experience record (#1030)
* add Injured class for checking ability to perform actions (#1035)

### Bug Fixes (general)
* map dijkstra optimization (#1061)
* update.rb keep script/data file incase of error on update (#1070)
* ensure proxy path is set for non-destructive array write-th… (#1073)
* [lib][global-defs] - move update (#1079)
* GameObj force new objects ID to be string (#1087)
* xmlparser.rb gate GSL exits sending behind @send_fake_tags (#1103)
* change Hash[] pair key conversion to use to_h for Ruby 4.0 (#1108)
* move gui-login.rb to Ruby standard gui_login.rb (#1111)
* update location for currency and move game-loader.rb to Ruby standard gameloader.rb (#1112)

### Bug Fixes (dr)
* DRCA allow custom spell prep messaging (#1089)
* Update Slackbot error handling, and lnet management (#1091)
* Fix exp mods parsing for DR (#1102)
* equipmanager.rb support for custom messaging in forester's longbow (#1105)
* Fix hang in equipment manager when game doesn't respond to commands (#1110)

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

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

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

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

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

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

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

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

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

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

Fash'lo'nae's Tutelage

2026-02-25T00:07:11Z

HORIBU1: /* Analyze */ add closing pre tag

<table><tr valign="top"><td>
Introduced at the February 20206 run of [[:Category:Duskruin|Duskruin]], "Fash'lo'nae's Tutelage" is a [[SimuCoin]] item that is available at Major Events. It provides a 5x multiplier for up to 100,000 bonus experience per week, activating once the [[Gift of Lumnis]] cycle ends. It costs 3,500 SimuCoins and lasts for 90 days.

{{TOC limit|2}}
==Analyze==
<pre{{log2}}>
You analyze the bronze disc and sense that the creator has provided the following information:
The arcane symbols on the disc shift and dance before your eyes.

When claimed using REDEEM, this item grants Fash'lo'nae's Tutelage for 90 days. When your Gift of Lumnis ends, Fash'lo'nae's Tutelage will activate, granting 5x experience absorption until you have gained 100,000 bonus experience in this fashion.

You get no sense of whether or not the disc may be further lightened.
</pre>

==Usage==
{| {{verbtable}} 
|- {{verbtableheader|90}}
! scope="col" style="width:5em;"|Verb
! scope="col" style="width:5em;"|Style
! scope="col" style="width: 40%"|First
! scope="col" style="width: 40%"|Third
|-
! scope="row" role="rowheader" rowspan="3"|REDEEM
! scope="row" role="rowheader"|(First use)
|
|-
|}
==Additional Information==
Once Redeemed, when you type EXP, you will see:

Activating
: You feel a heightened understanding of events around you. Knowledge that is not your own teases at the edges of your mind, luring your thoughts down forbidden alleyways and into dark shadows where unknown secrets await.

Expiring
: The feeling of heightened understanding departs, leaving behind a cold hunger for forbidden knowledge that is slow to fade.
=== FAQ ===
Taken from the pinned FAQs in the discord forum.
# It will reset with the start of our Lumnis Cycle. If you do not utilize it in full before the end of your cycle, the excess will be lost.

=== Credits ===
*

==See Also==
* [https://www.play.net/gs4/news.asp?id=2385&back=home Play.net Post]
</td><td>
{{iteminfo
|type=Mechanical 
|itemclass=Misc. 
|itemtype=Disc 
|alter= 
|ld= 
|feature= 
|customize= 
|custom= 
|origmerch= 
|releasevenue=Duskruin 
|releaseyear=2026 
|questitem= 
|tiered= 
|tiersnumber= 
|unlock= 
|legendary= 
|demeanor= 
|loresong= 
|corrscript= 
|attune=Permanent 
|attunement= 
|affinity= 
|spell= 
|enhancive= 
|swap= 
|add= 
|restrictions=
}}
{{itemverb
|verb=REDEEM 
|verb2=
|verb3=
|verb4=
|verb5=
|verb6=
|verb7=
|verb8=
}}
</td></tr></table>

==Expiring==
: The feeling of heightened understanding departs, leaving behind a cold hunger for forbidden knowledge that is slow to fade.

[[Category:SimuCoins]]

Locker

2026-02-23T18:31:43Z

HORIBU1: fix missing pre tags

{{TOCright}} '''Lockers''' are storage units in which adventurers can store items safely when they do not want to carry them on their person.

==Item Limits==

{| {{prettytable|float:right;}}
|- bgcolor=lightblue
!Status !!Items
|-
|Prime Account ||50
|-
|[[Premium subscription]] ||+50
|-
|[[Platinum subscription]] ||+50
|-
|[[CHE|House]] Member ||+50
|-
|}[[F2P]] subscriptions have no base access to a locker. Characters on a [[standard subscription]] (also known as a prime account) have base access to 50 item slots while those on a [[premium subscription]] have base access to 100 item slots, and those on a [[Platinum Subscription]] have base access to 150 item slots. If a character is in any of the [[Co-operative Houses of Elanthia]], they will add +50 to the base item slots for whichever account type they are on. Locker capacities may also be increased through the [[Simucoin]] Store or occasionally through [[giftbox|giftboxes]]. There is a maximum of +750 total item slots; if the maximum is exceeded, a [[GameMaster]] will need to assist with what is leftover.

When {{boldmono|[[OPEN (verb)|OPEN]]}}ed, the locker will give messaging reflecting how many items it is holding and what the capacity is. One can {{boldmono|[[INSPECT (verb)|INSPECT]]}} the locker to get updated information.

<pre{{log2}}>
>open locker

As you open the locker, you hear the faint creak of a pulley turning behind the wall. Descending from above, a weapon rack, armor stand, and clothing wardrobe come to rest at your feet. Two panels slide open on the floor, and a magical item bin and a deep chest rise up from their hidden depths.

Your locker is currently holding 19 items out of a maximum of 100.

You place the traveller's cloak in the locker, and it quickly disappears.

>inspect locker
Your locker is currently holding 20 items out of a maximum of 100.
</pre>

==Family Vault==
With the release of [[Locker Updates and Family Vaults]] an account now has access to a Family Vault at their local locker. Family vaults are account-wide lockers that allow all characters on a single account to access a shared locker. F2P characters are ineligible (they're restricted to 1 character per account, so there's no need for one). Basic subscribers have a base capacity of 25 items and Premium and Platinum subscribers have a base capacity of 50 items. Like existing lockers, in the future, expansion slots will be available to increase the base numbers that are separate from the locker contracts. To start using a family locker, a character simply needs to visit a local locker and open it. A new dark stained antique oak trunk bound in wrought iron will be revealed in the room.

==Locker Locations and Moving Services==

{| {{prettytable}}
|- bgcolor=lightblue
!City !!Public Lockers !!CHE House Lockers !!Movers
|-
|[[Wehnimer's Landing]]||[[Moot Hall]] (TSE)||Individual Houses or [[Ebonstone Manor]]||[[Paspartu Moving Company]]
|-
|[[Solhaven]]||Warehouse (1w, 2sw of NM)<br>Warehouse (Vornavis Caravansary, SE corner)||Warehouse (upstairs)|| [[Paspartu Moving Company]]
|-
|[[Icemule Trace]]||[[Clovertooth Hall]]||[[Silvermule Gaming Hall|Silvermule Gaming Hall]] (3s, 1w of TC)||[[Paspartu Moving Company]]
|-
|[[River's Rest]]||[[Timor's Storage]]||[[Timor's Storage]]||[[Timor's Storage]]
|-
|[[Mist Harbor]]||[[Hale Hall]] (downstairs)||[[Hale Hall]] (upstairs)||[[Island Shipping]]
|-
|[[Zul Logoth]]||[[Rockslinger Relocation Services]] (hallway)||[[Rockslinger Relocation Services]] (corridor)||[[Rockslinger Relocation Services]]
|-
|[[Kharam Dzu]] (Teras)||[[Borthuum Company Store]]||[[Adventurer's Rest]]||[[Paspartu Moving Company]]
|-
|[[Cysaegir]]||[[Rhyaesdid Hall]]||[[Rhyaesdid Hall]]||Moving Company (Rubicaene Way)
|-
|[[Ta'Illistim]]||[[Ta'Illistim Keep]]||[[Lost Home]]|| [[Sylvarrglin Moving Company]]
|-
|[[Ta'Vaalor]]||[[Wyvern Keep]] ||[[Dancing Dahcre]] (Aethenireas Wey)||Glimaerseen Moving Company
|-
|[[Kraken's Fall]]||[[Inking Den]]||[[Inking Den]]|| [[Cartwright]]
|-
|}

==Moving Lockers==

Lockers can be moved from one town to another but at a cost in both silvers and time which varies based upon game subscription level. This service can be accessed by visiting each town's local moving company office.

===Cost and Transport Times===

{|{{prettytable}}
|- bgcolor=lightblue
![[Subscription|Subscription Type]]
!Delivery Method
!Cost
!Transport Time
|-align=center
|[[Standard subscription|Standard]]
| Standard
| 1,000
| 2 hrs.
|-align=center
|[[Standard subscription|Standard]]
| Express
| 10,000
| 30 min.
|-align=center
|[[Premium subscription|Premium]]/[[Platinum subscription|Platinum]]
| Standard
| 1,000
| 2 hrs.
|-align=center
|[[Premium subscription|Premium]]/[[Platinum subscription|Platinum]]
| Express
| 2,500
| 30 min.
|-align=center
|[[Premium subscription|Premium]]/[[Platinum subscription|Platinum]]
| Immediate
| 5,000
| 1 min.
|}
{{Top}}
===Process===

{| class="wikitable mw-collapsible mw-collapsed"
| Click "Expand" for a very simple how-to (spoiler):
|-
|How to use the Locker Moving Company's services:
#go to any Moving Company
#ask clerk about rates
#ask clerk about shipping
#say yes
#say <the town where you want your locker>
#say <the town your locker currently is in>
#choose one <Standard, Express, Immediate> and say your choice

*This process swaps your locker between the two towns you specified.
*Any moving company can serve you, no matter which lockers you want to swap. You do not have to be in the same town as either locker.
*These town names seem to work, though a few others are possible: Wehnimer's Landing, Teras Isle, Icemule Trace, Kraken's Fall, Solhaven, River's Rest, Cysaegir, Ta'Illistim, Ta'Vaalor, Zul Logoth, Four Winds Isle.
*You can not abbreviate most of the town names shorter than 5 characters: wehni, teras, icemu. krake, solha, river, cysae, illis (or ta'ill), vaalo (or ta'vaa), zul l (must have a space), four w (must have a space).
*Note that the "immediate" option seems to actually take about 1-2 minutes, and during those couple of minutes, you are not allowed to initiate moving other lockers.
*In at least some locations, a promissory note is an acceptable form of payment.
*If your House does not have lockers in a particular location, the clerk will refuse to provide a transfer service:
<pre{{log2}}>
>ask clerk about cysaegir
The young clerk kindly informs you that your House does not maintain lockers there and refuses the business.
</pre>
|}

<pre{{log2}}>
>ask clerk about shipping
The young clerk smiles sunnily at you, "Moving, are we? How nice!" she says. The young clerk consults somes files, running a delicate finger down each page as she reads.

The young clerk says to you, "Would you like us to ship your locker for you?"

The young clerk smiles at you, waiting patiently for your answer.
>
The young clerk smiles and says, "If you'd like your locker moved, just ASK me. I know all ABOUT shipping."
>"Yes
You say, "Yes."
The young clerk smiles brightly. "Very good, <Player>! We offer shipping services to and from Wehnimer's Landing, Teras Isle, Icemule Trace, Solhaven, River's Rest, Ta'Illistim, Zul Logoth and Ta'Vaalor and Four Winds Isle. From which town would you like your locker shipped?"

The young clerk waits attentively for your answer.
>"Wehnimer's Landing
You say, "Wehnimer's Landing."
The young clerk smiles. "Ah, you're planning on staying a while. Now, <Player>, we're going to ship that locker from Wehnimer's Landing, but what locker did you want to exchange it with? Just SAY the name of the town!"
>
The young clerk smiles and says, "If you'd like your locker moved, just ASK me. I know all ABOUT shipping."
>"Four Winds Isle
You say, "Four Winds Isle."
The young clerk smiles. "Ah, hrmn, alrighty. Now, <Player>, we're going to ship that locker to Mist Harbor. Did you want the standard rate, express rate, or immediate rate? Go ahead and just SAY STANDARD, EXPRESS, or IMMEDIATE."
>"IMMEDIATE
You say, "IMMEDIATE."
The young clerk nods and jots something down. "Okay, it's done! Immediate rate locker shipping from Wehnimer's Landing to Mist Harbor."
You hand the young clerk 5,000 silvers.
</pre>

==Locker Manifest==
[[Premium subscription|Premium members]] automatically gain access to locker manifests through the {{boldmono|LOCKER}} verb (see below) or through a physical locker manifest which can be obtained in the [[Mist Harbor]] bank, east from the teller.

Access to {{boldmono|LOCKER MANIFEST}} can be purchased by non-Premium players in the [[SimuCoin]]s Store for 25 SCs.

==LOCKER (verb)==

The {{boldmono|LOCKER}} verb can be used to access manifests and runners. [[standard subscription|Standard subscribers]] may gain access the manifest function through the [[Simucoin]] Store for 25 SimuCoins. [[premium subscription|Premium]] and standard subscribers may also purchase access to the Locker Runner system for 300 simucoins for either 30 days of unlimited access or 60 uses over an unlimited time. The Locker Runner function will only work in places where the [[justice]] system applies (most outdoor places in towns).

<pre{{log2}}>
>locker

Usage:
LOCKER INFO - View information on the status of your locker(s).
LOCKER MANIFEST [OPTION] - View the contents of your locker. Valid options are TOWN, FAMILY VAULT, or ASTRAL VAULT.
LOCKER GET [MANIFESTID#] - Retrieve an item from your locker while in town.
To specify the item, use the item id number from LOCKER MANIFEST.
LOCKER SEND [ITEM] - Send a held item to your locker while in town.
</pre>

==SURRENDER (verb)==
<section begin=surrender />If a player finds themselves in a locker that they cannot close because there are more items in it than the locker can currently hold, the player can {{boldmono|SURRENDER {item} }}in the locker in order to alleviate the problem. This situation occurs when a player downgrades from a [[premium subscription]] or if a [[SimuCoin]] locker contract ends. The verb is only available when the locker is overfull.

The surrendered item(s) will be sent to the [[Justice#Constabulary|local justice office]] and stored in a box similar to those that hold a character's items after being arrested. This is not permanent storage and the box will only persist for two weeks. This timespan is a substantial increase in comparison to the jail mechanics.<section end=surrender />

==Troubleshooting==
;I downgraded from premium! What happens to my lockers?
If you downgrade from Premium, all of your lockers are going to consolidate into one and you won't be able to leave until you remove enough items to be able to close your locker. You will have the choice of removing them by hand or {{boldmono|SURRENDER}}ing them to pick up later (with applicable fines) as outlined below when you downgrade and attempt to open your locker:

<pre{{log2}}>Your locker is about to be converted from a premium locker to a basic locker. This means that all of your belongings, in all of your lockers will be stuffed into just one locker. You'll need to ensure that the locker, after conversion, does not exceed its standard limit before being able to close it.
You can do this by either removing items directly by hand or by temporarily SURRENDERing them to the local town officials for later pickup at the nearest justice office. If you choose to SURRENDER an item, you will need to pay any fines you may owe to the local town before you can retrieve your items.
If you're prepared to continue with the conversion please OPEN LOCKER again within in the next 15 seconds.</pre>

;I put an armor-filled backpack in and now my halfling/gnome can't pull it out!
This is related to the "You can only pick up a certain percentage of your weight" issue. Find some CON enhancives or {{boldmono|[[ASSIST (verb)|ASSIST]]}}.

;My locker isn't here! Where is it?
It's wherever you started the game, or wherever you last moved it to. You can use {{boldmono|LOCKER INFO}} or go to the local Mover's and ask them about moving your locker. Either option will tell you where your locker is.

;No, really, it says my locker isn't here but I'm in the House Annex.
Oh, that. Yeah, people post about that on the forums and a [[GameMaster]] tells them its a known issue. It comes up if you try to move your locker to a locker that hasn't been accessed in a while. Try to ask if someone can visit the annex lockers and then try to move your locker again.

;I can't figure out how to get into my locker in my House Annex.
A lot of the House Annexes have puzzles to get into the lockers. Ask on your House [[ESP]] channel or look on your house website. Or just start pulling and turning everything in the room. If you have a House pin, you can {{boldmono|TURN}} it from inside any city (except the city with the main branch) to teleport you to the local locker annex. The pins can usually be purchased near the main branch entry for a modest fee and do not degrade.

;I'm on an F2P subscription. Is there any way I can access a locker to store a few things?
An [[F2P]] subscription has no base access to a locker, but through the [[Simucoin Store]], a Basic Locker Access (30 days) token can be purchased for a temporary 10 item locker pass, and other locker upgrades may also be available for purchase.

==See Also==

*[http://beaconhall.net/index.php?Lockers Beacon Hall Archive lockers]
*[[Helden_Hall#Town_Annexes|Helden Hall lockers]]
*[[House Brigatta lockers]]
*[[Silvergate_Inn#Annexes_and_Lockers|Silvergate Inn lockers]]
*[[Twilight_Hall#Annexes|Twilight Hall lockers]]
*[[SimuCoin store]]
*[[SimuCoin (saved posts)]]

{{top}}

[[Category:Area Mechanics]]

Event Vault

2026-02-14T15:24:31Z

HORIBU1: /* Recent Event Items: */ add missing items and convert to chart

{{stub}}

<pre{{log2}}>
The BATTLE VAULT is a bundle of items for <events>. You may only redeem one BATTLE VAULT per run of an event, per character. The BATTLE VAULT itself is not attuned in any way until you REDEEM it, so you can trade them, hand them off, etc.
</pre>

==Included in the BATTLE VAULT:==

* Two 25-count entry booklets, compatible with the [[Booklet_exchange_NPC|Booklet Exchange NPC]].
* One bottle of 30-count [[Spell_up_pills|Advanced Spellup Pills]].
* One [[Experience_modifier_scroll|golden scroll]].
* One [[Gilded_locus_oil|Locus Oil]].
* One Event [[Event_Vaults%27_Special_Items|Special Item]].

The cost of the BATTLE VAULT is 6,500 [[SimuCoin|simucoins]].

==Recent Event Items:==
{| class="wikitable"
! Item !! Event !! Date
|-
| [[Clockwerke Golem|Golem Chassis]] || Duskruin || February 2024
|-
| [[MechSpinner|Mechspinner]] || Rumor Woods || April 2024
|-
| [[Clockwerke Golem|Golem Chassis]] || Duskruin || August 2024
|-
| [[The Ferryman's Lantern|Ferryman's Lantern]] || Ebon Gate || October 2024
|-
| [[Greater Felcour Gauntlets]] || Duskruin || February 2025
|-
| [[Gnomic Candy Press]] || Rumor Woods || April 2025
|-
| [[Fizwixit's Wonderful Widget]] || Duskruin || August 2025
|-
| [[The_Spidersilk_Apothecary|Spidersilk Apothecary]] || Ebon Gate || October 2025
|-
| [[Chaos_mirror_shard|Chaos Mirror Shard]] || Duskruin || February 2026
|}

Deed acquisition

2026-02-10T01:56:50Z

HORIBU1: fixed visual edit PRE removal errors

{{Spoiler}}

[[Deed]]s can be purchased in all cities in Elanthia. They can be purchased by solving puzzles (each location has its own puzzle) and paying in gems, coins (accepted by most puzzles) and sometimes alchemy products or other treasure items.
{{TOC limit|3}}
== Locations ==

Here is a summary of the locations of the deed puzzles in the lands and how to solve them.

=== [[Icemule]] ===

Just outside the temple doors there is a ice flow. '''Search flow''' to reveal a door. '''Go door''' and then '''close door''' once inside. '''Pull chain''' and a drawer slides into view. Now '''open drawer''' and put your offering(s) inside. Then '''close drawer''' to complete the ritual. If you don't '''open door''' before attempting to go through it you will walk right into it causing a loud thud which people will hear outside. If you want to make multiple offerings, you can '''open door''' and then '''close door''' to restart the ritual without even leaving. Just remember to '''open door''' again before leaving. Once you are out, no need in attempting to close the door, as it is hidden once again.

Seems '''Gems AND Wands''' recieve extra value in Icemule, and someone mentioned '''Lockpicks''' can be used in Icemule.

Very young adventurers with few deeds can use '''broadswords''' which can be found by hunting thyrils outside the south gate of Icemule.

=== [[Mist Harbor]] ===

Go to the Western Harbor cemetery on Fishmonger Way and look for a door in a cliff.

{{RoomDescription
|roomname = Cavern, Altar Room
|desc = Vaulted and wide open, the cavern is illuminated by the numerous torches that are hung in large wrought iron rings anchored to the smooth stone walls. High in the distant ceiling is a wide hole that allows sunlight to cast its golden glow upon a smooth round stone altar that has been placed in the center of the chamber. Overlapping thick azure rugs ring the room's single piece of furniture, their faces decorated with interlocking whorls and geometric shapes. You also see a merry mountain spirit that is flying around and a willow-thin human priest.
|rnum = 28620
|exits = north, east, southeast, south, west
}}
'''Log of Discussion with Priest'''
<pre{{log2}}>
Moving quietly to your side, the priest whispers to you, "I know all manner of things about this place. If you wish me to share my knowledge, then simply ask me about NORTH winds, SOUTH winds, EAST winds, WEST winds, or just the WINDS in general. I also know about the FEATHER, the ALTAR, and the POT." Nodding once, he moves away to give you some privacy.

>ask priest about north winds
Smiling, Fyodar says, "The altar that sits in that portion of the cavern is dedicated to the northern winds, which are the cold, fierce winds that are born of the element water. There's an urn there that you'll want to POUR over the basin that holds your offering. Once that is done, you'll want to share your breath to freeze the pieces and then LIGHT the brazier to evaporate it all."

>ask priest about south winds
Gazing at the distant ceiling, Fyodar distractedly says, "The altar that sits there is dedicated to the southern winds, which are the winds that bring us heat because they are born of the element fire. If you wish to make an offering there, then you must SPRINKLE the OIL over the basin and LIGHT it on fire. Share your breath, too, for that is the touch that makes your offering pure."

>ask priest about east winds
Pondering, Fyodar says, "Well, I believe that altar is given to the winds of the east, which is tied to spices and the element of air. When making an offering there, you may want to LIGHT some INCENSE and EXHALE its fumes over the BASIN."

>ask priest about west winds
Nodding several times, almost as if distracted, Fyodar finally says, "The alter erected over there is given to the west winds, which are the winds of life and tied to the element of earth. You will want to TAKE some soil from the VESSEL and pack it in around your offering. Then you shall need to POUR some water and watch what happens. The key here is to share your internal breath with your offering."

>ask priest about winds
"Bountiful winds," the priest quietly says in response to your query. "Without the wind there would be nothing to carry the seed, nothing to push ships across the seas, and nothing to cool faces in the heat. There are four winds, you know, and I know all about them. NORTH, EAST, WEST, and SOUTH, just ask me about them."

>ask priest about feather
"Ah, yes," Fyodar says quietly, "The feather is a guide. When you pray it rises to your destination and you must follow it."

>ask priest about altar
Glancing at the altar, Fyodar says, "It is the missing piece from above. Once, long ago, it tumbled from the ceiling and left us a clear view of the sky. Through that opening, the winds grace us with their daily breath."

>ask priest about pot
Smiling, Fyodar says, "One may have to SPRINKLE a pot over a BRAZIER or BASIN, though some you may have to POUR over them."
</pre>
:{{addmetext}}

=== [[River's Rest]] ===

Go to ''Spring Rest'' just outside the Sanctuary (the room with the pillars, room #10854). '''Kneel''', '''look in pool''' (an inviting message should appear), '''look in pool''' again (another inviting message should appear), '''touch pool''', '''put''' your shells, gems or silvers into the pool, '''touch pool''' again.

If you put in items of sufficient value, you should be transported to the ''Garden of Life''. Once there, '''touch flower''', '''get seed''' (make sure the seed is in your right hand) and '''plant seed'''.

''Note: Only [[:Category: River's Rest gems|local River's Rest gems]] (including shells) count for triple their value in the deed cost calculation.''

=== [[Solhaven]] ===

Go to Lorminstra's temple on Liabo street. Enter the temple and find a curtain. Go curtain and close curtain. Kneel and place offering in the brazier. Light the brazier.

=== [[Ta'Illistim]] ===

{{RoomDescription
| roomname = Hall of Patrons, Rotunda
| rnum = 745
| desc = Eight arches supported by gold-veined marble columns encircle this large rotunda. A forged chandelier hangs suspended from the lofty, domed ceiling, illuminating the room. Six pedestals form a small circle beneath the chandelier, in the center of the rotunda.}}
OPEN the TOME on the pedestal and TURN the TOME to the PATRON of ILLISTIM, VAALOR, NALFEIN, ARDENAI, ASHRIM, LOENTHRA. Remember the image of the patron that appears on the page. Retrieve a taper from behind the silk-screened panel in the eastern room, light it with a candle, then find the meditation room dedicated to the patron. Place any offerings on the censer inside, then use the lit taper to light the censer and meditate.

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

Deeds can be acquired at the Garden of Ancients. '''Search vines''', then '''go door''' to enter the niche. '''Close door''' once you are inside. '''Pull hemp''' and '''open drawer''', place any offerings in the drawer, then '''close drawer'''.

=== [[Teras Isle]] ===

Getting a deed on Teras Isle involves doing a puzzle. This puzzle can be overwhelmingly difficult and so here are some guiding hints and the final answer.

Starting it...

:<span class="mw-customtoggle-start" style="color:#0000ff">Click Here to Expand a Starting Point Hint</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-start">
:Thoroughly explore the temple in town and talk to the priestess you find there.
</div>

The donation box...

:<span class="mw-customtoggle-hint1" style="color:#0000ff">Click Here to Expand a Helpful Hint</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-hint1">
:The donation box keeps track of what you put in so just keep adding to it until you've put in enough.
</div>

The skiff...

:<span class="mw-customtoggle-hint2" style="color:#0000ff">Click Here to Expand a Helpful Hint</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-hint2">
:The skiff only works for one, and only the person who initiates it. Attempting to initiate it will cause it to return if it's not already there.
</div>

Success versus failure...

:<span class="mw-customtoggle-hint3" style="color:#0000ff">Click Here to Expand a Helpful Hint</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-hint3">
:If you've done everything successfully you'll know within a few seconds of giving your offering. If you can't seem to give your offering there may already be one there that you can't see, so try "get bundle" to remove it and then put in yours.
</div>

This is pretty hard...

:<span class="mw-customtoggle-puzzle1" style="color:#0000ff">Click Here to Expand a Puzzle Hint</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-puzzle1">
:Numbers matter and several of the tiles have dual meaning as a result. Sound subtracts from sight.
</div>

Still too hard...

:<span class="mw-customtoggle-puzzle2" style="color:#0000ff">Click Here to Expand a Puzzle Hint</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-puzzle2">
:Assign a number value to all the tiles (seven is 7, twenty is 20, thirty-three is 33, death is 40). Sound subtracts from sight. Make sure to take notice of what symbols each wheel has.
</div>

I'm done with this, give me the answer...

:<span class="mw-customtoggle-answer" style="color:#0000ff">Click Here to Expand the Puzzle Answer</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-answer">
:Assign a number value to all the tiles (seven is 7, twenty is 20, thirty-three is 33, death is 40). What's the value of the eye? Subtract the number of gongs from that. Make the wheels total that number and then give your offering.
</div>

=== [[Wehnimer's Landing]] ===

There are multiple locations near Wehnimer's Landing where deeds can be acquired.

==== Temple ====

The first is at the Temple in Erebor Square (Room #4045). Once inside, '''go black arch''', then '''go tapestry'''. '''Hit chime with mallet''' twice, then '''kneel''', place any offerings of silvers or gems on the ground, then '''hit chime with mallet''' one last time.

==== [[Hearthstone Manor]] ====

Down the walkway in the herb garden is a wall covered in honeysuckle vines. Search the vines to find a hidden door. If the door is open, it is available. Enter the door, close it, pull the rope, open the draw, stuff it with broken lockpicks, pawnshop fodder such as drake weapons, [[magical item]]s such as wands, and/or everything made via [[Alchemy]]. Close the drawer when there is enough stuff in it, but the quantity to spell level to character level requirement is unknown. This is not a good method for getting deeds at high level as an incredible amount of magical items are required.

==== [[Northern Caravansary]] ====

There is a curtain in [[Small Wonders]] that functions similar to the Hearthstone Manor mechanism. Close the curtain, fill the brazier with magical items, kneel and light the brazier.

=== [[Zul Logoth]] ===

Visit Brother [[Barnstel]], the herbalist (lich room #9505). '''Ask''' him about deeds and he will give you a password ("ygrutha sans'ra"). Then '''go arch''', '''go hall''' and '''say''' the password. The small door in the room will open and you will enter it automatically.

You will be in a room with a series of murals and candles. You have to light two candles with a lighting stick that's in a cup on the first of two tables and put your offering in the bowl. The candles you light depend on your race and profession. These can be determined by examining the murals in the room, but they're also provided in the table below.

{|{{prettytable}}
|- bgcolor="Lightgrey"
|+Candle descriptions
| '''Profession'''
| '''Colour'''
| '''Race'''
| '''Shape'''
|-
| Bard
| yellow
| Aelotoi
| winged
|-
| Cleric
| orange
| Burghal Gnome
| petite
|-
| Empath
| purple
| Dark Elf
| thin medium
|-
| Paladin
| grey
| Dwarf
| short thick
|-
| Ranger
| green
| Elf
| medium
|-
| Rogue
| black
| Erithian
| delicate tall
|-
| Sorcerer
| blue
| Forest Gnome
| small slender
|-
| Warrior
| brown
| Giantman
| stocky tall
|-
| Wizard
| red
| Half-Elf
| slender tall
|-
|
|
| Half-Krolvin
| sturdy tall
|-
|
|
| Halfling
| round short
|-
|
|
| Human
| tall
|-
|
|
| Sylvan
| slim medium
|-
|}

So, for example, if you are a dwarven warrior, you will GET STICK FROM CUP, LIGHT STICK, LIGHT BROWN CANDLE, LIGHT STICK, LIGHT SHORT CANDLE and then put your gems in the offering bowl. Lastly, look in the silver holder. There is a tall golden candle in the holder. LIGHT GOLD CANDLE. What happens next depends on whether or not Lorminstra is pleased or displeased.

'''NOTE:''' There are only nine profession murals and nine corresponding candles in this room, so if you are a monk--the tenth and most recently added profession--you cannot get deeds in Zul Logoth.

== Cost ==
This formula works to obtain deeds through the tapestry in the black arch room in the Wehnimer's Landing Temple. This formula works for lower level characters. Higher level characters need to offer more than the formula calculates. The point at which it becomes inaccurate is currently unknown. The cost is based on experience and not level itself, which under GS3 worked because all levels (20+) were equal and so you could determine level off experience. This is easily seen where a character with 10 million experience can always get a deed for X amount while a character with 30 million experience can never get with the same amount.

<div {{prettydiv|margin-right=55%}}>'''Deed cost (in silvers) = 101 + (level * 100) + (deeds * 100)</div>

Example: a 99th level character with 7 deeds = 10701 silvers

<div {{prettydiv|margin-right=65%}}>101 + (99 * 100 = 9900) + (7 * 100 = 700)</div>

If using items (usually gems), a general estimate is 3x what they appraise for.
Using the example would mean a gem worth 3567 silvers. Err on the side of caution with this. The gem bonus does not seem to apply (at least not as substantially) in [[Ta'Vaalor]], but wands seem to apply to the 3x bonus, so they are a suggested substitute.

Using bank notes is possible but requires an additional cost of approximately 50% of the result of the formula above.

[[GameMaster]] Xayle, July 9th 2012:
<pre{{log2}}>
Xayle says, "The answer that I seem to be getting is this..."
Xayle says, "Different deed puzzles use different formulas."
You nod.
Xayle says, "And this one isn't working on the formula you're using."
You softly say, "I see."
You softly say, "That would explain it."
Xayle says, "I wish I could say more, but that would start straying into puzzle answering."
Xayle says, "Which is a nono."
</pre>

==Resources==
*[[Ta'Illistim deeds (script)]]

[[Category:Puzzles]]

Lich:Script Eloot

2026-02-10T01:46:38Z

HORIBU1: massive update to include all latest features of ELoot

{{3rd-party}}
{{TOCright| limit=2}}
ELoot is an automatic looting script for [[Lich]] and the spiritual successor to Sloot, borrowing and expanding on many of its original concepts. ELoot is actively maintained by the Elanthia-Online team.

'''Mark and register every item you value''' before using ELoot. Until you fully understand how the script handles your inventory, do not wear gem hoarding containers. Test your settings thoroughly before relying on ELoot during a hunting session.

==What Does It Do?==
ELoot automates common post-combat tasks:
* '''Looting''' — Gathers loot from killed creatures or the room and places items into your defined [[STOW]] containers, including overflow containers.
* '''Skinning''' — Skins creatures using your configured weapons.
* '''Box Handling''' — Drops boxes at the locksmith pool or town locksmith for opening, retrieves them, and loots their contents.
* '''Selling''' — Sells loot that meets your criteria at the appropriate shops and deposits coins at the bank.
* '''Gem & Alchemy Hoarding''' — Stores gems or alchemy reagents into jars in your locker for later use.

ELoot settings are saved per character, per game instance, in your Lich5 data folder (e.g., <code>lich-5/data/eloot/GSIV/Rinualdo.yaml</code>). To reuse settings across characters, copy and rename the <code>.yaml</code> file to match each character's name.

==How Do I Get It?==
Download ELoot from the repository:
<CODE>;repo download eloot</CODE>

Because ELoot is under active development and GemStone IV changes frequently, it is recommended to enable auto-updates:
<CODE>;repo set-updatable eloot</CODE>

ELoot scans your inventory each time it loads. Adding it to your Lich autostart ensures your container information is populated at the start of every session:
<CODE>;autostart add --global eloot start</CODE>

==How Does It Work?==
ELoot relies on the in-game [[STOW]] verb to determine your containers. '''You must configure your STOW settings in-game before ELoot will function.''' Unlike [[Sloot]], ELoot does not use <code>UserVars</code>.

To open the graphical configuration window, type:
<CODE>;eloot setup</CODE>

The setup window contains '''eight tabs''' described below, plus a status bar that reads "Your changes are saved automatically."

==Tab: Looting==
The Looting tab controls what ELoot picks up and how it handles the looting process. Item categorization is based on Lich's <code>gameobj-data.xml</code> file. When no exclusions are defined and all items on the ground match your criteria, ELoot uses the in-game <code>LOOT ROOM</code> command, which lets the game engine gather and place items based on your STOW settings.

===Loot Types===
A grid of checkboxes that tells ELoot which categories of items to pick up. Items can belong to multiple categories simultaneously (e.g., a weapon could be classified as a weapon, magical, valuable, and uncommon).

Available categories: Alchemy, Armor, Box, Breakable, Clothing, Collectible, Cursed, Food, Gem, Herb, Jewelry, Junk, Lockpick, Locksmith Traps, Magic, Reagent, Scroll, Skin, Uncommon, Valuable, Wand, Weapon.

===Other Settings===
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Loot in Defensive''' || Swaps to a defensive stance before looting if hostile creatures are present in the room.
|-
| '''Phase Boxes''' || Phases boxes if your character is able to do so.
|-
| '''Favor Left Hand''' || Uses your left hand for looting instead of the default right hand.
|-
| '''Log Unlootables''' || Tracks items ELoot could not pick up and logs them to the Unlootable section on the Looting Grid tab. If disabled, unlootable items are simply ignored.
|-
| '''Use Disk''' || Stores boxes in your disk if checked.
|-
| '''Use Group Disks''' || Allows ELoot to use group members' disks when looting boxes.
|-
| '''Keep Sacks Closed''' || Keeps your containers closed after looting. Note: this has a performance impact.
|-
| '''Track Full Sacks''' || ELoot tracks which containers are full to avoid repeated failed stow attempts. Turn this off if you do not sell with ELoot.
|-
| '''Sigil of Determination on Fail''' || Uses Sigil of Determination if looting fails because your character is too injured.
|-
| '''Bloodtooth Bands''' || If your character wears Bloodtooth Bands and a Bloodtooth Bracer, ELoot will use RAISE on dead creatures that can bleed to gain Blood Bank charges.
|-
| '''Coin Hand''' || The name of your coin hand container (e.g., a coin purse or pouch that picks up coins automatically).
|-
| '''Charm Name''' || The name of a charm item, if applicable.
|-
| '''Overflow Containers''' || A comma-separated list of container names to use when your default STOW containers are full. These should '''not''' be your default stow container or box container. For example, if your default container is a cloak and your box container is a backpack, choose different items like "satchel, knapsack" as overflow.
|-
| '''Gambling Kit (Min Silvers)''' || The minimum number of coins you must be holding before ELoot will toss coins into your gambling kit. Incurs 2 seconds of roundtime.
|}

==Tab: Looting Grid==
The Looting Grid tab provides editable lists for fine-tuning looting behavior. Each list supports adding and deleting entries one at a time. Regular expressions (regex) are supported for advanced matching.

===Never Loot (Exclusions)===
Items to never pick up, entered by noun or regex pattern. Common exclusions include <code>black ora</code> and <code>urglaes</code> for non-Cleric characters that cannot safely handle cursed materials.

'''Example entries:'''
* <code>black ora</code>
* <code>(?:aquamarine|gold) wand</code> — matches "aquamarine wand" or "gold wand"

===Always Loot===
Items to always pick up regardless of other settings. Entered by noun or regex pattern, one per line.

===Creature Exclusions===
Creatures you do not want ELoot to loot, such as those that injure you when searching. Entered by creature name or regex pattern.

'''Example entries:'''
* <code>Vvrael destroyer</code>
* <code>(?:big ugly|mongrel) kobold</code>

===Unlootable===
Items that ELoot has previously been unable to pick up are tracked here (if "Log Unlootables" is enabled on the Looting tab). This can happen when another player or group member picks up an item before ELoot finishes processing. Items on this list will not be attempted again. You can manually remove entries from this list if the item was only temporarily unlootable.

==Tab: Boxes==
The Boxes tab controls how ELoot handles lockbox processing — locksmith pool usage, tipping, and scripts to run between pool and selling steps.

===Locksmithing===
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Use Town Locksmith''' || Sends boxes to the town locksmith instead of the pool.
|-
| '''Use Locksmith Pool''' || Sends boxes to the player-run locksmith pool for opening.
|-
| '''Always Check Pool''' || If checked, ELoot always checks the pool for returned boxes, even if you have no boxes to drop off. Default behavior only checks the pool when you have a box to deposit.
|-
| '''Use Locksmith When Gem Bounty''' || Always routes through the locksmith when you have an active gem bounty, so you can recover gems from boxes.
|-
| '''Display Box Contents''' || Shows the contents of boxes as they are opened and looted.
|-
| '''Bank Withdrawal Amount''' || The amount of silver to withdraw from the bank for locksmith tips.
|}

===Tipping===
Two tipping modes are available. Only one can be active at a time:

'''Standard Tipping''' — A fixed tip amount or percentage applied to every box.
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Tip Amount''' || The silver amount or percentage to tip per box.
|-
| '''Tip as Percentage''' || If checked, the tip amount is treated as a percentage of the box's value rather than a flat silver amount.
|}

'''Incremental Tipping''' — Your tip scales upward as your box count in the pool grows. This rewards locksmiths who handle larger batches.
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Base Tip''' || The minimum starting tip.
|-
| '''Max Tip''' || The maximum tip cap.
|-
| '''Alpha Rate''' || Controls how quickly the tip scales between the base and max values. A higher alpha rate means the tip rises more steeply.
|-
| '''Test''' || Click the "Test" button to see a preview chart of what your incremental tips would look like at various box counts.
|}

===In-between Scripts===
A list of scripts (with optional parameters) to run after the locksmith pool step finishes but before the selling routine begins. This is useful for running utility scripts like repair, organize, or other automation between steps.

'''Format:''' <code><script name> <option1 option2 option3></code>

==Tab: Selling==
The Selling tab defines what ELoot sells, where it sells, and how it handles special items.

===Sell Types===
Checkboxes for each item category ELoot should sell. Notes on specific types:
* '''Box''' — Sells empty gold, mithril, and silver boxes to the pawnshop.
* '''Food''' — Food cannot be sold; it will be thrown away or dropped.
* '''Herb''' — Herbs cannot be sold; they will be thrown away or dropped.
* '''Junk''' — Junk cannot be sold; it will be thrown away or dropped.
* '''Breakable''' — Porous chunks of rock (from The Hive, released 12/17/2023) that need to be broken so their contents can be sold.

===Only Sell from These STOW Containers===
Checkboxes for each STOW container type. If a container is unchecked here, ELoot will not sell items from it. This is useful if you have a container with items you want to keep. '''Test thoroughly''' before relying on this setting.

===Appraisals===
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Appraise Types''' || Select which item categories ELoot should appraise before selling.
|-
| '''Gemshop Limit''' || Items appraised above this value at the gemshop will not be sold (default: 14,999). These may be enhancive or otherwise valuable and warrant player inspection.
|-
| '''Pawnshop Limit''' || Items appraised above this value at the pawnshop will not be sold (default: 34,999).
|-
| '''Appraisal Container''' || Optionally specify a container to use during the appraisal process.
|}

Items flagged by the appraisal system will not be sold during the current session, and ELoot will notify you. If you restart the session, ELoot will attempt to appraise and potentially sell those items again.

===Trash to Dump===
A configurable set of item types to throw in the trash after the selling routine finishes. An item type must also be enabled for selling in order to be eligible for dumping. Available types include: Alchemy, Box, Breakable, Clothing, Food, Herb, Junk, Lockpick, Locksmith Traps, Reagent, Wand.

===Other Settings===
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Deposit Collectibles''' || Deposits collectible items at the town collection location.
|-
| '''Sell Gold Rings''' || Delivers gold rings to the chronomage/chronomaster.
|-
| '''Sell in FWI''' || Sells items in Four Winds Isle. Bounty items will still be sold in your original town.
|-
| '''Use Shroud (1212/1205)''' || Uses Cloak of Shadows (1212) or Shadow Mastery (1205) during selling, if known.
|-
| '''Use Aspect (650)''' || Uses Assume Aspect — Lion (650) during selling, if known.
|-
| '''Share Silvers''' || Shares silvers with your group after selling.
|-
| '''Keep Silver''' || Keeps a specified number of silvers on your character after selling and depositing, rather than depositing everything.
|-
| '''Deposit Coin Hand''' || Deposits the contents of your coin hand container when depositing at the bank.
|}

==Tab: Selling Grid==
The Selling Grid tab provides editable lists for fine-tuning selling behavior.

===Exclusions===
Items to exclude from selling, entered by noun or regex pattern, one per line. Regular expressions are supported.

'''Example:''' <code>(?:aquamarine|gold) wand</code> and <code>gold ring</code> as separate entries.

===Keep Scrolls===
A list of spell numbers whose scrolls ELoot should '''not''' sell. Your character must have the appropriate training to read scrolls in order for ELoot to identify the spell on a given scroll.

'''How to add entries:'''
* Enter just the spell number (e.g., <code>101</code>) for regular scrolls.
* Enter the spell number followed by <code>v</code> or <code>vibrant</code> (e.g., <code>401v</code> or <code>401 vibrant</code>) to keep vibrant scrolls of that spell.

==Tab: Skinning==
The Skinning tab configures creature skinning behavior.

===Settings===
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Enable Skinning''' || Master toggle to enable or disable skinning.
|-
| '''Kneel to Skin''' || Kneels before skinning for a bonus.
|-
| '''Use Spell 604 (Skinning)''' || Casts Ranger spell 604 (Resist Elements) before skinning for a bonus.
|-
| '''Use Sigil of Resolve''' || Uses the Sunfist Sigil of Resolve before skinning for a bonus.
|}

===Edged Skinning===
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Skin Sheath (edged)''' || The name of the container that holds your edged skinning weapon.
|-
| '''Skin Weapon (edged)''' || The name of your edged skinning weapon.
|}

===Blunt Skinning===
Some creatures require a blunt weapon to skin. If your creature list includes such creatures, fill out these fields as well.
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Skin Sheath (blunt)''' || The name of the container that holds your blunt skinning weapon.
|-
| '''Skin Weapon (blunt)''' || The name of your blunt skinning weapon.
|}

===Skinning Exclusions===
A list of creatures you do not want ELoot to skin, entered by creature name or regex pattern, one per line.

==Tab: Gem Hoarding==
The Gem Hoarding tab allows you to store gems in jars inside your locker instead of selling them. This is useful for fulfilling gem bounties or accumulating valuable gems over time.

'''Hoarding Notes:''' Requires jars to store items. ELoot can use any size jar and will use empty jars for new gem types. ELoot does not buy jars. Full jars are skipped.

===Settings===
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Hoard Gems''' || Master toggle. When enabled, defaults to hoarding all gems unless modified by the lists below.
|-
| '''Use Locker''' || Stores hoarded gems in your locker.
|-
| '''Hoard Container''' || The specific container in your locker to use for gem jars.
|-
| '''Containers to Hoard From''' || Select which STOW containers ELoot should pull gems from for hoarding (default: "default" and "gem").
|-
| '''Use Overflow''' || Also hoard gems found in overflow containers.
|-
| '''Turn-in for Bounty''' || Enables automatic retrieval of gems from your hoard for gem bounties.
|-
| '''Use CHE Locker''' || If your locker is inside a CHE (Cooperative House of Elanthia), provide the room IDs, entry command, and exit command.
|}

===Gem Lists===
Two list modes control which gems are hoarded:
* '''Everything List''' — If enabled, shows the full master list of all known gems. You can remove entries you do NOT want to hoard.
* '''Only List''' — If enabled, ELoot will ONLY hoard gems that appear on this list. Add specific gem names to hoard just those.

===Locker Location===
Enter the room number(s) for your locker. If using a CHE locker, provide the room list, entry command, and exit command. ELoot will try each locker location in order; if one is occupied, it moves to the next. After cycling through all locations, it pauses 10 seconds and starts over.

==Tab: Alchemy Hoarding==
The Alchemy Hoarding tab works identically to the Gem Hoarding tab but for alchemy reagents. All the same settings and list behaviors apply.

===Settings===
{| class="wikitable"
|-
! Setting !! Description
|-
| '''Hoard Reagents''' || Master toggle for alchemy reagent hoarding.
|-
| '''Use Locker''' || Stores hoarded reagents in your locker.
|-
| '''Hoard Container''' || The specific container in your locker to use for reagent jars.
|-
| '''Containers to Hoard From''' || Select which STOW containers ELoot should pull reagents from (default: "default" and "reagent").
|-
| '''Use Overflow''' || Also hoard reagents found in overflow containers.
|-
| '''Use CHE Locker''' || Same CHE locker support as the Gem Hoarding tab.
|}

===Reagent Lists===
* '''Everything List''' — Master list of all known reagents. Remove entries you do NOT want to hoard.
* '''Only List''' — Only hoard reagents that appear on this specific list.

==Command Line Interface (CLI)==

All ELoot commands are entered using the Lich command prefix (typically <code>;</code>).

===Basic Commands===
{| class="wikitable"
|-
! Command !! Description
|-
| <code>;eloot setup</code> || Opens the graphical configuration window.
|-
| <code>;eloot</code> || Loots items and creatures in the current room.
|-
| <code>;eloot ground</code> || Loots open boxes on the ground.
|-
| <code>;eloot sell</code> || Runs the full selling routine based on your UI settings.
|-
| <code>;eloot sell alchemy_mode</code> || Sells loot but skips selling alchemy reagents.
|-
| <code>;eloot deposit</code> || Deposits coins and notes at the bank without selling.
|-
| <code>;eloot skin</code> || Skins dead creatures in the room without looting.
|-
| <code>;eloot box</code> || Loots a box currently in your hand, then returns to your starting room.
|}

===Locksmith Pool Commands===
{| class="wikitable"
|-
! Command !! Description
|-
| <code>;eloot pool</code> || Runs the full locksmith pool cycle (deposit boxes and check for returns).
|-
| <code>;eloot pool deposit</code> || Only deposits boxes at the locksmith pool (does not check for returns).
|-
| <code>;eloot pool return</code> || Only checks the pool for returned (opened) boxes.
|}

===Custom Selling Commands===
These commands let you sell specific items without using the full UI-configured sell routine. Useful for one-off selling tasks.
{| class="wikitable"
|-
! Command !! Description
|-
| <code>;eloot --sellable <categories></code> || Sells items matching GameObj sellable categories (e.g., <code>;eloot --sellable gem,scroll</code>).
|-
| <code>;eloot --type <types></code> || Sells items matching GameObj type classifications.
|-
| <code>;eloot --sell <items></code> || Sells specific named items.
|}

===Hoarding Commands===
{| class="wikitable"
|-
! Command !! Description
|-
| <code>;eloot list gem</code> || Displays your hoarded gem inventory.
|-
| <code>;eloot list reagent</code> || Displays your hoarded alchemy reagent inventory.
|-
| <code>;eloot reset gem</code> || Resets your hoarded gem inventory tracking and re-lists it.
|-
| <code>;eloot reset reagent</code> || Resets your hoarded reagent inventory tracking and re-lists it.
|-
| <code>;eloot deposit gem</code> || Deposits gems from your containers into your hoard locker.
|-
| <code>;eloot deposit reagent</code> || Deposits reagents from your containers into your hoard locker.
|-
| <code>;eloot raid gem <item> x<amount></code> || Retrieves a specific gem from your hoard. Example: <code>;eloot raid gem blue diamond x5</code>
|-
| <code>;eloot raid reagent <item> x<amount></code> || Retrieves a specific reagent from your hoard.
|-
| <code>;eloot bounty</code> || Retrieves gems from your hoard that match your current gem bounty.
|}

===Troubleshooting Commands===
{| class="wikitable"
|-
! Command !! Description
|-
| <code>;eloot help</code> || Displays the in-game help table.
|-
| <code>;eloot debug</code> || Toggles debug messaging on or off.
|-
| <code>;eloot debug file</code> || Toggles logging debug output to a file on or off.
|-
| <code>;eloot test</code> || Displays all current variables, settings, containers, disk status, and inventory information.
|-
| <code>;eloot list</code> || Lists all current script settings in a table.
|-
| <code>;eloot options</code> || Lists all available setting keys (useful for CLI-based setting changes).
|-
| <code>;eloot settings <key> <value></code> || Changes a specific setting via CLI (for use when GTK is not available).
|-
| <code>;eloot load</code> || Reloads your settings profile and rescans inventory.
|}

==Quick Start Guide==
# Configure your in-game [[STOW]] settings (e.g., <code>STOW SET default cloak</code>, <code>STOW SET box backpack</code>, <code>STOW SET gem pouch</code>).
# Download ELoot: <code>;repo download eloot</code>
# Start ELoot to initialize: <code>;eloot start</code>
# Open the configuration: <code>;eloot setup</code>
# On the '''Looting''' tab, check the loot types you want to pick up.
# On the '''Selling''' tab, check the sell types and configure your locksmith and bank preferences.
# If you skin creatures, configure the '''Skinning''' tab with your weapon details.
# If you want to hoard gems or reagents, configure the '''Gem Hoarding''' or '''Alchemy Hoarding''' tabs.
# Add ELoot to your autostart: <code>;autostart add --global eloot start</code>
# '''Test with marked/registered items first!'''

==In-game Screenshots==
<gallery perrow="4">
File:eloot-1.PNG|Looting
File:eloot-2.PNG|Selling
File:eloot-3.PNG|Skinning
</gallery>

==Changelog==
<span class="mw-customtoggle-mychangelog" style="color:#0000ff">Click to expand</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-mychangelog">
v2.7.1 (2026-01-27)
- replaced overflow_container and secondary_overflow with single overflow_containers setting (comma-separated)
- added configurable "Trash to Dump" section, instead of hardcoded herb/food/junk
- bugfix inbetween script(s) added erroneous commas between script parameters
- allow custom bank withdraw amount
- bugfix when trying to store box in non-group disk
- bugfix in box_loot_ground locked box message
- bugfix in single_drag_box cycling thru all group disks even when use_disk_group was false
- bugfix for eonake gauntlet missing XML to properly match
- bugfix for in_region check if already in destination room
- reset sacks full when using --sellable/type/sell CLI
v2.7.0 (2026-01-19)
- added ground looting of boxes
- added support for group disks when looting boxes
- added selling of ingots if too heavy to store
- updated find_trash to fully use trash verb
- general inventory code cleanup
- bugfix for depositing extra silver in pool method
- bugfix in go2_locker to stop withdrawing silver when using house locker
v2.6.7 (2026-01-18)
- bugfix in silver breakdown
v2.6.6 (2026-01-17)
- bugfix for bank withdraw
- disable f2p locksmith pool
v2.6.5 (2026-01-16)
- update for new loot commands in locksmith pool
v2.6.4 (2026-01-12)
- increase upper limit of appraisal amount from 1,000,000 to 10,000,000
v2.6.3 (2025-12-02)
- bugfix trying to skin/loot failed bounty children npcs
- update debug messaging
- bugfix in blood band/bracer settings
v2.6.2 (2025-11-21)
- force looting of bounty heirloom items if found
v2.6.1 (2025-11-11)
- bugfix in open_loot_containers
- bugfix in get_weapon_inv
v2.6.0 (2025-10-26)
- add bloodband support
- bugfix for save_trash_box method
- bugfix box tipping default missing on first run
- bugfix for open_single_container when using a string
- moved tooltips out of UI xml
v2.5.7 (2025-10-19)
- bugfix for debt when entering locker
v2.5.6 (2025-10-08)
- bugfix for store/ready ranged_weapon to ranged
v2.5.5 (2025-10-05)
- bugfix for non-standard ready/stow list items
v2.5.4 (2025-10-04)
- bugfix for nil items
- bugfix in logic for return_hands
v2.5.3 (2025-10-03)
- bugfix for return_hands
- toggle righthand and lefthand off at initialization
- minimum lich version to 5.12.9
v2.5.2 (2025-10-02)
- bugfix for incorrect method call typo
v2.5.1 (2025-09-30)
- bugfix for store/ready secondary_weapon to 2weapon
v2.5.0 (2025-09-19)
- switch to using Lich methods ReadyList and StowList
- removed change log in script before 2.4.0. Full change log on the wiki
- fix for SG trash can
v2.4.11 (2025-09-12)
- add option to always use the locksmith when a gem bounty is active
v2.4.10 (2025-09-06)
- rework box contents check to store box instead of pausing
- bugfix for looting coins on the ground
v2.4.9 (2025-09-05)
- bugfix in regex for use_coin_hand method
v2.4.8 (2025-08-30)
- bugfix for setting ELoot.data.coin_bag_full to false when empty.
v2.4.7 (2025-08-15)
- if debug to file enabled, allow for when started with a parameter (sell/pool/etc)
v2.4.6 (2025-08-12)
- fix encumbered after box opening by depositing silvers in process_boxes
v2.4.5 (2025-07-22)
- bugfix for default locksmith_withdrawl_amount
v2.4.4 (2025-07-16)
- allow customizable locksmith tip amount withdrawal
- typo correction in bulk sell gem method
- force clean overflow containers from sell_container list
- utilize File.join for save/load
- bugfix in pool_return to allow up to 2 seconds for GameObj right/left hand to populate
- remove Unicode characters in formula explanation for scaled box tipping (non-logic change) / Warlock
v2.4.3 (2025-07-15)
- bugfix for town locksmith regex to open box after return being too generic
v2.4.2 (2025-07-09)
- bugfix for silver withdrawals failing on f2p accounts with low bank balances
v2.4.1 (2025-06-05)
- bugfix for unable to lighten load during pool return and no silvers to deposit to allow more boxes to be returned
- bugfix for box loot to deposit coins if too many coins on yourself to be able to loot coins from box
- change class checks to is_a? checks
v2.4.0 (2025-05-21)
- add CLI option to skin only
- fix regex for sellable/type/sell CLI to make = optional to match help text
v2.3.12 (2025-05-10)
- fix for Pinefar banker withdraw/deposit
- fix for disk/container contents being nil prior to storing an item
v2.3.11 (2025-05-05)
- fix find_boxes to now clear sacks found with boxes from sacks_full
- bugfix in regex for pool parameters to match help text
- general sanitation of GTK values on load and close of GTK window
- bugfix in incremental tipping display chart
- bugfix in locksmith_pool_count due to truncated results list returning incorrect list of boxes unopened
- correctly display incremental tipping chart starting at base 0
v2.3.10 (2025-04-28)
- bugfix in locksmith_tip to ensure numerics incase of string values saved in yaml
v2.3.9 (2025-04-27)
- bugfix add coin bag full msg'ing to regex
v2.3.8 (2025-04-22)
- bugfix for older Ruby 2.6 users and Bounty.task.assigned?
v2.3.7 (2025-03-27)
- add ;eloot pool return to options
- bugfix for Rift talons gem hoarding
- bugfix in get_regex to support hidden dagger harness
- bugfix in check_type for hoarding HW hyphenated gem names
- bugfix for locker reset while hoarding
- bugfix in wait_for_disk logic
- bugfix for spinbutton
- add additional in_region boundaries and convert to UID lookup
- bugfix for note deposit when using urchin guide and bounties
v2.3.6 (2025-03-15)
- typo for horde to hoard
- bugfix to deposit local note if selling in FWI
- bugfix in gem name standardization
- remove deprecated percentstance & percentencumbrance calls
- bugfix to not timeout on creatures that get ressurrected
- bugfix on find_weapons_ready_list
- bugfix in looting gemstone jewels if both hands currently used
- bugfix in validate_setup when toggling on/off skinning
v2.3.5 (2025-03-14)
- additional updates to put_regex and get_regex
- bugfix to not Regexp escape loot_keep
v2.3.4 (2025-03-11)
- bugfix for spin buttons not saving properly
- add debug for loot method
v2.3.2 (2025-03-10)
- update to appraise method
- fix for monsterbold gemstone jewel drop msging at feet
v2.3.1 (2025-03-09)
- add space for regex_at_feet
v2.3.0 (2025-03-09)
- add support for gambling kits
- update for gemstones
- bugfix when ELoot.data.settings[:loot_keep] is nil
- bugfix when emptying jars to add to empty jar count
- bugfix in store_item when gem hoarding
- bugfix for weapon displayer
- bugfix for container_contents
- broke up the set_inventory method into smaller sections
- bugfix add daybringer put_regex match
- bugfix for swordbelts and neck sheaths
v2.2.3 (2025-03-03)
- added support for Lock & Key gameobj types to loot_special and loot_regular
- bugfix in Bounty.task usage for gem/skin
v2.2.2 (2025-02-28)
- bugfix in Region.in_region for HW/Cold River
v2.2.1 (2025-02-26)
- bugfix in check_bounty_gems using furrier instead of gemshop
v2.2.0 (2025-02-24)
- add locker support for IMT
- bugfix for FWI sell if bounty active
- add check_bounty_gems to sell non-bounty gems during bounty
- add sell only to sellable_categories
- change to use_silver_deposit
- bugfix for Lich GameObj update for loot containers (v5.12.0+)
v2.1.7 (2025-01-30)
- bugfix in loot_creature to handle nil creature
- bugfix in sell_locksmith_pool_tip type check
- additional gemshop regex updates
v2.1.6 (2025-01-15)
- bugfix in custom sellable/type/sell regex
- bugfix in sell_gem method for gemshop
v2.1.5 (2024-12-15)
- bugfix in silver breakdown
- bugfix for missing sell_appraise_types default
v2.1.4 (2024-12-01)
- add appraisal container setting
- bugfix in regex for locksmith pool
v2.1.3 (2024-11-20)
- bugfix for sell_fwi bounty check
- bugfix in sell keep scrolls vibrant
v2.1.2 (2024-11-10)
- add support for scarab selling
- bugfix in sell_keep_scrolls loader
v2.1.1 (2024-10-28)
- bugfix in sell container list
v2.1.0 (2024-10-15)
- add incremental tipping system
- add between-scripts support for locksmith pool
- rework box handling flow
- bugfix in silver tracking
v2.0.0 (2024-09-01)
- major rewrite of selling logic
- add Selling Grid tab
- add Looting Grid tab
- add Gem Hoarding tab
- add Alchemy Hoarding tab
- improved UI with 8-tab layout
- add CLI --sellable, --type, --sell commands
v1.5.27 (2023-03-30)
- additional find_trash method changes to utilize meta:trashcan
v1.5.26 (2023-03-30)
- added "wastebin" to list of trashcans
v1.5.25 (2023-03-25)
- another try at finding the trashcan
v1.5.24 (2023-03-23)
- added additional trashcan identification if no room description available
v1.5.23 (2023-03-22)
- added open regex for container
v1.5.22 (2023-03-08)
- bugfix for updating setting on nil for Ruby v3
v1.5.21 (2023-03-06)
- bugfix for bag_loot method
v1.5.20 (2023-02-25)
- bugfix for scroll selling in setup
v1.5.19 (2023-02-22)
- added toggle for unlootable tracking
v1.5.18 (2023-02-07)
- added additional error checking for autoclose bags
v1.5.17 (2023-02-01)
- added support for Assume Aspect - Lion (650)
v1.5.16 (2023-01-31)
- added child to unlootable list
v1.5.15 (2023-01-30)
- bug fix for wait_for_disk method
v1.5.14 (2023-01-22)
- added support for plinite looting
v1.5.13 (2023-01-22)
- add RT check to retrieving weapon/shield after looting
- added support to not sell alchemy items: ;eloot sell alchemy_mode
v1.5.12 (2023-01-17)
- add check to prevent trying to loot something that's not yours
v1.5.11 (2023-01-13)
- add extra output to eloot test (disk and full containers)
v1.5.10 (2022-12-23)
- fixed location bug for locksmithing in KF
v1.5.9 (2022-12-05)
- added unlootable list to the UI (bottom of loot tab)
- bugfix for trying to put loot in full container
v1.5.8 (2022-12-05)
- added word boundary checks for container setup
- bug fix for phased box's
v1.5.7 (2022-11-27)
- removed custom quiet command to use Lich command instead
- fixed bug if encumbered at the locksmith and can't get the box out of the disk
- fixed bug for ice elemental looting
v1.5.6 (2022-11-11)
- added an "Always Loot" list
- added support for auto closing bags
- bug fix for handling reliquaries
- bug fix for skinning without a designated skinning tool
v1.5.5 (2022-11-03)
- bugfix for unlootable tracking
v1.5.4 (2022-11-01)
- bugfix for silver totals
v1.5.3 (2022-10-31)
- added check for unlootable items
v1.5.2 (2022-10-29)
- added muck and cloud to unlootable list
v1.5.1 (2022-10-28)
- bugfix for terminal-table silver breakdown
v1.5.0 (2022-10-09)
- removed dependancy on separate UI file and associated code
- cleaned up inventory & looting logic
- added support to always check the locksmith pool
- fixed bug that was looting cursed items in boxes
- added validation check for setup
- silver summary at end of selling using terminal-table
- archived change log before 1.4.0
- adds CLI interface to update settings
v1.4.22 (2022-09-25)
- bug fix for cursed items in boxes
v1.4.21 (2022-09-23)
- added support for hidden skin sheathes
- bug fix for crumbly bandit bandanas
- locksmith pool functionality added: over encumbered coin deposit and box drop off only option
- fixed bug in track_full_sacks default setting
- fixed bug when trying to do initial load when in RT
- added small delay to ;eloot start
v1.4.20
- bug fix for cursed items and some crumbly ones
v1.4.19
- fixed looting logic when its flagged as two items with one not wanted (eg. uncommon & clothing). It will pick up the item to prevent valuable items getting left behind
- additional error checking for empty box's in containers
- additional error checking for looting
- added support to use left hand for looting
- added support for users who don't sell with eloot (full container tracking)
- added secondary overflow container
- moved UI check only when loading or setup
v1.4.18
- follow-up typo fix for default crumbly list
v1.4.17
- add rough leather quiver to the default crumbly items
v1.4.16 (2022-08-23)
- fixed typo in overflow setting
v1.4.15 (2022-08-23)
- changed regex for scabbards again
v1.4.14 (2022-08-19)
- will sell bounty items in original town if selling in FWI
- added regex for custom scabbard
- reworked data loading, should be faster now
- changed the container identification to skip non-worn containers (helps with getting the correct skinning sheath)
v1.4.13
- empty gold, silver, mithril boxes if selling them
- fixed trying to loot gangplank
- fix for stancing with verbose turned on
v1.4.12
- fixed duplicate container saving
- fixed bug in box looting that wasn't recognizing box found armor/weapons
v1.4.11 (2022-08-02)
- added support for looting coins on the ground
v1.4.10 (2022-07-28)
- more edits for locksmithpool not recognizing worker
v1.4.9 (2022-07-28)
- another edit to the locksmith pool
v1.4.8 (2022-07-20)
- close sacks function had a bug preventing it from working
- additional changes for the load delay in locksmith pool
v1.4.7 (2022-07-09)
- fix for object load delay in locksmith pool
v1.4.6 (2022-07-09)
- added option to deposit coins/notes without sell routine
- fixed bug in empty box selling causing it to duplicate
v1.4.5
- performance improvement in selling and storing items
- added logic to address having a box in hand at start of sell routine.
- added support to loot a box in hand then exit - ;eloot box
v1.4.4
- added skin matching for alchemically ruined skins
v1.4.3
- added support for skinning rotting chimera's when they have scorpion tails
v1.4.2 (2022-06-15)
- bug fix in blunt skinning
v1.4.1 (2022-06-15)
- bug fix for disks
v1.4.0 (2022-06-10)
- added support for shroud and glamour
- added check in valid loot routine to exclude disks
</div>

==Reference==

{{Third-Party Software}}

Lich:Script Bigshot

2026-02-09T16:57:34Z

HORIBU1: /* Command Checks */ add ES/EB/EC/ED for effects tracking

{{3rd-party}}
Bigshot is a fully automated hunting script for GemStone IV. It handles combat routines, movement to and from hunting areas, target selection, and attack execution.
AFK scripting on any server other than Shattered is a violation of game policy.
{{TOCright| limit=2}}
==Changelog==
*[[Script Bigshot/Changelog|Script Bigshot Changelog]]
==About Bigshot==
===What Does Bigshot Do?===

Using a series of menus and command inputs, Bigshot lets you create a modular, customizable, and fully automated hunting script. With just a few clicks and tweaks, you can go from scripting rats to the Rift.

===How Do I Get It?===

Grab it from the repository: <CODE>;repository download Bigshot</CODE>

===How Do I Make It Go?===
Initial setup is accessed through <CODE>;bigshot setup</CODE>. This opens a configuration window with several tabs for setting up your hunting routine.

As with most scripts, the SETUP command opens a graphical user interface. Use <CODE>;bigshot setup</CODE> to open the dialog. The window contains the following tabs:
* '''Profile''' - Save and load profile configurations. Profiles are saved to your <CODE>\Lich5\data\<GSServer>\<charname>\bigshot_profiles</CODE> directory (e.g., <CODE>\Lich5\data\GSIV\Rinualdo\bigshot_profiles</CODE>). Note: if you previously used Bigshot, the file location has changed from the old <CODE>\Lich5\scripts\bigshot_profiles</CODE> folder. You can copy/paste your old profiles to the new location.
* '''Resting''' - Configure your resting routine, rest location, and conditions that trigger resting.
* '''Hunting''' - Create a hunting map using boundaries, set your starting room, configure attack/wander stances, and define pre-hunt behavior.
* '''Attacking''' - Configure ambush aiming, flee conditions, bless behavior, weapon reactions, and similar combat flags.
* '''Commands''' - Define your valid targets and associated attack routines. See sample routines below.
* '''Boon Creatures''' - Configure how Bigshot handles boss/boon creatures on a per-ability basis (fight, ignore, or flee).
* '''Misc''' - UAC options, MSTRIKE options, ammo/wand configuration, and MA grouping settings.
* '''Monitoring''' - Interaction monitoring, deadman's switch, depart behavior, and debug options.

Each tab is covered in detail further on.

===Other Commands===
Beyond the setup GUI, Bigshot has several command-line options:
* <CODE>;bigshot quick</CODE> - A special hunting mode that kills everything in your current room, then quits. It will not wander or attempt to rest. Uses its own separate hunting commands and targets (configured on the Commands tab).
* <CODE>;bigshot head</CODE> / <CODE>;bigshot tail</CODE> - Multi-account hunting on a single computer. All characters must be set up for the same hunting area. Following characters run <CODE>;bigshot tail</CODE>, then the leader runs <CODE>;bigshot head</CODE>. The leader can optionally specify the expected group size, e.g., <CODE>;bigshot head 3</CODE>. Head and tail can be started in any order.
* <CODE>;bigshot display</CODE> - Shows all your current settings.
* <CODE>;bigshot reset</CODE> - Resets your targetable and untargetable lists. Useful if Bigshot will not target something it should.
* <CODE>;bigshot ranger</CODE> or <CODE>;bigshot companion</CODE> - Resets the ranger companion setting so you can reconfigure it. Use this when you change your companion.
* <CODE>;bigshot profile save <name></CODE> - Saves a profile in YAML format to your character's profile folder. Also accessible via the Profiles tab.
* <CODE>;bigshot profile load <name></CODE> - Loads a profile from your character's profile folder. Also accessible via the Profiles tab.
* <CODE>;bigshot single</CODE> - Executes a single hunting routine, returns to your resting location, and then exits.
* <CODE>;bigshot list</CODE> - Displays all initialized variable values (useful for troubleshooting).
* <CODE>;bigshot test <method> <args></CODE> - Runs a specific internal method for testing purposes.
* <CODE>;bigshot <creature></CODE> - Any input that does not match the above commands defaults to ranger tracking (e.g., <CODE>;bigshot single giant rat</CODE> will track and hunt a giant rat).

==The Profile Tab==
* '''Load Profile''' - Load an existing saved profile. The dropdown will be empty if no profiles have been saved yet.
* '''Current Profile''' - Displays the name of the currently loaded profile.
* '''Save Profile''' - Enter any name for your profile and click Save. Once saved, the profile will appear in the Load Profile dropdown.
* '''Notes''' - A freeform text area for any notes you want to associate with the profile.

==The Resting Tab==
This tab controls where and how Bigshot rests between hunts. During rest mode, Bigshot checks your mind state, hit points, wound status, mana, and spirit. Once all conditions defined in the "Should Hunt?" section are met, Bigshot leaves rest mode and begins a new hunt.

===Where to Rest===
* '''room id''' - The room Bigshot returns to for resting. Uses room numbers from Map/Go2. Supports both Lich IDs and SimuIDs (prefix SimuIDs with "u", e.g., <CODE>228</CODE> for Town Square Central or <CODE>u7120</CODE>).
* '''return waypoints''' - Optional intermediate room IDs that Bigshot will pass through when returning to rest. Separate multiple waypoints with commas.
* '''pre-rest commands''' - Commands executed before entering rest mode. Example: <CODE>shea, wear shield, sit, stance offensive, rest</CODE>. This will sheathe your weapon, wear your shield, sit down, enter offensive stance, and use the REST verb. You can also call scripts here using the <CODE>script</CODE> prefix, e.g., <CODE>script go2 place</CODE>.
* '''active resting scripts''' - Scripts that run upon entering rest mode for between-hunt tasks such as selling loot, spelling up, or healing. Example: <CODE>eloot sell, waggle, eherbs</CODE>. This will sell via eloot, spell up via waggle, then use herbs from your PACK to heal wounds.
* '''Fog Option''' - Determines how Bigshot returns to rest. Options include:
** '''None''' - Walk normally (no teleportation).
** '''130''' - Uses [[Spirit Guide (130)]] first; falls back to Symbol of Return if it fails.
** '''Symbol of Return''' - Uses Voln [[Symbol of Return]] first; falls back to 130 if it fails.
** '''Traveler's Song (1020)''' - Attempts [[Traveler's Song (1020)]] once, then continues.
** '''Familiar Gate (930)''' - Attempts [[Familiar Gate (930)]] to summon a portal and walk through it. Will perform a mana pulse if not enough mana is detected.
** '''Sigil of Escape''' - Uses [[Sigil of Escape]].
** '''Custom''' - Allows a comma-separated list of custom commands to perform.
* '''Fog ONLY if wounded or encumbered''' - When checked, Bigshot will only use the fog option if you are actually wounded or encumbered. Otherwise it walks normally.
* '''Fog twice from the Rift''' - When checked, Bigshot will double-cast the fog spell when returning from the Rift (useful since the Rift requires two uses to escape).

===Should Rest?===
Bigshot evaluates these conditions to decide when to leave a hunt and return to rest.
* '''when percent mind >='''
** Triggers resting when your mind has reached this threshold. Generally set to 100 (fried). Default is 100.
* '''and extra kills >='''
** The number of additional monsters to kill after reaching your "when percent mind" threshold and after LTE boosts are used. Set to 0 to rest immediately upon reaching the mind threshold.
* '''and used lte boosts >='''
** The number of LTE (Long-Term Experience) boosts Bigshot will attempt to use after reaching the mind threshold. Set to 0 to skip LTE boosts entirely.
* '''or percent mana <='''
** Forces Bigshot to rest when your mana percentage is at or below this value. Can be set to 0, but leaving a small buffer is useful (e.g., for Unlock (406) to open the WL Graveyard gate). If you encounter an "OOM" error, try setting this to 1.
* '''or percent encumbrance >='''
** Forces Bigshot to rest when your encumbrance reaches or exceeds this percentage.
* '''or wounded eval'''
** Allows you to set a Ruby evaluation expression to determine if you are too wounded to continue. Can trigger on bleeding, specific wound levels, inability to cast, scars, and more.

The following is a wounded evaluation that will rest whenever you have any level II wounds:
<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || Char.percent_health <= 70</PRE>
The following is a wound evaluation that will take you home if you can no longer cast (bleeding, nerves, level 2 head/eyes, bad scars, etc.):
<PRE>bleeding? || Char.percent_health <= 25 || [Wounds.head, Scars.head, Wounds.leftEye, Scars.leftEye, Wounds.rightEye, Scars.rightEye, Wounds.nsys, Scars.nsys].max > 1 || [Wounds.leftArm, Wounds.leftHand, Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand, Scars.rightArm, Scars.rightHand].max > 2 || ([Wounds.leftArm, Wounds.leftHand, Scars.leftArm, Scars.leftHand].max + [Wounds.rightArm, Wounds.rightHand, Scars.rightArm, Scars.rightHand].max) >= 3</PRE>
The following can be appended to either wound evaluation above to also rest upon having popped muscles:
<PRE>|| Effects::Debuffs.active?("Overexerted")</PRE>

* '''when creeping dread >='''
** Forces Bigshot to rest when your creeping dread level reaches or exceeds this value.
* '''when crushing dread >='''
** Forces Bigshot to rest when your crushing dread level reaches or exceeds this value.
* '''Wall of Thorns Poison'''
** Forces Bigshot to rest when you are affected by Wall of Thorns poison.
* '''Confusion Debuff'''
** Forces Bigshot to rest when you are affected by the non-dispellable Confusion debuff.
* '''Box in hand'''
** Forces Bigshot to rest if looting leaves a box in your hand.

==The Hunting Tab==
This tab controls when and where Bigshot hunts, any pre-hunt preparation, and the map boundaries for wandering.

===The Hunting Map===
Your hunting map consists of '''Boundaries''' (rooms Bigshot will never enter) and a '''Starting Room''' (the first room Bigshot moves to when a hunt begins). These function similarly to the boundaries in the ;Wander script, but are stored in Bigshot's own configuration files.

* '''starting room ID''' - The first room Bigshot travels to when beginning a hunt. Set this to any room within your boundaries.
* '''boundary rooms''' - Rooms that act as walls. Bigshot will never enter a boundary room.

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>

In the diagram above, "B" is a boundary room and "A" is outside the hunting area. Rooms marked "0" are the huntable area. Bigshot will wander freely among the "0" rooms but never cross into "B" or "A".

Boundary room IDs are separated by commas. Some popular examples:

'''Rift Boundaries:'''
<PRE>
Plane 1: 2635, 12101, 12208
Plane 2: 2605, 2635, 12093
Plane 3: 2635, 12089, 12152
Plane 4: 12122, 12207, 12235
Plane 5: 2579
North Scatter: 12151, 12254, 12256, 12249, 12247, 12241
South Scatter: 12151, 12219, 12217, 12233, 12237, 12239
</PRE>

'''Maaghara Boundaries:'''
<PRE>9734</PRE>

'''Confluence Boundaries:'''
<PRE>2300, 3519, 228, 188, 1932, 10855, 3668, 1438, 1005</PRE>

Imagine a hunting area that is a six-room square. To enter this square, you must GO DOORWAY from room A. You would set room A (outside the square, before the doorway) as a boundary. Then set room B (just inside the square) as the starting room. Bigshot will move to room B and wander within the bounded area until your "Should Rest?" conditions are met.

* '''rally point rooms''' - Optional intermediate room IDs Bigshot will pass through on the way to the hunting area. Separate multiple rooms with commas.

===Hunting Settings===
* '''wait before wandering to another room''' - Time in seconds Bigshot waits before leaving a room to look for creatures. Default is 0.3. Set to 0 for fastest (but spammy) movement.
* '''attack stance''' - The stance Bigshot switches to when issuing attack commands. Bigshot remains in defensive stance until an attack is triggered, then stances to your specified attack stance. Recognizes all game stances from Offensive through Defensive.
* '''wander stance''' - The stance Bigshot uses while moving between rooms. Defaults to Defensive.
* '''stand up stance''' - The stance Bigshot enters when standing up after being knocked down. Defaults to Defensive.
* '''pre-hunt commands''' - Commands executed before Bigshot uses Go2 to travel to your starting room. Example: <CODE>gird, stance defensive</CODE>. This ensures your weapon is readied and you are in defensive stance before traveling. Use this line for short-lived combat spells like 1605 (Arm of the Arkati).
* '''active hunting scripts''' - Scripts that run while Bigshot is in hunt mode. Use these for complex behaviors that Bigshot does not natively support (e.g., keeping certain spells active or executing CMANs based on conditions).
* '''society abilities/spells/cmans''' - Abilities Bigshot keeps active during a hunt. Enter numerical designations separated by commas. For example, entering <CODE>506</CODE> keeps Haste up, recasting whenever it wears off. Hover over this field in the GUI for a list of supported values. Supported options include spells that can be ignored by rapidfire cooldown: e.g., <CODE>515 (ignore)</CODE> or <CODE>rapidfire (ignore)</CODE>.
* '''loot script''' - The script Bigshot calls to loot your kills (e.g., <CODE>eloot</CODE>). Make sure the loot script is properly configured via its own SETUP command, or Bigshot may error.
* '''wracking spirit >=''' - If your spirit is greater than or equal to this value, Bigshot will WRACK for mana. Setting it to 6 will wrack down to 5 spirit. Only functions when the wracking checkbox is enabled.
* '''Use sign of wracking/sigil of power''' - Checkbox to enable wracking.
* '''Check for favor before using Voln symbols''' - Checkbox to verify you have sufficient favor before casting Voln society symbols.
* '''Priority hunt''' - When enabled, Bigshot targets creatures in the order listed in your valid targets field. If a higher-priority creature enters the room, Bigshot switches to it. When using <CODE>;bigshot quick</CODE>, quickhunt targets take priority, followed by any remaining targets in room order.
* '''Delay looting''' - Delays the looting of creatures in a room.
* '''Defensive stance before looting''' - Switches to defensive stance before looting begins.
* '''Pull players to feet''' - Attempts to pull players to their feet when passing them.
* '''Stop for dead players''' - Pauses Bigshot if you encounter a dead player.
* '''Troubadour's Rally''' - Enables the use of Troubadour's Rally during hunts.
* '''Sneaky Sneaky''' - Sneak around while moving through the hunting area.

===Should Hunt?===
Bigshot evaluates these conditions to determine if you are ready to begin a hunt from rest.
* '''when percent mind <='''
** Setting this to 51 will wait until "Clear". Setting it to 65 will wait until "Muddled".
* '''and percent mana >='''
** The percentage of your maximum mana that must be present before hunting. Setting below 50 results in short hunts if you cast frequently. Generally set to 95 or higher.
* '''and CHECK spirit >='''
** Bigshot checks that your current spirit value is at least this amount. Make sure this is high enough that Bigshot will not immediately hunt after DEPARTing if you have the "Depart / re-run" option enabled on the Monitoring tab.
* '''and percent stamina >='''
** The percentage of your maximum stamina that must be present before hunting. Useful for melee-heavy builds that rely on stamina for CMANs and MSTRIKEs.

==The Attacking Tab==
This tab controls aiming, flee conditions, and various combat behavior toggles.

* '''Ambush aiming locations (head, etc)''' - The order Bigshot aims when ambushing. Default is head, right leg, left leg, chest. Bigshot cycles through these and skips locations that are too injured or unreachable.
* '''Archery aiming locations (head, etc)''' - The order Bigshot aims when using archery attacks. Loops through your aiming list.
* '''flee if enemy count is >''' - Flees the room if the total number of enemies exceeds this value. Set to 1 to engage only single targets.
* '''...but don't count these''' - Bigshot ignores these monsters when evaluating flee count. Useful when low-level monsters are mixed into your hunting area.
* '''...and always flee from''' - Bigshot immediately flees from these monsters. Useful when your hunting area has higher-level or dangerous monsters mixed in.
* '''flee from environment message''' - Bigshot flees whenever the game sends a message matching this text (uses XML regex matching).
* '''wait before wandering to another room''' - Time in seconds before moving to a new room. Default is 0.3. Set to 0 to move instantly (can be spammy for others in the area).
* '''Approach lone targets only''' - Forces Bigshot to only begin combat against creatures that are alone in a room.
* '''Bless weapon?''' - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on any weapon that loses its bless during hunting. If unable to bless during hunting, Bigshot returns to the rest area and quits.
* '''Activate weapon reactions''' - Initiates reactive strikes when the opportunity presents itself.
* '''Flee from clouds''' - Flees from cloud spells such as 125 (Call Lightning/Ominous Cloud), 1704 (Stun Cloud), and 1713 (Death Cloud).
* '''Flee from vines''' - Flees from vine spells such as 610 (Tangle Weed).
* '''Flee from webs''' - Flees from webs.
* '''Flee from voids''' - Flees from voids.

==Commands Tab==
This is the core of Bigshot — where you define your attack routines.

===Hunting Commands===
* '''hunting commands (a)''' - The primary commands Bigshot executes when in a room with a valid target. Commands are separated by commas. Bigshot recognizes most hunting verbs; unrecognized commands are sent directly as-is via fput. The following are recognized hunting commands:
** '''kill''' - Attacks using the KILL verb.
** '''incant <spell number>''' - Casts the specified spell with INCANT. Automatically stances into offensive for bolt and stance-sensitive spells. You can CHANNEL via <CODE>INCANT SET CHANNEL <spell></CODE> (a standard GSIV verb) or by setting <CODE>SET ChannelIncant ON</CODE>, which will CHANNEL an INCanted spell if you are in a stance higher than neutral.
** '''channel <spell number>''' - Channels the specified spell at the target. Requires a stance higher than neutral to have effect.
** '''<spell number>''' - Casts the specified spell using PREPARE and CAST.
** '''wand''' - Gets a wand from your specified container and WAVEs it at the target.
** '''wandolier''' - Similar to wand, but designed for wandoliers. Gets a wand from the fresh wand container and waves it; rubs the container if no wands are found. Default waves in offensive stance. Use <CODE>wandolier defensive</CODE> to wave in a different stance.
** '''fire''' - Gets ammunition from your specified container and FIREs at the target. Aims based on Archery aiming settings on the Attacking tab.
** '''aim <location>''' - Aims at the specified body location.
** '''ambush''' - Uses the AMBUSH verb to attack, aiming based on Attacking tab settings. Can also aim dynamically: <CODE>ambush head</CODE> overrides default settings for that attack.
** '''wait <time>''' - Stance dances by going into Defensive stance for the specified time (in seconds). Bigshot will exit early if the target swings or casts, then evaluate the rest of the attack routine from your attack stance.
** '''mstrike''' - Executes MSTRIKE based on cooldown and stamina. Has its own options page under the Misc tab. Can also be used with UAC: <CODE>mstrike punch</CODE>.
** '''berserk''' - Executes the BERSERK verb and waits until it fades.
** '''throw''' - Empties hands, attempts throw, then retrieves the items you emptied.
** '''weed/kweed''' - Casts 610 at the target. Using <CODE>kweed</CODE> forces EVOKE 610, ensuring the damage version.
** '''curse <type>''' - Preps 715 and uses the specified curse type. Valid types: Clumsy, Weakness, Darkness, Itch, Hex, Pox, Nightmare, Star. Skips "curse star" if the buff is already active.
** '''unarmed <type>''' - Uses the Bigshot UAC routine. Valid types: punch, jab, kick, grapple. The routine uses appropriate attacks to rank up and applies MSTRIKE based on MSTRIKE options. Example: <CODE>unarmed jab</CODE>.
** '''smite''' - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on the target until successful.
** '''leech''' - Performs a [[Mana Leech (516)]] on the target if cooldown is under 15 minutes.
** '''script <script name>''' - Executes a specified custom attack script.
** '''hide''' - Repeatedly attempts to hide until successful or gives up.
** '''sleep <nostance>''' - Pauses Bigshot for the specified number of seconds. Example: <CODE>sleep 10</CODE> or <CODE>sleep 10 nostance</CODE>. Useful for timed hunting, e.g., <CODE>410, sleep 15</CODE> will E-wave, then wait 15 seconds before re-evaluating.
** '''stance <stance>''' - Changes stance. Example: <CODE>stance defensive</CODE>.
** '''nudgeweapons''' - Moves all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** '''force <cmd> until <endroll>''' - Repeats a command until a desired endroll is achieved. Example: <CODE>force incant 1002 until 101</CODE>. Only works for standard swings/spells/CMANs.
** '''eachtarget <cmd>''' - Issues the command against each valid target in the room.
** '''efury <fire|cold>''' - Casts Earthen Fury (917) on the target and waits for the DOT to end or 12 seconds to pass.
** '''caststop <spell>''' - Casts the spell and immediately stops it after casting.
** '''wield <noun> <left|right>''' - Wields a new item in the specified hand and stores the current item.
** '''store''' - Stores items in left, right, or both hands (only if something is in those hands).
** '''tether <recast>''' - Casts 706 with built-in wait logic. The optional <CODE>recast</CODE> flag will auto-recast 706 on creature death and transfer DOTs to a new target.
** '''unravel <spell>''' - Casts 1013 (Song of Unravelling). Optionally specify a spell number to target against the creature.
** '''depress''' - Casts 1015 (Song of Depression) with built-in logic.
** '''phase''' - Force-casts 704 (Phase) using PREP/CAST, required for NPC targeting to convert non-corporeal to corporeal undead.

===Additional Command Sets===
* '''hunting commands (b) through (j)''' - Additional attack routines tied to creature flags. When you flag a creature in your valid targets (e.g., <CODE>niirsha(b)</CODE>), Bigshot uses the matching command set. This allows different attack strategies for different creature types.
* '''fried hunting commands''' - Commands executed specifically when your mind is fried. Useful in group hunting where you still want to contribute.
* '''quick hunting commands''' - Commands executed when using <CODE>;bigshot quick</CODE>.
* '''valid targets''' - The monsters you are hunting. Bigshot works best with creature NOUNs (e.g., <CODE>ogre</CODE> instead of <CODE>a large ogre</CODE>). Use commas to separate multiple targets: <CODE>manticore, thrak</CODE>. If left blank, Bigshot will target everything in the room. Supports regex for advanced matching.
* '''quickhunt targets''' - Designated targets for the <CODE>;bigshot quick</CODE> option.

===PSM3 Integration===
Bigshot supports weapon/shield skills and warcries. Assaults wait until they finish or are interrupted. The following are recognized PSM3 commands:

'''Assaults''' (wait until completed/interrupted):
* barrage, flurry, fury, gthrusts, pummel, thrash
* fury can specify a default attack: <CODE>fury punch</CODE> or <CODE>fury kick</CODE> (defaults to jab)

'''Setups''' (execute on cooldown — pair with prone/stun/root checks):
* charge, cripple, dizzyingswing, pindown, twinhammer

'''AOE''' (execute on cooldown — limit with mob checks):
* clash, cyclone, pulverize, volley, wblade, whirlwind

'''Warcries:'''
* '''shout''' - Performs warcry Shout. Must use a command check or it will shout every loop: <CODE>shout(!shout)</CODE> or <CODE>shout(buff10 s25)</CODE>
* '''yowlp''' - Performs warcry Yowlp. Must use a command check: <CODE>yowlp(!yowlp)</CODE> or <CODE>yowlp(buff10 s10)</CODE>
* '''holler''' - Performs warcry Holler, taunting all mobs. Example: <CODE>holler(s60)</CODE>
* '''bellow, growl, cry''' - Offensive warcries. Use with <CODE>target</CODE> for single target or <CODE>all</CODE> for AOE.

'''Shield Skills:'''
* shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw

'''Combat Maneuvers:'''
* '''surge''' - Keeps Surge of Strength active. <CODE>surge</CODE> or <CODE>surge(surge)</CODE> casts even on cooldown; <CODE>surge(!surge)</CODE> only casts when not on cooldown.
* '''bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, disarm, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kifocus, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick'''
* '''dislodge <location>''' - Dislodge from the specified location: <CODE>dislodge eye neck</CODE>
* '''stomp''' - Performs a stomp attack. Channels 909 if not already active. You can also add 909 to the society abilities field to keep it active.
* '''dhurl''' - Hurls your weapon and recovers it. Works with weapon bonding auto-return and the RECOVER verb.
* '''assume <aspect> <aspect/evoke>''' - Cycles between two aspects, or evokes a single aspect. Also works in the society abilities box: <CODE>650 <aspect> <aspect/evoke></CODE>
* '''briar <weapon>''' - Activates the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
* '''stance perfection''' - Put 10, 20, 30, etc. in your attack stance box to take advantage of stance perfection.
* '''chastise, excoriate''' - Performs the FEAT if available and affordable.
* '''rebuke''' - Performs Righteous Rebuke.
* '''scourge''' - Performs Ardor of the Scourge.
* '''momentum''' - Performs Glorious Momentum.

===Gemstone Activation===
To use a gemstone-activated ability, use <CODE>jewel <mnemonic></CODE>. Bigshot automatically avoids usage if the ability is on cooldown. Supported gemstone mnemonics:
* bloodboil - Blood Boil
* spellblade - Spellblade's Fury
* arcascend - Arcanist's Ascendancy
* geospite - Geomancer's Spite
* forceofwill - Force of Will
* arcaneintensity - Arcane Intensity
* arcaneopus - Arcane Opus
* bloodsiphon - Blood Siphon
* bloodwell - Blood Wellspring
* epossess - Evanescent Possession
* manawellspring - Mana Wellspring
* spiritwell - Spirit Wellspring
* stamwell - Stamina Wellspring
* terrortribute - Terror's Tribute
* arcblade - Arcanist's Blade
* arcwill - Arcanist's Will
* imaerabalm - Imaera's Balm
* reckless - Reckless Precision
* unearthchains - Unearthly Chains
* witchhunt - Witchhunter's Ascendancy
* manashield - Mana Shield
* arcaneaegis - Arcane Aegis

You may need to run '''SKILLS FULL''', '''CMAN INFO''', '''WEAPON INFO''', or '''SHIELD INFO''' if you have recently changed training or if skills are being skipped.

===Additional Options===
* '''haste''' or '''506''' - Placing this in front of any command casts 506 (Haste) before executing the command. Only casts if Haste is not currently active or has less than 3 seconds remaining.
<PRE>wait 10, haste kill (x3)</PRE>
* '''slayer''' or '''240''' - Placing this in front of any command casts 240 before executing. Will not recast if already active.
<PRE>slayer 302 (x99)</PRE>

===Command Checks===
Command checks let you add conditions to any command. The format is:
<CODE>COMMAND (CHECKS)(REPETITIONS)</CODE>

Example: <CODE>hamstring (mob1 prone)(x2)</CODE>. The (x#) repetition must be in a separate set of parentheses. Note that (xx) is shorthand for (x5), not unlimited.

Checks can be combined inside a single set of parentheses with spaces between them. Example: <CODE>kill(m20 s5 e20)</CODE>

Each check also has an inverse — prefix with <CODE>!</CODE> to negate. Example: <CODE>kill(!m20 !s5 !e20)</CODE>

'''Resource and Status Checks:'''
* '''s#''' - Requires at least # stamina.
* '''m#''' - Requires at least # mana.
* '''h#''' - Requires health to be at or above #% (percentage, not fixed).
* '''v#''' - Requires at least # spirit.
* '''e#''' - Requires encumbrance percentage to be at or below #.
* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).

'''Creature Checks:'''
* '''mob#''' - Requires at least # NPCs in the room. Only useful for 2 or more creatures.
<PRE>To further clarify the mob# implementation:
1 mob, mob2: 1 IS less than 2 — attack does NOT proceed.
2 mobs, mob2: 2 IS NOT less than 2 — attack CAN proceed.
1 mob, !mob2: 1 IS NOT more than 2 — attack CAN proceed.
2 mobs, !mob2: 2 IS NOT more than 2 — attack CAN proceed.
3 mobs, !mob2: 3 IS more than 2 — attack does NOT proceed.</PRE>
* '''valid#''' - Like mob#, but only counts valid targets you are actively targeting in current settings.
* '''tier#''' - Checks your current UAC tier (1, 2, 3). Performs the command if your tier is equal to or greater than #. <CODE>(!tier3)</CODE> skips the command at tier 3.
* '''prone''' - Checks that the target is NOT sleeping, webbed, stunned, kneeling, sitting, lying down, prone, frozen, or held in place. Performs the command if none of those apply.
* '''frozen''' - Similar to prone but broken out separately. Useful for archers against non-corporeal creatures that deflect ranged attacks. Corporeal creatures that are stunned will break this check.
* '''undead''' - Performs the command if the target is undead.
* '''flying''' - Performs the command if the target is flying.
* '''rooted''' - Performs the command if the target is rooted.
* '''noncorporeal''' - Performs the command if the NPC is [[noncorporeal|non-corporeal]] undead.
* '''ancient''' - Checks for grizzled/ancient creatures.

'''Self Checks:'''
* '''hidden''' - Performs the command if you are currently hidden.
* '''poison''' - Performs the command if you are currently poisoned.
* '''disease''' - Performs the command if you are currently diseased.
* '''pcs''' - Performs the command if there are PCs in the room that are not in your group.
* '''outside''' - Performs the command if the room is outdoors.
* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.

'''Timing Checks:'''
* '''once''' - Performs the command once per target. Resets on room change.
* '''room''' - Performs the command once per room. Resets on room change.

'''Buff Checks:'''
* '''barrage''' - Checks for the Enhanced Dexterity buff from Barrage.
* '''fury''' - Checks for the Enhanced Constitution buff from Fury.
* '''flurry''' - Checks for the Slashing Strikes buff from Flurry.
* '''pummel''' - Checks for the Concussive Blows buff from Pummel.
* '''thrash''' - Checks for the Forceful Blows buff from Thrash.
* '''vigor''' - Checks for the Tangleweed Vigor buff.
* '''reflex''' - Checks for the Arcane Reflex buff from Nature's Touch.
* '''tailwind''' - Checks for the Tailwind buff from Breeze.
* '''shout''' - Checks for the Empowered buff from Shout.
* '''yowlp''' - Checks for Yertie's Yowlp buff from Yowlp.
* '''holler''' - Checks for Horland's Holler buff from Holler.
* '''voidweaver''' - Checks for the Voidweaver buff from Implosion (720).
* '''justice''' - Checks for charges of Swift Justice. <CODE>(justice)</CODE> acts with charges; <CODE>(!justice)</CODE> acts with no charges.
* '''surge''' - Checks for Surge of Strength buff.
* '''rebuke''' - Checks for Righteous Rebuke buff.
* '''scourge''' - Checks for Ardor of the Scourge buff.
* '''momentum''' - Checks for Glorious Momentum buff.
* '''coupdegrace''' - Checks for the Empowered buff from Coup de Grace.
* '''animate''' - Checks for whether you have an animate present.
* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds. Supported for barrage, bearhug, coupdegrace, fury, flurry, pummel, thrash, shout, yowlp, garrote.
* '''censer''' - Attempts to cast 320 before your command, checking mana and cooldown. Examples: <CODE>309(censer)</CODE>, <CODE>335(censer mob3)</CODE>, <CODE>attack(censer)</CODE>
** If the command is a spell, censer only casts if you have mana for both 320 and the spell.
** If the command is not a spell, censer only checks you have enough mana for 320.

'''Effects Checks:'''
* '''ES"Effect to Track"''' - Checks if the Effects::Spells effect is active
* '''EB"Effect to Track"''' - Checks if the Effects::Buffs effect is active
* '''EC"Effect to Track"''' - Checks if the Effects::Cooldowns effect is active
* '''ED"Effect to Track"''' - Checks if the Effects::Debuffs effect is active

===Example Attack Routines===
<PRE>wait 10, kill (x3)</PRE>
Waits 10 seconds for the monster to swing or cast, then counter-attacks from your specified attack stance. Swings three times, then goes back to defensive and waits again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>
Waits 15 seconds, then INCants 505 (Hand of Tonis) to knock down or stun the target. Follows up with repeated casts of 903 (Minor Water) until the target is dead (up to 5 times).

<PRE>stance defensive and incant 1615, kill (x100)</PRE>
Casts 1615 (Divine Strike) from defensive stance, then uses KILL continuously until the target is dead or 100 swings (whichever comes first).

<PRE>force feint until 101, kill (x2)</PRE>
Uses FEINT against the target until a successful endroll, then hits twice before trying FEINT again.

<PRE>stance defensive and hide, ambush left leg</PRE>
Hides from defensive stance, then ambushes the target's left leg. Repeats (hides again) after roundtime.

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>
Casts 720 (Implosion) if you have 50+ mana, then INCants 708 (Limb Disruption) at the default aim location, then channels 702 (Mana Disruption) up to 5 times or until dead.

<PRE>prep 708, cast at left leg / prep 708 channel at left leg, incant 719 (m50)(x1), incant 702 (xx)</PRE>
Prepares 708 and CASTs at the left leg. The second variant prepares and CHANNELs at the left leg. Then casts 719 (Dark Catalyst) once if 50+ mana. Finally, INCants 702 until the creature is dead.

<PRE>wait 30, unarmed punch</PRE>
Waits 30 seconds or until the target attacks, then begins UAC combat using Punch to tier up.

<PRE>shield charge (s15 prone), ambush, mstrike</PRE>
Shield charges the target if you have 15+ stamina and the target is NOT prone. Then ambushes based on Attacking tab settings (cycling through configured aim locations). Then MSTRIKEs — focused if below the creature threshold, unfocused if at or above it. Use <CODE>mstrike target</CODE> to always focus, or set unfocused threshold very high.

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>
AOE bellows, then Whirling Blade if 3+ targets. Flurries if the Slashing Strikes buff is not active. Falls back to basic attack.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>
Taunts with Holler, Shield Throws if 3+ targets, Flurries on cooldown, Thrashes on cooldown, and attacks as a fallback.

<PRE>shroud(s35 !hidden mob2), divert (s25 hidden mob2), ambush(hidden), flurry, attack</PRE>
If 2+ mobs: hides with Shroud (35 stamina, not already hidden), then Diverts one target (25 stamina, must be hidden). Ambushes if hidden, Flurries on cooldown, attacks as fallback.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>
Keeps Surge active (casting only when not on cooldown). Bullrush to apply vulnerable, Bearhug (faster on vulnerable targets), Pummel on cooldown, attack as fallback.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>
Keeps Surge active (casting even during cooldown for 60 stamina). Shouts when less than 11 seconds remain on the buff. Shield Strikes, Pummels once per minute, finishes with 2 attacks.

<PRE>pindown(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 (m16 reflex), fire</PRE>
Pin Down if 4+ targets, Volley if 2+ targets. Tangleweed if missing Vigor and Reflex buffs. Barrage if missing Enhanced Dexterity. Spike Thorn (616) if 16+ mana and Arcane Reflex is active. Fire as fallback.

===Hunting Target Examples===
All examples below work for both "valid targets" and "quickhunt targets."

A simple target list using default commands (a) for each creature:
<PRE>crazed zombie, niirsha, sacristan spirit</PRE>

Using different command sets per creature — (a) for zombies and spirits, (b) for niirsha:
<PRE>crazed zombie(a), niirsha(b), sacristan spirit(a)</PRE>

Including [[:Category:Boss creatures|Boss Creature]] variations as valid targets using regex:
<PRE>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</PRE>

Advanced regex for Grimswarm hunting with different commands per class:
<PRE>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)
</PRE>

To target everything in the room: <CODE>(?:.*)</CODE>

==Boon Creatures Tab==
Boss creatures (also called the Boss Creature System) upgrades newly created creatures into bosses, minibosses, or packs. Upgraded creatures have their level and basic stats boosted, and are granted a number of special abilities called '''boons''', which are denoted by a special adjective in the creature's name. Players have alternatively called these "glam critters," "gifted creatures," or "boosted critters."

Additional details are available on the GemStone Wiki: [https://gswiki.play.net/Category:Boss_creatures Category:Boss creatures]

The Boon Creatures tab provides granular control over how Bigshot handles each boon ability. Bigshot uses the ASSESS verb to identify which boons a creature has, then checks your configuration to decide how to respond.

===How It Works===
For each boon ability, you can choose one of three actions:
* '''Common''' - Treat as a normal target and fight it. Uses your hunting commands to kill. Still requires proper valid target matching to engage. This is also the default behavior if no selection is made.
* '''Ignore''' - Skip this creature entirely; do not engage it.
* '''Flee''' - Immediately flee from the room when this boon type is detected.

===Master Toggle===
At the top of the tab is an '''All Boon Creatures''' section with Common, Ignore, and Flee checkboxes. These act as master toggles — checking one will set every individual boon ability across all groups to that action. If all individual items are already set to the same action and you uncheck the "All" toggle, everything gets unchecked.

===Boon Groups===
The individual boon abilities are organized into four collapsible groups, each with its own group-level toggle row ("Entire Group") and individual per-ability rows:

====Immunity====
Boons that make the creature resistant or immune to certain damage types or effects.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Crit Death Immune || resolute, unflinching || Similar to constructs or golems
|-
| Damage Padding || flinty, tough ||
|-
| Elem Negation || sparkling, shining || Absorbs elemental magic attacks
|-
| Magic Resistance || rune-covered, tattooed || Reduces magic damage by 50%
|-
| Physical Negation || indistinct, nebulous || Physical damage resist shield
|-
| Stun Immune || steadfast, unyielding ||
|}

====Offensive====
Boons that enhance the creature's offensive capabilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Boosted Offense || combative, belligerent ||
|-
| Cheat Death || glorious, illustrious || Raises self after death
|-
| Counter Attack || apt, ready || SMR counter-attack
|-
| Crit Weighting || shimmering, gleaming ||
|-
| Dmg Weighting || barbed, spiny ||
|-
| Dispelling || dazzling, flashy || Spirit Dispel (119) and Elem Dispel (417)
|-
| Elemental Flares || glittering ||
|-
| Frenzy || raging, frenzied ||
|-
| Mind Blast || canny, keen ||
|-
| Parting Shot || dreary, drab || Deals damage one last time upon death
|-
| Poisonous || sickly green, oozing || SMR poison gas cloud
|}

====Defensive====
Boons that enhance the creature's defensive capabilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Blink || flickering, wavering || Temporary phase ability
|-
| Bolt Shield || shielded ||
|-
| Boosted Defense || sinuous, flexile || High damage padding (+12 CER)
|-
| Confuse || blurry, shifting || May give hard RT for casting at them
|-
| Crit Padding || stout, hardy ||
|}

====Stats / Misc====
Boons that affect the creature's stats, resistances, or grant miscellaneous special abilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Boosted HP || robust, stalwart ||
|-
| Boosted Mana || luminous, lustrous ||
|-
| Diseased || pestilent, afflicted, diseased ||
|-
| Extra Spells - Elem || glowing ||
|-
| Extra Spells - Spirit || radiant ||
|-
| Extra Spells - Other || twinkling ||
|-
| Ethereal || ethereal, wispy, ghostly || Noncorporeal undead. No Sheer Fear.
|-
| Jack of All Trades || adroit, deft ||
|-
| Regeneration || slimy, muculent || Similar to Troll's Blood (1125)
|-
| Soul Stealing || tenebrous, shadowy || May possess 1204, 1601, and 1712
|-
| Terrifying || ghastly, grotesque || Pre-attack SMR can force player into defensive
|-
| Weaken || spindly, lanky || Weaker creature than normal
|}

===Usage Tips===
* If you are a melee character who struggles with '''Stun Immune''' or '''Crit Death Immune''' creatures, set those to Ignore or Flee while leaving others on Common.
* Casters may want to Flee from '''Dispelling''' and '''Magic Resistance''' boons.
* '''Weaken''' is actually beneficial — the creature is weaker than normal, so leaving it on Common is usually best.
* '''Cheat Death''' creatures will revive after dying; consider Ignore if your build cannot handle killing them twice.
* The configuration is saved per profile, so you can have different boon strategies for different hunting areas.

== Misc Tab==
Various specialized configuration options.

===UAC Options===
Options for configuring Unarmed Combat (UAC):
* '''Tier 3 Attack''' - The attack used when you have reached "excellent" positioning. Options: jab, punch, grapple, or kick.
* '''Aim at location (head, etc)''' - Used for aimed UAC combat, which requires ambush training to be effective. Leave blank if you do not want to aim.
* '''MSTRIKE when creatures equal or greater''' - How many creatures must be present before using MSTRIKE during UAC.
* '''Use Voln SMITE?''' - Will perform a Voln SMITE on [[Non-corporeal]] undead.

'''Quick Setup:''' Bigshot only requires minimal configuration for UAC to work well:
# '''UAC options:''' Set your '''Tier 3 Attack''' (jab, punch, grapple, or kick).
# '''Commands tab:''' Set your '''hunting commands (a)''' to '''unarmed jab'''.

Important notes about UAC in Bigshot:
* <CODE>unarmed jab</CODE> can be replaced with any UAC attack type (e.g., <CODE>unarmed punch</CODE>).
* UAC follow-up strikes take priority over the base or Tier 3 attack.
* Tier 3 attacks are only used when positioning is "excellent".
* There is almost no reason to use anything other than <CODE>unarmed jab</CODE> as the hunting command and either <CODE>grapple</CODE> or <CODE>kick</CODE> as the Tier 3 attack.

===MSTRIKE Options===
Options for when and how MSTRIKE should be used:
* '''MSTRIKE during cooldown stamina requirement''' - How much stamina you need before Bigshot will MSTRIKE during the MSTRIKE cooldown period. Be careful setting this too low, as it can pop your muscles. Leave blank to use your max stamina.
* '''QUICKSTRIKE stamina requirement''' - Stamina required for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater''' - Number of creatures in the room before Bigshot uses an unfocused (AOE) MSTRIKE instead of a focused one. Default is 2.
* '''MSTRIKE during cooldown''' - Toggle to allow MSTRIKEing during the cooldown period.
* '''Use QUICKSTRIKE for MSTRIKE''' - Toggle to use QUICKSTRIKE instead of normal MSTRIKE.

===Ammo/Wands===
Settings for ammunition and wand management. If your attack routine uses FIRE or WAND verbs, these fields must be configured or Bigshot will hang.

* '''find ammo in this container''' - The container holding your ammunition (quiver, backpack, etc.). Leave BLANK if using FIRE without retrieving ammo (post-Archery 2020 Update).
* '''use this ammo type''' - The noun of your ammo type. Leave BLANK to use FIRE without retrieving ammo. Be precise with the noun — Bigshot is sensitive to exact naming here.
* '''fresh wand container''' - The container Bigshot checks for fresh wands to WAVE.
* '''dead wand container''' - The container where Bigshot deposits used-up wands.
* '''use this wand type''' - The specific wand type(s) to use. Bigshot only pulls these for WAVEing. Separate multiple types with commas. Example: <CODE>aquamarine wand, bloodwood wand</CODE>
* '''Hide while waiting to pick up ammo''' - Bigshot will hide when gathering spent arrows and bolts.
* '''Use wands when out of mana''' - When out of mana, Bigshot pulls the specified wand type, stances to your attack stance, and WAVEs at valid targets until out of wands or resting conditions are met.

===MA Grouping===
Multi-account grouping options:
* '''Looter name''' - The name of the character designated as the looter in Head/Tail configuration.
* '''No-looting list''' - Comma-separated list of characters who should never be assigned looting duty.
* '''Random looting''' - Distributes looting randomly based on encumbrance rather than assigning a fixed looter.
* '''Leader final loot''' - Allows the leader to perform a final loot pass before leaving a room.
* '''Travel TO hunting grounds independently''' - When enabled, group members travel to the hunting area on their own rather than as a group. Bigshot will disband the group and force GROUP OPEN after disbanding.
* '''Travel FROM hunting grounds independently''' - When enabled, group members return from the hunting area on their own.
* '''Stop for dead group members''' - Pauses the group if a follower dies during a hunt.

==Monitoring Tab==
Options for safety, interaction monitoring, and debugging.

* '''Monitor interaction''' - Pops up a window whenever Bigshot detects that someone or something is trying to interact with you. Customizable monitor strings and safe strings can be configured.
* '''Engage deadman's switch''' - Forces Bigshot to quit GemStone IV when your character drops below 40% health, allowing you to log back on and assess the situation manually.
* '''Depart/rerun if dead''' - Forces a DEPART (waking up in the Temple with low spirit), then restarts Bigshot for a fresh hunt. Make sure your "CHECK spirit >=" value in Should Hunt? is set high enough to recover before the next hunt.
* '''Quiet followers''' - Followers wait until the leader finishes both actions and resting scripts before beginning their own.
* '''Ignore disk objects''' - Ignores disk objects when evaluating room claims and other checks.

===Debugging===
Bigshot provides detailed debug options for troubleshooting. Use these commands in-game:
<pre{{log2}}>
+---------------------------------------------------------------------------+
| Bigshot Debug Help v5.11.4 |
+---------------------------------------------------------------------------+
| Debug options have changed to be more helpful. |
+--------------------------------------+------------------------------------+
| ;bigshot debug file | Toggles logging to a file <on/off> |
| ;bigshot debug all <true/false> | Toggles true/false all the things |
| ;bigshot debug check | Lists current debug settings |
| ;bigshot debug combat <true/false> | Combat and Creature Status |
| ;bigshot debug commands <true/false> | Attacking and Casting Commands |
| ;bigshot debug status <true/false> | Status Checks of your Character |
| ;bigshot debug system <true/false> | System processes |
| | |
| Options can be combined: |
| ;bigshot debug combat commands status <true/false> |
+---------------------------------------------------------------------------+
</pre>

Debug log files are stored in your Lich5 logs directory under <CODE>debug/<Game>-<CharacterName>/bigshot.log</CODE> and rotate daily.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|Profiles
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting
File:bigshot-4.PNG|Attacking
File:bigshot-5.PNG|Commands
File:bigshot-6.PNG|Misc
File:bigshot-7.PNG|Monitoring
</gallery>

==Reference==
* Info originally taken from http://forum.gsplayers.com/showthread.php?t=57651

{{Third-Party Software}}
{{top}}

Lich:Script Ebounty

2026-02-08T02:08:11Z

HORIBU1: update overhaul with all new functionality documented.

{{3rd-party}}
{{TOCright| limit=2}}
EBounty is a management script for automating [[Adventurer's Guild]] bounty tasks. It handles the full lifecycle of obtaining, executing, and turning in bounties.

'''Important:''' AFK scripting on any server other than Shattered is a violation of game policy.

==Overview==

EBounty automates the Adventurer's Guild bounty workflow:

<PRE>
1. Request a bounty from the Adventurer's Guild.
2. If the bounty type is acceptable (based on your settings), execute the task.
3. If no acceptable bounty is available, run a Bigshot hunting routine using your default profile.
4. Once the bounty is complete, turn it in (if not saturated on experience).
5. When the bounty cooldown expires, request a new task.
6. Repeat.
</PRE>

EBounty relies on [[Bigshot]] for all combat-related operations. '''You must configure your Bigshot profiles before setting up EBounty.''' It also uses companion scripts for specific task types: <CODE>;echild</CODE> for rescue tasks, <CODE>;escortgo2</CODE> for escort tasks, <CODE>;eherbs</CODE> for healing, and <CODE>;eloot</CODE> for selling loot. Each of these can be overridden with a custom script of your choice.

==Installation==

Download EBounty from the script repository:

<CODE>;repo download ebounty</CODE>

Since EBounty is actively developed and game changes can affect its functionality, it is strongly recommended to enable auto-updates:

<CODE>;repo set-updatable ebounty</CODE>

===Required Dependencies===
EBounty will check for and notify you of any missing dependencies when it starts. The following scripts are needed based on your configuration:
* '''bigshot''' — Always required (unless using "Just the Basics" mode)
* '''eherbs''' — Required for healing unless you specify a custom healing script or enable "Skip healing"
* '''eloot''' — Required for selling unless you specify a custom selling script
* '''echild''' — Required if you enable Rescue bounties (unless you specify a custom rescue script)
* '''escortgo2''' — Required if you enable Escort bounties (unless you specify a custom escort script)

==Getting Started==

Open the configuration window with:

<CODE>;ebounty setup</CODE>

This opens a GUI with eight tabs: '''General''', '''Resting''', '''Foraging''', '''Heirloom''', '''Bandits''', '''Escort''', '''Exclusions''', and '''Profiles'''. All changes in the GUI are saved automatically.

At minimum, you need to:
# Enable the bounty types you want on the '''General''' tab.
# Select a '''Gem/Default''' profile on the '''Profiles''' tab (this is the Bigshot profile used between bounties).
# Add creature names and associate Bigshot profiles on the '''Profiles''' tab for any creatures you expect to hunt.

Once configured, start EBounty by simply running:

<CODE>;ebounty</CODE>

'''Note:''' EBounty must be started from a mapped room.

==General Tab==
The General tab controls which bounty types you accept, core behavior options, support scripts, and task limits.

===Bounty Types===
Enable or disable each bounty type using the checkboxes. When a bounty type is unchecked, EBounty will automatically ask the Guild to remove that type if received. Available types:

{| class="wikitable"
|-
! Bounty Type !! Description
|-
| Boss Creature || Hunt a dangerous (boss-level) creature
|-
| Culling || Kill a specified number of a particular creature
|-
| Escort || Escort an NPC between two towns (uses <CODE>;escortgo2</CODE>)
|-
| Foraging || Gather herbs from the wild (see the Foraging tab for options)
|-
| Gem Collecting || Collect specific gems by hunting creatures
|-
| Heirloom (loot) || Recover an heirloom by looting a creature
|-
| Heirloom (search) || Recover an heirloom by searching rooms (see the Heirloom tab for options)
|-
| Kill Bandits || Suppress bandit activity in an area (see the Bandits tab for options)
|-
| Rescue || Rescue a lost child (uses <CODE>;echild</CODE>)
|-
| Skinning || Collect creature skins
|}

===Misc Options===
{| class="wikitable"
|-
! Option !! Description
|-
| Rest when mind full || When enabled, EBounty will return to your resting location once your experience pool is full. When disabled, it continues hunting until the bounty is complete or another rest condition (injury, low mana, etc.) is triggered.
|-
| Keep hunting || When enabled and no creature-specific Bigshot profile is found, EBounty will use your Gem/Default profile to continue hunting instead of exiting. '''Cannot be used together with "Rest when mind full".'''
|-
| Skip healing || Disables automatic healing between tasks.
|-
| Run one bounty and quit || EBounty will complete a single bounty and then stop.
|-
| Get new bounty before quitting || (Only applies when "Run one bounty and quit" is enabled.) Grabs the next task from the Guild before exiting.
|-
| Just the basics || Only picks up and turns in bounties based on your settings. No automatic hunting, healing, or other routines are performed. Useful if you want to manage combat yourself.
|-
| Use vouchers || EBounty will use Adventurer's Guild vouchers to reroll tasks until a desired bounty type is obtained.
|-
| Use bounty boosts || Activates a bounty boost before hunting. Use the adjacent dropdown to select which bounty type to target when boosted (Any, Kill, Heirloom, Skin, Gem, Escort, Herb, Dangerous, Child, or Bandit).
|-
| Remove bounty if heirloom item is missing || If enabled and the heirloom item gets lost, EBounty will automatically remove the bounty.
|-
| Rejoin group before quitting || If you started EBounty while in a group, it will attempt to rejoin the group leader before exiting.
|-
| Ranger Track || (Rangers only) Uses the Track ability on cooldown to locate bounty targets.
|}

===Support Scripts===
These fields let you override the default helper scripts. Leave blank to use the defaults.

{| class="wikitable"
|-
! Field !! Default !! Description
|-
| Healing Script || eherbs || Runs when your character is injured between tasks.
|-
| Death Recovery Script || ''(none)'' || Runs if your character dies. If configured, EBounty will attempt to recover and restart automatically.
|-
| Selling Script || eloot || Runs to sell loot and deposit silvers.
|-
| Hording Script || ''(none)'' || Runs before a gem bounty (optional). Enter the script name followed by any necessary parameters (e.g., <CODE>HoardingScriptName param1 param2</CODE>).
|-
| Escort Script || escortgo2 || Handles escort bounty travel.
|-
| Rescue Script || echild || Handles child rescue bounties.
|-
| Gem History || ''(none)'' || An optional script that runs after receiving a gem bounty, useful for tracking which gems are requested.
|}

===Task Limits===
Set maximum values for how many items to collect per bounty type. These caps help prevent excessively long tasks:
* '''Max Culling Kills''' — Maximum number of creatures to kill for a culling bounty.
* '''Max Gems''' — Maximum number of gems to collect.
* '''Max Herbs''' — Maximum number of herbs to forage.
* '''Max Skins''' — Maximum number of skins to collect.
* '''# of Extra Skins''' — How many additional skins to collect beyond the bounty requirement before turning in.

==Resting Tab==
The Resting tab controls where your character rests between tasks and during downtime. '''Only one resting method can be active at a time''' — selecting one will deactivate the others.

===Resting Methods===
{| class="wikitable"
|-
! Option !! Description
|-
| Use Nearest Table || Travels to the nearest mapped table and sits at it.
|-
| Use Bigshot Resting Room || Uses the resting room configured in your current Bigshot profile.
|-
| Use Custom Resting Area(s) || Enter one or more room numbers (comma-separated) in the text field below. If multiple rooms are listed, one will be selected at random. Supports room IDs and UIDs.
|-
| Use Random Resting Areas || Picks a random [[supernode]] in your current town.
|-
| Use Script to Handle Resting Location || Runs a custom script to manage where you rest. Enter the script name and any parameters in the field below (e.g., <CODE>myscript param1 param2</CODE>).
|}

If no resting method is selected, EBounty defaults to the Nexus (on Shattered) or town center (on Prime).

===Per-Town Resting Locations===
Below the resting method checkboxes, you can customize the random resting room pools for each town. Each field contains a comma-separated list of room IDs that EBounty will randomly choose from when using the "Use Random Resting Areas" option:

Hinter Wilds, Icemule Trace, Kharam Dzu (Teras), Kraken's Fall, Mist Harbor, River's Rest, Sailor's Grief, Solhaven, Ta'Illistim, Ta'Vaalor, Wehnimer's Landing, and Zul Logoth.

===Additional Resting Options===
* '''Join Character''' — When enabled, EBounty will try to join a specific character when resting. Enter one or more character names (comma-separated) in the field; it will try each in order.
* '''Use Buff Script''' — When enabled, EBounty will run a buff script each time it returns to the resting location. Enter the script name and parameters below.

==Foraging Tab==
The Foraging tab configures how EBounty handles herb-gathering bounties. This tab has three sections.

===Foraging Options===
Enable spells, abilities, and behaviors to use while foraging. These help with safety and efficiency:

{| class="wikitable"
|-
! Option !! Description
|-
| Run from creatures || Flee the room if creatures appear.
|-
| Hide when foraging || Attempt to hide before foraging.
|-
| Rogue Gambits: Stealth || Use the Rogue Stealth gambit while foraging.
|-
| Nature's Bounty (604) || Cast spell 604 to improve foraging results.
|-
| Nature's Bounty Evoke (604) || Evoke spell 604 instead of casting.
|-
| Camouflage (608) || Cast spell 608 to stay hidden.
|-
| Celerity (506) || Cast spell 506 for faster actions.
|-
| Mass Calm (619) || Cast spell 619 to pacify creatures.
|-
| Wizard's Shield (919) || Cast spell 919 for additional protection.
|-
| Minor Sanctuary (213) || Cast spell 213 for a protective sanctuary.
|-
| Song of Peace (1011) || Sing Song of Peace to prevent creature attacks.
|-
| Song of Tonis (1035) || Sing Song of Tonis for speed.
|-
| Wall of Force (140) || Cast spell 140 for a defensive barrier.
|-
| Assume Aspect (650) Yierka || Assume the Yierka aspect for enhanced foraging.
|-
| Grasp of the Grave (709) || Cast spell 709 to immobilize creatures.
|-
| Sigil of Resolve || Activate the Sigil of Resolve.
|}

===Pre-Foraging===
* '''Pre-Foraging Commands''' — In-game commands to execute before each foraging session.
* '''Active Foraging Scripts''' — Scripts to run alongside foraging (comma-separated for multiple).

===Post-Foraging===
* '''Post-Foraging Commands''' — In-game commands to execute after foraging is complete.
* '''Post-Foraging Scripts''' — Scripts to run after foraging finishes.

==Heirloom Tab==
The Heirloom tab configures how EBounty handles heirloom ''search'' bounties (where you must search rooms to find the item, not loot it from a creature). This tab mirrors the Foraging tab structure with three sections.

===Search Options===
Enable spells and behaviors to use while searching for heirloom items:

{| class="wikitable"
|-
! Option !! Description
|-
| Run from creatures || Flee the room if creatures appear.
|-
| Presence (402) || Cast spell 402 to detect nearby items.
|-
| Minor Sanctuary (213) || Cast spell 213 for protection.
|-
| Song of Peace (1011) || Sing Song of Peace to prevent attacks.
|-
| Celerity (506) || Cast spell 506 for speed.
|-
| Mass Calm (619) || Cast spell 619 to pacify creatures.
|-
| Wizard's Shield (919) || Cast spell 919 for protection.
|-
| Wall of Force (140) || Cast spell 140 for defense.
|-
| Grasp of the Grave (709) || Cast spell 709 to immobilize creatures.
|-
| Song of Tonis (1035) || Sing Song of Tonis for speed.
|-
| Flag right hand || By default, found heirloom items are placed on the ground. Enable this to have the item go to your right hand instead.
|}

===Pre-Heirloom Searching===
* '''Pre-Searching Commands''' — In-game commands to execute before beginning the search.
* '''Active Searching Scripts''' — Scripts to run alongside searching.

===Post-Heirloom Searching===
* '''Post-Searching Commands''' — In-game commands to execute after the heirloom is found.
* '''Post-Searching Scripts''' — Scripts to run after searching finishes.

==Bandits Tab==
The Bandits tab configures how EBounty handles bandit suppression bounties.

===Wander Timing===
* '''Wait this long before moving rooms''' — Controls the delay (in seconds) that EBounty waits in each room before moving on while searching for bandits. Adjust this to allow time for bandits to appear.

===Bad Room List===
A table where you can define rooms to avoid during bandit hunting. Each row has two fields:
* '''Location''' — A reference label for the area (does not need to be exact; this is for your convenience only).
* '''Bad Room Numbers''' — A comma-separated list of room IDs or UIDs to skip in that area (e.g., <CODE>228, 188, u76564564</CODE>). UIDs are supported and recommended for instance compatibility.

Multiple locations can be configured so you can exclude problematic rooms across all areas where bandits spawn.

==Escort Tab==
The Escort tab configures how EBounty handles escort bounties — tasks where you accompany an NPC between two towns.

===Travel Preferences===
A grid of checkboxes showing origin and destination town pairs. Enable the routes you are willing to accept. Available towns include Wehnimer's Landing, Solhaven, Icemule Trace, Ta'Illistim, Ta'Vaalor, and Zul Logoth. Only bounties matching your enabled routes will be accepted; others will be dropped.

===Pre-Escort===
* '''Pre-Escort Commands''' — In-game commands to execute before starting the escort.
* '''Active Escort Scripts''' — Scripts to run alongside the escort.

===Post-Escort===
* '''Post-Escort Commands''' — In-game commands to execute after the escort is complete.
* '''Post-Escort Scripts''' — Scripts to run after the escort finishes.

==Exclusions Tab==
The Exclusions tab lets you define things EBounty should never accept a bounty for. There are four exclusion lists, and each supports regular expressions for pattern matching. Add items one at a time using the text field and '''Add''' button. Select an item and click '''Remove''' to delete it.

===Creature Exclusions===
Creature nouns you do not want to hunt. If a bounty targets an excluded creature, EBounty will reject it. Enter the creature noun exactly as it appears in-game (e.g., <CODE>troll</CODE>, <CODE>griffin</CODE>).

===Herb Exclusions===
Herb names you do not want to forage. If a foraging bounty requests an excluded herb, EBounty will reject it.

===Gem Exclusions===
Gem names you do not want to collect. If a gem bounty requests an excluded gem, EBounty will reject it.

===Location Exclusions===
Location/area names you do not want to visit for bounties. If a bounty sends you to an excluded location, EBounty will reject it.

==Profiles Tab==
The Profiles tab is '''the most critical tab for combat'''. This is where you tell EBounty which Bigshot profile to use for each creature. The dropdown menus automatically populate with all Bigshot profiles found in your Bigshot profiles folder.

===Gem/Default Profile===
At the top of the tab, select your '''Gem/Default''' Bigshot profile. This is the profile EBounty uses when:
* Waiting for a bounty timer to expire (hunts using this profile to fill time).
* No specific creature profile is matched.
* Running gem bounties.

'''This field is required.''' EBounty will not start without a default profile selected.

===Bandits Profile===
Below the default, select a profile specifically for bandit bounties. The '''Only Kill Bounty Creatures''' checkbox next to it determines whether EBounty should ignore non-bandit creatures during bandit tasks.

===Creature Profiles (A through J)===
Ten rows (A–J) are available for mapping creatures to Bigshot profiles. Each row has three fields:
* '''Creature Names''' (left) — Enter the full creature noun(s) for this profile. You can enter multiple creatures separated by commas or each on a separate line.
* '''Associated Profile''' (right dropdown) — Select the Bigshot profile to use when fighting these creatures.
* '''Only Kill Bounty Creatures''' (checkbox) — When checked, EBounty will only attack the specific bounty creature and ignore all other creatures in the hunting area.

'''Critical:''' Creature names must match exactly as they appear in-game. Partial or abbreviated names will not work.

{| class="wikitable"
|-
! Example !! Correct?
|-
| <CODE>executioner</CODE> || ❌ '''Wrong''' — too generic
|-
| <CODE>triton executioner</CODE> || ✅ '''Correct''' — full creature noun
|}

If a creature is not listed in the Exclusions tab and no matching Creature Name can be found in any profile row, EBounty will either use the Gem/Default profile to keep hunting (if "Keep hunting" is enabled on the General tab) or return to the resting spot and exit.

==Command Line Interface (CLI)==

EBounty supports several commands that can be run directly from the game without opening the GUI.

===Running EBounty===
{| class="wikitable"
|-
! Command !! Description
|-
| <CODE>;ebounty</CODE> || Start the main bounty loop using your saved settings.
|-
| <CODE>;ebounty once</CODE> || Run a single bounty then quit (overrides settings temporarily).
|-
| <CODE>;ebounty setup</CODE> || Open the GUI configuration window.
|}

===Information Commands===
{| class="wikitable"
|-
! Command !! Description
|-
| <CODE>;ebounty help</CODE> || Display a summary of available commands.
|-
| <CODE>;ebounty list</CODE> || Display all current settings and their values.
|-
| <CODE>;ebounty bounty</CODE> || Show details of your current active bounty.
|-
| <CODE>;ebounty creature</CODE> || Show the creature associated with your current bounty.
|-
| <CODE>;ebounty location</CODE> || Show the location associated with your current bounty.
|-
| <CODE>;ebounty ver</CODE> || Display the current EBounty version number.
|}

===Utility Commands===
{| class="wikitable"
|-
! Command !! Description
|-
| <CODE>;ebounty remove</CODE> || Remove your current bounty (travels to the Guild to request removal).
|-
| <CODE>;ebounty load</CODE> || Reload all settings from the saved configuration file.
|-
| <CODE>;ebounty debug</CODE> || Toggle debug mode on or off for verbose logging.
|}

===CLI Settings===
You can modify individual settings without opening the GUI:

<CODE>;ebounty setup <setting_name> <value></CODE>

For boolean settings, use <CODE>true</CODE>/<CODE>false</CODE>, <CODE>yes</CODE>/<CODE>no</CODE>, or <CODE>on</CODE>/<CODE>off</CODE>. Use <CODE>;ebounty list</CODE> to see all available setting names.

===Foraging via CLI===
EBounty can forage herbs independently of bounties using the command line:

{| class="wikitable"
|-
! Command !! Description
|-
| <CODE>;ebounty forage bounty</CODE> || Automatically detects your current foraging bounty and completes it.
|-
| <CODE>;ebounty forage "herb name" <quantity></CODE> || Searches the closest 10 rooms for the specified herb.
|-
| <CODE>;ebounty forage "herb name" <quantity> "location"</CODE> || Searches all rooms at the specified location for the herb.
|}

'''Examples:'''
<PRE>
;ebounty forage bounty
;ebounty forage "acantha leaf" 7
;ebounty forage "acantha leaf" 7 "Upper Trollfang"
</PRE>

==Planned Features & Known Limitations==

* '''Grouping:''' Not currently supported but planned for a future release.

==Ingame Screenshots==
<gallery perrow="4">
File:ebounty-1.PNG|General
File:ebounty-2.PNG|Escort
File:ebounty-3.PNG|Profiles
</gallery>

==Changelog==
<span class="mw-customtoggle-mychangelog" style="color:#0000ff">Click to expand</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-mychangelog">
v1.9.5 (2025-02-06)
- bugfix in forage_bounty when using optional location in CLI argument
v1.9.4 (2025-02-04)
- optimize location_list finding in forage_find room logic
v1.9.3 (2025-02-04)
- bugfix in forage_find room
v1.9.2 (2025-01-27)
- add CLI support for ;ebounty forage bounty
- add CLI support for ;ebounty forage "herb" <qty> "location"
- bugfix in heirloom_search and forage_bounty to use Claim.mine? instead of checkpcs
- anchor ending gem names in search functions to prevent false matching on other items
- fix resting spot for SG shattered
- fix forage tag in starting room crash
- fix between script(s) added erroneous commas between script parameters
v1.9.1 (2025-01-18)
- bugfix for running gem tracking script
v1.9.0 (2025-01-08)
- added support for ranger track
v1.8.1 (2025-12-24)
- added option to regroup before quiting if started in group
v1.8.0 (2025-11-18)
- added option to get a new bounty before quitting when set to "Run one bounty and quit"
v1.7.5 (2025-11-11)
- bugfix in minimum Lich required checks
v1.7.4 (2025-11-11)
- bugfix for go2_rest - settings[:resting_room] converted to array and current_room a string
v1.7.3 (2025-10-01)
- updates for Sailor's Grief
- added support for uids
- bugfix for saving settings
- general code cleanup
v1.7.2 (2025-09-08)
- change requirement to 5.12.5 due to heirloom text change
v1.7.1 (2025-09-07)
- bugfix for change in Heirloom return messaging
v1.7.0 (2025-09-05)
- add option to select boost bounty type
v1.6.5 (2025-08-15)
- bugfix for stowing herbs
v1.6.4 (2025-08-05)
- remove version check for bigshot
v1.6.3 (2025-08-03)
- bugfix mana check when changing aspect while 650 is active
- bugfix for hiding is 608 doesn't work
v1.6.2 (2025-04-21)
- bugfix for NPCs not populating quickly upon room entry with large amount of other characters
v1.6.1 (2025-04-21)
- bugfix for HW bounty turnin
v1.6.0 (2025-03-29)
- remove custom bounty and use Lich Bounty API
- remove custom issue_command to Lich::Util.issue_command
- remove depreciated code
- update references of ego2 to escortgo2
v1.5.6 (2025-03-27)
- bugfix for set_eval not adding additional skins to skinning bounty amount
v1.5.5 (2025-03-19)
- remove deprecated Lich calls
v1.5.4 (2025-03-10)
- another bugfix for bundled skins
v1.5.3 (2025-03-08)
- bugfix when counting bundled skins
v1.5.2 (2025-02-09)
- bugfix when only foraging and needing healed
v1.5.1 (2025-01-07)
- bugfix for forage turn-in
v1.5.0 (2024-12-24)
- added buffing option when resting
- added using a script to handling resting location
- added option to rest at nearest table
- added remove bounty if heirloom item gets lost
- bugfix for bounty eval not setting EBounty.data.complete_mind
- bugfix for ask_guard in HW
v1.4.5 (2024-11-26)
- added option to use the bigshot setting for a resting location
- bugfix for profile dropdown sorting
- bugfix stop script from looping if started without child in room
v1.4.4 (2024-11-22)
- bugfix in should_hunt
v1.4.3 (2024-11-18)
- missing criteria in should_hunt?
- bugfix in wait_for_bounty
- removed EBounty.data.wait - no longer used
v1.4.2 (2024-11-16)
- bugfix for when to rest
v1.4.1 (2024-11-07)
- will continue hunting after bounty complete until Bigshot Should Rest? is met
- bugfix in setup - prevent toggling both Rest when mind is full and Keep Hunting
- bug fix for should_hunt? spamming an experience check
- bug fix for should_hunt? exp_pause incorrectly included
v1.4.0 (2024-08-23)
- expanded resting options
- added optional death recovery support
- added spinbutton for room delay for bandit bounties
- asks the alchemist in HW for bounties instead of the tavernkeeper since he keeps moving
- bugfix in gem bounty running hording script with parameters
- bugfix in bandit hunting variables
- removed script change log before v1.3.0 - full log: https://gswiki.play.net/Lich:Script_Ebounty
v1.3.11 (2024-09-24)
- fix to allow for CLI foraging without setting Gem/Default profile
v1.3.10 (2024-08-19)
- bugfix for ask_guard response
v1.3.9 (2024-08-14)
- logic fix when once_and_done is set and rejected bounty not exiting (but going out to hunt instead)
v1.3.8 (2024-07-12)
- add timer to not spam INFO during should_hunt? method
v1.3.7 (2024-07-08)
- add quiet info command to should_hunt? method to refresh stats
v1.3.6 (2024-06-23)
- update ebounty fog routine to match bigshot
v1.3.5 (2024-05-15)
- add exit if gembounty complete but using eloot sell excludes gems
v1.3.4 (2024-05-01)
- Change Char.prof to Stats.prof
v1.3.3 (2024-04-13)
- bug in escort task acceptance
v1.3.2 (2024-04-09)
- bug in forage for 1011 song of peace usage
v1.3.1 (2024-04-01)
- updated keep_hunting not to run in bigshot bounty mode. Also, added better messaging for why
- consolidated herbalist names and switched to ID for turnin
- updated wiki changelog
- removed change log before v1.1.14 - full log: https://gswiki.play.net/Lich:Script_Ebounty
v1.3.0 (2024-03-17)
- added exclusion options for individual gems and locations
- added help section
- bugfix for UI title
- removed shattered specific actions not referenced in UI (requesting spells and healing in the nexus)
v1.2.2 (2024-03-03)
- bugfix for gem hoarding scripts that handle selling gems
v1.2.1 (2024-02-25)
- bugfix for condition where ebounty may be repeatedly invoke eherbs
v1.2.0 (2024-02-09)
- added toggle to skip healing
- added individual script options for rescue, escort, and hording
v1.1.37 (2024-01-08)
- add option to HIDE back for no-magic rooms if enabled to hide.
v1.1.36 (2024-01-06)
- remove forced HIDE for foraging put in by error.
v1.1.35 (2024-01-02)
- added check for nomagic tag before casting spells.
v1.1.34 (2023-11-16)
- bugfix in location check for foraging
v1.1.33 (2023-11-10)
- bugfix to stop trying to hand in herbs if completed
- added check for having enough herbs for turnin
v1.1.32 (2023-10-13)
- update hunting settings to use bigshot fried setting instead of setting to 100
v1.1.31 (2023-09-27)
- bugfix when asking taskmaster for bounty in crowded room
v1.1.30 (2023-09-26)
- bugfix for closing containers
v1.1.29 (2023-09-23)
- bugfix to initialize settings when using stand alone foraging
v1.1.28 (2023-09-23)
- bugfix for checking if 604 is active
v1.1.27 (2023-09-17)
- bugfix for CLI foraging exiting when "just the basics" option toggled true
- bugfix for black void check when foraging
v1.1.26 (2023-09-09)
- bugfix for CLI setting values to true/false with Ruby 3.2
v1.1.25 (2023-07-10)
- bugfix for HW guard
- bugfix for Ta'Vaalor guards
- bugfix for rejecting heirloom taskers
- turn portals off for escorts
v1.1.24 (2023-07-10)
- bugfix for HW taskmaster
v1.1.23 (2023-07-05)
- keep silvers based on eloot setting
v1.1.22 (2023-06-19)
- changed the resting room to default to your bigshot profile
- should recognize the correct town to turn in bounties
v1.1.22 (2023-06-11)
- removed need to set a resting room
v1.1.21 (2023-06-11)
- bugfix for missing category in tasks
v1.1.20 (2023-06-04)
- prep for new Lich 5.7.0 infomon.lic & effect-list.xml change
v1.1.19 (2023-05-21)
- bugfix for string error when finding rooms
- bugfix for heirloom turnin
- added support to wait for shattered healbot
v1.1.18 (2023-05-21)
- bugfix for escort tasks
v1.1.17 (2023-05-17)
- added missing escort locations
- bugfix for foraging using an heirloom setting
- bugfix for CLI herb gathering
v1.1.16 (2023-04-22)
- bugfix for RR purser
v1.1.15 (2023-04-11)
- bugfix bandit bounty locations
- bugfix in dangerous creature regex
v1.1.14 (2023-04-11)
- bugfix for CLI
- switched bounty_check to use Bounty API regex
- moved 213 into loop during foraging so it checks each time in case the spell wears off
- removed list of alternate foraging herb commands. Instead using in-game bounty xml for correct forage syntax
- added option to hunt with default profile instead of exiting when no profile found
v1.1.13 (2023-03-16)
- added sigil of resolve to foraging
- added flag righthand for heirloom search bounties
- replace script.vars with Script.current.vars
- run loot script only if loot at end of hunt
- added strip for extra spaced in herb bounties
- added check for right hand flag to make sure it gets turned off
v1.1.12 (2023-03-16)
- bugfix in rescue task regex
- changed bundle measuring to not be silent to prevent unintented screen scroll
v1.1.11 (2023-03-05)
- bugfix in string literal
v1.1.10 (2023-03-05)
- reverted string literal changes back
- fixed bug in child bounty
v1.1.9 (2023-03-05)
- reverted string literal changes
v1.1.8 (2023-03-04)
- added herb exclusions, rubocop fixes
v1.1.7 (2023-03-02)
- bug fix depositing silver
v1.1.6 (2023-02-28)
- fixed looting script from running in town
v1.1.5 (2023-02-28)
- fixed regex error in herb task location
v1.1.4 (2023-02-23)
- fixed regex error in targeting
v1.1.3 (2023-02-23)
- Added check for npcs in heirloom search
v1.1.2 (2023-02-04)
- added support for keeping silvers
v1.1.1 (2023-02-01)
- bug fix for foraging spells (waitcastrt? for assume yierka)
- rearranged post-hunt sequence to mimic bigshot functionality.
-fixed forage/heirloom search using empty_hands
v1.1.0 (2023-01-27)
- added pre and post hunt commands and scripts for foraging, heirloom search, and escorts
- added bad room entries for bandits that will accept UID's
- added spell support for heirloom search bounties
- added 1035 to foraging and heirloom searching
- think I finally squashed the repeating Song of Peace bug
v1.0.32 (2023-01-26)
- bugfix for heirloom searching
v1.0.31 (2023-01-24)
- reordered casting of song of peace during foraging and stopping it when done.
- added a double check for heirloom searching
v1.0.30 (2023-01-23)
- fix bad Widowmaker Rd room#
v1.0.29 (2023-01-23)
- fix bugfix in variable list from v1.0.29
v1.0.28 (2023-01-23)
- added herbalist to Mist Harbor
v1.0.27 (2023-01-22)
- refreshed spell active before casting foraging helper spells
- add check for silver deposit after bounty turn-in
- fixed bug in bundled skin eval
v1.0.26 (2023-01-21)
- fixed bug in herb turnin when caught in RT
- fixed prep-hunt command to run scripts consistent with bigshot functionality
v1.0.25 (2023-01-19)
- Fix badlist rooms and add bad logging road rooms
v1.0.24 (2023-01-19)
- Correct another typo in herb finding method
v1.0.23 (2023-01-16)
- Correct typo in herb finding method
v1.0.22 (2023-01-12)
- Change EBounty.data.location_start to use nearest instead of first in list
v1.0.21 (2023-01-02)
- typo in bug fix
v1.0.20 (2023-01-02)
-bug fix moves minor sanct outside foraging loop to stop it spamming
v1.0.19 (2023-01-01)
-bug fix to stop voucher use when bounty boost is active
v1.0.18 (2023-01-01)
- added bounty boost to available options
- added foraging enhancements - see foraging tab on ui
- changed the herb searching routine to try and eliminate false positives/negatives
- updated infomon and spell-list version requirements to support 650 tracking
- added CLI herb foraging independent of bounty - ;ebounty forage "<type of herb>" <number to find>
v1.0.17 (2022-12-27)
- ensuring following scripts are stopped before starting ebounty: go2, echild, ego2, bigshot
v1.0.16 (2022-12-22)
- typo fix for the bugfix for herbalist rooms using UID's
v1.0.15 (2022-12-22)
- bugfix for herbalist rooms using UID's
v1.0.14 (2022-12-20)
- updated herbalist rooms to use UID's for instance compatibility
v1.0.13 (2022-12-19)
- add regex for opening an item
v1.0.12 (2022-12-15)
- made resting room a required parameter
- consolidated odd herb names
v1.0.11 (2022-12-12)
- foraging name match fix
v1.0.10 (2022-12-11)
- fixed foraging herb matching bug
v1.0.9 (2022-12-09)
- bug fix for checkbounty not populating quickly
v1.0.8 (2022-12-06)
- moved post hunt routine to after forage turn-in to avoid trashing foraged item
- bug fix for foraging in the red forest
v1.0.7 (2022-12-05)
- bug fix for hunting sequence resting
v1.0.6 (2022-12-5)
- fixed bug in rescue bounty sequencing.
v1.0.5 (2022-12-3)
- bugfix for bounty_eval
- various foraging name corrections
- pre/post hunting bigshot routines (from default profile) added to escort bounties
v1.0.4 (2022-11-30)
- bug fix on container opening
- adjusted hunting sequence due to bigshot bounty_eval changing
- set bounty_eval to empty string on exit
- updated required versions to Lich 5.6.2, Bigshot 4.13.12, and Infomon 1.18.16
- regex fix for completed task
v1.0.3 (2022-11-28)
- changed container method to use "inventory container" instead of GameObj.inv
v1.0.2 (2022-11-27)
- Fix to targeting not using bigshot routines
v1.0.1 (2022-11-26)
- hedgehog sack messaging
- fixed herb names
- support for Bigshot fogging options
- child bounty fail bug
- Fix for grizzled targeting when user only kills bounty creatures
v1.0.0 (2022-05-18)
- initial framework and ui
</div>

==Reference==

{{Third-Party Software}}

Lich:Script Bigshot

2026-02-08T00:57:08Z

HORIBU1: Massive update to take into account all new functionality added over the years.

{{3rd-party}}
Bigshot is a fully automated hunting script for GemStone IV. It handles combat routines, movement to and from hunting areas, target selection, and attack execution.
AFK scripting on any server other than Shattered is a violation of game policy.
{{TOCright| limit=2}}
==Changelog==
*[[Script Bigshot/Changelog|Script Bigshot Changelog]]
==About Bigshot==
===What Does Bigshot Do?===

Using a series of menus and command inputs, Bigshot lets you create a modular, customizable, and fully automated hunting script. With just a few clicks and tweaks, you can go from scripting rats to the Rift.

===How Do I Get It?===

Grab it from the repository: <CODE>;repository download Bigshot</CODE>

===How Do I Make It Go?===
Initial setup is accessed through <CODE>;bigshot setup</CODE>. This opens a configuration window with several tabs for setting up your hunting routine.

As with most scripts, the SETUP command opens a graphical user interface. Use <CODE>;bigshot setup</CODE> to open the dialog. The window contains the following tabs:
* '''Profile''' - Save and load profile configurations. Profiles are saved to your <CODE>\Lich5\data\<GSServer>\<charname>\bigshot_profiles</CODE> directory (e.g., <CODE>\Lich5\data\GSIV\Rinualdo\bigshot_profiles</CODE>). Note: if you previously used Bigshot, the file location has changed from the old <CODE>\Lich5\scripts\bigshot_profiles</CODE> folder. You can copy/paste your old profiles to the new location.
* '''Resting''' - Configure your resting routine, rest location, and conditions that trigger resting.
* '''Hunting''' - Create a hunting map using boundaries, set your starting room, configure attack/wander stances, and define pre-hunt behavior.
* '''Attacking''' - Configure ambush aiming, flee conditions, bless behavior, weapon reactions, and similar combat flags.
* '''Commands''' - Define your valid targets and associated attack routines. See sample routines below.
* '''Boon Creatures''' - Configure how Bigshot handles boss/boon creatures on a per-ability basis (fight, ignore, or flee).
* '''Misc''' - UAC options, MSTRIKE options, ammo/wand configuration, and MA grouping settings.
* '''Monitoring''' - Interaction monitoring, deadman's switch, depart behavior, and debug options.

Each tab is covered in detail further on.

===Other Commands===
Beyond the setup GUI, Bigshot has several command-line options:
* <CODE>;bigshot quick</CODE> - A special hunting mode that kills everything in your current room, then quits. It will not wander or attempt to rest. Uses its own separate hunting commands and targets (configured on the Commands tab).
* <CODE>;bigshot head</CODE> / <CODE>;bigshot tail</CODE> - Multi-account hunting on a single computer. All characters must be set up for the same hunting area. Following characters run <CODE>;bigshot tail</CODE>, then the leader runs <CODE>;bigshot head</CODE>. The leader can optionally specify the expected group size, e.g., <CODE>;bigshot head 3</CODE>. Head and tail can be started in any order.
* <CODE>;bigshot display</CODE> - Shows all your current settings.
* <CODE>;bigshot reset</CODE> - Resets your targetable and untargetable lists. Useful if Bigshot will not target something it should.
* <CODE>;bigshot ranger</CODE> or <CODE>;bigshot companion</CODE> - Resets the ranger companion setting so you can reconfigure it. Use this when you change your companion.
* <CODE>;bigshot profile save <name></CODE> - Saves a profile in YAML format to your character's profile folder. Also accessible via the Profiles tab.
* <CODE>;bigshot profile load <name></CODE> - Loads a profile from your character's profile folder. Also accessible via the Profiles tab.
* <CODE>;bigshot single</CODE> - Executes a single hunting routine, returns to your resting location, and then exits.
* <CODE>;bigshot list</CODE> - Displays all initialized variable values (useful for troubleshooting).
* <CODE>;bigshot test <method> <args></CODE> - Runs a specific internal method for testing purposes.
* <CODE>;bigshot <creature></CODE> - Any input that does not match the above commands defaults to ranger tracking (e.g., <CODE>;bigshot single giant rat</CODE> will track and hunt a giant rat).

==The Profile Tab==
* '''Load Profile''' - Load an existing saved profile. The dropdown will be empty if no profiles have been saved yet.
* '''Current Profile''' - Displays the name of the currently loaded profile.
* '''Save Profile''' - Enter any name for your profile and click Save. Once saved, the profile will appear in the Load Profile dropdown.
* '''Notes''' - A freeform text area for any notes you want to associate with the profile.

==The Resting Tab==
This tab controls where and how Bigshot rests between hunts. During rest mode, Bigshot checks your mind state, hit points, wound status, mana, and spirit. Once all conditions defined in the "Should Hunt?" section are met, Bigshot leaves rest mode and begins a new hunt.

===Where to Rest===
* '''room id''' - The room Bigshot returns to for resting. Uses room numbers from Map/Go2. Supports both Lich IDs and SimuIDs (prefix SimuIDs with "u", e.g., <CODE>228</CODE> for Town Square Central or <CODE>u7120</CODE>).
* '''return waypoints''' - Optional intermediate room IDs that Bigshot will pass through when returning to rest. Separate multiple waypoints with commas.
* '''pre-rest commands''' - Commands executed before entering rest mode. Example: <CODE>shea, wear shield, sit, stance offensive, rest</CODE>. This will sheathe your weapon, wear your shield, sit down, enter offensive stance, and use the REST verb. You can also call scripts here using the <CODE>script</CODE> prefix, e.g., <CODE>script go2 place</CODE>.
* '''active resting scripts''' - Scripts that run upon entering rest mode for between-hunt tasks such as selling loot, spelling up, or healing. Example: <CODE>eloot sell, waggle, eherbs</CODE>. This will sell via eloot, spell up via waggle, then use herbs from your PACK to heal wounds.
* '''Fog Option''' - Determines how Bigshot returns to rest. Options include:
** '''None''' - Walk normally (no teleportation).
** '''130''' - Uses [[Spirit Guide (130)]] first; falls back to Symbol of Return if it fails.
** '''Symbol of Return''' - Uses Voln [[Symbol of Return]] first; falls back to 130 if it fails.
** '''Traveler's Song (1020)''' - Attempts [[Traveler's Song (1020)]] once, then continues.
** '''Familiar Gate (930)''' - Attempts [[Familiar Gate (930)]] to summon a portal and walk through it. Will perform a mana pulse if not enough mana is detected.
** '''Sigil of Escape''' - Uses [[Sigil of Escape]].
** '''Custom''' - Allows a comma-separated list of custom commands to perform.
* '''Fog ONLY if wounded or encumbered''' - When checked, Bigshot will only use the fog option if you are actually wounded or encumbered. Otherwise it walks normally.
* '''Fog twice from the Rift''' - When checked, Bigshot will double-cast the fog spell when returning from the Rift (useful since the Rift requires two uses to escape).

===Should Rest?===
Bigshot evaluates these conditions to decide when to leave a hunt and return to rest.
* '''when percent mind >='''
** Triggers resting when your mind has reached this threshold. Generally set to 100 (fried). Default is 100.
* '''and extra kills >='''
** The number of additional monsters to kill after reaching your "when percent mind" threshold and after LTE boosts are used. Set to 0 to rest immediately upon reaching the mind threshold.
* '''and used lte boosts >='''
** The number of LTE (Long-Term Experience) boosts Bigshot will attempt to use after reaching the mind threshold. Set to 0 to skip LTE boosts entirely.
* '''or percent mana <='''
** Forces Bigshot to rest when your mana percentage is at or below this value. Can be set to 0, but leaving a small buffer is useful (e.g., for Unlock (406) to open the WL Graveyard gate). If you encounter an "OOM" error, try setting this to 1.
* '''or percent encumbrance >='''
** Forces Bigshot to rest when your encumbrance reaches or exceeds this percentage.
* '''or wounded eval'''
** Allows you to set a Ruby evaluation expression to determine if you are too wounded to continue. Can trigger on bleeding, specific wound levels, inability to cast, scars, and more.

The following is a wounded evaluation that will rest whenever you have any level II wounds:
<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || Char.percent_health <= 70</PRE>
The following is a wound evaluation that will take you home if you can no longer cast (bleeding, nerves, level 2 head/eyes, bad scars, etc.):
<PRE>bleeding? || Char.percent_health <= 25 || [Wounds.head, Scars.head, Wounds.leftEye, Scars.leftEye, Wounds.rightEye, Scars.rightEye, Wounds.nsys, Scars.nsys].max > 1 || [Wounds.leftArm, Wounds.leftHand, Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand, Scars.rightArm, Scars.rightHand].max > 2 || ([Wounds.leftArm, Wounds.leftHand, Scars.leftArm, Scars.leftHand].max + [Wounds.rightArm, Wounds.rightHand, Scars.rightArm, Scars.rightHand].max) >= 3</PRE>
The following can be appended to either wound evaluation above to also rest upon having popped muscles:
<PRE>|| Effects::Debuffs.active?("Overexerted")</PRE>

* '''when creeping dread >='''
** Forces Bigshot to rest when your creeping dread level reaches or exceeds this value.
* '''when crushing dread >='''
** Forces Bigshot to rest when your crushing dread level reaches or exceeds this value.
* '''Wall of Thorns Poison'''
** Forces Bigshot to rest when you are affected by Wall of Thorns poison.
* '''Confusion Debuff'''
** Forces Bigshot to rest when you are affected by the non-dispellable Confusion debuff.
* '''Box in hand'''
** Forces Bigshot to rest if looting leaves a box in your hand.

==The Hunting Tab==
This tab controls when and where Bigshot hunts, any pre-hunt preparation, and the map boundaries for wandering.

===The Hunting Map===
Your hunting map consists of '''Boundaries''' (rooms Bigshot will never enter) and a '''Starting Room''' (the first room Bigshot moves to when a hunt begins). These function similarly to the boundaries in the ;Wander script, but are stored in Bigshot's own configuration files.

* '''starting room ID''' - The first room Bigshot travels to when beginning a hunt. Set this to any room within your boundaries.
* '''boundary rooms''' - Rooms that act as walls. Bigshot will never enter a boundary room.

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>

In the diagram above, "B" is a boundary room and "A" is outside the hunting area. Rooms marked "0" are the huntable area. Bigshot will wander freely among the "0" rooms but never cross into "B" or "A".

Boundary room IDs are separated by commas. Some popular examples:

'''Rift Boundaries:'''
<PRE>
Plane 1: 2635, 12101, 12208
Plane 2: 2605, 2635, 12093
Plane 3: 2635, 12089, 12152
Plane 4: 12122, 12207, 12235
Plane 5: 2579
North Scatter: 12151, 12254, 12256, 12249, 12247, 12241
South Scatter: 12151, 12219, 12217, 12233, 12237, 12239
</PRE>

'''Maaghara Boundaries:'''
<PRE>9734</PRE>

'''Confluence Boundaries:'''
<PRE>2300, 3519, 228, 188, 1932, 10855, 3668, 1438, 1005</PRE>

Imagine a hunting area that is a six-room square. To enter this square, you must GO DOORWAY from room A. You would set room A (outside the square, before the doorway) as a boundary. Then set room B (just inside the square) as the starting room. Bigshot will move to room B and wander within the bounded area until your "Should Rest?" conditions are met.

* '''rally point rooms''' - Optional intermediate room IDs Bigshot will pass through on the way to the hunting area. Separate multiple rooms with commas.

===Hunting Settings===
* '''wait before wandering to another room''' - Time in seconds Bigshot waits before leaving a room to look for creatures. Default is 0.3. Set to 0 for fastest (but spammy) movement.
* '''attack stance''' - The stance Bigshot switches to when issuing attack commands. Bigshot remains in defensive stance until an attack is triggered, then stances to your specified attack stance. Recognizes all game stances from Offensive through Defensive.
* '''wander stance''' - The stance Bigshot uses while moving between rooms. Defaults to Defensive.
* '''stand up stance''' - The stance Bigshot enters when standing up after being knocked down. Defaults to Defensive.
* '''pre-hunt commands''' - Commands executed before Bigshot uses Go2 to travel to your starting room. Example: <CODE>gird, stance defensive</CODE>. This ensures your weapon is readied and you are in defensive stance before traveling. Use this line for short-lived combat spells like 1605 (Arm of the Arkati).
* '''active hunting scripts''' - Scripts that run while Bigshot is in hunt mode. Use these for complex behaviors that Bigshot does not natively support (e.g., keeping certain spells active or executing CMANs based on conditions).
* '''society abilities/spells/cmans''' - Abilities Bigshot keeps active during a hunt. Enter numerical designations separated by commas. For example, entering <CODE>506</CODE> keeps Haste up, recasting whenever it wears off. Hover over this field in the GUI for a list of supported values. Supported options include spells that can be ignored by rapidfire cooldown: e.g., <CODE>515 (ignore)</CODE> or <CODE>rapidfire (ignore)</CODE>.
* '''loot script''' - The script Bigshot calls to loot your kills (e.g., <CODE>eloot</CODE>). Make sure the loot script is properly configured via its own SETUP command, or Bigshot may error.
* '''wracking spirit >=''' - If your spirit is greater than or equal to this value, Bigshot will WRACK for mana. Setting it to 6 will wrack down to 5 spirit. Only functions when the wracking checkbox is enabled.
* '''Use sign of wracking/sigil of power''' - Checkbox to enable wracking.
* '''Check for favor before using Voln symbols''' - Checkbox to verify you have sufficient favor before casting Voln society symbols.
* '''Priority hunt''' - When enabled, Bigshot targets creatures in the order listed in your valid targets field. If a higher-priority creature enters the room, Bigshot switches to it. When using <CODE>;bigshot quick</CODE>, quickhunt targets take priority, followed by any remaining targets in room order.
* '''Delay looting''' - Delays the looting of creatures in a room.
* '''Defensive stance before looting''' - Switches to defensive stance before looting begins.
* '''Pull players to feet''' - Attempts to pull players to their feet when passing them.
* '''Stop for dead players''' - Pauses Bigshot if you encounter a dead player.
* '''Troubadour's Rally''' - Enables the use of Troubadour's Rally during hunts.
* '''Sneaky Sneaky''' - Sneak around while moving through the hunting area.

===Should Hunt?===
Bigshot evaluates these conditions to determine if you are ready to begin a hunt from rest.
* '''when percent mind <='''
** Setting this to 51 will wait until "Clear". Setting it to 65 will wait until "Muddled".
* '''and percent mana >='''
** The percentage of your maximum mana that must be present before hunting. Setting below 50 results in short hunts if you cast frequently. Generally set to 95 or higher.
* '''and CHECK spirit >='''
** Bigshot checks that your current spirit value is at least this amount. Make sure this is high enough that Bigshot will not immediately hunt after DEPARTing if you have the "Depart / re-run" option enabled on the Monitoring tab.
* '''and percent stamina >='''
** The percentage of your maximum stamina that must be present before hunting. Useful for melee-heavy builds that rely on stamina for CMANs and MSTRIKEs.

==The Attacking Tab==
This tab controls aiming, flee conditions, and various combat behavior toggles.

* '''Ambush aiming locations (head, etc)''' - The order Bigshot aims when ambushing. Default is head, right leg, left leg, chest. Bigshot cycles through these and skips locations that are too injured or unreachable.
* '''Archery aiming locations (head, etc)''' - The order Bigshot aims when using archery attacks. Loops through your aiming list.
* '''flee if enemy count is >''' - Flees the room if the total number of enemies exceeds this value. Set to 1 to engage only single targets.
* '''...but don't count these''' - Bigshot ignores these monsters when evaluating flee count. Useful when low-level monsters are mixed into your hunting area.
* '''...and always flee from''' - Bigshot immediately flees from these monsters. Useful when your hunting area has higher-level or dangerous monsters mixed in.
* '''flee from environment message''' - Bigshot flees whenever the game sends a message matching this text (uses XML regex matching).
* '''wait before wandering to another room''' - Time in seconds before moving to a new room. Default is 0.3. Set to 0 to move instantly (can be spammy for others in the area).
* '''Approach lone targets only''' - Forces Bigshot to only begin combat against creatures that are alone in a room.
* '''Bless weapon?''' - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on any weapon that loses its bless during hunting. If unable to bless during hunting, Bigshot returns to the rest area and quits.
* '''Activate weapon reactions''' - Initiates reactive strikes when the opportunity presents itself.
* '''Flee from clouds''' - Flees from cloud spells such as 125 (Call Lightning/Ominous Cloud), 1704 (Stun Cloud), and 1713 (Death Cloud).
* '''Flee from vines''' - Flees from vine spells such as 610 (Tangle Weed).
* '''Flee from webs''' - Flees from webs.
* '''Flee from voids''' - Flees from voids.

==Commands Tab==
This is the core of Bigshot — where you define your attack routines.

===Hunting Commands===
* '''hunting commands (a)''' - The primary commands Bigshot executes when in a room with a valid target. Commands are separated by commas. Bigshot recognizes most hunting verbs; unrecognized commands are sent directly as-is via fput. The following are recognized hunting commands:
** '''kill''' - Attacks using the KILL verb.
** '''incant <spell number>''' - Casts the specified spell with INCANT. Automatically stances into offensive for bolt and stance-sensitive spells. You can CHANNEL via <CODE>INCANT SET CHANNEL <spell></CODE> (a standard GSIV verb) or by setting <CODE>SET ChannelIncant ON</CODE>, which will CHANNEL an INCanted spell if you are in a stance higher than neutral.
** '''channel <spell number>''' - Channels the specified spell at the target. Requires a stance higher than neutral to have effect.
** '''<spell number>''' - Casts the specified spell using PREPARE and CAST.
** '''wand''' - Gets a wand from your specified container and WAVEs it at the target.
** '''wandolier''' - Similar to wand, but designed for wandoliers. Gets a wand from the fresh wand container and waves it; rubs the container if no wands are found. Default waves in offensive stance. Use <CODE>wandolier defensive</CODE> to wave in a different stance.
** '''fire''' - Gets ammunition from your specified container and FIREs at the target. Aims based on Archery aiming settings on the Attacking tab.
** '''aim <location>''' - Aims at the specified body location.
** '''ambush''' - Uses the AMBUSH verb to attack, aiming based on Attacking tab settings. Can also aim dynamically: <CODE>ambush head</CODE> overrides default settings for that attack.
** '''wait <time>''' - Stance dances by going into Defensive stance for the specified time (in seconds). Bigshot will exit early if the target swings or casts, then evaluate the rest of the attack routine from your attack stance.
** '''mstrike''' - Executes MSTRIKE based on cooldown and stamina. Has its own options page under the Misc tab. Can also be used with UAC: <CODE>mstrike punch</CODE>.
** '''berserk''' - Executes the BERSERK verb and waits until it fades.
** '''throw''' - Empties hands, attempts throw, then retrieves the items you emptied.
** '''weed/kweed''' - Casts 610 at the target. Using <CODE>kweed</CODE> forces EVOKE 610, ensuring the damage version.
** '''curse <type>''' - Preps 715 and uses the specified curse type. Valid types: Clumsy, Weakness, Darkness, Itch, Hex, Pox, Nightmare, Star. Skips "curse star" if the buff is already active.
** '''unarmed <type>''' - Uses the Bigshot UAC routine. Valid types: punch, jab, kick, grapple. The routine uses appropriate attacks to rank up and applies MSTRIKE based on MSTRIKE options. Example: <CODE>unarmed jab</CODE>.
** '''smite''' - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on the target until successful.
** '''leech''' - Performs a [[Mana Leech (516)]] on the target if cooldown is under 15 minutes.
** '''script <script name>''' - Executes a specified custom attack script.
** '''hide''' - Repeatedly attempts to hide until successful or gives up.
** '''sleep <nostance>''' - Pauses Bigshot for the specified number of seconds. Example: <CODE>sleep 10</CODE> or <CODE>sleep 10 nostance</CODE>. Useful for timed hunting, e.g., <CODE>410, sleep 15</CODE> will E-wave, then wait 15 seconds before re-evaluating.
** '''stance <stance>''' - Changes stance. Example: <CODE>stance defensive</CODE>.
** '''nudgeweapons''' - Moves all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** '''force <cmd> until <endroll>''' - Repeats a command until a desired endroll is achieved. Example: <CODE>force incant 1002 until 101</CODE>. Only works for standard swings/spells/CMANs.
** '''eachtarget <cmd>''' - Issues the command against each valid target in the room.
** '''efury <fire|cold>''' - Casts Earthen Fury (917) on the target and waits for the DOT to end or 12 seconds to pass.
** '''caststop <spell>''' - Casts the spell and immediately stops it after casting.
** '''wield <noun> <left|right>''' - Wields a new item in the specified hand and stores the current item.
** '''store''' - Stores items in left, right, or both hands (only if something is in those hands).
** '''tether <recast>''' - Casts 706 with built-in wait logic. The optional <CODE>recast</CODE> flag will auto-recast 706 on creature death and transfer DOTs to a new target.
** '''unravel <spell>''' - Casts 1013 (Song of Unravelling). Optionally specify a spell number to target against the creature.
** '''depress''' - Casts 1015 (Song of Depression) with built-in logic.
** '''phase''' - Force-casts 704 (Phase) using PREP/CAST, required for NPC targeting to convert non-corporeal to corporeal undead.

===Additional Command Sets===
* '''hunting commands (b) through (j)''' - Additional attack routines tied to creature flags. When you flag a creature in your valid targets (e.g., <CODE>niirsha(b)</CODE>), Bigshot uses the matching command set. This allows different attack strategies for different creature types.
* '''fried hunting commands''' - Commands executed specifically when your mind is fried. Useful in group hunting where you still want to contribute.
* '''quick hunting commands''' - Commands executed when using <CODE>;bigshot quick</CODE>.
* '''valid targets''' - The monsters you are hunting. Bigshot works best with creature NOUNs (e.g., <CODE>ogre</CODE> instead of <CODE>a large ogre</CODE>). Use commas to separate multiple targets: <CODE>manticore, thrak</CODE>. If left blank, Bigshot will target everything in the room. Supports regex for advanced matching.
* '''quickhunt targets''' - Designated targets for the <CODE>;bigshot quick</CODE> option.

===PSM3 Integration===
Bigshot supports weapon/shield skills and warcries. Assaults wait until they finish or are interrupted. The following are recognized PSM3 commands:

'''Assaults''' (wait until completed/interrupted):
* barrage, flurry, fury, gthrusts, pummel, thrash
* fury can specify a default attack: <CODE>fury punch</CODE> or <CODE>fury kick</CODE> (defaults to jab)

'''Setups''' (execute on cooldown — pair with prone/stun/root checks):
* charge, cripple, dizzyingswing, pindown, twinhammer

'''AOE''' (execute on cooldown — limit with mob checks):
* clash, cyclone, pulverize, volley, wblade, whirlwind

'''Warcries:'''
* '''shout''' - Performs warcry Shout. Must use a command check or it will shout every loop: <CODE>shout(!shout)</CODE> or <CODE>shout(buff10 s25)</CODE>
* '''yowlp''' - Performs warcry Yowlp. Must use a command check: <CODE>yowlp(!yowlp)</CODE> or <CODE>yowlp(buff10 s10)</CODE>
* '''holler''' - Performs warcry Holler, taunting all mobs. Example: <CODE>holler(s60)</CODE>
* '''bellow, growl, cry''' - Offensive warcries. Use with <CODE>target</CODE> for single target or <CODE>all</CODE> for AOE.

'''Shield Skills:'''
* shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw

'''Combat Maneuvers:'''
* '''surge''' - Keeps Surge of Strength active. <CODE>surge</CODE> or <CODE>surge(surge)</CODE> casts even on cooldown; <CODE>surge(!surge)</CODE> only casts when not on cooldown.
* '''bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, disarm, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kifocus, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick'''
* '''dislodge <location>''' - Dislodge from the specified location: <CODE>dislodge eye neck</CODE>
* '''stomp''' - Performs a stomp attack. Channels 909 if not already active. You can also add 909 to the society abilities field to keep it active.
* '''dhurl''' - Hurls your weapon and recovers it. Works with weapon bonding auto-return and the RECOVER verb.
* '''assume <aspect> <aspect/evoke>''' - Cycles between two aspects, or evokes a single aspect. Also works in the society abilities box: <CODE>650 <aspect> <aspect/evoke></CODE>
* '''briar <weapon>''' - Activates the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
* '''stance perfection''' - Put 10, 20, 30, etc. in your attack stance box to take advantage of stance perfection.
* '''chastise, excoriate''' - Performs the FEAT if available and affordable.
* '''rebuke''' - Performs Righteous Rebuke.
* '''scourge''' - Performs Ardor of the Scourge.
* '''momentum''' - Performs Glorious Momentum.

===Gemstone Activation===
To use a gemstone-activated ability, use <CODE>jewel <mnemonic></CODE>. Bigshot automatically avoids usage if the ability is on cooldown. Supported gemstone mnemonics:
* bloodboil - Blood Boil
* spellblade - Spellblade's Fury
* arcascend - Arcanist's Ascendancy
* geospite - Geomancer's Spite
* forceofwill - Force of Will
* arcaneintensity - Arcane Intensity
* arcaneopus - Arcane Opus
* bloodsiphon - Blood Siphon
* bloodwell - Blood Wellspring
* epossess - Evanescent Possession
* manawellspring - Mana Wellspring
* spiritwell - Spirit Wellspring
* stamwell - Stamina Wellspring
* terrortribute - Terror's Tribute
* arcblade - Arcanist's Blade
* arcwill - Arcanist's Will
* imaerabalm - Imaera's Balm
* reckless - Reckless Precision
* unearthchains - Unearthly Chains
* witchhunt - Witchhunter's Ascendancy
* manashield - Mana Shield
* arcaneaegis - Arcane Aegis

You may need to run '''SKILLS FULL''', '''CMAN INFO''', '''WEAPON INFO''', or '''SHIELD INFO''' if you have recently changed training or if skills are being skipped.

===Additional Options===
* '''haste''' or '''506''' - Placing this in front of any command casts 506 (Haste) before executing the command. Only casts if Haste is not currently active or has less than 3 seconds remaining.
<PRE>wait 10, haste kill (x3)</PRE>
* '''slayer''' or '''240''' - Placing this in front of any command casts 240 before executing. Will not recast if already active.
<PRE>slayer 302 (x99)</PRE>

===Command Checks===
Command checks let you add conditions to any command. The format is:
<CODE>COMMAND (CHECKS)(REPETITIONS)</CODE>

Example: <CODE>hamstring (mob1 prone)(x2)</CODE>. The (x#) repetition must be in a separate set of parentheses. Note that (xx) is shorthand for (x5), not unlimited.

Checks can be combined inside a single set of parentheses with spaces between them. Example: <CODE>kill(m20 s5 e20)</CODE>

Each check also has an inverse — prefix with <CODE>!</CODE> to negate. Example: <CODE>kill(!m20 !s5 !e20)</CODE>

'''Resource and Status Checks:'''
* '''s#''' - Requires at least # stamina.
* '''m#''' - Requires at least # mana.
* '''h#''' - Requires health to be at or above #% (percentage, not fixed).
* '''v#''' - Requires at least # spirit.
* '''e#''' - Requires encumbrance percentage to be at or below #.
* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).

'''Creature Checks:'''
* '''mob#''' - Requires at least # NPCs in the room. Only useful for 2 or more creatures.
<PRE>To further clarify the mob# implementation:
1 mob, mob2: 1 IS less than 2 — attack does NOT proceed.
2 mobs, mob2: 2 IS NOT less than 2 — attack CAN proceed.
1 mob, !mob2: 1 IS NOT more than 2 — attack CAN proceed.
2 mobs, !mob2: 2 IS NOT more than 2 — attack CAN proceed.
3 mobs, !mob2: 3 IS more than 2 — attack does NOT proceed.</PRE>
* '''valid#''' - Like mob#, but only counts valid targets you are actively targeting in current settings.
* '''tier#''' - Checks your current UAC tier (1, 2, 3). Performs the command if your tier is equal to or greater than #. <CODE>(!tier3)</CODE> skips the command at tier 3.
* '''prone''' - Checks that the target is NOT sleeping, webbed, stunned, kneeling, sitting, lying down, prone, frozen, or held in place. Performs the command if none of those apply.
* '''frozen''' - Similar to prone but broken out separately. Useful for archers against non-corporeal creatures that deflect ranged attacks. Corporeal creatures that are stunned will break this check.
* '''undead''' - Performs the command if the target is undead.
* '''flying''' - Performs the command if the target is flying.
* '''rooted''' - Performs the command if the target is rooted.
* '''noncorporeal''' - Performs the command if the NPC is [[noncorporeal|non-corporeal]] undead.
* '''ancient''' - Checks for grizzled/ancient creatures.

'''Self Checks:'''
* '''hidden''' - Performs the command if you are currently hidden.
* '''poison''' - Performs the command if you are currently poisoned.
* '''disease''' - Performs the command if you are currently diseased.
* '''pcs''' - Performs the command if there are PCs in the room that are not in your group.
* '''outside''' - Performs the command if the room is outdoors.
* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.

'''Timing Checks:'''
* '''once''' - Performs the command once per target. Resets on room change.
* '''room''' - Performs the command once per room. Resets on room change.

'''Buff Checks:'''
* '''barrage''' - Checks for the Enhanced Dexterity buff from Barrage.
* '''fury''' - Checks for the Enhanced Constitution buff from Fury.
* '''flurry''' - Checks for the Slashing Strikes buff from Flurry.
* '''pummel''' - Checks for the Concussive Blows buff from Pummel.
* '''thrash''' - Checks for the Forceful Blows buff from Thrash.
* '''vigor''' - Checks for the Tangleweed Vigor buff.
* '''reflex''' - Checks for the Arcane Reflex buff from Nature's Touch.
* '''tailwind''' - Checks for the Tailwind buff from Breeze.
* '''shout''' - Checks for the Empowered buff from Shout.
* '''yowlp''' - Checks for Yertie's Yowlp buff from Yowlp.
* '''holler''' - Checks for Horland's Holler buff from Holler.
* '''voidweaver''' - Checks for the Voidweaver buff from Implosion (720).
* '''justice''' - Checks for charges of Swift Justice. <CODE>(justice)</CODE> acts with charges; <CODE>(!justice)</CODE> acts with no charges.
* '''surge''' - Checks for Surge of Strength buff.
* '''rebuke''' - Checks for Righteous Rebuke buff.
* '''scourge''' - Checks for Ardor of the Scourge buff.
* '''momentum''' - Checks for Glorious Momentum buff.
* '''coupdegrace''' - Checks for the Empowered buff from Coup de Grace.
* '''animate''' - Checks for whether you have an animate present.
* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds. Supported for barrage, bearhug, coupdegrace, fury, flurry, pummel, thrash, shout, yowlp, garrote.
* '''censer''' - Attempts to cast 320 before your command, checking mana and cooldown. Examples: <CODE>309(censer)</CODE>, <CODE>335(censer mob3)</CODE>, <CODE>attack(censer)</CODE>
** If the command is a spell, censer only casts if you have mana for both 320 and the spell.
** If the command is not a spell, censer only checks you have enough mana for 320.

===Example Attack Routines===
<PRE>wait 10, kill (x3)</PRE>
Waits 10 seconds for the monster to swing or cast, then counter-attacks from your specified attack stance. Swings three times, then goes back to defensive and waits again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>
Waits 15 seconds, then INCants 505 (Hand of Tonis) to knock down or stun the target. Follows up with repeated casts of 903 (Minor Water) until the target is dead (up to 5 times).

<PRE>stance defensive and incant 1615, kill (x100)</PRE>
Casts 1615 (Divine Strike) from defensive stance, then uses KILL continuously until the target is dead or 100 swings (whichever comes first).

<PRE>force feint until 101, kill (x2)</PRE>
Uses FEINT against the target until a successful endroll, then hits twice before trying FEINT again.

<PRE>stance defensive and hide, ambush left leg</PRE>
Hides from defensive stance, then ambushes the target's left leg. Repeats (hides again) after roundtime.

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>
Casts 720 (Implosion) if you have 50+ mana, then INCants 708 (Limb Disruption) at the default aim location, then channels 702 (Mana Disruption) up to 5 times or until dead.

<PRE>prep 708, cast at left leg / prep 708 channel at left leg, incant 719 (m50)(x1), incant 702 (xx)</PRE>
Prepares 708 and CASTs at the left leg. The second variant prepares and CHANNELs at the left leg. Then casts 719 (Dark Catalyst) once if 50+ mana. Finally, INCants 702 until the creature is dead.

<PRE>wait 30, unarmed punch</PRE>
Waits 30 seconds or until the target attacks, then begins UAC combat using Punch to tier up.

<PRE>shield charge (s15 prone), ambush, mstrike</PRE>
Shield charges the target if you have 15+ stamina and the target is NOT prone. Then ambushes based on Attacking tab settings (cycling through configured aim locations). Then MSTRIKEs — focused if below the creature threshold, unfocused if at or above it. Use <CODE>mstrike target</CODE> to always focus, or set unfocused threshold very high.

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>
AOE bellows, then Whirling Blade if 3+ targets. Flurries if the Slashing Strikes buff is not active. Falls back to basic attack.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>
Taunts with Holler, Shield Throws if 3+ targets, Flurries on cooldown, Thrashes on cooldown, and attacks as a fallback.

<PRE>shroud(s35 !hidden mob2), divert (s25 hidden mob2), ambush(hidden), flurry, attack</PRE>
If 2+ mobs: hides with Shroud (35 stamina, not already hidden), then Diverts one target (25 stamina, must be hidden). Ambushes if hidden, Flurries on cooldown, attacks as fallback.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>
Keeps Surge active (casting only when not on cooldown). Bullrush to apply vulnerable, Bearhug (faster on vulnerable targets), Pummel on cooldown, attack as fallback.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>
Keeps Surge active (casting even during cooldown for 60 stamina). Shouts when less than 11 seconds remain on the buff. Shield Strikes, Pummels once per minute, finishes with 2 attacks.

<PRE>pindown(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 (m16 reflex), fire</PRE>
Pin Down if 4+ targets, Volley if 2+ targets. Tangleweed if missing Vigor and Reflex buffs. Barrage if missing Enhanced Dexterity. Spike Thorn (616) if 16+ mana and Arcane Reflex is active. Fire as fallback.

===Hunting Target Examples===
All examples below work for both "valid targets" and "quickhunt targets."

A simple target list using default commands (a) for each creature:
<PRE>crazed zombie, niirsha, sacristan spirit</PRE>

Using different command sets per creature — (a) for zombies and spirits, (b) for niirsha:
<PRE>crazed zombie(a), niirsha(b), sacristan spirit(a)</PRE>

Including [[:Category:Boss creatures|Boss Creature]] variations as valid targets using regex:
<PRE>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</PRE>

Advanced regex for Grimswarm hunting with different commands per class:
<PRE>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)
</PRE>

To target everything in the room: <CODE>(?:.*)</CODE>

==Boon Creatures Tab==
Boss creatures (also called the Boss Creature System) upgrades newly created creatures into bosses, minibosses, or packs. Upgraded creatures have their level and basic stats boosted, and are granted a number of special abilities called '''boons''', which are denoted by a special adjective in the creature's name. Players have alternatively called these "glam critters," "gifted creatures," or "boosted critters."

Additional details are available on the GemStone Wiki: [https://gswiki.play.net/Category:Boss_creatures Category:Boss creatures]

The Boon Creatures tab provides granular control over how Bigshot handles each boon ability. Bigshot uses the ASSESS verb to identify which boons a creature has, then checks your configuration to decide how to respond.

===How It Works===
For each boon ability, you can choose one of three actions:
* '''Common''' - Treat as a normal target and fight it. Uses your hunting commands to kill. Still requires proper valid target matching to engage. This is also the default behavior if no selection is made.
* '''Ignore''' - Skip this creature entirely; do not engage it.
* '''Flee''' - Immediately flee from the room when this boon type is detected.

===Master Toggle===
At the top of the tab is an '''All Boon Creatures''' section with Common, Ignore, and Flee checkboxes. These act as master toggles — checking one will set every individual boon ability across all groups to that action. If all individual items are already set to the same action and you uncheck the "All" toggle, everything gets unchecked.

===Boon Groups===
The individual boon abilities are organized into four collapsible groups, each with its own group-level toggle row ("Entire Group") and individual per-ability rows:

====Immunity====
Boons that make the creature resistant or immune to certain damage types or effects.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Crit Death Immune || resolute, unflinching || Similar to constructs or golems
|-
| Damage Padding || flinty, tough ||
|-
| Elem Negation || sparkling, shining || Absorbs elemental magic attacks
|-
| Magic Resistance || rune-covered, tattooed || Reduces magic damage by 50%
|-
| Physical Negation || indistinct, nebulous || Physical damage resist shield
|-
| Stun Immune || steadfast, unyielding ||
|}

====Offensive====
Boons that enhance the creature's offensive capabilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Boosted Offense || combative, belligerent ||
|-
| Cheat Death || glorious, illustrious || Raises self after death
|-
| Counter Attack || apt, ready || SMR counter-attack
|-
| Crit Weighting || shimmering, gleaming ||
|-
| Dmg Weighting || barbed, spiny ||
|-
| Dispelling || dazzling, flashy || Spirit Dispel (119) and Elem Dispel (417)
|-
| Elemental Flares || glittering ||
|-
| Frenzy || raging, frenzied ||
|-
| Mind Blast || canny, keen ||
|-
| Parting Shot || dreary, drab || Deals damage one last time upon death
|-
| Poisonous || sickly green, oozing || SMR poison gas cloud
|}

====Defensive====
Boons that enhance the creature's defensive capabilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Blink || flickering, wavering || Temporary phase ability
|-
| Bolt Shield || shielded ||
|-
| Boosted Defense || sinuous, flexile || High damage padding (+12 CER)
|-
| Confuse || blurry, shifting || May give hard RT for casting at them
|-
| Crit Padding || stout, hardy ||
|}

====Stats / Misc====
Boons that affect the creature's stats, resistances, or grant miscellaneous special abilities.
{| class="wikitable"
! Boon !! Adjectives !! Notes
|-
| Boosted HP || robust, stalwart ||
|-
| Boosted Mana || luminous, lustrous ||
|-
| Diseased || pestilent, afflicted, diseased ||
|-
| Extra Spells - Elem || glowing ||
|-
| Extra Spells - Spirit || radiant ||
|-
| Extra Spells - Other || twinkling ||
|-
| Ethereal || ethereal, wispy, ghostly || Noncorporeal undead. No Sheer Fear.
|-
| Jack of All Trades || adroit, deft ||
|-
| Regeneration || slimy, muculent || Similar to Troll's Blood (1125)
|-
| Soul Stealing || tenebrous, shadowy || May possess 1204, 1601, and 1712
|-
| Terrifying || ghastly, grotesque || Pre-attack SMR can force player into defensive
|-
| Weaken || spindly, lanky || Weaker creature than normal
|}

===Usage Tips===
* If you are a melee character who struggles with '''Stun Immune''' or '''Crit Death Immune''' creatures, set those to Ignore or Flee while leaving others on Common.
* Casters may want to Flee from '''Dispelling''' and '''Magic Resistance''' boons.
* '''Weaken''' is actually beneficial — the creature is weaker than normal, so leaving it on Common is usually best.
* '''Cheat Death''' creatures will revive after dying; consider Ignore if your build cannot handle killing them twice.
* The configuration is saved per profile, so you can have different boon strategies for different hunting areas.

== Misc Tab==
Various specialized configuration options.

===UAC Options===
Options for configuring Unarmed Combat (UAC):
* '''Tier 3 Attack''' - The attack used when you have reached "excellent" positioning. Options: jab, punch, grapple, or kick.
* '''Aim at location (head, etc)''' - Used for aimed UAC combat, which requires ambush training to be effective. Leave blank if you do not want to aim.
* '''MSTRIKE when creatures equal or greater''' - How many creatures must be present before using MSTRIKE during UAC.
* '''Use Voln SMITE?''' - Will perform a Voln SMITE on [[Non-corporeal]] undead.

'''Quick Setup:''' Bigshot only requires minimal configuration for UAC to work well:
# '''UAC options:''' Set your '''Tier 3 Attack''' (jab, punch, grapple, or kick).
# '''Commands tab:''' Set your '''hunting commands (a)''' to '''unarmed jab'''.

Important notes about UAC in Bigshot:
* <CODE>unarmed jab</CODE> can be replaced with any UAC attack type (e.g., <CODE>unarmed punch</CODE>).
* UAC follow-up strikes take priority over the base or Tier 3 attack.
* Tier 3 attacks are only used when positioning is "excellent".
* There is almost no reason to use anything other than <CODE>unarmed jab</CODE> as the hunting command and either <CODE>grapple</CODE> or <CODE>kick</CODE> as the Tier 3 attack.

===MSTRIKE Options===
Options for when and how MSTRIKE should be used:
* '''MSTRIKE during cooldown stamina requirement''' - How much stamina you need before Bigshot will MSTRIKE during the MSTRIKE cooldown period. Be careful setting this too low, as it can pop your muscles. Leave blank to use your max stamina.
* '''QUICKSTRIKE stamina requirement''' - Stamina required for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater''' - Number of creatures in the room before Bigshot uses an unfocused (AOE) MSTRIKE instead of a focused one. Default is 2.
* '''MSTRIKE during cooldown''' - Toggle to allow MSTRIKEing during the cooldown period.
* '''Use QUICKSTRIKE for MSTRIKE''' - Toggle to use QUICKSTRIKE instead of normal MSTRIKE.

===Ammo/Wands===
Settings for ammunition and wand management. If your attack routine uses FIRE or WAND verbs, these fields must be configured or Bigshot will hang.

* '''find ammo in this container''' - The container holding your ammunition (quiver, backpack, etc.). Leave BLANK if using FIRE without retrieving ammo (post-Archery 2020 Update).
* '''use this ammo type''' - The noun of your ammo type. Leave BLANK to use FIRE without retrieving ammo. Be precise with the noun — Bigshot is sensitive to exact naming here.
* '''fresh wand container''' - The container Bigshot checks for fresh wands to WAVE.
* '''dead wand container''' - The container where Bigshot deposits used-up wands.
* '''use this wand type''' - The specific wand type(s) to use. Bigshot only pulls these for WAVEing. Separate multiple types with commas. Example: <CODE>aquamarine wand, bloodwood wand</CODE>
* '''Hide while waiting to pick up ammo''' - Bigshot will hide when gathering spent arrows and bolts.
* '''Use wands when out of mana''' - When out of mana, Bigshot pulls the specified wand type, stances to your attack stance, and WAVEs at valid targets until out of wands or resting conditions are met.

===MA Grouping===
Multi-account grouping options:
* '''Looter name''' - The name of the character designated as the looter in Head/Tail configuration.
* '''No-looting list''' - Comma-separated list of characters who should never be assigned looting duty.
* '''Random looting''' - Distributes looting randomly based on encumbrance rather than assigning a fixed looter.
* '''Leader final loot''' - Allows the leader to perform a final loot pass before leaving a room.
* '''Travel TO hunting grounds independently''' - When enabled, group members travel to the hunting area on their own rather than as a group. Bigshot will disband the group and force GROUP OPEN after disbanding.
* '''Travel FROM hunting grounds independently''' - When enabled, group members return from the hunting area on their own.
* '''Stop for dead group members''' - Pauses the group if a follower dies during a hunt.

==Monitoring Tab==
Options for safety, interaction monitoring, and debugging.

* '''Monitor interaction''' - Pops up a window whenever Bigshot detects that someone or something is trying to interact with you. Customizable monitor strings and safe strings can be configured.
* '''Engage deadman's switch''' - Forces Bigshot to quit GemStone IV when your character drops below 40% health, allowing you to log back on and assess the situation manually.
* '''Depart/rerun if dead''' - Forces a DEPART (waking up in the Temple with low spirit), then restarts Bigshot for a fresh hunt. Make sure your "CHECK spirit >=" value in Should Hunt? is set high enough to recover before the next hunt.
* '''Quiet followers''' - Followers wait until the leader finishes both actions and resting scripts before beginning their own.
* '''Ignore disk objects''' - Ignores disk objects when evaluating room claims and other checks.

===Debugging===
Bigshot provides detailed debug options for troubleshooting. Use these commands in-game:
<pre{{log2}}>
+---------------------------------------------------------------------------+
| Bigshot Debug Help v5.11.4 |
+---------------------------------------------------------------------------+
| Debug options have changed to be more helpful. |
+--------------------------------------+------------------------------------+
| ;bigshot debug file | Toggles logging to a file <on/off> |
| ;bigshot debug all <true/false> | Toggles true/false all the things |
| ;bigshot debug check | Lists current debug settings |
| ;bigshot debug combat <true/false> | Combat and Creature Status |
| ;bigshot debug commands <true/false> | Attacking and Casting Commands |
| ;bigshot debug status <true/false> | Status Checks of your Character |
| ;bigshot debug system <true/false> | System processes |
| | |
| Options can be combined: |
| ;bigshot debug combat commands status <true/false> |
+---------------------------------------------------------------------------+
</pre>

Debug log files are stored in your Lich5 logs directory under <CODE>debug/<Game>-<CharacterName>/bigshot.log</CODE> and rotate daily.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|Profiles
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting
File:bigshot-4.PNG|Attacking
File:bigshot-5.PNG|Commands
File:bigshot-6.PNG|Misc
File:bigshot-7.PNG|Monitoring
</gallery>

==Reference==
* Info originally taken from http://forum.gsplayers.com/showthread.php?t=57651

{{Third-Party Software}}
{{top}}

SimuCon 2026

2026-02-04T02:36:35Z

HORIBU1: fix date

'''SimuCon''' is a yearly gathering in St. Louis near [[Simutronics]] headquarters usually taking place near the end of the summer.

'''<u>OFFICIAL</u>''' dates for 2025 are Thursday, July 9 through Sunday, July 12, 2026 at the Sheraton Westport Plaza Hotel. We will post more as the dates unfold and more information is available.

==2025 Schedule==
===Main Schedule===
All times CST (CENTRAL TIME)

Event Color Coding:<br>
This event is in the main conference room.<br>
<span style="color:blue">This event is in Breakout 1.</span><br>
<span style="color:#BF40BF">This event is in Breakout 2.</span><br>
<span style="color:red">This event is in Breakout 3.</span>

===Streaming Schedule===

=== Unstreamed Panels ===

==Attendee List==
===Prime Players===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">

</div>

===Platinum Players===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">

</div>

===Shattered Players===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">

</div>

===Game Staff===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">

</div>

==Frequently Asked Questions==
===How much does SimuCon cost?===
Attendance badges have previously cost $40 when purchased in advance. Tickets are available at the door, but will be more expensive. Please see the [[#Ticketing|Ticketing]] section for more details.

=== Where do I sign up?===

Ticketing will likely be handled via the play.net Box Office when available. Please see the [[#Ticketing|Ticketing]] section for more details.

===Who organizes SimuCon?===

Typically GameMasters from Gemstone IV and DragonRealms are the official organizers. However, many players pitch in to plan unofficial events or to offer support. All work is strictly volunteer, so please be sure to thank your organizer team!

===What is it like to attend a SimuCon?===

SimuCon is a gathering of players and GameMasters for Simutronics games, including Gemstone IV and DragonRealms. The convention includes several events, as listed in the [[#2025 Schedule|2025 Schedule]], that are planned by both players and staff. In-between events, attendees typically gather at conference tables similar to a large LAN party to play. Board games and other activities are frequently available as well.

===How many people attend SimuCon and when do they show up?===

SimuCon has experienced a growth spurt over the past three years or so. A current rough estimate would be 100 attendees (GS and DR combined) over the course of the weekend. The main convention days are Thursday through Sunday, although several people arrive on Wednesday and stay through Monday. The convention room is typically setup by Wednesday evening.

===What equipment should I bring? ===

Bring your laptop/computer so that you can play Gemstone during the convention. Internet access and power strips are typically provided. '''Note:''' It is not recommended that you leave your equipment unattended in the conference room.

===Will I need a car?===

Many attendees never leave the hotel. However if you are planning to explore St. Louis, a car is recommended as public transportation options are slim. Lyft and Uber are both operational in St. Louis and are ideal for single trips. For any excursions listed in the schedule, carpool options may be available. A shuttle may be available to and from your hotel for airport travel, but don't forget to bring cash for a tip!

===Is SimuCon family friendly?===

In general, yes. Some attendees do bring children but activities in the convention room may be of limited interest to them. Note the [[#Attractions|Attractions]] section listed below for additional kid-friendly activities available in St. Louis. Please expect to encounter explicit language and consumption of alcoholic beverages, which will increase in the late night hours.

===What is the weather typically like?===

Missouri is nicknamed "Misery" for its hot and humid summers. For a current local forecast, click here: https://www.ksdk.com/weather

===Do I need to bring food or beverages?===

Depending on funds available, basic snacks will be provided. You are generally on your own for meals and can purchase food at the grocery or restaurant options listed in the [[#Dining.2FEating|Dining/Eating]] section. SimuCon is strictly BYOB. Alcohol can be purchased in most grocery stores and gas stations in Missouri.

===What should I wear?===

SimuCon is casual attire unless the schedule for a specific event indicates otherwise. Some events may encourage costumes or themed attire.

=== Is there a pool?===

YES, pack your bathing suit! The Sheraton Westport Plaza has an indoor pool, and their sister property the Sheraton Westport Chalet has an outdoor pool. The Chalet's outdoor pool is very close and is a popular day time destination for attendees. All facilities at both hotels are available to any guest staying at either hotel. There is even a poolside bar with snacks and beverages (open Friday through Sunday), and towel service is available. It is recommended that you pack sunscreen ahead of time, because the hotel and nearby shops do not stock any. It is also recommended that you bring pool noodles, because pool noodles are wicked cool.
==Visitor Information==
The convention is typically held in the St. Louis area, home of Simutronic's headquarters. While the host hotel may very, it is usually held at one of the many convention spaces at or near the Westport Plaza. For specific details on the official hotel, please see the below accommodations list. Also below are some nearby shops and other information for visitors. All distances calculated from the host hotel.

===Accommodations===
https://www.marriott.com/event-reservations/reservation-link.mi?id=1741039429417&key=GRP&app=resvlink

{| {{prettytable}} cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 1em; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; "
|- bgcolor="lightblue"
!Name||Distance||Address|| Link
|-
|'''Sheraton Westport Plaza (Official Hotel)'''||onsite||900 Westport Plaza, St. Louis, MO 63146||[https://www.marriott.com/event-reservations/reservation-link.mi?id=1741039429417&key=GRP&app=resvlink Group Discount Booking Link]
|-
|Sheraton Westport Chalet||onsite||191 Westport Plaza, St. Louis, MO 63146||[https://www.marriott.com/en-us/hotels/stlsi-sheraton-westport-chalet-hotel-st-louis/ Booking Link]
|-
|Staybridge Suites||0.3 miles||25 Progress Pkwy, St. Louis, MO 63146||[https://www.ihg.com/staybridge/hotels/us/en/st-louis/stlsb/hoteldetail Booking Link]
|-
|Comfort Inn Suites||0.7 miles||12031 Lackland Rd., Saint Louis, MO, 63146||[https://www.choicehotels.com/missouri/saint-louis/comfort-inn-hotels/mo608/rates?checkInDate=2022-08-03&checkOutDate=2022-08-79 Booking Link]
|-
|Residence Inn St. Louis Westport||0.6 miles|| 11918 Westline Industrial Drive, St. Louis, MO 63146|| [https://www.marriott.com/hotels/travel/stlwr-residence-inn-st-louis-westport/ Booking Link]
|-
|Farfield Inn and Suites St. Louis Westport||0.6 miles||11918 Westline Industrial Drive, St. Louis, MO 63146||[https://www.marriott.com/hotels/travel/stlfw-fairfield-inn-and-suites-st-louis-westport/ Booking Link]
|-
|Courtyard by Marriott St. Louis Westport||0.7 miles||11888 Westline Industrial Drive, St. Louis, MO 63146||[https://www.marriott.com/hotels/travel/stlwp-courtyard-st-louis-westport-plaza/ Booking Link]
|}

===Dining/Eating===
{| {{prettytable}} cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 1em; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; "
|- bgcolor="lightblue"
!Name||Type||Distance||Address||Link
|-
|Drunken Fish||Sushi||onsite||639 West Port Plaza, St. Louis, MO 63146 ||https://www.drunkenfish.com/
|-
|Kobe Japanese Grill||Japanese/Hibachi||onsite||645 West Port Plaza, St. Louis, MO 63146||https://www.kobeofwestport.com/menus/
|-
|Starbucks||Coffee|| onsite||111 West Port Plaza, St. Louis, MO 63146 ||https://www.westportstl.com/tenant/starbucks/
|-
|Trainwreck Saloon||American/Grill||onsite|| 314 West Port Plaza, St. Louis, MO 63146||https://www.trainwrecksaloon.com/westport-home
|-
|Westport Social||Bar/Games/Karaoke||onsite||910 West Port Plaza Dr, St. Louis, MO 63146||https://westportsocial-stl.com/menu/
|-
|360 Westport||Rooftop Bar & Lounge||onsite||111 West Port Plaza, Suite 1200, St. Louis, MO 63146||https://www.360-stl.com/westport/
|-
|Soda Fountain Express||Modern Diner||onsite||147 West Port Plaza Dr, St. Louis, MO 63146||https://sodafountainexpress-stl.com/
|-
|Basso on the Plaza||Italian||onsite||545 West Port Plaza Dr, St. Louis, MO 63146||https://www.basso-stl.com/westport/
|}

===Off-Site Dining===
For attendees who want to explore St. Louis cuisine, local players recommend the following restaurants.

{| {{prettytable}} cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 1em; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; "
|- bgcolor="lightblue"
!Name|| Type||Distance||Address||Link
|-
|St. Louis Bread Company||Cafe & Bakery||0.3 mi||15 Progress Pkwy, Maryland Heights, MO 63043 ||https://www.panerabread.com/en-us/cafe/locations/mo/maryland-heights/15-progress-parkway
|-
|O'Fallon Brewery||Beer/American Food||0.3 mi ||45 Progress Pkwy, Maryland Heights, MO 63043 ||http://www.ofallonbrewery.com/
|-
|Giola's Deli||Sandwiches||0.8 mi||11855 Adie Rd, Maryland Heights, MO 63043||https://www.gioiasdeli.com/

|-
|DD Mau||Vietnamese / Bao||1.3 mi||11982 Dorsett Rd, Maryland Heights, MO 63043||http://www.ddmaustl.com/
|-
|Gobble STOP Smokehouse|| BBQ Poultry||2.8 mi||1227 Castillon Arcade Plaza, Creve Coeur, MO 63141||http://gobblestopsmokehouse.net/
|-
| Nudo House STL||Ramen / Japanese||3.0 mi||11423 Olive Blvd, St. Louis, MO 63141||http://nudohousestl.com/
|-
|Dave & Tony's||Premium Burgers||3.2 mi||12766 Olive Blvd, St. Louis, MO 63146||http://www.daveandtonys.com/
|-
|Taqueria Durango|| Mexican||3.5 mi|| 10238 Page Ave, Overland, MO||https://www.facebook.com/TaqueriaDurangoSaintLouis
|-
| Nick & Elena's Pizzeria||Pizza/Italian||5.4 mi||3007 Woodson Rd, Overland, MO 63114||https://www.facebook.com/NICKnELENAS/
|-
|Sugarfire Smokehouse||BBQ||6.0 mi||9200 Olive Blvd, St. Louis, MO 63132||https://sugarfiresmokehouse.com/locations/mo-olivette/
|-
|Salt + Smoke|| BBQ||9.0 mi||501 S Main St, St. Charles, MO 63301 || https://saltandsmokestl.com/
|-
|BEAST||BBQ||17.1 mi||4156 Manchester Ave, St. Louis, MO 63110||https://beastbbqstl.com/
|-
|Pappy's Smokehouse||BBQ||18.7 mi||3106 Olive St, St. Louis, MO 63103||https://www.pappyssmokehouse.com/
|-
|Bogart's||BBQ||20.8 mi||71627 S 9th St, St. Louis, MO 63104||https://www.bogartssmokehouse.com/
|-
|Broadway Oyster Bar||Cajun||23.7 mi||736 S Broadway, St. Louis, MO 63102||http://www.broadwayoysterbar.com/
|-
| Ted Drewes||Famous local frozen custard||21.6 mi||6726 Chippewa, St. Louis, MO 63109|| http://teddrewes.com/
|-
|Bombay Food Junkies||Vegan Options||5.2 mi||3580 Adie Rd, St Ann, MO 63074||https://www.bombayfoodjunkies.com/
|-
|Hi-Point Drive-In||Burgers||12 mi||1033 McCausland Ave, St. Louis, MO 63117||https://hipointedrivein.com/about/
|-
|Bar Louie||Bar & Grill||8.4 mi||1650 Beale Street Suite 180, St. Charles, MO 63303||https://www.barlouie.com/
|-
|Sauce on the Side||Calzones||9.2 mi||7810 Forsyth Blvd., Clayton, MO 63105||https://sauceontheside.com/
|-
|Blueberry Hill||Landmark restaurant / Americana||9.4 mi||6504 Delmar Blvd, University City, MO 63130||https://blueberryhill.com/
|-
|Fitz's||Local root beer & burgers||9.3 mi||6605 Delmar Blvd, St. Louis, MO 63130||https://fitzsrootbeer.com/
|}

===Shopping/Groceries===
{| {{prettytable}} cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 1em; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; "
|- bgcolor="lightblue"
!Name||Distance||Address||Link
|-
|Target||5.9 mi||12275 St Charles Rock Rd, Bridgeton, MO 63044||[https://www.target.com/sl/bridgeton/12 website]
|-
|Costco||13.3 mi||200 Costco Way, St Peters, MO 63376||[https://www.costco.com/warehouse-locations/st-peters-saint-peters-mo-382.html website]
|-
|Schnucks Dorsett (Grocery Store) ||1.5 mi||2030 Dorsett Rd, Maryland Heights, MO 63043||[https://locations.schnucks.com/mo-maryland-heights-117 website]
|-
|Walgreens ||1.6 mi||12509 Dorsett Rd, Maryland Heights, MO 63043||[https://www.walgreens.com/locator/walgreens-12509+dorsett+rd-maryland+heights-mo-63043/id=9481 website]
|-
|BP Gas Station||0.3 mi||11988 Westline Industrial Dr, St. Louis, MO 63146||
|-
|ALDI||2.6 mi||11745 Olive Blvd, Creve Coeur, MO 63141||[https://www.aldi.us/ website]
|-
|Trader Joe's||[https://goo.gl/maps/3aV8WLBakaB2 2.4 mi]||11505 Olive Blvd, Creve Coeur, MO 63141||[https://locations.traderjoes.com/mo/creve-coeur/694/ website]
|-
|D&J Liquor||[https://goo.gl/maps/a6m73h9w4ynWnWqh8 1.5 mi]||1914 McKelvey Rd, Maryland Heights, MO 63043||
|}

===Attractions===

Most attractions are a 15-30 minute drive from the hotel. For tourism information, click here: https://explorestlouis.com/

{| {{prettytable}} cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 1em; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; "
|- bgcolor="lightblue"
!Name||Description||Address||Link
|-
|The Gateway Arch||Oh look, it's the Arch||200 Washington Ave, St. Louis, MO 63102|| https://www.gatewayarch.com/
|-
|Busch Stadium ||Cardinals Baseball Stadium||700 Clark Ave, St. Louis, MO 63102||https://www.mlb.com/cardinals/ballpark
|-
|Forest Park||Large public park, home to several free attractions ||5595 Grand Dr, St. Louis, MO 63112||https://forestparkmap.org/
|-
|St. Louis Zoo||Free zoo, located inside Forest Park||Government Dr, St. Louis, MO 63110 ||https://www.stlzoo.org/
|-
|St. Louis Aquarium at Union Station||Opened Dec. 2019, the otters and spitting fish are worth the admission, skip the wheel||201 S 18th St, St. Louis, MO 63103||https://www.stlouisaquarium.com/
|-
|St. Louis Art Museum||Free art museum, located inside Forest Park||1 Fine Arts Dr, St. Louis, MO 63110||https://www.slam.org/
|-
|Creve Coeur Lake Park||[https://goo.gl/maps/7s9nUCbcyBM2 3.4 mi] from the hotel. Trails, kayak rentals, Go Ape||13725 Marine Ave, St. Louis, MO 63146||[https://www.stlouisco.com/Parks-and-Recreation/Park-Pages/Creve-Coeur website]
|-
|The Muny||Outdoor theater, located inside Forest Park||1 Theatre Dr, St. Louis, MO 63112||https://muny.org/
|-
|Missouri Botanical Gardens||Outdoor garden ||4344 Shaw Blvd, St. Louis, MO 63110 ||http://www.missouribotanicalgarden.org/
|-
|Anheuser-Busch St. Louis Brewery||Main brewery, offers tours||1200 Lynch St, St. Louis, MO 63118||https://www.budweisertours.com/locations/st-louis-missouri.html
|-
|City Museum||Architectural Anomaly/Interactive Art/Climbing Museum||750 N 16th St, St. Louis, MO 63103|| https://www.citymuseum.org/
|-
|Grants Farm||Free wildlife park with tram tours and free beer||10501 Gravois Rd, St. Louis, MO 63123||https://www.grantsfarm.com/home.html
|-
|The Butterfly House||Indoor butterfly pavilion ||15193 Olive Blvd, Chesterfield, MO 63017|| http://www.missouribotanicalgarden.org/visit/family-of-attractions/butterfly-house.aspx
|-
|Science Center||Kid-friendly interactive museum, includes IMAX and planetarium||5050 Oakland Ave, St. Louis, MO 63110||https://www.slsc.org/
|-
| Magic House ||Kid-friendly interactive museum, includes magic||516 S Kirkwood Rd, St. Louis, MO 63122||https://www.magichouse.org/
|-
|Fox Theatre||Historic theater, offers tours||527 NORTH GRAND BLVD., St. Louis, MO 63103||https://www.fabulousfox.com/visit/tours
|-
|St. Louis Neighborhoods||Shopping/Nightlife/Exploring|| Various||https://explorestlouis.com/things-to-do/neighborhoods/
|-
|Live Music Venues||St. Louis is known for its blues and jazz scene||Various ||https://explorestlouis.com/discover/st-louis-music-lovers/st-louis-live-music-venues/
|-
|Casinos||Gambling||Various||https://www.tripadvisor.com/Attractions-g44881-Activities-c53-Saint_Louis_Missouri.html
|-
|Cahokia Mounds||Ruins of the largest prehistoric civilization north of Mexico, 30 min drive from hotel||30 Ramey Street Collinsville, IL 62234|| https://cahokiamounds.org/
|-
|A Gathering Place||Massages within walking distance of convention center||12140 Lackland Rd, St. Louis, MO 63146 ||https://www.agatheringplace.com/
|}

==Ticketing==

TBA

==See Also==
*[https://discord.gg/ypGH9P4AsB Official Simutronics Discord Server]
*[https://elanthipedia.play.net/SimuCon DragonRealms Simucon Page] (DR's Wiki Page)

[[Category:SimuCon]]

SimuCon

2026-02-04T02:35:44Z

HORIBU1: update redirect

#REDIRECT [[SimuCon 2026]]

Ensorcell (735)

2026-02-01T00:18:53Z

HORIBU1: /* Failures */ more closing tags, stupid visual edits

{{spell |
| name = Ensorcell
| number = 735
| mnemonic = ENSORCELL
| duration = 4 hours real time (temporary)<br>or permanent
| type = Utility
| subtype = Weapon/Armor Enhancement
| skill = None
| components = None
| availability = Weapon, Armor, Shield, Runestaff
| navigation = {{Sorcerer base navigation}}
}}
{{TOC limit|2}}
<span class="mw-customtoggle-material_gear_difficulty_modifiers mw-customtoggle-script_gear_difficulty_modifiers mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">This page has collapsed tables for gear difficulty modifiers.''' Click here to toggle all content.</span>

'''Ensorcell''' allows [[sorcerer]]s to enhance [[weapon]]s, [[Runestaff|runestaves]], [[shield]]s, and [[armor]] by infusing necrotic energy into them. Items may be either temporarily or permanently ensorcelled, with varying benefits depending on the nature of the item and the strength of the ensorcellment. Most weapons, runestaves, shields, and armor are able to accept an ensorcellment (provided they do not resist magic in general), though the difficulty of the skill check increases based on the item's exact properties. One thing of note is that an ensorcelled weapon may also be blessed.

==Temporary Ensorcellment==
*{{boldmono|[[PREP]] 735 {{!}} [[EVOKE]] {item} }}with the item in hand
Temporary ensorcellment allows sorcerers (and sorcerers only) to gain temporary necrotic (life channeling) flares on their weapons and runestaves. There is no skill check or necrotic energy requirement for adding a temporary ensorcellment, though an item's properties may prevent it. The flares from temporary and permanent ensorcelled items are exactly the same (see table below).

According to the official spell description, non-sorcerers may benefit from temporarily ensorcelled gear to perform certain combat and shield maneuvers that require an ensorcelled or anti magic weapon or shield. Temporarily ensorcelling armor has no current benefit to any profession.

Higher level sorcerers can temporarily ensorcell a weapon/runestaff for lower level sorcerers who cannot yet cast the spell.

===Duration===

A temporary ensorcell lasts four real time hours. Should the player log off with an active temporary ensorcell and return more than four hours later, the ensorcell will dispel after the first cast/attack. Temporary ensorcellment can be refreshed without dispelling first.

===Flare Rate===

Magical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 7 attacks. Physical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 5 attacks. This is the same rate as an [[Elemental Blade (411)|ebladed weapon]].

==Permanent Ensorcellment==
{{side box|The items that are difficult/impossible are by design. [Ensorcell] will never be offered as a future merchant service. Not all items are intended to be ensorcelled, especially if they already have a number of high end properties. ~GM Estild August 2017}}
*{{boldmono|PREP 735 {{!}} [[CHANNEL]] {item} }} (must be done twice (until 4/1/2021, at which point you only need to channel once))
Permanent ensorcellment can be put on a weapon, armor, shield, or runestaff with the benefits dependent on the type of item ensorcelled, and can be used by members of any profession. Permanently ensorcelling an item requires necrotic energy, which is gained by absorbing experience.

To permanently ensorcell an item, {{boldmono|PREP 735}} and {{boldmono|CAST}} at the item while holding it. This will give a message saying how difficult it will be to place a permanent ensorcellment on the item as well as the current tier of ensorcellment already on that item. Then {{boldmono|CHANNEL}} 735 at the item within 30 seconds to make the Ensorcell attempt. Enhancive and holy items require the use of a special potion prior to the attempt. See below for a more detailed [[#Process|process]].

An item that has been permanently ensorcelled will have a strange necrotic haze radiating from it when {{boldmono|[[LOOK]]}}ed at. The level of ensorcellment can be detected with a cast of [[Elemental Detection (405)]]. Or a bard can determine the sorcerer and ensorcellment by [[Loresinging]] to the item.

===Tiers===

There are 5 permanent ensorcellment tiers with each tier requiring a separate {{boldmono|[[CHANNEL (verb)|CHANNEL]]}} of 735. Both the [[#Necrotic energy|necrotic energy]] cost and ensorcell benefits increase incrementally with each higher tier. Sorcerers (only) wielding permanently ensorcelled weapons or runestaves also receive a phantom 'bonus' tier (for purposes of calculating the flare strength only). For example, a sorcerer with a Tier 5 weapon or runestaff will have an effective tier 6 flare strength (+30 AS/+18 CS).

===Weapons and Runestaves===

Weapons and runestaves that have been permanently ensorcelled gain permanent necrotic (life channeling) flares which can be used by members of any profession (unlike temporary ensorcellment, which can, for the most part, only be used by sorcerers). The strength of these flares is based on the tier of ensorcellment.

There is no increase in flare frequency with higher tiers as had been previously described in the official spell documentation.

Ensorcelled weapons are infused with necrotic energy that will flare and affect the wielder in one of four ways: [[Attack strength|attack]]/[[Casting strength|casting]] strength increase (+5/+3 per tier, respectively - [[acuity]]), [[health]], [[mana]] (runestaves) or [[stamina]] (weapons), or [[spirit]], based mostly on random chance. However, health flares will have a much higher chance of flaring than the others when the wielder is missing health points. If the runestaff would flare for something that the wielder is already full of (health, mana, stamina, spirit), the runestaff flares for AS/CS instead instead; this is the only way to get the acuity-like flare. Runestaves also gain 2 lower CvA per tier of ensorcellment so long as the wielder's left hand is empty; unlike normal Runestaff defense, this CvA adjustment is NOT applied while holding a magical implement (wand, scroll, trinket).

Ensorcelled weapons will trigger flares when the weapon is swung at or used on (IE: a bow) an enemy while ensorcelled [[runestaff|runestaves]] will flare when attack spells are cast (successful hits required).

{| {{prettytable}}
|-
! bgcolor = lightgrey | Flare
! bgcolor = lightgrey | Message
|- align="center"
| [[Health]]
| You feel healed!
|-
|- align="center"
| [[Mana]]
| You feel empowered!
|-
|- align="center"
| [[Spirit]]
| You feel rejuvenated!
|-
|- align="center"
| [[Stamina]]
| You feel reinvigorated!
|-
|- align="center"
| [[acuity flare|Acuity]] (+AS/CS)
| You feel energized!
|-
|}

====Amount Recovered by Tier====

The below information was provided by GM Naijin on Discord:

{| class="wikitable sortable" {{prettytable}}
! Tier||Stamina returned||Average
|-
| T1
| 6 to 12
| 9
|-
| T2
| 7 to 14
| 10.5
|-
| T3
| 8 to 16
| 12
|-
| T4
| 9 to 18
| 13.5
|-
| T5
| 10 to 20
| 15
|}
It is the same amount for mana and health. Sorcerers' phantom bonus applies as well using the same scaling - a sorcerer with a T5 ensorcelled item will recover 11 to 22 health/mana/stamina.

Flares are predominantly health flares - they make up about 77.5% of all flares. Mana/stamina flares come up about 17.5% of the time, and spirit flares trigger about 5% of the time.

===Shields and Armor===

Shields and armor that are permanently ensorcelled provide the bearer with 2 lower [[CvA]] per tier of ensorcellment. This bonus is permanent and no flare is required to activate. Armor accessories can be permanently ensorcelled for no benefit, similar to their capability to receive an enchant.

===Combat and Shield Maneuvers===

[[Shield Use|Shield]] Maneuvers requiring an ensorcelled shield are [[Spell Block]] and [[Shield Mind]].

[[Combat Maneuvers]] requiring an ensorcelled weapon are [[Spell Cleaving]], [[Spell Thieve]], and [[Spell Parry]]. [[Tainted Bond]] does not require one, but users of ensorcelled weapons receive the benefit of one extra attack before expending the periodic attack boost.

==Success Factors (& Mana Control Benefit)==
:''Numbers provided in this section, except for the material difficulty chart, are player research. A bard may loresing an item to determine a base difficulty value, your skill will be evaluated against the base difficulty value '''plus''' a difficulty penalty modifier.

===Difficulty Penalty Modifier===

*Your current skill will be evaluated against the base difficulty provided by a Bard Loresong '''plus''' the difficulty penalty modifier.
*Ensorcell has a difficulty penalty modifier of -50, meaning a sorcerer would need 150 bonus above the item's difficulty for a maximum chance of success.

Primary:
*[[Level]]: +1 per level
*[[Sorcerer Base|Sorcerer Spell Ranks]]: +2 per rank up to level, +1 per rank above level (uncapped)
*[[Wisdom]]: +1 per stat bonus
*[[Intuition]] +1 per stat bonus

Secondary:
*[[Elemental Mana Control]]: +1 per 2 ranks if higher than SMC, otherwise +1 per 4 ranks
*[[Spiritual Mana Control]]: +1 per 2 ranks if higher than EMC, otherwise +1 per 4 ranks
*[[Arcane Symbols]]: +1 per 10 ranks
*[[Magic Item Use]]: +1 per 10 ranks
*[[Magical workshop]]: +20 bonus
*Applicable skill and stat [[enhancive]]s (helps)
*[[Gift of Eonak]] (helps)

===Other:===
*[[Wound]]s (hinders)
*[[Spirit]] (having less then full spirit hinders)
*ebows, silver, [[krodera]], [[coraesine]] and [[veil iron]] cannot be ensorcelled
*Some [[:category: Functional Scripts|item scripts]] can outright reject ensorcell (see above), or add to difficulty.
*Armor resistance does not appear to add to difficulty
*Forged weapons do not seem to be any more difficult than regular weapons when everything else is equal
*Properties of the item (including the item's [[enchantment]], whether it is [[enhancive]], [[Holy_armament|holy]], [[padding|padded]]/[[weighting|weighted]], if it [[flares]], what material it is, etc.)
*{{#section:Fusion|nopry}}

===Gear Difficulty Modifiers===

==== Material Gear Difficulty Modifiers ====

<span class="mw-customtoggle-material_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Material Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-material_gear_difficulty_modifiers">
{{Material_Gear_Difficulty_Modifier}}
</div>

==== Script Gear Difficulty Modifiers ====

<span class="mw-customtoggle-script_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Script Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-script_gear_difficulty_modifiers">
{{Script_Gear_Difficulty_Modifier}}
</div>

==== Other Gear Difficulty Modifiers ====

<span class="mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Other Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-other_gear_difficulty_modifiers">
{{Other_Gear_Difficulty_Modifier}}
</div>

====Ensorcell Formula====

Formula based on player research is located [[Research:Ensorcell (735) Formula|here]].

===Paladin bonded weapons===

[[Holy Weapon (1625)]], the spell that bonds a weapon to a [[Paladin]], can make a weapon extremely difficult to ensorcell since the spell adds [[Holy_armament|holy armament]] and maybe [[flare|flaring]] and enhancive properties to weapons. Depending on the properties of the weapon, the spell might take the weapon from possible to ensorcell to beyond the capabilities of even the most experienced sorcerer. Should the weapon become very difficult or impossible to ensorcell, it is recommended that the Paladin remove the bond from the weapon, especially at higher tiers. Bonded weapons always require the use of an [[inky black potion]] before an ensorcell.

===Failure===

*A failed attempt costs 5% of the amount of necrotic energy that would have been required for a successful attempt
*There is no chance of losing or damaging an item due to a failed attempt
*A sorcerer may make another attempt immediately after a failed attempt, provided they still have the required amount of necrotic energy

==Necrotic Energy==
*{{boldmono|PREP 735 {{!}} CAST }}or{{boldmono| INCANT 735 }}to check a sorcerer's energy level.
Necrotic energy is the fuel source used to permanently ensorcell an item. All sorcerers with knowledge of Ensorcell (735) and able to cast the spell, will acquire energy by killing like-[[level]] creatures. The amount of energy required to successfully ensorcell an item depends on the [[#Tiers|tier]] being attempted.

''Note: In this context a like-level creature is any creature that, when killed, confers [[experience]] on the sorcerer. There is no energy gain with creatures 10 or more levels below the sorcerer's level.''

===Necrotic Energy Limits===

The limit for how much necrotic energy can be gathered per week is capped at 50,000 units. This is equal to the energy needed for a successful Tier 1 ensorcellment. The energy required for Tiers 2 to 5 increases in increments of 25,000 units. The maximum amount of energy a sorcerer can store at any given time is capped at 200,000 units. After gathering this amount, a sorcerer must attempt an ensorcellment to accumulate energy again.

While there is a cap on both weekly and total necrotic energy gained, a sorcerer will only lose necrotic energy if they attempt to permanently ensorcell an item.

===Gaining Necrotic Energy===

A sorcerer will gain a point of necrotic energy per each point of experience they absorb.

===Checking Stored Energy===
Sorcerers may check their level of necrotic energy stored by self-casting ensorcell or simply using the [[SENSE]] verb or the [[RESOURCE]] verb. When a sorcerer has reached his/her maximum for the week, the following message will appear below the accumulated amount:
<pre{{log2}}>Your rapid build up of necrotic energy has left you feeling overwhelmed and temporarily unable to absorb any new necrotic power.</pre>

The weekly cap resets when the first experience is gained after the [[Gift of Lumnis]] has begun.

When a sorcerer is completely full of energy the energy detection will be as follows:

<pre{{log2}}>You sense the build up of necrotic energy within you has reached its limits. You have enough energy to permanently ensorcell an item for the fifth and final time.</pre>

===Energy Cost per Tier===

The table below details the energy requirement for each ensorcellment tier.

{| {{prettytable}}
|-
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Energy Units
|- align="center"
| 1
| 50,000
|-
|- align="center"
| 2
| 75,000
|-
|- align="center"
| 3
| 100,000
|-
|- align="center"
| 4
| 125,000
|-
|- align="center"
| 5
| 150,000
|}

To permanently ensorcell an item from Tier 0 to Tier 5 requires 500,000 energy units and takes a minimum of 10 weeks to gain that amount, barring any failed casts.

==Lore Benefits==

Sorcerers training in [[Sorcerous Lore, Necromancy]] receive additional charges of Ensorcell flares:<ref>Baswab, a non-sorcerer, tested 90 ranks of necromancy in Shattered and it did not work to give him multiple strikes.</ref>

Sorcerers will retain attack flare bonuses for one extra attack at 90 ranks or two extra attacks at 180 ranks.

{| {{prettytable|text-align:center;}}
!align=right|Sorcerous Lore, Necromancy ranks||90||180
|-
|align=right|Total acuity flare attacks (You feel energized!)||2||3
|}

==Process==

The ensorcelling process is very straight forward.

#Gather energy, by gaining experience, until a self-cast of Ensorcell (735) gives you the message that you have '''reached the point necessary to permanently ensorcell an item''' for whichever tier you are casting.
#Do a preliminary 735 channel on the item to check for difficulty. If you (a) get a reading, (b) get the easiest difficulty message of '''you can only fail if you are horribly unlucky''', and (c) are outside of a workshop, skip to the last step.
#If you do not get a reading (the item resists), or if you know the item is enhanced or [[Holy_armament|a holy armament]], you will need to pour an inky black potion on it (not required for difficulty testing). Repeat preliminary channel to get a reading. Potion pours last approximately 30 minutes.
#If the item is at all difficult, wear as many applicable skill and stat [[enhancive]]s that you have available to you.
#Go to a [[magical workshop]] (use the [[sense|SENSE]] verb to check).
#Prep and channel at the item again. You may have to repeat if you did any of steps 3-5 above. (Note: if the item is blessed, then you will receive the message "You sense a strange aura of power from within the <item> that disrupts the power of your spell!" In this case you can cast 119 at the item to remove the bless and try again.)

Sorcerers successfully completing an ensorcell receive [[experience]] and [[fame]].

===Difficulties===

Sorcerers doing an initial channel on an item will get a reading for one of the following levels of difficulty (from easiest to hardest):

''Tables provided by GM Estild''<section begin=difficulty chart />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Needed Description||% Chance
|-
| you can only fail if you are horribly unlucky||~99% (will only fail on a fumble)
|-
| <noinclude>you should be able to ensorcell it </noinclude>easily enough, barring bad luck||90+%
|-
| the odds are on your side<noinclude> to successfully complete the ensorcellment</noinclude>||75+%
|-
| <noinclude>you are </noinclude>more likely than not to succeed<noinclude> on your cast</noinclude>, but<noinclude> you will</noinclude> need some luck||55+%
|-
| <noinclude>this ensorcellment will be </noinclude>difficult, but possible||35+%
|-
| <noinclude>this ensorcellment will be </noinclude>very difficult||15+%
|-
| <noinclude>that this ensorcellment will be </noinclude>nearly impossible||1+%
|-
| you will likely need a miracle<noinclude> to complete this ensorcellment</noinclude>||Need an open roll
|-
| <noinclude>this ensorcellment is </noinclude>completely beyond your abilities||0%
|}<section end=difficulty chart />

<section begin=miracle />When an item '''needs a miracle''', the <noinclude>sorcerer</noinclude><includeonly>wizard</includeonly> must roll a 100 on the attempt, after which another [[d100]] roll is made to add to the first result. The chance of successfully <noinclude>ensorcelling</noinclude><includeonly>enchanting</includeonly> a miracle item is between approximately .01-.99%.<section end=miracle />

===Attempts===

From best to worst, here are the rolls possible on any permanent ensorcell attempt:
<section begin=attempt table />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Result Description||Result
|-
| You make an astoundingly good attempt!||High open roll
|-
| You make an outstanding attempt!||90+
|-
| You make an excellent attempt!||80+
|-
| You make a good attempt!||70+
|-
| You make a decent attempt.||60+
|-
| You make an okay attempt.||50+
|-
| You make a passable attempt.||40+
|-
| You make a questionable attempt.||30+
|-
| You make a poor attempt!||20+
|-
| You make a very poor attempt!||10+
|-
| You make a horribly poor attempt!||1+
|-
| You make an astoundingly inept attempt!||Low open roll
|-
| <noinclude>You make the most horribly incompetent attempt possible!</noinclude><includeonly>Something doesn't seem right...</includeonly>||Fumble
|}<section end=attempt table />

==Ensorcell Pricing==

Because of the weekly time increments, many sorcerers price their ensorcell casts by the week, instead of by the tier, not knowing what tier the next customer might need. Below is a table showing the costs for sorcerers charging 1 million, 2 million, 3 million, and 4 million silvers per week:

{| {{prettytable}}
|-
! bgcolor = lightgrey | Weeks
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Cost: 1m/wk
! bgcolor = lightgrey | Cost: 2m/wk
! bgcolor = lightgrey | Cost: 3m/wk
! bgcolor = lightgrey | Cost: 4m/wk
|- align="center"
| 1
| 1
| 1m
| 2m
| 3m
| 4m
|-
|- align="center"
| 1.5<br>2
| 2<br>3
| 1.5m T2<br>2m T3
| 3m T2<br>4m T3
| 4.5m T2<br>6m T3
| 6m T2<br>8m T3
|-
|- align="center"
| 2.5<br>3
| 4<br>5
| 2.5m T4<br>3m T5
| 5m T4<br>6m T5
| 7.5m T4<br>9m T5
| 10m T4<br>12m T5
|-
|- align="center"
| <small>Total for<br>5 casts<br>(10 weeks)
| 1-5
| 10m
| 20m
| 30m
| 40m
|}

Sorcerers charging around 1 million per week might be just starting out with the spell, working on easier items. Sorcerers charging 2 million per week will be working on mid range items. Sorcerers charging 3 million per week and more might have full enhancive sets and/or use [[Strong Potions of Accelerated Unlearning]] (fixskills), and only work on the most difficult items.

==Messaging==
===Bonuses===
;The flares appear basically similar, besides their respective messages of feeling. For example, an acuity flare:
<pre{{log2}}>
<nowiki> ** Necrotic energy from your <weapon> overflows into you! **</nowiki>
You feel energized!
</pre>
;Acuity is the only flare which also wears off (whether used or unused):
<pre{{log2}}>You feel the unnatural surge of necrotic power wane away.</pre>
;Unused acuity flares will take the hit when dispel magic and hex [[715|curses]] are cast at you (spells without warding rolls):
<pre{{log2}}>
A hooded figure gestures at you!
You feel the unnatural surge of necrotic power wane away.
The elemental aura around you wavers.

An eidolon points a spectral finger at you!
As the tendril of swirling gray magic leaves the eidolon, it is deflected away from you and dissipates harmlessly into the air.
You feel the unnatural surge of necrotic power wane away.

;Unused acuity flares will be applied to the hidden CS roll of [[Pestilence (716)]] reactive flares
</pre>

===Usage===
;Temporary Ensorcell success:
<pre{{log2}}>
>cast at my staff
You gesture at a drakar-runed ebonwood staff.
Necrotic energy materializes around your ebonwood staff and sinks onto it like an ethereal film.
</pre>
;Failure from temporary ensorcellment of permanently ensorcelled item:
<pre{{log2}}>
>cast my leather
You gesture at some vruul skin casting leathers.
Necrotic energy materializes around your casting leathers before being repelled by the stronger necrotic energy already present.
Cast Roundtime 3 Seconds.
</pre>
;Failure from temporary ensorcellment of cursed item:
<pre{{log2}}>
>cast my claidhmore
You gesture at a black steel claidhmore.
Necrotic energy materializes around your black steel claidhmore before being disrupted and fading away.
Cast Roundtime 3 Seconds.
</pre>
;Probable success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
You sense that the rune-carved crosier has not yet been permanently ensorcelled and that you should be able to ensorcell it easily enough, barring bad luck.
</pre>
;Success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
>channel my crosier
You channel at a tiny rune-carved crosier.
Having probed the rune-carved crosier already, you begin to channel your stored necrotic energy at it. You carefully regulate the flow of energy in order to attempt to overcome its natural resistance while not simultaneously overwhelming yourself...

You make an outstanding attempt!

Success! You manage to breach the rune-carved crosier's defenses and pour in enough of your stored necrotic energy to permanently fuse it to the rune-carved crosier's very structure.
</pre>

===Wearing Off===
;Temporary item ensorcellment wearing off.
<pre{{log2}}>The ethereal necrotic film covering your hoarbeam runestaff shrivels away.</pre>

===Failures===
;Failure message for testing a permanent item (7x @ lvl 36):
<pre{{log2}}>
You channel at an ice blue tapered faewood runestaff tipped with a smooth bone wand.
You sense that the tapered faewood runestaff has not yet been permanently ensorcelled and that this ensorcellment will be nearly impossible.
</pre>
;Possible failure for testing (5x @ lvl 37):
<pre{{log2}}>
You sense that the faewood runestaff has not yet been permanently ensorcelled and that you are more likely than not to succeed on your cast, but you will need some luck.
</pre>
;Failure message for permanent item:
<pre{{log2}}>
You make an excellent attempt!
Failure! You are unable to overcome the tapered faewood runestaff's defenses, wasting some of your stored necrotic energy in the fruitless attempt.
</pre>
;Failure message for a holy/enhancive item without first pouring an inky black potion:
<pre{{log2}}>
You channel at a double bit eonake handaxe.
You sense a strange aura of power from within the eonake handaxe that disrupts the power of your spell!
</pre>
;Failure message for a magic resistant item:
<pre{{log2}}>
You channel at a dented veil iron war hammer.
Your veil iron war hammer resists your spell!
</pre>

==[[Alchemy]] [[recipes|Recipes]]==
===Inky Black Potion===
{{:inky black potion}}

===Glimmering Sanguine Potion===
{{#section:Glimmering sanguine potion|intro}}
{{#section:Glimmering sanguine potion|formula}}

==References==
<references />
==Resources==
*[[/saved posts|Saved posts]]
*[[The Courtesan: A Reflection on Necrotic Energy]]
*[http://gsguide.wikia.com/wiki/Ensorcell Dergoatean's Guide]
*[http://forum.gsplayers.com/showthread.php?83562-Ensorcell-data-blame-Goat PC: Ensorcell Data Thread]
*[http://forum.gsplayers.com/showthread.php?80647-I-checked-t1-ensorcell-difficulty-on-a-few-items PC: Item Difficulty Checking Thread]

[[Category:Sorcerer Base Spells]]
[[category:Weapon Enhancements]]
[[Category:Armor Enhancements]]
[[Category:Shield Enhancements]]
[[Category:Profession services]]

Ensorcell (735)

2026-02-01T00:18:07Z

HORIBU1: /* Usage */ another!

{{spell |
| name = Ensorcell
| number = 735
| mnemonic = ENSORCELL
| duration = 4 hours real time (temporary)<br>or permanent
| type = Utility
| subtype = Weapon/Armor Enhancement
| skill = None
| components = None
| availability = Weapon, Armor, Shield, Runestaff
| navigation = {{Sorcerer base navigation}}
}}
{{TOC limit|2}}
<span class="mw-customtoggle-material_gear_difficulty_modifiers mw-customtoggle-script_gear_difficulty_modifiers mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">This page has collapsed tables for gear difficulty modifiers.''' Click here to toggle all content.</span>

'''Ensorcell''' allows [[sorcerer]]s to enhance [[weapon]]s, [[Runestaff|runestaves]], [[shield]]s, and [[armor]] by infusing necrotic energy into them. Items may be either temporarily or permanently ensorcelled, with varying benefits depending on the nature of the item and the strength of the ensorcellment. Most weapons, runestaves, shields, and armor are able to accept an ensorcellment (provided they do not resist magic in general), though the difficulty of the skill check increases based on the item's exact properties. One thing of note is that an ensorcelled weapon may also be blessed.

==Temporary Ensorcellment==
*{{boldmono|[[PREP]] 735 {{!}} [[EVOKE]] {item} }}with the item in hand
Temporary ensorcellment allows sorcerers (and sorcerers only) to gain temporary necrotic (life channeling) flares on their weapons and runestaves. There is no skill check or necrotic energy requirement for adding a temporary ensorcellment, though an item's properties may prevent it. The flares from temporary and permanent ensorcelled items are exactly the same (see table below).

According to the official spell description, non-sorcerers may benefit from temporarily ensorcelled gear to perform certain combat and shield maneuvers that require an ensorcelled or anti magic weapon or shield. Temporarily ensorcelling armor has no current benefit to any profession.

Higher level sorcerers can temporarily ensorcell a weapon/runestaff for lower level sorcerers who cannot yet cast the spell.

===Duration===

A temporary ensorcell lasts four real time hours. Should the player log off with an active temporary ensorcell and return more than four hours later, the ensorcell will dispel after the first cast/attack. Temporary ensorcellment can be refreshed without dispelling first.

===Flare Rate===

Magical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 7 attacks. Physical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 5 attacks. This is the same rate as an [[Elemental Blade (411)|ebladed weapon]].

==Permanent Ensorcellment==
{{side box|The items that are difficult/impossible are by design. [Ensorcell] will never be offered as a future merchant service. Not all items are intended to be ensorcelled, especially if they already have a number of high end properties. ~GM Estild August 2017}}
*{{boldmono|PREP 735 {{!}} [[CHANNEL]] {item} }} (must be done twice (until 4/1/2021, at which point you only need to channel once))
Permanent ensorcellment can be put on a weapon, armor, shield, or runestaff with the benefits dependent on the type of item ensorcelled, and can be used by members of any profession. Permanently ensorcelling an item requires necrotic energy, which is gained by absorbing experience.

To permanently ensorcell an item, {{boldmono|PREP 735}} and {{boldmono|CAST}} at the item while holding it. This will give a message saying how difficult it will be to place a permanent ensorcellment on the item as well as the current tier of ensorcellment already on that item. Then {{boldmono|CHANNEL}} 735 at the item within 30 seconds to make the Ensorcell attempt. Enhancive and holy items require the use of a special potion prior to the attempt. See below for a more detailed [[#Process|process]].

An item that has been permanently ensorcelled will have a strange necrotic haze radiating from it when {{boldmono|[[LOOK]]}}ed at. The level of ensorcellment can be detected with a cast of [[Elemental Detection (405)]]. Or a bard can determine the sorcerer and ensorcellment by [[Loresinging]] to the item.

===Tiers===

There are 5 permanent ensorcellment tiers with each tier requiring a separate {{boldmono|[[CHANNEL (verb)|CHANNEL]]}} of 735. Both the [[#Necrotic energy|necrotic energy]] cost and ensorcell benefits increase incrementally with each higher tier. Sorcerers (only) wielding permanently ensorcelled weapons or runestaves also receive a phantom 'bonus' tier (for purposes of calculating the flare strength only). For example, a sorcerer with a Tier 5 weapon or runestaff will have an effective tier 6 flare strength (+30 AS/+18 CS).

===Weapons and Runestaves===

Weapons and runestaves that have been permanently ensorcelled gain permanent necrotic (life channeling) flares which can be used by members of any profession (unlike temporary ensorcellment, which can, for the most part, only be used by sorcerers). The strength of these flares is based on the tier of ensorcellment.

There is no increase in flare frequency with higher tiers as had been previously described in the official spell documentation.

Ensorcelled weapons are infused with necrotic energy that will flare and affect the wielder in one of four ways: [[Attack strength|attack]]/[[Casting strength|casting]] strength increase (+5/+3 per tier, respectively - [[acuity]]), [[health]], [[mana]] (runestaves) or [[stamina]] (weapons), or [[spirit]], based mostly on random chance. However, health flares will have a much higher chance of flaring than the others when the wielder is missing health points. If the runestaff would flare for something that the wielder is already full of (health, mana, stamina, spirit), the runestaff flares for AS/CS instead instead; this is the only way to get the acuity-like flare. Runestaves also gain 2 lower CvA per tier of ensorcellment so long as the wielder's left hand is empty; unlike normal Runestaff defense, this CvA adjustment is NOT applied while holding a magical implement (wand, scroll, trinket).

Ensorcelled weapons will trigger flares when the weapon is swung at or used on (IE: a bow) an enemy while ensorcelled [[runestaff|runestaves]] will flare when attack spells are cast (successful hits required).

{| {{prettytable}}
|-
! bgcolor = lightgrey | Flare
! bgcolor = lightgrey | Message
|- align="center"
| [[Health]]
| You feel healed!
|-
|- align="center"
| [[Mana]]
| You feel empowered!
|-
|- align="center"
| [[Spirit]]
| You feel rejuvenated!
|-
|- align="center"
| [[Stamina]]
| You feel reinvigorated!
|-
|- align="center"
| [[acuity flare|Acuity]] (+AS/CS)
| You feel energized!
|-
|}

====Amount Recovered by Tier====

The below information was provided by GM Naijin on Discord:

{| class="wikitable sortable" {{prettytable}}
! Tier||Stamina returned||Average
|-
| T1
| 6 to 12
| 9
|-
| T2
| 7 to 14
| 10.5
|-
| T3
| 8 to 16
| 12
|-
| T4
| 9 to 18
| 13.5
|-
| T5
| 10 to 20
| 15
|}
It is the same amount for mana and health. Sorcerers' phantom bonus applies as well using the same scaling - a sorcerer with a T5 ensorcelled item will recover 11 to 22 health/mana/stamina.

Flares are predominantly health flares - they make up about 77.5% of all flares. Mana/stamina flares come up about 17.5% of the time, and spirit flares trigger about 5% of the time.

===Shields and Armor===

Shields and armor that are permanently ensorcelled provide the bearer with 2 lower [[CvA]] per tier of ensorcellment. This bonus is permanent and no flare is required to activate. Armor accessories can be permanently ensorcelled for no benefit, similar to their capability to receive an enchant.

===Combat and Shield Maneuvers===

[[Shield Use|Shield]] Maneuvers requiring an ensorcelled shield are [[Spell Block]] and [[Shield Mind]].

[[Combat Maneuvers]] requiring an ensorcelled weapon are [[Spell Cleaving]], [[Spell Thieve]], and [[Spell Parry]]. [[Tainted Bond]] does not require one, but users of ensorcelled weapons receive the benefit of one extra attack before expending the periodic attack boost.

==Success Factors (& Mana Control Benefit)==
:''Numbers provided in this section, except for the material difficulty chart, are player research. A bard may loresing an item to determine a base difficulty value, your skill will be evaluated against the base difficulty value '''plus''' a difficulty penalty modifier.

===Difficulty Penalty Modifier===

*Your current skill will be evaluated against the base difficulty provided by a Bard Loresong '''plus''' the difficulty penalty modifier.
*Ensorcell has a difficulty penalty modifier of -50, meaning a sorcerer would need 150 bonus above the item's difficulty for a maximum chance of success.

Primary:
*[[Level]]: +1 per level
*[[Sorcerer Base|Sorcerer Spell Ranks]]: +2 per rank up to level, +1 per rank above level (uncapped)
*[[Wisdom]]: +1 per stat bonus
*[[Intuition]] +1 per stat bonus

Secondary:
*[[Elemental Mana Control]]: +1 per 2 ranks if higher than SMC, otherwise +1 per 4 ranks
*[[Spiritual Mana Control]]: +1 per 2 ranks if higher than EMC, otherwise +1 per 4 ranks
*[[Arcane Symbols]]: +1 per 10 ranks
*[[Magic Item Use]]: +1 per 10 ranks
*[[Magical workshop]]: +20 bonus
*Applicable skill and stat [[enhancive]]s (helps)
*[[Gift of Eonak]] (helps)

===Other:===
*[[Wound]]s (hinders)
*[[Spirit]] (having less then full spirit hinders)
*ebows, silver, [[krodera]], [[coraesine]] and [[veil iron]] cannot be ensorcelled
*Some [[:category: Functional Scripts|item scripts]] can outright reject ensorcell (see above), or add to difficulty.
*Armor resistance does not appear to add to difficulty
*Forged weapons do not seem to be any more difficult than regular weapons when everything else is equal
*Properties of the item (including the item's [[enchantment]], whether it is [[enhancive]], [[Holy_armament|holy]], [[padding|padded]]/[[weighting|weighted]], if it [[flares]], what material it is, etc.)
*{{#section:Fusion|nopry}}

===Gear Difficulty Modifiers===

==== Material Gear Difficulty Modifiers ====

<span class="mw-customtoggle-material_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Material Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-material_gear_difficulty_modifiers">
{{Material_Gear_Difficulty_Modifier}}
</div>

==== Script Gear Difficulty Modifiers ====

<span class="mw-customtoggle-script_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Script Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-script_gear_difficulty_modifiers">
{{Script_Gear_Difficulty_Modifier}}
</div>

==== Other Gear Difficulty Modifiers ====

<span class="mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Other Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-other_gear_difficulty_modifiers">
{{Other_Gear_Difficulty_Modifier}}
</div>

====Ensorcell Formula====

Formula based on player research is located [[Research:Ensorcell (735) Formula|here]].

===Paladin bonded weapons===

[[Holy Weapon (1625)]], the spell that bonds a weapon to a [[Paladin]], can make a weapon extremely difficult to ensorcell since the spell adds [[Holy_armament|holy armament]] and maybe [[flare|flaring]] and enhancive properties to weapons. Depending on the properties of the weapon, the spell might take the weapon from possible to ensorcell to beyond the capabilities of even the most experienced sorcerer. Should the weapon become very difficult or impossible to ensorcell, it is recommended that the Paladin remove the bond from the weapon, especially at higher tiers. Bonded weapons always require the use of an [[inky black potion]] before an ensorcell.

===Failure===

*A failed attempt costs 5% of the amount of necrotic energy that would have been required for a successful attempt
*There is no chance of losing or damaging an item due to a failed attempt
*A sorcerer may make another attempt immediately after a failed attempt, provided they still have the required amount of necrotic energy

==Necrotic Energy==
*{{boldmono|PREP 735 {{!}} CAST }}or{{boldmono| INCANT 735 }}to check a sorcerer's energy level.
Necrotic energy is the fuel source used to permanently ensorcell an item. All sorcerers with knowledge of Ensorcell (735) and able to cast the spell, will acquire energy by killing like-[[level]] creatures. The amount of energy required to successfully ensorcell an item depends on the [[#Tiers|tier]] being attempted.

''Note: In this context a like-level creature is any creature that, when killed, confers [[experience]] on the sorcerer. There is no energy gain with creatures 10 or more levels below the sorcerer's level.''

===Necrotic Energy Limits===

The limit for how much necrotic energy can be gathered per week is capped at 50,000 units. This is equal to the energy needed for a successful Tier 1 ensorcellment. The energy required for Tiers 2 to 5 increases in increments of 25,000 units. The maximum amount of energy a sorcerer can store at any given time is capped at 200,000 units. After gathering this amount, a sorcerer must attempt an ensorcellment to accumulate energy again.

While there is a cap on both weekly and total necrotic energy gained, a sorcerer will only lose necrotic energy if they attempt to permanently ensorcell an item.

===Gaining Necrotic Energy===

A sorcerer will gain a point of necrotic energy per each point of experience they absorb.

===Checking Stored Energy===
Sorcerers may check their level of necrotic energy stored by self-casting ensorcell or simply using the [[SENSE]] verb or the [[RESOURCE]] verb. When a sorcerer has reached his/her maximum for the week, the following message will appear below the accumulated amount:
<pre{{log2}}>Your rapid build up of necrotic energy has left you feeling overwhelmed and temporarily unable to absorb any new necrotic power.</pre>

The weekly cap resets when the first experience is gained after the [[Gift of Lumnis]] has begun.

When a sorcerer is completely full of energy the energy detection will be as follows:

<pre{{log2}}>You sense the build up of necrotic energy within you has reached its limits. You have enough energy to permanently ensorcell an item for the fifth and final time.</pre>

===Energy Cost per Tier===

The table below details the energy requirement for each ensorcellment tier.

{| {{prettytable}}
|-
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Energy Units
|- align="center"
| 1
| 50,000
|-
|- align="center"
| 2
| 75,000
|-
|- align="center"
| 3
| 100,000
|-
|- align="center"
| 4
| 125,000
|-
|- align="center"
| 5
| 150,000
|}

To permanently ensorcell an item from Tier 0 to Tier 5 requires 500,000 energy units and takes a minimum of 10 weeks to gain that amount, barring any failed casts.

==Lore Benefits==

Sorcerers training in [[Sorcerous Lore, Necromancy]] receive additional charges of Ensorcell flares:<ref>Baswab, a non-sorcerer, tested 90 ranks of necromancy in Shattered and it did not work to give him multiple strikes.</ref>

Sorcerers will retain attack flare bonuses for one extra attack at 90 ranks or two extra attacks at 180 ranks.

{| {{prettytable|text-align:center;}}
!align=right|Sorcerous Lore, Necromancy ranks||90||180
|-
|align=right|Total acuity flare attacks (You feel energized!)||2||3
|}

==Process==

The ensorcelling process is very straight forward.

#Gather energy, by gaining experience, until a self-cast of Ensorcell (735) gives you the message that you have '''reached the point necessary to permanently ensorcell an item''' for whichever tier you are casting.
#Do a preliminary 735 channel on the item to check for difficulty. If you (a) get a reading, (b) get the easiest difficulty message of '''you can only fail if you are horribly unlucky''', and (c) are outside of a workshop, skip to the last step.
#If you do not get a reading (the item resists), or if you know the item is enhanced or [[Holy_armament|a holy armament]], you will need to pour an inky black potion on it (not required for difficulty testing). Repeat preliminary channel to get a reading. Potion pours last approximately 30 minutes.
#If the item is at all difficult, wear as many applicable skill and stat [[enhancive]]s that you have available to you.
#Go to a [[magical workshop]] (use the [[sense|SENSE]] verb to check).
#Prep and channel at the item again. You may have to repeat if you did any of steps 3-5 above. (Note: if the item is blessed, then you will receive the message "You sense a strange aura of power from within the <item> that disrupts the power of your spell!" In this case you can cast 119 at the item to remove the bless and try again.)

Sorcerers successfully completing an ensorcell receive [[experience]] and [[fame]].

===Difficulties===

Sorcerers doing an initial channel on an item will get a reading for one of the following levels of difficulty (from easiest to hardest):

''Tables provided by GM Estild''<section begin=difficulty chart />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Needed Description||% Chance
|-
| you can only fail if you are horribly unlucky||~99% (will only fail on a fumble)
|-
| <noinclude>you should be able to ensorcell it </noinclude>easily enough, barring bad luck||90+%
|-
| the odds are on your side<noinclude> to successfully complete the ensorcellment</noinclude>||75+%
|-
| <noinclude>you are </noinclude>more likely than not to succeed<noinclude> on your cast</noinclude>, but<noinclude> you will</noinclude> need some luck||55+%
|-
| <noinclude>this ensorcellment will be </noinclude>difficult, but possible||35+%
|-
| <noinclude>this ensorcellment will be </noinclude>very difficult||15+%
|-
| <noinclude>that this ensorcellment will be </noinclude>nearly impossible||1+%
|-
| you will likely need a miracle<noinclude> to complete this ensorcellment</noinclude>||Need an open roll
|-
| <noinclude>this ensorcellment is </noinclude>completely beyond your abilities||0%
|}<section end=difficulty chart />

<section begin=miracle />When an item '''needs a miracle''', the <noinclude>sorcerer</noinclude><includeonly>wizard</includeonly> must roll a 100 on the attempt, after which another [[d100]] roll is made to add to the first result. The chance of successfully <noinclude>ensorcelling</noinclude><includeonly>enchanting</includeonly> a miracle item is between approximately .01-.99%.<section end=miracle />

===Attempts===

From best to worst, here are the rolls possible on any permanent ensorcell attempt:
<section begin=attempt table />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Result Description||Result
|-
| You make an astoundingly good attempt!||High open roll
|-
| You make an outstanding attempt!||90+
|-
| You make an excellent attempt!||80+
|-
| You make a good attempt!||70+
|-
| You make a decent attempt.||60+
|-
| You make an okay attempt.||50+
|-
| You make a passable attempt.||40+
|-
| You make a questionable attempt.||30+
|-
| You make a poor attempt!||20+
|-
| You make a very poor attempt!||10+
|-
| You make a horribly poor attempt!||1+
|-
| You make an astoundingly inept attempt!||Low open roll
|-
| <noinclude>You make the most horribly incompetent attempt possible!</noinclude><includeonly>Something doesn't seem right...</includeonly>||Fumble
|}<section end=attempt table />

==Ensorcell Pricing==

Because of the weekly time increments, many sorcerers price their ensorcell casts by the week, instead of by the tier, not knowing what tier the next customer might need. Below is a table showing the costs for sorcerers charging 1 million, 2 million, 3 million, and 4 million silvers per week:

{| {{prettytable}}
|-
! bgcolor = lightgrey | Weeks
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Cost: 1m/wk
! bgcolor = lightgrey | Cost: 2m/wk
! bgcolor = lightgrey | Cost: 3m/wk
! bgcolor = lightgrey | Cost: 4m/wk
|- align="center"
| 1
| 1
| 1m
| 2m
| 3m
| 4m
|-
|- align="center"
| 1.5<br>2
| 2<br>3
| 1.5m T2<br>2m T3
| 3m T2<br>4m T3
| 4.5m T2<br>6m T3
| 6m T2<br>8m T3
|-
|- align="center"
| 2.5<br>3
| 4<br>5
| 2.5m T4<br>3m T5
| 5m T4<br>6m T5
| 7.5m T4<br>9m T5
| 10m T4<br>12m T5
|-
|- align="center"
| <small>Total for<br>5 casts<br>(10 weeks)
| 1-5
| 10m
| 20m
| 30m
| 40m
|}

Sorcerers charging around 1 million per week might be just starting out with the spell, working on easier items. Sorcerers charging 2 million per week will be working on mid range items. Sorcerers charging 3 million per week and more might have full enhancive sets and/or use [[Strong Potions of Accelerated Unlearning]] (fixskills), and only work on the most difficult items.

==Messaging==
===Bonuses===
;The flares appear basically similar, besides their respective messages of feeling. For example, an acuity flare:
<pre{{log2}}>
<nowiki> ** Necrotic energy from your <weapon> overflows into you! **</nowiki>
You feel energized!
</pre>
;Acuity is the only flare which also wears off (whether used or unused):
<pre{{log2}}>You feel the unnatural surge of necrotic power wane away.</pre>
;Unused acuity flares will take the hit when dispel magic and hex [[715|curses]] are cast at you (spells without warding rolls):
<pre{{log2}}>
A hooded figure gestures at you!
You feel the unnatural surge of necrotic power wane away.
The elemental aura around you wavers.

An eidolon points a spectral finger at you!
As the tendril of swirling gray magic leaves the eidolon, it is deflected away from you and dissipates harmlessly into the air.
You feel the unnatural surge of necrotic power wane away.

;Unused acuity flares will be applied to the hidden CS roll of [[Pestilence (716)]] reactive flares
</pre>

===Usage===
;Temporary Ensorcell success:
<pre{{log2}}>
>cast at my staff
You gesture at a drakar-runed ebonwood staff.
Necrotic energy materializes around your ebonwood staff and sinks onto it like an ethereal film.
</pre>
;Failure from temporary ensorcellment of permanently ensorcelled item:
<pre{{log2}}>
>cast my leather
You gesture at some vruul skin casting leathers.
Necrotic energy materializes around your casting leathers before being repelled by the stronger necrotic energy already present.
Cast Roundtime 3 Seconds.
</pre>
;Failure from temporary ensorcellment of cursed item:
<pre{{log2}}>
>cast my claidhmore
You gesture at a black steel claidhmore.
Necrotic energy materializes around your black steel claidhmore before being disrupted and fading away.
Cast Roundtime 3 Seconds.
</pre>
;Probable success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
You sense that the rune-carved crosier has not yet been permanently ensorcelled and that you should be able to ensorcell it easily enough, barring bad luck.
</pre>
;Success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
>channel my crosier
You channel at a tiny rune-carved crosier.
Having probed the rune-carved crosier already, you begin to channel your stored necrotic energy at it. You carefully regulate the flow of energy in order to attempt to overcome its natural resistance while not simultaneously overwhelming yourself...

You make an outstanding attempt!

Success! You manage to breach the rune-carved crosier's defenses and pour in enough of your stored necrotic energy to permanently fuse it to the rune-carved crosier's very structure.
</pre>

===Wearing Off===
;Temporary item ensorcellment wearing off.
<pre{{log2}}>The ethereal necrotic film covering your hoarbeam runestaff shrivels away.</pre>

===Failures===
;Failure message for testing a permanent item (7x @ lvl 36):
<pre{{log2}}>
You channel at an ice blue tapered faewood runestaff tipped with a smooth bone wand.
You sense that the tapered faewood runestaff has not yet been permanently ensorcelled and that this ensorcellment will be nearly impossible.

;Possible failure for testing (5x @ lvl 37):
<pre{{log2}}>
You sense that the faewood runestaff has not yet been permanently ensorcelled and that you are more likely than not to succeed on your cast, but you will need some luck.

;Failure message for permanent item:
<pre{{log2}}>
You make an excellent attempt!
Failure! You are unable to overcome the tapered faewood runestaff's defenses, wasting some of your stored necrotic energy in the fruitless attempt.

;Failure message for a holy/enhancive item without first pouring an inky black potion:
<pre{{log2}}>
You channel at a double bit eonake handaxe.
You sense a strange aura of power from within the eonake handaxe that disrupts the power of your spell!

;Failure message for a magic resistant item:
<pre{{log2}}>
You channel at a dented veil iron war hammer.
Your veil iron war hammer resists your spell!

==[[Alchemy]] [[recipes|Recipes]]==
===Inky Black Potion===
{{:inky black potion}}

===Glimmering Sanguine Potion===
{{#section:Glimmering sanguine potion|intro}}
{{#section:Glimmering sanguine potion|formula}}

==References==
<references />
==Resources==
*[[/saved posts|Saved posts]]
*[[The Courtesan: A Reflection on Necrotic Energy]]
*[http://gsguide.wikia.com/wiki/Ensorcell Dergoatean's Guide]
*[http://forum.gsplayers.com/showthread.php?83562-Ensorcell-data-blame-Goat PC: Ensorcell Data Thread]
*[http://forum.gsplayers.com/showthread.php?80647-I-checked-t1-ensorcell-difficulty-on-a-few-items PC: Item Difficulty Checking Thread]

[[Category:Sorcerer Base Spells]]
[[category:Weapon Enhancements]]
[[Category:Armor Enhancements]]
[[Category:Shield Enhancements]]
[[Category:Profession services]]

Ensorcell (735)

2026-02-01T00:17:20Z

HORIBU1: /* Usage */ add closing pre tag

{{spell |
| name = Ensorcell
| number = 735
| mnemonic = ENSORCELL
| duration = 4 hours real time (temporary)<br>or permanent
| type = Utility
| subtype = Weapon/Armor Enhancement
| skill = None
| components = None
| availability = Weapon, Armor, Shield, Runestaff
| navigation = {{Sorcerer base navigation}}
}}
{{TOC limit|2}}
<span class="mw-customtoggle-material_gear_difficulty_modifiers mw-customtoggle-script_gear_difficulty_modifiers mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">This page has collapsed tables for gear difficulty modifiers.''' Click here to toggle all content.</span>

'''Ensorcell''' allows [[sorcerer]]s to enhance [[weapon]]s, [[Runestaff|runestaves]], [[shield]]s, and [[armor]] by infusing necrotic energy into them. Items may be either temporarily or permanently ensorcelled, with varying benefits depending on the nature of the item and the strength of the ensorcellment. Most weapons, runestaves, shields, and armor are able to accept an ensorcellment (provided they do not resist magic in general), though the difficulty of the skill check increases based on the item's exact properties. One thing of note is that an ensorcelled weapon may also be blessed.

==Temporary Ensorcellment==
*{{boldmono|[[PREP]] 735 {{!}} [[EVOKE]] {item} }}with the item in hand
Temporary ensorcellment allows sorcerers (and sorcerers only) to gain temporary necrotic (life channeling) flares on their weapons and runestaves. There is no skill check or necrotic energy requirement for adding a temporary ensorcellment, though an item's properties may prevent it. The flares from temporary and permanent ensorcelled items are exactly the same (see table below).

According to the official spell description, non-sorcerers may benefit from temporarily ensorcelled gear to perform certain combat and shield maneuvers that require an ensorcelled or anti magic weapon or shield. Temporarily ensorcelling armor has no current benefit to any profession.

Higher level sorcerers can temporarily ensorcell a weapon/runestaff for lower level sorcerers who cannot yet cast the spell.

===Duration===

A temporary ensorcell lasts four real time hours. Should the player log off with an active temporary ensorcell and return more than four hours later, the ensorcell will dispel after the first cast/attack. Temporary ensorcellment can be refreshed without dispelling first.

===Flare Rate===

Magical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 7 attacks. Physical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 5 attacks. This is the same rate as an [[Elemental Blade (411)|ebladed weapon]].

==Permanent Ensorcellment==
{{side box|The items that are difficult/impossible are by design. [Ensorcell] will never be offered as a future merchant service. Not all items are intended to be ensorcelled, especially if they already have a number of high end properties. ~GM Estild August 2017}}
*{{boldmono|PREP 735 {{!}} [[CHANNEL]] {item} }} (must be done twice (until 4/1/2021, at which point you only need to channel once))
Permanent ensorcellment can be put on a weapon, armor, shield, or runestaff with the benefits dependent on the type of item ensorcelled, and can be used by members of any profession. Permanently ensorcelling an item requires necrotic energy, which is gained by absorbing experience.

To permanently ensorcell an item, {{boldmono|PREP 735}} and {{boldmono|CAST}} at the item while holding it. This will give a message saying how difficult it will be to place a permanent ensorcellment on the item as well as the current tier of ensorcellment already on that item. Then {{boldmono|CHANNEL}} 735 at the item within 30 seconds to make the Ensorcell attempt. Enhancive and holy items require the use of a special potion prior to the attempt. See below for a more detailed [[#Process|process]].

An item that has been permanently ensorcelled will have a strange necrotic haze radiating from it when {{boldmono|[[LOOK]]}}ed at. The level of ensorcellment can be detected with a cast of [[Elemental Detection (405)]]. Or a bard can determine the sorcerer and ensorcellment by [[Loresinging]] to the item.

===Tiers===

There are 5 permanent ensorcellment tiers with each tier requiring a separate {{boldmono|[[CHANNEL (verb)|CHANNEL]]}} of 735. Both the [[#Necrotic energy|necrotic energy]] cost and ensorcell benefits increase incrementally with each higher tier. Sorcerers (only) wielding permanently ensorcelled weapons or runestaves also receive a phantom 'bonus' tier (for purposes of calculating the flare strength only). For example, a sorcerer with a Tier 5 weapon or runestaff will have an effective tier 6 flare strength (+30 AS/+18 CS).

===Weapons and Runestaves===

Weapons and runestaves that have been permanently ensorcelled gain permanent necrotic (life channeling) flares which can be used by members of any profession (unlike temporary ensorcellment, which can, for the most part, only be used by sorcerers). The strength of these flares is based on the tier of ensorcellment.

There is no increase in flare frequency with higher tiers as had been previously described in the official spell documentation.

Ensorcelled weapons are infused with necrotic energy that will flare and affect the wielder in one of four ways: [[Attack strength|attack]]/[[Casting strength|casting]] strength increase (+5/+3 per tier, respectively - [[acuity]]), [[health]], [[mana]] (runestaves) or [[stamina]] (weapons), or [[spirit]], based mostly on random chance. However, health flares will have a much higher chance of flaring than the others when the wielder is missing health points. If the runestaff would flare for something that the wielder is already full of (health, mana, stamina, spirit), the runestaff flares for AS/CS instead instead; this is the only way to get the acuity-like flare. Runestaves also gain 2 lower CvA per tier of ensorcellment so long as the wielder's left hand is empty; unlike normal Runestaff defense, this CvA adjustment is NOT applied while holding a magical implement (wand, scroll, trinket).

Ensorcelled weapons will trigger flares when the weapon is swung at or used on (IE: a bow) an enemy while ensorcelled [[runestaff|runestaves]] will flare when attack spells are cast (successful hits required).

{| {{prettytable}}
|-
! bgcolor = lightgrey | Flare
! bgcolor = lightgrey | Message
|- align="center"
| [[Health]]
| You feel healed!
|-
|- align="center"
| [[Mana]]
| You feel empowered!
|-
|- align="center"
| [[Spirit]]
| You feel rejuvenated!
|-
|- align="center"
| [[Stamina]]
| You feel reinvigorated!
|-
|- align="center"
| [[acuity flare|Acuity]] (+AS/CS)
| You feel energized!
|-
|}

====Amount Recovered by Tier====

The below information was provided by GM Naijin on Discord:

{| class="wikitable sortable" {{prettytable}}
! Tier||Stamina returned||Average
|-
| T1
| 6 to 12
| 9
|-
| T2
| 7 to 14
| 10.5
|-
| T3
| 8 to 16
| 12
|-
| T4
| 9 to 18
| 13.5
|-
| T5
| 10 to 20
| 15
|}
It is the same amount for mana and health. Sorcerers' phantom bonus applies as well using the same scaling - a sorcerer with a T5 ensorcelled item will recover 11 to 22 health/mana/stamina.

Flares are predominantly health flares - they make up about 77.5% of all flares. Mana/stamina flares come up about 17.5% of the time, and spirit flares trigger about 5% of the time.

===Shields and Armor===

Shields and armor that are permanently ensorcelled provide the bearer with 2 lower [[CvA]] per tier of ensorcellment. This bonus is permanent and no flare is required to activate. Armor accessories can be permanently ensorcelled for no benefit, similar to their capability to receive an enchant.

===Combat and Shield Maneuvers===

[[Shield Use|Shield]] Maneuvers requiring an ensorcelled shield are [[Spell Block]] and [[Shield Mind]].

[[Combat Maneuvers]] requiring an ensorcelled weapon are [[Spell Cleaving]], [[Spell Thieve]], and [[Spell Parry]]. [[Tainted Bond]] does not require one, but users of ensorcelled weapons receive the benefit of one extra attack before expending the periodic attack boost.

==Success Factors (& Mana Control Benefit)==
:''Numbers provided in this section, except for the material difficulty chart, are player research. A bard may loresing an item to determine a base difficulty value, your skill will be evaluated against the base difficulty value '''plus''' a difficulty penalty modifier.

===Difficulty Penalty Modifier===

*Your current skill will be evaluated against the base difficulty provided by a Bard Loresong '''plus''' the difficulty penalty modifier.
*Ensorcell has a difficulty penalty modifier of -50, meaning a sorcerer would need 150 bonus above the item's difficulty for a maximum chance of success.

Primary:
*[[Level]]: +1 per level
*[[Sorcerer Base|Sorcerer Spell Ranks]]: +2 per rank up to level, +1 per rank above level (uncapped)
*[[Wisdom]]: +1 per stat bonus
*[[Intuition]] +1 per stat bonus

Secondary:
*[[Elemental Mana Control]]: +1 per 2 ranks if higher than SMC, otherwise +1 per 4 ranks
*[[Spiritual Mana Control]]: +1 per 2 ranks if higher than EMC, otherwise +1 per 4 ranks
*[[Arcane Symbols]]: +1 per 10 ranks
*[[Magic Item Use]]: +1 per 10 ranks
*[[Magical workshop]]: +20 bonus
*Applicable skill and stat [[enhancive]]s (helps)
*[[Gift of Eonak]] (helps)

===Other:===
*[[Wound]]s (hinders)
*[[Spirit]] (having less then full spirit hinders)
*ebows, silver, [[krodera]], [[coraesine]] and [[veil iron]] cannot be ensorcelled
*Some [[:category: Functional Scripts|item scripts]] can outright reject ensorcell (see above), or add to difficulty.
*Armor resistance does not appear to add to difficulty
*Forged weapons do not seem to be any more difficult than regular weapons when everything else is equal
*Properties of the item (including the item's [[enchantment]], whether it is [[enhancive]], [[Holy_armament|holy]], [[padding|padded]]/[[weighting|weighted]], if it [[flares]], what material it is, etc.)
*{{#section:Fusion|nopry}}

===Gear Difficulty Modifiers===

==== Material Gear Difficulty Modifiers ====

<span class="mw-customtoggle-material_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Material Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-material_gear_difficulty_modifiers">
{{Material_Gear_Difficulty_Modifier}}
</div>

==== Script Gear Difficulty Modifiers ====

<span class="mw-customtoggle-script_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Script Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-script_gear_difficulty_modifiers">
{{Script_Gear_Difficulty_Modifier}}
</div>

==== Other Gear Difficulty Modifiers ====

<span class="mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Other Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-other_gear_difficulty_modifiers">
{{Other_Gear_Difficulty_Modifier}}
</div>

====Ensorcell Formula====

Formula based on player research is located [[Research:Ensorcell (735) Formula|here]].

===Paladin bonded weapons===

[[Holy Weapon (1625)]], the spell that bonds a weapon to a [[Paladin]], can make a weapon extremely difficult to ensorcell since the spell adds [[Holy_armament|holy armament]] and maybe [[flare|flaring]] and enhancive properties to weapons. Depending on the properties of the weapon, the spell might take the weapon from possible to ensorcell to beyond the capabilities of even the most experienced sorcerer. Should the weapon become very difficult or impossible to ensorcell, it is recommended that the Paladin remove the bond from the weapon, especially at higher tiers. Bonded weapons always require the use of an [[inky black potion]] before an ensorcell.

===Failure===

*A failed attempt costs 5% of the amount of necrotic energy that would have been required for a successful attempt
*There is no chance of losing or damaging an item due to a failed attempt
*A sorcerer may make another attempt immediately after a failed attempt, provided they still have the required amount of necrotic energy

==Necrotic Energy==
*{{boldmono|PREP 735 {{!}} CAST }}or{{boldmono| INCANT 735 }}to check a sorcerer's energy level.
Necrotic energy is the fuel source used to permanently ensorcell an item. All sorcerers with knowledge of Ensorcell (735) and able to cast the spell, will acquire energy by killing like-[[level]] creatures. The amount of energy required to successfully ensorcell an item depends on the [[#Tiers|tier]] being attempted.

''Note: In this context a like-level creature is any creature that, when killed, confers [[experience]] on the sorcerer. There is no energy gain with creatures 10 or more levels below the sorcerer's level.''

===Necrotic Energy Limits===

The limit for how much necrotic energy can be gathered per week is capped at 50,000 units. This is equal to the energy needed for a successful Tier 1 ensorcellment. The energy required for Tiers 2 to 5 increases in increments of 25,000 units. The maximum amount of energy a sorcerer can store at any given time is capped at 200,000 units. After gathering this amount, a sorcerer must attempt an ensorcellment to accumulate energy again.

While there is a cap on both weekly and total necrotic energy gained, a sorcerer will only lose necrotic energy if they attempt to permanently ensorcell an item.

===Gaining Necrotic Energy===

A sorcerer will gain a point of necrotic energy per each point of experience they absorb.

===Checking Stored Energy===
Sorcerers may check their level of necrotic energy stored by self-casting ensorcell or simply using the [[SENSE]] verb or the [[RESOURCE]] verb. When a sorcerer has reached his/her maximum for the week, the following message will appear below the accumulated amount:
<pre{{log2}}>Your rapid build up of necrotic energy has left you feeling overwhelmed and temporarily unable to absorb any new necrotic power.</pre>

The weekly cap resets when the first experience is gained after the [[Gift of Lumnis]] has begun.

When a sorcerer is completely full of energy the energy detection will be as follows:

<pre{{log2}}>You sense the build up of necrotic energy within you has reached its limits. You have enough energy to permanently ensorcell an item for the fifth and final time.</pre>

===Energy Cost per Tier===

The table below details the energy requirement for each ensorcellment tier.

{| {{prettytable}}
|-
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Energy Units
|- align="center"
| 1
| 50,000
|-
|- align="center"
| 2
| 75,000
|-
|- align="center"
| 3
| 100,000
|-
|- align="center"
| 4
| 125,000
|-
|- align="center"
| 5
| 150,000
|}

To permanently ensorcell an item from Tier 0 to Tier 5 requires 500,000 energy units and takes a minimum of 10 weeks to gain that amount, barring any failed casts.

==Lore Benefits==

Sorcerers training in [[Sorcerous Lore, Necromancy]] receive additional charges of Ensorcell flares:<ref>Baswab, a non-sorcerer, tested 90 ranks of necromancy in Shattered and it did not work to give him multiple strikes.</ref>

Sorcerers will retain attack flare bonuses for one extra attack at 90 ranks or two extra attacks at 180 ranks.

{| {{prettytable|text-align:center;}}
!align=right|Sorcerous Lore, Necromancy ranks||90||180
|-
|align=right|Total acuity flare attacks (You feel energized!)||2||3
|}

==Process==

The ensorcelling process is very straight forward.

#Gather energy, by gaining experience, until a self-cast of Ensorcell (735) gives you the message that you have '''reached the point necessary to permanently ensorcell an item''' for whichever tier you are casting.
#Do a preliminary 735 channel on the item to check for difficulty. If you (a) get a reading, (b) get the easiest difficulty message of '''you can only fail if you are horribly unlucky''', and (c) are outside of a workshop, skip to the last step.
#If you do not get a reading (the item resists), or if you know the item is enhanced or [[Holy_armament|a holy armament]], you will need to pour an inky black potion on it (not required for difficulty testing). Repeat preliminary channel to get a reading. Potion pours last approximately 30 minutes.
#If the item is at all difficult, wear as many applicable skill and stat [[enhancive]]s that you have available to you.
#Go to a [[magical workshop]] (use the [[sense|SENSE]] verb to check).
#Prep and channel at the item again. You may have to repeat if you did any of steps 3-5 above. (Note: if the item is blessed, then you will receive the message "You sense a strange aura of power from within the <item> that disrupts the power of your spell!" In this case you can cast 119 at the item to remove the bless and try again.)

Sorcerers successfully completing an ensorcell receive [[experience]] and [[fame]].

===Difficulties===

Sorcerers doing an initial channel on an item will get a reading for one of the following levels of difficulty (from easiest to hardest):

''Tables provided by GM Estild''<section begin=difficulty chart />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Needed Description||% Chance
|-
| you can only fail if you are horribly unlucky||~99% (will only fail on a fumble)
|-
| <noinclude>you should be able to ensorcell it </noinclude>easily enough, barring bad luck||90+%
|-
| the odds are on your side<noinclude> to successfully complete the ensorcellment</noinclude>||75+%
|-
| <noinclude>you are </noinclude>more likely than not to succeed<noinclude> on your cast</noinclude>, but<noinclude> you will</noinclude> need some luck||55+%
|-
| <noinclude>this ensorcellment will be </noinclude>difficult, but possible||35+%
|-
| <noinclude>this ensorcellment will be </noinclude>very difficult||15+%
|-
| <noinclude>that this ensorcellment will be </noinclude>nearly impossible||1+%
|-
| you will likely need a miracle<noinclude> to complete this ensorcellment</noinclude>||Need an open roll
|-
| <noinclude>this ensorcellment is </noinclude>completely beyond your abilities||0%
|}<section end=difficulty chart />

<section begin=miracle />When an item '''needs a miracle''', the <noinclude>sorcerer</noinclude><includeonly>wizard</includeonly> must roll a 100 on the attempt, after which another [[d100]] roll is made to add to the first result. The chance of successfully <noinclude>ensorcelling</noinclude><includeonly>enchanting</includeonly> a miracle item is between approximately .01-.99%.<section end=miracle />

===Attempts===

From best to worst, here are the rolls possible on any permanent ensorcell attempt:
<section begin=attempt table />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Result Description||Result
|-
| You make an astoundingly good attempt!||High open roll
|-
| You make an outstanding attempt!||90+
|-
| You make an excellent attempt!||80+
|-
| You make a good attempt!||70+
|-
| You make a decent attempt.||60+
|-
| You make an okay attempt.||50+
|-
| You make a passable attempt.||40+
|-
| You make a questionable attempt.||30+
|-
| You make a poor attempt!||20+
|-
| You make a very poor attempt!||10+
|-
| You make a horribly poor attempt!||1+
|-
| You make an astoundingly inept attempt!||Low open roll
|-
| <noinclude>You make the most horribly incompetent attempt possible!</noinclude><includeonly>Something doesn't seem right...</includeonly>||Fumble
|}<section end=attempt table />

==Ensorcell Pricing==

Because of the weekly time increments, many sorcerers price their ensorcell casts by the week, instead of by the tier, not knowing what tier the next customer might need. Below is a table showing the costs for sorcerers charging 1 million, 2 million, 3 million, and 4 million silvers per week:

{| {{prettytable}}
|-
! bgcolor = lightgrey | Weeks
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Cost: 1m/wk
! bgcolor = lightgrey | Cost: 2m/wk
! bgcolor = lightgrey | Cost: 3m/wk
! bgcolor = lightgrey | Cost: 4m/wk
|- align="center"
| 1
| 1
| 1m
| 2m
| 3m
| 4m
|-
|- align="center"
| 1.5<br>2
| 2<br>3
| 1.5m T2<br>2m T3
| 3m T2<br>4m T3
| 4.5m T2<br>6m T3
| 6m T2<br>8m T3
|-
|- align="center"
| 2.5<br>3
| 4<br>5
| 2.5m T4<br>3m T5
| 5m T4<br>6m T5
| 7.5m T4<br>9m T5
| 10m T4<br>12m T5
|-
|- align="center"
| <small>Total for<br>5 casts<br>(10 weeks)
| 1-5
| 10m
| 20m
| 30m
| 40m
|}

Sorcerers charging around 1 million per week might be just starting out with the spell, working on easier items. Sorcerers charging 2 million per week will be working on mid range items. Sorcerers charging 3 million per week and more might have full enhancive sets and/or use [[Strong Potions of Accelerated Unlearning]] (fixskills), and only work on the most difficult items.

==Messaging==
===Bonuses===
;The flares appear basically similar, besides their respective messages of feeling. For example, an acuity flare:
<pre{{log2}}>
<nowiki> ** Necrotic energy from your <weapon> overflows into you! **</nowiki>
You feel energized!
</pre>
;Acuity is the only flare which also wears off (whether used or unused):
<pre{{log2}}>You feel the unnatural surge of necrotic power wane away.</pre>
;Unused acuity flares will take the hit when dispel magic and hex [[715|curses]] are cast at you (spells without warding rolls):
<pre{{log2}}>
A hooded figure gestures at you!
You feel the unnatural surge of necrotic power wane away.
The elemental aura around you wavers.

An eidolon points a spectral finger at you!
As the tendril of swirling gray magic leaves the eidolon, it is deflected away from you and dissipates harmlessly into the air.
You feel the unnatural surge of necrotic power wane away.

;Unused acuity flares will be applied to the hidden CS roll of [[Pestilence (716)]] reactive flares
</pre>

===Usage===
;Temporary Ensorcell success:
<pre{{log2}}>
>cast at my staff
You gesture at a drakar-runed ebonwood staff.
Necrotic energy materializes around your ebonwood staff and sinks onto it like an ethereal film.
</pre>
;Failure from temporary ensorcellment of permanently ensorcelled item:
<pre{{log2}}>
>cast my leather
You gesture at some vruul skin casting leathers.
Necrotic energy materializes around your casting leathers before being repelled by the stronger necrotic energy already present.
Cast Roundtime 3 Seconds.
</pre>
;Failure from temporary ensorcellment of cursed item:
<pre{{log2}}>
>cast my claidhmore
You gesture at a black steel claidhmore.
Necrotic energy materializes around your black steel claidhmore before being disrupted and fading away.
Cast Roundtime 3 Seconds.
</pre>
;Probable success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
You sense that the rune-carved crosier has not yet been permanently ensorcelled and that you should be able to ensorcell it easily enough, barring bad luck.
</pre>
;Success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
>channel my crosier
You channel at a tiny rune-carved crosier.
Having probed the rune-carved crosier already, you begin to channel your stored necrotic energy at it. You carefully regulate the flow of energy in order to attempt to overcome its natural resistance while not simultaneously overwhelming yourself...

You make an outstanding attempt!

Success! You manage to breach the rune-carved crosier's defenses and pour in enough of your stored necrotic energy to permanently fuse it to the rune-carved crosier's very structure.

===Wearing Off===
;Temporary item ensorcellment wearing off.
<pre{{log2}}>The ethereal necrotic film covering your hoarbeam runestaff shrivels away.</pre>

===Failures===
;Failure message for testing a permanent item (7x @ lvl 36):
<pre{{log2}}>
You channel at an ice blue tapered faewood runestaff tipped with a smooth bone wand.
You sense that the tapered faewood runestaff has not yet been permanently ensorcelled and that this ensorcellment will be nearly impossible.

;Possible failure for testing (5x @ lvl 37):
<pre{{log2}}>
You sense that the faewood runestaff has not yet been permanently ensorcelled and that you are more likely than not to succeed on your cast, but you will need some luck.

;Failure message for permanent item:
<pre{{log2}}>
You make an excellent attempt!
Failure! You are unable to overcome the tapered faewood runestaff's defenses, wasting some of your stored necrotic energy in the fruitless attempt.

;Failure message for a holy/enhancive item without first pouring an inky black potion:
<pre{{log2}}>
You channel at a double bit eonake handaxe.
You sense a strange aura of power from within the eonake handaxe that disrupts the power of your spell!

;Failure message for a magic resistant item:
<pre{{log2}}>
You channel at a dented veil iron war hammer.
Your veil iron war hammer resists your spell!

==[[Alchemy]] [[recipes|Recipes]]==
===Inky Black Potion===
{{:inky black potion}}

===Glimmering Sanguine Potion===
{{#section:Glimmering sanguine potion|intro}}
{{#section:Glimmering sanguine potion|formula}}

==References==
<references />
==Resources==
*[[/saved posts|Saved posts]]
*[[The Courtesan: A Reflection on Necrotic Energy]]
*[http://gsguide.wikia.com/wiki/Ensorcell Dergoatean's Guide]
*[http://forum.gsplayers.com/showthread.php?83562-Ensorcell-data-blame-Goat PC: Ensorcell Data Thread]
*[http://forum.gsplayers.com/showthread.php?80647-I-checked-t1-ensorcell-difficulty-on-a-few-items PC: Item Difficulty Checking Thread]

[[Category:Sorcerer Base Spells]]
[[category:Weapon Enhancements]]
[[Category:Armor Enhancements]]
[[Category:Shield Enhancements]]
[[Category:Profession services]]

Ensorcell (735)

2026-02-01T00:16:27Z

HORIBU1: /* Bonuses */ add closing pre tag

{{spell |
| name = Ensorcell
| number = 735
| mnemonic = ENSORCELL
| duration = 4 hours real time (temporary)<br>or permanent
| type = Utility
| subtype = Weapon/Armor Enhancement
| skill = None
| components = None
| availability = Weapon, Armor, Shield, Runestaff
| navigation = {{Sorcerer base navigation}}
}}
{{TOC limit|2}}
<span class="mw-customtoggle-material_gear_difficulty_modifiers mw-customtoggle-script_gear_difficulty_modifiers mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">This page has collapsed tables for gear difficulty modifiers.''' Click here to toggle all content.</span>

'''Ensorcell''' allows [[sorcerer]]s to enhance [[weapon]]s, [[Runestaff|runestaves]], [[shield]]s, and [[armor]] by infusing necrotic energy into them. Items may be either temporarily or permanently ensorcelled, with varying benefits depending on the nature of the item and the strength of the ensorcellment. Most weapons, runestaves, shields, and armor are able to accept an ensorcellment (provided they do not resist magic in general), though the difficulty of the skill check increases based on the item's exact properties. One thing of note is that an ensorcelled weapon may also be blessed.

==Temporary Ensorcellment==
*{{boldmono|[[PREP]] 735 {{!}} [[EVOKE]] {item} }}with the item in hand
Temporary ensorcellment allows sorcerers (and sorcerers only) to gain temporary necrotic (life channeling) flares on their weapons and runestaves. There is no skill check or necrotic energy requirement for adding a temporary ensorcellment, though an item's properties may prevent it. The flares from temporary and permanent ensorcelled items are exactly the same (see table below).

According to the official spell description, non-sorcerers may benefit from temporarily ensorcelled gear to perform certain combat and shield maneuvers that require an ensorcelled or anti magic weapon or shield. Temporarily ensorcelling armor has no current benefit to any profession.

Higher level sorcerers can temporarily ensorcell a weapon/runestaff for lower level sorcerers who cannot yet cast the spell.

===Duration===

A temporary ensorcell lasts four real time hours. Should the player log off with an active temporary ensorcell and return more than four hours later, the ensorcell will dispel after the first cast/attack. Temporary ensorcellment can be refreshed without dispelling first.

===Flare Rate===

Magical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 7 attacks. Physical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 5 attacks. This is the same rate as an [[Elemental Blade (411)|ebladed weapon]].

==Permanent Ensorcellment==
{{side box|The items that are difficult/impossible are by design. [Ensorcell] will never be offered as a future merchant service. Not all items are intended to be ensorcelled, especially if they already have a number of high end properties. ~GM Estild August 2017}}
*{{boldmono|PREP 735 {{!}} [[CHANNEL]] {item} }} (must be done twice (until 4/1/2021, at which point you only need to channel once))
Permanent ensorcellment can be put on a weapon, armor, shield, or runestaff with the benefits dependent on the type of item ensorcelled, and can be used by members of any profession. Permanently ensorcelling an item requires necrotic energy, which is gained by absorbing experience.

To permanently ensorcell an item, {{boldmono|PREP 735}} and {{boldmono|CAST}} at the item while holding it. This will give a message saying how difficult it will be to place a permanent ensorcellment on the item as well as the current tier of ensorcellment already on that item. Then {{boldmono|CHANNEL}} 735 at the item within 30 seconds to make the Ensorcell attempt. Enhancive and holy items require the use of a special potion prior to the attempt. See below for a more detailed [[#Process|process]].

An item that has been permanently ensorcelled will have a strange necrotic haze radiating from it when {{boldmono|[[LOOK]]}}ed at. The level of ensorcellment can be detected with a cast of [[Elemental Detection (405)]]. Or a bard can determine the sorcerer and ensorcellment by [[Loresinging]] to the item.

===Tiers===

There are 5 permanent ensorcellment tiers with each tier requiring a separate {{boldmono|[[CHANNEL (verb)|CHANNEL]]}} of 735. Both the [[#Necrotic energy|necrotic energy]] cost and ensorcell benefits increase incrementally with each higher tier. Sorcerers (only) wielding permanently ensorcelled weapons or runestaves also receive a phantom 'bonus' tier (for purposes of calculating the flare strength only). For example, a sorcerer with a Tier 5 weapon or runestaff will have an effective tier 6 flare strength (+30 AS/+18 CS).

===Weapons and Runestaves===

Weapons and runestaves that have been permanently ensorcelled gain permanent necrotic (life channeling) flares which can be used by members of any profession (unlike temporary ensorcellment, which can, for the most part, only be used by sorcerers). The strength of these flares is based on the tier of ensorcellment.

There is no increase in flare frequency with higher tiers as had been previously described in the official spell documentation.

Ensorcelled weapons are infused with necrotic energy that will flare and affect the wielder in one of four ways: [[Attack strength|attack]]/[[Casting strength|casting]] strength increase (+5/+3 per tier, respectively - [[acuity]]), [[health]], [[mana]] (runestaves) or [[stamina]] (weapons), or [[spirit]], based mostly on random chance. However, health flares will have a much higher chance of flaring than the others when the wielder is missing health points. If the runestaff would flare for something that the wielder is already full of (health, mana, stamina, spirit), the runestaff flares for AS/CS instead instead; this is the only way to get the acuity-like flare. Runestaves also gain 2 lower CvA per tier of ensorcellment so long as the wielder's left hand is empty; unlike normal Runestaff defense, this CvA adjustment is NOT applied while holding a magical implement (wand, scroll, trinket).

Ensorcelled weapons will trigger flares when the weapon is swung at or used on (IE: a bow) an enemy while ensorcelled [[runestaff|runestaves]] will flare when attack spells are cast (successful hits required).

{| {{prettytable}}
|-
! bgcolor = lightgrey | Flare
! bgcolor = lightgrey | Message
|- align="center"
| [[Health]]
| You feel healed!
|-
|- align="center"
| [[Mana]]
| You feel empowered!
|-
|- align="center"
| [[Spirit]]
| You feel rejuvenated!
|-
|- align="center"
| [[Stamina]]
| You feel reinvigorated!
|-
|- align="center"
| [[acuity flare|Acuity]] (+AS/CS)
| You feel energized!
|-
|}

====Amount Recovered by Tier====

The below information was provided by GM Naijin on Discord:

{| class="wikitable sortable" {{prettytable}}
! Tier||Stamina returned||Average
|-
| T1
| 6 to 12
| 9
|-
| T2
| 7 to 14
| 10.5
|-
| T3
| 8 to 16
| 12
|-
| T4
| 9 to 18
| 13.5
|-
| T5
| 10 to 20
| 15
|}
It is the same amount for mana and health. Sorcerers' phantom bonus applies as well using the same scaling - a sorcerer with a T5 ensorcelled item will recover 11 to 22 health/mana/stamina.

Flares are predominantly health flares - they make up about 77.5% of all flares. Mana/stamina flares come up about 17.5% of the time, and spirit flares trigger about 5% of the time.

===Shields and Armor===

Shields and armor that are permanently ensorcelled provide the bearer with 2 lower [[CvA]] per tier of ensorcellment. This bonus is permanent and no flare is required to activate. Armor accessories can be permanently ensorcelled for no benefit, similar to their capability to receive an enchant.

===Combat and Shield Maneuvers===

[[Shield Use|Shield]] Maneuvers requiring an ensorcelled shield are [[Spell Block]] and [[Shield Mind]].

[[Combat Maneuvers]] requiring an ensorcelled weapon are [[Spell Cleaving]], [[Spell Thieve]], and [[Spell Parry]]. [[Tainted Bond]] does not require one, but users of ensorcelled weapons receive the benefit of one extra attack before expending the periodic attack boost.

==Success Factors (& Mana Control Benefit)==
:''Numbers provided in this section, except for the material difficulty chart, are player research. A bard may loresing an item to determine a base difficulty value, your skill will be evaluated against the base difficulty value '''plus''' a difficulty penalty modifier.

===Difficulty Penalty Modifier===

*Your current skill will be evaluated against the base difficulty provided by a Bard Loresong '''plus''' the difficulty penalty modifier.
*Ensorcell has a difficulty penalty modifier of -50, meaning a sorcerer would need 150 bonus above the item's difficulty for a maximum chance of success.

Primary:
*[[Level]]: +1 per level
*[[Sorcerer Base|Sorcerer Spell Ranks]]: +2 per rank up to level, +1 per rank above level (uncapped)
*[[Wisdom]]: +1 per stat bonus
*[[Intuition]] +1 per stat bonus

Secondary:
*[[Elemental Mana Control]]: +1 per 2 ranks if higher than SMC, otherwise +1 per 4 ranks
*[[Spiritual Mana Control]]: +1 per 2 ranks if higher than EMC, otherwise +1 per 4 ranks
*[[Arcane Symbols]]: +1 per 10 ranks
*[[Magic Item Use]]: +1 per 10 ranks
*[[Magical workshop]]: +20 bonus
*Applicable skill and stat [[enhancive]]s (helps)
*[[Gift of Eonak]] (helps)

===Other:===
*[[Wound]]s (hinders)
*[[Spirit]] (having less then full spirit hinders)
*ebows, silver, [[krodera]], [[coraesine]] and [[veil iron]] cannot be ensorcelled
*Some [[:category: Functional Scripts|item scripts]] can outright reject ensorcell (see above), or add to difficulty.
*Armor resistance does not appear to add to difficulty
*Forged weapons do not seem to be any more difficult than regular weapons when everything else is equal
*Properties of the item (including the item's [[enchantment]], whether it is [[enhancive]], [[Holy_armament|holy]], [[padding|padded]]/[[weighting|weighted]], if it [[flares]], what material it is, etc.)
*{{#section:Fusion|nopry}}

===Gear Difficulty Modifiers===

==== Material Gear Difficulty Modifiers ====

<span class="mw-customtoggle-material_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Material Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-material_gear_difficulty_modifiers">
{{Material_Gear_Difficulty_Modifier}}
</div>

==== Script Gear Difficulty Modifiers ====

<span class="mw-customtoggle-script_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Script Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-script_gear_difficulty_modifiers">
{{Script_Gear_Difficulty_Modifier}}
</div>

==== Other Gear Difficulty Modifiers ====

<span class="mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Other Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-other_gear_difficulty_modifiers">
{{Other_Gear_Difficulty_Modifier}}
</div>

====Ensorcell Formula====

Formula based on player research is located [[Research:Ensorcell (735) Formula|here]].

===Paladin bonded weapons===

[[Holy Weapon (1625)]], the spell that bonds a weapon to a [[Paladin]], can make a weapon extremely difficult to ensorcell since the spell adds [[Holy_armament|holy armament]] and maybe [[flare|flaring]] and enhancive properties to weapons. Depending on the properties of the weapon, the spell might take the weapon from possible to ensorcell to beyond the capabilities of even the most experienced sorcerer. Should the weapon become very difficult or impossible to ensorcell, it is recommended that the Paladin remove the bond from the weapon, especially at higher tiers. Bonded weapons always require the use of an [[inky black potion]] before an ensorcell.

===Failure===

*A failed attempt costs 5% of the amount of necrotic energy that would have been required for a successful attempt
*There is no chance of losing or damaging an item due to a failed attempt
*A sorcerer may make another attempt immediately after a failed attempt, provided they still have the required amount of necrotic energy

==Necrotic Energy==
*{{boldmono|PREP 735 {{!}} CAST }}or{{boldmono| INCANT 735 }}to check a sorcerer's energy level.
Necrotic energy is the fuel source used to permanently ensorcell an item. All sorcerers with knowledge of Ensorcell (735) and able to cast the spell, will acquire energy by killing like-[[level]] creatures. The amount of energy required to successfully ensorcell an item depends on the [[#Tiers|tier]] being attempted.

''Note: In this context a like-level creature is any creature that, when killed, confers [[experience]] on the sorcerer. There is no energy gain with creatures 10 or more levels below the sorcerer's level.''

===Necrotic Energy Limits===

The limit for how much necrotic energy can be gathered per week is capped at 50,000 units. This is equal to the energy needed for a successful Tier 1 ensorcellment. The energy required for Tiers 2 to 5 increases in increments of 25,000 units. The maximum amount of energy a sorcerer can store at any given time is capped at 200,000 units. After gathering this amount, a sorcerer must attempt an ensorcellment to accumulate energy again.

While there is a cap on both weekly and total necrotic energy gained, a sorcerer will only lose necrotic energy if they attempt to permanently ensorcell an item.

===Gaining Necrotic Energy===

A sorcerer will gain a point of necrotic energy per each point of experience they absorb.

===Checking Stored Energy===
Sorcerers may check their level of necrotic energy stored by self-casting ensorcell or simply using the [[SENSE]] verb or the [[RESOURCE]] verb. When a sorcerer has reached his/her maximum for the week, the following message will appear below the accumulated amount:
<pre{{log2}}>Your rapid build up of necrotic energy has left you feeling overwhelmed and temporarily unable to absorb any new necrotic power.</pre>

The weekly cap resets when the first experience is gained after the [[Gift of Lumnis]] has begun.

When a sorcerer is completely full of energy the energy detection will be as follows:

<pre{{log2}}>You sense the build up of necrotic energy within you has reached its limits. You have enough energy to permanently ensorcell an item for the fifth and final time.</pre>

===Energy Cost per Tier===

The table below details the energy requirement for each ensorcellment tier.

{| {{prettytable}}
|-
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Energy Units
|- align="center"
| 1
| 50,000
|-
|- align="center"
| 2
| 75,000
|-
|- align="center"
| 3
| 100,000
|-
|- align="center"
| 4
| 125,000
|-
|- align="center"
| 5
| 150,000
|}

To permanently ensorcell an item from Tier 0 to Tier 5 requires 500,000 energy units and takes a minimum of 10 weeks to gain that amount, barring any failed casts.

==Lore Benefits==

Sorcerers training in [[Sorcerous Lore, Necromancy]] receive additional charges of Ensorcell flares:<ref>Baswab, a non-sorcerer, tested 90 ranks of necromancy in Shattered and it did not work to give him multiple strikes.</ref>

Sorcerers will retain attack flare bonuses for one extra attack at 90 ranks or two extra attacks at 180 ranks.

{| {{prettytable|text-align:center;}}
!align=right|Sorcerous Lore, Necromancy ranks||90||180
|-
|align=right|Total acuity flare attacks (You feel energized!)||2||3
|}

==Process==

The ensorcelling process is very straight forward.

#Gather energy, by gaining experience, until a self-cast of Ensorcell (735) gives you the message that you have '''reached the point necessary to permanently ensorcell an item''' for whichever tier you are casting.
#Do a preliminary 735 channel on the item to check for difficulty. If you (a) get a reading, (b) get the easiest difficulty message of '''you can only fail if you are horribly unlucky''', and (c) are outside of a workshop, skip to the last step.
#If you do not get a reading (the item resists), or if you know the item is enhanced or [[Holy_armament|a holy armament]], you will need to pour an inky black potion on it (not required for difficulty testing). Repeat preliminary channel to get a reading. Potion pours last approximately 30 minutes.
#If the item is at all difficult, wear as many applicable skill and stat [[enhancive]]s that you have available to you.
#Go to a [[magical workshop]] (use the [[sense|SENSE]] verb to check).
#Prep and channel at the item again. You may have to repeat if you did any of steps 3-5 above. (Note: if the item is blessed, then you will receive the message "You sense a strange aura of power from within the <item> that disrupts the power of your spell!" In this case you can cast 119 at the item to remove the bless and try again.)

Sorcerers successfully completing an ensorcell receive [[experience]] and [[fame]].

===Difficulties===

Sorcerers doing an initial channel on an item will get a reading for one of the following levels of difficulty (from easiest to hardest):

''Tables provided by GM Estild''<section begin=difficulty chart />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Needed Description||% Chance
|-
| you can only fail if you are horribly unlucky||~99% (will only fail on a fumble)
|-
| <noinclude>you should be able to ensorcell it </noinclude>easily enough, barring bad luck||90+%
|-
| the odds are on your side<noinclude> to successfully complete the ensorcellment</noinclude>||75+%
|-
| <noinclude>you are </noinclude>more likely than not to succeed<noinclude> on your cast</noinclude>, but<noinclude> you will</noinclude> need some luck||55+%
|-
| <noinclude>this ensorcellment will be </noinclude>difficult, but possible||35+%
|-
| <noinclude>this ensorcellment will be </noinclude>very difficult||15+%
|-
| <noinclude>that this ensorcellment will be </noinclude>nearly impossible||1+%
|-
| you will likely need a miracle<noinclude> to complete this ensorcellment</noinclude>||Need an open roll
|-
| <noinclude>this ensorcellment is </noinclude>completely beyond your abilities||0%
|}<section end=difficulty chart />

<section begin=miracle />When an item '''needs a miracle''', the <noinclude>sorcerer</noinclude><includeonly>wizard</includeonly> must roll a 100 on the attempt, after which another [[d100]] roll is made to add to the first result. The chance of successfully <noinclude>ensorcelling</noinclude><includeonly>enchanting</includeonly> a miracle item is between approximately .01-.99%.<section end=miracle />

===Attempts===

From best to worst, here are the rolls possible on any permanent ensorcell attempt:
<section begin=attempt table />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Result Description||Result
|-
| You make an astoundingly good attempt!||High open roll
|-
| You make an outstanding attempt!||90+
|-
| You make an excellent attempt!||80+
|-
| You make a good attempt!||70+
|-
| You make a decent attempt.||60+
|-
| You make an okay attempt.||50+
|-
| You make a passable attempt.||40+
|-
| You make a questionable attempt.||30+
|-
| You make a poor attempt!||20+
|-
| You make a very poor attempt!||10+
|-
| You make a horribly poor attempt!||1+
|-
| You make an astoundingly inept attempt!||Low open roll
|-
| <noinclude>You make the most horribly incompetent attempt possible!</noinclude><includeonly>Something doesn't seem right...</includeonly>||Fumble
|}<section end=attempt table />

==Ensorcell Pricing==

Because of the weekly time increments, many sorcerers price their ensorcell casts by the week, instead of by the tier, not knowing what tier the next customer might need. Below is a table showing the costs for sorcerers charging 1 million, 2 million, 3 million, and 4 million silvers per week:

{| {{prettytable}}
|-
! bgcolor = lightgrey | Weeks
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Cost: 1m/wk
! bgcolor = lightgrey | Cost: 2m/wk
! bgcolor = lightgrey | Cost: 3m/wk
! bgcolor = lightgrey | Cost: 4m/wk
|- align="center"
| 1
| 1
| 1m
| 2m
| 3m
| 4m
|-
|- align="center"
| 1.5<br>2
| 2<br>3
| 1.5m T2<br>2m T3
| 3m T2<br>4m T3
| 4.5m T2<br>6m T3
| 6m T2<br>8m T3
|-
|- align="center"
| 2.5<br>3
| 4<br>5
| 2.5m T4<br>3m T5
| 5m T4<br>6m T5
| 7.5m T4<br>9m T5
| 10m T4<br>12m T5
|-
|- align="center"
| <small>Total for<br>5 casts<br>(10 weeks)
| 1-5
| 10m
| 20m
| 30m
| 40m
|}

Sorcerers charging around 1 million per week might be just starting out with the spell, working on easier items. Sorcerers charging 2 million per week will be working on mid range items. Sorcerers charging 3 million per week and more might have full enhancive sets and/or use [[Strong Potions of Accelerated Unlearning]] (fixskills), and only work on the most difficult items.

==Messaging==
===Bonuses===
;The flares appear basically similar, besides their respective messages of feeling. For example, an acuity flare:
<pre{{log2}}>
<nowiki> ** Necrotic energy from your <weapon> overflows into you! **</nowiki>
You feel energized!
</pre>
;Acuity is the only flare which also wears off (whether used or unused):
<pre{{log2}}>You feel the unnatural surge of necrotic power wane away.</pre>
;Unused acuity flares will take the hit when dispel magic and hex [[715|curses]] are cast at you (spells without warding rolls):
<pre{{log2}}>
A hooded figure gestures at you!
You feel the unnatural surge of necrotic power wane away.
The elemental aura around you wavers.

An eidolon points a spectral finger at you!
As the tendril of swirling gray magic leaves the eidolon, it is deflected away from you and dissipates harmlessly into the air.
You feel the unnatural surge of necrotic power wane away.

;Unused acuity flares will be applied to the hidden CS roll of [[Pestilence (716)]] reactive flares
</pre>

===Usage===
;Temporary Ensorcell success:
<pre{{log2}}>
>cast at my staff
You gesture at a drakar-runed ebonwood staff.
Necrotic energy materializes around your ebonwood staff and sinks onto it like an ethereal film.

;Failure from temporary ensorcellment of permanently ensorcelled item:
<pre{{log2}}>
>cast my leather
You gesture at some vruul skin casting leathers.
Necrotic energy materializes around your casting leathers before being repelled by the stronger necrotic energy already present.
Cast Roundtime 3 Seconds.

;Failure from temporary ensorcellment of cursed item:
<pre{{log2}}>
>cast my claidhmore
You gesture at a black steel claidhmore.
Necrotic energy materializes around your black steel claidhmore before being disrupted and fading away.
Cast Roundtime 3 Seconds.

;Probable success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
You sense that the rune-carved crosier has not yet been permanently ensorcelled and that you should be able to ensorcell it easily enough, barring bad luck.

;Success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
>channel my crosier
You channel at a tiny rune-carved crosier.
Having probed the rune-carved crosier already, you begin to channel your stored necrotic energy at it. You carefully regulate the flow of energy in order to attempt to overcome its natural resistance while not simultaneously overwhelming yourself...

You make an outstanding attempt!

Success! You manage to breach the rune-carved crosier's defenses and pour in enough of your stored necrotic energy to permanently fuse it to the rune-carved crosier's very structure.

===Wearing Off===
;Temporary item ensorcellment wearing off.
<pre{{log2}}>The ethereal necrotic film covering your hoarbeam runestaff shrivels away.</pre>

===Failures===
;Failure message for testing a permanent item (7x @ lvl 36):
<pre{{log2}}>
You channel at an ice blue tapered faewood runestaff tipped with a smooth bone wand.
You sense that the tapered faewood runestaff has not yet been permanently ensorcelled and that this ensorcellment will be nearly impossible.

;Possible failure for testing (5x @ lvl 37):
<pre{{log2}}>
You sense that the faewood runestaff has not yet been permanently ensorcelled and that you are more likely than not to succeed on your cast, but you will need some luck.

;Failure message for permanent item:
<pre{{log2}}>
You make an excellent attempt!
Failure! You are unable to overcome the tapered faewood runestaff's defenses, wasting some of your stored necrotic energy in the fruitless attempt.

;Failure message for a holy/enhancive item without first pouring an inky black potion:
<pre{{log2}}>
You channel at a double bit eonake handaxe.
You sense a strange aura of power from within the eonake handaxe that disrupts the power of your spell!

;Failure message for a magic resistant item:
<pre{{log2}}>
You channel at a dented veil iron war hammer.
Your veil iron war hammer resists your spell!

==[[Alchemy]] [[recipes|Recipes]]==
===Inky Black Potion===
{{:inky black potion}}

===Glimmering Sanguine Potion===
{{#section:Glimmering sanguine potion|intro}}
{{#section:Glimmering sanguine potion|formula}}

==References==
<references />
==Resources==
*[[/saved posts|Saved posts]]
*[[The Courtesan: A Reflection on Necrotic Energy]]
*[http://gsguide.wikia.com/wiki/Ensorcell Dergoatean's Guide]
*[http://forum.gsplayers.com/showthread.php?83562-Ensorcell-data-blame-Goat PC: Ensorcell Data Thread]
*[http://forum.gsplayers.com/showthread.php?80647-I-checked-t1-ensorcell-difficulty-on-a-few-items PC: Item Difficulty Checking Thread]

[[Category:Sorcerer Base Spells]]
[[category:Weapon Enhancements]]
[[Category:Armor Enhancements]]
[[Category:Shield Enhancements]]
[[Category:Profession services]]

Ensorcell (735)

2026-02-01T00:16:05Z

HORIBU1: /* Bonuses */ add closing tag

{{spell |
| name = Ensorcell
| number = 735
| mnemonic = ENSORCELL
| duration = 4 hours real time (temporary)<br>or permanent
| type = Utility
| subtype = Weapon/Armor Enhancement
| skill = None
| components = None
| availability = Weapon, Armor, Shield, Runestaff
| navigation = {{Sorcerer base navigation}}
}}
{{TOC limit|2}}
<span class="mw-customtoggle-material_gear_difficulty_modifiers mw-customtoggle-script_gear_difficulty_modifiers mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">This page has collapsed tables for gear difficulty modifiers.''' Click here to toggle all content.</span>

'''Ensorcell''' allows [[sorcerer]]s to enhance [[weapon]]s, [[Runestaff|runestaves]], [[shield]]s, and [[armor]] by infusing necrotic energy into them. Items may be either temporarily or permanently ensorcelled, with varying benefits depending on the nature of the item and the strength of the ensorcellment. Most weapons, runestaves, shields, and armor are able to accept an ensorcellment (provided they do not resist magic in general), though the difficulty of the skill check increases based on the item's exact properties. One thing of note is that an ensorcelled weapon may also be blessed.

==Temporary Ensorcellment==
*{{boldmono|[[PREP]] 735 {{!}} [[EVOKE]] {item} }}with the item in hand
Temporary ensorcellment allows sorcerers (and sorcerers only) to gain temporary necrotic (life channeling) flares on their weapons and runestaves. There is no skill check or necrotic energy requirement for adding a temporary ensorcellment, though an item's properties may prevent it. The flares from temporary and permanent ensorcelled items are exactly the same (see table below).

According to the official spell description, non-sorcerers may benefit from temporarily ensorcelled gear to perform certain combat and shield maneuvers that require an ensorcelled or anti magic weapon or shield. Temporarily ensorcelling armor has no current benefit to any profession.

Higher level sorcerers can temporarily ensorcell a weapon/runestaff for lower level sorcerers who cannot yet cast the spell.

===Duration===

A temporary ensorcell lasts four real time hours. Should the player log off with an active temporary ensorcell and return more than four hours later, the ensorcell will dispel after the first cast/attack. Temporary ensorcellment can be refreshed without dispelling first.

===Flare Rate===

Magical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 7 attacks. Physical attack flares from temporary ensorcellment occur randomly and have an average rate of 1 flare per 5 attacks. This is the same rate as an [[Elemental Blade (411)|ebladed weapon]].

==Permanent Ensorcellment==
{{side box|The items that are difficult/impossible are by design. [Ensorcell] will never be offered as a future merchant service. Not all items are intended to be ensorcelled, especially if they already have a number of high end properties. ~GM Estild August 2017}}
*{{boldmono|PREP 735 {{!}} [[CHANNEL]] {item} }} (must be done twice (until 4/1/2021, at which point you only need to channel once))
Permanent ensorcellment can be put on a weapon, armor, shield, or runestaff with the benefits dependent on the type of item ensorcelled, and can be used by members of any profession. Permanently ensorcelling an item requires necrotic energy, which is gained by absorbing experience.

To permanently ensorcell an item, {{boldmono|PREP 735}} and {{boldmono|CAST}} at the item while holding it. This will give a message saying how difficult it will be to place a permanent ensorcellment on the item as well as the current tier of ensorcellment already on that item. Then {{boldmono|CHANNEL}} 735 at the item within 30 seconds to make the Ensorcell attempt. Enhancive and holy items require the use of a special potion prior to the attempt. See below for a more detailed [[#Process|process]].

An item that has been permanently ensorcelled will have a strange necrotic haze radiating from it when {{boldmono|[[LOOK]]}}ed at. The level of ensorcellment can be detected with a cast of [[Elemental Detection (405)]]. Or a bard can determine the sorcerer and ensorcellment by [[Loresinging]] to the item.

===Tiers===

There are 5 permanent ensorcellment tiers with each tier requiring a separate {{boldmono|[[CHANNEL (verb)|CHANNEL]]}} of 735. Both the [[#Necrotic energy|necrotic energy]] cost and ensorcell benefits increase incrementally with each higher tier. Sorcerers (only) wielding permanently ensorcelled weapons or runestaves also receive a phantom 'bonus' tier (for purposes of calculating the flare strength only). For example, a sorcerer with a Tier 5 weapon or runestaff will have an effective tier 6 flare strength (+30 AS/+18 CS).

===Weapons and Runestaves===

Weapons and runestaves that have been permanently ensorcelled gain permanent necrotic (life channeling) flares which can be used by members of any profession (unlike temporary ensorcellment, which can, for the most part, only be used by sorcerers). The strength of these flares is based on the tier of ensorcellment.

There is no increase in flare frequency with higher tiers as had been previously described in the official spell documentation.

Ensorcelled weapons are infused with necrotic energy that will flare and affect the wielder in one of four ways: [[Attack strength|attack]]/[[Casting strength|casting]] strength increase (+5/+3 per tier, respectively - [[acuity]]), [[health]], [[mana]] (runestaves) or [[stamina]] (weapons), or [[spirit]], based mostly on random chance. However, health flares will have a much higher chance of flaring than the others when the wielder is missing health points. If the runestaff would flare for something that the wielder is already full of (health, mana, stamina, spirit), the runestaff flares for AS/CS instead instead; this is the only way to get the acuity-like flare. Runestaves also gain 2 lower CvA per tier of ensorcellment so long as the wielder's left hand is empty; unlike normal Runestaff defense, this CvA adjustment is NOT applied while holding a magical implement (wand, scroll, trinket).

Ensorcelled weapons will trigger flares when the weapon is swung at or used on (IE: a bow) an enemy while ensorcelled [[runestaff|runestaves]] will flare when attack spells are cast (successful hits required).

{| {{prettytable}}
|-
! bgcolor = lightgrey | Flare
! bgcolor = lightgrey | Message
|- align="center"
| [[Health]]
| You feel healed!
|-
|- align="center"
| [[Mana]]
| You feel empowered!
|-
|- align="center"
| [[Spirit]]
| You feel rejuvenated!
|-
|- align="center"
| [[Stamina]]
| You feel reinvigorated!
|-
|- align="center"
| [[acuity flare|Acuity]] (+AS/CS)
| You feel energized!
|-
|}

====Amount Recovered by Tier====

The below information was provided by GM Naijin on Discord:

{| class="wikitable sortable" {{prettytable}}
! Tier||Stamina returned||Average
|-
| T1
| 6 to 12
| 9
|-
| T2
| 7 to 14
| 10.5
|-
| T3
| 8 to 16
| 12
|-
| T4
| 9 to 18
| 13.5
|-
| T5
| 10 to 20
| 15
|}
It is the same amount for mana and health. Sorcerers' phantom bonus applies as well using the same scaling - a sorcerer with a T5 ensorcelled item will recover 11 to 22 health/mana/stamina.

Flares are predominantly health flares - they make up about 77.5% of all flares. Mana/stamina flares come up about 17.5% of the time, and spirit flares trigger about 5% of the time.

===Shields and Armor===

Shields and armor that are permanently ensorcelled provide the bearer with 2 lower [[CvA]] per tier of ensorcellment. This bonus is permanent and no flare is required to activate. Armor accessories can be permanently ensorcelled for no benefit, similar to their capability to receive an enchant.

===Combat and Shield Maneuvers===

[[Shield Use|Shield]] Maneuvers requiring an ensorcelled shield are [[Spell Block]] and [[Shield Mind]].

[[Combat Maneuvers]] requiring an ensorcelled weapon are [[Spell Cleaving]], [[Spell Thieve]], and [[Spell Parry]]. [[Tainted Bond]] does not require one, but users of ensorcelled weapons receive the benefit of one extra attack before expending the periodic attack boost.

==Success Factors (& Mana Control Benefit)==
:''Numbers provided in this section, except for the material difficulty chart, are player research. A bard may loresing an item to determine a base difficulty value, your skill will be evaluated against the base difficulty value '''plus''' a difficulty penalty modifier.

===Difficulty Penalty Modifier===

*Your current skill will be evaluated against the base difficulty provided by a Bard Loresong '''plus''' the difficulty penalty modifier.
*Ensorcell has a difficulty penalty modifier of -50, meaning a sorcerer would need 150 bonus above the item's difficulty for a maximum chance of success.

Primary:
*[[Level]]: +1 per level
*[[Sorcerer Base|Sorcerer Spell Ranks]]: +2 per rank up to level, +1 per rank above level (uncapped)
*[[Wisdom]]: +1 per stat bonus
*[[Intuition]] +1 per stat bonus

Secondary:
*[[Elemental Mana Control]]: +1 per 2 ranks if higher than SMC, otherwise +1 per 4 ranks
*[[Spiritual Mana Control]]: +1 per 2 ranks if higher than EMC, otherwise +1 per 4 ranks
*[[Arcane Symbols]]: +1 per 10 ranks
*[[Magic Item Use]]: +1 per 10 ranks
*[[Magical workshop]]: +20 bonus
*Applicable skill and stat [[enhancive]]s (helps)
*[[Gift of Eonak]] (helps)

===Other:===
*[[Wound]]s (hinders)
*[[Spirit]] (having less then full spirit hinders)
*ebows, silver, [[krodera]], [[coraesine]] and [[veil iron]] cannot be ensorcelled
*Some [[:category: Functional Scripts|item scripts]] can outright reject ensorcell (see above), or add to difficulty.
*Armor resistance does not appear to add to difficulty
*Forged weapons do not seem to be any more difficult than regular weapons when everything else is equal
*Properties of the item (including the item's [[enchantment]], whether it is [[enhancive]], [[Holy_armament|holy]], [[padding|padded]]/[[weighting|weighted]], if it [[flares]], what material it is, etc.)
*{{#section:Fusion|nopry}}

===Gear Difficulty Modifiers===

==== Material Gear Difficulty Modifiers ====

<span class="mw-customtoggle-material_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Material Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-material_gear_difficulty_modifiers">
{{Material_Gear_Difficulty_Modifier}}
</div>

==== Script Gear Difficulty Modifiers ====

<span class="mw-customtoggle-script_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Script Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-script_gear_difficulty_modifiers">
{{Script_Gear_Difficulty_Modifier}}
</div>

==== Other Gear Difficulty Modifiers ====

<span class="mw-customtoggle-other_gear_difficulty_modifiers" style="color:#0000ff">Click Here to Expand the Other Gear Difficulty Modifiers Table</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-other_gear_difficulty_modifiers">
{{Other_Gear_Difficulty_Modifier}}
</div>

====Ensorcell Formula====

Formula based on player research is located [[Research:Ensorcell (735) Formula|here]].

===Paladin bonded weapons===

[[Holy Weapon (1625)]], the spell that bonds a weapon to a [[Paladin]], can make a weapon extremely difficult to ensorcell since the spell adds [[Holy_armament|holy armament]] and maybe [[flare|flaring]] and enhancive properties to weapons. Depending on the properties of the weapon, the spell might take the weapon from possible to ensorcell to beyond the capabilities of even the most experienced sorcerer. Should the weapon become very difficult or impossible to ensorcell, it is recommended that the Paladin remove the bond from the weapon, especially at higher tiers. Bonded weapons always require the use of an [[inky black potion]] before an ensorcell.

===Failure===

*A failed attempt costs 5% of the amount of necrotic energy that would have been required for a successful attempt
*There is no chance of losing or damaging an item due to a failed attempt
*A sorcerer may make another attempt immediately after a failed attempt, provided they still have the required amount of necrotic energy

==Necrotic Energy==
*{{boldmono|PREP 735 {{!}} CAST }}or{{boldmono| INCANT 735 }}to check a sorcerer's energy level.
Necrotic energy is the fuel source used to permanently ensorcell an item. All sorcerers with knowledge of Ensorcell (735) and able to cast the spell, will acquire energy by killing like-[[level]] creatures. The amount of energy required to successfully ensorcell an item depends on the [[#Tiers|tier]] being attempted.

''Note: In this context a like-level creature is any creature that, when killed, confers [[experience]] on the sorcerer. There is no energy gain with creatures 10 or more levels below the sorcerer's level.''

===Necrotic Energy Limits===

The limit for how much necrotic energy can be gathered per week is capped at 50,000 units. This is equal to the energy needed for a successful Tier 1 ensorcellment. The energy required for Tiers 2 to 5 increases in increments of 25,000 units. The maximum amount of energy a sorcerer can store at any given time is capped at 200,000 units. After gathering this amount, a sorcerer must attempt an ensorcellment to accumulate energy again.

While there is a cap on both weekly and total necrotic energy gained, a sorcerer will only lose necrotic energy if they attempt to permanently ensorcell an item.

===Gaining Necrotic Energy===

A sorcerer will gain a point of necrotic energy per each point of experience they absorb.

===Checking Stored Energy===
Sorcerers may check their level of necrotic energy stored by self-casting ensorcell or simply using the [[SENSE]] verb or the [[RESOURCE]] verb. When a sorcerer has reached his/her maximum for the week, the following message will appear below the accumulated amount:
<pre{{log2}}>Your rapid build up of necrotic energy has left you feeling overwhelmed and temporarily unable to absorb any new necrotic power.</pre>

The weekly cap resets when the first experience is gained after the [[Gift of Lumnis]] has begun.

When a sorcerer is completely full of energy the energy detection will be as follows:

<pre{{log2}}>You sense the build up of necrotic energy within you has reached its limits. You have enough energy to permanently ensorcell an item for the fifth and final time.</pre>

===Energy Cost per Tier===

The table below details the energy requirement for each ensorcellment tier.

{| {{prettytable}}
|-
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Energy Units
|- align="center"
| 1
| 50,000
|-
|- align="center"
| 2
| 75,000
|-
|- align="center"
| 3
| 100,000
|-
|- align="center"
| 4
| 125,000
|-
|- align="center"
| 5
| 150,000
|}

To permanently ensorcell an item from Tier 0 to Tier 5 requires 500,000 energy units and takes a minimum of 10 weeks to gain that amount, barring any failed casts.

==Lore Benefits==

Sorcerers training in [[Sorcerous Lore, Necromancy]] receive additional charges of Ensorcell flares:<ref>Baswab, a non-sorcerer, tested 90 ranks of necromancy in Shattered and it did not work to give him multiple strikes.</ref>

Sorcerers will retain attack flare bonuses for one extra attack at 90 ranks or two extra attacks at 180 ranks.

{| {{prettytable|text-align:center;}}
!align=right|Sorcerous Lore, Necromancy ranks||90||180
|-
|align=right|Total acuity flare attacks (You feel energized!)||2||3
|}

==Process==

The ensorcelling process is very straight forward.

#Gather energy, by gaining experience, until a self-cast of Ensorcell (735) gives you the message that you have '''reached the point necessary to permanently ensorcell an item''' for whichever tier you are casting.
#Do a preliminary 735 channel on the item to check for difficulty. If you (a) get a reading, (b) get the easiest difficulty message of '''you can only fail if you are horribly unlucky''', and (c) are outside of a workshop, skip to the last step.
#If you do not get a reading (the item resists), or if you know the item is enhanced or [[Holy_armament|a holy armament]], you will need to pour an inky black potion on it (not required for difficulty testing). Repeat preliminary channel to get a reading. Potion pours last approximately 30 minutes.
#If the item is at all difficult, wear as many applicable skill and stat [[enhancive]]s that you have available to you.
#Go to a [[magical workshop]] (use the [[sense|SENSE]] verb to check).
#Prep and channel at the item again. You may have to repeat if you did any of steps 3-5 above. (Note: if the item is blessed, then you will receive the message "You sense a strange aura of power from within the <item> that disrupts the power of your spell!" In this case you can cast 119 at the item to remove the bless and try again.)

Sorcerers successfully completing an ensorcell receive [[experience]] and [[fame]].

===Difficulties===

Sorcerers doing an initial channel on an item will get a reading for one of the following levels of difficulty (from easiest to hardest):

''Tables provided by GM Estild''<section begin=difficulty chart />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Needed Description||% Chance
|-
| you can only fail if you are horribly unlucky||~99% (will only fail on a fumble)
|-
| <noinclude>you should be able to ensorcell it </noinclude>easily enough, barring bad luck||90+%
|-
| the odds are on your side<noinclude> to successfully complete the ensorcellment</noinclude>||75+%
|-
| <noinclude>you are </noinclude>more likely than not to succeed<noinclude> on your cast</noinclude>, but<noinclude> you will</noinclude> need some luck||55+%
|-
| <noinclude>this ensorcellment will be </noinclude>difficult, but possible||35+%
|-
| <noinclude>this ensorcellment will be </noinclude>very difficult||15+%
|-
| <noinclude>that this ensorcellment will be </noinclude>nearly impossible||1+%
|-
| you will likely need a miracle<noinclude> to complete this ensorcellment</noinclude>||Need an open roll
|-
| <noinclude>this ensorcellment is </noinclude>completely beyond your abilities||0%
|}<section end=difficulty chart />

<section begin=miracle />When an item '''needs a miracle''', the <noinclude>sorcerer</noinclude><includeonly>wizard</includeonly> must roll a 100 on the attempt, after which another [[d100]] roll is made to add to the first result. The chance of successfully <noinclude>ensorcelling</noinclude><includeonly>enchanting</includeonly> a miracle item is between approximately .01-.99%.<section end=miracle />

===Attempts===

From best to worst, here are the rolls possible on any permanent ensorcell attempt:
<section begin=attempt table />
{| {{prettytable<includeonly>|1=font-size:95%;</includeonly>}}
|-bgcolor=lightblue
! Roll Result Description||Result
|-
| You make an astoundingly good attempt!||High open roll
|-
| You make an outstanding attempt!||90+
|-
| You make an excellent attempt!||80+
|-
| You make a good attempt!||70+
|-
| You make a decent attempt.||60+
|-
| You make an okay attempt.||50+
|-
| You make a passable attempt.||40+
|-
| You make a questionable attempt.||30+
|-
| You make a poor attempt!||20+
|-
| You make a very poor attempt!||10+
|-
| You make a horribly poor attempt!||1+
|-
| You make an astoundingly inept attempt!||Low open roll
|-
| <noinclude>You make the most horribly incompetent attempt possible!</noinclude><includeonly>Something doesn't seem right...</includeonly>||Fumble
|}<section end=attempt table />

==Ensorcell Pricing==

Because of the weekly time increments, many sorcerers price their ensorcell casts by the week, instead of by the tier, not knowing what tier the next customer might need. Below is a table showing the costs for sorcerers charging 1 million, 2 million, 3 million, and 4 million silvers per week:

{| {{prettytable}}
|-
! bgcolor = lightgrey | Weeks
! bgcolor = lightgrey | Tier
! bgcolor = lightgrey | Cost: 1m/wk
! bgcolor = lightgrey | Cost: 2m/wk
! bgcolor = lightgrey | Cost: 3m/wk
! bgcolor = lightgrey | Cost: 4m/wk
|- align="center"
| 1
| 1
| 1m
| 2m
| 3m
| 4m
|-
|- align="center"
| 1.5<br>2
| 2<br>3
| 1.5m T2<br>2m T3
| 3m T2<br>4m T3
| 4.5m T2<br>6m T3
| 6m T2<br>8m T3
|-
|- align="center"
| 2.5<br>3
| 4<br>5
| 2.5m T4<br>3m T5
| 5m T4<br>6m T5
| 7.5m T4<br>9m T5
| 10m T4<br>12m T5
|-
|- align="center"
| <small>Total for<br>5 casts<br>(10 weeks)
| 1-5
| 10m
| 20m
| 30m
| 40m
|}

Sorcerers charging around 1 million per week might be just starting out with the spell, working on easier items. Sorcerers charging 2 million per week will be working on mid range items. Sorcerers charging 3 million per week and more might have full enhancive sets and/or use [[Strong Potions of Accelerated Unlearning]] (fixskills), and only work on the most difficult items.

==Messaging==
===Bonuses===
;The flares appear basically similar, besides their respective messages of feeling. For example, an acuity flare:
<pre{{log2}}>
<nowiki> ** Necrotic energy from your <weapon> overflows into you! **</nowiki>
You feel energized!
</pre>
;Acuity is the only flare which also wears off (whether used or unused):
<pre{{log2}}>You feel the unnatural surge of necrotic power wane away.</pre>
;Unused acuity flares will take the hit when dispel magic and hex [[715|curses]] are cast at you (spells without warding rolls):
<pre{{log2}}>
A hooded figure gestures at you!
You feel the unnatural surge of necrotic power wane away.
The elemental aura around you wavers.

An eidolon points a spectral finger at you!
As the tendril of swirling gray magic leaves the eidolon, it is deflected away from you and dissipates harmlessly into the air.
You feel the unnatural surge of necrotic power wane away.

;Unused acuity flares will be applied to the hidden CS roll of [[Pestilence (716)]] reactive flares

===Usage===
;Temporary Ensorcell success:
<pre{{log2}}>
>cast at my staff
You gesture at a drakar-runed ebonwood staff.
Necrotic energy materializes around your ebonwood staff and sinks onto it like an ethereal film.

;Failure from temporary ensorcellment of permanently ensorcelled item:
<pre{{log2}}>
>cast my leather
You gesture at some vruul skin casting leathers.
Necrotic energy materializes around your casting leathers before being repelled by the stronger necrotic energy already present.
Cast Roundtime 3 Seconds.

;Failure from temporary ensorcellment of cursed item:
<pre{{log2}}>
>cast my claidhmore
You gesture at a black steel claidhmore.
Necrotic energy materializes around your black steel claidhmore before being disrupted and fading away.
Cast Roundtime 3 Seconds.

;Probable success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
You sense that the rune-carved crosier has not yet been permanently ensorcelled and that you should be able to ensorcell it easily enough, barring bad luck.

;Success for a Tier 1 permanent item (CHANNEL):
<pre{{log2}}>
>channel my crosier
You channel at a tiny rune-carved crosier.
Having probed the rune-carved crosier already, you begin to channel your stored necrotic energy at it. You carefully regulate the flow of energy in order to attempt to overcome its natural resistance while not simultaneously overwhelming yourself...

You make an outstanding attempt!

Success! You manage to breach the rune-carved crosier's defenses and pour in enough of your stored necrotic energy to permanently fuse it to the rune-carved crosier's very structure.

===Wearing Off===
;Temporary item ensorcellment wearing off.
<pre{{log2}}>The ethereal necrotic film covering your hoarbeam runestaff shrivels away.</pre>

===Failures===
;Failure message for testing a permanent item (7x @ lvl 36):
<pre{{log2}}>
You channel at an ice blue tapered faewood runestaff tipped with a smooth bone wand.
You sense that the tapered faewood runestaff has not yet been permanently ensorcelled and that this ensorcellment will be nearly impossible.

;Possible failure for testing (5x @ lvl 37):
<pre{{log2}}>
You sense that the faewood runestaff has not yet been permanently ensorcelled and that you are more likely than not to succeed on your cast, but you will need some luck.

;Failure message for permanent item:
<pre{{log2}}>
You make an excellent attempt!
Failure! You are unable to overcome the tapered faewood runestaff's defenses, wasting some of your stored necrotic energy in the fruitless attempt.

;Failure message for a holy/enhancive item without first pouring an inky black potion:
<pre{{log2}}>
You channel at a double bit eonake handaxe.
You sense a strange aura of power from within the eonake handaxe that disrupts the power of your spell!

;Failure message for a magic resistant item:
<pre{{log2}}>
You channel at a dented veil iron war hammer.
Your veil iron war hammer resists your spell!

==[[Alchemy]] [[recipes|Recipes]]==
===Inky Black Potion===
{{:inky black potion}}

===Glimmering Sanguine Potion===
{{#section:Glimmering sanguine potion|intro}}
{{#section:Glimmering sanguine potion|formula}}

==References==
<references />
==Resources==
*[[/saved posts|Saved posts]]
*[[The Courtesan: A Reflection on Necrotic Energy]]
*[http://gsguide.wikia.com/wiki/Ensorcell Dergoatean's Guide]
*[http://forum.gsplayers.com/showthread.php?83562-Ensorcell-data-blame-Goat PC: Ensorcell Data Thread]
*[http://forum.gsplayers.com/showthread.php?80647-I-checked-t1-ensorcell-difficulty-on-a-few-items PC: Item Difficulty Checking Thread]

[[Category:Sorcerer Base Spells]]
[[category:Weapon Enhancements]]
[[Category:Armor Enhancements]]
[[Category:Shield Enhancements]]
[[Category:Profession services]]

Floating Disk (511)

2026-01-31T21:30:53Z

HORIBU1: added info about locked treasure chests counting as 1/3 item count

{{spell
| mnemonic = FLOATDISK
| type = Utility
| duration = Special
| subtype = Container
| components = None
| skill = None
| availability = All
| navigation = {{Major elemental navigation}}
}}
__TOC__
<section begin=description />'''Floating Disk''' can hold objects for a character and will follow the character as he travels.<section end=description /> It has a base item limit of 8 items (this includes items inside other items) for non-wizards. Players can increase the item limit by training in [[Elemental Lore, Air]]. Disks also have a hard weight limit of 500 pounds that cannot be increased. Disk descriptions can be changed by holding a gem or through [[attunement]], as described below.

Locked treasure chests count as 1/3 (rounded up) for item count storage capacity. Character locked treasure chests do not receive this benefit.

Unlike most spells, floating disk has an indefinite duration. As long as the character remains logged in (and alive) the disk should remain. If a player logs out or is disconnected, the disk will remain around for a few minutes in case the player is able to reconnect. Upon [[death]], or if the player does not reconnect, the disk will vanish and all items will be deposited onto the ground. Any items lost in this manner will not be replaced by staff and players are advised to never place precious items in a disk.

[[AMBUSH (verb)|Ambushers]] sometimes use disks to signal that they are hunting in a stealthy fashion. Thus, if one sees a disk and a creature in the same space, it is quite possible that there is a [[hidden]] ambusher there also. Common courtesy may then suggest that one heeds this.

This spell is commonly found in [[black crystal]]s.

== Usage ==
*{{boldmono|[[INCANT]] 511}} to self-cast a disk.
*{{boldmono|[[PREP]] 511 {{!}} [[CAST]] {player} }}to give someone else a disk or use caster's name as target for a self-cast plain disk.
*{{boldmono|[[PREP]] 511 {{!}} [[CAST]] {gem} }} to self-cast a disk with a specific color. This will consume the gem in the process.

Disks can be {{boldmono|[[OPEN]]}}ed and {{boldmono|[[CLOSE]]}}d. {{boldmono|[[TURN]]}}ing a disk will empty the entire contents onto the ground at once. The spell can be ended via the {{boldmono|[[DISMISS]]}} verb.

== Lore Benefit ==
Training in [[Elemental Lore, Air]] increases a disk's capacity from the base of 8 items by seed 10 [[summation]] of ranks.
<section begin=Air_Lore_Disk_Capacity/>
{| {{prettytable|text-align:center;}}
!align="right"|Elemental Lore, Air ranks||0||10||21||33||46||60||75||91||108||126||145||165||186||208||231
|-
|align="right"|Total disk capacity||8||9||10||11||12||13||14||15||16||17||18||19||20||21||22
|}
<section end=Air_Lore_Disk_Capacity/>

;Note on Air lores impacting disk capacity for non-wizards
<pre{{log2}}>
In the ###### disk:

Containers [11]: an off-white cotton sack (11)
Total items: 11

Elemental Lore - Air...............| 171 71</pre>

== Changing Disk Descriptions ==
Wizards can cast on certain [[gem]]s or items held on their person while casting this spell to affect the description of the disk. The gem will be lost. If no gem or item is used a somewhat random description will be added to the disk, though a wizard's [[attunement]] has some effect on this. If a wizard would like a plain disk (or has a disk customization unlocked) he should cast the spell at himself instead of just casting in an open manner. Non-wizards will always receive a disk with the plain description no matter the method used (wizard cast, black crystal, scroll, etc.)

<small>(<i>Theory: Without using gems, attuned wizards have a propensity to get certain disks. To wit: air=translucent, fire=fiery red, water=icy blue, earth=earth brown, lightning=sparkling. A randomly attuned wizard can get all five.</i>)
<table>
<tr valign="top" align="center"><td>
{| {{prettytable}}
!colspan="2" width="200"|Spinels
|-
| blue spinel ||icy blue or frost white
|-
| pink spinel ||earth brown or granite
|-
| red spinel ||fiery red or scorched
|-
| violet spinel ||sparkling or iridescent
|-
| yellow spinel ||iridescent
|}</td>
<td>
{| {{prettytable}}
!colspan="2" width="125"|Miscellaneous
|-
| aquamarine gem||aquamarine
|-
| banded sardonyx stone||lopsided or slim
|-
| blue lapis lazuli||blue
|-
| deep purple amethyst||deep purple
|-
| deep red carbuncle||red
|-
| golden amber||golden
|-
| mottled agate||mottled
|-
| pale blue moonstone||blue
|-
| piece of green jade||green
|-
| rose quartz||rose
|}</td>
<td>
{| {{prettytable}}
!colspan="2" width="100"|Zircons
|-
| brown||brown
|-
| clear||clear
|-
| green||green
|-
| yellow||yellow
|}</td>
<td>
{| {{prettytable}}
!colspan="2" width="100"|Tourmalines
|-
| black||black
|-
| blue||blue
|-
| clear||clear
|-
| green||green
|-
| pink||pink
|}</td>
<td>
{| {{prettytable}}
!colspan="2" width="100"|Pearls
|-
| tiny black pearl||black
|-
| tiny white pearl||white
|-
| grey pearl||grey
|}</td>
</tr>
<tr valign="top" align="center"><td>
{| {{prettytable}}
!colspan="2" width="150"|Jaspers
|-
| black jasper||cracked or revolving
|-
| red jasper||revolving or spinning
|-
| yellow jasper||spinning or pulsating
|}</td>
<td>
{| {{prettytable}}
!colspan="2" width="100"|Topaz
|-
| blue topaz||blue
|-
| golden topaz||yellow
|-
| pink topaz||pink
|}</td>
<td>
{| {{prettytable}}
!colspan="2" width="100"|Sapphires
|-
| clear||clear
|-
| violet||violet
|-
| yellow||yellow
|}</td>
<td>
{| {{prettytable}}
!colspan="2" width="100"|Diamonds
|-
| uncut diamond||white
|-
| yellow diamond||yellow
|}</td>
<td>
{| {{prettytable}}
!colspan="2" width="75"|Corals
|-
| black||black
|-
| blue||blue
|-
| red||red
|}</td></tr>
</table>
</small>
;Not Used
{| width=100%
|- valign=top
| width = 25% |
<small>
:*amethyst
:*bright chrysoberyl gem
:*carnelian quartz
:*dark red-green bloodstone
:*dragonseye sapphire
:*fire opal
:*fiery jacinth
</small>
| width = 25% |
<small>
:*golden beryl gem
:*green malachite stone
:*green garnet
:*lavender shimmarglin sapphire
:*orange imperial topaz
:*pale water sapphire
</small>
| width = 25% |
<small>
:*periwinkle feystone
:*piece of citrine quartz
:*pink rhodocrosite stone
:*polished jet stone
:*quartz crystal
:*rock crystal
:*shimmertine shard
</small>
| width = 25% |
<small>
:*silvery moonstone
:*smoky glimaerstone
:*spiderweb obsidian
:*spiderweb turquoise
:*star diopside
:*star sapphire
:*turquoise stone
</small>
|}

{| {{prettytable}}
|colspan=16 style="background:#ddd; white-space: nowrap; font-size: larger; text-align: center;height:15px" |
'''Colors Available'''
|-
!style="background:Grey;font-size: 80%"|Whites
!style="background:Grey;font-size: 80%"|Grey
!style="background:Grey;font-size: 80%"|Granite
!style="background:Grey;font-size: 80%"|Black
!style="background:purple;font-size: 80%"|Purple
!style="background:violet;font-size: 80%"|Violet
!style="background:Red;font-size: 80%"|Red
!style="background:#FF1493;font-size: 80%"|Pink
!style="background:#FBCCE7;font-size: 80%"|Rose
!style="background:orange;font-size: 80%"|Orange
!style="background:gold;font-size: 80%"|Golden
!style="background:yellow;font-size: 80%"|Yellow
!style="background:Aquamarine;font-size: 80%"|Aquamarine
!style="background:Green;font-size: 80%"|Green
!style="background:Blue;font-size: 80%"|Blue
!style="background:#6D351A;font-size: 80%"|Browns
|-
|colspan=16 style="background:#ddd; white-space: nowrap; font-size: larger; text-align: center;height:15px" |
'''Other Effects'''
|-
!style="background:Grey;font-size: 80%"|Cracked
!style="background:Grey;font-size: 80%"|Iridescent
!style="background:Grey;font-size: 80%"|Pulsating
!style="background:Grey;font-size: 80%"|Revolving
!style="background:Grey;font-size: 80%"|Scorched
!style="background:Grey;font-size: 80%"|Sparkling
!style="background:Grey;font-size: 80%"|Lopsided
!style="background:Grey;font-size: 80%"|Spinning
!style="background:Grey;font-size: 80%"|Mottled
!style="background:Grey;font-size: 80%"|Slim
!style="background:Grey;font-size: 80%"|Translucent
!style="background:Grey;font-size: 80%"|Clear
!style="background:Grey;"|
!style="background:Grey;"|
!style="background:Grey;"|
!style="background:Grey;"|
|}{{top}}

== Messaging ==
;Initial cast:
<pre{{Log2}}>
A small circular container suddenly appears and floats rather serenely over to you.
</pre>

;Wearing off:
<pre{{Log2}}>
The <color> <person>'s disk disintegrates, dropping everything on the ground.
</pre>
{{AR2}}
{{:black crystal}}
{{top}}

==Resources==
*[[Custom Floating Disk]]
*[[Antique Brass Lantern]]
*[http://www.play.net/gs4/info/spells/spelllist.asp?circle=2#511 Major Elemental Spell Circle: Floating Disk], on Play.net

Lich:Script Bigshot

2026-01-26T17:24:12Z

HORIBU1: /* Command Checks */ add essence and splashy command checks

{{3rd-party}}
Bigshot is designed to handle combat routines, including moving to and from hunting areas, defining creatures to hunt and accompanying attack routines
Afk scripting on any server but Shattered is in violation of game policy.
{{TOCright| limit=2}}
==Changelog==
*[[Script Bigshot/Changelog|Script Bigshot Changelog]]
==About Bigshot==
===What Does Bigshot Do?===

Using a series of menus and commands inputs, Bigshot lets a user create a modular, customizable and fully automated hunting script. With just a few clicks and tweaks, you can go from scripting Rats to the Rift.

===How Do I Get It?===

Grab it from the Repository: ;repository download Bigshot

===How Do I Make it GO!?===
Initial setup is accessed through ;bigshot setup. There you will see a configuration window with various tabs to setup for your hunting routine.

As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* Profile - This is where you save/load your profile information. Profiles are saved to your \Lich5\data\<GSServer\<charname>\bigshot_profiles directory. Eg, \Lich5\data\GSIV\Rinualdo\bigshot_profiles (note, if you've previously used bigshot, the file location has changed. The previous location was in your \Lich5\scripts\bigshot_profiles folder. You can copy/paste
* Resting - Set up your resting routine and location.
* Hunting - Create a hunting map by adding BOUNDARIES, define your attack stance and any pre hunt information
* Attacking - configuration for ambushing, bless, reactions, and similar flags
* Commands - Where you define your valid targets and associated attack routines. See sample routines below.
* Misc tab - Various config options

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room you are in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your character's profile folder. Also accessible via the Profiles tab in the setup menu.
* ;bigshot profile load <name here> - Loads a profile from your character's profile folder. Also accessible via the Profiles tab in the setup menu.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit
* ;bigshot <options> <creature> - example: ;bigshot single giant rat - Will activate ranger tracking of a creature. Anything input besides the above commands will default to "track <input>".

==The Profile Tab==
* Load Profile - will load an existing profile. Nothing will be available if no previous profiles are saved
* Current Profile - shows the existing profile if a new one is loaded.
* Save profile - Valid profile information for future ebounty script support
Save Current Settings - tell Bigshot what you want your profile to be named. Any name will work here. Once a profile is saved, will show up in the Load Profile menu.

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.

* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Map/Go2. Support both LichIDs and SimuIDs with a u, for example, 228 for Town Square Central or u7120.
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'eloot sell, waggle, eherbs'. This will use eloot to sell according to the options set with eloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, eherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]], Voln [[Symbol of Return]], [[Traveler's Song (1020)]], [[Sigil of Escape]], [[Familiar Gate (930)]] or Custom when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails. Setting to Traveler's Song will attempt once and continue. Setting to Familiar Gate will attempt to summon a portal once and walk through it. Will perform a mana pulse if not enough mana is detected. Custom option allows for comma separated list of commands to perform.
* Should Rest?
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate. 11/17/24: If you run into an error that calls to an "OOM" message, try setting this to 1.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds:
<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || Char.percent_health <= 70</PRE>
The following is a wound evaluation that will take you home if you can not cast anymore (bleeding, nerves, level 2 head/eyes, bad scars etc.):
<PRE>bleeding? || Char.percent_health <= 25 || [Wounds.head, Scars.head, Wounds.leftEye, Scars.leftEye, Wounds.rightEye, Scars.rightEye, Wounds.nsys, Scars.nsys].max > 1 || [Wounds.leftArm, Wounds.leftHand, Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand, Scars.rightArm, Scars.rightHand].max > 2 || ([Wounds.leftArm, Wounds.leftHand, Scars.leftArm, Scars.leftHand].max + [Wounds.rightArm, Wounds.rightHand, Scars.rightArm, Scars.rightHand].max) >= 3</PRE>
The following can be added to one of the above wound evaluations to also rest upon having popped muscles:
<PRE>|| Effects::Debuffs.active?("Overexerted")</PRE>

* '''when creeping dread >='''
** Forces Bigshot to rest when your creeping dread is at or below this threshold.
* '''when crushing dread >='''
** Forces Bigshot to rest when your crushing dread is at or below this threshold.
* '''Wall of Thorns Poison'''
** Forces Bigshot to rest when you are affected by Wall of Thorns Poison.
* '''Confusion Debuff'''
** Forces Bigshot to rest when you are affected by the non-dispellable Confusion Debuff.

==The Hunting Tab==
This is where you will tell bigshot when to hunt, any commands or society abilities to use prior to hunting, and where on the map you want to hunt.
===The Hunting Map===
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Here you also configure when to hunt
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>

The proper syntax for boundary rooms are separated by commas
Some popular Rift boundaries as an example
<PRE>
Plane 1: 2635, 12101, 12208
Plane 2: 2605, 2635, 12093
Plane 3: 2635, 12089, 12152
Plane 4: 12122, 12207, 12235
Plane 5: 2579
North Scatter: 12151, 12254, 12256, 12249, 12247, 12241
South Scatter: 12151, 12219, 12217, 12233, 12237, 12239
</PRE>

For Maaghara boundaries, you can use
<PRE>
9734
</PRE>

Confluence boundaries:<pre>
2300, 3519, 228, 188, 1932, 10855, 3668, 1438, 1005
</pre>

Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds. Set to 0 for fastest (spammy) movement.

* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. eloot is commonly scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Delay looting - delays looting of creatures in a room.
* Pull players to feet - attempt to pull players to their feet upon passing them in a room
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player
* Sneaky Sneaky - sneak around while out in the hunting area

===Should hunt ===
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game. (XML regex matching)
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])
* Activate weapon reactions - Will initiate reactive strikes when the opportunity presents itself
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)
* Flee from webs - Enabling this check box will force Bigshot to flee from webs.
* Flee from voids- Enabling this check box will force Bigshot to flee from voids.

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, <CODE>wand</CODE>. Gets a wand from the specified storage and WAVES it at the target.
** wandolier - Similiar to wand, but uses wandoliers. Gets a wand from the fresh wand container and waves it, rubs container if no wands found. Default waves in offensive. Can change via <CODE>wandolier defensive</CODE> to wave in a different stance
** fire - As in, <CODE>fire</CODE>. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, <CODE>kill (x3)</CODE> will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: <CODE>incant 903 (xx)</CODE> will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. <CODE>incant 720 (m50)</CODE> will only cast 720 (Implosion) if you have 50 or more mana. Similarly, <CODE>cman feint (s10)</CODE> will only execute the combat maneuver Feint on the target if you have 10 or more stamina. The command syntax is used as a separate call and wrapped in separate parenthesis, as in (m50 s20)(x2).
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will go into and stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, <CODE>mstrike</CODE>. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will force evoke 610 ensuring the damage version
** curse <curse> - Clumsy/Weakness/Darkness/Itch/Hex/Pox/Nightmare/Star - will prep 715 and use curse command as defined. Will skip "curse star" if buff is up.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** leech - Performs a [[Mana Leech (516)]] on target if cooldown is under 15 minutes.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep <nostance> - As in, <CODE>sleep 10</CODE> or <CODE>sleep 10 nostance</CODE>. Pause bigshot. Useful with fried hunting commands such as: <CODE>410, sleep 15</CODE> will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, <CODE>stance defense</CODE>. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, <CODE>force incant 1002 until 101</CODE>. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
** eachtarget <cmd> - issues command to each valid target in room
** efury <fire|cold> - casts Earthern Fury (917) on the target and waits for DOT to end or 12secs to pass
** caststop <spell> - casts the spell and then immediately stops it after casting
** wield <noun> <left|right> - weilds new noun and stores the hand given to put new noun item in
** store - store left, right or both, but only if something is in those hands
** tether <recast> - casts 706 with built-in logic to wait, can also do recast to auto-recast 706 on creature death and DOTs transfer
** unravel <spell> - casts 1013 Song of Unravelling with an optional spell to target against creature
** depress - casts 1015 Song of Depression with some some built in logic
** phase - force CASTs 704 Phase due to needing to prep/cast for usage on NPC targets
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targeted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** fury - You can specify the default attack fury will use. Will jab if not specified: fury punch or fury kick
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, disarm, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kifocus, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** dislodge <location> - Dislodge from location specified: dislodge eye neck
** stomp - Will perform a stomp attack. Channels 909 if not active. Can also add 909 to society abilities to keep it active.
** dhurl - Hurl your weapon and recovers it. Works with weapon bonding auto return and the recover verb.
** assume <aspect> <aspect/evoke> - Will cycle between two aspects, or evoke a single aspect. Also works in society ability box. "650 <aspect> <aspect/evoke>"
** briar <weapon> - activate the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
** stance perfection - Put 10, 20, 30, ect in your attack stance box to take advantage of stance perfection.
** chastise, excoriate - Will perform FEAT if available and affordable

===Gemstones Activation===
To utilize a Gemstone activated ability, you will use <CODE>jewel <mnemonic></CODE>. Will avoid usage if on cooldown automatically. Current supported activated gemstones are:
* bloodboil - Blood Boil
* spellblade - Spellblade's Fury
* arcascend - Arcanist's Ascendancy
* geospite - Geomancer's Spite
* forceofwill - Force of Will
* arcaneintensity - Arcane Intensity
* arcaneopus - Arcane Opus
* bloodsiphon - Blood Siphon
* bloodwell - Blood Wellspring
* epossess - Evanescent Possession
* manawellspring - Mana Wellspring
* spiritwell - Spirit Wellspring
* stamwell - Stamina Wellspring
* terrortribute - Terror's Tribute
* arcblade - Arcanist's Blade
* arcwill - Arcanist's Will
* imaerabalm - Imaera's Balm
* reckless - Reckless Precision
* unearthchains - Unearthly Chains
* witchhunt - Witchhunter's Ascendancy
* manashield - Mana Shield
* arcaneaegis - Arcane Aegis

You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill (x3)</PRE>
*slayer or 240 - Placing this in front of any command will cause you to cast 240 before doing that command. It will not recast if it's already active.
<PRE>slayer 302 (x99)</PRE>

===Command Checks===

Commands need to use the following format:
<CODE>COMMAND (CHECKS)(REPETITIONS)</CODE>

So <CODE>hamstring (mob1 prone)(x2)</CODE> Any (x#) needs to be separate. Also (xx) is not unlimited and is just short for (x5).

Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified. Only use for 2 or more creatures in the room
<PRE>To further clarify the mob# implimentation
1 mob, mob2, 1 IS less than 2, attack should not proceed.
2 mob, mob2, 2 IS NOT less than 2, attack can proceed
1 mob, !mob2, 1 IS NOT more than 2, attack can proceed
2 mob, !mob2, 2 IS NOT more than 2, attack can proceed
3 mob, !mob2, 3 IS more than 2, attack should not proceed</PRE>
*valid# - Similar to the mob check prior, but only counts valid targets you're actively targeting in current Bigshot settings.
*once - Performs the command once on a specified target, resets on room change
*room - Performs the command once in a room only, resets on room change
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*frozen - Same usage as prone. Broke out of prone check for archers against non-corporeal creatures that deflect ranged. Corporeal creatures can be stunned and will break this check.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*rooted - Checks to see if the target is rooted. Performed command if target is rooted.
*hidden - Checks to see if you're currently hidden.
*poison - Checks to see if you're currently poisoned.
*disease - Checks to see if you're currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*tailwind - Checks for Tailwind buff from Breeze. (tailwind) (!tailwind)
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*holler - Checks for the Horland's Holler buff from Holler.
*voidweaver - checks for the Voidweaver buff from Implosion(720)
*justice - Checks for charges of Swift Justice. (justice) do skill with charges (!justice) do skill with no charges
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,coupdegrace,fury,flurry,pummel,thrash,shout,yowlp
*tier# - Perform action if you are at the corresponding tier. (!tier3) don't do it if you are at tier3. (tier2) do it if you are tier2
*censer - Attempt to cast 320 before your command checking mana and cooldown. 309(censer), 335(censer mob3), attack(censer)
*ancient - Checks for grizzled/ancient creatures
*animate - Checks for if you have an animate present or not
*rebuke - Checks for Righteous Rebuke buff
*scourge - Checks for Ardor of the Scourge buff
*momentum - Checks for Glorious Momentum buff
*coupdegrace - Checks for Empowered buff.
*essence# - checks you have the required Shadow Essence
*splashy - checks if the room is "splashy" via Room.tags, useful to not do lightning attacks in wet rooms
**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.
**If command is not a spell, will only check you have enough mana for the censer.

===Example Attack Routines===
<PRE>wait 10, kill (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and incant 1615, kill (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force feint until 101, kill (x2)</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at left leg / prep 708 channel at left leg, incant 719 (m50)(x1), incant 702 (xx)</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg. It will then cast 719 (Dark Catalyst) if there is at least 50 mana, and will only cast one time. The last will incant 702 until the creature is dead.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge (s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert (s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pindown(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 (m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)
</pre>
* To attack everything in the room <code>(?:.*)</code>

== Misc Tab==
Various specialized config options

===UAC Options===
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===MSTRIKE Options===
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

===Ammo/Wands===
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

===MA Grouping===
* Enter the name of the looter in Head/Tail configuration

==Monitoring Tab==
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Quiet followers - Followers will wait until leader is done with both actions and resting scripts to begin using their own.

===Debugging:===
<pre{{log2}}>
+---------------------------------------------------------------------------+
| Bigshot Debug Help v5.8.5 |
+---------------------------------------------------------------------------+
| Debug options have changed to be more helpful. |
+--------------------------------------+------------------------------------+
| ;bigshot debug file | Toggles logging to a file <on/off> |
| ;bigshot debug all <true/false> | Toggles true/false all the things |
| ;bigshot debug check | Lists current debug settings |
| ;bigshot debug combat <true/false> | Combat and Creature Status |
| ;bigshot debug commands <true/false> | Attacking and Casting Commands |
| ;bigshot debug status <true/false> | Status Checks of your Character |
| ;bigshot debug system <true/false> | System processes |
| | |
| Options can be combined: |
| ;bigshot debug combat commands status <true/false> |
+---------------------------------------------------------------------------+

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|Profiles
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting
File:bigshot-4.PNG|Attacking
File:bigshot-5.PNG|Commands
File:bigshot-6.PNG|Misc
File:bigshot-7.PNG|Monitoring
</gallery>

==Reference==
* Info originally taken from http://forum.gsplayers.com/showthread.php?t=57651

{{Third-Party Software}}
{{top}}

Small clay animal

2026-01-23T17:04:56Z

HORIBU1: fix formating

<table><tr valign="top"><td>
A '''small clay animal''' is a special piece of pottery created by GM Haliste. If watered consistently, something grows inside of it. If watered for 7 days in a row without fail, it yields a prize. If watered for 14 days in a row without fail, it yields a better prize. Some types of water do not work for watering the animal, so if at first you don't succeed, try water from a different source. 
{{TOC limit|2}}

==Analzye==
'''If the clay animal belongs to you:'''
<pre{{log2}}>
You analyze your clay {animal} and sense that the creator has provided the following information:
This clay {animal} appears to be some kind of planter, as it is already filled with dirt.

Try as you might, you cannot get a good sense of whether or not the {animal}'s pockets could get any deeper, but you can tell that the {animal} is as light as it can get.
</pre>
'''If the clay animal does not belong to you:'''
<pre{{log2}}>
You analyze your clay {animal} and sense that the creator has provided the following information:
This clay {animal} does not belong to you.

Try as you might, you cannot get a good sense of whether or not the {animal}'s pockets could get any deeper, but you can tell that the {animal} is as light as it can get.
</pre>
==Look==
'''If the clay animal belongs to you:'''
<pre{{log2}}>
Expertly crafted from clay, fired and glazed to a brilliant color of {color}, this small {animal} has a large opening on its head that appears to be filled with fresh dirt. A thin layer of rhimar, clearly identified by its deep steel-blue color, lines the inside of the animal-shaped pot, and tiny holes have been bored along the bottom.

A small tag on a silver linked chain hangs around the creature's neck, and its mouth is wide open as if prepared to catch or hold something.
</pre>
'''If the clay animal does not belong to you:'''
<pre{{log2}}>
This clay {animal} does not belong to you.
</pre>
==Read==
<pre{{log2}}><nowiki>
In the Common language, it reads:
~~~ FEED ME ~~~
</nowiki></pre>
==Usage==
{| {{verbtable}} 
|- {{verbtableheader}}
! scope="col" style="width:5em;"|Verb
! scope="col"|First
! scope="col"|Third
|-
! scope="row" role="rowheader"|WATER
| {{addmetext}}
| {{addmetext}}
|}
==Additional Information==
A small clay animal was first featured in the third PlayApartTogether {{boldmono|[[GIFTBOX]]}} between May 6 and May 19, 2020. When you looked in the animal-stamped present, you saw a small clay animal. When you picked up the animal, it changed and became a particular type of animal. Here is a list of some of the various types of clay animals that were found:
*a small clay bear
*a small clay bobcat
*a small clay chimera
*a small clay dobrem
*a small clay mezic
*a small clay puma
*a small clay relnak
*a small clay rolton
*a small clay sheep
*a small clay snowcat
*a small clay tegu
*a small clay urgh
*a small clay yeti
*a small clay weasel
*a small clay wolverine
*a small clay lizard
*a small clay shrickhen

===GIFTBOX Messaging===
<pre{{log2}}>
The clay animal requires watering to grow. Be sure to water it daily until it's finished! Once you start, you'll want to make sure you continue until it fully blooms!
</pre>
===GM Wyrom Message===
<pre{{log2}}>
Once you start watering it, you won't want to miss a single day until it has fully bloomed! Only start it when you're prepared to visit daily!
</pre>
</td><td>
{{iteminfo
|type= Fluff
|itemclass= Miscellaneous
|itemtype= 
|alter= 
|ld= 
|feature= 
|customize= 
|custom= 
|origmerch= 
|releasevenue= Giftbox 
|releaseyear= 2020 
|questitem= 
|tiered= 
|tiersnumber= 
|unlock= 
|legendary= 
|demeanor= 
|loresong= 
|corrscript= 
|attune= 
|attunement= 
|affinity= 
|spell= 
|enhancive= 
|swap= 
|add= 
|restrictions= 
}}
{{itemverb
|verb= WATER
}}
</td></tr></table>

Lich:Software/Installation

2026-01-17T03:18:57Z

HORIBU1: /* Lich Changelog */ add 5.13.5

{{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.13.5 supporting Ruby 4.0 - published January 16, 2026'''

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

====Lich 5.6 or older====
Please proceed to updating both Ruby and Lich 5

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

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

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

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

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora
* 41 uses Ruby 3.3
* 42 uses Ruby 3.4
* 43 uses Ruby 3.4
All of which are currently compatible with Lich 5.7.0 or higher.

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

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

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

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

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

=Ecosystem Information=

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

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.13.5'''
<PRE>
### Bug Fixes (general)
* util.rb only show gem installing debug messaging if gem mis… (#1131)
* add --gs and --dr, refactor argv_options to helpers (#1133)
* fix multiple custom entries, improvements to yaml save (#1134)
* login_tab_utils.rb expand helper text show Warlock (#1135)
* update CLI for YAML security signature, add auto-convert fo… (#1136)
* remove password parameter from debug logging in all cases (#1137)
* reduce minimum GUI window footprint for non-tabbed view (#1138)
* remove double save in YAML to preserve yaml.bak integrity (#1139)

### Bug Fixes (gs)
* stash.rb additional improvements (#1132)
</PRE>
'''5.13.4'''
<PRE>
### Bug Fixes (general)
* force system gem install if RubyGems fails (#1126)
* gui_login prevent destroying window if already destroyed (#1127)
* add window size / position saves to login GUI (#1128)
* non tabbed saved entries in reduced button / font size (not… (#1129)
</PRE>
'''5.13.3'''
<PRE>
### Bug Fixes (general)
* account manager sorting GUI fix (#1123)
</PRE>
'''5.13.2'''
<PRE>
### Bug Fixes (general)
* install_gem_requirements update available gems after install (#1120)
</PRE>
'''5.13.1'''
<PRE>
### Bug Fixes (general)
* password_cipher.rb upcase account_name for key (#1118)

### Bug Fixes (dr)
* validator.rb change sleep to should_sleep named param (#1116)

### Bug Fixes (gs)
* add base stats capture from 'info full' command (#1115)
</PRE>
'''5.13.0'''
<PRE>
### Features (general)
* Refocus Frontend (#960)
* socket configurator to better guard TCPSocket (#976)
* add simplified DB maintenance (#991)
* TextStripper module support for XML, HTML, Markdown (#1055)
* Login modernization and refactor to yaml (#1063)
* Ruby Memory Releaser module (#1066)

### Features (dr)
* support meta:trashcan tag for DRCI.dispose_trash (#966)
* Add GameObj.inv support for DR items (#1080)
* DRCS allow custom adjective for summoned weapons (#1088)
* DRParser support for new exp window xml stream elements (rested exp, tdps, favors) (#1104)

### Features (gs)
* Add Armaments (Weapon, Armor, and Shield) Module (#911)
* add creature module, including Hinterwilds creatures (#1002)
* Creature module combat tracking (#1003)
* track time of last total_experience record (#1030)
* add Injured class for checking ability to perform actions (#1035)

### Bug Fixes (general)
* map dijkstra optimization (#1061)
* update.rb keep script/data file incase of error on update (#1070)
* ensure proxy path is set for non-destructive array write-th… (#1073)
* [lib][global-defs] - move update (#1079)
* GameObj force new objects ID to be string (#1087)
* xmlparser.rb gate GSL exits sending behind @send_fake_tags (#1103)
* change Hash[] pair key conversion to use to_h for Ruby 4.0 (#1108)
* move gui-login.rb to Ruby standard gui_login.rb (#1111)
* update location for currency and move game-loader.rb to Ruby standard gameloader.rb (#1112)

### Bug Fixes (dr)
* DRCA allow custom spell prep messaging (#1089)
* Update Slackbot error handling, and lnet management (#1091)
* Fix exp mods parsing for DR (#1102)
* equipmanager.rb support for custom messaging in forester's longbow (#1105)
* Fix hang in equipment manager when game doesn't respond to commands (#1110)

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

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

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

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

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

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

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

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

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

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

Lich:Software/Installation

2026-01-17T03:18:13Z

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

{{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.13.5 supporting Ruby 4.0 - published January 16, 2026'''

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

====Lich 5.6 or older====
Please proceed to updating both Ruby and Lich 5

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

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

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

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

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora
* 41 uses Ruby 3.3
* 42 uses Ruby 3.4
* 43 uses Ruby 3.4
All of which are currently compatible with Lich 5.7.0 or higher.

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

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

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

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

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

=Ecosystem Information=

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

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.13.4'''
<PRE>
### Bug Fixes (general)
* force system gem install if RubyGems fails (#1126)
* gui_login prevent destroying window if already destroyed (#1127)
* add window size / position saves to login GUI (#1128)
* non tabbed saved entries in reduced button / font size (not… (#1129)
</PRE>
'''5.13.3'''
<PRE>
### Bug Fixes (general)
* account manager sorting GUI fix (#1123)
</PRE>
'''5.13.2'''
<PRE>
### Bug Fixes (general)
* install_gem_requirements update available gems after install (#1120)
</PRE>
'''5.13.1'''
<PRE>
### Bug Fixes (general)
* password_cipher.rb upcase account_name for key (#1118)

### Bug Fixes (dr)
* validator.rb change sleep to should_sleep named param (#1116)

### Bug Fixes (gs)
* add base stats capture from 'info full' command (#1115)
</PRE>
'''5.13.0'''
<PRE>
### Features (general)
* Refocus Frontend (#960)
* socket configurator to better guard TCPSocket (#976)
* add simplified DB maintenance (#991)
* TextStripper module support for XML, HTML, Markdown (#1055)
* Login modernization and refactor to yaml (#1063)
* Ruby Memory Releaser module (#1066)

### Features (dr)
* support meta:trashcan tag for DRCI.dispose_trash (#966)
* Add GameObj.inv support for DR items (#1080)
* DRCS allow custom adjective for summoned weapons (#1088)
* DRParser support for new exp window xml stream elements (rested exp, tdps, favors) (#1104)

### Features (gs)
* Add Armaments (Weapon, Armor, and Shield) Module (#911)
* add creature module, including Hinterwilds creatures (#1002)
* Creature module combat tracking (#1003)
* track time of last total_experience record (#1030)
* add Injured class for checking ability to perform actions (#1035)

### Bug Fixes (general)
* map dijkstra optimization (#1061)
* update.rb keep script/data file incase of error on update (#1070)
* ensure proxy path is set for non-destructive array write-th… (#1073)
* [lib][global-defs] - move update (#1079)
* GameObj force new objects ID to be string (#1087)
* xmlparser.rb gate GSL exits sending behind @send_fake_tags (#1103)
* change Hash[] pair key conversion to use to_h for Ruby 4.0 (#1108)
* move gui-login.rb to Ruby standard gui_login.rb (#1111)
* update location for currency and move game-loader.rb to Ruby standard gameloader.rb (#1112)

### Bug Fixes (dr)
* DRCA allow custom spell prep messaging (#1089)
* Update Slackbot error handling, and lnet management (#1091)
* Fix exp mods parsing for DR (#1102)
* equipmanager.rb support for custom messaging in forester's longbow (#1105)
* Fix hang in equipment manager when game doesn't respond to commands (#1110)

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

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

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

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

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

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

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

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

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

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

Lich:Profanity

2026-01-16T17:28:27Z

HORIBU1: /* Logging in */ wrap flags in code block

{{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 --gemstone &
</pre>

For other game instances you need to update the CLI flags. Supported options include:
* <code>--gemstone</code>
* <code>--shattered</code>
* <code>--gemstone --shattered</code>
* <code>--gemstone --platinum</code>
* <code>--gemstone --test</code>
* <code>--dragonrealms</code>
* <code>--fallen</code>
* <code>--dragonrealms --fallen</code>
* <code>--dragonrealms --platinum</code>
* <code>--dragonrealms --test</code>

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 --gemstone
</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]]

Lich:Profanity

2026-01-16T17:27:34Z

HORIBU1: /* Logging in */ add additional game instance flag docs

{{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 --gemstone &
</pre>

For other game instances you need to update the CLI flags. Supported options include:
* --gemstone
* --shattered
* --gemstone --shattered
* --gemstone --platinum
* --gemstone --test
* --dragonrealms
* --fallen
* --dragonrealms --fallen
* --dragonrealms --platinum
* --dragonrealms --test

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 --gemstone
</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]]

Lich:Software/Installation

2026-01-15T15:42:05Z

HORIBU1: update to 5.13.4

{{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.13.4 supporting Ruby 4.0 - published January 14, 2026'''

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

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

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

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

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

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

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora
* 41 uses Ruby 3.3
* 42 uses Ruby 3.4
* 43 uses Ruby 3.4
All of which are currently compatible with Lich 5.7.0 or higher.

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

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

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

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

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

=Ecosystem Information=

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

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.13.4'''
<PRE>
### Bug Fixes (general)
* force system gem install if RubyGems fails (#1126)
* gui_login prevent destroying window if already destroyed (#1127)
* add window size / position saves to login GUI (#1128)
* non tabbed saved entries in reduced button / font size (not… (#1129)
</PRE>
'''5.13.3'''
<PRE>
### Bug Fixes (general)
* account manager sorting GUI fix (#1123)
</PRE>
'''5.13.2'''
<PRE>
### Bug Fixes (general)
* install_gem_requirements update available gems after install (#1120)
</PRE>
'''5.13.1'''
<PRE>
### Bug Fixes (general)
* password_cipher.rb upcase account_name for key (#1118)

### Bug Fixes (dr)
* validator.rb change sleep to should_sleep named param (#1116)

### Bug Fixes (gs)
* add base stats capture from 'info full' command (#1115)
</PRE>
'''5.13.0'''
<PRE>
### Features (general)
* Refocus Frontend (#960)
* socket configurator to better guard TCPSocket (#976)
* add simplified DB maintenance (#991)
* TextStripper module support for XML, HTML, Markdown (#1055)
* Login modernization and refactor to yaml (#1063)
* Ruby Memory Releaser module (#1066)

### Features (dr)
* support meta:trashcan tag for DRCI.dispose_trash (#966)
* Add GameObj.inv support for DR items (#1080)
* DRCS allow custom adjective for summoned weapons (#1088)
* DRParser support for new exp window xml stream elements (rested exp, tdps, favors) (#1104)

### Features (gs)
* Add Armaments (Weapon, Armor, and Shield) Module (#911)
* add creature module, including Hinterwilds creatures (#1002)
* Creature module combat tracking (#1003)
* track time of last total_experience record (#1030)
* add Injured class for checking ability to perform actions (#1035)

### Bug Fixes (general)
* map dijkstra optimization (#1061)
* update.rb keep script/data file incase of error on update (#1070)
* ensure proxy path is set for non-destructive array write-th… (#1073)
* [lib][global-defs] - move update (#1079)
* GameObj force new objects ID to be string (#1087)
* xmlparser.rb gate GSL exits sending behind @send_fake_tags (#1103)
* change Hash[] pair key conversion to use to_h for Ruby 4.0 (#1108)
* move gui-login.rb to Ruby standard gui_login.rb (#1111)
* update location for currency and move game-loader.rb to Ruby standard gameloader.rb (#1112)

### Bug Fixes (dr)
* DRCA allow custom spell prep messaging (#1089)
* Update Slackbot error handling, and lnet management (#1091)
* Fix exp mods parsing for DR (#1102)
* equipmanager.rb support for custom messaging in forester's longbow (#1105)
* Fix hang in equipment manager when game doesn't respond to commands (#1110)

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

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

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

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

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

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

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

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

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

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

Lich:Profanity

2026-01-14T01:41:59Z

HORIBU1: /* Logging in */ add --gemstone flag

{{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 --gemstone &
</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 --gemstone
</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]]

Lich:Software/Installation

2026-01-14T01:03:57Z

HORIBU1: /* Lich Changelog */ update to 5.13.1

{{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.13.1 supporting Ruby 4.0 - published January 13, 2026'''

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

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

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

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

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

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

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora
* 41 uses Ruby 3.3
* 42 uses Ruby 3.4
* 43 uses Ruby 3.4
All of which are currently compatible with Lich 5.7.0 or higher.

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

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

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

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

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

=Ecosystem Information=

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

=Lich Changelog=
<div class="mw-customtoggle-changelog" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-changelog">
'''5.13.1''' (current)
<PRE>
### Bug Fixes (general)

* password_cipher.rb upcase account_name for key (#1118)

### Bug Fixes (dr)

* validator.rb change sleep to should_sleep named param (#1116)

### Bug Fixes (gs)

* add base stats capture from 'info full' command (#1115)
</PRE>
'''5.13.0'''
<PRE>
### Features (general)

* Refocus Frontend (#960)
* socket configurator to better guard TCPSocket (#976)
* add simplified DB maintenance (#991)
* TextStripper module support for XML, HTML, Markdown (#1055)
* Login modernization and refactor to yaml (#1063)
* Ruby Memory Releaser module (#1066)

### Features (dr)

* support meta:trashcan tag for DRCI.dispose_trash (#966)
* Add GameObj.inv support for DR items (#1080)
* DRCS allow custom adjective for summoned weapons (#1088)
* DRParser support for new exp window xml stream elements (rested exp, tdps, favors) (#1104)

### Features (gs)

* Add Armaments (Weapon, Armor, and Shield) Module (#911)
* add creature module, including Hinterwilds creatures (#1002)
* Creature module combat tracking (#1003)
* track time of last total_experience record (#1030)
* add Injured class for checking ability to perform actions (#1035)

### Bug Fixes (general)

* map dijkstra optimization (#1061)
* update.rb keep script/data file incase of error on update (#1070)
* ensure proxy path is set for non-destructive array write-th… (#1073)
* [lib][global-defs] - move update (#1079)
* GameObj force new objects ID to be string (#1087)
* xmlparser.rb gate GSL exits sending behind @send_fake_tags (#1103)
* change Hash[] pair key conversion to use to_h for Ruby 4.0 (#1108)
* move gui-login.rb to Ruby standard gui_login.rb (#1111)
* update location for currency and move game-loader.rb to Ruby standard gameloader.rb (#1112)

### Bug Fixes (dr)

* DRCA allow custom spell prep messaging (#1089)
* Update Slackbot error handling, and lnet management (#1091)
* Fix exp mods parsing for DR (#1102)
* equipmanager.rb support for custom messaging in forester's longbow (#1105)
* Fix hang in equipment manager when game doesn't respond to commands (#1110)

### Bug Fixes (gs)

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

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

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

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

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

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

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

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

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

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

Lich:Software/Installation

2026-01-14T01:02:19Z

HORIBU1: /* Installing the Latest Stable Release */ update to Ruby 4.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.13.1 supporting Ruby 4.0 - published January 13, 2026'''

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

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

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

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

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

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

==Fedora==
<div class="mw-customtoggle-fedora" style="font-size:16px;overflow:auto;color:#0000FF">[Click to Expand]</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-fedora">
Currently supported versions of Fedora
* 41 uses Ruby 3.3
* 42 uses Ruby 3.4
* 43 uses Ruby 3.4
All of which are currently compatible with Lich 5.7.0 or higher.

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

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

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

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

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

=Ecosystem Information=

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

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

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

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

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

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

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

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

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

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

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

Lich:Software/Installation

2026-01-13T23:51:37Z

HORIBU1: /* Fedora */ update required gems

{{3rd-party}}
=About=

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

=Installing the Latest Stable Release=

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

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

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

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

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

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

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

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

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

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

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

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

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

=Ecosystem Information=

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

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

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

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

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

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

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

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

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

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

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

Lich:Software/Installation

2026-01-13T23:51:29Z

HORIBU1: /* Arch Linux & Arch-based distributions */ update required gems

{{3rd-party}}
=About=

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

=Installing the Latest Stable Release=

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

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

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

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

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

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

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

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

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

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

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

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

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

=Ecosystem Information=

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

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

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

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

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

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

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

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

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

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

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

Lich:Software/Installation

2026-01-13T23:51:19Z

HORIBU1: /* Chromebook & Debian variants */ update required gems

{{3rd-party}}
=About=

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

=Installing the Latest Stable Release=

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

==In-Place Upgrade==

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

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

===Lich 5 Only===

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

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

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

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

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

==Windows New Installation==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Update the system and install required dependencies:
<pre>
sudo pacman -Syu
sudo pacman -S --needed base-devel openssl libyaml readline zlib ncurses libffi gdbm sqlite git unzip curl
</pre>

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

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

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

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

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

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

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

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

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

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

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

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

=Ecosystem Information=

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

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

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

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

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

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

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

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

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

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

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

Lich:Script Ebounty

2026-01-09T15:07:10Z

HORIBU1: /* Changelog */ update to v1.9.0

{{3rd-party}}
Ebounty is management script for handling Bounties from the [[Adventurer's Guild]].
Afk scripting on any server but Shattered is in violation of game policy.

==What Does Ebounty Do?==

Ebounty will handle the management for Adventurer's Guild tasks. It utilizes a primary workflow of
<PRE>Find acceptable tasks. If acceptable task can not be found, execute the default Bigshot routine. If a task is available, execute the task and then turn in if not saturated. When bounty timer is up, grab a new task. Repeat. </PRE>

==How Do I Get It?==

Eloot can be downloaded via <CODE>;repo download ebounty</CODE>

As a script in active development and with the constant state of changes in the game, it is recommended to set ebountyand all Elanthia-Online scripts to auto-update via <CODE>;repo set-updatable ebounty</CODE>

==How Do I Make it GO!?==
Initial setup is accessed through ;ebounty setup. There you will see a configuration window with various tabs to configure for your guild tasks. Presently Ebounty is designed to utilize [[Bigshot]] for it's attack related parameters, and will run a bigshot routine when there is no available active bounty.
'''Bigshot profiles need to be configured inside Bigshot before they can be utilized in Ebounty'''.

As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;ebounty setup to open this dialog. This will open a window with the following tabs:
* General - This is where you tell ebounty what type of bounties you are looking for and any task limits.
* Escort - Set up your escort and location preferences
* Profiles - Exclusions and which creatures you do/do not which to hunt.

==The General Tab==
===Bounty Types===
* Bounty Types - This is where you will define which bounty types you wish. Enabling the checkboxes will tell ebounty which types of bounties you wish to get and which ones to drop.
Ebounty will use ;echild for children tasks and ;ego2 for escort tasks.

===Task Limits===
* Task Limits - Here you can define maximum number of tasks you want to accept

===Misc===
* Rest when mind full - Will perform a bigshot attack, based on your default profile, and then return to your resting location once your mind is full. If disabled, ebounty will keep killing creatures until the bounty is or other rest condition like injury or mana are met.
* Run one bounty and quit - Ebounty will run a single bounty until successful and then quit.
* Use Vouchers - Ebounty will use advguild vouchers until a desired bounty type has been met
* Rest at random nodes in town - Will find a random [[supernode]] in town for resting
* Just the Basics- Will only get/drop tasks and not perform any other bounty related routines
* Selling script - Which script you want to sell. No arguments needed. Default is Eloot
* Healing script - Which healing script you want when injured. No arguments needed. Default is Eherb
* Resting Room - Define where you want to rest between activities.

==The Escort Tab==
Here you can define your travel preferences and which destinations to/from.

==The Profiles Tab==
This is the area to tell Ebounty how to hunt

===Creature Exclusions===
* Input a list of creature nouns that you do not wish to perform any tasks for and then click ''add''.

===Profiles===
The heart of ebounty combat routines. ''Only Kill Bounty Creatures'' option is available if you only want to kill the creatures listed in the Creature Name field and ignore other creatures in the bigshot profile.
* Gem/Default profile - This is the default bigshot profile that Ebounty will utilize when there's no acceptable bounty to initiate. Ebounty will run bigshot using the parameters established in the profile for hunting, skinning, resting, etc... until the bigshot is resting and the bounty timer is available. See workflow screenshot.
* Bandits profile - Ebounty will attempt to locate where bandits are based in game location and then attack based on profile settings.
* Creatures - Associate a profile for one or more creature names. User can separate creatures by commas or each creature on a separate line. The pulldown will grab all bigshot profiles in the Bigshot profiles folder.
'''Creature names must match exactly in the Creature Names field and there must be a routine for that creature in the Associated Profile. Ebounty will not function for combat without these two items being correct.'''
If a creature is not listed in exclusions and no available Creature Name can be located, Ebounty will return to the resting spot and kill itself.
* Incorrect <CODE>executioner</CODE>

* Correct <CODE>triton executioner</CODE>

==Planned work and known issues==

* Grouping: Not presently supported but planned

* Hoarding: Basics work but we'll likely need to clean up ;shoard and rerelease it to fully support hoarding. That's going to be quite a bit of work

==Ingame Screenshot==
<gallery perrow="4">
File:ebounty-1.PNG|General
File:ebounty-2.PNG|Escort
File:ebounty-3.PNG|Profiles
</gallery>

==Changelog==
<span class="mw-customtoggle-mychangelog" style="color:#0000ff">Click to expand</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-mychangelog">
v1.9.0 (2025-01-08)
- added support for ranger track
v1.8.1 (2025-12-24)
- added option to regroup before quiting if started in group
v1.8.0 (2025-11-18)
- added option to get a new bounty before quitting when set to "Run one bounty and quit"
v1.7.5 (2025-11-11)
- bugfix in minimum Lich required checks
v1.7.4 (2025-11-11)
- bugfix for go2_rest - settings[:resting_room] converted to array and current_room a string
v1.7.3 (2025-10-01)
- updates for Sailor's Grief
- added support for uids
- bugfix for saving settings
- general code cleanup
v1.7.2 (2025-09-08)
- change requirement to 5.12.5 due to heirloom text change
v1.7.1 (2025-09-07)
- bugfix for change in Heirloom return messaging
v1.7.0 (2025-09-05)
- add option to select boost bounty type
v1.6.5 (2025-08-15)
- bugfix for stowing herbs
v1.6.4 (2025-08-05)
- remove version check for bigshot
v1.6.3 (2025-08-03)
- bugfix mana check when changing aspect while 650 is active
- bugfix for hiding is 608 doesn't work
v1.6.2 (2025-04-21)
- bugfix for NPCs not populating quickly upon room entry with large amount of other characters
v1.6.1 (2025-04-21)
- bugfix for HW bounty turnin
v1.6.0 (2025-03-29)
- remove custom bounty and use Lich Bounty API
- remove custom issue_command to Lich::Util.issue_command
- remove depreciated code
- update references of ego2 to escortgo2
v1.5.6 (2025-03-27)
- bugfix for set_eval not adding additional skins to skinning bounty amount
v1.5.5 (2025-03-19)
- remove deprecated Lich calls
v1.5.4 (2025-03-10)
- another bugfix for bundled skins
v1.5.3 (2025-03-08)
- bugfix when counting bundled skins
v1.5.2 (2025-02-09)
- bugfix when only foraging and needing healed
v1.5.1 (2025-01-07)
- bugfix for forage turn-in
v1.5.0 (2024-12-24)
- added buffing option when resting
- added using a script to handling resting location
- added option to rest at nearest table
- added remove bounty if heirloom item gets lost
- bugfix for bounty eval not setting EBounty.data.complete_mind
- bugfix for ask_guard in HW
v1.4.5 (2024-11-26)
- added option to use the bigshot setting for a resting location
- bugfix for profile dropdown sorting
- bugfix stop script from looping if started without child in room
v1.4.4 (2024-11-22)
- bugfix in should_hunt
v1.4.3 (2024-11-18)
- missing criteria in should_hunt?
- bugfix in wait_for_bounty
- removed EBounty.data.wait - no longer used
v1.4.2 (2024-11-16)
- bugfix for when to rest
v1.4.1 (2024-11-07)
- will continue hunting after bounty complete until Bigshot Should Rest? is met
- bugfix in setup - prevent toggling both Rest when mind is full and Keep Hunting
- bug fix for should_hunt? spamming an experience check
- bug fix for should_hunt? exp_pause incorrectly included
v1.4.0 (2024-08-23)
- expanded resting options
- added optional death recovery support
- added spinbutton for room delay for bandit bounties
- asks the alchemist in HW for bounties instead of the tavernkeeper since he keeps moving
- bugfix in gem bounty running hording script with parameters
- bugfix in bandit hunting variables
- removed script change log before v1.3.0 - full log: https://gswiki.play.net/Lich:Script_Ebounty
v1.3.11 (2024-09-24)
- fix to allow for CLI foraging without setting Gem/Default profile
v1.3.10 (2024-08-19)
- bugfix for ask_guard response
v1.3.9 (2024-08-14)
- logic fix when once_and_done is set and rejected bounty not exiting (but going out to hunt instead)
v1.3.8 (2024-07-12)
- add timer to not spam INFO during should_hunt? method
v1.3.7 (2024-07-08)
- add quiet info command to should_hunt? method to refresh stats
v1.3.6 (2024-06-23)
- update ebounty fog routine to match bigshot
v1.3.5 (2024-05-15)
- add exit if gembounty complete but using eloot sell excludes gems
v1.3.4 (2024-05-01)
- Change Char.prof to Stats.prof
v1.3.3 (2024-04-13)
- bug in escort task acceptance
v1.3.2 (2024-04-09)
- bug in forage for 1011 song of peace usage
v1.3.1 (2024-04-01)
- updated keep_hunting not to run in bigshot bounty mode. Also, added better messaging for why
- updated wiki changelog
- removed change log before v1.1.14 - full log: https://gswiki.play.net/Lich:Script_Ebounty
v1.3.0 (2024-03-17)
- added exclusion options for individual gems and locations
- added help section
- bugfix for UI title
- removed shattered specific actions not referenced in UI (requesting spells and healing in the nexus)
v1.2.2 (2024-03-03)
- bugfix for gem hoarding scripts that handle selling gems
v1.2.1 (2024-02-25)
- bugfix for condition where ebounty may be repeatedly invoke eherbs
v1.2.0 (2024-02-09)
- added toggle to skip healing
- added individual script options for rescue, escort, and hording
v1.1.37 (2024-01-08)
- add option to HIDE back for no-magic rooms if enabled to hide.
v1.1.36 (2024-01-06)
- remove forced HIDE for foraging put in by error.
v1.1.35 (2024-01-02)
- added check for nomagic tag before casting spells.
v1.1.34 (2023-11-16)
- bugfix in location check for foraging
v1.1.33 (2023-11-10)
- bugfix to stop trying to hand in herbs if completed
- added check for having enough herbs for turnin
v1.1.32 (2023-10-13)
- update hunting settings to use bigshot fried setting instead of setting to 100
v1.1.31 (2023-09-27)
- bugfix when asking taskmaster for bounty in crowded room
v1.1.30 (2023-09-26)
- bugfix for closing containers
v1.1.29 (2023-09-23)
- bugfix to initialize settings when using stand alone foraging
v1.1.28 (2023-09-23)
- bugfix for checking if 604 is active
v1.1.27 (2023-09-17)
- bugfix for CLI foraging exiting when "just the basics" option toggled true
- bugfix for black void check when foraging
v1.1.26 (2023-09-09)
- bugfix for CLI setting values to true/false with Ruby 3.2
v1.1.25 (2023-07-10)
- bugfix for HW guard
- bugfix for Ta'Vaalor guards
- bugfix for rejecting heirloom taskers
- turn portals off for escorts
v1.1.24 (2023-07-10)
- bugfix for HW taskmaster
v1.1.23 (2023-07-05)
- keep silvers based on eloot setting
v1.1.22 (2023-06-19)
- changed the resting room to default to your bigshot profile
- should recognize the correct town to turn in bounties
v1.1.22 (2023-06-11)
- removed need to set a resting room
v1.1.21 (2023-06-11)
- bugfix for missing category in tasks
v1.1.20 (2023-06-04)
- prep for new Lich 5.7.0 infomon.lic & effect-list.xml change
v1.1.19 (2023-05-21)
- bugfix for string error when finding rooms
- bugfix for heirloom turnin
- added support to wait for shattered healbot
v1.1.18 (2023-05-21)
- bugfix for escort tasks
v1.1.17 (2023-05-17)
- added missing escort locations
- bugfix for foraging using an heirloom setting
- bugfix for CLI herb gathering
v1.1.16 (2023-04-22)
- bugfix for RR purser
v1.1.15 (2023-04-11)
- bugfix bandit bounty locations
- bugfix in dangerous creature regex
v1.1.14 (2023-04-11)
- bugfix for CLI
- switched bounty_check to use Bounty API regex
- moved 213 into loop during foraging so it checks each time in case the spell wears off
- removed list of alternate foraging herb commands. Instead using in-game bounty xml for correct forage syntax
- added option to hunt with default profile instead of exiting when no profile found
v1.1.13 (2023-03-16)
- added sigil of resolve to foraging
- added flag righthand for heirloom search bounties
- replace script.vars with Script.current.vars
- run loot script only if loot at end of hunt
- added strip for extra spaced in herb bounties
- added check for right hand flag to make sure it gets turned off
v1.1.12 (2023-03-16)
- bugfix in rescue task regex
- changed bundle measuring to not be silent to prevent unintented screen scroll
v1.1.11 (2023-03-05)
- bugfix in string literal
v1.1.10 (2023-03-05)
- reverted string literal changes back
- fixed bug in child bounty
v1.1.9 (2023-03-05)
- reverted string literal changes
v1.1.8 (2023-03-04)
- added herb exclusions, rubocop fixes
v1.1.7 (2023-03-02)
- bug fix depositing silver
v1.1.6 (2023-02-28)
- fixed looting script from running in town
v1.1.5 (2023-02-28)
- fixed regex error in herb task location
v1.1.4 (2023-02-23)
- fixed regex error in targeting
v1.1.3 (2023-02-23)
- Added check for npcs in heirloom search
v1.1.2 (2023-02-04)
- added support for keeping silvers
v1.1.1 (2023-02-01)
- bug fix for foraging spells (waitcastrt? for assume yierka)
- rearranged post-hunt sequence to mimic bigshot functionality.
-fixed forage/heirloom search using empty_hands
v1.1.0 (2023-01-27)
- added pre and post hunt commands and scripts for foraging, heirloom search, and escorts
- added bad room entries for bandits that will accept UID's
- added spell support for heirloom search bounties
- added 1035 to foraging and heirloom searching
- think I finally squashed the repeating Song of Peace bug
v1.0.32 (2023-01-26)
- bugfix for heirloom searching
v1.0.31 (2023-01-24)
- reordered casting of song of peace during foraging and stopping it when done.
- added a double check for heirloom searching
v1.0.30 (2023-01-23)
- fix bad Widowmaker Rd room#
v1.0.29 (2023-01-23)
- fix bugfix in variable list from v1.0.29
v1.0.28 (2023-01-23)
- added herbalist to Mist Harbor
v1.0.27 (2023-01-22)
- refreshed spell active before casting foraging helper spells
- add check for silver deposit after bounty turn-in
- fixed bug in bundled skin eval
v1.0.26 (2023-01-21)
- fixed bug in herb turnin when caught in RT
- fixed prep-hunt command to run scripts consistent with bigshot functionality
v1.0.25 (2023-01-19)
- Fix badlist rooms and add bad logging road rooms
v1.0.24 (2023-01-19)
- Correct another typo in herb finding method
v1.0.23 (2023-01-16)
- Correct typo in herb finding method
v1.0.22 (2023-01-12)
- Change EBounty.data.location_start to use nearest instead of first in list
v1.0.21 (2023-01-02)
- typo in bug fix
v1.0.20 (2023-01-02)
-bug fix moves minor sanct outside foraging loop to stop it spamming
v1.0.19 (2023-01-01)
-bug fix to stop voucher use when bounty boost is active
v1.0.18 (2023-01-01)
- added bounty boost to available options
- added foraging enhancements - see foraging tab on ui
- changed the herb searching routine to try and eliminate false positives/negatives
- updated infomon and spell-list version requirements to support 650 tracking
- added CLI herb foraging independent of bounty - ;ebounty forage "<type of herb>" <number to find>
v1.0.17 (2022-12-27)
- ensuring following scripts are stopped before starting ebounty: go2, echild, ego2, bigshot
v1.0.16 (2022-12-22)
- typo fix for the bugfix for herbalist rooms using UID's
v1.0.15 (2022-12-22)
- bugfix for herbalist rooms using UID's
v1.0.14 (2022-12-20)
- updated herbalist rooms to use UID's for instance compatibility
v1.0.13 (2022-12-19)
- add regex for opening an item
v1.0.12 (2022-12-15)
- made resting room a required parameter
- consolidated odd herb names
v1.0.11 (2022-12-12)
- foraging name match fix
v1.0.10 (2022-12-11)
- fixed foraging herb matching bug
v1.0.9 (2022-12-09)
- bug fix for checkbounty not populating quickly
v1.0.8 (2022-12-06)
- moved post hunt routine to after forage turn-in to avoid trashing foraged item
- bug fix for foraging in the red forest
v1.0.7 (2022-12-05)
- bug fix for hunting sequence resting
v1.0.6 (2022-12-5)
- fixed bug in rescue bounty sequencing.
v1.0.5 (2022-12-3)
- bugfix for bounty_eval
- various foraging name corrections
- pre/post hunting bigshot routines (from default profile) added to escort bounties
v1.0.4 (2022-11-30)
- bug fix on container opening
- adjusted hunting sequence due to bigshot bounty_eval changing
- set bounty_eval to empty string on exit
- updated required versions to Lich 5.6.2, Bigshot 4.13.12, and Infomon 1.18.16
- regex fix for completed task
v1.0.3 (2022-11-28)
- changed container method to use "inventory container" instead of GameObj.inv
v1.0.2 (2022-11-27)
- Fix to targeting not using bigshot routines
v1.0.1 (2022-11-26)
- hedgehog sack messaging
- fixed herb names
- support for Bigshot fogging options
- child bounty fail bug
- Fix for grizzled targeting when user only kills bounty creatures
v1.0.0 (2022-05-18)
- initial framework and ui
</div>

==Reference==

{{Third-Party Software}}

Lich:Script Eloot

2026-01-09T15:06:43Z

HORIBU1: /* Changelog */ update to 2.6.3

{{3rd-party}}
Eloot is an automatic looting script in [[lich]] that is the spiritual predessory, and borrows heavily from concepts in [[sloot]]. Eloot is actively maintained by the Elanthia-Online team. As with all scripts that deal with inventory management, it is '''Highly''' recommend to mark and register every item you value until you understand how eloot will handle your inventory, and it is not recommended to be wearing any gem hoarding containers until you can verify your eloot settings and behavior.

==What does it do?==
Eloot will gather loot from a killed monster or room, place that loot into the defined containers including overflow containers. It will not gather specific loot types you define,skin creatures, will drop boxes off at the locksmith pool or town locksmith if you desire, and will sell loot that meets the criteria and deposit coins. Eloot settings are saved per character per instance, in your lich5 data folder. Ex lich-5\data\eloot\GSIV\Rinualdo.yaml. If you wish to keep eloot settings across more than one char, you can copy and paste this file and rename the .yaml to each character you have.

==How do I get it?==
Eloot can be downloaded via <CODE>;repo download eloot</CODE>.

As a script in active development and with the constant state of changes in the game, it is recommended to set eloot and all Elanthia-Online scripts to auto-update via <CODE>;repo set-updatable eloot</CODE>

Eloot scans your inventory each time lost, so adding ;autostart add --global eloot start to your lich autostart can populate the information it needs at the start of your gaming session.

==How does it work?==
Eloot operates off in game [[STOW]] settings where a user can define one or multiple containers for loot. [[STOW]] settings need to be configured in game or eloot will not function. Eloot does not utilize User.vars like [[Sloot]] does.
Eloot allows the user to define a variety of loot and selling conditions. You can access the configuration via ;eloot setup

==The Looting Tab==
The looting tab allows the user to define what items you want eloot to pick up. Item categorization is based on lich's gameobj-data.xml file. When no exclusions are defined and all available loot on the ground meets the relevant criteria, eloot will use the in game verb loot room, which the game engine gathers and places items based on your stow settings
* '''Loot Types'''
** Allows the user to tell eloot what things to loot. Of note, this is based on lich classification so some items may fit multiple categories. For example, a weapon may be both a weapon, magical, valuable, and uncommon.
* '''Other Settings'''
**A variety of switches for eloot configuration. Supports Coin Hands and a switch is provided for eloot to keep a lot in the yaml file for items that eloot is unable to loot.
* '''Overflow containers'''
**These are containers the user defines when the default stow containers are full. Of note, these should not be your default or box containers. For example, if your default container is a cloak and your box container is a backpack, then you would not designate either as overflow for boxes, but instead would pick satchel and knapsack as your primary and secondary overflow.
*'''Never Loot'''
** Items to never loot. Black ora, urglaes are popular exclusions for non clerics.
*'''Always Loot'''
**Always loot these items, no matter what other settings contain
*'''Creature exclusions'''
** If there is a creature you do not want to loot, such as one that can injur you when searching.
*'''Unlootable'''
** Note, sometimes due to player interaction, an item can be classified as unlootable. For example, if there is an uncut diamond on the ground and you run eloot, then another group or group member loots that diamond before eloot finishes, eloot may attempt to classify that as an unlootable item and will not try to loot again. You can check this location to see what items eloot was unable to loot previously.
==The Selling Tab==
* '''Sell Types'''
**Which items you want eloot to sell. '''MARK EVERYTHING IMPORTANT'''
* '''Only Sell from these STOW containers'''
**If you have a STOW container you want eloot not to sell from, you would remove it here. Testing beforehand is highly recommended.
* '''Exclusions'''
**If you want eloot not to sell any items supported by nouns or regex here
* '''Keep Scrolls'''
**Allows a defined list of spell numbers that eloot will not attempt to sell. Requires the appropriate training in reading scrolls to determine if a scroll contains the defined spells. Supports vibrant scrolls by doing 401v or 401 vibrant.
* '''Appraisals'''
**If enabled, eloot will attempt to appraise the designated categories to determine if they meet the Gemshop and Pawnshop limits established. This is useful for determining enhancive items that may require futher player inspection. Eloot will not attempt to resell items above these thresholds during the current session and will provide a notification to the user. If the current session is closed, eloot will attempt again on the next session.
* '''Locksmithing'''
**Allows the user to define which, if any, locksmithing component to use and allows the user to set a preconfigured tip as an actual silver amount or as a tip percentage.
* '''Other Settings'''
**Allows the user to define if they want collectiables deposited to the town collection location, to sell in FWI and if they want gold rings delivered to the chronomaster. 1212/1205/650 are options as well for those who can cast.

==The Skinning Tab==
* '''Settings'''
**Fill in the appropriate switches if you want eloot to skin, if you want it to keel and or use ranger spell 604 or Sunfist's Sigil of Resolve
* '''Skin Weapons'''
**Eloot needs to know what your skin weapon is and what container it is contained in. If your creature list requires a blunt weapon to skin, these also need to be filled out
* '''Skinning Exclusions'''
**Any creatures you do not want eloot to attempt to skin

==Ingame Screenshot==
<gallery perrow="4">
File:eloot-1.PNG|Looting
File:eloot-2.PNG|Selling
File:eloot-3.PNG|Skinning
</gallery>

==Changelog==
<span class="mw-customtoggle-mychangelog" style="color:#0000ff">Click to expand</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-mychangelog">
v2.6.3 (2025-12-2)
- bugfix trying to skin/loot failed bounty children npcs
- update debug messaging
- bugfix in blood band/bracer settings
v2.6.2 (2025-11-21)
- force looting of bounty heirloom items if found
v2.6.1 (2025-11-11)
- bugfix in open_loot_containers
- bugfix in get_weapon_inv
v2.6.0 (2025-10-26)
- add bloodband support
- bugfix for save_trash_box method
- bugfix box tipping default missing on first run
- bugfix for open_single_container when using a string
- moved tooltips out of UI xml
v2.5.7 (2025-10-19)
- bugfix for debt when entering locker
v2.5.6 (2025-10-08)
- bugfix for store/ready ranged_weapon to ranged
v2.5.5 (2025-10-05)
- bugfix for non-standard ready/stow list items
v2.5.4 (2025-10-04)
- bugfix for nil items
- bugfix in logic for return_hands
v2.5.3 (2025-10-03)
- bugfix for return_hands
- toggle righthand and lefthand off at initialization
- minimum lich version to 5.12.9
v2.5.2 (2025-10-02)
- bugfix for incorrect method call typo
v2.5.1 (2025-09-30)
- bugfix for store/ready secondary_weapon to 2weapon
v2.5.0 (2025-09-19)
- switch to using Lich methods ReadyList and StowList
- removed change log in script before 2.4.0. Full change log on the wiki
- fix for SG trash can
v2.4.11 (2025-09-12)
- add option to always use the locksmith when a gem bounty is active
v2.4.10 (2025-09-06)
- rework box contents check to store box instead of pausing
- bugfix for looting coins on the ground
v2.4.9 (2025-09-05)
- bugfix in regex for use_coin_hand method
v2.4.8 (2025-08-30)
- bugfix for setting ELoot.data.coin_bag_full to false when empty.
v2.4.7 (2025-08-15)
- if debug to file enabled, allow for when started with a parameter (sell/pool/etc)
v2.4.6 (2025-08-12)
- fix encumbered after box opening by depositing silvers in process_boxes
v2.4.5 (2025-07-22)
- bugfix for default locksmith_withdrawl_amount
v2.4.4 (2025-07-16)
- allow customizable locksmith tip amount withdrawal
- typo correction in bulk sell gem method
- force clean overflow containers from sell_container list
- utilize File.join for save/load
- bugfix in pool_return to allow up to 2 seconds for GameObj right/left hand to populate
- remove Unicode characters in formula explanation for scaled box tipping (non-logic change) / Warlock
v2.4.3 (2025-07-15)
- bugfix for town locksmith regex to open box after return being too generic
v2.4.2 (2025-07-09)
- bugfix for silver withdrawals failing on f2p accounts with low bank balances
v2.4.1 (2025-06-05)
- bugfix for unable to lighten load during pool return and no silvers to deposit to allow more boxes to be returned
- bugfix for box loot to deposit coins if too many coins on yourself to be able to loot coins from box
- change class checks to is_a? checks
v2.4.0 (2025-05-21)
- add CLI option to skin only
- fix regex for sellable/type/sell CLI to make = optional to match help text
v2.3.12 (2025-05-10)
- fix for Pinefar banker withdraw/deposit
- fix for disk/container contents being nil prior to storing an item
v2.3.11 (2025-05-05)
- fix find_boxes to now clear sacks found with boxes from sacks_full
- bugfix in regex for pool parameters to match help text
- general sanitation of GTK values on load and close of GTK window
- bugfix in incremental tipping display chart
- bugfix in locksmith_pool_count due to truncated results list returning incorrect list of boxes unopened
- correctly display incremental tipping chart starting at base 0
v2.3.10 (2025-04-28)
- bugfix in locksmith_tip to ensure numerics incase of string values saved in yaml
v2.3.9 (2025-04-27)
- bugfix add coin bag full msg'ing to regex
v2.3.8 (2025-04-22)
- bugfix for older Ruby 2.6 users and Bounty.task.assigned?
v2.3.7 (2025-03-27)
- add ;eloot pool return to options
- bugfix for Rift talons gem hoarding
- bugfix in get_regex to support hidden dagger harness
- bugfix in check_type for hoarding HW hyphenated gem names
- bugfix for locker reset while hoarding
- bugfix in wait_for_disk logic
- bugfix for spinbutton
- add additional in_region boundaries and convert to UID lookup
- bugfix for note deposit when using urchin guide and bounties
v2.3.6 (2025-03-15)
- typo for horde to hoard
- bugfix to deposit local note if selling in FWI
- bugfix in gem name standardization
- remove deprecated percentstance & percentencumbrance calls
- bugfix to not timeout on creatures that get ressurrected
- bugfix on find_weapons_ready_list
- bugfix in looting gemstone jewels if both hands currently used
- bugfix in validate_setup when toggling on/off skinning
v2.3.5 (2025-03-14)
- additional updates to put_regex and get_regex
- bugfix to not Regexp escape loot_keep
v2.3.4 (2025-03-11)
- bugfix for spin buttons not saving properly
- add debug for loot method
v2.3.2 (2025-03-10)
- update to appraise method
- fix for monsterbold gemstone jewel drop msging at feet
v2.3.1 (2025-03-09)
- add space for regex_at_feet
v2.3.0 (2025-03-09)
- add support for gambling kits
- update for gemstones
- bugfix when ELoot.data.settings[:loot_keep] is nil
- bugfix when emptying jars to add to empty jar count
- bugfix in store_item when gem hoarding
- bugfix for weapon displayer
- bugfix for container_contents
- broke up the set_inventory method into smaller sections
- bugfix add daybringer put_regex match
- bugfix for swordbelts and neck sheaths
v2.2.3 (2025-03-03)
- added support for Lock & Key gameobj types to loot_special and loot_regular
- bugfix in Bounty.task usage for gem/skin
v2.2.2 (2025-02-28)
- bugfix in Region.in_region for HW/Cold River
v2.2.1 (2025-02-26)
- bugfix in check_bounty_gems using furrier instead of gemshop
- bugfix for neck sheath containers not populating contents
v2.2.0 (2025-02-20)
- updated required lich version to 5.8.0
- added support for house lockers
- added additional container content checks
- added check for selling bounty items in the correct town
- misc improvements to UI functionality
v2.1.6 (2025-02-10)
- bugfix for selling boxtraps
- modified hording bugfix to be more comprehensive. Was failing on an end of line condition
- bugfix for standard account gem inventory
v2.1.5 (2025-02-07)
- bugfix for hoarding inventory when using a family vault
v2.1.4 (2025-01-25
- rework coin bag logic to reduce excessive inspect calls
v2.1.3 (2025-01-24)
- bugfix in incrimental tipping
v2.1.2 (2025-01-23)
- added support for looting/selling locksmith traps
- bugfix for breakdown calc
v2.1.1 (2025-01-23)
- add support for keeping vibrant scrolls. Enter the scroll number (Ex:101v or 101 vibrant) in the Keep Scrolls section
- add box detail to selling output
- added support for looting/selling locksmith traps
v2.1.0 (2025-01-13)
- added option to output debug information to file
v2.0.10 (2025-01-11)
- bugfix for box inhand and full locksmith pool
v2.0.9 (2025-01-01)
- bugfix for locksmith pool box list
v2.0.8 (2024-12-21)
- additional error checking for looting to avoid false pauses
- removed get_lines method and combined it with get_command
- add custom vine name
- bugfix in loot_regular method when looting a box and default container is full
v2.0.7 (2024-12-12)
- add HW uncommon loot to loot_specials method
- update reject loot method for 335 Deity effects
- added automatic data reload if new version downloaded
v2.0.6 (2024-12-06)
- temporarily disable raiding from house lockers
- bugfix in account type comparison
- bugfix for running results report when nothing to report
v2.0.5 (2024-12-06)
- bugfix for house lockers check
- bugfix for thinking bags were full when actually stunned.
v2.0.4 (2024-12-01)
- temporarily disable hording for house lockers
- bugfix to hording regex when creating inventory
v2.0.3 (2024-11-23)
- will try to selling clothing at the gemshop first, then the pawnshop if applicable
- bugfix in put_regex
- bugfix in store_item
v2.0.2 (2024-11-20)
- bugfix in single_loot method
- bugfix in hording process
- bugfix for urchin guide
v2.0.1 (2024-11-12)
- bugfix to only buff for selling if something to sell
- bugfix to exit if insufficient funds at bank
v2.0.0 (2024-09-04)
- support for hording gems and alchemy ingredients
- support for in-between script to run. This runs between finishing the pool and before selling. Usecase: totems, hording, supplies, whatever
- addition of CLI selling options: sellable, type, and itemized
- disk usage tracking improvements
- incremental tipping added for locksmith pool
- added appraisal container to store items appraised over limit.
- added crumble messaging for the bowels
- bugfix for selling in HW
- bugfix for closed coin bag
- bugfix for favor_left skinning
- bugfix for silver_deposit if keeper_silvers returns a note
- bugfix for coin hand bank deposit
- changes to UI
- bugfix for coin bag capacity check
- bugfix for shattered urchin usage
- bugfix for 1205 Glamour
- updated changelog on wiki
- removed changelog in script before 1.6.20
v1.6.36 (2024-08-16)
- pause script instead of exit when failing to empty container
v1.6.35 (2024-08-10)
- fix for emptying container but failing due to full bag
v1.6.34 (2024-08-07)
- bugfix for box_in_hand method
v1.6.33 (2024-07-25)
- add additional get_regex for READY WEAPON
v1.6.32 (2024-07-20)
- box_in_hand method updated to process both hands.
v1.6.31 (2024-06-30)
- add toggle for coin hand closing to be optional after selling
v1.6.30 (2024-06-28)
- fix for coin hand not closing after selling routine
v1.6.28 (2024-05-01)
- Change bad Char.methods to Stats.method
v1.6.27 (2024-04-28)
- add additional disk noun bassinet
v1.6.26 (2024-04-24)
- fix for GST and F2P accounts
- fix for disk noun regex word boundary
v1.6.25 (2024-04-24)
- handle all the new custom disk nouns
v1.6.24 (2024-04-05)
- update change_stance to use percentstance instead of checkstance
- add support for CMAN STANCE in change_stance
v1.6.23 (2024-04-05)
- additional open/close messaging for squelching
- reduce Lich::Util.quiet_command_xml timeout from default 5 to 2 seconds
v1.6.22 (2024-03-29)
- fix for Frozen Bramble creatures requiring left hand to be empty in order to loot.
v1.6.21 (2024-03-26)
- add messaging for valence weapons
v1.6.20 (2024-03-16)
- added use of trash verb
- (F2P) withdraw a note when the max bank account balance is reached
- fix to not "Share silvers" from the allotment of "Keep Silvers"
- fix to locksmith rooms without trashcans
v1.6.19 (2024-03-13)
- fix to not sell bounty items in FWI when selling disabled for that type
v1.6.18 (2024-03-08)
- fix for bulk selling skins when bundles are worth to much to sell via bulk sell
v1.6.17 (2024-02-25)
- withdraw exact amount if using flat tipping for locksmith pool
v1.6.16 (2024-01-29)
- bugfix in break_rocks method
v1.6.15 (2023-12-17)
- added breakable looting and selling options for Hive items (released 12/17/2023)
- added word boundary check for notes
- bugfix for urchin guild at locksmith pool in Hinterwilds
v1.6.14 (2023-12-04)
- fix bug in coin bag. It needed a free hand
- incorporated urchin guide support for shattered and plat (prime already supported)
- typo in gem selling method
v1.6.13 (2023-11-27)
- changed unknown response at locksmith to put item in container and keep going instead of exiting
v1.6.12 (2023-11-24)
- update get_regex for unique messaging
v1.6.11 (2023-11-19)
- check to make sure box is locked when using locksmith
v1.6.10 (2023-11-03)
- bugfix to use eonake gauntlet with correct hand
- bugfix for sewer rat sack
- support for coin bags
- add 'sling' to get_regex
- add check for Gtk gem
- fix typo in return_hands method
- add look messaging for modular neck sheath
v1.6.9 (2023-11-02)
- check mapdb and xmldata for trashcan searching fallback logic
v1.6.8 (2023-09-21)
- added support to sell when a box is in hand
v1.6.7 (2023-09-21)
- Bugfix for matching change in wealth output.
v1.6.6 (2023-09-10)
- bugfix to deposit silvers for ;eloot pool deposit.
v1.6.5 (2023-09-05)
- bugfix for the bugfix for calling deposit when nothing to do.
v1.6.4 (2023-09-05)
- bugfix for skinning routine not excluding from creature exclude list
- bugfix for calling deposit when nothing to do.
v1.6.3 (2023-08-24)
- update for dropping boxes (shattered only) to include both hands
- excluded shimmering orbs from sell list
- bugfix for excluding items
- added method to get script version from only one location
- misc variable adjustments in Data class
v1.6.2 (2023-08-14)
- added regex for GEF weapon retrieval
v1.6.1 (2023-08-03)
- extended support for fossil charm (ground coins)
v1.6.0 (2023-07-31)
- added support for fossil charm
v1.5.37 (2023-07-19)
- switched Lich::Util.silver_count for using 'wealth quiet'
v1.5.36 (2023-06-23)
- fix for assume lion to check for 25 mana if 650 already active
- fix for assume lion to check for proper cooldown number
v1.5.35 (2023-06-11)
- change to 650 implementation
v1.5.34 (2023-06-08)
- bugfix for looting coins in a box when encumbered
v1.5.33 (2023-06-04)
- prep for new Lich 5.7.0 infomon.lic change
v1.5.32 (2023-05-12)
- reworked method for cursed items to support eonake gauntlets
v1.5.31 (2023-04-12)
- bugfix for never loot section not working correctly with regex
v1.5.30 (2023-04-07)
- split drag method to wear and drag and added RT check for wearing containers after bulk sell.
v1.5.29 (2023-04-04)
- added regex for pirate harnesses
v1.5.28 (2023-03-30)
- bugfix for trashcans
v1.5.27 (2023-03-30)
- additional find_trash method changes to utilize meta:trashcan
v1.5.26 (2023-03-30)
- added "wastebin" to list of trashcans
v1.5.25 (2023-03-25)
- another try at finding the trashcan
v1.5.24 (2023-03-23)
- added additional trashcan identification if no room description available
v1.5.23 (2023-03-22)
- added open regex for container
v1.5.22 (2023-03-08)
- bugfix for updating setting on nil for Ruby v3
v1.5.21 (2023-03-06)
- bugfix for bag_loot method
v1.5.20 (2023-02-25)
- bugfix for scroll selling in setup
v1.5.19 (2023-02-22)
- added toggle for unlootable tracking
v1.5.18 (2023-02-07)
- added additional error checking for autoclose bags
v1.5.17 (2023-02-01)
- added support for Assume Aspect - Lion (650)
v1.5.16 (2023-01-31)
- added child to unlootable list
v1.5.15 (2023-01-30)
- bug fix for wait_for_disk method
v1.5.14 (2023-01-22)
- added support for plinite looting
v1.5.13 (2023-01-22)
- add RT check to retrieving weapon/shield after looting
- added support to not sell alchemy items: ;eloot sell alchemy_mode
v1.5.12 (2023-01-17)
- add check to prevent trying to loot something that's not yours
v1.5.11 (2023-01-13)
- add extra output to eloot test (disk and full containers)
v1.5.10 (2022-12-23)
- fixed location bug for locksmithing in KF
v1.5.9 (2022-12-05)
- added unlootable list to the UI (bottom of loot tab)
- bugfix for trying to put loot in full container
v1.5.8 (2022-12-05)
- added word boundary checks for container setup
- bug fix for phased box's
v1.5.7 (2022-11-27)
- removed custom quiet command to use Lich command instead
- fixed bug if encumbered at the locksmith and can't get the box out of the disk
- fixed bug for ice elemental looting
v1.5.6 (2022-11-11)
- added an "Always Loot" list
- added support for auto closing bags
- bug fix for handling reliquaries
- bug fix for skinning without a designated skinning tool
v1.5.5 (2022-11-03)
-bugfix for unlootable tracking
v1.5.4 (2022-11-01)
- bugfix for silver totals
v1.5.3 (2022-10-31)
- added check for unlootable items
v1.5.2 (2022-10-29)
- added muck and cloud to unlootable list
v1.5.1 (2022-10-28)
- bugfix for terminal-table silver breakdown
v1.5.0 (2022-10-09)
- removed dependancy on separate UI file and associated code
- cleaned up inventory & looting logic
- added support to always check the locksmith pool
- fixed bug that was looting cursed items in boxes
- added validation check for setup
- silver summary at end of selling using terminal-table
- archived change log before 1.4.0
- adds CLI interface to update settings
v1.4.22 (2022-09-25)
- bug fix for cursed items in boxes
v1.4.21 (2022-09-23)
- added support for hidden skin sheathes
- bug fix for crumbly bandit bandanas
- locksmith pool functionality added: over encumbered coin deposit and box drop off only option
- fixed bug in track_full_sacks default setting
- fixed bug when trying to do initial load when in RT
- added small delay to ;eloot start
v1.4.20
- bug fix for cursed items and some crumbly ones
v1.4.19
- fixed looting logic when its flagged as two items with one not wanted (eg. uncommon & clothing). It will pick up the item to prevent valuable items getting left behind
- additional error checking for empty box's in containers
- additional error checking for looting
- added support to use left hand for looting
- added support for users who don't sell with eloot (full container tracking)
- added secondary overflow container
- moved UI check only when loading or setup
v1.4.18
- follow-up typo fix for default crumbly list
v1.4.17
- add rough leather quiver to the default crumbly items
v1.4.16 (2022-08-23)
- fixed typo in overflow setting
v1.4.15 (2022-08-23)
- changed regex for scabbards again
v1.4.14 (2022-08-19)
- will sell bounty items in original town if selling in FWI
- added regex for custom scabbard
- reworked data loading, should be faster now
- changed the container identification to skip non-worn containers (helps with getting the correct skinning sheath)
v1.4.13
- empty gold, silver, mithril boxes if selling them
- fixed trying to loot gangplank
- fix for stancing with verbose turned on
v1.4.12
- fixed duplicate container saving
- fixed bug in box looting that wasn't recognizing box found armor/weapons
v1.4.11 (2022-08-02)
- added support for looting coins on the ground
v1.4.10 (2022-07-28)
- more edits for locksmithpool not recognizing worker
v1.4.9 (2022-07-28)
- another edit to the locksmith pool
v1.4.8 (2022-07-20)
- close sacks function had a bug preventing it from working
- additional changes for the load delay in locksmith pool
v1.4.7 (2022-07-09)
- fix for object load delay in locksmith pool
v1.4.6 (2022-07-09)
- added option to deposit coins/notes without sell routine
- fixed bug in empty box selling causing it to duplicate
v1.4.5
- performance improvement in selling and storing items
- added logic to address having a box in hand at start of sell routine.
- added support to loot a box in hand then exit - ;eloot box
v1.4.4
- added skin matching for alchemically ruined skins
v1.4.3
- added support for skinning rotting chimera's when they have scorpion tails
v1.4.2 (2022-06-15)
- bug fix in blunt skinning
v1.4.1 (2022-06-15)
- bug fix for disks
v1.4.0 (2022-06-10)
- added support for shroud and glamour
- added check in valid loot routine to exclude disks
</div>

==Reference==

{{Third-Party Software}}

Lich:Script Bigshot/Changelog

2026-01-09T15:04:15Z

HORIBU1: /* Change Log */ update to 5.11.0

{{3rd-party}}
== Change Log ==

<pre{{log2|background=none|border=none|margin-left=none|margin-right=none|font-size=93%}}>
v5.11.0 (2025-11-29)
- add support for boon creatures
- add toggle to stop for dead group members
- refactor find_routine, ma_looter, check_mind, ready_to_hunt?, and ready_to_rest?
- removed gather_ammo (no longer used since archery update)
- reworked debug process
- refactor attack loop for followers
- only call group open call if grouped
- refactor escape from oozes, crawlers, and roa'ters
- removed voln_favor method for Lich::Resources.voln_favor
- update default fried to be 100 and removed value check
- refactor sort_npcs so if valid targets is left blank it targets everything
- removed target check from check_required_values
v5.10.0 (2025-10-31)
- update BSAreaRooms
- fix MA so leader has group open
- tighten follower loop
- MA lead can identify expected group number at startup eg ;bigshot head 3
- head/tail can now be started in any order
- removed old companion_check method
- bugfix when using negative mana value in cmd_spell
- refactor group class
- bugfix for bigclaim when follower is hidden
- update cmd sleep to not change stance
- add command for valid creatures similiar to mob
- bugfix in disarm if target has no weapon
- add gemstone support
v5.9.13 (2025-10-27)
- fix for dhurl command to respect ambush settings and additional messaging
v5.9.12 (2025-10-24)
- bugfix for stance dancing for unarmed and force being respected with AND commands
v5.9.11 (2025-10-11)
- bugfix for encumbrance command check
v5.9.10 (2025-10-03)
- bugfix in cmd_spell targetting to send proper gameobj ID# string
v5.9.9 (2025-10-02)
- add missing $rest_reasons
v5.9.8 (2025-09-30)
- bugfix for cmd_rapid to use cooldown instead of penalty check
v5.9.7 (2025-09-30)
- bugfix when Spell[597].active? in cast_signs
v5.9.6 (2025-09-09)
- add support for 902 and 411 (doesn't work with UAC)
- remove custom issue_command for Lich method
- added cast_spell method
- updated Society Abilities/Spells/CMan section to ignore rapidfire cool down: 515 (ignore) or rapidfire (ignore)
v5.9.5 (2025-07-22)
- remove companion_check calls as no longer needed with migration to GameObj.targets for valid creatures
- add check_disks param to bigclaim? method
- add claim check to attack_break and need_to_loot (ignoring disk check)
- add coupdegrace buff check and command check
- increase bs_move timeout from 2 to 5
v5.9.4 (2025-07-08)
- bugfix for leader final loot to only work if claim is true
v5.9.3 (2025-07-02)
- bugfix for shield bash if using CMan instead of shield
- bugfix for FORCE cmd to stop checking older lines if it found a proper attack messaging but failed the match
- bugfix for cmd_tether to end if link is broken
v5.9.2 (2025-06-30)
- bugfix in cmd_tether potential npc logic
v5.9.1 (2025-06-27)
- Fix for head/tails bs_wander groupcheck logic
v5.9.0 (2025-04-03)
- Convert over to use Group and Claim modules from core Lich5
- bugfix in cmd_assaults for confusion
- add additional logic to cmd_unravel for creature gone/dead
- bugfix in bs_put for bleedthru numbers merged with wait time (EXP output: Level: 100...wait 1 seconds.)
- bugfix in creeping_dread typo name
- attempts as head to pull tail members to feet if not standing prior to returning to resting
- adds cmd_depress for 1015/Song of Depression usage
- adds cmd_phase for 704/Phase to purpose prep/cast with NPC as target due to special use of changing non-corp to corp undead
- adds final room loot option for leader in head/tail
- add disarm weapon to cmd_cman
- bugfix break PSM loop early if not affordable after wait messaging
- cleanup class detection logic to use is_a? logic instead
- bugfix in cmd_force to search newest msg to oldest via reget reversing
- add Feat support for Chastise & Excoriate
- add Righteous Rebuke command check (rebuke)
- add Ardor of the Scourge command check (scourge)
- add Glorious Momentum command check (momentum)
- fix depart monitor to use ewaggle instead of waggle
- fix clean value setting for rest_till_exp & rest_till_mana
v5.8.5 (2025-03-28)
- bugfix for follower resting commands use running a script
- add cooldown detection to cmd_spell and 140/919/211/215/219/1619/1650
v5.8.4 (2025-03-19)
- remove deprecated calls
v5.8.3 (2025-03-10)
- bugfix in run_script to use exact naming of script that was started
v5.8.2 (2025-02-26)
- bugfix in run_script needing EXACT match for Script.running? check. Script.start is not exact. Causing issues
- bugfix in command_check split_check
v5.8.1 (2025-02-26)
- add garrote command to buffXX command check validity for Enh. Agility buff
- add garrote command check for active buff check
- cleanup command check regex to simplify
v5.8.0 (2025-02-20)
- add custom fog option
- option to force resting if looting leaves a box in your hand
- enable pre-rest commands to call scripts eg. script go2 place
- bugfix in tether command
- add ancient & !ancient command checks for grizzled/ancient creatures
- add animate & !animate command checks for if you have an animate present or not
- change command_checks to lamdas for optimization
v5.7.10 (2025-02-18)
- add option for cmd_tether to recast upon death and transfer of dots
v5.7.9 (2025-02-15)
- fix stand() to not stand if casting 608 and kneeling with a crossbow in hand
v5.7.8 (2025-02-11)
- update $bigshot_status to utilize :ready instead of :hunting when clear to hunt
- update $bigshot_status to :hunting when arrived in do_hunt() and actually starts hunting
v5.7.7 (2025-02-10)
- bugfix in cmd_curse due to custom prep/curse logic
v5.7.6 (2025-02-08)
- bugfix where claims was including characters disk
v5.7.5 (2025-01-30)
- bugfix in resting method for fog_return
v5.7.4 (2025-01-22)
- adjust loop delay for efury and tether
v5.7.3 (2025-01-20)
- added command tether to have spell 706 wait until completion
- update to efury command
- fix for constant redefinition Ruby warnings
v5.7.2 (2025-01-15)
- added implosion(720) cooldown
- added check for voidwalker buff from 720
v5.7.1 (2025-01-13)
- added client input into debug file
v5.7.0 (2025-01-12)
- added debug logging to file
v5.6.11 (2025-01-02)
- added cmd_rapid for rapidfire/515 usage
- added rapid/!rapid command check for current rapidfire buff
- bugfix for room claim with disks if SET DESCRIPTION is off
v5.6.10 (2024-12-22)
- added optional stand-up stance selection
- bugfix for surge in cmd_surge and command_check
- bugfix for burst in command_check
v5.6.9 (2024-12-09)
- bugfix for group members in room claim
- bugfix for weapon reactions to be done in @HUNTING_STANCE
v5.6.8 (2024-12-06)
- additional regex for rooted debuff
- bugfix for leader waiting to regroup during rest cycle
v5.6.7 (2024-12-06)
- bugfix for follower not attacking
- add cmd_wandolier (using fresh wand container and wand name)
v5.6.6 (2024-12-02)
- typo in load_settings: 'maxstamina' should be maxstamina
v5.6.5 (2024-11-23)
- added test method, usage: ;bigshot test <method> <arg1> <arg2> etc.
- added ;bigshot list to display initialized values
- bugfix for out of mana default not an integer
- update to check_required_values
- update to load_settings
- bugfix to allow follower to sit when resting
- bugfix updating spin button settings
- $rest_reason wasn't being reset before next hunt
- bugfix in profile sorting
- bugfix for leader to wait for wounded follower
- bugfix unnecessary groupcheck in pre_hunt method
v5.6.4 (2024-11-18)
- bugfix for ready_to_hunt stamina check when set to 100
v5.6.3 (2024-11-14)
- bugfix for the command check when rooted
v5.6.2 (2024-11-13
- prevent UAC from trying to kick when rooted
v5.6.1 (2024-11-13)
- bugfix in bandit tracking
- bugfix in loot() method
- add msg in class BSAreaRooms if open boundary
v5.6.0 (2024-09-11)
- new room claim process inspired by ;overwatch and Lich::Claim
- additional targeting for bandits
- bugfix on confusion status to confused
v5.5.0 (2024-08-24)
- rework of debug messaging
- removed duplicate calls to methods
- once command update for force
- updated check_required_values for integer Use
- set defaults for integer settings
- support for worn items with wield command
v5.4.5 (2024-08-20)
- update spinButton to save properly when manually entered
v5.4.4 (2024-08-19)
- remove unused GUI elements
v5.4.3 (2024-08-19)
- updated wander wait to a spin button
- bugfix for missing id on lte_boost
- update OOM spin button to allow for negatives
- updated OOM check for negative values
v5.4.2 (2024-08-17)
- bugfix in cmd_spell to set Spell's @@after_stance to prevent forced stance dancing when hunting_stance is offensive
v5.4.1 (2024-08-14)
- room command check logic correction
v5.4.0 (2024-08-07)
- UI updates
- Notes section added on profiles tab
- percent_stamina added as a should_hunt? parameter
- wander stance added
v5.3.17 (2024-08-05)
- added 506/celerity check
- fix for hunt_monitor not working for followers
v5.3.16 (2024-08-04)
- fix for ROOM being missed in command_check regex
v5.3.15 (2024-07-25)
- add ROOM command check, Performs the command a single time only per room, clears on room change
v5.3.14 (2024-07-24)
- bugfix for reset_variables
v5.3.13 (2024-07-19)
- bugfix for head/tail random looting
- bugfix for smite tracking in a group
v5.3.12 (2024-07-13)
- update profile_current and save_profile_name when using CLI profile load/save
- bugfix ready_to_rest? should_rest lambda logic
v5.3.11 (2024-06-20)
- fix to break from cmd_assault command on cooldown if loop repeated
v5.3.10 (2024-06-15)
- added support for Seanette's Shout in Society/Abilities/Spells/Cmans section of the hunting tab
v5.3.9 (2024-05-29)
- add additional missing cmd_assault regex matching
v5.3.8 (2024-05-18)
- remove superfluous check for escorts, not needed since they are not valid targets
v5.3.7 (2024-05-01)
- fix for Char.prof/Char.level to Stats.prof/Stats.level
v5.3.6 (2024-04-28)
- add additional custom disk noun
v5.3.5 (2024-04-24)
- handle all the new custom disk nouns
v5.3.4 (2024-03-29)
- fix to add Tangle Weed (610) status of "entangled" to the PRONE regex
- fix for kweed command to use EVOKE instead of stancing
v5.3.3 (2024-03-15)
- fix for cmd_briar to use MEASURE instead of LOOK due to gamefeed issue with extended show descriptions
- fix for cmd_briar to support UCS worn gear and two weapon combat
v5.3.2 (2024-03-12)
- bugfix in check_required_values
v5.3.1 (2024-03-11)
- bugfix for UIDs in boundary rooms and new boundary return outside of hunting area feature
- added cmd_curse command for Sorcerer spell Curse 715
- added cmd_store command to store left, right or both, but only if something is in those hands
v5.3.0 (2023-11-29)
- added boundary return if character ends up outside hunting area
- added option to double cast on fog options when returning from the Rift
- added support for warcry holler buff
- fixed bug in stand method when command is an array
- fixed command to standardize to downcase
- fixed bug in head/tail looting where the leader wasn't waiting for the follower to loot
- removed $bigshot_briar in favor of Spell[9105]
- added toggle to check for favor before using voln symbol on hunting tab
- expanded need_to_loot method for 1108 kills
- added escape for temporal rift
- added eachtarget command that attacks each creature in the room eg. (eachtarget force incant 917 until 101 (once), incant 903 (x10))
- removed change log comments before 5.0.0 and updated wiki
v5.2.2 (2023-11-21)
- bugfix causing bs_wander to delay 0.5 seconds longer than needed
- added Roa'ter and Ooze escape check in bs_wander
v5.2.1 (2023-11-15)
- add new efury, caststop, and wield cmd
- redo unravel/barddispel cmd
v5.2.0 (2023-10-02)
- general adjustment to group hunting
- additions to group looting for exclude individuals as well as allowing for changing looter based on encumbrance
- changes to try and prevent leaving stray bandits
- update to prevent targeting 709 arms
- allows multiple rally rooms just separate with commas
- added multiple return room waypoints
- added support for ranger tracking. Usage ;bigshot <options> <creature> example: ;bigshot single giant rat
v5.1.10 (2023-09-28)
- bugfix for ;bigshot quick occassionally stopping when another character enters the room
- changed BIGSHOT_VERSION variable to pull version from title block
- bugfix for display output
v5.1.9 (2023-09-24)
- fix to debug variable being hard set at launch to false.
- add CLI debug option to toggle debug value between true/false.
v5.1.8 (2023-09-18)
- add acid & steam to incant 518 allowances in cmd_spell
v5.1.7 (2023-09-16)
- bugfix wracking not considering active COL signs
- added RT check for wand method
v5.1.6 (2023-09-12)
- bugfix for cmd_force when target has 115
v5.1.5 (2023-08-30)
- bugfix for calling escape_rooms for tail
v5.1.4 (2023-08-30)
- bugfix for Roa'ter and Ooze escape for head/tail
v5.1.3 (2023-08-26)
- add 335/Divine Wrath cooldown check in cmd_spell to not cast
- change cmd_spell to use Spell.force_incant for incanted spells instead of bs_put
v5.1.2 (2023-08-21)
- fix incorrect regex match for mighty blow
v5.1.1 (2023-08-14)
- fix missing regex match for censer command check
v5.1.0 (2023-08-07)
- add ooze_escape for getting out of Ooze, Innards in HW.
v5.0.0 (2023-7-19)
- move method spell_is_selfcast? inside Bigshot class
- corrected deadmans typo
- moved Setup class outside main Bigshot block
- renamed various methods to snake case
- removed changlog notes older than 4.17.0 and updated changelog on wiki
- bugfix for bearhug complete_regex and in the command check
- retry RT commands for warrior and rogue guild cmans
- added rooted to status check
- bugfix in check_target_vitals
- bugfix in cast_signs undefined method `=~' for false:FalseClass
v4.17.6 (2023-07-11)
- will perform one final loot call if OOM, bounty complete, dread, or fried before resting
- bugfix in cast signs for KS+Mental Acuity Monk
v4.17.5 (2023-07-05)
- Added support for MA hunting single loop
v4.17.4 (2023-06-29)
- Expanded UCS followup attack tracking to work with PSM attacks.
- Added UCS tier command checks tier3, !tier3, ect.
v4.17.3 (2023-06-24)
- Added support for sneaking while hunting.
v4.17.2 (2023-06-21)
- Added missing regex for fury completion.
v4.17.1 (2023-06-13)
- Reconfigure assume aspect
- Removed check that could cause nerves to get blown.
- Added cman ki focus
v4.17.0 (2023-06-04)
- Skip infomon.lic check if on newer Lich versions
v4.16.3 (2023-05-20)
- Update for groupcheck to strip XML from $grouplist
v4.16.2 (2023-05-19)
- Update for GROUP output display
v4.16.1 (2023-05-16)
- Add burst of swiftness
v4.16.0 (2023-04-06)
- Add bard command unravel to dispel and stop
- Add bard command barddispel to dispel single spell from target
- Add once command check to perform a command one time on a specific target only. Resets on room change.
- bugfix for barrange and using bolts
v4.15.6 (2023-04-04)
- Add cman sbash to cmans as was missing
v4.15.5 (2023-03-15)
- Rubocop cleanup
- replace script.vars with Script.current.vars
v4.15.4 (2023-03-13)
- add additional missing 709 arms to exclude for NPCs check
v4.15.3 (2023-03-02)
- bugfix for cmd_shields
v4.15.2 (2023-03-01)
- bugfix to allow cmd_weapons to work if using more than base Mnemonic
- bugfix to allow cmd_shields to work if using more than base Mnemonic
- bugfix to allow cmd_cmans to work if using more than base Mnemonic
- bugfix to allow cmd_bearhug to work if using more than base Mnemonic
- bugfix to allow cmd_rogue_cmans to work if using more than base Mnemonic
v4.15.1 (2023-02-18)
- initial bugfix(s) for Ruby 3.x compliance
- fix for exiting cmd_force if command check fails on cmd
v4.15.0 (2023-02-18)
- add tonis/1035 command
- bugfix to not try to pull dead people up
v4.14.8 (2023-02-11)
- moved bounty check to after looting to avoid excessive game feed
v4.14.7 (2023-02-09)
- added missing room claim check
v4.14.6 (2023-02-06)
- fix head/tail issues with claim
- cleaned up also here detection
- cleaned up cast_signs to not spam song status for bards
v4.14.5 (2023-02-03)
- regex fix for hunt monitor claim_room
- fix in bs_wander method for 'approach lone target only'
v4.14.4 (2023-02-02)
- fix second target aquisition to use valid_targets?
- fix odd issue that would cause you to loot existing corpses in specific scenarios.
v4.14.3 (2023-02-01)
- fixed bigshot quick group room claim
- fixed regex to prevent attacks from removing people from claim
v4.14.2 (2023-01-31)
- updates to room claim system ;e UserVars.show_claim = true/false to echo when room is claimed.
v4.14.1 (2023-01-28)
- bugfix for GTK display if old settings contained integer for certain fields
- bugfix to allow cmd_assault to work if using more than Mnemonic (ie fury punch)
- add new regex result for cmd_cmans for sattack
- remove spam/unspam as waitrt?/waitcastrt? updated in Lich5 to be faster by default
v4.14.0 (2023-01-25)
- add new slayer command for 240
- fix for wander_wait to use should_flee?
v4.13.18 (2023-01-24)
- introduced room claim system to prevent poaching.
v4.13.17 (2023-01-23)
- move wander_wait to prevent poaching
v4.13.16 (2023-01-21)
- added support to rest for debuffs: Wall of Thorn Poison, Confusion, Creeping Dread, and Crushing Dread
v4.13.15 (2023-01-12)
- Add 1650 cooldown check for cast_signs
v4.13.14 (2023-01-12)
- add bounty check while resting and in bounty mode
v4.13.13 (2022-12-03)
- add bounty check while resting and in bounty mode
v4.13.12 (2022-12-01)
- reset bounty_eval when bounty complete
v4.13.11
- bounty mode will only exit if bounty is complete or child present
v4.13.10 (2022-11-30)
- bug fix for comparison of bonded weapon return
v4.13.9 (2022-11-30)
- bug fix for extra kills not being in monsterbold
v4.13.8 (2022-11-18)
- convert directory lookups to File.join to prevent OS pathname issues
- bug fix for poaching on rally_point and starting room
- bug fix for cmd_assume
- fix for cmd_hide using bs_put instead of fput
- bug fix to create UserVars.op on first run
- remove message() override color and update calls to use yellow to retain previous coloring
v4.13.7 (2022-11-14)
- bugfix for overkill hunting
v4.13.6 (2022-11-10)
- rearranged command tab for clarity
- removed profile checkboxes for ebounty, not needed
- added bounty_eval to support bounty mode and ebounty completion
v4.13.5 (2022-11-7)
- bug fix for MA looter
v4.13.4 (2022-11-7)
- bug fix for split, buff, and other checks
v4.13.3 (2022-11-7)
- bug fix for censure command
v4.13.2 (2022-11-5)
- added support to designate a looter for head/tail operations: See Misc tab
- added check for ...wait issue on routines
- reorganized the commands a little more to help with troubleshooting
v4.13.1 (2022-11-03)
Typo fixes in cman regex
v4.13.0 (2022-11-03)
Added profile support to UI
***************************
Changed file save location
/scripts/bigshot_profiles to Lich5/data/GSIV/<charname>/bigshot_profiles.
Lich5/data/GSIV/Rinualdo/bigshot_profiles as an example.
Existing profiles will need to be resaved or migrated over.
***************************
Added standard Lich messaging functionality
Reorganized UI menu and locations
Code cleanup.
Support for future (RSN) ebounty script
Fix to allow 640 blocked attacks to work for wait_for_attack
Fix to only account for renewal mana if bard and have renewal costs
Support for uid's for hunting and resting
Fix for percent_mind to more accurately gauge current mind full status
v4.12.12 (2022-10-28)
Fix for waitcastrt? before commands unless command can be executed during castrt
Fix for quickhunt targets when given an attack routine
v4.12.11 (2022-09-18)
Fixed calls to kill hunting scripts started with args
v4.12.10 (2022-08-21)
Added tumbleweed to list of tangleweed nouns
v4.12.9 (2022-08-08)
Bugfix for 9625/burst of swiftness
v4.12.8 (2022-08-07)
Added support for Burst of Swiftness. 9625 in society box.
Added kneeling command check (k) (!k)
Will no longer attempt to stand when hidden and kneeling.
v4.12.7 (2022-07-27)
Added checkbox to opt out of mstrike on unarmed combat.
v4.12.6 (2022-07-24)
Gave frozen it's own command check
Expanded support for dislodge firing only on specific locations.
Commented out ammo gathering.
v4.12.5 (2022-07-21)
Fixed shield bash to work for both shield and cman skills.
1040 now has a checkbox to auto shout if you or group member could benefit.
Will no longer pull kneeling people to their feet.
Will no longer attempt to pull the dead to their feet.
v4.12.4 (2022-07-01)
Add command check for tailwind.
Fixed briar command with briar weapon in off hand of twc.
Fixed bigshot quick standing around waiting for mana.
v4.12.3 (2022-07-01)
Add check to deadman's switch to only work in Shattered.
v4.12.2 (2022-06-08)
Add checks for Divergence cooldown spells for hunting tab abilities/spells/cmans
Changed boon detection to look at gameobj-data.xml TYPE instead of hardcoded name adjective check
v4.12.1 (2022-06-01)
Add SSR to force results check
Add additional weed/kweed for Tangle Weed 610
Adjusted hunt logic to prevent fleeing when someone enters.
v4.12.0 (2022-05-24)
Update various GameObj.npcs to use GameObj.targets
Add familiar gate(930) as a fog option
Add cmd_leech to cast Mana Leech/516
Fix for spell cleave cman to not attempt if on cooldown
v4.11.4 (2022-05-20)
Fix for cmd_ambush to switch to attack if not hidden
Update flee_message tooltip to state uses XML feed not plain text
v4.11.3 (2022-05-01)
Fixed dhurl with the new aim messaging
Adjusted location of waitrt in command checks
Changed do_hunt() to use no_players() instead of no_players_hunt() to prevent poaching in first room of the hunt.
v4.11.2 (2022-04-29)
Added a waitrt? to cmd_spell routine.
v4.11.1 (2022-04-23)
Fixed bug with cast_signs() assuming bards are always singing.
Cleaned up RoaterEscape(), it will now open containers to look for dagger type weapon.
Roater's and Rift Crawlers are pretty much identical in this aspect. No changes needed to work for both.
Added waitrt? to command checks to prevent check from clearing while in rt from previous move.
v4.11.0 (2022-04-15)
Adjusted hide to specify number of attempts to try and hide if failing: hide 2
Added Swift Justice tracking command check: (justice) (!justice) to use skill when swift justice has charges or has no charges.
v4.10.1 (2022-04-04)
Update consecrate to not return from hunt if blessing a sanctified weapon
v4.10.0 (2022-04-02)
Fixed pummel buff check from crushing blows to concussive blows.
Added stomp command for Tremors.
v4.9.0 (2022-03-24)
Added support for briar weapons. Will check for buff and check status of weapons charge.
Added support for assume aspect. Will alternate between aspects or evoke for one aspect.
Added support for cman stance perfection. Put 10,20,30,ect in attack stance box.
Fixed dhurl command knowing weapon auto returned from bond.
v4.8.7 (2022-03-12)
Fixed mstrike cooldown and debuff checks.
Added Barkskin cooldown support. Add 605 to your society abilities box.
Added song renewal mana cost check to cast_signs()
Fix for animated slushes registering as animates
Added (censer) command check to attempt a 320 before the command.
Added hurl command. Will hurl and recover item.
Fix familiar check to not cause familiar to return
v4.8.6 (2022-03-10)
Fixed conflict with 1040 and warcry shout. Simply '1040' to use 1040 not shout 1040.
Fixed missing msg from bullrush and forced prone check for bullrush/twin weapon.
Update for disk detection of group members
v4.8.5 (2022-03-10)
Added attempt mana pulse on 130 fog option if not enough mana
v4.8.4 (2022-03-08)
Fixed 9605 in society box, integrated surge in hunting commands.
Added command switch to refresh buffs based on duration.
v4.8.3 (2022-03-08)
Fixed global variable call for standing
v4.8.2 (2022-03-08)
Added version check for Infomon due to new Effects/Cmans
v4.8.1 (2022-03-08)
Added version check for Lich due to new Effects/Cmans
v4.8.0 (2022-03-07)
Integrated weapon/shield/cman skills and warcries.
barrage(!barrage) will only barrage if you don't have the buff
bellow all, will aoe bellow vs bellow target, will single target bellow
v4.7.7 (2022-03-02)
Add option to Stop for Deaders on Hunting tab
When enabled, bigshot will PAUSE when it encounters a dead player
v4.7.6 (2022-03-02)
Updated Fog options to include Sigil of Escape
v4.7.5 (2022-02-02)
Updated needs bless logic to to remove false positives (most cases)
v4.7.4 (2022-01-29)
Updated target logic to ignore sorcerer animates.
Updated loot subroutine to flag looting active - prevent BS from forcing stand
v4.7.3 (2022-01-25)
Updated bless routines to current text and provide option to continue hunt.
Disabled default startup sound value. Uncomment print "\a" unless $bigshot_quick if function is desired.
v4.7.2 (2021-12-14)
Updated GTK version detection for proper display in dark-mode
v4.7.1 (2021-12-12)
Adding bigshot single run mode accessed via ;bigshot single
v4.7.0 (2021-08-11)
-Updated group and event namespace to prevent future conflicts
-Consolidated Changelog and updated it on the GS wiki
v4.6.0 (2021-08-06)
-Separated bigshot_monitor to only run while hunting (to resolve lag in very active rooms)
-Added initial automatic weapon reactions
v4.5.0 (2021-06-25)
-Add fog only if encumbered or injured checkbox
v4.4.0 (2021-06-25)
-Add flee from voids option to general tab
v4.3.4 (2021-05-29)
-Updated UAC mstrike to always use tier3 for auto-tiering
v4.3.3 (2021-05-12)
-Revise GTK3 check to be more compatible with older versions of GTK that don't support Gtk::Version calls
v4.3.2 (2021-05-02)
-Updated Etheral Censer to be used in signs based on the cooldown refreshes
v4.3.1 (2021-04-30)
-Added regex for stance changing when using STANCE VERBOSE
v4.3.0 (2021-04-13)
-Add flee from boon/boss/glamour mobs checkbox on attacking tab
v4.2.4 (2021-03-02)
-Fix cast roundtime regex match for chan
v4.2.3 (2021-02-10)
-Fixes cman's to be usable with the force until option.
v4.2.2 (2021-01-19)
-Fix for certain values getting set when opening GUI, overwriting own settings
v4.2.1 (2021-01-12)
-Fixed stand() def to not stand if xbow kneel/fire
-Update buffer check for SMR result txt
v4.2.0 (2021-01-03)
-Removed 1617 from forced stance change
-Added customizable interaction monitoring panel
v4.1.1 (2020-12-31)
-Added cleanup from selfcast check in bigshot PR #374
-Included v3.93 updates
-Added loot room option when no loot script is defined
-Migrated v3 changelog to gswiki
-Updated Version Control
v4.1 (2020-12-31)
-Added GTK2/GTK3 dual logic for compatability
v4.0 (2020-08-13)
-Fix for ambush (Head/Neck/Eyes), no longer get stuck ambushing a head/neck over and over
-Archery Updates
Change aim location based on target actual status
BUGFIX:Aiming should now actually function as intended when switching targets
--TODO!Crossbows should now work with Bigshot, see pre-fire commands for details
-Group logic changes
Followers can now stay in the resting area and wait to run scripts/commands until leader is done
To do this, have the leader disband before running their scripts. With quiet followers selected
Followers attempt to not execute scripts/actions until the leader is in the rest area with them (regardless of disband)
Quiet Followers can be toggled off (not recommended)
Followers will now wait to cast signs until hunt is about to begin
Leader will no longer begin hunt until all followers are present and ready to go
--TODO!Leader will wait at rallypoint for entire group to arrive before moving to hunt starting room
If this feature is selected, the leader will not wait to hunt when at hunt starting room after rallypoint check
BUGFIX:Fix for fatal recursion cause by obvious hiding players
--TODO!Group should move more intelligently when seeking leader if group is broken
BUGFIX:Group will now be more responsive to commands
-Major UCS updates
BUGFIX:Will now use Tier 3 attack when tiered up to 3 and no follow up available for everything, not just jab
BUGFIX:Updates to UCS Mstrike, should no longer do open mstrikes when at or below threshhold instead of targetted mstrike
UCS mstrike threshold merged with MStrike tab threshold
--Still to be done: Per creature tier ups
-Bigshot now has the ability to turn some individual checks on and off
Functionality allows for custom hunting scripts to be built using Bigshot logic
Added ability to send custom "fput" to Group
Added ability to send custom "client_put" to Group
v3.92 (2020-07-08)
-Added LTE support for followers, overkill support for followers, & fried hunting commands for followers
v3.91 (2020-06-16)
-Added longterm boost usage option
v3.90 (2020-05-19)
-Minor fix to add a delay to 130/sym of return/1020 return option case in RT
v3.89 (2020-03-28)
-Crude fix for archery update, BLANK out your ammo & ammo container setting to NOT attempt to get ammo any longer
v3.88 (2020-03-28)
-Fixed a bug with obvious_hiding_player detection (Probably, at least)
-Fixed a bug with poaching when other players are present
-Cleaned out changelog history after updating wiki
-Re-organized global variables and requires statements (alphabetized)
-Added a sleep between resting_commands and hunting_prep_commands to prevent issues
-Replaced all pause commands with sleep
-Updated all sleep commands to follow proper syntax
v3.87 (2020-19-11)
-Added overkill counter for extra killed monsters
-Tooltip updates
-Formatting changes to make script more easily read
v3.86 (2020-03-11)
-Added outside & !outside command checks
v3.85 (2020-02-28)
-Resolved `block in setup` error when running setup in Fedora
v3.84 (2020-02-15)
-Fix a bug with "obvious hiding" players detection
v3.83 (2020-02-13)
-Added check for "obvious hiding" players (SET ObviousHiding ON)
v3.82 (2020-02-02)
-Added a v & !v command checks for checking spirit
-Possible fix for FOG_RETURN not loading when doing ;bigshot setup properly
-Added ;bigshot profile support
;bigshot profile load <name here, no spaces>
;bigshot profile save <name here, no spaces>
Allows saving of bigshot profiles as YAML files, saved in your LICH\scripts\bigshot_profiles folder
v3.81 (2019-09-06)
-Fix for wands with extra descriptors in hand vs grab name
-Add 1020 as an option for fleeing
v3.80 (2019-08-01)
-Exit cleanly from bounty mode
-Don't count regenerating troll kings when deciding if there's enough enemies to flee
-Treat intense shimmering circles like clouds when deciding to flee
-Don't require Gtk if $bigshot_headless is defined
v3.79 (2019-05-25)
-Removed 309 from hardcoded selfcast list
v3.78 (2019-05-10)
-Missed a few settings for flying
v3.77 (2019-05-10)
-Added flying/!flying as command checks for attacks
v3.76 (2018-07-04)
-Fixed INCANT command to respect Spell.stance setting
v3.75 (2018-07-02)
-Fix ;bigshot bounty
-Don't flee from your own group even if they're not hunting
v3.74 (2018-04-30)
-Added water as option for cmd_spell extra variable
v3.73 (2018-04-22)
-Add flee from webs option
-Add 917 to not stance offensive if using incant
v3.72 (2017-10-10)
-Fix bug in berserk
v3.71 (2017-10-08)
-Attack line now recognizes "wand" by itself
-Fix GameObjAdd autostart
v3.70 (2017-09-28)
-Fix download loop of GameObjAdd.lic
v3.69 (2016-09-20)
-Wont stance offensive for the spell 703 anymore
-Fixes for delayed looting
-option to pull players to there feet, Defaults to on
-Only pulls the player to there feet if their is an aggressive npc in the room with them
v3.68 (2016-09-14)
-option to stance defensive before looting if not all the creatures in room are dead
-wracking option now will use "Symbol of Mana" for voln peoples :)
-Performs the bless routine if needed when you wander or go to rest now
-Added a delayed looting option
-skips looting when creature still alive in the room or its been less than 15 seconds since the last creature died
-Will now try to escape from the inside of a roa'ter if you get swallowed
v3.67 (2016-08-31)
-Optimization for priority checks, wont run that section of code so often anymore.
-Manual aiming for unarmed combat routine. Command is "unarmed <punch/kick/grapple/jab> <aim location>"
-Will swap to the default aiming when you can't reach what your aiming at or its already missing.
v3.66 (2016-08-29)
-Only checks for group members if there are other pcs in the room
-Won't loot in the Duskruin Arena anymore
v3.65 (2016-08-28)
-Fixes for targeting, fleeing, and priority targeting
-This should let bigshot work in the duskruin arena
v3.64 (2016-08-23)
-Changed Celerity option to only recast if you have less than 3 seconds left
-Changed so it doesn't change into your attacking stance before casting
-Changed Fog return option to be an option pulldown instead of a checkbox, defaults to None
v3.63 (2016-08-23)
-Added option to use Celerity (506) for any command.
-Will cast if you dont have it on you or you have less than 6 seconds or so left on haste.
-Just add haste or 506 to the front of any command you want it to be cast before.
-example: "506 kill target" or "haste kill target(x3),525(pcs)"
v3.62 (2016-08-23)
-UAC Mstrike no longer will ignore the number of creatures in the room in some instances.
-Option to flee the room when player-defined message from the game happen
-Check the Attacking tab for box to input your text
-Fixed issue with bigshot not targeting "do not count these" targets
-Fixed issue with force command until # not working correctly
v3.61 (2016-08-15)
-Fix for new fogging option triggering at weird times.
v3.60 (2016-08-15)
-Fix for ;bigshot quick not working correctly when you dont have any quickhunt targets.
-Option to use Spirit Guide (130) or Voln Symbol of Return when going to rest. Option is on Rest Tab.
v3.59 (2016-08-13)
-To prevent me having to duplicate code, Bigshot will now download GameObjAdd.lic and make it autostart
-Spells should no longer target npcs when they are meant to target you. Let me know if something happens otherwise.
v3.58 (2016-08-07)
-companions and familiars should now be excluded from fleeing and targeting stuff
-companions and familiars count for poaching checks now just like a disk does
-this check only works for solo hunters, group bigshot hunters will ignore this
-Ambushers that are part of your group should no longer trigger the poaching routine
-Bigshot will on first run for a Ranger with a companion set your companion to a variable.
-You can reset this variable with ;bigshot ranger or ;bigshot companion
v3.57 (2016-08-04)
-Bigshot won't consider arms(709) and demons(725) as room creatures for targeting or fleeing purposes
-Priority should now ignore some NPCs when it does its calculations
v3.56 (2016-08-02)
-Think I have all the Reim mobs handled
-Fix for Multi-account hunting...oops
-other minor tweaks
v3.55 (2016-07-31)
-Target tracking for Aura of the Arkati (1614). Wont cast again on something that is affected.
-More Reim creatures added, Still missing creatures from the gypsy camp probably, celestial types
-New Command check: noncorporeal - Will see if current creature is non-corporeal undead
-New Command check: pcs - Will check for other non-grouped players in the room
v3.54 (2016-07-30)
-REIM! Quick update for some support for reim creatures
-Smite tracks individual mobs now, So if you switch creatures before killing it, will smite the new one
-Fixed the lag issue
v3.53 (2016-07-29)
-Incant should now work for any incant combination
-Bless can now bless two weapons that lose bless in same attack
v3.52 (2016-07-27)
-Changed variable tracking to be downstream hook instead of exec script
-Please let me know if anything doesn't work like it did in the previous versions
-Tracking added for Corrupt Essence (703), will no longer repeatedly cast and waste that precious mana
-You can also cast it open as "incant 703 open"
-Added flee from vines option to first tab of ;bigshot setup
v3.51 (2016-07-25)
-Special coding for 1700. Wont stance offensive for "incant 1700", Will stance offensive for "incant 1700 evoke"
-Fix for ;Bigshot quick not working when your quickhunt targets was empty
v3.50 (2016-07-24)
-Untargetable and Targetable lists now use the name instead of noun. Option to clear these so they can start fresh using ;bigshot reset. This will fix the issue for being unable to target guards in warcamps.
-Targetable and Untargetable are now listed in ;bigshot display
-Fix for Head/Tail Routine. Head wasn't waiting for the tail members to join bigshot group.
v3.49 (2016-07-24)
-Updated berserk to use Spell.cast functionality, should now use STOP BERSERK when no alive mobs in the room.
-Command check added for poison and disease
-Fixed some options that were out of place, oops
-Tail should now use scripts when performing pre-hunt commands
-Head should wait for tails to be out of RT before heading to rest now
-Incant should no longer fry your nerves when you dont have enough mana.
-Changed incant to use wands when you dont have enough mana.
-Also checks your target before incanting, so you always target the correct creature
-Changed wand routine to be able to use multiple wand types, "use this wand type" now takes comma seperated wands "use this wand type" example: "aquamarine wand, bloodwood wand, etc"
-Changed incant, spell and wand routines to return to attack stance option instead of stance defensive.
-Fixed bug with bless routine, maybe
-Option to use Voln SMITE in UAC routine now, instead of always doing it.
v3.48 (2016-07-20)
-Added Consecrate(1604) to bless routine
-Quickhunt targets code update and fixes
-Made bless work with identical weapons
v3.47 (2016-07-19)
-fix for blessing weapons
v3.46 (2016-07-19)
-now tries to pull someone to their feet when they are lying down/kneeling/etc.
-Rewrote the bless option to bless anything that runs out of a bless.
-Now located on Attacking Tab as a checkbox
-Returns you to your resting area if you can't bless things.
-Added a priority targeting option to hunting tab.
-Will switch target based on the order of your valid targets, whenever its attacking.
-Added Quickhunt targets, These always are first in terms of priority (Quickhunt targets, room targets)
-You can use the (a)|(b)|(etc) in here instead of just the Quickhunt routine every time.
v3.45 (2016-07-09)
-better code for checking for an escort, less error prone now (:
-fixed rare issue with ambusher jumping out of hiding just as go to move and it screwing up bigshot
-UAC Bless option changed so that you can leave it blank and it wont stop hunting. Has tooltip explaining different options.
v3.44 (2016-07-01)
-Fix for the fix for the fix!!
-Added a check for spell 608 to skip if already hidden
-Added hidden and !hidden a command check, hidden only works when your hiding, !hidden when your not hiding
v3.43 (2016-07-01)
-Fix for the Fix :(
v3.42 (2016-06-30)
-Fix for mob command check due to recent change
-Optimized the escort npc check
v3.41 (2016-06-30)
-Fixed Head/Tail bigshot hunting
V3.40 (2016-06-30)
-Mstrike will now cast 1107 and 1607 when appropriate
-Quick Hunting mode tweaked so that it works when your in a group, or in a room that isn't mapped
-added inverse command checks, put a ! in front of the command check, i.e kill(!h60)
-Doesn't count escorts anymore for NPC checks
V3.39 (2016-06-26)
-Quick Hunting mode added - Just start bigshot with the variable quick - ;bigshot quick
-Quick Mode overrides your currently setup targets and targets the current room npcs
-Wandering, Fleeing and Resting is disabled
-Bigshot exits when no NPCS found in room
-Uses Quick Hunting Commands
-Supports up to 10 (A-J) different attack routines now.
-Moved all the attack routines to new tab, Commands
-Moved few options to the attacking tab
v3.38 (2016-06-25)
-added command check for target not being prone or target being undead
-current checks are mana/stamina/health(percentage)/encumbrance/unarmed tiering/mobs in room/target not prone/target undead
-m/s/h/e/tier/mob/prone/undead respectively
-Prone means target is sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place
v3.37 (2016-06-24)
-can now have two or more checks for a command. i.e kill(mob3 s20 h80) 3 mobs in room, stamina is above 20, health is above 80%
-must all be inside the () and seperated with a space
-current checks are mana/stamina/health(percentage)/encumbrance/unarmed tiering/mobs in room
-m/s/h/e/tier/mob respectively
v3.36 (2016-06-23)
-Added option for adjusting wander time between rooms (Found on Hunting Map Tab)
v3.35 (2016-06-14)
-Added option for attacks to only trigger when certain number of creatures are in the room.
-Just add (mob#) to the attack you want to do
-Fixes for unarmed combat getting stalled
-Now attempts to soothe (1205) when appropriate
v3.34 (2016-06-08)
-Added aiming for archery to the Hunting tab in setup.
-Will change location once you stick the place your aiming at, looping until the creature is dead
-Made gathering ammo a bit more specific about what its grabbing and where its putting it.
-Also works with bolts and darts now if you gathered things to the ground.
v3.33 (2016-06-06)
-Fix for creatures leaving room and script getting stuck (Hopefully)
-Fix for loot script activating during roundtime
-Fix for issue with targeting using creatures name or noun
v3.32 (2016-06-02)
-Changed aiming for UAC to continue until if finds something you can hit or just hits them like normal
-Added Voln Smite to command, use Smite in your hunting commands
-Rewrote Ambush again! Now has the option to pick locations you want to ambush at on the hunting page
-Also supports it from the hunting command i.e. "ambush head"
-If left blank without picking any options in setup will default to Head, Right Leg, Left Leg, Chest
v3.31 (2016-06-02)
-Changed up the ambush command so it ambushes what you said to ambush first, then attempts right leg, left leg, then chest
-Added an option to trigger the mstrike during UAC combat, other MSTRIKE options apply
-Few fixes to MSTRIKE routine, now checks number of creatures in room as an equal or greater
-Fixed bug caused when doing commands like "stance for and kill target"

Edits by Hazado: (2016-06-01)
V3.3 (2016-06-01)
-Added UAC combat! Start it with hunting command "unarmed punch/jab/kick/grapple"
-Added options for UAC in setup
-Added options for MSTRIKEing in setup
-Rewrote MSTRIKE routine
-can now check mana/stamina/health(percentage)/encumbrance/unarmed tiering inside the hunting commands
-Changed wander routine to hit every room in area instead of random wandering

Edits by Zhiart: (2016-03-25)
-Added new ambush command for legging a critter and then go for the head as long as they are prone (Code by SashaFierce)

v3.2 (2/27/2016)
-Added changes to fix incant loot issues (might work)
-Added ability to detect renaming of bigshot without destroying exec scripts
-Converted exec scripts to strings to allow =>quiet

Edits by Kalros: (2015-11-2015)
v3.1
-Fixed Disk poaching.
-Fixed First room poaching.
-Removed group poaching logic.
-Ambush detection via Exec Script. It will leave the room if it detects an ambush line.
-Rewrote and updated wander targeting sections. Fixes some target related bugs.
-Moved WAIT command to exec to prevent line buffer issues and make more responsive

3.0 (2015-05-30):
stop trying to attack monsters that aren't in the room (wild guess, untested)
bumped version up from 2.12052012 to 3.0, because 2.12052012 is a stupid version format
added message to trust script
</pre>

Wrayth protocol

2026-01-04T22:15:31Z

HORIBU1: update Front Ends category to proper capitalization

==Wrayth protocol==
The '''Wrayth protocol''' is the XML protocol used to pass information between the GemStone IV game server and front-end clients. It is utilized by the official Wrayth client and unofficial frontends.

==Core System Elements==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>mode</code> || Game mode indicator || id (GAME, LOGIN, CMGR)
|-
| <code>playerID</code> || Player identifier || id (numeric)
|-
| <code>settingsInfo</code> || Client/game settings || client, major, crc, instance
|-
| <code>app</code> || Application metadata || char, game, title
|-
| <code>endSetup</code> || Marks end of initial setup || (none)
|}

===Examples===
<pre>
<mode id="GAME"/>
<playerID id='966483'/>
<settingsInfo client='1.0.1.28' major='19313' crc='3508957330' instance='GS4'/>
<endSetup/><app char="Nisugi" game="Prime" title="GemStone IV: Nisugi [Prime]"/>
</pre>

==Stream Management==
Streams route text output to specific UI windows.

{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>streamWindow</code> || UI window definition || id, title, subtitle, location, target, ifClosed, resident, save, scroll, timestamp
|-
| <code>clearStream</code> || Clear stream contents || id, ifClosed
|-
| <code>pushStream</code> || Push content to stream || id
|-
| <code>popStream</code> || Pop stream context || id
|-
| <code>stream</code> || Individual stream content line || id
|-
| <code>exposeStream</code> || Expose/show a stream || id
|}

===Stream Window IDs===
{| class="wikitable"
|-
! Stream ID !! Title !! Purpose
|-
| main || Story || Main game output
|-
| room || Room || Room description display
|-
| inv || My Inventory || Worn items
|-
| Spells || Spells || Available spells list
|-
| familiar || Familiar || Familiar messages
|-
| thoughts || Thoughts || ESP/telepathy
|-
| logons || Arrivals || Player arrivals
|-
| death || Deaths || Death notices
|-
| speech || Speech || Speech window
|-
| ambients || Ambients || Ambient messages
|-
| announcements || Announcements || Game announcements
|-
| bounty || Bounties || Bounty task info
|-
| society || Society Tasks || Society task info
|-
| loot || Loot || Loot window
|-
| charprofile || Character's Profile || Character profile
|-
| charsheet || Character Sheet || Character sheet
|}

===Examples===
<pre>
<streamWindow id='room' title='Room' subtitle=" - [Icemule Trace, South Road]" location='center' target='drop' ifClosed='' resident='true'/>
<streamWindow id='inv' title='My Inventory' target='wear' ifClosed='' resident='true'/>
<streamWindow id="Spells" title="Spells" ifClosed="" resident="true" scroll="manual"/>
<clearStream id='inv' ifClosed=''/>
<pushStream id='inv'/>Your worn items are:
<popStream/>
<clearStream id="Spells"/>
</pre>

'''Stream content example (thoughts/ESP):'''
<pre>
<pushStream id="thoughts"/>You hear the faint thoughts of Nisugi echo in your mind:
"Hello everyone!"
<popStream/>
</pre>

==Component System==
Components represent dynamic room/area content.

{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>compDef</code> || Component definition || id
|-
| <code>component</code> || Component instance || id
|}

'''Component IDs:'''
* room desc - Room description
* room objs - Room objects
* room players - Players in room
* room exits - Available exits
* sprite - Player's familiar/sprite

===Examples===
<pre>
<compDef id='room players'></compDef>
<compDef id='room exits'>Obvious paths: <d>east</d>, <d>west</d></compDef>
<compDef id='sprite'></compDef>

<component id='room players'>Also here: Lord <a exist="-10939058" noun="Huras">Huras</a></component>
<component id='room players'></component>
<component id='room objs'> You also see<b> <pushBold/>a <a exist="103330" noun="resident">disheveled resident</a><popBold/></b>.</component>
</pre>

==Container/Inventory System==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>container</code> || Container window || id, title, location, target, resident, save
|-
| <code>exposeContainer</code> || Expose container || id
|-
| <code>clearContainer</code> || Clear container contents || id
|-
| <code>deleteContainer</code> || Delete container from UI || id
|-
| <code>inv</code> || Inventory item line || id
|}

===Examples===
'''Looking in a container:'''
<pre>
<container id='393944944' title='Chest' target='#393944944' location='right'/>
<clearContainer id="393944944"/>
<inv id='393944944'>In the <a exist="393944944" noun="chest">chest</a>:</inv>
<inv id='393944944'> <a exist="393944946" noun="coins">some silver coins</a></inv>
<inv id='393944944'> a <a exist="393944945" noun="garnet">dark red-violet garnet</a></inv>
</pre>

'''Stow container (default storage):'''
<pre>
<exposeContainer id='stow'/>
<container id='stow' title="My Cloak" target='#225766691' location='right' save='' resident='true'/>
<clearContainer id="stow"/>
<inv id='stow'>In the <a exist="225766691" noun="cloak">cloak</a>:</inv>
<inv id='stow'> a <a exist="225766734" noun="feather">nacreous disir feather</a></inv>
</pre>

==Dialog System==
Dialogs are UI panels with controls and data.

{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>openDialog</code> || Create dialog window || id, type, title, location, target, height, width, resident
|-
| <code>dialogData</code> || Dialog content || id, clear
|-
| <code>closeDialog</code> || Close a dialog window || id
|-
| <code>exposeDialog</code> || Show a hidden dialog || id
|}

===Dialog IDs===
{| class="wikitable"
|-
! Dialog ID !! Purpose
|-
| combat || Combat controls
|-
| injuries || Injury display (player)
|-
| minivitals || Health/mana/stamina bars
|-
| stance || Stance indicator
|-
| expr || Experience/level info
|-
| encum || Encumbrance
|-
| Active Spells || Active spell list
|-
| Buffs || Active buffs
|-
| Debuffs || Active debuffs
|-
| Cooldowns || Ability cooldowns
|-
| mapMaster || Map controls
|-
| mapViewMain || Map view
|-
| espMasterDialog || ESP/telepathy controls
|-
| quick || Quick action bar (main)
|-
| quick-combat || Combat quick bar
|-
| quick-simu || Information quick bar
|-
| BetrayerPanel || Blood Points tracking
|-
| befriend || Friends & Enemies list
|-
| bank || Banking interface
|-
| injuries-{existID} || Target character injuries appraisal
|}

===Examples===
'''Opening and populating a dialog:'''
<pre>
<openDialog type='dynamic' id='minivitals' title='Stats' location='statBar'>
<dialogData id='minivitals'></dialogData>
</openDialog>

<openDialog type='dynamic' id='stance' title='Stance' location='right' height='50' width='190' resident='true'>
<dialogData id='stance'>
<progressBar id='pbarStance' value='100' text='defensive (100%)' top='5' left='-5' height='16' width='160' align='n' tooltip='Percent of stance contributing to defense'/>
</dialogData>
</openDialog>
</pre>

'''Updating dialog data:'''
<pre>
<dialogData id='combat'>
<progressBar id='pbarStance' value='100' text='defensive (100%)' top='51' width='130' height='16' left='0' align='n' tooltip='Percent of stance contributing to defense'/>
</dialogData>
</pre>

'''Banking dialog:'''
<pre>
<dialogData id='bank'>
<link id='depositallLnk' value='Deposit All' cmd='deposit all' align='w' top='30' left='0' height='30' width='90' echo='deposit all'/>
<link id='wealthnotesLnk' value='Check Notes' cmd='wealth notes' align='e' top='30' left='0' height='30' width='90' echo='wealth notes'/>
<closeButton id='closeMe' value='Close' cmd='' align='s' left='0' top='0' width='80'/>
</dialogData>
<exposeDialog id='bank'/>
<closeDialog id="bank"/>
</pre>

===Target Injuries Appraisal Dialog===
When you <code>appraise</code> another character, a dynamic injuries dialog opens showing their wounds:

<pre>
<openDialog type='dynamic' id='injuries-10070682' title='Dicate's Injuries' location='right'>
<dialogData id='injuries'>
<skin id='injuredSkin' name='InjuriesPanel'
controls='nsys,leftArm,rightArm,rightLeg,leftLeg,head,rightFoot,leftFoot,rightHand,leftHand,rightEye,leftEye,back,neck,chest,abdomen'/>
<closeButton id='cancel' value='Close' cmd=''/>
</dialogData>
</openDialog>
<dialogData id="injuries-10070682">
<image id="head" name="Injury1"/>
<image id="neck" name="Injury2" cmd="tend Dicate neck" tooltip="tend Dicate's neck"/>
<image id="rightArm" name="Injury3" cmd="tend Dicate right arm"/>
...
</dialogData>
</pre>

'''Key Elements:'''
* Dialog ID: injuries-{existID} where existID is the target's object ID
* Body part images with injury levels: Injury1 (minor), Injury2 (moderate), Injury3 (severe)
* Clickable cmd attributes for tending wounds
* Body parts tracked: head, neck, rightArm, leftArm, rightLeg, leftLeg, rightHand, leftHand, chest, abdomen, back, rightEye, leftEye, rightFoot, leftFoot, nsys

==UI Control Elements==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>progressBar</code> || Progress indicator || id, value, text, customText, top, left, height, width
|-
| <code>cmdButton</code> || Command button || id, value, cmd, echo, tooltip
|-
| <code>dropDownBox</code> || Dropdown selector || id, value, cmd, content_text, content_value
|-
| <code>upDownEditBox</code> || Numeric input || id, value, min, max
|-
| <code>label</code> || Text label || id, value, justify
|-
| <code>link</code> || Clickable link || id, value, cmd, echo, URL
|-
| <code>menuLink</code> || Menu link || id, value, exist, noun
|-
| <code>image</code> || UI image/button || id, name, cmd, echo, tooltip
|-
| <code>radio</code> || Radio button || id, value, text, cmd, group
|-
| <code>skin</code> || UI skin/theme || id, name, controls
|-
| <code>closeButton</code> || Close button || id, value, cmd
|-
| <code>sep</code> || Separator || (none)
|}

===Progress Bar IDs===
{| class="wikitable"
|-
! ProgressBar ID !! Dialog !! Purpose
|-
| health || minivitals || Health bar (main)
|-
| health2 || injuries || Health bar (injuries)
|-
| mana || minivitals || Mana bar
|-
| spirit || minivitals || Spirit bar
|-
| stamina || minivitals || Stamina bar
|-
| pbarStance || combat/stance || Stance indicator
|-
| encumlevel || encum || Encumbrance level
|-
| mindState || expr || Mind state (experience absorption)
|-
| nextLvlPB || expr || Progress to next level
|}

===Examples===
'''Progress bars (vitals):'''
<pre>
<progressBar id='health' value='100' text='health 223/223' customText='t' left='0%' top='0%' width='25%' height='100%'/>
<progressBar id='mana' value='98' text='mana 426/431' left='25%' customText='t' top='0%' width='25%' height='100%'/>
<progressBar id='spirit' value='100' text='spirit 10/10' left='50%' customText='t' top='0%' width='25%' height='100%'/>
<progressBar id='stamina' value='100' text='stamina 112/112' left='75%' customText='t' top='0%' width='25%' height='100%'/>
<progressBar id='encumlevel' value='0' text='None' top='5' left='-5' align='n' width='160' height='15'/>
</pre>

'''Command buttons:'''
<pre>
<cmdButton id='cmdDefStance' value='defense' cmd='_stance defensive' tooltip='Assume a Defensive Stance' echo='stance defensive' height='20' width='55' top='70' left='0' align='nw'/>
<cmdButton id='cmdTarget' value='target' cmd='target random' tooltip='Select a Random Target' height='20' width='55' top='93' left='0' align='nw'/>
<cmdButton id='cmdAttack' value='attack' cmd='attack' height='20' width='50' left='0' top='93' tooltip='Attack Current Target' align='ne'/>
</pre>

'''Dropdown box:'''
<pre>
<dropDownBox id='dDBStance' value="defensive" cmd='_stance %dDBStance%' content_text='offensive,advance,forward,neutral,guarded,defensive' content_value='offensive,advance,forward,neutral,guarded,defensive' align='n' top='70' left='0' height='20' width='80' tooltip='Stance Selection'/>
</pre>

'''Labels:'''
<pre>
<label id='encumblurb' value='You are not encumbered enough to notice.' top='10' left='0' align='n' width='160' height='50' justify='0'/>
</pre>

==Navigation Elements==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>nav</code> || Navigation/room info || rm (room ID)
|-
| <code>compass</code> || Compass container || (contains dir elements)
|-
| <code>dir</code> || Direction indicator || value (n, s, e, w, ne, nw, se, sw, up, down, out)
|}

===Examples===
<pre>
<nav rm='12345'/>
<compass><dir value="e"/><dir value="out"/></compass>
<compass><dir value="n"/><dir value="s"/><dir value="e"/><dir value="w"/></compass>
</pre>

==Interactive/Link Elements==
===Hyperlink Element (<code><a></code>)===
Creates clickable links for objects, players, and coordinates.

{| class="wikitable"
|-
! Attribute !! Description
|-
| exist || Game object ID (numeric, can be negative)
|-
| noun || Object noun/type
|-
| coord || Click coordinates (x,y format)
|-
| char || Character name (for player links)
|-
| game || Game code (GSIV, GST)
|}

===Examples===
<pre>
<a exist="225766824" noun="bandolier">leather bandolier</a>
<a exist="-11225598" noun="Ludge">Ludge</a>
<a exist="103330" noun="resident">disheveled resident</a>
<a exist="-10939058" noun="Huras">Huras</a>
</pre>

===Direct Command Link Element (<code><d></code>)===
Creates clickable command links in text. When clicked, executes the command specified in the <code>cmd</code> attribute (or the tag contents if <code>cmd</code> is omitted). Commonly used for compass directions but works for any command.

{| class="wikitable"
|-
! Attribute !! Description
|-
| cmd || Command to execute (optional - if omitted, executes tag contents as the command)
|}

===Examples===
'''Compass directions (no cmd attribute - executes tag contents):'''
<pre>
<compDef id='room exits'>Obvious paths: <d>east</d>, <d>west</d></compDef>
<compDef id='room exits'>Obvious exits: <d>northeast</d>, <d>out</d></compDef>
</pre>

'''Movement message (with cmd attribute):'''
<pre>
Lord <a exist="-10939058" noun="Huras">Huras</a> just went <d cmd='go west'>west</d>.
</pre>

'''Store commands:'''
<pre>
shield: <d cmd="store SHIELD clear">an <a exist="412277454" noun="buckler">old krodera buckler</a></d> (<d cmd='store set'>put in sheath</d>)
weapon: <d cmd="store WEAPON clear">a <a exist="412277485" noun="baselard">sleek gleaming steel baselard</a></d> (<d cmd='store set'>put in sheath</d>)
</pre>

==Character State Elements==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>indicator</code> || Status indicator || id, visible (y/n)
|-
| <code>spell</code> || Current prepared spell || (text content)
|-
| <code>left</code> || Left hand item || exist, noun
|-
| <code>right</code> || Right hand item || exist, noun
|-
| <code>prompt</code> || Command prompt || time (unix timestamp)
|-
| <code>roundTime</code> || Action round time || value (seconds)
|-
| <code>castTime</code> || Spell cast time || value (seconds)
|}

===Indicator IDs===
{| class="wikitable"
|-
! Indicator ID !! Status
|-
| IconKNEELING || Kneeling
|-
| IconPRONE || Prone
|-
| IconSITTING || Sitting
|-
| IconSTANDING || Standing
|-
| IconSTUNNED || Stunned
|-
| IconHIDDEN || Hidden
|-
| IconINVISIBLE || Invisible
|-
| IconDEAD || Dead
|-
| IconWEBBED || Webbed
|-
| IconJOINED || Joined group
|}

===Examples===
'''Character state elements:'''
<pre>
<indicator id='IconSTANDING' visible='y'/>
<indicator id='IconHIDDEN' visible='y'/>
<indicator id='IconHIDDEN' visible='n'/>
<indicator id='IconSTUNNED' visible='y'/>
<indicator id='IconINVISIBLE' visible='n'/>

<spell>None</spell>
<spell>Fire Spirit (111)</spell>

<left exist="394466807" noun="bow">ghezyte long bow</left>
<left exist="" noun=""/>
<right exist="417169523" noun="arrows">glowbark arrows</right>

<prompt time="1767310975">></prompt>
<roundTime value='1767333503'/>
<castTime value='1767250287'/>
</pre>

==Text Formatting Elements==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>pushBold</code> || Start bold text || (none)
|-
| <code>popBold</code> || End bold text || (none)
|-
| <code>b</code> || Bold wrapper || (none)
|-
| <code>output</code> || Output formatting/font switch || class
|-
| <code>style</code> || Text style || id (roomName, roomDesc, etc.)
|-
| <code>preset</code> || Styled action text || id (speech, whisper, thought)
|}

===Output Class Values===
* <code><output class="mono"/></code> - Switch to monospace font
* <code><output class=""/></code> - Switch back to normal font

===Examples===
'''Bold text (monster highlighting):'''
<pre>
<b> <pushBold/>a <a exist="103330" noun="resident">disheveled resident</a><popBold/></b>
</pre>

'''Room styling:'''
<pre>
<popBold/><resource picture="0"/><style id="roomName" />[Cobblestone Path]
<style id="roomDesc"/>The narrow cobblestone path winds between aged buildings...
</pre>

'''Speech/whisper preset:'''
<pre>
<preset id="whisper">(OOC) You whisper,</preset> "Rallying at 0d7d2dc1." to your group.
<preset id="whisper">(OOC) <a exist="-10070682" noun="Dicate">Dicate's</a> player whispers to the group,</preset> "Joined cluster group 0d7d2dc1."
<preset id="speech">Nisugi says,</preset> "Hello!"
</pre>

'''Font switching:'''
<pre>
<output class="mono"/>
Name Mana Known/Cast
Minor Elemental Edge (902) 1 Yes
Elemental Defense I (401) 1 Yes
<output class=""/>
</pre>

==Menu System==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>menu</code> || Menu container || id, path, cat_list
|-
| <code>mi</code> || Menu item || coord
|-
| <code>menuImage</code> || Image in menu || (for quick bar menus)
|}

==Settings/Flags System==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>flag</code> || Player setting flag || id, status (on/off), desc
|}

'''Example flags:'''
* Player Log On, Player Log Off, Player Disconnect
* Room Names, Room Descriptions, Brief Room Description
* Monster Bold, Default Group Open

===Examples===
<pre>
<flag id="Player Log On" status='off' desc="Show logon messages."/>
<flag id="Player Log Off" status='off' desc="Show logoff messages."/>
<flag id="Player Disconnect" status='off' desc="Show disconnection messages."/>
<flag id="Room Names" status='on' desc="Display the name of the room in which you are located."/>
<flag id="Room Descriptions" status='on' desc="Display room descriptions."/>
<flag id="Brief Room Description" status='off' desc="Display room descriptions in shortened form."/>
<flag id="Monster Bold" status='on' desc="Highlight monster names."/>
<flag id="Default Group Open" status='on' desc="Allow others to join your group."/>
<flag id="Automatically Activate ESP Amulets" status='on' desc="Activate items for THINKing automatically."/>
<flag id="Automatically Gather Coins" status='on' desc="Gather coins when searching your kills."/>
</pre>

==Client Settings (stgupd)==
Used within <code></code> markers for client-side settings:

<pre>
<stgupd><panels>...</panels>
<stgupd><stream>...</stream>
</pre>

===Nested Elements in stgupd===
{| class="wikitable"
|-
! Element !! Description
|-
| panels || Panel layout configuration
|-
| stream || Stream window settings
|-
| misc || Miscellaneous settings
|-
| toggles || Toggle settings
|-
| group || Group container (id: Left, Right)
|-
| w || Window configuration
|-
| m || Setting value
|-
| s || Toggle state
|}

==UI State Control==
===Monopolize Element===
{| class="wikitable"
|-
! Element !! Description
|-
| <code>monopolize</code> || Game takes exclusive control of a stream
|}

When <code>monopolize id="main"</code> is set, the game blocks all other text/streams until released with <code>monopolize id=""</code>.

===Examples===
<pre>
<monopolize id="main"/>You get a room key from the innkeeper and wander off to your room...
... (inn rest sequence) ...
<indicator id='IconINVISIBLE' visible='n'/><monopolize id=""/><output class=""/>
</pre>

==Miscellaneous Elements==
{| class="wikitable"
|-
! Element !! Description !! Key Attributes
|-
| <code>switchQuickBar</code> || Switch active quick bar || id
|-
| <code>updateverbs</code> || Update available verbs || default
|-
| <code>cmdlist</code> || Command list || (none)
|-
| <code>cmdtimestamp</code> || Command timestamp || data
|-
| <code>pushInputState</code> || Input state control || state
|-
| <code>popInputState</code> || Pop input state || (none)
|}

===Examples===
<pre>
<switchQuickBar id="quick"/>
<switchQuickBar id="quick-simu"/>
<switchQuickBar id="quick-combat"/>
</pre>

==Special Behaviors==
===Newline Suppression===
Tags followed by newlines suppress newline output '''except''' for:
* <code><a></code> (hyperlinks)
* <code><pushBold></code> (bold start)

===Mixed Content===
Output contains both XML tags and plain text on the same lines. Parsers must handle interleaved content.

===Negative Exist IDs===
Room/NPC objects often have negative exist values (e.g., -11225598).

==Common Attributes Reference==
{| class="wikitable"
|-
! Category !! Attributes
|-
| Layout || top, left, height, width, align, anchor_top, anchor_left, anchor_right, justify, location
|-
| Identity || id, exist, noun
|-
| Behavioral || cmd, echo, value, visible, resident, ifClosed
|-
| Content || title, subtitle, text, tooltip, content_text, content_value
|}

==Complete Element Summary==
'''Total Unique Elements: 60+'''

{| class="wikitable"
|-
! Category !! Count !! Elements
|-
| Core || 5 || mode, playerID, settingsInfo, app, endSetup
|-
| Streams || 6 || streamWindow, clearStream, pushStream, popStream, stream, exposeStream
|-
| Components || 2 || compDef, component
|-
| Containers || 5 || container, exposeContainer, clearContainer, deleteContainer, inv
|-
| Dialogs || 4 || openDialog, dialogData, closeDialog, exposeDialog
|-
| Controls || 12 || progressBar, cmdButton, dropDownBox, upDownEditBox, label, link, menuLink, image, radio, skin, closeButton, sep
|-
| Navigation || 3 || nav, compass, dir
|-
| Interactive || 2 || a, d
|-
| Character State || 7 || indicator, spell, left, right, prompt, roundTime, castTime
|-
| Formatting || 6 || pushBold, popBold, b, output, style, preset
|-
| Menu || 3 || menu, mi, menuImage
|-
| Settings || 1 || flag
|-
| Miscellaneous || 7 || switchQuickBar, updateverbs, cmdlist, cmdtimestamp, pushInputState, popInputState, monopolize
|}

[[Category:Front Ends]]

Gungfer (prime)

2025-12-17T21:39:16Z

HORIBU1: HORIBU1 moved page Gungfer (prime to Gungfer (prime): missing closing parenthesis

{{characterprofile
|name=Gungfer
|image= 
|caption=
|race=Human 
|culture= 
|culture2= 
|hometown=
|class=Warrior
|profession=
|religion=
|affiliations=Voln
|word=
|disposition=
|demeanor=
|ptrait=
|strait=
|flaw=
|strength=
|weakness=
|habits=
|hobbies=
|soft=
|likes=
|dislikes=
|fears=
|loyalties=
|friend=
|spouse=
|loved=
|children=
|instance= 
|town= 
|town2= 
}}
[[File:Gungfer.png|left|thumb]]

Lich:Software/Mac Installation

2025-12-17T00:46:12Z

HORIBU1: /* The Process */ add openssl to brew list

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

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

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

==Before You Start==

You will need to install a few things.

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

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

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

==The Process==

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

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

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

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

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

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

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

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

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

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

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

* <code>rbenv versions</code>

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

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

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

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

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

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

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

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

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

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

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

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

==Lich for Other Front Ends==

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

https://warlockfe.github.io/

Configuration for Mac (and other OS types) here:

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

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

{{Third-Party Software}}

Lich:Script Repository

2025-12-14T17:46:49Z

HORIBU1: /* Jinx Lich Repository Offline Update Info */ updated mapdb backup option

{{3rd-party}}
The repository, owned by Tillmen, is the most common location for downloading scripts that are not pre-installed with Lich.

==How to Use the Repository==

The repository has four basic commands:

<syntaxhighlight lang="ruby">
;repository

;repository download <scriptname>

;repository info <scriptname>

;repository list
</syntaxhighlight>

The first shows a Help screen and is the root command for all others.

The second, often shortened to ';repo down', lets you download a specified script.

Third, INFO provides information about whatever script is specified. If the author has been kind and thorough, this will tell you how to use the script and if it has any interdependencies.

Fourth, LIST will list all scripts in the repository.

==Updating Scripts==
The repository supports updates via prefedined scripts and the MapDatabase
To see a list of scripts you currently have set to updatable, <CODE>;repo show-updatable</CODE>.
For users on Lich 5+, you want <CODE>Lich: off</CODE> to be displayed.

To add a script to be updated, <CODE>;repo set-updatable <scriptname></CODE>.
To view scripts you have set to be auto-updated, <CODE>;repo show-updatable</CODE>.
It is only recommended to set scripts from authors you trust to auto-update.

If you want to remove, <CODE>;repo unset-updatable <scriptname></CODE>.

==Popular Lich Scripts==

<section begin=popularscripts />The following are a list of scripts that enhance or extend basic functions of Gemstone IV and can improve or streamline your gaming experience to a point where you can't think of ever going back. It's not all inclusive but contains a good starter set or some of the most popular scripts in use.
=== Core components installed with Lich ===

'''Generally speaking, the below scripts should not need to be updated manually by the user, especially if the user keeps up to date on the current lich version.'''
* [[Lich:Script Alias|alias]] - A default script used to create shortcuts in lich. See wiki page for details.
* [[Lich:Script Autostart|autostart]] - A default script to handle which scripts run on startup. See wiki page for details.
* [[Script Go2|go2]] - Go2 is an intelligent travel script that is synchronized to many of the more complex scripts. Go2 uses a Room Number system and can intelligently plot routes between most any two rooms in all of Elanthia. Use can be as simple as <code>;go2 town</code> or <code>;go2 bank</code> to head to the nearest town square or bank. Use <code>;go2 targets</code> to see a list of pre-programmed locations broken down by towns. Or, use <code>;go2 save <new location name>=<new location room number></code> to create your own locations. Go2 is distributed as part of a default Lich installation.
* [[Lich:Script Map|map]] - map (fork of Narost/XNarost) is an active map library that can display your location and allows Point-And-Click travel. Simply right click and choose a map, pick a room on it and click on it. map is distributed as part of a default Lich installation.
* [[Script Repository|repository]] - A default script to view and download other scripts. See wiki page for details.
* [[Lich:Script Vars|vars]] - A default script to create and view variables for both users and scripts. See wiki page for details.
* [[Lich:Script Version|version]] - A default script to output your current lich version and other information. See wiki page for details.

=== Scripts maintained by Elanthia-Online ===
* [[Lich:Script Bigshot|bigshot]] - A script for attacking and hunting routines. See wiki page for details.
* '''blackarts''' - A script for doing various [[alchemy]] tasks. <CODE>;blackarts setup</CODE> for configuration details
* [[Lich:Script Ebounty|ebounty]] - A script to get and perform bounties. See wiki page for details.
* '''ecaster''' - Allows user to type just the spell number and have lich cast that spell. Usage syntax is <code>;ecaster setup</code> for configuration. Set to autostart.
* '''echild''' - A child bounty script that monitors for and returns a child during bounty sessions. Add to autostart or your hunting script when performing a bounty.
* [[Lich:Script Ecleanse|ecleanse]] - A script for dealing with status conditions. See wiki page for details.
* '''ecure''' - A script for healing for empaths. Usage syntax is <code>;ecure setup</code> for first usage.
* [[Lich:Script Eherbs|eherbs]] - A herb healing and stocking script. See wiki page for details.
* [[Lich:Script Eloot|eloot]] - A looting and loot management script. See wiki page for details.
* '''elogin''' - A script for command line login for your characters. . Usage syntax is <code>;elogin <charname></code>
* '''escortgo2''' - A script for bounty escorts. Usage syntax is <code>;escortgo2 help</code> for relevant commands (replaces ;ego2)
* [[Lich:Script Ewaggle|ewaggle]] - A script for spelling yourself and others up. See wiki page for details.
* '''ewander''' - The last of the Trifector of Travel, wander will move from room to room until it runs into a Boundary - a specified room number - or finds a room with a monster AND empty of players. Wander can be used to create a walled in hunting ground, letting you automatically move from room to room without having to use keystrokes. Use the <code>;ewander add</code> command to add the room you are currently standing in to the Wander List. Note: Wander will NOT enter your boundary rooms. For example, adding Town Square East to the list and then executing ;ewander from within the confines of Moot Hall will send your character exploring every room in Moot, but unable to leave as TSE is a Boundary.
* [[Lich:Script foreach|foreach]] - A script for sending a series of commands for each item that matches its criteria. See wiki page for details.
* '''jbackup ''' - A excellent backup and recovery tool that allows lich database and any additional file backup a user prefers. Set to autostart.
* '''ledger''' - A scripting for tracking your silver and bounty incoming across sessions and over time per character and account with a nice ascii display. Requires ascii_charts gem (installed by default with Lich 5.7.0+ full installer)
* '''signore ''' - A script for using society powers <CODE>;signore setup</CODE> for configuration
* '''resource''' - A script for determining your current player service bonus. <CODE> ;resource bonus </CODE> Can also be used to determine the cost of enchanting with the syntax ;resource calc <starting enchant> <ending enchant> <cost per essence> as in <CODE>;resource calc 35 45 50</CODE>
* '''uberbar_eo ''' - The most current Uberbar variant. This will provide a paperdoll with room number, resource information, etc. inside Wrayth. Set to autostart. Note- there is a small performance impact when using Uberbars.

=== Other scripts that are popular ===
* '''character-planner ''' - A script for planning out your character skills and training. <CODE>;character-planner</CODE> for configuration
* '''colmaster ''' - A script for getting and performing COL tasks in Solhaven
* '''dirty-deeds ''' - A script for getting deeds in IMT and WL. <CODE>;dirty-deeds setup</CODE> for configuration
* [[Script invdb|invdb]] - An inventory management database. See wiki page for details
* '''linktothefast''' - A complex script that provides highlighting for Wrayth links when links are disabled. This script can cause issues with [[STOW]] settings, so disable prior to adjusting those settings.
* [[Script LNet|lnet]] - An out of game, third party, not Simutronics controlled chat server. <CODE>;repo download lnet --author=elanthia-online</CODE>. See wiki page for details '''LNet should be installed at your own risk'''. Simutronics has no control over LNet or policy enforcement there. The in-game [[ESP]] is now available and replaces many of the functions that LNet provided.
* '''multi''' - A script to perform repetitive set of commands. Usage syntax is <code>;multi; <number> <action></code> such as <code>;multi 10, get my diamond, drop my diamond</code>
* '''rogues''' - A script for rogue guild tasks <CODE>;rogues setup</CODE> for configuration
* '''sorter ''' Sorter cleans up your bags and breaks down the the output of a LOOK command, sorting the results by type. Makes looking in your locker or backpack, and especially your gem pouch, infinitely easier. *Note* Sorter can mess up some other scripts that deal with inventory, so be cautious in usage. Elanthia-Online scripts like eloot disable sorter when performing relevant functions
* '''stat-maximizer''' - A script for configuring character stats. <CODE>;stat-maximizer</CODE> for configuration
* '''tpick''' - A script for lockpicking <CODE>;tpick setup</CODE> for configuration
* '''volnstep ''' - A script for performing voln tasks in Wehnimer's Landing
* '''warrior''' - A script for warrior guild tasks <CODE>;warrior setup</CODE> for configuration
<section end=popularscripts />

==In-game Help Output==
<PRE>Usage:

;repository list [alpha] lists all scripts available for download (optionally in alphabetial order)
;repository sync [alpha] lists only new and/or updated scripts
;repository info <script name> shows the comments at the top of the script
;repository download <script name> downloads the script
;repository upload <script name> uploads the script
;repository delete <script name> deletes the script from the server

Scripts should include comments at the top describing the purpose of the script. Scripts without comments at the top will not show up on the server.

After uploading a script, a key that allows you to delete/update the script will be saved to C:/Games/lich/keys</PRE>

==Sortable list==
The repository script has an in game GUI available that allows sorting by date, tags, etc.
<CODE>;repo gui</CODE>

==Jinx (Repository alternative)==

Jinx is a project that is an alternative form of script installation from the default ;repository. It can serve up scripts for download similar to the ;repo however it is not dependent on a single server that may be prone to outages. Any one can set up their own script library, and then users can add it as a source for the ;jinx script to search and download from.

Jinx is installed in the default Lich5 package. Jinx can be downloaded and installed into your scripts folder from the Elanthia Online github

https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/jinx.lic

Right-click the above link and save it into the scripts folder in your lich directory.

Alternatively, the following command can be issued in game via lich to attempt to download the script to the proper directory for you (this command is for when the repository is down and the script cannot be downloaded naturally):
<syntaxhighlight lang="ruby">
;e require 'open-uri';begin;jinx_remote = open("https://raw.githubusercontent.com/elanthia-online/scripts/master/scripts/jinx.lic"); jinx_local = File.open(File.join(SCRIPT_DIR, 'jinx.lic'), "wb"); jinx_local.write(jinx_remote.read);ensure; jinx_remote.close(); jinx_local.close();end</syntaxhighlight>

once installed you can issue: <CODE>;jinx help</CODE> for basic usage information.

===Jinx Lich Repository Mirror===
In the event the main <code>;repository</code> is unavailable, there is currently an actively maintained <code>;jinx</code> repository that is a direct mirror.

https://github.com/FarFigNewGut/lich_repo_mirror

Scripts can be manually retrieved from this Github repository (they are all located in the lib folder). The repository is also packaged and published for use directly with Jinx:

<syntaxhighlight lang="ruby">
;jinx repo add mirror https://ffnglichrepoarchive.netlify.app
</syntaxhighlight>

Once it is setup as a source for <code>;jinx</code> you can install any scripts from the repo with:

<syntaxhighlight lang="ruby">
# install script for the first time
;jinx script install <script name> --repo=mirror

# update previously installed script
;jinx script update <script name> --repo=mirror
</syntaxhighlight>

For example if you wanted to download or update invdb.lic:
<syntaxhighlight lang="ruby">
# first install
;jinx script install invdb --repo=mirror

# update if you had previously downloaded invdb.lic
;jinx script update invdb --repo=mirror
</syntaxhighlight>

Do note, if a script is not available on the archive, it's likely because it belongs to Elanthia-Online and those scripts are not found within the archive, but under a default repo that is configured with jinx. To use it, you would do the following, using bigshot.lic as an example
<syntaxhighlight lang="ruby">
# first install
;jinx script install bigshot --repo=elanthia-online

# update if you had previously downloaded bigshot.lic
;jinx script update bigshot --repo=elanthia-online
</syntaxhighlight>

You can also leave the <code>--repo=<REPO_NAME></code> off to see all available options for a script that is found.

===Jinx Lich Repository Offline Update Info===
At times the default Lich repository (accessed via <code>;repo</code>) can go offline, below are some helpful commands to update core Lich related functionality using Jinx.

<syntaxhighlight lang="ruby">
# ensure running latest jinx.lic for newest compatibility
;jinx script update jinx.lic --repo=elanthia-online

# update spell-list.xml for new spells, cmans, cooldowns, etc
;jinx data update effect-list.xml --repo=elanthia-online

# update gameobj-data.xml for proper classification of NPCs and items
;jinx data update gameobj-data.xml --repo=mirror

# update mapdb and associated missing map files for graphical use
;jinx data update mapdb.json --repo=mapdb-backup-gs

</syntaxhighlight>

==In-game Screenshot==
<gallery perrow="4">
File:Repo-1.png|Repo
</gallery>

{{Third-Party Software}}

Template:CHE

2025-12-13T00:05:54Z

HORIBU1: change formating to help with white spacing

<noinclude>
This template is used to display information about Cooperative Houses of Elanthia (CHEs) in GemStone IV.

== Usage ==
<pre>
{{CHE
|name=
|emblem=
|location=
|officer1_name=
|officer1_title=
|officer1_position=
|officer2_name=
|officer2_title=
|officer2_position=
|officer3_name=
|officer3_title=
|officer3_position=
|officer4_name=
|officer4_title=
|officer4_position=
|officer5_name=
|officer5_title=
|officer5_position=
|officer6_name=
|officer6_title=
|officer6_position=
|officer7_name=
|officer7_title=
|officer7_position=
|officer8_name=
|officer8_title=
|officer8_position=
|officer9_name=
|officer9_title=
|officer9_position=
|officer10_name=
|officer10_title=
|officer10_position=
|annex1=
|annex2=
|annex3=
|annex4=
|annex5=
|annex6=
|annex7=
|annex8=
|annex9=
|annex10=
}}
</pre>

== Parameters ==
* '''name''' - The full name of the CHE
* '''emblem''' - Filename of the emblem/artwork (e.g., "Phoenix_emblem.png")
* '''location''' - The main town where the CHE is located
* '''officer#_name''' - Name of the officer (supports up to 10 officers)
* '''officer#_title''' - Title of the officer (e.g., "Lord", "Lady")
* '''officer#_position''' - Position held (e.g., "Secretary", "President", "Treasurer")
* '''annex#''' - Location of annexes (supports up to 10)

[[Category:Templates]]
</noinclude><includeonly>
{| class="wikitable" style="float: right; margin-left: 1em; margin-bottom: 1em; width: 400px; clear: right;"
! colspan="2" style="text-align: center; font-size: 1.2em; background-color: #d4af37;" | {{{name|}}}
|-
{{#if:{{{emblem|}}}|
{{!}} colspan="2" style="text-align: center; background-color: #ffffff;" {{!}} [[File:{{{emblem}}}|380px]]
{{!}}-
|}}
! style="width: 35%; background-color: #f0f0f0;" | Main Location
| {{{location|''Unknown''}}}
{{#if:{{{officer1_name|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Officers
{{!}} {{#if:{{{officer1_title|}}}|{{{officer1_title}}} |}}{{{officer1_name}}}{{#if:{{{officer1_position|}}}|, ''{{{officer1_position}}}''|}}{{#if:{{{officer2_name|}}}|<br/>{{#if:{{{officer2_title|}}}|{{{officer2_title}}} |}}{{{officer2_name}}}{{#if:{{{officer2_position|}}}|, ''{{{officer2_position}}}''|}}|}}{{#if:{{{officer3_name|}}}|<br/>{{#if:{{{officer3_title|}}}|{{{officer3_title}}} |}}{{{officer3_name}}}{{#if:{{{officer3_position|}}}|, ''{{{officer3_position}}}''|}}|}}{{#if:{{{officer4_name|}}}|<br/>{{#if:{{{officer4_title|}}}|{{{officer4_title}}} |}}{{{officer4_name}}}{{#if:{{{officer4_position|}}}|, ''{{{officer4_position}}}''|}}|}}{{#if:{{{officer5_name|}}}|<br/>{{#if:{{{officer5_title|}}}|{{{officer5_title}}} |}}{{{officer5_name}}}{{#if:{{{officer5_position|}}}|, ''{{{officer5_position}}}''|}}|}}{{#if:{{{officer6_name|}}}|<br/>{{#if:{{{officer6_title|}}}|{{{officer6_title}}} |}}{{{officer6_name}}}{{#if:{{{officer6_position|}}}|, ''{{{officer6_position}}}''|}}|}}{{#if:{{{officer7_name|}}}|<br/>{{#if:{{{officer7_title|}}}|{{{officer7_title}}} |}}{{{officer7_name}}}{{#if:{{{officer7_position|}}}|, ''{{{officer7_position}}}''|}}|}}{{#if:{{{officer8_name|}}}|<br/>{{#if:{{{officer8_title|}}}|{{{officer8_title}}} |}}{{{officer8_name}}}{{#if:{{{officer8_position|}}}|, ''{{{officer8_position}}}''|}}|}}{{#if:{{{officer9_name|}}}|<br/>{{#if:{{{officer9_title|}}}|{{{officer9_title}}} |}}{{{officer9_name}}}{{#if:{{{officer9_position|}}}|, ''{{{officer9_position}}}''|}}|}}{{#if:{{{officer10_name|}}}|<br/>{{#if:{{{officer10_title|}}}|{{{officer10_title}}} |}}{{{officer10_name}}}{{#if:{{{officer10_position|}}}|, ''{{{officer10_position}}}''|}}|}}
|}}
{{#if:{{{annex1|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Annex Locations
{{!}} {{{annex1}}}{{#if:{{{annex2|}}}|<br/>{{{annex2}}}|}}{{#if:{{{annex3|}}}|<br/>{{{annex3}}}|}}{{#if:{{{annex4|}}}|<br/>{{{annex4}}}|}}{{#if:{{{annex5|}}}|<br/>{{{annex5}}}|}}{{#if:{{{annex6|}}}|<br/>{{{annex6}}}|}}{{#if:{{{annex7|}}}|<br/>{{{annex7}}}|}}{{#if:{{{annex8|}}}|<br/>{{{annex8}}}|}}{{#if:{{{annex9|}}}|<br/>{{{annex9}}}|}}{{#if:{{{annex10|}}}|<br/>{{{annex10}}}|}}
|}}
|}
[[Category:Cooperative Houses of Elanthia]]
</includeonly>

Template:CHE

2025-12-13T00:03:12Z

HORIBU1: remove line break spacing

<noinclude>
This template is used to display information about Cooperative Houses of Elanthia (CHEs) in GemStone IV.

== Usage ==
<pre>
{{CHE
|name=
|emblem=
|location=
|officer1_name=
|officer1_title=
|officer1_position=
|officer2_name=
|officer2_title=
|officer2_position=
|officer3_name=
|officer3_title=
|officer3_position=
|officer4_name=
|officer4_title=
|officer4_position=
|officer5_name=
|officer5_title=
|officer5_position=
|officer6_name=
|officer6_title=
|officer6_position=
|officer7_name=
|officer7_title=
|officer7_position=
|officer8_name=
|officer8_title=
|officer8_position=
|officer9_name=
|officer9_title=
|officer9_position=
|officer10_name=
|officer10_title=
|officer10_position=
|annex1=
|annex2=
|annex3=
|annex4=
|annex5=
|annex6=
|annex7=
|annex8=
|annex9=
|annex10=
}}
</pre>

== Parameters ==
* '''name''' - The full name of the CHE
* '''emblem''' - Filename of the emblem/artwork (e.g., "Phoenix_emblem.png")
* '''location''' - The main town where the CHE is located
* '''officer#_name''' - Name of the officer (supports up to 10 officers)
* '''officer#_title''' - Title of the officer (e.g., "Lord", "Lady")
* '''officer#_position''' - Position held (e.g., "Secretary", "President", "Treasurer")
* '''annex#''' - Location of annexes (supports up to 10)

[[Category:Templates]]
</noinclude><includeonly>
{| class="wikitable" style="float: right; margin-left: 1em; margin-bottom: 1em; width: 400px; clear: right;"
! colspan="2" style="text-align: center; font-size: 1.2em; background-color: #d4af37;" | {{{name|}}}
|-
{{#if:{{{emblem|}}}|
{{!}} colspan="2" style="text-align: center; background-color: #ffffff;" {{!}} [[File:{{{emblem}}}|380px]]
{{!}}-
|}}
! style="width: 35%; background-color: #f0f0f0;" | Main Location
| {{{location|''Unknown''}}}
{{#if:{{{officer1_name|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Officers
{{!}}{{#if:{{{officer1_title|}}}|{{{officer1_title}}} |}}{{{officer1_name}}}{{#if:{{{officer1_position|}}}|, ''{{{officer1_position}}}''|}}
{{#if:{{{officer2_name|}}}|<br/>{{#if:{{{officer2_title|}}}|{{{officer2_title}}} |}}{{{officer2_name}}}{{#if:{{{officer2_position|}}}|, ''{{{officer2_position}}}''|}}|}}
{{#if:{{{officer3_name|}}}|<br/>{{#if:{{{officer3_title|}}}|{{{officer3_title}}} |}}{{{officer3_name}}}{{#if:{{{officer3_position|}}}|, ''{{{officer3_position}}}''|}}|}}
{{#if:{{{officer4_name|}}}|<br/>{{#if:{{{officer4_title|}}}|{{{officer4_title}}} |}}{{{officer4_name}}}{{#if:{{{officer4_position|}}}|, ''{{{officer4_position}}}''|}}|}}
{{#if:{{{officer5_name|}}}|<br/>{{#if:{{{officer5_title|}}}|{{{officer5_title}}} |}}{{{officer5_name}}}{{#if:{{{officer5_position|}}}|, ''{{{officer5_position}}}''|}}|}}
{{#if:{{{officer6_name|}}}|<br/>{{#if:{{{officer6_title|}}}|{{{officer6_title}}} |}}{{{officer6_name}}}{{#if:{{{officer6_position|}}}|, ''{{{officer6_position}}}''|}}|}}
{{#if:{{{officer7_name|}}}|<br/>{{#if:{{{officer7_title|}}}|{{{officer7_title}}} |}}{{{officer7_name}}}{{#if:{{{officer7_position|}}}|, ''{{{officer7_position}}}''|}}|}}
{{#if:{{{officer8_name|}}}|<br/>{{#if:{{{officer8_title|}}}|{{{officer8_title}}} |}}{{{officer8_name}}}{{#if:{{{officer8_position|}}}|, ''{{{officer8_position}}}''|}}|}}
{{#if:{{{officer9_name|}}}|<br/>{{#if:{{{officer9_title|}}}|{{{officer9_title}}} |}}{{{officer9_name}}}{{#if:{{{officer9_position|}}}|, ''{{{officer9_position}}}''|}}|}}
{{#if:{{{officer10_name|}}}|<br/>{{#if:{{{officer10_title|}}}|{{{officer10_title}}} |}}{{{officer10_name}}}{{#if:{{{officer10_position|}}}|, ''{{{officer10_position}}}''|}}|}}
|}}
{{#if:{{{annex1|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Annex Locations
{{!}} {{{annex1}}}
{{#if:{{{annex2|}}}|<br/>{{{annex2}}}|}}
{{#if:{{{annex3|}}}|<br/>{{{annex3}}}|}}
{{#if:{{{annex4|}}}|<br/>{{{annex4}}}|}}
{{#if:{{{annex5|}}}|<br/>{{{annex5}}}|}}
{{#if:{{{annex6|}}}|<br/>{{{annex6}}}|}}
{{#if:{{{annex7|}}}|<br/>{{{annex7}}}|}}
{{#if:{{{annex8|}}}|<br/>{{{annex8}}}|}}
{{#if:{{{annex9|}}}|<br/>{{{annex9}}}|}}
{{#if:{{{annex10|}}}|<br/>{{{annex10}}}|}}
|}}
|}
[[Category:Cooperative Houses of Elanthia]]
</includeonly>

Template:CHE

2025-12-13T00:00:54Z

HORIBU1: use   instead of normal spacing to prevent stripping

<noinclude>
This template is used to display information about Cooperative Houses of Elanthia (CHEs) in GemStone IV.

== Usage ==
<pre>
{{CHE
|name=
|emblem=
|location=
|officer1_name=
|officer1_title=
|officer1_position=
|officer2_name=
|officer2_title=
|officer2_position=
|officer3_name=
|officer3_title=
|officer3_position=
|officer4_name=
|officer4_title=
|officer4_position=
|officer5_name=
|officer5_title=
|officer5_position=
|officer6_name=
|officer6_title=
|officer6_position=
|officer7_name=
|officer7_title=
|officer7_position=
|officer8_name=
|officer8_title=
|officer8_position=
|officer9_name=
|officer9_title=
|officer9_position=
|officer10_name=
|officer10_title=
|officer10_position=
|annex1=
|annex2=
|annex3=
|annex4=
|annex5=
|annex6=
|annex7=
|annex8=
|annex9=
|annex10=
}}
</pre>

== Parameters ==
* '''name''' - The full name of the CHE
* '''emblem''' - Filename of the emblem/artwork (e.g., "Phoenix_emblem.png")
* '''location''' - The main town where the CHE is located
* '''officer#_name''' - Name of the officer (supports up to 10 officers)
* '''officer#_title''' - Title of the officer (e.g., "Lord", "Lady")
* '''officer#_position''' - Position held (e.g., "Secretary", "President", "Treasurer")
* '''annex#''' - Location of annexes (supports up to 10)

[[Category:Templates]]
</noinclude><includeonly>
{| class="wikitable" style="float: right; margin-left: 1em; margin-bottom: 1em; width: 400px; clear: right;"
! colspan="2" style="text-align: center; font-size: 1.2em; background-color: #d4af37;" | {{{name|}}}
|-
{{#if:{{{emblem|}}}|
{{!}} colspan="2" style="text-align: center; background-color: #ffffff;" {{!}} [[File:{{{emblem}}}|380px]]
{{!}}-
|}}
! style="width: 35%; background-color: #f0f0f0;" | Main Location
| {{{location|''Unknown''}}}
{{#if:{{{officer1_name|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Officers
{{!}} {{#if:{{{officer1_title|}}}|{{{officer1_title}}} |}}{{{officer1_name}}}{{#if:{{{officer1_position|}}}|, ''{{{officer1_position}}}''|}}
{{#if:{{{officer2_name|}}}|<br/>{{#if:{{{officer2_title|}}}|{{{officer2_title}}} |}}{{{officer2_name}}}{{#if:{{{officer2_position|}}}|, ''{{{officer2_position}}}''|}}|}}
{{#if:{{{officer3_name|}}}|<br/>{{#if:{{{officer3_title|}}}|{{{officer3_title}}} |}}{{{officer3_name}}}{{#if:{{{officer3_position|}}}|, ''{{{officer3_position}}}''|}}|}}
{{#if:{{{officer4_name|}}}|<br/>{{#if:{{{officer4_title|}}}|{{{officer4_title}}} |}}{{{officer4_name}}}{{#if:{{{officer4_position|}}}|, ''{{{officer4_position}}}''|}}|}}
{{#if:{{{officer5_name|}}}|<br/>{{#if:{{{officer5_title|}}}|{{{officer5_title}}} |}}{{{officer5_name}}}{{#if:{{{officer5_position|}}}|, ''{{{officer5_position}}}''|}}|}}
{{#if:{{{officer6_name|}}}|<br/>{{#if:{{{officer6_title|}}}|{{{officer6_title}}} |}}{{{officer6_name}}}{{#if:{{{officer6_position|}}}|, ''{{{officer6_position}}}''|}}|}}
{{#if:{{{officer7_name|}}}|<br/>{{#if:{{{officer7_title|}}}|{{{officer7_title}}} |}}{{{officer7_name}}}{{#if:{{{officer7_position|}}}|, ''{{{officer7_position}}}''|}}|}}
{{#if:{{{officer8_name|}}}|<br/>{{#if:{{{officer8_title|}}}|{{{officer8_title}}} |}}{{{officer8_name}}}{{#if:{{{officer8_position|}}}|, ''{{{officer8_position}}}''|}}|}}
{{#if:{{{officer9_name|}}}|<br/>{{#if:{{{officer9_title|}}}|{{{officer9_title}}} |}}{{{officer9_name}}}{{#if:{{{officer9_position|}}}|, ''{{{officer9_position}}}''|}}|}}
{{#if:{{{officer10_name|}}}|<br/>{{#if:{{{officer10_title|}}}|{{{officer10_title}}} |}}{{{officer10_name}}}{{#if:{{{officer10_position|}}}|, ''{{{officer10_position}}}''|}}|}}
|}}
{{#if:{{{annex1|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Annex Locations
{{!}} {{{annex1}}}
{{#if:{{{annex2|}}}|<br/>{{{annex2}}}|}}
{{#if:{{{annex3|}}}|<br/>{{{annex3}}}|}}
{{#if:{{{annex4|}}}|<br/>{{{annex4}}}|}}
{{#if:{{{annex5|}}}|<br/>{{{annex5}}}|}}
{{#if:{{{annex6|}}}|<br/>{{{annex6}}}|}}
{{#if:{{{annex7|}}}|<br/>{{{annex7}}}|}}
{{#if:{{{annex8|}}}|<br/>{{{annex8}}}|}}
{{#if:{{{annex9|}}}|<br/>{{{annex9}}}|}}
{{#if:{{{annex10|}}}|<br/>{{{annex10}}}|}}
|}}
|}
[[Category:Cooperative Houses of Elanthia]]
</includeonly>

Template:CHE

2025-12-12T23:58:46Z

HORIBU1: more corrections

<noinclude>
This template is used to display information about Cooperative Houses of Elanthia (CHEs) in GemStone IV.

== Usage ==
<pre>
{{CHE
|name=
|emblem=
|location=
|officer1_name=
|officer1_title=
|officer1_position=
|officer2_name=
|officer2_title=
|officer2_position=
|officer3_name=
|officer3_title=
|officer3_position=
|officer4_name=
|officer4_title=
|officer4_position=
|officer5_name=
|officer5_title=
|officer5_position=
|officer6_name=
|officer6_title=
|officer6_position=
|officer7_name=
|officer7_title=
|officer7_position=
|officer8_name=
|officer8_title=
|officer8_position=
|officer9_name=
|officer9_title=
|officer9_position=
|officer10_name=
|officer10_title=
|officer10_position=
|annex1=
|annex2=
|annex3=
|annex4=
|annex5=
|annex6=
|annex7=
|annex8=
|annex9=
|annex10=
}}
</pre>

== Parameters ==
* '''name''' - The full name of the CHE
* '''emblem''' - Filename of the emblem/artwork (e.g., "Phoenix_emblem.png")
* '''location''' - The main town where the CHE is located
* '''officer#_name''' - Name of the officer (supports up to 10 officers)
* '''officer#_title''' - Title of the officer (e.g., "Lord", "Lady")
* '''officer#_position''' - Position held (e.g., "Secretary", "President", "Treasurer")
* '''annex#''' - Location of annexes (supports up to 10)

[[Category:Templates]]
</noinclude><includeonly>
{| class="wikitable" style="float: right; margin-left: 1em; margin-bottom: 1em; width: 400px; clear: right;"
! colspan="2" style="text-align: center; font-size: 1.2em; background-color: #d4af37;" | {{{name|}}}
|-
{{#if:{{{emblem|}}}|
{{!}} colspan="2" style="text-align: center; background-color: #ffffff;" {{!}} [[File:{{{emblem}}}|380px]]
{{!}}-
|}}
! style="width: 35%; background-color: #f0f0f0;" | Main Location
| {{{location|''Unknown''}}}
{{#if:{{{officer1_name|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Officers
{{!}}
{{#if:{{{officer1_title|}}}|{{{officer1_title}}} |}}{{{officer1_name}}}{{#if:{{{officer1_position|}}}|, ''{{{officer1_position}}}''|}}
{{#if:{{{officer2_name|}}}|<br/>{{#if:{{{officer2_title|}}}|{{{officer2_title}}} |}}{{{officer2_name}}}{{#if:{{{officer2_position|}}}|, ''{{{officer2_position}}}''|}}|}}
{{#if:{{{officer3_name|}}}|<br/>{{#if:{{{officer3_title|}}}|{{{officer3_title}}} |}}{{{officer3_name}}}{{#if:{{{officer3_position|}}}|, ''{{{officer3_position}}}''|}}|}}
{{#if:{{{officer4_name|}}}|<br/>{{#if:{{{officer4_title|}}}|{{{officer4_title}}} |}}{{{officer4_name}}}{{#if:{{{officer4_position|}}}|, ''{{{officer4_position}}}''|}}|}}
{{#if:{{{officer5_name|}}}|<br/>{{#if:{{{officer5_title|}}}|{{{officer5_title}}} |}}{{{officer5_name}}}{{#if:{{{officer5_position|}}}|, ''{{{officer5_position}}}''|}}|}}
{{#if:{{{officer6_name|}}}|<br/>{{#if:{{{officer6_title|}}}|{{{officer6_title}}} |}}{{{officer6_name}}}{{#if:{{{officer6_position|}}}|, ''{{{officer6_position}}}''|}}|}}
{{#if:{{{officer7_name|}}}|<br/>{{#if:{{{officer7_title|}}}|{{{officer7_title}}} |}}{{{officer7_name}}}{{#if:{{{officer7_position|}}}|, ''{{{officer7_position}}}''|}}|}}
{{#if:{{{officer8_name|}}}|<br/>{{#if:{{{officer8_title|}}}|{{{officer8_title}}} |}}{{{officer8_name}}}{{#if:{{{officer8_position|}}}|, ''{{{officer8_position}}}''|}}|}}
{{#if:{{{officer9_name|}}}|<br/>{{#if:{{{officer9_title|}}}|{{{officer9_title}}} |}}{{{officer9_name}}}{{#if:{{{officer9_position|}}}|, ''{{{officer9_position}}}''|}}|}}
{{#if:{{{officer10_name|}}}|<br/>{{#if:{{{officer10_title|}}}|{{{officer10_title}}} |}}{{{officer10_name}}}{{#if:{{{officer10_position|}}}|, ''{{{officer10_position}}}''|}}|}}
|}}
{{#if:{{{annex1|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Annex Locations
{{!}} {{{annex1}}}
{{#if:{{{annex2|}}}|<br/>{{{annex2}}}|}}
{{#if:{{{annex3|}}}|<br/>{{{annex3}}}|}}
{{#if:{{{annex4|}}}|<br/>{{{annex4}}}|}}
{{#if:{{{annex5|}}}|<br/>{{{annex5}}}|}}
{{#if:{{{annex6|}}}|<br/>{{{annex6}}}|}}
{{#if:{{{annex7|}}}|<br/>{{{annex7}}}|}}
{{#if:{{{annex8|}}}|<br/>{{{annex8}}}|}}
{{#if:{{{annex9|}}}|<br/>{{{annex9}}}|}}
{{#if:{{{annex10|}}}|<br/>{{{annex10}}}|}}
|}}
|}
</includeonly>

Template:CHE

2025-12-12T23:56:26Z

HORIBU1:

<noinclude>
This template is used to display information about Cooperative Houses of Elanthia (CHEs) in GemStone IV.

== Usage ==
<pre>
{{CHE
|name=
|emblem=
|location=
|officer1_name=
|officer1_title=
|officer1_position=
|officer2_name=
|officer2_title=
|officer2_position=
|officer3_name=
|officer3_title=
|officer3_position=
|officer4_name=
|officer4_title=
|officer4_position=
|officer5_name=
|officer5_title=
|officer5_position=
|officer6_name=
|officer6_title=
|officer6_position=
|officer7_name=
|officer7_title=
|officer7_position=
|officer8_name=
|officer8_title=
|officer8_position=
|officer9_name=
|officer9_title=
|officer9_position=
|officer10_name=
|officer10_title=
|officer10_position=
|annex1=
|annex2=
|annex3=
|annex4=
|annex5=
|annex6=
|annex7=
|annex8=
|annex9=
|annex10=
}}
</pre>

== Parameters ==
* '''name''' - The full name of the CHE
* '''emblem''' - Filename of the emblem/artwork (e.g., "Phoenix_emblem.png")
* '''location''' - The main town where the CHE is located
* '''officer#_name''' - Name of the officer (supports up to 10 officers)
* '''officer#_title''' - Title of the officer (e.g., "Lord", "Lady")
* '''officer#_position''' - Position held (e.g., "Secretary", "President", "Treasurer")
* '''annex#''' - Location of annexes (supports up to 10)

[[Category:Templates]]
</noinclude><includeonly>
{| class="wikitable" style="float: right; margin-left: 1em; margin-bottom: 1em; width: 400px; clear: right;"
! colspan="2" style="text-align: center; font-size: 1.2em; background-color: #d4af37;" | {{{name|}}}
|-
{{#if:{{{emblem|}}}|
{{!}} colspan="2" style="text-align: center; background-color: #ffffff;" {{!}} [[File:{{{emblem}}}|380px]]
{{!}}-
|}}
! style="width: 35%; background-color: #f0f0f0;" | Main Location
| {{{location|''Unknown''}}}
{{#if:{{{officer1_name|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Officers
{{!}}
{{#if:{{{officer1_title|}}}|{{{officer1_title}}} |}}{{{officer1_name}}}{{#if:{{{officer1_position|}}}|, ''{{{officer1_position}}}''|}}
{{#if:{{{officer2_name|}}}|<br/>{{#if:{{{officer2_title|}}}|{{{officer2_title}}} |}}{{{officer2_name}}}{{#if:{{{officer2_position|}}}|, ''{{{officer2_position}}}''|}}|}}
{{#if:{{{officer3_name|}}}|<br/>{{#if:{{{officer3_title|}}}|{{{officer3_title}}} |}}{{{officer3_name}}}{{#if:{{{officer3_position|}}}|, ''{{{officer3_position}}}''|}}|}}
{{#if:{{{officer4_name|}}}|<br/>{{#if:{{{officer4_title|}}}|{{{officer4_title}}} |}}{{{officer4_name}}}{{#if:{{{officer4_position|}}}|, ''{{{officer4_position}}}''|}}|}}
{{#if:{{{officer5_name|}}}|<br/>{{#if:{{{officer5_title|}}}|{{{officer5_title}}} |}}{{{officer5_name}}}{{#if:{{{officer5_position|}}}|, ''{{{officer5_position}}}''|}}|}}
{{#if:{{{officer6_name|}}}|<br/>{{#if:{{{officer6_title|}}}|{{{officer6_title}}} |}}{{{officer6_name}}}{{#if:{{{officer6_position|}}}|, ''{{{officer6_position}}}''|}}|}}
{{#if:{{{officer7_name|}}}|<br/>{{#if:{{{officer7_title|}}}|{{{officer7_title}}} |}}{{{officer7_name}}}{{#if:{{{officer7_position|}}}|, ''{{{officer7_position}}}''|}}|}}
{{#if:{{{officer8_name|}}}|<br/>{{#if:{{{officer8_title|}}}|{{{officer8_title}}} |}}{{{officer8_name}}}{{#if:{{{officer8_position|}}}|, ''{{{officer8_position}}}''|}}|}}
{{#if:{{{officer9_name|}}}|<br/>{{#if:{{{officer9_title|}}}|{{{officer9_title}}} |}}{{{officer9_name}}}{{#if:{{{officer9_position|}}}|, ''{{{officer9_position}}}''|}}|}}
{{#if:{{{officer10_name|}}}|<br/>{{#if:{{{officer10_title|}}}|{{{officer10_title}}} |}}{{{officer10_name}}}{{#if:{{{officer10_position|}}}|, ''{{{officer10_position}}}''|}}|}}
|}}
{{#if:{{{annex1|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Annex Locations
{{!}} {{{annex1}}}
{{#if:{{{annex2|}}}|<br/>{{{annex2}}}|}}
{{#if:{{{annex3|}}}|<br/>{{{annex3}}}|}}
{{#if:{{{annex4|}}}|<br/>{{{annex4}}}|}}
{{#if:{{{annex5|}}}|<br/>{{{annex5}}}|}}
{{#if:{{{annex6|}}}|<br/>{{{annex6}}}|}}
{{#if:{{{annex7|}}}|<br/>{{{annex7}}}|}}
{{#if:{{{annex8|}}}|<br/>{{{annex8}}}|}}
{{#if:{{{annex9|}}}|<br/>{{{annex9}}}|}}
{{#if:{{{annex10|}}}|<br/>{{{annex10}}}|}}
|}}
|}
[[Category:Cooperative Houses of Elanthia]]
</includeonly>

Template:CHE

2025-12-12T23:55:15Z

HORIBU1: additional spacing correction

<noinclude>
This template is used to display information about Cooperative Houses of Elanthia (CHEs) in GemStone IV.

== Usage ==
<pre>
{{CHE
|name=
|emblem=
|location=
|officer1_name=
|officer1_title=
|officer1_position=
|officer2_name=
|officer2_title=
|officer2_position=
|officer3_name=
|officer3_title=
|officer3_position=
|officer4_name=
|officer4_title=
|officer4_position=
|officer5_name=
|officer5_title=
|officer5_position=
|officer6_name=
|officer6_title=
|officer6_position=
|officer7_name=
|officer7_title=
|officer7_position=
|officer8_name=
|officer8_title=
|officer8_position=
|officer9_name=
|officer9_title=
|officer9_position=
|officer10_name=
|officer10_title=
|officer10_position=
|annex1=
|annex2=
|annex3=
|annex4=
|annex5=
|annex6=
|annex7=
|annex8=
|annex9=
|annex10=
}}
</pre>

== Parameters ==
* '''name''' - The full name of the CHE
* '''emblem''' - Filename of the emblem/artwork (e.g., "Phoenix_emblem.png")
* '''location''' - The main town where the CHE is located
* '''officer#_name''' - Name of the officer (supports up to 10 officers)
* '''officer#_title''' - Title of the officer (e.g., "Lord", "Lady")
* '''officer#_position''' - Position held (e.g., "Secretary", "President", "Treasurer")
* '''annex#''' - Location of annexes (supports up to 10)

[[Category:Templates]]
</noinclude><includeonly>
{| class="wikitable" style="float: right; margin-left: 1em; margin-bottom: 1em; width: 400px; clear: right;"
! colspan="2" style="text-align: center; font-size: 1.2em; background-color: #d4af37;" | {{{name|}}}
|-
{{#if:{{{emblem|}}}|
{{!}} colspan="2" style="text-align: center; background-color: #ffffff;" {{!}} [[File:{{{emblem}}}|380px]]
{{!}}-
|}}
! style="width: 35%; background-color: #f0f0f0;" | Main Location
| {{{location|''Unknown''}}}
{{#if:{{{officer1_name|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Officers
{{!}}
{{#if:{{{officer1_title|}}}|{{{officer1_title}}} |}} {{{officer1_name}}}{{#if:{{{officer1_position|}}}|, ''{{{officer1_position}}}''|}}
{{#if:{{{officer2_name|}}}|<br/>{{#if:{{{officer2_title|}}}|{{{officer2_title}}} |}}{{{officer2_name}}}{{#if:{{{officer2_position|}}}|, ''{{{officer2_position}}}''|}}|}}
{{#if:{{{officer3_name|}}}|<br/>{{#if:{{{officer3_title|}}}|{{{officer3_title}}} |}}{{{officer3_name}}}{{#if:{{{officer3_position|}}}|, ''{{{officer3_position}}}''|}}|}}
{{#if:{{{officer4_name|}}}|<br/>{{#if:{{{officer4_title|}}}|{{{officer4_title}}} |}}{{{officer4_name}}}{{#if:{{{officer4_position|}}}|, ''{{{officer4_position}}}''|}}|}}
{{#if:{{{officer5_name|}}}|<br/>{{#if:{{{officer5_title|}}}|{{{officer5_title}}} |}}{{{officer5_name}}}{{#if:{{{officer5_position|}}}|, ''{{{officer5_position}}}''|}}|}}
{{#if:{{{officer6_name|}}}|<br/>{{#if:{{{officer6_title|}}}|{{{officer6_title}}} |}}{{{officer6_name}}}{{#if:{{{officer6_position|}}}|, ''{{{officer6_position}}}''|}}|}}
{{#if:{{{officer7_name|}}}|<br/>{{#if:{{{officer7_title|}}}|{{{officer7_title}}} |}}{{{officer7_name}}}{{#if:{{{officer7_position|}}}|, ''{{{officer7_position}}}''|}}|}}
{{#if:{{{officer8_name|}}}|<br/>{{#if:{{{officer8_title|}}}|{{{officer8_title}}} |}}{{{officer8_name}}}{{#if:{{{officer8_position|}}}|, ''{{{officer8_position}}}''|}}|}}
{{#if:{{{officer9_name|}}}|<br/>{{#if:{{{officer9_title|}}}|{{{officer9_title}}} |}}{{{officer9_name}}}{{#if:{{{officer9_position|}}}|, ''{{{officer9_position}}}''|}}|}}
{{#if:{{{officer10_name|}}}|<br/>{{#if:{{{officer10_title|}}}|{{{officer10_title}}} |}}{{{officer10_name}}}{{#if:{{{officer10_position|}}}|, ''{{{officer10_position}}}''|}}|}}
|}}
{{#if:{{{annex1|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Annex Locations
{{!}} {{{annex1}}}
{{#if:{{{annex2|}}}|<br/>{{{annex2}}}|}}
{{#if:{{{annex3|}}}|<br/>{{{annex3}}}|}}
{{#if:{{{annex4|}}}|<br/>{{{annex4}}}|}}
{{#if:{{{annex5|}}}|<br/>{{{annex5}}}|}}
{{#if:{{{annex6|}}}|<br/>{{{annex6}}}|}}
{{#if:{{{annex7|}}}|<br/>{{{annex7}}}|}}
{{#if:{{{annex8|}}}|<br/>{{{annex8}}}|}}
{{#if:{{{annex9|}}}|<br/>{{{annex9}}}|}}
{{#if:{{{annex10|}}}|<br/>{{{annex10}}}|}}
|}}
|}
[[Category:Cooperative Houses of Elanthia]]
</includeonly>
```

**The key fix:** On the first officer line, I changed:
```
{{#if:{{{officer1_title|}}}|{{{officer1_title}}} |}} {{{officer1_name}}}
```

Notice the space is now BEFORE the closing `|}}` of the conditional, so it only appears when there's a title. The space after `|}}` was being eaten by the wiki parser.

Now you should see:
```
Warden Tolwynn, Chair
Chatalaine Traiva, Co-Chair

Template:CHE

2025-12-12T23:54:10Z

HORIBU1: fix spacing

<noinclude>
This template is used to display information about Cooperative Houses of Elanthia (CHEs) in GemStone IV.

== Usage ==
<pre>
{{CHE
|name=
|emblem=
|location=
|officer1_name=
|officer1_title=
|officer1_position=
|officer2_name=
|officer2_title=
|officer2_position=
|officer3_name=
|officer3_title=
|officer3_position=
|officer4_name=
|officer4_title=
|officer4_position=
|officer5_name=
|officer5_title=
|officer5_position=
|officer6_name=
|officer6_title=
|officer6_position=
|officer7_name=
|officer7_title=
|officer7_position=
|officer8_name=
|officer8_title=
|officer8_position=
|officer9_name=
|officer9_title=
|officer9_position=
|officer10_name=
|officer10_title=
|officer10_position=
|annex1=
|annex2=
|annex3=
|annex4=
|annex5=
|annex6=
|annex7=
|annex8=
|annex9=
|annex10=
}}
</pre>

== Parameters ==
* '''name''' - The full name of the CHE
* '''emblem''' - Filename of the emblem/artwork (e.g., "Phoenix_emblem.png")
* '''location''' - The main town where the CHE is located
* '''officer#_name''' - Name of the officer (supports up to 10 officers)
* '''officer#_title''' - Title of the officer (e.g., "Lord", "Lady")
* '''officer#_position''' - Position held (e.g., "Secretary", "President", "Treasurer")
* '''annex#''' - Location of annexes (supports up to 10)

[[Category:Templates]]
</noinclude><includeonly>
{| class="wikitable" style="float: right; margin-left: 1em; margin-bottom: 1em; width: 400px; clear: right;"
! colspan="2" style="text-align: center; font-size: 1.2em; background-color: #d4af37;" | {{{name|}}}
|-
{{#if:{{{emblem|}}}|
{{!}} colspan="2" style="text-align: center; background-color: #ffffff;" {{!}} [[File:{{{emblem}}}|380px]]
{{!}}-
|}}
! style="width: 35%; background-color: #f0f0f0;" | Main Location
| {{{location|''Unknown''}}}
{{#if:{{{officer1_name|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Officers
{{!}}
{{#if:{{{officer1_title|}}}|{{{officer1_title}}} |}}{{{officer1_name}}}{{#if:{{{officer1_position|}}}|, ''{{{officer1_position}}}''|}}
{{#if:{{{officer2_name|}}}|<br/>{{#if:{{{officer2_title|}}}|{{{officer2_title}}} |}}{{{officer2_name}}}{{#if:{{{officer2_position|}}}|, ''{{{officer2_position}}}''|}}|}}
{{#if:{{{officer3_name|}}}|<br/>{{#if:{{{officer3_title|}}}|{{{officer3_title}}} |}}{{{officer3_name}}}{{#if:{{{officer3_position|}}}|, ''{{{officer3_position}}}''|}}|}}
{{#if:{{{officer4_name|}}}|<br/>{{#if:{{{officer4_title|}}}|{{{officer4_title}}} |}}{{{officer4_name}}}{{#if:{{{officer4_position|}}}|, ''{{{officer4_position}}}''|}}|}}
{{#if:{{{officer5_name|}}}|<br/>{{#if:{{{officer5_title|}}}|{{{officer5_title}}} |}}{{{officer5_name}}}{{#if:{{{officer5_position|}}}|, ''{{{officer5_position}}}''|}}|}}
{{#if:{{{officer6_name|}}}|<br/>{{#if:{{{officer6_title|}}}|{{{officer6_title}}} |}}{{{officer6_name}}}{{#if:{{{officer6_position|}}}|, ''{{{officer6_position}}}''|}}|}}
{{#if:{{{officer7_name|}}}|<br/>{{#if:{{{officer7_title|}}}|{{{officer7_title}}} |}}{{{officer7_name}}}{{#if:{{{officer7_position|}}}|, ''{{{officer7_position}}}''|}}|}}
{{#if:{{{officer8_name|}}}|<br/>{{#if:{{{officer8_title|}}}|{{{officer8_title}}} |}}{{{officer8_name}}}{{#if:{{{officer8_position|}}}|, ''{{{officer8_position}}}''|}}|}}
{{#if:{{{officer9_name|}}}|<br/>{{#if:{{{officer9_title|}}}|{{{officer9_title}}} |}}{{{officer9_name}}}{{#if:{{{officer9_position|}}}|, ''{{{officer9_position}}}''|}}|}}
{{#if:{{{officer10_name|}}}|<br/>{{#if:{{{officer10_title|}}}|{{{officer10_title}}} |}}{{{officer10_name}}}{{#if:{{{officer10_position|}}}|, ''{{{officer10_position}}}''|}}|}}
|}}
{{#if:{{{annex1|}}}|
{{!}}-
! style="background-color: #f0f0f0;" {{!}} Annex Locations
{{!}} {{{annex1}}}
{{#if:{{{annex2|}}}|<br/>{{{annex2}}}|}}
{{#if:{{{annex3|}}}|<br/>{{{annex3}}}|}}
{{#if:{{{annex4|}}}|<br/>{{{annex4}}}|}}
{{#if:{{{annex5|}}}|<br/>{{{annex5}}}|}}
{{#if:{{{annex6|}}}|<br/>{{{annex6}}}|}}
{{#if:{{{annex7|}}}|<br/>{{{annex7}}}|}}
{{#if:{{{annex8|}}}|<br/>{{{annex8}}}|}}
{{#if:{{{annex9|}}}|<br/>{{{annex9}}}|}}
{{#if:{{{annex10|}}}|<br/>{{{annex10}}}|}}
|}}
|}
[[Category:Cooperative Houses of Elanthia]]
</includeonly>