GemStone IV Wiki - User contributions [en]

User:WHIGHTCNIGHT/EG Fishing

2026-10-13T14:58:10Z

HORIBU1: initial creation

'''Ebon Gate Fishing''' is the fishing activity on the four haunted fishing docks along the Gleyminn Anni River during the [[Ebon Gate Festival]]. It uses the Artisan-era [[Fishing]] system (<code>FISH CAST</code> / <code>FISH REEL</code>, lures and sinkers) with a few event-specific twists:
* every visit to a dock costs [[Soul shard|soul shards]];
* every landed fish teleports you back off the dock;
* every fish holds a prize.

This page covers the whole cycle from buying gear to filleting the catch. It also includes an analysis of roughly 640 logged Ebon Gate fights (October 10–13, 2026) covering cast distance, depth, rarity, line wear, time of day and skill gain.

For the general fishing system, see [[Fishing]], [[Fishing equipment]], [[Verb:FISHING]], [[Fishing guide]] and [[List of fish]].

__TOC__

== Quick start ==
# Buy a rod, line, a lure for each depth, and the two sinkers at [[EHShop:Rodnir's Bait and Tackle|Rodnir's Bait and Tackle]] in Evermore Hollow.
# String the rod: <code>PULL</code> your spool to snap off a length of line, then <code>PUT</code> the length on your rod.
# <code>PUT</code> a lure on the rod. Add a sinker if you want to fish deeper than the surface.
# Take a raft along the Gleyminn Anni River to a dock entrance and <code>GO DOCK</code> twice (50 soul shards).
# <code>FISH CAST NEAR|MIDDLE|FAR</code> and wait for "''You feel a brief jerk on your line…''".
# <code>FISH REEL</code> until "''…one final tug and the <fish> comes wriggling to the surface!''".
# You're teleported back to the entrance. <code>CUT</code> the fish with a dagger to get its prize, then repeat.

== Equipment ==
=== Where to buy ===
'''[[EHShop:Rodnir's Bait and Tackle|Rodnir's Bait and Tackle]]''' in Evermore Hollow (Lich room 31969, room 8084321) sells everything needed. Prices are in soul shards. They have varied during the event; see the shop page for current listings.

{| class="wikitable"
! Item !! Use !! Notes
|-
| a twisted black fishing pole adorned with tiny fish skulls<br/>a bleached bone fishing rod bound with knotted jute twine<br/>a short rattan fishing stick with a dark cork-wrapped handle || Rod || The rods are cosmetic variants of one another.
|-
| a ball of dark braided fishing wire<br/>a spool of thin silvery fishing line || Line || 50 lengths per spool. <code>LOOK</code> at the braided wire: "''looks exceptionally strong''".
|-
| a leaf-topped grey mandrake lure with tiny thorn teeth || '''Surface''' lure || +16 surface, +12 middle, +12 deep
|-
| a pale carved skull-shaped lure with granite-inset eyes || '''Middle''' lure || +12 surface, +16 middle, +12 deep
|-
| a twisted iron ebon gate lure dangling a tiny gold key || '''Bottom''' lure || +12 surface, +12 middle, +16 deep
|-
| a shimmering blown glass weight flecked with glitter || Sinker || "''heavy enough to sink a line to the middle depths''"
|-
| a translucent glaes weight with gleaming metallic veins || Sinker || "''heavy enough to sink a line to the bottom''"
|}

Also on sale next door in Rodnir's Folly: the [[Super-Fish-All Tackle Box]] (holds line, lures and weights, and can be unlocked to hold fish), [[Bugs 2 Lure Jig]]s, fishing hats, and the Life Aquatic collection items.

'''Filleting knife:''' bring any dagger. Every Ebon Gate fish in the sample was "''completely eviscerated''" (no usable fillet) when cut open, but the prize was always found. The fillet bonuses described on [[Fishing]] don't matter here.

=== Rigging the rod ===
{| class="wikitable"
! Action !! Command !! Game message
|-
| Snap a length off a spool || <code>PULL MY WIRE</code> || ''You uncoil a bit of wire from your braided fishing wire and snap it off swiftly.''
|-
| String the rod || <code>PUT MY LENGTH ON MY POLE</code> || ''You coil some of your braided fishing wire around the reel of your black fishing pole before threading the remainder through its guides.''
|-
| Attach a lure || <code>PUT MY LURE ON MY POLE</code> || ''You carefully fasten your … near to the fishhook dangling from your fishing rod.''
|-
| Attach a sinker || <code>PUT MY WEIGHT ON MY POLE</code> || ''Using some slack from your line, you deftly string your glaes weight onto your black fishing pole.''
|-
| Remove a lure or sinker || <code>GET LURE FROM MY POLE</code> || Refer to gear by noun plus at most one adjective: "grey lure" works, but "grey mandrake lure" does not.
|-
| Cut off the line || <code>CUT MY POLE</code> || ''With a swift, sharp tug, you snap the line of your black fishing pole. Your skull-shaped lure and blown glass weight fall to the ground at your feet.''
|-
| Check the rod || <code>LOOK MY POLE</code> || Shows how far out the line is, the depth, the line condition, and the lure and its bonuses.
|}

Things to know:
* '''<code>CUT</code> only works with a lure on the line.''' With no lure the game refuses, so attach a lure before cutting off a worn line.
* '''Everything on the line drops at your feet when you cut it.''' Items at your feet stop you from moving: "''As you prepare to move away, you remember the … still placed alongside you.''" Pick them back up.
* '''You can't restring a line that's still intact.''' Cut it first.
* Spool size: 50 lengths. A length strings one rod.

=== Line condition ===
<code>LOOK MY POLE</code> reports the line's condition. It wears with every fight:
{| class="wikitable"
! Stage !! Message
|-
| 1 || ''The pole's line looks to be in excellent condition.''
|-
| 2 || ''The pole's line looks to be in decent condition.''
|-
| 3 || ''The pole's line looks to be showing signs of use.''
|-
| 4 || ''The pole's line looks to be frayed and in danger of snapping soon.''
|}
Replace the line once it reaches '''frayed'''. A snap mid-fight loses the fish, the line, the lure and the sinker: "''The line of your black fishing pole strains and breaks with a sharp *SNAP*!''" Afterwards, <code>LOOK MY POLE</code> shows "''The line of black fishing pole has snapped and will need to be replaced.''" With frayed lines replaced, only 2 lines snapped in 637 catches. How fast a line wears depends heavily on [[#Line wear and the 300-foot limit|cast distance]].

== The docks ==
There are four docks, each reached from its own entrance on the Gleyminn Anni River. The moss-covered rafts travel between the entrances. The rafts at the Misty Waters entrance sometimes don't come.

{| class="wikitable"
! # !! Dock !! Entrance (Lich ID / room) !! Fishing spots (Lich ID / room)
|-
| 1 || Stream of Reflections || 31834 / 8083431 ''Gleyminn Anni River, Island'' || 32116 / 8085010, 32117 / 8085009, 32118 / 8085008
|-
| 2 || Misty Waters || 31846 / 8083429 ''Gleyminn Anni River, Rocky Path'' || 32126 / 8085004, 32127 / 8085003, 32128 / 8085002
|-
| 3 || Mold Marsh || 32074 / 8083430 ''Gleyminn Anni River, Shore'' || 32120 / 8085007, 32121 / 8085006, 32122 / 8085005
|-
| 4 || Moss Pond || 32073 / 8083432 ''Gleyminn Anni River, Shore'' || 32123 / 8085012, 32124 / 8085013, 32125 / 8085011
|}

=== Entry fee ===
<code>GO DOCK</code> at an entrance:
* ''A horrific, ghostly apparition steps in front of you and states, "It will cost 50 soul shards to visit the dock. If you wish to pay the cost and continue, GO dock again."''
* ''A horrific, ghostly apparition swirls around you and collects 50 soul shards.''

=== Teleport after every catch ===
Landing a fish ends your visit: "''Flashing, prismatic lights swirl around you, pulling you out of the area!''" You land back at the dock's entrance, so '''every fish costs 50 soul shards'''. A snapped line doesn't teleport you, so you can restring on the dock and recast without paying again.

=== Overfishing ===
Fishing holes elsewhere can become overfished ("''It looks like this area has been heavily overfished.''"). Overfishing is '''disabled''' at Ebon Gate (confirmed by a GM). Every spot on a dock is the same, and sharing a spot with other players has no penalty.

=== Sharing a dock ===
You'll see your neighbours' fishing messages in the third person. Only lines that say '''your''' are about you. For example:
* ''With a sudden surge, the catch yanks the line of Lakishiie's rod forward…'' (not yours)
* ''The line of your black fishing pole whips forward…'' (yours)

== Fishing, step by step ==
=== 1. Casting ===
<code>FISH CAST NEAR</code>, <code>FISH CAST MIDDLE</code> or <code>FISH CAST FAR</code> (7 seconds roundtime):
{| class="wikitable"
! Distance !! Landing message !! Line lands at
|-
| Near || ''…before landing with a soft *plink* right off of the side of the dock.'' || ~88 ft
|-
| Middle || ''…landing with a soft *plink* a good distance from the dock.'' || ~184 ft
|-
| Far || ''…landing with a soft *plink* quite a large distance from the dock.'' || ~274 ft
|}
Other replies: ''You must be holding a fishing rod.'', ''You can't cast without a free hand.'', ''You've already cast the line…''

The depth comes from the sinker, and <code>LOOK MY POLE</code> confirms it:
{| class="wikitable"
! Sinker !! Depth !! Look message
|-
| none || Surface || ''Judging from the tiny, frenetic twitches traveling along the line, the … lure attached to it is skimming the surface of the water.''
|-
| blown glass weight || Middle || ''The faint, rolling twitches traveling along the line suggest that the … lure attached to it is drifting on the currents of the water's middle depths.''
|-
| glaes weight || Bottom || ''The line is almost completely still, leading you to believe that the … lure attached to it is resting on the bottom.''
|}

=== 2. Waiting for a bite ===
While the line sits, the game makes a '''bite roll every 30 seconds''', starting 30 s after the cast. Each roll is shown as, e.g., <code>[Fishing result: 102 (Open d100: 77)]</code>.
* A result of '''101 or more''' hooks a fish. A result of exactly 100 still misses.
* The modifier (result minus the d100) is set by '''cast distance''':

{| class="wikitable"
! Cast !! Bite modifier !! d100 needed !! Hook chance per roll !! Median wait
|-
| Near || +26 || 75+ || ~26% || ~65 s
|-
| Middle || +31 || 70+ || ~31% || ~60 s
|-
| Far || +36 || 65+ || ~36% || ~63 s
|}
* '''Depth did not change the modifier''' when each lure was used at its own depth (mandrake at the surface, skull in the middle, ebon gate on the bottom). The +16 bonus applied equally at all three depths.
* Fishing level adds a little: about +0.2 per level. See [[#Fishing level and skill gain|Fishing level]].
* Waiting doesn't need any input from you. There's no need to reel while waiting.

The game picks one of several flavour messages for a missed roll, regardless of how close the roll came, for example:
* ''A few bubbles drift lazily to the surface, but the line of your … remains still.''
* ''You watch intently as the line of your … drifts, but the depths remain unyieldingly calm, even the fish unimpressed with your efforts.''
* ''You feel a faint tremor through the line of your …--a false hope, as it is only the current…''
* ''A faint shimmer of light catches on the … lure of your … as it bobs in the water, but nothing rises from the depths to investigate.''
* ''You wait patiently as the … lure of your … drifts aimlessly in the current. No curious fish take notice.''

A hook:
: ''You feel a brief jerk on your line before it begins to reel out wildly. You manage to yank your black fishing pole back to set the hook. The pole bends and its tip dips as the catch on your line weaves back and forth in a frantic effort to escape!''

<code>WEIGH MY POLE</code> while a fish is on reports its weight: "''You carefully examine the black fishing pole and determine that the weight is about 4 pounds.''"

=== 3. The fight ===
Each <code>FISH REEL</code> (about 6–8 seconds roundtime) is a roll against the fish. Between your reels, the fish takes its own turns and pulls line back out. A result of 100+ is a success, and the message only tells you whether the roll passed or failed:
* '''Reel gains line:''' ''Your muscles work in steady rhythm as the line of your … tightens and the reel clicks smoothly.'', ''Your grip steadies as you reel your …, the tension on the line taut but controlled.''
* '''Reel fails:''' ''Your … groans in protest as you try unsuccessfully to reel in your catch…'', ''You brace yourself and reel with all your strength, but the line feels locked in place.''
* '''Fish turn, you hold it:''' ''Your catch fights, sending small ripples across the water. You maintain control…''
* '''Fish turn, it takes line:''' ''With a sudden surge, the catch yanks the line of your … forward…''
* '''Fish turn at the line's limit:''' ''Your … bends alarmingly as the fish at the end of your line jerks and tugs violently in its attempt to escape. You have no more slack to let loose!''
* '''Landed:''' ''You give your … one final tug and the rainbow roosterfish comes wriggling to the surface! Moving swiftly, you quickly unhook it from the line and take hold of it tightly.''
* '''Progress''' (sometimes shown): ''Your hook is now about 23 feet away.''

'''Every fight has two stages.'''
# '''The fish is fresh.''' For about the first '''100 seconds''' (about 15–16 reels) the reel modifier sits around '''−23''' (it was −25 at level 0), so reels almost never gain line. The fish pulls the line out toward the 300 ft limit.
# '''The fish tires.''' The modifier suddenly jumps by about '''+70''' (to about +48), nearly every reel gains line, and the fish comes in.

It's the reeling that tires the fish. In a test, resting 180 s before reeling left the modifier flat, and the fish tired 13 reels after the reeling began. '''Reel straight away and keep reeling.''' A fight lasts about '''200–230 seconds / 30–36 reels''', almost regardless of distance, depth, rarity or fish weight.

=== 4. The catch and its prize ===
After the teleport, cut the fish open: <code>CUT MY <fish> WITH MY DAGGER</code>.
: ''You cut into the iridescent roosterfish's flesh and after a few deft strokes, completely eviscerate the poor creature. Brushing guts and scales off both your hands and dagger, you wonder if that particular type of fish just wasn't meant for filleting.''
: ''In addition, you find a slice of golden requiem sunstone inside the roosterfish's belly. You toss the remaining carcass aside.''

'''Every Ebon Gate fish held a prize''' (625 of 625). <code>FISH TOTAL</code> tallies your catches by rarity. Ebon Gate fish have no "''It is of … quality''" line when you <code>LOOK</code> at them, so check which <code>FISH TOTAL</code> count went up to find out a catch's rarity.

== Fish ==
Each depth has its own fish. The ichor-covered tendrils and the tentacled aberration appear at every depth.

{| class="wikitable"
! Rarity !! Surface (no sinker) !! Middle (blown glass) !! Bottom (glaes)
|-
| Common || glowing butterflyfish || giant ratfish || viridian-spined lionfish<br/>long-spined lionfish
|-
| Uncommon || aquamarine parrotfish<br/>pale yellow parrotfish<br/>viridian parrotfish || green-black frogfish<br/>grey and brown frogfish || six-horned cowfish<br/>four-horned cowfish
|-
| Rare || multihued roosterfish<br/>iridescent roosterfish<br/>rainbow roosterfish || floppy-finned dogfish<br/>dark umber dogfish || violet-spined hogfish<br/>ichor-covered tendrils (sometimes)
|-
| Epic || yellow-finned batfish<br/>ichor-covered tendrils || jagged-toothed tigerfish<br/>ichor-covered tendrils || three-eyed catfish<br/>ichor-covered tendrils (sometimes)
|-
| Legendary || tentacled aberration || tentacled aberration || tentacled aberration
|-
| Weight || 2–5 lb || 4–9 lb || 7–14 lb
|}

=== Rarity odds ===
From one character's <code>FISH TOTAL</code> after 637 Ebon Gate catches:
{| class="wikitable"
! Rarity !! Count !! Share
|-
| Common || 258 || 40.5%
|-
| Uncommon || 170 || 26.7%
|-
| Rare || 119 || 18.7%
|-
| Epic || 66 || 10.4%
|-
| Legendary || 24 || 3.8%
|-
| ''Lines snapped'' || 2 ||
|}
Rare-or-better fish were about a third of catches at every depth (surface 36%, middle 32%, bottom 28%), and epic and legendary odds were the same at every depth (about 14%). '''Depth mainly decides the species and weight, not the odds of a rarer fish.''' Rarer fish didn't fight any longer:

{| class="wikitable"
! Rarity !! Fights !! Average fight !! Reels !! Average weight
|-
| Common || 258 || 214 s || 33.5 || 5.7 lb
|-
| Uncommon || 164 || 215 s || 33.8 || 5.6 lb
|-
| Rare || 116 || 214 s || 33.3 || 5.1 lb
|-
| Epic || 63 || 222 s || 34.6 || 5.8 lb
|-
| Legendary || 24 || 220 s || 34.1 || 6.0 lb
|}

=== Prizes ===
Prizes come from a shared pool, whatever the fish's rarity or depth. Common finds include:
* vellum and parchment pages
* skirt pins and spider pins
* wispstone, auroraline, everine, agate and soulstone gems
* horsehair pendants and wrist-cuffs
* tombstones, coffins (containers, so empty them before selling) and tarantulas
* bottles, dyes and masks
* occasionally a glittery fishing lure

The '''ridge-edged painted wooden coin''' (the token used at the Bittermere Woods wishing well) came from '''12 of 635 catches (~2%)''', from fish of every rarity and depth and at every distance and dock. Its find message is the same as any other prize's.

== Analysis ==
''The data comes from automated fishing logs ([[Lich]] <code>tfish</code> v2.0.0 with verbose debugging) of one character at Stream of Reflections, October 10–13, 2026. The character's fishing level went from 0 to 20 over that time. About 640 fights were logged, about 450 of them in an even rotation of all nine cast distance × depth pairs, with each depth using its own lure. All times are Eastern, which is the game's clock.''

=== Cast distance ===
{| class="wikitable"
! !! Near !! Middle !! Far
|-
| Bite modifier || +26 || +31 || +36
|-
| Line lands at || ~88 ft || ~184 ft || ~274 ft
|-
| Median wait for a bite || ~65 s || ~60 s || ~63 s
|-
| Average fight || ~205 s || ~223 s || ~224 s
|-
| Cast to landed fish || ~326 s || ~307 s || ~320 s
|-
| "No more slack" turns per fight || 0.0 || 1.1 || 4.9
|-
| Fish landed per line || ~11.5 || ~8.8 || ~6.5
|-
| Rare or better || 36% || 34% || 27%
|}
* Near's shorter fights don't make up for its slower bites. '''Middle is the most efficient''', by about 5%.
* Far puts the most strain on the line for no gain in speed, and it had the lowest share of rare-or-better fish in the sample.
* Near makes a line last the longest.

=== Line wear and the 300-foot limit ===
The line can run out to at most '''300 feet'''. While the fish is fresh it pulls toward that limit, and each fish turn there gives "''You have no more slack to let loose!''". Lines wear faster under that strain:
* A far cast already starts at ~274 ft, so it reaches the limit about 5 times a fight. A line lasts about 6–7 fish.
* A near cast starting at ~88 ft never reached it. A line lasts about 11–12 fish.

Line is cheap next to the dock fee, so this mostly costs time spent restringing.

=== Depth ===
{| class="wikitable"
! Depth !! Fights !! Common !! Uncommon !! Rare !! Epic !! Legendary !! Average weight
|-
| Surface || 147 || 34% || 29% || 22% || 10% || 4% || ~3.5 lb
|-
| Middle || 146 || 43% || 25% || 18% || 9% || 5% || ~5.9 lb
|-
| Bottom || 146 || 45% || 27% || 14% || 10% || 4% || ~10.0 lb
|}
Epic and legendary odds were the same at every depth. The surface gave slightly more rare fish, but that difference is about the size of the random spread for ~146 fights each. Fish a depth for its species and weight.

=== Time of day ===
{| class="wikitable"
! Eastern time !! Fights !! Average bite wait !! Hook chance per roll !! Average fight !! Rare or better
|-
| 00–03 || 60 || 121 s || 25% || 209 s || 31%
|-
| 03–06 || 62 || 110 s || 27% || 210 s || 34%
|-
| 06–09 || 69 || 87 s || 34% || 200 s || 30%
|-
| 09–12 || 42 || 120 s || 25% || 212 s || 32%
|-
| 12–15 || 31 || 101 s || 29% || 245 s || 45%
|-
| 15–18 || 30 || 134 s || 23% || 230 s || 30%
|-
| 18–21 || 41 || 92 s || 32% || 212 s || 42%
|-
| 21–24 || 58 || 108 s || 28% || 217 s || 31%
|}
'''No time-of-day effect was found.''' The bite modifier changed from day to day (fishing level), not with the hour. The swings above are within the random spread for 30–70 fights per block.

=== Fishing level and skill gain ===
Each skill gain shows: "''Satisfaction surges through you as you gain new insights into the art of fishing!''" Check your level with <code>FISH STATUS</code>:
<pre>
Fishing Level: 15
Active Perks:
none
You will unlock your second Fishing Perk when you achieve level 25 in Fishing.
</pre>
* '''Levels are capped at 5 per day''' at Ebon Gate. The logged character went 0 → 5 → 10 → 15 → 20 on consecutive days, and the count starts over at '''midnight Eastern'''.
* Skill gains came with landed fish of any rarity.
* Each level added about '''+0.2''' to the bite and reel modifiers. The reel modifier at the start of a fight went from −25 at level 0 to about −20.5 at level 20. That's minor next to cast distance (+5 per step).
* Perk slots open at levels 10, 25, 50 and 100 (see [[Fishing]]).

Which catch of the day each level came on:
{| class="wikitable"
! Day !! Catch numbers !! Day's last level at
|-
| Oct 11 || 1, 4, 6, 13, 15 || 01:25
|-
| Oct 12 || 2, 4, 9, 12, 16 || 01:27
|-
| Oct 13 (after the GM change) || 17, 20, 45, 68, 101 || 09:31
|}

=== October 12 changes ===
A GM posted on October 12:
<blockquote>Fish have had their stamina significantly reduced, but there is a much lower chance to rank up in fishing on the EG grounds now.</blockquote>
* '''Ranking up:''' clearly lower. The day's 5 levels took about 100 catches instead of about 15.
* '''Fish stamina:''' not yet visible. Fights logged up to October 13 10:20 still averaged ~215 s, and the fish still tired at ~100 s. The character stayed logged in throughout, so the change may only apply after logging in again or a game reboot.

=== Throughput and cost ===
* About '''10–11 fish an hour''' while fishing continuously.
* About '''525 soul shards an hour''' in dock fees, plus a line every ~9 fish and lures and sinkers that only run out when a line snaps.

== Recommendations ==
* '''Cast middle.''' It gives the most fish per hour, and lines last longer than at far. Cast near if you'd rather restring less often.
* '''Use the matching lure for your depth''' (mandrake at the surface, skull with blown glass, ebon gate with glaes).
* '''Choose a depth for the fish you want''' (species and weight), not for rarity.
* '''Reel immediately and keep reeling.'''
* '''Replace frayed lines before casting.''' Attach a lure first so <code>CUT</code> works, and pick up what falls at your feet.
* '''Gaining skill''' is limited to 5 levels a day, starting over at midnight Eastern.

== Automation ==
The [[Lich]] script <code>tfish</code> (elanthia-online/scripts, v2.0.0+) automates all of the above:
* entering the dock and paying the fee;
* casting, waiting and reeling;
* replacing worn lines (<code>replace_line_at</code>);
* lures for each depth (<code>lure_surface</code>, <code>lure_middle</code>, <code>lure_deep</code>);
* cycling the sinker and cast distance (<code>cycle_weights</code>, <code>cycle_distance</code>);
* filleting and stashing prizes, with an <code>announce_finds</code> report;
* picking a dock (<code>dock</code>: 1–4 or a name).

<code>;tfish check</code> confirms your gear and <code>;tfish list</code> shows your settings.

== Open questions ==
* What message does a fish that escapes without snapping the line give?
* Does the Tier 5 "''…probably deserves a close inspection''" prize message exist in the new system?
* Does the October 12 stamina change apply after logging in again?

== See also ==
* [[Fishing]]
* [[Fishing equipment]]
* [[Verb:FISHING]]
* [[Fishing guide]]
* [[List of fish]]
* [[Fishing/Legacy fishing system]]
* [[Ebon Gate Festival]]
* [[Soul shard]]
* [[EHShop:Rodnir's Bait and Tackle]]

[[Category:Fishing system]]

Lich:Software/Installation

2026-10-08T21:29:11Z

HORIBU1: /* Lich Changelog */ add changelog for 5.21.0 and 5.22.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.22.0 supporting Ruby 4.0 - published October 8, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.22.0'''
<PRE>
### Features (general)
* add opt-in bounded script execution guards (#1575)
* add static-only map route selection (#1577)
* bounded fput with max_resends, interrupt, resend_transient and failure symbols (#1587)
* Spell.results_regex, the lines cast waits on, exposed (#1590)
* add Events, a script-to-script notification primitive; combat emits on it (#1619)
* add deterministic hook priorities (#1621)
* Map.boundary_rooms_for(ids), the perimeter of any set of rooms (#1660)
* sticky ever_hostile? keeps Sympathy'd creatures in targets (#1665)
* --pipe -g honours the frontend flag, and --sentinel requests the origin marker (#1677)

### Features (gs)
* add trustworthy combat observation provenance (#1576)
* Lich::Gemstone::Stance, a shared stance setter (#1578)
* Lich::Stash.wield and Stash.hands put named items into hands (#1579)
* Lich::Gemstone::Mana.pulse, the MANA PULSE verb once (#1580)
* Lich::Gemstone::Bank, Currency refresh, and WEALTH parser lines (#1581)
* PSM command and results_regex readers, factored out of use (#1583)
* Lich::Gemstone::Fog, the ways home on the spell and society readers (#1584)
* Combat::Messages - non-combat message families as observer events (#1586)
* society command readers, factored out of use (#1589)
* Group.join, the follower's side of Group.add (#1591)
* emit post-commit combat recorder receipts (#1592)
* combat definition supplements from a player YAML file (#1607)
* message definitions from the player supplement file (#1608)
* creature library - abilities from session logs, limbs flags, triggers as hash of arrays (#1623)
* expose exact server creature health from crtrStatus (#1661)

### Bug Fixes (general)
* fix spec stub race breaking FFI loads, gate WindowsCredentialManager to Windows (fixes #1542) (#1573)
* setup_files uses content hash for cache freshness (#1596) (#1599)
* creatures registry housekeeping independent of Combat::Tracker (#1603)
* place effect-list.xml backups in the update snapshot folder (#1606)
* retain discovery ownership through cleanup (#1612)
* Initial Lich state update and detachable-client split GS/DR (#1617)
* bound move()'s remedy retries, record why a move failed, lift it into Lich::Common::Move (#1622)
* update puts to Lich.log (#1630)
* create detachable-client session file without --login (#1656)
* converge server_time_offset instead of resetting it every prompt (#1663)
* plain-language lich5-update messages when GitHub fails (#1687)
* Inventory.refresh waits out roundtime before sending (#1688)

### Bug Fixes (dr)
* update HOW pattern to accommodate various soul states (#1620)
* restore script halt in DRCC.get_crafting_item on missing item (#1624)
* halt script when too distracted to turn recipe book (#1625)
* equipmentmanager energy bow handling (#1662)
* report when DRC.rummage can't read a container (#1671)
* DRCI.get_item? confirms #<id> gets by the item id in hand (#1674)
* DRCT.sell_item references the item through DRCI.item_ref (#1675)
* DRCA.do_buffs filters day/night spells without mutating settings (#1680)
* DRCI.tie_item? no longer reports an empty pouch as tied (#1684)
* DRC.play_song? keeps climbing and performance songs across instrument switches (#1686)

### Bug Fixes (gs)
* Injured cache lives on the class and keys on an injury fingerprint (#1582)
* infomon - a spell's start message refreshes a refreshable timer (#1585)
* Group.broken? waits on Lich::Claim::Lock, the constant that exists (#1588)
* combat module - hunt-log audit: interrupted-swing resume, status attribution by event, spell-loss cause, live defs (#1593)
* QStrike prices MSTRIKE's own stamina cost (#1594)
* combat module - a stand-up message later in the chunk outranks an earlier knockdown crit (#1595)
* track spell cooldowns on the characters a spell locks out (#1597)
* catalog missing deity-specific strike lines for Divine Wrath (335) (#1598)
* combat module - Rysk/Dreadt log audit: Holy Weapon release model, held maneuver rolls, AoE roll attribution, live defs (#1600)
* Combat defs add thrust as a basic attack (#1615)
* preserve group state after ambiguous disband reply (#1629)
* target ridden mounts before their first crtrStatus (#1669)
* snapshot Effects registries so scripts can't break the XML parser (#1672)
</PRE>
'''5.21.0'''
<PRE>
### Features (general)
* Add --refresh-characters and --add-character CLI flags (#1504)
* add --active-session-dir to decouple Active Sessions coordination from --temp (#1520)
* add read model for the inventoryManager extended feed (#1524)
* GUI add configurable frontend registry (#1558)
* add HTTPS web-login fallback for when EAccess (7910) is unreachable (#1570)

### Features (dr)
* player-supplied custom prep/cast/invoke messages (#1528)
* opt-in cambrinth charge distribution across configured items (#1549)
* populate GameObj from INV LIST full refresh (02 of 05) (#1554)
* non-destructive upsert for INV SEARCH / category scrapes (03 of 05) (#1556)
* reconcile GameObj containers on hand pickup (04 of 05) (#1557)
* [DRCC] add shared private-forge helpers (#1560)

### Features (gs)
* creature template library - measured combat data, HP/speed censuses, messaging (#1539)

### Bug Fixes (general)
* enforce Script#pause at every blocking/mutating checkpoint (#1537)
* always report missing gems on stderr; only wait on a dialog without a tty (#1544)
* dispatch --help and --version before the GTK require (#1546)
* global_def update deprecated method calls to include caller info (#1550)
* normalize colons in Lich::Util.normalize_lookup (#1561)
* Script.log respects --log-dir/LOG_DIR override; use File.join for paths in script.rb (#1572)

### Bug Fixes (dr)
* drvariables add more data to VOL_MAP (#1536)
* pin capped skills to 34 in DRSkill.clear_mind (#1548)
* match lowercase "it's already open" when opening a container (#1553)
* normalize capitalized leading articles in inventory scrape names (01 of 05) (#1555)
* make INV LIST refresh atomic and warn on interruption (05 of 05) (#1563)
* refresh before_name/after_name on a name-preserving container move (#1564)
* do not re-add a held item as worn inventory on inv scrape (#1565)
* evict orphaned identity-index entries on a name-changing upsert (#1566)
* unpause the exact scripts safe_pause_list paused, by object (#1574)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1540)
* correct messaging drift in 13 crit table patterns (#1547)
* combat module - event defs, observer emissions, replay-verified parsing, SQLite recorder (#1559)
</PRE>
'''5.20.1'''
<PRE>
### Bug Fixes (general)
* bound EAccess auth with a timeout so a stalled SGE backend can't hang Lich silently (#1502)
* Linux WINE and Wrayth FE detection (#1517)
* update Gemstone game-code validations (#1518)
* preserve bundled display-state tags on quiet-suppressed chunks (#1530)
* prevent a stray formatting character from appearing in Saga during quiet script output (#1532)

### Bug Fixes (dr)
* make $safe_pause_lock holder immune to pause (#1525)

### Bug Fixes (gs)
* critranks.rb tolerate nil table rows, fix reload!, index patterns … (#1522)
* combat module hardening - ordered processing, 22x faster parsing, double-count fix (#1523)
</PRE>
'''5.20.0'''
<PRE>
### Features (general)
* add concurrent runtime I/O and multi-client detach support (#1459)
* --bind-address speaks the same keywords as --detachable-client (#1461)
* GUI Launcher Improvements (#1463)
* Add supervised child script APIs (01 of 06) (#1474)
* Add forced script teardown command (06 of 06) (#1479)
* teardown and distinguishable errors for Script.run_child (#1501)

### Features (dr)
* DRCMM.moon_weapon_duration - read a moon weapon's remaining life (#1483)
* id-based creature tracking from crtrStatus + assess (#1485)
* capture room UID from <nav> tag; stop enforcing ShowRoomID; opt-in room-id placement (#1491)
* user-extensible scroll substitutions via settings (01 of 06) (#1512)
* user-extensible boxes and trash receptacles (03 of 06) (#1514)
* user-extensible summoned-weapon adjectives (04 of 06) (#1515)
* user-extensible flavor-text stripping (05 of 06) (#1516)

### Features (gs)
* gameobj add full_name matcher to type/sellable classification (#1453)

### Bug Fixes (general)
* prevent empty/partial GameObj registry reads during mid-stream refresh (#1370)
* no-op Gtk.lich_main_quit when no main loop is nested (#1464)
* correct path-flag aliases and document all path options (#1472)
* Synchronize script lifecycle transitions (02 of 06) (#1475)
* Coordinate script shutdown draining (03 of 06) (#1476)
* Harden script lifecycle ownership (05 of 06) (#1478)
* surface the underlying LoadError in dependency alerts (#1480)
* extract game-agnostic CreatureBase into lib/common (#1484)
* bound GemCheck alert dialogs with a timeout so they can't hang forever (#1488)
* identify Genie as the frontend for headless launches (#1490)
* restore detachable client disconnect notice to stdout (#1492)
* harden detachable client teardown and escape init payload (#1493)
* resolve GameObj status visibility during staged refresh (#1497)
* compact client write queue instead of ending the session (#1498)
* scrub startup credentials once login completes (#1499)
* Honor Simu-side teardown for 10 seconds (#1505)

### Bug Fixes (dr)
* resolve no-UID rooms carrying a stored UID instead of returning nil (#1467)
* equipmanager.rb - reliable ranged-weapon transitions - stow ammo after unload + verify offhand wield hand (#1468)
* common-healing.rb - DRCH.bind_wound: only dispose a dislodged item while it is in hand (#1469)
* preserve game RealID in room title (GS parity for ";display roomid title") (#1500)
* Refine need_buffs? logic for non-recast spells to correctly check cyclic spells. (#1503)
* reduce symbol-torn scale scrolls to gettable noun (#1506)
</PRE>
'''5.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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-10-08T21:27:21Z

HORIBU1: /* Installing the Latest Stable Release */ update to 5.22.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.22.0 supporting Ruby 4.0 - published October 8, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.20.1'''
<PRE>
### Bug Fixes (general)
* bound EAccess auth with a timeout so a stalled SGE backend can't hang Lich silently (#1502)
* Linux WINE and Wrayth FE detection (#1517)
* update Gemstone game-code validations (#1518)
* preserve bundled display-state tags on quiet-suppressed chunks (#1530)
* prevent a stray formatting character from appearing in Saga during quiet script output (#1532)

### Bug Fixes (dr)
* make $safe_pause_lock holder immune to pause (#1525)

### Bug Fixes (gs)
* critranks.rb tolerate nil table rows, fix reload!, index patterns … (#1522)
* combat module hardening - ordered processing, 22x faster parsing, double-count fix (#1523)
</PRE>
'''5.20.0'''
<PRE>
### Features (general)
* add concurrent runtime I/O and multi-client detach support (#1459)
* --bind-address speaks the same keywords as --detachable-client (#1461)
* GUI Launcher Improvements (#1463)
* Add supervised child script APIs (01 of 06) (#1474)
* Add forced script teardown command (06 of 06) (#1479)
* teardown and distinguishable errors for Script.run_child (#1501)

### Features (dr)
* DRCMM.moon_weapon_duration - read a moon weapon's remaining life (#1483)
* id-based creature tracking from crtrStatus + assess (#1485)
* capture room UID from <nav> tag; stop enforcing ShowRoomID; opt-in room-id placement (#1491)
* user-extensible scroll substitutions via settings (01 of 06) (#1512)
* user-extensible boxes and trash receptacles (03 of 06) (#1514)
* user-extensible summoned-weapon adjectives (04 of 06) (#1515)
* user-extensible flavor-text stripping (05 of 06) (#1516)

### Features (gs)
* gameobj add full_name matcher to type/sellable classification (#1453)

### Bug Fixes (general)
* prevent empty/partial GameObj registry reads during mid-stream refresh (#1370)
* no-op Gtk.lich_main_quit when no main loop is nested (#1464)
* correct path-flag aliases and document all path options (#1472)
* Synchronize script lifecycle transitions (02 of 06) (#1475)
* Coordinate script shutdown draining (03 of 06) (#1476)
* Harden script lifecycle ownership (05 of 06) (#1478)
* surface the underlying LoadError in dependency alerts (#1480)
* extract game-agnostic CreatureBase into lib/common (#1484)
* bound GemCheck alert dialogs with a timeout so they can't hang forever (#1488)
* identify Genie as the frontend for headless launches (#1490)
* restore detachable client disconnect notice to stdout (#1492)
* harden detachable client teardown and escape init payload (#1493)
* resolve GameObj status visibility during staged refresh (#1497)
* compact client write queue instead of ending the session (#1498)
* scrub startup credentials once login completes (#1499)
* Honor Simu-side teardown for 10 seconds (#1505)

### Bug Fixes (dr)
* resolve no-UID rooms carrying a stored UID instead of returning nil (#1467)
* equipmanager.rb - reliable ranged-weapon transitions - stow ammo after unload + verify offhand wield hand (#1468)
* common-healing.rb - DRCH.bind_wound: only dispose a dislodged item while it is in hand (#1469)
* preserve game RealID in room title (GS parity for ";display roomid title") (#1500)
* Refine need_buffs? logic for non-recast spells to correctly check cyclic spells. (#1503)
* reduce symbol-torn scale scrolls to gettable noun (#1506)
</PRE>
'''5.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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/Changelog

2026-10-03T16:28:00Z

HORIBU1: /* Change Log */ update to 5.16.6

{{3rd-party}}
== Change Log ==

<pre{{log2|background=none|border=none|margin-left=none|margin-right=none|font-size=93%}}>
v5.16.6 (2026-09-27)
- fix: bigshot could get stuck spamming failed target attempts on a creature that had already fully decayed/left the room, instead of picking a new one
v5.16.5 (2026-09-23)
- fix: mounts (e.g. a gigas's battle mastodon) were ignored as targets until something else hurt them first
- fix: Rangers leading a group with a follower count (e.g. ;bigshot head 2) would try to track the number instead of hunting normally
v5.16.4 (2026-09-21)
- fix: a follower would keep trying to attack on its own, spamming failed target attempts, if the group leader stopped running bigshot while everyone stayed grouped - followers now stand down until the leader is hunting again
v5.16.3 (2026-09-21)
- fix: a follower could get stuck spamming failed target attempts on a creature the group leader had already killed, instead of picking a new target
v5.16.2 (2026-09-16)
- fix: bigshot would stop attacking a creature as soon as it was made sympathetic (e.g. by Sympathy 1120), even though it was still fighting back
- fix: remove unnecessary strip_xml type parameter being sent, which was causing unneeded multi-line detection unnecessarily
- fix: stop a constant-redefinition warning on subsequent runs without restarting Lich
v5.16.1 (2026-09-13)
- added lying command check
v5.16.0 (2026-08-13)
- creature tracking is more accurate right after a kill or a room change, so targeting and looting are less likely to grab a stale target
- added checks for more creature states (calm, disoriented, hovering, immobilized, kneeling, sitting, sleeping, stunned, webbed, flying, rooted) and creature types (mounts, riders, mini-bosses, and more), so combat commands react to them correctly
- added checks for wounds, critical hits, and smites, so combat maneuvers can respond to them
- fixed a rare timing issue where looting could get interrupted mid-action if bigshot and the loot script were paused and resumed at nearly the same moment (e.g. by ecleanse), sometimes skipping or cutting off a loot/skin action
- coup de grace attempts are now double-checked right before they're sent, so bigshot stops wasting stamina on attempts that were already going to fail
- added an empowered<N> command option to skip a move when a strong enough Empowered buff is already active, so it can't get overwritten by a weaker recast
- added a thp<N> command option to only use a move when the target's health is at or below a set percentage
- fixed the buff<N> command option silently doing nothing
- added debug logging that tracks a target's health and status from when it's first engaged through every command tried against it to its death, for troubleshooting combat behavior
v5.15.4 (2026-08-05)
- add additional messaging for cmd_unravel
v5.15.3 (2026-07-29)
- fix to remove EXPERIENCE scraping for field exp, require new Lich to get it automatically from feed
v5.15.2 (2026-07-27)
- fix priority hunt not retargeting when a higher priority creature arrives mid-fight
- compare target list rank instead of identity so a lower ranked creature never wins a check
- match priority targets with the same anchored name and noun rules used to select them
- keep the current target when a priority retarget has no replacement to offer
- fix eachtarget commands skipping every creature except the highest ranked one
- fix follower priority check reading an instance variable that was never set
- remove the unused room npc snapshot thread and its globals
v5.15.1 (2026-07-23)
- fix cmd_force re-issuing a maneuver on a passing roll
v5.15.0 (2026-07-19)
- add repeatdelay command check, throttles a command to once per N seconds per room, clears on room change
- bugfix for once command check raising when a creature has no prior commands
v5.14.4 (2026-07-15)
- fix some beast belly edge cases
v5.14.3 (2026-07-13)
- fix missing essence regex pattern
v5.14.2 (2026-07-06)
- fix cmd_shields missing regex
v5.14.1 (2026-06-18)
- remove greedy prone check for bullrush
v5.14.0 (2026-06-17)
- add new sacrifice command
- bugfix for creature escape result regex check
v5.13.3 (2026-06-16)
- bugfix for looting when in resting status
v5.13.2 (2026-06-15)
- bugfix in run_script to only do box_in_hand if hunting
v5.13.1 (2026-06-14)
- bugfix in resonance cmd
v5.13.0 (2026-05-17)
- add new resonance command for casting bolts
- add new UNHIDE event to allow for unhiding before fogging
v5.12.8 (2026-05-14)
- use gameobj id for wandolier instead of name after being found
v5.12.7 (2026-05-07)
- allow for wandolier command to take a noreserve option, defaults to use RESERVE system
v5.12.6 (2026-05-02)
- fix for boundary building to set a new status while building boundary list, useful for scripts like teleport.lic
v5.12.5 (2026-04-22)
- fix final_loot to now work for solo as well, helps pickup left behind loot by other players, poof'd creature loot, etc.
v5.12.4 (2026-04-10)
- fix for cmd_tether spell hindrance loop
v5.12.3 (2026-03-25)
- change to wander_stance if single_stop called (bigshot quick)
v5.12.2 (2026-03-11)
- fix to catch max inventory quantity item messaging
- fix in cmd_depress for result check
v5.12.1 (2026-02-08)
- fix for cast_signs/cmd_rapid to prevent double casting due to 0sec castRT.
v5.12.0 (2026-02-08)
- add ES/EB/EC/ED for spell, buff, cooldown, and debuff command checks
v5.11.4 (2026-01-14)
- add splashy command check for Rooms that are splashy(wet)
- add essence command check to check for sorcerer shadow essence
- unhide if hidden as a head/leader to allow followers to join
- add ATTACK event to attack routine if followers get separated
- allow non-incant spell COMMANDs to respect extra cast/evoke/channel
- force GROUP OPEN after disband when doing independent travel
v5.11.3 (2026-01-12)
- bugfix in follower rejoining leader
- bugfix for missing id's in attack stance, wander stance, and stand up
v5.11.2 (2026-01-09)
- optimize get_valid_neighbors to eval timeto as being valid numerics
v5.11.1 (2026-01-09)
- bugfix in sort_npcs
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>

Lich:Script Bigshot

2026-10-02T13:43:37Z

HORIBU1: /* Hunting Commands */ update sacrifice cmd description

{{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 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 help</CODE> - Prints a quick-reference table of every command-line option listed in this section. Typing an option Bigshot doesn't recognize prints this same help (with a warning naming the bad option) instead of silently doing nothing.
* <CODE>;bigshot <mode> <creature></CODE> - Rangers only: combine one of the modes above (<CODE>solo</CODE>, <CODE>single</CODE>, <CODE>bounty</CODE>, <CODE>quick</CODE>, or <CODE>once</CODE>) with a creature name to TRACK toward that creature instead of wandering, e.g., <CODE>;bigshot single giant rat</CODE>. A creature name with no mode in front of it (just <CODE>;bigshot giant rat</CODE>) is not recognized.

==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). Note: This does not work when using <CODE>;bigshot quick.</CODE>
* '''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 <stance> <noreserve>''' - 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 and automatically adds the wand to your RESERVE list. Use <CODE>wandolier defensive</CODE> to wave in a different stance, and add <CODE>noreserve</CODE> to skip the RESERVE step, e.g., <CODE>wandolier defensive noreserve</CODE>.
** '''resonance <spell id> <spell id> ...''' - Casts Resonance Bolt, picking randomly among the listed spell numbers each time (never repeating the one it just used back-to-back). Example: <CODE>resonance 511 512 513</CODE>.
** '''sacrifice''' - Performs a sacrifice on the current target's corpse. Only attempts it when you have 2+ spirit, the ability is off cooldown, and the corpse appraises as suitable for sacrifice.
** '''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).
* '''thp#''' - Requires the ''target's'' health to be at or below #% (this is the target's health, unlike h# above which checks your own). <CODE>(!thp#)</CODE> requires the target's health to be above #%. If Bigshot can't determine the target's health, the command is skipped.

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

The following checks read the target's live status directly from the game feed, so they can be more precise than the umbrella '''prone''' check above. Each performs the command only when the target IS in that state (add <CODE>!</CODE> to require that it is NOT):
* '''calm''' - Target is calmed.
* '''disoriented''' - Target is disoriented.
* '''hovering''' - Target is hovering.
* '''immobilized''' - Target is immobilized (note: this checks the opposite condition of the existing '''frozen''' check above, which performs its command only when the target is NOT frozen).
* '''kneeling''' - Target is kneeling.
* '''sitting''' - Target is sitting.
* '''sleeping''' - Target is sleeping.
* '''stunned''' - Target is stunned.
* '''webbed''' - Target is webbed.
* '''lying''' - Target is lying down (prone).

Creature type/classification checks, also read from the game feed. Each performs the command only when the target carries that classification (add <CODE>!</CODE> to require that it does not):
* '''mount''' - Target is a mount.
* '''rider''' - Target is riding a mount.
* '''mini_boss''' - Target is flagged as a mini-boss.
* '''ascension_boss''' - Target is flagged as an Ascension boss.
* '''ascended''' - Target carries the "ascended" classification.
* '''challenging''' - Target is flagged as a tougher "challenging" variant.
* '''inferior''' - Target is flagged as a weaker "inferior" variant.
* '''disengaged''' - Target has disengaged from combat.
* '''sympathetic''' - Target is flagged as sympathetic (non-hostile).

Wound and critical-hit checks:
* '''wounded''' - Performs the command only when the target's health is at or below 25% (a fixed threshold; use '''thp#''' above for a custom percentage). <CODE>(!wounded)</CODE> requires health above 25%.
* '''fatalcrit''' - Performs the command only when the target has already suffered a fatal critical hit. <CODE>(!fatalcrit)</CODE> requires that it has not.
* '''smote''' - Performs the command only when the target has already been hit with Voln Smite. <CODE>(!smote)</CODE> requires that it has not been.

Target-specific UCS positioning checks — these read the ''target's'' individual unarmed-combat positioning, unlike the '''tier#''' checks above which track your own overall UAC tier. Each performs the command only when your positioning against ''that specific target'' matches (add <CODE>!</CODE> to require that it does not):
* '''ucsdecent''' - Positioning is "decent".
* '''ucsgood''' - Positioning is "good".
* '''ucsexcellent''' - Positioning is "excellent".
* '''ucstierup''' - A tier-up follow-up is available.

====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.
* '''k#''' - Performs the command only while you are kneeling. The number is required by the syntax but its value doesn't matter (e.g. <CODE>k1</CODE>). <CODE>(!k#)</CODE> performs the command only while you are NOT kneeling.

====Timing Checks====
* '''once''' - Performs the command once per target. Resets on room change.
* '''room''' - Performs the command once per room. Resets on room change.
* '''repeatdelay#''' - Throttles the command to once every # seconds per room, regardless of which target it's used against. Resets on room change. Example: <CODE>holler(repeatdelay60)</CODE> will not Holler again for 60 seconds after it last went off in that room.

====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.
* '''empowered#''' - Skips the command if an Empowered buff of +# or greater is already active, so a strong Coup de Grace bonus can't get overwritten by a weaker recast. <CODE>(!empowered#)</CODE> skips unless already at +# or greater.
* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds remaining. Supported for barrage, bearhug, coupdegrace, flurry, fury, garrote, pummel, shout, thrash, weed/kweed, yowlp.
* '''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.16.0 |
+---------------------------------------------------------------------------+
| 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> |
+---------------------------------------------------------------------------+

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

With <CODE>debug combat</CODE> enabled, the log also tracks each target's health and status from the moment Bigshot first engages it, through every command tried against it, to its death — useful for figuring out why a particular command check fired or didn't fire against a specific creature.

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

Gemstones

2026-09-30T18:29:19Z

HORIBU1: /* Updates: */ place closing tag back after visual edit

==Overview==

Gemstones are powerful character-boosting artifacts that creatures in [[Ascension]] hunting areas can drop upon being looted by characters who have defeated the [[Silver-scaled_cold_wyrm|wyrm]] and completed the ensuing mission [[Gemstone Quest Guide|quest]], [[A Sparkling Ascent]]. Gemstones can be equipped through the {{boldmono|[[Verb:GEM|GEM]]}} interface, starting with one equipment slot upon completing the quest and upgrading to as many as five slots.

{| {{prettytable|font-size:95%;margin-left:2em;}}
|-
! scope="col" colspan="8" | Gemstone Slot Unlocks
|-
|-
! scope="col" |Slot
! scope="col" |Ascension Experience Required
! scope="col" |Silver
|-
| scope="row" | Slot 1
| Quest
| Quest
|-
| scope="row" | Slot 2
| 1,000,000
| 5,000,000
|-
| scope="row" | Slot 3
| 2,500,000
| 10,000,000
|-
| scope="row" | Slot 4
| 4,500,000
| 25,000,000
|-
| scope="row" | Slot 5
| 7,500,000
| 50,000,000
|}
* Total of 90,000,000 silver to unlock all five slots.

A Gemstone generates with up to three properties, each categorized as common, regional, rare, or legendary. (For more details on these properties, see [[Gemstone Property List|the Gemstone Property List]].)

{| {{prettytable|font-size:95%;margin-left:2em;}}
|-
! scope="col" |Properties
! scope="col" |Qualities
|-
| scope="row" |First Property
|Common or Regional
|-
| scope="row" |Second Property
|Common, Regional or Rare
|-
| scope="row" |Third Property
|Legendary
|}

The first property can only be common or regional. If it generates with a second property, that property can be common, regional, or rare. The third property can only be legendary and only has a chance to generate on the Gemstone if that Gemstone's second property is rare.
* Players may only equip one Gemstone with a legendary property at a time.

Ultimately, characters maximizing all five slots of the Gemstone System may have a maximum of 11 equipped properties: one Gemstone will have a common/regional property, a rare property, and a legendary property while the next 2 Gemstones will have a common/regional and a common/regional/rare property. This gives a maximum of 3 rares total. With the last 2 being limited to common/regional and common/regional. The following table illustrates:

{| {{prettytable|font-size:95%;margin-left:2em;}}
|-
! scope="col" |Properties
! scope="col" |Qualities
|-
| scope="row" |1st Gemstone
|Common/Regional plus Rare plus Legendary
|-
| scope="row" |2nd Gemstone
|Common/Regional plus Common/Regional/Rare
|-
| scope="row" |3rd Gemstone
|Common/Regional plus Common/Regional/Rare
|-
| scope="row" |4th Gemstone
|Common/Regional plus Common/Regional
|-
| scope="row" |5th Gemstone
|Common/Regional plus Common/Regional
|}

==Drop Rates==

* You can obtain a maximum of 1 Gemstone per week and 3 per month.
* The chance for a weekly Gemstone to drop is reset on Sunday.
* The chance for the monthly Gemstones to drop is reset on the 1st of the month.
* You must have earned killing contribution before searching a critter for the chance to drop a gemstone. A contributor is anyone who directly assists in incapacitating, hindering, or killing the creature. This includes Binding, Tackling, Cheapshotting, E-waving, and the like. It does not include indirect assistance, such as spelling up your buddy, Guard or Protect, group-boosting warcries, etc. Similarly to how odds improve for a violet orb drop from the Arena in Duskruin.
* An individual must be eligible for both a weekly and a monthly gemstone in order to receive contribution or be eligible for a drop: If a gemstone drops on Sunday, January 31st, the individual would be ineligible for a gemstone drop through Saturday, even with their monthly allocation was reset, because they had received their weekly.
* The first gemstone of a month is easier to find than the second or third.
* There is no limit on the amount of [[Gemstone dust|dust]] you can find, but the chance of finding it goes down as you find more. This chance resets each week.

==FAQ:==
;Q. Can you equip and unequip Gemstones at will?
:A. Yes.

;Q. How much does it cost to unbind a gemstone?
:A. It costs 1-4m to permanently remove the lesser binding. [[https://gswiki.play.net/Gemstones#Unbind|Unbinding Gemstones]]

;Q. Can you Shatter a Gemstone without unbinding it?
:A. Yes, if the gemstone is lesser bound to you. No, if the gemstone is lesser bound to someone else.

;Q. How much does it cost to Shatter a Gemstone?
:A. Shattering a Gemstone is free, but it must be unbound.

;Q. If you unbind a lesser bind, and you pass it to someone, can they use it, and give it back, or does it lesser bind every time it's equipped?
:A. Yes. Equipping a gemstone causes it to lesser bind. Reshaping or amplifying causes a greater binding to the character, which is '''permanent and irreversible'''.

;Q. How many gems can you find per week?
:A. One per character, per week. Capped at 3 in a month.

;Q. When does resets occur for per month and per week?
:A. One per week reset occurs on Sundays at 12:00am EST. The same as Lumnis
:A. The monthly reset occurs on the 1st of the month. ''(Might need this to be validated still)''

==Gemstone Modifications:==

Done with the Artificier in:
Rawknuckle's, Watering Hole - 29877(u7503251)
===Costs===
NOTE: Prices are currently based on information provided during testing and may be inaccurate for the release.

===Reshape===
Reshaping a Gemstone will cause all properties of said Gemstone to reroll into new properties of the same rarity.<br>
Reshaping causes '''permanent binding''' to the character.
Reshape costs double for every additional reroll. The scaling cost resets weekly.<br>
Premium Accounts get a 25% discount.<br>
[[Viscous vial of violet vodka]] will either remove one reshape from your weekly total if imbibed, or grant a 75% discount to the silver cost if held while you order the reshape from the Artificer.

{| {{prettytable|font-size:95%;margin-left:2em;}}
|-
! scope="col" |Rarity
! scope="col" |Dust
! scope="col" |Regular Cost
! scope="col" |Premium Cost
|-
| scope="row" |Common/Regional
| 10
| 250,000
| -
|-
| scope="row" |2 Common/Regional
| 20
| 500,000
| -
|-
| scope="row" |Common/Regional + Rare
| 40
| 750,000
| 562,500
|-
| scope="row" |Common/Regional + Rare + Legendary
| 90
| 1,750,000
| 1,312,500
|}

===Amplify===
The amplify option will upgrade one property of a Gemstone. This will '''permanently bind''' the Gemstone to that character.
{|
| valign="top" |

{| class="wikitable" {{prettytable}}
|-
! scope="col" |Tier
! scope="col" |Dust
! scope="col" |Silvers
|-
| scope="row" |2/5
|15
|1,000,000
|-
| scope="row" |3/5
|30
|1,500,000
|-
| scope="row" |4/5
|45
|2,000,000
|-
| scope="row" |5/5
|60
|2,500,000
|}

|

{| class="wikitable" {{prettytable}}
|-
! scope="col" |Tier
! scope="col" |Dust
! scope="col" |Silvers
|-
| scope="row" |2/3
|45
|2,500,000
|-
| scope="row" |3/3
|105
|4,500,000
|}

|}

===Unbind===
The Unbind cost of a Gemstone is the total of each rarity cost on that Gemstone.<br>
A Gemstone that is lesser bound to someone else must be unbound before shattering.<br>
A Gemstone that is lesser bound to yourself can be shattered for free.<br>
Unbinding a lesser bind is permanent unless you amplify or reshape the Gemstone, which will greater bind it. Note: changes are pending (not finalized) that would cause EQUIP/UNEQUIP to cause lesser binding

{| {{prettytable|font-size:95%;margin-left:2em;}}
|-
! scope="col" |Rarity
! scope="col" |Silvers
|-
| scope="row" |Common/Regional
|1,000,000
|-
| scope="row" |2 Common/Regional
|2,000,000
|-
| scope="row" |Common plus Rare
|3,000,000
|-
| scope="row" |Common/Regional + Rare + Legendary
|7,000,000
|}

===Shatter===
Shattering a Gemstone turns it into dust. There is no cost for this service.

Shattering gemstones will now refund 80% of dust spent upgrading the gemstone. This is raised from the previous refund of 2 dust per upgrade.

{| {{prettytable|font-size:95%;margin-left:2em;}}
|-
! scope="col" |Rarity
! scope="col" |Dust
|-
| scope="row" |Common/Regional
|10
|-
| scope="row" |2 Common/Regional
|20
|-
| scope="row" |Common/Regional + Rare
|40
|-
| scope="row" |Common/Regional + Rare + Legendary
|90
|}

===Dust===
Your first dust purchased from the artificer costs 500k. Every additional dust costs 2.5x the previous one.
The scaling cost resets weekly. Dust found by looting creatures has no impact on these costs.

{| {{prettytable|font-size:95%;margin-left:2em;}}
|-
! scope="col" |Count
! scope="col" |Silvers
|-
| scope="row" |1
|500,000
|-
| scope="row" |2
|1,250,000
|-
| scope="row" |3
|3,125,000
|-
| scope="row" |4
|7,812,500
|-
| scope="row" |5
|19,531,250
|}

==Collection==
{{boldmono|GEM COLLECT <the gemstone in question>}} will add a gemstone to your collection. Your collection can contain up to 25 gemstones. Gemstones in your collection aren't offering you any benefit, but do not take up inventory space. If you want to receive benefit, you have to {{boldmono|GEM EQUIP <gemstone #>}}. At that point it will become one of your equipped gemstones.

==Gemstone Properties==

[[Gemstone Property List]]

==Updates:==
<pre{{log2}}>
Gemstone 4 Your Group
Ascension Gemstones now have a chance to be looted by your eligible party members when you search a creature. Ineligible party members will not infringe upon chances to find a Gemstone, and the searcher does not need to be eligible to find a Gemstone for eligible party members to have a chance to find one.
</pre>

==See Also==
* [[Announcement: Ascension Gemstones are live!]]
* [[Gemstones/saved posts]]
* [[GemstoneRebalance-Sep-29-2026]]

[[Category:Gemstones]]

Pale scaled shaper

2026-09-29T15:08:58Z

HORIBU1: /* Other Information */ fix visual edit deletion of closing tag

{{Creature start2 
| level = 102
| family = Humanoid 
| type = Biped
| otherclass = Living
| area = Sanctum
| bcs = Yes 
| hitpoints = 265
| roundtime = ?
}}
{{Creature attack attributes2 
| PA1 = 
| PAA =
| BT1 = Major Fire
| BTA = +454
| WD1 = Disintegrate
| WD2 = Cloak of Shadows
| WD3 =
| WDA = +353
| WDB = +431
| OS1 = Gas cloud
| OS2 = Major Elemental Wave
| OS3 = Spiritual Abolition
| OS4 = Condemn
| MN1 = 
| AB1 =
| ABA = 
}}
{{Creature defense attributes2 
| asg = 1
| IMM1 =
| Melee = 555+
| Ranged = 429-616
| Bolt = ?
| UDF = ?
| BarTD = ?
| CleTD = ?
| EmpTD = ?
| PalTD = 349
| RanTD = 368
| SorTD = ?
| WizTD = ?
| MjETD = 470-483
| MnETD = ?
| MjSTD = ?
| MnSTD = ?
| MnMTD = ?
| DSP1 = Spirit Warding I
| DSP2 = Spirit Warding II
| DSP3 = Lesser Shroud
| DSP4 = Cloak of Shadows
| DSP5 = Spirit Shield
| DSP6 = Bravery
| DSP7 = Thurfel's Ward
| DSp8 = Elemental Focus
| SDA1 = 
}}
{{Creature special other|Summons sidewinder cobras}} 
{{Creature treasure
| coins = Yes
| magic items = Yes
| gems = Yes
| boxes = Yes
| other = None
| skin = None
}}
{{Creature end}}

<pre{{log2|margin-right=26em}}>A pale scaled shaper is far taller than a woman ought to be, with a stretched appearance like that of a doll tugged by battling children. That is, if she is even female: the pale robes that she wears, with their faint appliqued patterns of winking copper scales, betray only the most suggestive promise of a feminine form beneath. There is something upsettingly inhuman about the shaper's face, which has the shape and proportions of a human's, but eyes that glow like green embers and a dusting of ridged scales on its cheeks and brow.</pre>

==Hunting Strategies==

Shapers spawn with [[Wall of Force (140)]] and [[Cloak of Shadows (712)]] (with retributive [[Condemn (309)]]) active) as well as [[Soul Ward (319)]]. However, if you can overcome their DS, their lack of armor leaves them vulnerable. They will occasionally cast [[Major Elemental Wave (435)]] back-to-back along with [[Divine Wrath (335)]] rarely via the evoke version.

Shapers will automatically stand from prone, even if stunned. This happens 3-5 seconds after being knocked down. Grizzled shapers (generated by [[Adventurer's Guild]] bounties) can stand up and prepare or cast a spell on the same action.

On very rare occasions, shapers can used the evoked version of Condemn, causing 10 damage cycles instantly. This may only be possible after a shaper has killed someone.

==Other Information==

Shapers will turn dead adventurers, [[Lithe veiled sentinel|Lithe Veiled Sentinels]], and [[Deathsworn fanatic|Deathsworn Fanatics]] into a [[Shambling lurk|Shambling Lurk]]:

<pre{{log2|margin-right=26em}}>
A pale scaled shaper stoops and places a hand on your chest. Green-tinged light spews from her hand, suffusing your flesh. For a moment, you feel nothing but incredible heat and power flowing through you, but something goes terribly wrong, and a cold hand tugs at your soul. Your last living sight is that of your flesh sloughing away like serpentskin, giving rise to something shambling and heinous.
</pre>

Shapers can summon [[sidewinder]] cobras on occasion if given enough time. The sidewinders can be skinned.

{{Nearlevel
|levelm2 = 100
|levelm1 = 101
|level = 102
|levelp1 = 103
|levelp2 = 104
}}

Sparkling Ascent

2026-09-22T18:21:29Z

HORIBU1: /* Details */ add link to gemstone quest guide

{{Questinfo
|quest=A Sparkling Ascent
|type=Permanent
|pageintro=It is available via the {{boldmono|QUEST}} verb. Completion of this quest provides access to [[gemstones]] and additional quests.
}}
==Details==
A detailed player guide is available at [[Gemstone Quest Guide]] but be warned as there are many spoilers inside.

{{stub}}
[[Category:Gemstones]]

Empyrean Onslaughts

2026-09-22T18:18:44Z

HORIBU1: added link to sparkling ascent quest

{{Questinfo
|quest = Empyrean Onslaughts
|type = Permanent
|prerequisite = [[Shadow's Descent]] is required for event credit
|pageintro = Use {{boldmono|[[Verb:GEM|GEM ONSLAUGHT]]}} to check whether an onslaught is currently active, where it's happening, and how much time remains. Onslaughts are timed invasion events that rotate across four [[:Category:Ascension Hunting Grounds|Ascension hunting zones]]: [[Hinterwilds]], [[Moonsedge]], [[The Hive]], and [[Sailor's Grief]]. When an onslaught is active, invasion portals appear in the targeted zone and transport you to the Empyrean fleet. Each onslaught runs for four hours before the fleet withdraws.
}}

__TOC__

==Details==
In order to be eligible for event credit for the various Empyrean Onslaughts timed quests, you must first complete [[Shadow's Descent]], which is the introductory quest for Empyrean Onslaughts and requires prior completion of a [[Sparkling Ascent]]. See that article for detailed information on the quest. Completing Shadow's Descent unlocks [[Gemstone codex|Gemstone Codices]], the weekly/monthly repeatable quests, and the GEM ONSLAUGHT command.

==Empyrean Airship Raids==
Slaying Empyrean during an active Onslaught has a chance to open a swirling portal into one of the Syndicate's airships. Fighting your way upward through the ship takes you through multi-deck combat encounters connected by mechanical lifts, with progressively increasing difficulty at higher decks. Airship raids support groups of up to five adventurers.

==Repeatable Quests==
Four new repeatable quests offer ongoing Empyrean content, available in weekly and monthly variants. They involve hunting aboard Empyrean airships or defending the ground during an active Onslaught, and reward [[Gemstone codex|Gemstone Codices]], experience, and fame. Check QUEST LIST for availability after completing [[Shadow's Descent]].

==Gemstone Geodes==
[[Gemstone geode|Gemstone Geodes]] are a collectible drop containing two [[Gemstones]] inside. Use GEM FIXATE to shift focus to finding Gemstone geodes at the expense of other kinds of loot. When found you can then choose which of the two gemstones inside the geode to extract.

==GEM Commands==
*'''GEM FIXATE''' – Sacrifice a portion of your weekly silver generation potential in exchange for an increased chance of finding Gemstones and receiving them inside a Geode.
*'''GEM STATUS''' – Check whether you are currently eligible for Gemstone drops.
*'''GEM ONSLAUGHT''' – Sense the presence and location of any active Onslaught. Requires completion of [[Shadow's Descent]].

==Gemstone Codices==
[[Gemstone codex|Gemstone Codices]] are one-time-use items that overwrite a property on one of your Gemstones with a new one, via the [[Gaunt masked artificer|masked Gemstone Artificer]].

==Additional Information==
===System Updates===
;Gem and Dust Rate Increase
Ascension Gemstones and Dust will now drop at an increased rate from Empyrean foes. Completion of Shadow's Descent is required to be eligible for this increased rate. The rate is further increased on Empyrean Airships, and is increased further on higher elevation Airships.

==See Also==
*[[Empyrean Onslaughts/saved posts|Saved posts]]
*[[Announcement:Empyrean Onslaughts]]
*[https://discordapp.com/channels/226045346399256576/1505233733559521430 Discussion:Empyrean Onslaughts and Codices]

[[Category:Permanent quests]]
[[Category:Gemstones]]
[[Category:Ascension Hunting Grounds]]

Empyrean Onslaughts

2026-09-22T18:08:40Z

HORIBU1: /* Repeatable Quests */

{{Questinfo
|quest = Empyrean Onslaughts
|type = Permanent
|prerequisite = [[Shadow's Descent]] is required for event credit
|pageintro = Use {{boldmono|[[Verb:GEM|GEM ONSLAUGHT]]}} to check whether an onslaught is currently active, where it's happening, and how much time remains. Onslaughts are timed invasion events that rotate across four [[:Category:Ascension Hunting Grounds|Ascension hunting zones]]: [[Hinterwilds]], [[Moonsedge]], [[The Hive]], and [[Sailor's Grief]]. When an onslaught is active, invasion portals appear in the targeted zone and transport you to the Empyrean fleet. Each onslaught runs for four hours before the fleet withdraws.
}}

__TOC__

==Details==
In order to be eligible for event credit for the various Empyrean Onslaughts timed quests, you must first complete [[Shadow's Descent]], which is the introductory quest for Empyrean Onslaughts and requires prior completion of "A Sparkling Ascent." See that article for detailed information on the quest. Completing Shadow's Descent unlocks [[Gemstone codex|Gemstone Codices]], the weekly/monthly repeatable quests, and the GEM ONSLAUGHT command.

==Empyrean Airship Raids==
Slaying Empyrean during an active Onslaught has a chance to open a swirling portal into one of the Syndicate's airships. Fighting your way upward through the ship takes you through multi-deck combat encounters connected by mechanical lifts, with progressively increasing difficulty at higher decks. Airship raids support groups of up to five adventurers.

==Repeatable Quests==
Four new repeatable quests offer ongoing Empyrean content, available in weekly and monthly variants. They involve hunting aboard Empyrean airships or defending the ground during an active Onslaught, and reward [[Gemstone codex|Gemstone Codices]], experience, and fame. Check QUEST LIST for availability after completing [[Shadow's Descent]].

==Gemstone Geodes==
[[Gemstone geode|Gemstone Geodes]] are a collectible drop containing two [[Gemstones]] inside. Use GEM FIXATE to shift focus to finding Gemstone geodes at the expense of other kinds of loot. When found you can then choose which of the two gemstones inside the geode to extract.

==GEM Commands==
*'''GEM FIXATE''' – Sacrifice a portion of your weekly silver generation potential in exchange for an increased chance of finding Gemstones and receiving them inside a Geode.
*'''GEM STATUS''' – Check whether you are currently eligible for Gemstone drops.
*'''GEM ONSLAUGHT''' – Sense the presence and location of any active Onslaught. Requires completion of [[Shadow's Descent]].

==Gemstone Codices==
[[Gemstone codex|Gemstone Codices]] are one-time-use items that overwrite a property on one of your Gemstones with a new one, via the [[Gaunt masked artificer|masked Gemstone Artificer]].

==Additional Information==
===System Updates===
;Gem and Dust Rate Increase
Ascension Gemstones and Dust will now drop at an increased rate from Empyrean foes. Completion of Shadow's Descent is required to be eligible for this increased rate. The rate is further increased on Empyrean Airships, and is increased further on higher elevation Airships.

==See Also==
*[[Empyrean Onslaughts/saved posts|Saved posts]]
*[[Announcement:Empyrean Onslaughts]]
*[https://discordapp.com/channels/226045346399256576/1505233733559521430 Discussion:Empyrean Onslaughts and Codices]

[[Category:Permanent quests]]
[[Category:Gemstones]]
[[Category:Ascension Hunting Grounds]]

Empyrean Onslaughts

2026-09-22T18:06:25Z

HORIBU1: /* Gemstone Geodes */ minor wording change for clarity

{{Questinfo
|quest = Empyrean Onslaughts
|type = Permanent
|prerequisite = [[Shadow's Descent]] is required for event credit
|pageintro = Use {{boldmono|[[Verb:GEM|GEM ONSLAUGHT]]}} to check whether an onslaught is currently active, where it's happening, and how much time remains. Onslaughts are timed invasion events that rotate across four [[:Category:Ascension Hunting Grounds|Ascension hunting zones]]: [[Hinterwilds]], [[Moonsedge]], [[The Hive]], and [[Sailor's Grief]]. When an onslaught is active, invasion portals appear in the targeted zone and transport you to the Empyrean fleet. Each onslaught runs for four hours before the fleet withdraws.
}}

__TOC__

==Details==
In order to be eligible for event credit for the various Empyrean Onslaughts timed quests, you must first complete [[Shadow's Descent]], which is the introductory quest for Empyrean Onslaughts and requires prior completion of "A Sparkling Ascent." See that article for detailed information on the quest. Completing Shadow's Descent unlocks [[Gemstone codex|Gemstone Codices]], the weekly/monthly repeatable quests, and the GEM ONSLAUGHT command.

==Empyrean Airship Raids==
Slaying Empyrean during an active Onslaught has a chance to open a swirling portal into one of the Syndicate's airships. Fighting your way upward through the ship takes you through multi-deck combat encounters connected by mechanical lifts, with progressively increasing difficulty at higher decks. Airship raids support groups of up to five adventurers.

==Repeatable Quests==
Four new repeatable [[Verb:QUEST|quests]] offer ongoing Empyrean content, available in weekly and monthly variants. They involve hunting aboard Empyrean airships or defending the ground during an active Onslaught, and reward [[Gemstone codex|Gemstone Codices]], experience, and fame. Check QUEST LIST for availability after completing [[Shadow's Descent]].

==Gemstone Geodes==
[[Gemstone geode|Gemstone Geodes]] are a collectible drop containing two [[Gemstones]] inside. Use GEM FIXATE to shift focus to finding Gemstone geodes at the expense of other kinds of loot. When found you can then choose which of the two gemstones inside the geode to extract.

==GEM Commands==
*'''GEM FIXATE''' – Sacrifice a portion of your weekly silver generation potential in exchange for an increased chance of finding Gemstones and receiving them inside a Geode.
*'''GEM STATUS''' – Check whether you are currently eligible for Gemstone drops.
*'''GEM ONSLAUGHT''' – Sense the presence and location of any active Onslaught. Requires completion of [[Shadow's Descent]].

==Gemstone Codices==
[[Gemstone codex|Gemstone Codices]] are one-time-use items that overwrite a property on one of your Gemstones with a new one, via the [[Gaunt masked artificer|masked Gemstone Artificer]].

==Additional Information==
===System Updates===
;Gem and Dust Rate Increase
Ascension Gemstones and Dust will now drop at an increased rate from Empyrean foes. Completion of Shadow's Descent is required to be eligible for this increased rate. The rate is further increased on Empyrean Airships, and is increased further on higher elevation Airships.

==See Also==
*[[Empyrean Onslaughts/saved posts|Saved posts]]
*[[Announcement:Empyrean Onslaughts]]
*[https://discordapp.com/channels/226045346399256576/1505233733559521430 Discussion:Empyrean Onslaughts and Codices]

[[Category:Permanent quests]]
[[Category:Gemstones]]
[[Category:Ascension Hunting Grounds]]

Empyrean Onslaughts

2026-09-22T18:03:32Z

HORIBU1: /* Empyrean Airship Raids */ correct group size to 5 from 6

{{Questinfo
|quest = Empyrean Onslaughts
|type = Permanent
|prerequisite = [[Shadow's Descent]] is required for event credit
|pageintro = Use {{boldmono|[[Verb:GEM|GEM ONSLAUGHT]]}} to check whether an onslaught is currently active, where it's happening, and how much time remains. Onslaughts are timed invasion events that rotate across four [[:Category:Ascension Hunting Grounds|Ascension hunting zones]]: [[Hinterwilds]], [[Moonsedge]], [[The Hive]], and [[Sailor's Grief]]. When an onslaught is active, invasion portals appear in the targeted zone and transport you to the Empyrean fleet. Each onslaught runs for four hours before the fleet withdraws.
}}

__TOC__

==Details==
In order to be eligible for event credit for the various Empyrean Onslaughts timed quests, you must first complete [[Shadow's Descent]], which is the introductory quest for Empyrean Onslaughts and requires prior completion of "A Sparkling Ascent." See that article for detailed information on the quest. Completing Shadow's Descent unlocks [[Gemstone codex|Gemstone Codices]], the weekly/monthly repeatable quests, and the GEM ONSLAUGHT command.

==Empyrean Airship Raids==
Slaying Empyrean during an active Onslaught has a chance to open a swirling portal into one of the Syndicate's airships. Fighting your way upward through the ship takes you through multi-deck combat encounters connected by mechanical lifts, with progressively increasing difficulty at higher decks. Airship raids support groups of up to five adventurers.

==Repeatable Quests==
Four new repeatable [[Verb:QUEST|quests]] offer ongoing Empyrean content, available in weekly and monthly variants. They involve hunting aboard Empyrean airships or defending the ground during an active Onslaught, and reward [[Gemstone codex|Gemstone Codices]], experience, and fame. Check QUEST LIST for availability after completing [[Shadow's Descent]].

==Gemstone Geodes==
[[Gemstone geode|Gemstone Geodes]] are a collectible drop containing two [[Gemstones]]. Use GEM FIXATE to shift focus between the two housed Gemstones, then break the geode to extract the one you want.

==GEM Commands==
*'''GEM FIXATE''' – Sacrifice a portion of your weekly silver generation potential in exchange for an increased chance of finding Gemstones and receiving them inside a Geode.
*'''GEM STATUS''' – Check whether you are currently eligible for Gemstone drops.
*'''GEM ONSLAUGHT''' – Sense the presence and location of any active Onslaught. Requires completion of [[Shadow's Descent]].

==Gemstone Codices==
[[Gemstone codex|Gemstone Codices]] are one-time-use items that overwrite a property on one of your Gemstones with a new one, via the [[Gaunt masked artificer|masked Gemstone Artificer]].

==Additional Information==
===System Updates===
;Gem and Dust Rate Increase
Ascension Gemstones and Dust will now drop at an increased rate from Empyrean foes. Completion of Shadow's Descent is required to be eligible for this increased rate. The rate is further increased on Empyrean Airships, and is increased further on higher elevation Airships.

==See Also==
*[[Empyrean Onslaughts/saved posts|Saved posts]]
*[[Announcement:Empyrean Onslaughts]]
*[https://discordapp.com/channels/226045346399256576/1505233733559521430 Discussion:Empyrean Onslaughts and Codices]

[[Category:Permanent quests]]
[[Category:Gemstones]]
[[Category:Ascension Hunting Grounds]]

Empyrean Onslaughts

2026-09-22T18:02:55Z

HORIBU1: add bold to GEM ONSLAUGHT in intro paragraph

{{Questinfo
|quest = Empyrean Onslaughts
|type = Permanent
|prerequisite = [[Shadow's Descent]] is required for event credit
|pageintro = Use {{boldmono|[[Verb:GEM|GEM ONSLAUGHT]]}} to check whether an onslaught is currently active, where it's happening, and how much time remains. Onslaughts are timed invasion events that rotate across four [[:Category:Ascension Hunting Grounds|Ascension hunting zones]]: [[Hinterwilds]], [[Moonsedge]], [[The Hive]], and [[Sailor's Grief]]. When an onslaught is active, invasion portals appear in the targeted zone and transport you to the Empyrean fleet. Each onslaught runs for four hours before the fleet withdraws.
}}

__TOC__

==Details==
In order to be eligible for event credit for the various Empyrean Onslaughts timed quests, you must first complete [[Shadow's Descent]], which is the introductory quest for Empyrean Onslaughts and requires prior completion of "A Sparkling Ascent." See that article for detailed information on the quest. Completing Shadow's Descent unlocks [[Gemstone codex|Gemstone Codices]], the weekly/monthly repeatable quests, and the GEM ONSLAUGHT command.

==Empyrean Airship Raids==
Slaying Empyrean during an active Onslaught has a chance to open a swirling portal into one of the Syndicate's airships. Fighting your way upward through the ship takes you through multi-deck combat encounters connected by mechanical lifts, with progressively increasing difficulty at higher decks. Airship raids support groups of up to six adventurers.

==Repeatable Quests==
Four new repeatable [[Verb:QUEST|quests]] offer ongoing Empyrean content, available in weekly and monthly variants. They involve hunting aboard Empyrean airships or defending the ground during an active Onslaught, and reward [[Gemstone codex|Gemstone Codices]], experience, and fame. Check QUEST LIST for availability after completing [[Shadow's Descent]].

==Gemstone Geodes==
[[Gemstone geode|Gemstone Geodes]] are a collectible drop containing two [[Gemstones]]. Use GEM FIXATE to shift focus between the two housed Gemstones, then break the geode to extract the one you want.

==GEM Commands==
*'''GEM FIXATE''' – Sacrifice a portion of your weekly silver generation potential in exchange for an increased chance of finding Gemstones and receiving them inside a Geode.
*'''GEM STATUS''' – Check whether you are currently eligible for Gemstone drops.
*'''GEM ONSLAUGHT''' – Sense the presence and location of any active Onslaught. Requires completion of [[Shadow's Descent]].

==Gemstone Codices==
[[Gemstone codex|Gemstone Codices]] are one-time-use items that overwrite a property on one of your Gemstones with a new one, via the [[Gaunt masked artificer|masked Gemstone Artificer]].

==Additional Information==
===System Updates===
;Gem and Dust Rate Increase
Ascension Gemstones and Dust will now drop at an increased rate from Empyrean foes. Completion of Shadow's Descent is required to be eligible for this increased rate. The rate is further increased on Empyrean Airships, and is increased further on higher elevation Airships.

==See Also==
*[[Empyrean Onslaughts/saved posts|Saved posts]]
*[[Announcement:Empyrean Onslaughts]]
*[https://discordapp.com/channels/226045346399256576/1505233733559521430 Discussion:Empyrean Onslaughts and Codices]

[[Category:Permanent quests]]
[[Category:Gemstones]]
[[Category:Ascension Hunting Grounds]]

Empyrean Onslaughts

2026-09-22T18:01:32Z

HORIBU1: add additional categories

{{Questinfo
|quest = Empyrean Onslaughts
|type = Permanent
|prerequisite = [[Shadow's Descent]] is required for event credit
|pageintro = Use [[Verb:GEM|GEM ONSLAUGHT]] to check whether an onslaught is currently active, where it's happening, and how much time remains. Onslaughts are timed invasion events that rotate across four [[:Category:Ascension Hunting Grounds|Ascension hunting zones]]: [[Hinterwilds]], [[Moonsedge]], [[The Hive]], and [[Sailor's Grief]]. When an onslaught is active, invasion portals appear in the targeted zone and transport you to the Empyrean fleet. Each onslaught runs for four hours before the fleet withdraws.
}}

__TOC__

==Details==
In order to be eligible for event credit for the various Empyrean Onslaughts timed quests, you must first complete [[Shadow's Descent]], which is the introductory quest for Empyrean Onslaughts and requires prior completion of "A Sparkling Ascent." See that article for detailed information on the quest. Completing Shadow's Descent unlocks [[Gemstone codex|Gemstone Codices]], the weekly/monthly repeatable quests, and the GEM ONSLAUGHT command.

==Empyrean Airship Raids==
Slaying Empyrean during an active Onslaught has a chance to open a swirling portal into one of the Syndicate's airships. Fighting your way upward through the ship takes you through multi-deck combat encounters connected by mechanical lifts, with progressively increasing difficulty at higher decks. Airship raids support groups of up to six adventurers.

==Repeatable Quests==
Four new repeatable [[Verb:QUEST|quests]] offer ongoing Empyrean content, available in weekly and monthly variants. They involve hunting aboard Empyrean airships or defending the ground during an active Onslaught, and reward [[Gemstone codex|Gemstone Codices]], experience, and fame. Check QUEST LIST for availability after completing [[Shadow's Descent]].

==Gemstone Geodes==
[[Gemstone geode|Gemstone Geodes]] are a collectible drop containing two [[Gemstones]]. Use GEM FIXATE to shift focus between the two housed Gemstones, then break the geode to extract the one you want.

==GEM Commands==
*'''GEM FIXATE''' – Sacrifice a portion of your weekly silver generation potential in exchange for an increased chance of finding Gemstones and receiving them inside a Geode.
*'''GEM STATUS''' – Check whether you are currently eligible for Gemstone drops.
*'''GEM ONSLAUGHT''' – Sense the presence and location of any active Onslaught. Requires completion of [[Shadow's Descent]].

==Gemstone Codices==
[[Gemstone codex|Gemstone Codices]] are one-time-use items that overwrite a property on one of your Gemstones with a new one, via the [[Gaunt masked artificer|masked Gemstone Artificer]].

==Additional Information==
===System Updates===
;Gem and Dust Rate Increase
Ascension Gemstones and Dust will now drop at an increased rate from Empyrean foes. Completion of Shadow's Descent is required to be eligible for this increased rate. The rate is further increased on Empyrean Airships, and is increased further on higher elevation Airships.

==See Also==
*[[Empyrean Onslaughts/saved posts|Saved posts]]
*[[Announcement:Empyrean Onslaughts]]
*[https://discordapp.com/channels/226045346399256576/1505233733559521430 Discussion:Empyrean Onslaughts and Codices]

[[Category:Permanent quests]]
[[Category:Gemstones]]
[[Category:Ascension Hunting Grounds]]

Empyrean Onslaughts

2026-09-22T18:00:28Z

HORIBU1: remove redundant line

Empyrean Onslaughts

2026-09-22T17:59:54Z

HORIBU1: minor layout template corrections

{{Questinfo
|quest = Empyrean Onslaughts
|type = Permanent
|prerequisite = [[Shadow's Descent]] is required for event credit
|pageintro = '''Empyrean Onslaughts''' is a [[Permanent quest|permanent quest]], which is always available as long as its prerequisites are met.
Use [[Verb:GEM|GEM ONSLAUGHT]] to check whether an onslaught is currently active, where it's happening, and how much time remains. Onslaughts are timed invasion events that rotate across four [[:Category:Ascension Hunting Grounds|Ascension hunting zones]]: [[Hinterwilds]], [[Moonsedge]], [[The Hive]], and [[Sailor's Grief]]. When an onslaught is active, invasion portals appear in the targeted zone and transport you to the Empyrean fleet. Each onslaught runs for four hours before the fleet withdraws.
}}

__TOC__

==Details==
In order to be eligible for event credit for the various Empyrean Onslaughts timed quests, you must first complete [[Shadow's Descent]], which is the introductory quest for Empyrean Onslaughts and requires prior completion of "A Sparkling Ascent." See that article for detailed information on the quest. Completing Shadow's Descent unlocks [[Gemstone codex|Gemstone Codices]], the weekly/monthly repeatable quests, and the GEM ONSLAUGHT command.

==Empyrean Airship Raids==
Slaying Empyrean during an active Onslaught has a chance to open a swirling portal into one of the Syndicate's airships. Fighting your way upward through the ship takes you through multi-deck combat encounters connected by mechanical lifts, with progressively increasing difficulty at higher decks. Airship raids support groups of up to six adventurers.

==Repeatable Quests==
Four new repeatable [[Verb:QUEST|quests]] offer ongoing Empyrean content, available in weekly and monthly variants. They involve hunting aboard Empyrean airships or defending the ground during an active Onslaught, and reward [[Gemstone codex|Gemstone Codices]], experience, and fame. Check QUEST LIST for availability after completing [[Shadow's Descent]].

==Gemstone Geodes==
[[Gemstone geode|Gemstone Geodes]] are a collectible drop containing two [[Gemstones]]. Use GEM FIXATE to shift focus between the two housed Gemstones, then break the geode to extract the one you want.

==GEM Commands==
*'''GEM FIXATE''' – Sacrifice a portion of your weekly silver generation potential in exchange for an increased chance of finding Gemstones and receiving them inside a Geode.
*'''GEM STATUS''' – Check whether you are currently eligible for Gemstone drops.
*'''GEM ONSLAUGHT''' – Sense the presence and location of any active Onslaught. Requires completion of [[Shadow's Descent]].

==Gemstone Codices==
[[Gemstone codex|Gemstone Codices]] are one-time-use items that overwrite a property on one of your Gemstones with a new one, via the [[Gaunt masked artificer|masked Gemstone Artificer]].

==Additional Information==
===System Updates===
;Gem and Dust Rate Increase
Ascension Gemstones and Dust will now drop at an increased rate from Empyrean foes. Completion of Shadow's Descent is required to be eligible for this increased rate. The rate is further increased on Empyrean Airships, and is increased further on higher elevation Airships.

==See Also==
*[[Empyrean Onslaughts/saved posts|Saved posts]]
*[[Announcement:Empyrean Onslaughts]]
*[https://discordapp.com/channels/226045346399256576/1505233733559521430 Discussion:Empyrean Onslaughts and Codices]

[[Category:Permanent quests]]

Empyrean Onslaughts

2026-09-22T17:58:07Z

HORIBU1: Add additional info from the Announcement article that was missing

{{Infobox
|title = Empyrean Onslaughts
|Type = Permanent
|Prerequisites = [[Shadow's Descent]] is required for event credit
}}

'''Empyrean Onslaughts''' is a [[Permanent quest|permanent quest]], which is always available as long as its prerequisites are met.
Use [[Verb:GEM|GEM ONSLAUGHT]] to check whether an onslaught is currently active, where it's happening, and how much time remains. Onslaughts are timed invasion events that rotate across four [[:Category:Ascension Hunting Grounds|Ascension hunting zones]]: [[Hinterwilds]], [[Moonsedge]], [[The Hive]], and [[Sailor's Grief]]. When an onslaught is active, invasion portals appear in the targeted zone and transport you to the Empyrean fleet. Each onslaught runs for four hours before the fleet withdraws.

__TOC__

==Details==
In order to be eligible for event credit for the various Empyrean Onslaughts timed quests, you must first complete [[Shadow's Descent]], which is the introductory quest for Empyrean Onslaughts and requires prior completion of "A Sparkling Ascent." See that article for detailed information on the quest. Completing Shadow's Descent unlocks [[Gemstone codex|Gemstone Codices]], the weekly/monthly repeatable quests, and the GEM ONSLAUGHT command.

==Empyrean Airship Raids==
Slaying Empyrean during an active Onslaught has a chance to open a swirling portal into one of the Syndicate's airships. Fighting your way upward through the ship takes you through multi-deck combat encounters connected by mechanical lifts, with progressively increasing difficulty at higher decks. Airship raids support groups of up to six adventurers.

==Repeatable Quests==
Four new repeatable [[Verb:QUEST|quests]] offer ongoing Empyrean content, available in weekly and monthly variants. They involve hunting aboard Empyrean airships or defending the ground during an active Onslaught, and reward [[Gemstone codex|Gemstone Codices]], experience, and fame. Check QUEST LIST for availability after completing [[Shadow's Descent]].

==Gemstone Geodes==
[[Gemstone geode|Gemstone Geodes]] are a collectible drop containing two [[Gemstones]]. Use GEM FIXATE to shift focus between the two housed Gemstones, then break the geode to extract the one you want.

==GEM Commands==
*'''GEM FIXATE''' – Sacrifice a portion of your weekly silver generation potential in exchange for an increased chance of finding Gemstones and receiving them inside a Geode.
*'''GEM STATUS''' – Check whether you are currently eligible for Gemstone drops.
*'''GEM ONSLAUGHT''' – Sense the presence and location of any active Onslaught. Requires completion of [[Shadow's Descent]].

==Gemstone Codices==
[[Gemstone codex|Gemstone Codices]] are one-time-use items that overwrite a property on one of your Gemstones with a new one, via the [[Gaunt masked artificer|masked Gemstone Artificer]].

==Additional Information==
===System Updates===
;Gem and Dust Rate Increase
Ascension Gemstones and Dust will now drop at an increased rate from Empyrean foes. Completion of Shadow's Descent is required to be eligible for this increased rate. The rate is further increased on Empyrean Airships, and is increased further on higher elevation Airships.

==See Also==
*[[Empyrean Onslaughts/saved posts|Saved posts]]
*[[Announcement:Empyrean Onslaughts]]
*[https://discordapp.com/channels/226045346399256576/1505233733559521430 Discussion:Empyrean Onslaughts and Codices]

[[Category:Permanent quests]]

Lich:Script Ebounty

2026-09-16T23:32:29Z

HORIBU1: add Third-Party Software category

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

''This page documents EBounty '''v1.12.3'''.''

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

===Lich Version Requirement===
EBounty requires '''Lich 5.19.0 or newer'''. The script checks your Lich version on startup and refuses to run (with an update notice) on anything older. Newer releases occasionally raise this floor, so keep Lich current alongside the script.

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

The dependency check is skipped entirely when "Just the basics" is enabled (either as a saved setting or via <CODE>;ebounty basic</CODE>).

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

Every option in the GUI also has a setting name that can be changed from the command line — see [[#Command Line Interface (CLI)|Command Line Interface]] below.

==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 !! CLI value !! Description
|-
| Boss Creature || <CODE>boss_culling</CODE> || Hunt a dangerous (boss-level) creature
|-
| Culling || <CODE>culling</CODE> || Kill a specified number of a particular creature
|-
| Escort || <CODE>escort</CODE> || Escort an NPC between two towns (uses <CODE>;escortgo2</CODE>)
|-
| Foraging || <CODE>foraging</CODE> || Gather herbs from the wild (see the Foraging tab for options)
|-
| Gem Collecting || <CODE>gem_collecting</CODE> || Collect specific gems by hunting creatures
|-
| Heirloom (loot) || <CODE>heirloom_loot</CODE> || Recover an heirloom by looting a creature
|-
| Heirloom (search) || <CODE>heirloom_search</CODE> || Recover an heirloom by searching rooms (see the Heirloom tab for options)
|-
| Kill Bandits || <CODE>kill_bandits</CODE> || Suppress bandit activity in an area (see the Bandits tab for options)
|-
| Rescue || <CODE>rescue</CODE> || Rescue a lost child (uses <CODE>;echild</CODE>)
|-
| Skinning || <CODE>skinning</CODE> || Collect creature skins
|}

===Misc Options===
{| class="wikitable"
|-
! Option !! Setting name !! Description
|-
| Rest when mind full || <CODE>exp_pause</CODE> || 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 || <CODE>keep_hunting</CODE> || 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 || <CODE>skip_healing</CODE> || Disables automatic healing between tasks.
|-
| Run one bounty and quit || <CODE>once_and_done</CODE> || EBounty will complete a single bounty and then stop.
|-
| Get new bounty before quitting || <CODE>new_bounty_on_exit</CODE> || (Only applies when "Run one bounty and quit" is enabled; the checkbox is greyed out otherwise.) Grabs the next task from the Guild before exiting.
|-
| Just the basics || <CODE>basic</CODE> || 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. Also skips the dependency check and the Gem/Default profile requirement, and returns you to the room you started in on exit.
|-
| Use vouchers || <CODE>use_vouchers</CODE> || EBounty will use Adventurer's Guild vouchers to reroll tasks until a desired bounty type is obtained.
|-
| Use bounty boosts || <CODE>use_boosts</CODE> / <CODE>boost_type</CODE> || 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 || <CODE>remove_heirloom</CODE> || If enabled and the heirloom item gets lost, EBounty will automatically remove the bounty.
|-
| Rejoin group before quitting || <CODE>return_to_group</CODE> || If you started EBounty while in a group, it will attempt to rejoin the group leader before exiting.
|-
| Ranger Track || <CODE>ranger_track</CODE> || (Rangers only — the checkbox is disabled for other professions.) Uses the Track ability on cooldown to locate bounty targets.
|}

===Support Scripts===
These fields let you override the default helper scripts. Each field accepts a script name optionally followed by parameters, and multiple scripts may be separated by commas.

{| class="wikitable"
|-
! Field !! Setting name !! Default !! Description
|-
| Healing Script || <CODE>healing_script</CODE> || <CODE>eherbs</CODE> || Runs when your character is injured between tasks.
|-
| Death Recovery Script || <CODE>death_script</CODE> || ''(none)'' || Runs if your character dies. If configured, EBounty starts a watcher that stops bigshot/go2, runs this script, and restarts EBounty automatically with the same command-line arguments. If left blank, EBounty simply exits on death.
|-
| Selling Script || <CODE>selling_script</CODE> || <CODE>eloot</CODE> || Runs to sell loot and deposit silvers.
|-
| Hording Script || <CODE>hording_script</CODE> || ''(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 || <CODE>escort_script</CODE> || <CODE>escortgo2</CODE> || Handles escort bounty travel.
|-
| Rescue Script || <CODE>rescue_script</CODE> || <CODE>echild</CODE> || Handles child rescue bounties.
|-
| Gem History || <CODE>gem_history</CODE> || ''(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. All are spin buttons with a maximum of 100.
* '''Max Culling Kills''' (<CODE>culling_max</CODE>, default 30) — Maximum number of creatures to kill for a culling bounty.
* '''Max Gems''' (<CODE>gem_max</CODE>, default 30) — Maximum number of gems to collect.
* '''Max Herbs''' (<CODE>herb_max</CODE>, default 30) — Maximum number of herbs to forage.
* '''Max Skins''' (<CODE>skin_max</CODE>, default 30) — Maximum number of skins to collect.
* '''# of Extra Skins''' (<CODE>extra_skin</CODE>, default 0) — 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 !! Setting name !! Description
|-
| Use Nearest Table || <CODE>table_rest</CODE> || Travels to the nearest mapped table and sits at it.
|-
| Use Bigshot Resting Room || <CODE>bigshot_rest</CODE> || Uses the resting room configured in your current Bigshot profile.
|-
| Use Custom Resting Area(s) || <CODE>custom_rest</CODE> + <CODE>resting_room</CODE> || 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 || <CODE>rest_random</CODE> || Picks a random [[supernode]] in your current town, drawn from the per-town lists below.
|-
| Use Script to Handle Resting Location || <CODE>use_script</CODE> + <CODE>use_script_name</CODE> || 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. Room IDs and UIDs are both accepted.

{| class="wikitable"
|-
! Town !! Setting name
|-
| Hinter Wilds || <CODE>hw_resting</CODE>
|-
| Icemule Trace || <CODE>icemule_resting</CODE>
|-
| Kharam Dzu (Teras) || <CODE>teras_resting</CODE>
|-
| Kraken's Fall || <CODE>kf_resting</CODE>
|-
| Mist Harbor || <CODE>fwi_resting</CODE>
|-
| River's Rest || <CODE>rr_resting</CODE>
|-
| Sailor's Grief || <CODE>contempt_resting</CODE>
|-
| Solhaven || <CODE>solhaven_resting</CODE>
|-
| Ta'Illistim || <CODE>illy_resting</CODE>
|-
| Ta'Vaalor || <CODE>vaalor_resting</CODE>
|-
| Wehnimer's Landing || <CODE>landing_resting</CODE>
|-
| Zul Logoth || <CODE>zul_resting</CODE>
|}

'''Note:''' the shipped defaults for several of these differ between Prime and Shattered (GSF), because the room IDs differ between instances. If you copy a settings file between instances, re-check these fields.

===Additional Resting Options===
* '''Join Character''' (<CODE>join_player</CODE> + <CODE>join_list</CODE>) — 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''' (<CODE>use_buff_script</CODE> + <CODE>buff_script</CODE>) — 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. All of these are stored in the <CODE>forage_options</CODE> array setting; the CLI value for each is listed below.

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

EBounty checks for the <CODE>nomagic</CODE> room tag before casting any of these.

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

===Post-Foraging===
* '''Post-Foraging Commands''' (<CODE>forage_post_commands</CODE>) — In-game commands to execute after foraging is complete.
* '''Post-Foraging Scripts''' (<CODE>forage_post_scripts</CODE>) — 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. All of these are stored in the <CODE>heirloom_options</CODE> array setting.

{| class="wikitable"
|-
! Option !! CLI value !! Description
|-
| Run from creatures || <CODE>run</CODE> || Flee the room if creatures appear.
|-
| Presence (402) || <CODE>use_402</CODE> || Cast spell 402 to detect nearby items.
|-
| Minor Sanctuary (213) || <CODE>use_213</CODE> || Cast spell 213 for protection.
|-
| Song of Peace (1011) || <CODE>use_1011</CODE> || Sing Song of Peace to prevent attacks.
|-
| Celerity (506) || <CODE>use_506</CODE> || Cast spell 506 for speed.
|-
| Mass Calm (619) || <CODE>use_619</CODE> || Cast spell 619 to pacify creatures.
|-
| Wizard's Shield (919) || <CODE>use_919</CODE> || Cast spell 919 for protection.
|-
| Wall of Force (140) || <CODE>use_140</CODE> || Cast spell 140 for defense.
|-
| Grasp of the Grave (709) || <CODE>use_709</CODE> || Cast spell 709 to immobilize creatures.
|-
| Song of Tonis (1035) || <CODE>use_1035</CODE> || Sing Song of Tonis for speed.
|-
| Flag right hand || <CODE>use_right</CODE> || 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''' (<CODE>heirloom_prep_commands</CODE>) — In-game commands to execute before beginning the search.
* '''Active Searching Scripts''' (<CODE>heirloom_prep_scripts</CODE>) — Scripts to run alongside searching.

===Post-Heirloom Searching===
* '''Post-Searching Commands''' (<CODE>heirloom_post_commands</CODE>) — In-game commands to execute after the heirloom is found.
* '''Post-Searching Scripts''' (<CODE>heirloom_post_scripts</CODE>) — 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''' (<CODE>wander_wait</CODE>, default <CODE>0.5</CODE>) — Controls the delay (in seconds) that EBounty waits in each room before moving on while searching for bandits. This is a decimal value. Adjust this to allow time for bandits to appear.

===Bad Room List===
A twelve-row table where you can define rooms to avoid during bandit hunting. Each row has two fields:
* '''Location''' (<CODE>location1</CODE> … <CODE>location12</CODE>) — A reference label for the area (does not need to be exact; this is for your convenience only).
* '''Bad Room Numbers''' (<CODE>bad_room1</CODE> … <CODE>bad_room12</CODE>) — 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.

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

===Crawl Area Cap===
Bandit and location-based bounties are capped at '''100 rooms''' of hunting area. If the bounty location maps to more rooms than that, EBounty walks outward from the nearest room and keeps a single contiguous region of up to 100 rooms; the remaining rooms are automatically added as hunting boundaries so Bigshot will not wander past them. This keeps very large areas from turning into extremely long crawls.

==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. Only bounties matching your enabled routes will be accepted; others will be dropped.

The six towns are Wehnimer's Landing, Solhaven, Icemule Trace, Ta'Illistim, Ta'Vaalor, and Zul Logoth, giving 30 directional routes. The routes are stored in the <CODE>escort_types</CODE> array using the form <CODE><origin>_to_<destination></CODE>, where each town is one of <CODE>landing</CODE>, <CODE>solhaven</CODE>, <CODE>icemule</CODE>, <CODE>illy</CODE>, <CODE>vaalor</CODE>, <CODE>zul</CODE> — for example <CODE>landing_to_solhaven</CODE> or <CODE>illy_to_vaalor</CODE>.

===Pre-Escort===
* '''Pre-Escort Commands''' (<CODE>escort_prep_commands</CODE>) — In-game commands to execute before starting the escort.
* '''Active Escort Scripts''' (<CODE>escort_prep_scripts</CODE>) — Scripts to run alongside the escort.

===Post-Escort===
* '''Post-Escort Commands''' (<CODE>escort_post_commands</CODE>) — In-game commands to execute after the escort is complete.
* '''Post-Escort Scripts''' (<CODE>escort_post_scripts</CODE>) — 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. Entries are de-duplicated and kept sorted.

===Creature Exclusions===
(<CODE>creature_exclude</CODE>) 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===
(<CODE>herb_exclude</CODE>) Herb names you do not want to forage. If a foraging bounty requests an excluded herb, EBounty will reject it.

===Gem Exclusions===
(<CODE>gem_exclude</CODE>) Gem names you do not want to collect. If a gem bounty requests an excluded gem, EBounty will reject it.

===Location Exclusions===
(<CODE>location_exclude</CODE>) 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 (<CODE><data dir>/<game>/<character>/bigshot_profiles</CODE>).

===Gem/Default Profile===
At the top of the tab, select your '''Gem/Default''' Bigshot profile (<CODE>default_profile</CODE>). 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. The two exceptions are "Just the basics" mode and standalone CLI foraging (<CODE>;ebounty forage …</CODE>), neither of which loads a combat profile.

===Bandits Profile===
Below the default, select a profile specifically for bandit bounties (<CODE>bandits_profile</CODE>). The '''Only Kill Bounty Creatures''' checkbox next to it (<CODE>kill_bandits</CODE>) 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, <CODE>names_a</CODE> … <CODE>names_j</CODE>) — 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, <CODE>profile_a</CODE> … <CODE>profile_j</CODE>) — Select the Bigshot profile to use when fighting these creatures.
* '''Only Kill Bounty Creatures''' (checkbox, <CODE>kill_a</CODE> … <CODE>kill_j</CODE>) — When checked, EBounty will only attack the specific bounty creature and ignore all other creatures in the hunting area.

Rows are matched in order A through J, and the '''last''' matching row wins, so put your most specific entries later in the list if a creature name could match more than one row.

'''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. Anything that is not a recognized command prints the help table, so <CODE>;ebounty help</CODE>, <CODE>;ebounty ?</CODE>, and any typo all behave the same way.

===Running EBounty===
{| class="wikitable"
|-
! Command !! Description
|-
| <CODE>;ebounty</CODE> || Start the main bounty loop using your saved settings. Must be run from a mapped room.
|-
| <CODE>;ebounty once</CODE> || Single run with '''full''' features: temporarily forces "Run one bounty and quit" on and "Just the basics" off, then exits after one bounty. Your saved settings are restored on exit.
|-
| <CODE>;ebounty basic</CODE> || Single run with '''just the basics''' enabled — picks up and turns in bounties only, no hunting, healing, or support scripts. The override is not written to your saved settings.
|-
| <CODE>;ebounty setup</CODE> || Open the GUI configuration window.
|}

Both <CODE>once</CODE> and <CODE>basic</CODE> apply their override only for that run; the previous values are restored when the script ends.

===Information Commands===
{| class="wikitable"
|-
! Command !! Description
|-
| <CODE>;ebounty help</CODE> || Display a summary of available commands. (Any unrecognized argument does the same.)
|-
| <CODE>;ebounty list</CODE> || Display all current settings and their values, filling in defaults for anything unset.
|-
| <CODE>;ebounty bounty</CODE> || Show a table of details for 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 version</CODE> || Display the current EBounty version number. <CODE>;ebounty ver</CODE> also works — in fact any first argument containing "ver" is treated as a version request.
|-
| <CODE>;ebounty test</CODE> || Display the script version followed by a raw dump of every setting. Useful when reporting a bug.
|}

===Utility Commands===
{| class="wikitable"
|-
! Command !! Description
|-
| <CODE>;ebounty remove</CODE> || Remove your current bounty (travels to the Guild to request removal, then returns you to the room you started in). Must be run from a mapped room.
|-
| <CODE>;ebounty load</CODE> || Reload all settings from the saved configuration file.
|-
| <CODE>;ebounty debug</CODE> || Toggle verbose debug output on or off. This is saved to your settings file, so it persists until you toggle it back off.
|}

===CLI Settings===
You can change any individual setting without opening the GUI:

<CODE>;ebounty settings <key> <value></CODE>

<CODE>;ebounty setup <key> <value></CODE> is accepted as an alias for the same thing. Setting names are case-insensitive, and hyphens are treated as underscores, so <CODE>;ebounty settings Skip-Healing true</CODE> is the same as <CODE>;ebounty settings skip_healing true</CODE>.

For a quick in-game reminder of the syntax for each value type:

<CODE>;ebounty settings help</CODE>

Each setting has a type, and the value you supply must match it:

{| class="wikitable"
|-
! Type !! Accepted values !! Example
|-
| Boolean || <CODE>on</CODE>/<CODE>true</CODE>/<CODE>yes</CODE> or <CODE>off</CODE>/<CODE>false</CODE>/<CODE>no</CODE>. '''Must be lowercase''' — <CODE>True</CODE> or <CODE>YES</CODE> will be rejected. || <CODE>;ebounty settings skip_healing true</CODE>
|-
| Integer || A whole number. || <CODE>;ebounty settings culling_max 30</CODE>
|-
| Float || A decimal number. || <CODE>;ebounty settings wander_wait 1.5</CODE>
|-
| Array || Space-separated values. The list is '''replaced''', not appended to. || <CODE>;ebounty settings bounty_types culling gem_collecting</CODE>
|-
| String || All remaining words, joined with single spaces. || <CODE>;ebounty settings selling_script eloot</CODE>
|}

'''Quoting commas.''' Several String settings (the per-town resting lists, <CODE>resting_room</CODE>, the <CODE>bad_room''N''</CODE> fields, the <CODE>location''N''</CODE> labels) store comma-separated values. Because a String setting joins the remaining arguments with spaces, quote the whole value as a single argument to preserve the commas:

<PRE>
;ebounty settings zul_resting "1005, 5751"
;ebounty settings bad_room1 "228, 188, u76564564"
</PRE>

'''Notes and gotchas:'''
* Array values are not validated. A misspelled bounty type or forage option is saved as-is and silently does nothing — check your work with <CODE>;ebounty list</CODE>.
* If the key is not recognized, EBounty prints an error along with the full list of valid setting names.
* A value that does not match the setting's type stops the script with an error rather than saving a bad value.
* <CODE>;ebounty list</CODE> shows the ''general'' category only. The internal <CODE>debug</CODE> setting is not listed there, but it is still settable (use <CODE>;ebounty debug</CODE> to toggle it).
* Setting updates are applied to the settings file on disk. If EBounty is already running, use <CODE>;ebounty load</CODE> — or restart it — to pick the change up.
* CLI setting updates only recognize keys that already exist in your saved settings file. If you have never opened <CODE>;ebounty setup</CODE>, open and close it once so the full set of defaults is written out.

===Foraging via CLI===
EBounty can forage herbs independently of bounties using the command line. This mode does not require a Gem/Default profile, and it returns you to the room you started in when it finishes.

{| class="wikitable"
|-
! Command !! Description
|-
| <CODE>;ebounty forage bounty</CODE> || Automatically detects your current foraging bounty and completes it.
|-
| <CODE>;ebounty forage bounty "<BOUNTY text>"</CODE> || Parses a pasted line of <CODE>BOUNTY</CODE> output instead of reading your live bounty, and forages from that. Useful for a task you have not accepted yet, or for testing.
|-
| <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 bounty "You have been tasked to gather 7 acantha leaves from the Upper Trollfang. You have not yet found any."
;ebounty forage "acantha leaf" 7
;ebounty forage "acantha leaf" 7 "Upper Trollfang"
</PRE>

Running <CODE>;ebounty forage</CODE> with missing or malformed arguments prints this syntax list rather than starting.

==Troubleshooting==
* '''"Please start ebounty in a mapped room."''' — <CODE>;ebounty</CODE>, <CODE>;ebounty once</CODE>, <CODE>;ebounty basic</CODE>, and <CODE>;ebounty remove</CODE> all need a mapped room to return to. Move somewhere the Lich map knows and try again.
* '''"Please select a Gem/Default profile in Profiles tab."''' — Set <CODE>default_profile</CODE> on the Profiles tab. This is not required for <CODE>;ebounty basic</CODE> or standalone CLI foraging.
* '''"You must also download the following script(s) to use ebounty"''' — Install the listed dependency with <CODE>;repo download <name></CODE>, or blank the matching support-script field and supply your own.
* '''"No Profile found for <creature>"''' — Add the full creature noun to a Creature Names row on the Profiles tab, add it to the Creature Exclusions list, or enable "Keep hunting".
* '''Script requires a newer Lich''' — Update Lich; EBounty requires 5.19.0 or newer.
* '''Reporting a bug''' — Include the output of <CODE>;ebounty test</CODE>, and turn on <CODE>;ebounty debug</CODE> to capture verbose output leading up to the problem.

==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.12.3 (2026-08-17)
- fix rgambit usage when not hidden to just put away instead
- fix to grab new bounty when available instead of waiting for should_hunt? to be true
v1.12.2 (2026-08-14)
- add ;ebounty settings help output covering CLI syntax for each setting value type (boolean/integer/float/array/string)
- reference ;ebounty settings help from the main help output
- bugfix: coerce_setting_value did not handle Float settings (e.g. wander_wait), causing ;ebounty settings wander_wait <value> to error out
v1.12.1 (2026-08-14)
- update help output to document previously undocumented CLI options: once, settings <key> <value>, debug, test, version
v1.12.0 (2026-08-14)
- add CLI support for ;ebounty basic (single run with just the basics enabled, without changing saved settings)
v1.11.3 (2026-08-01)
- fix to remove EXPERIENCE scraping for field exp, require new Lich to get it automatically from feed
v1.11.2 (2026-07-08)
- properly set start room ID
v1.11.1 (2026-07-05)
- add red trafel mushroom & black hook mushroom to find herb stow list method
v1.11.0 (2026-06-07)
- cap bandit/location crawl area at 100 rooms (Task::MAX_CRAWL_ROOMS)
- add Task.limit_crawl_area BFS to select a contiguous region from the nearest room
- excluded location rooms beyond the cap are added to location_boundaries automatically
v1.10.1 (2026-05-25)
- fix for forage_find to use distance calc of 90 for nearest only
- fix for no forageable item found when foraging in rift due to inside/outside rooms changing
v1.10.0 (2026-04-16)
- add support to use alternative BOUNTY text with ;ebounty forage bounty "BOUNTY output here"
- fix new mushroom PnC issues not calculating proper amounts in forage_bounty
v1.9.7 (2026-03-01)
- bugfix expedite vouchers when already ready to get new task
v1.9.6 (2026-02-17)
- bugfix to not try searching SG for taskmaster when already in room
v1.9.5 (2026-02-06)
- bugfix in forage_bounty when using optional location in CLI argument
v1.9.4 (2026-02-04)
- optimize location_list finding in forage_find room logic
v1.9.3 (2026-02-04)
- bugfix in forage_find room
v1.9.2 (2026-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 (2026-01-18)
- bugfix for running gem tracking script
v1.9.0 (2026-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 Ebounty

2026-09-16T23:30:52Z

HORIBU1: additional documentation and updates to latest version

Lich:Script Bigshot

2026-09-14T20:55:19Z

HORIBU1: /* Creature Checks */ add lying command check

{{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 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 help</CODE> - Prints a quick-reference table of every command-line option listed in this section. Typing an option Bigshot doesn't recognize prints this same help (with a warning naming the bad option) instead of silently doing nothing.
* <CODE>;bigshot <mode> <creature></CODE> - Rangers only: combine one of the modes above (<CODE>solo</CODE>, <CODE>single</CODE>, <CODE>bounty</CODE>, <CODE>quick</CODE>, or <CODE>once</CODE>) with a creature name to TRACK toward that creature instead of wandering, e.g., <CODE>;bigshot single giant rat</CODE>. A creature name with no mode in front of it (just <CODE>;bigshot giant rat</CODE>) is not recognized.

==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). Note: This does not work when using <CODE>;bigshot quick.</CODE>
* '''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 <stance> <noreserve>''' - 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 and automatically adds the wand to your RESERVE list. Use <CODE>wandolier defensive</CODE> to wave in a different stance, and add <CODE>noreserve</CODE> to skip the RESERVE step, e.g., <CODE>wandolier defensive noreserve</CODE>.
** '''resonance <spell id> <spell id> ...''' - Casts Resonance Bolt, picking randomly among the listed spell numbers each time (never repeating the one it just used back-to-back). Example: <CODE>resonance 511 512 513</CODE>.
** '''sacrifice''' - Performs a Voln Sacrifice on the current target's corpse for favor. Only attempts it when you have 2+ spirit, the ability is off cooldown, and the corpse appraises as suitable for sacrifice.
** '''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).
* '''thp#''' - Requires the ''target's'' health to be at or below #% (this is the target's health, unlike h# above which checks your own). <CODE>(!thp#)</CODE> requires the target's health to be above #%. If Bigshot can't determine the target's health, the command is skipped.

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

The following checks read the target's live status directly from the game feed, so they can be more precise than the umbrella '''prone''' check above. Each performs the command only when the target IS in that state (add <CODE>!</CODE> to require that it is NOT):
* '''calm''' - Target is calmed.
* '''disoriented''' - Target is disoriented.
* '''hovering''' - Target is hovering.
* '''immobilized''' - Target is immobilized (note: this checks the opposite condition of the existing '''frozen''' check above, which performs its command only when the target is NOT frozen).
* '''kneeling''' - Target is kneeling.
* '''sitting''' - Target is sitting.
* '''sleeping''' - Target is sleeping.
* '''stunned''' - Target is stunned.
* '''webbed''' - Target is webbed.
* '''lying''' - Target is lying down (prone).

Creature type/classification checks, also read from the game feed. Each performs the command only when the target carries that classification (add <CODE>!</CODE> to require that it does not):
* '''mount''' - Target is a mount.
* '''rider''' - Target is riding a mount.
* '''mini_boss''' - Target is flagged as a mini-boss.
* '''ascension_boss''' - Target is flagged as an Ascension boss.
* '''ascended''' - Target carries the "ascended" classification.
* '''challenging''' - Target is flagged as a tougher "challenging" variant.
* '''inferior''' - Target is flagged as a weaker "inferior" variant.
* '''disengaged''' - Target has disengaged from combat.
* '''sympathetic''' - Target is flagged as sympathetic (non-hostile).

Wound and critical-hit checks:
* '''wounded''' - Performs the command only when the target's health is at or below 25% (a fixed threshold; use '''thp#''' above for a custom percentage). <CODE>(!wounded)</CODE> requires health above 25%.
* '''fatalcrit''' - Performs the command only when the target has already suffered a fatal critical hit. <CODE>(!fatalcrit)</CODE> requires that it has not.
* '''smote''' - Performs the command only when the target has already been hit with Voln Smite. <CODE>(!smote)</CODE> requires that it has not been.

Target-specific UCS positioning checks — these read the ''target's'' individual unarmed-combat positioning, unlike the '''tier#''' checks above which track your own overall UAC tier. Each performs the command only when your positioning against ''that specific target'' matches (add <CODE>!</CODE> to require that it does not):
* '''ucsdecent''' - Positioning is "decent".
* '''ucsgood''' - Positioning is "good".
* '''ucsexcellent''' - Positioning is "excellent".
* '''ucstierup''' - A tier-up follow-up is available.

====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.
* '''k#''' - Performs the command only while you are kneeling. The number is required by the syntax but its value doesn't matter (e.g. <CODE>k1</CODE>). <CODE>(!k#)</CODE> performs the command only while you are NOT kneeling.

====Timing Checks====
* '''once''' - Performs the command once per target. Resets on room change.
* '''room''' - Performs the command once per room. Resets on room change.
* '''repeatdelay#''' - Throttles the command to once every # seconds per room, regardless of which target it's used against. Resets on room change. Example: <CODE>holler(repeatdelay60)</CODE> will not Holler again for 60 seconds after it last went off in that room.

====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.
* '''empowered#''' - Skips the command if an Empowered buff of +# or greater is already active, so a strong Coup de Grace bonus can't get overwritten by a weaker recast. <CODE>(!empowered#)</CODE> skips unless already at +# or greater.
* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds remaining. Supported for barrage, bearhug, coupdegrace, flurry, fury, garrote, pummel, shout, thrash, weed/kweed, yowlp.
* '''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.16.0 |
+---------------------------------------------------------------------------+
| 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> |
+---------------------------------------------------------------------------+

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

With <CODE>debug combat</CODE> enabled, the log also tracks each target's health and status from the moment Bigshot first engages it, through every command tried against it, to its death — useful for figuring out why a particular command check fired or didn't fire against a specific creature.

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

2026-09-11T00:59:52Z

HORIBU1: A few changes to remove version notes

{{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 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 help</CODE> - Prints a quick-reference table of every command-line option listed in this section. Typing an option Bigshot doesn't recognize prints this same help (with a warning naming the bad option) instead of silently doing nothing.
* <CODE>;bigshot <mode> <creature></CODE> - Rangers only: combine one of the modes above (<CODE>solo</CODE>, <CODE>single</CODE>, <CODE>bounty</CODE>, <CODE>quick</CODE>, or <CODE>once</CODE>) with a creature name to TRACK toward that creature instead of wandering, e.g., <CODE>;bigshot single giant rat</CODE>. A creature name with no mode in front of it (just <CODE>;bigshot giant rat</CODE>) is not recognized.

==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). Note: This does not work when using <CODE>;bigshot quick.</CODE>
* '''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 <stance> <noreserve>''' - 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 and automatically adds the wand to your RESERVE list. Use <CODE>wandolier defensive</CODE> to wave in a different stance, and add <CODE>noreserve</CODE> to skip the RESERVE step, e.g., <CODE>wandolier defensive noreserve</CODE>.
** '''resonance <spell id> <spell id> ...''' - Casts Resonance Bolt, picking randomly among the listed spell numbers each time (never repeating the one it just used back-to-back). Example: <CODE>resonance 511 512 513</CODE>.
** '''sacrifice''' - Performs a Voln Sacrifice on the current target's corpse for favor. Only attempts it when you have 2+ spirit, the ability is off cooldown, and the corpse appraises as suitable for sacrifice.
** '''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).
* '''thp#''' - Requires the ''target's'' health to be at or below #% (this is the target's health, unlike h# above which checks your own). <CODE>(!thp#)</CODE> requires the target's health to be above #%. If Bigshot can't determine the target's health, the command is skipped.

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

The following checks read the target's live status directly from the game feed, so they can be more precise than the umbrella '''prone''' check above. Each performs the command only when the target IS in that state (add <CODE>!</CODE> to require that it is NOT):
* '''calm''' - Target is calmed.
* '''disoriented''' - Target is disoriented.
* '''hovering''' - Target is hovering.
* '''immobilized''' - Target is immobilized (note: this checks the opposite condition of the existing '''frozen''' check above, which performs its command only when the target is NOT frozen).
* '''kneeling''' - Target is kneeling.
* '''sitting''' - Target is sitting.
* '''sleeping''' - Target is sleeping.
* '''stunned''' - Target is stunned.
* '''webbed''' - Target is webbed.

Creature type/classification checks, also read from the game feed. Each performs the command only when the target carries that classification (add <CODE>!</CODE> to require that it does not):
* '''mount''' - Target is a mount.
* '''rider''' - Target is riding a mount.
* '''mini_boss''' - Target is flagged as a mini-boss.
* '''ascension_boss''' - Target is flagged as an Ascension boss.
* '''ascended''' - Target carries the "ascended" classification.
* '''challenging''' - Target is flagged as a tougher "challenging" variant.
* '''inferior''' - Target is flagged as a weaker "inferior" variant.
* '''disengaged''' - Target has disengaged from combat.
* '''sympathetic''' - Target is flagged as sympathetic (non-hostile).

Wound and critical-hit checks:
* '''wounded''' - Performs the command only when the target's health is at or below 25% (a fixed threshold; use '''thp#''' above for a custom percentage). <CODE>(!wounded)</CODE> requires health above 25%.
* '''fatalcrit''' - Performs the command only when the target has already suffered a fatal critical hit. <CODE>(!fatalcrit)</CODE> requires that it has not.
* '''smote''' - Performs the command only when the target has already been hit with Voln Smite. <CODE>(!smote)</CODE> requires that it has not been.

Target-specific UCS positioning checks — these read the ''target's'' individual unarmed-combat positioning, unlike the '''tier#''' checks above which track your own overall UAC tier. Each performs the command only when your positioning against ''that specific target'' matches (add <CODE>!</CODE> to require that it does not):
* '''ucsdecent''' - Positioning is "decent".
* '''ucsgood''' - Positioning is "good".
* '''ucsexcellent''' - Positioning is "excellent".
* '''ucstierup''' - A tier-up follow-up is available.

====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.
* '''k#''' - Performs the command only while you are kneeling. The number is required by the syntax but its value doesn't matter (e.g. <CODE>k1</CODE>). <CODE>(!k#)</CODE> performs the command only while you are NOT kneeling.

====Timing Checks====
* '''once''' - Performs the command once per target. Resets on room change.
* '''room''' - Performs the command once per room. Resets on room change.
* '''repeatdelay#''' - Throttles the command to once every # seconds per room, regardless of which target it's used against. Resets on room change. Example: <CODE>holler(repeatdelay60)</CODE> will not Holler again for 60 seconds after it last went off in that room.

====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.
* '''empowered#''' - Skips the command if an Empowered buff of +# or greater is already active, so a strong Coup de Grace bonus can't get overwritten by a weaker recast. <CODE>(!empowered#)</CODE> skips unless already at +# or greater.
* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds remaining. Supported for barrage, bearhug, coupdegrace, flurry, fury, garrote, pummel, shout, thrash, weed/kweed, yowlp.
* '''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.16.0 |
+---------------------------------------------------------------------------+
| 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> |
+---------------------------------------------------------------------------+

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

With <CODE>debug combat</CODE> enabled, the log also tracks each target's health and status from the moment Bigshot first engages it, through every command tried against it, to its death — useful for figuring out why a particular command check fired or didn't fire against a specific creature.

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

2026-09-11T00:50:14Z

HORIBU1: updated to latest 5.16.0 content

{{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 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 help</CODE> - '''(New in v5.16.0)''' Prints a quick-reference table of every command-line option listed in this section. Typing an option Bigshot doesn't recognize now prints this same help (with a warning naming the bad option) instead of silently doing nothing.
* <CODE>;bigshot <mode> <creature></CODE> - Rangers only: combine one of the modes above (<CODE>solo</CODE>, <CODE>single</CODE>, <CODE>bounty</CODE>, <CODE>quick</CODE>, or <CODE>once</CODE>) with a creature name to TRACK toward that creature instead of wandering, e.g., <CODE>;bigshot single giant rat</CODE>. A creature name with no mode in front of it (just <CODE>;bigshot giant rat</CODE>) is not recognized.

==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). Note: This does not work when using <CODE>;bigshot quick.</CODE>
* '''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 <stance> <noreserve>''' - 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 and automatically adds the wand to your RESERVE list. Use <CODE>wandolier defensive</CODE> to wave in a different stance, and add <CODE>noreserve</CODE> to skip the RESERVE step, e.g., <CODE>wandolier defensive noreserve</CODE>.
** '''resonance <spell id> <spell id> ...''' - Casts Resonance Bolt, picking randomly among the listed spell numbers each time (never repeating the one it just used back-to-back). Example: <CODE>resonance 511 512 513</CODE>.
** '''sacrifice''' - Performs a Voln Sacrifice on the current target's corpse for favor. Only attempts it when you have 2+ spirit, the ability is off cooldown, and the corpse appraises as suitable for sacrifice.
** '''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).
* '''thp#''' - '''(New in v5.16.0)''' Requires the ''target's'' health to be at or below #% (this is the target's health, unlike h# above which checks your own). <CODE>(!thp#)</CODE> requires the target's health to be above #%. If Bigshot can't determine the target's health, the command is skipped.

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

'''(New in v5.16.0)''' The following checks read the target's live status directly from the game feed, so they can be more precise than the umbrella '''prone''' check above. Each performs the command only when the target IS in that state (add <CODE>!</CODE> to require that it is NOT):
* '''calm''' - Target is calmed.
* '''disoriented''' - Target is disoriented.
* '''hovering''' - Target is hovering.
* '''immobilized''' - Target is immobilized (note: this checks the opposite condition of the existing '''frozen''' check above, which performs its command only when the target is NOT frozen).
* '''kneeling''' - Target is kneeling.
* '''sitting''' - Target is sitting.
* '''sleeping''' - Target is sleeping.
* '''stunned''' - Target is stunned.
* '''webbed''' - Target is webbed.

'''(New in v5.16.0)''' Creature type/classification checks, also read from the game feed. Each performs the command only when the target carries that classification (add <CODE>!</CODE> to require that it does not):
* '''mount''' - Target is a mount.
* '''rider''' - Target is riding a mount.
* '''mini_boss''' - Target is flagged as a mini-boss.
* '''ascension_boss''' - Target is flagged as an Ascension boss.
* '''ascended''' - Target carries the "ascended" classification.
* '''challenging''' - Target is flagged as a tougher "challenging" variant.
* '''inferior''' - Target is flagged as a weaker "inferior" variant.
* '''disengaged''' - Target has disengaged from combat.
* '''sympathetic''' - Target is flagged as sympathetic (non-hostile).

'''(New in v5.16.0)''' Wound and critical-hit checks:
* '''wounded''' - Performs the command only when the target's health is at or below 25% (a fixed threshold; use '''thp#''' above for a custom percentage). <CODE>(!wounded)</CODE> requires health above 25%.
* '''fatalcrit''' - Performs the command only when the target has already suffered a fatal critical hit. <CODE>(!fatalcrit)</CODE> requires that it has not.
* '''smote''' - Performs the command only when the target has already been hit with Voln Smite. <CODE>(!smote)</CODE> requires that it has not been.

'''(New in v5.16.0)''' Target-specific UCS positioning checks — these read the ''target's'' individual unarmed-combat positioning, unlike the '''tier#''' checks above which track your own overall UAC tier. Each performs the command only when your positioning against ''that specific target'' matches (add <CODE>!</CODE> to require that it does not):
* '''ucsdecent''' - Positioning is "decent".
* '''ucsgood''' - Positioning is "good".
* '''ucsexcellent''' - Positioning is "excellent".
* '''ucstierup''' - A tier-up follow-up is available.

====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.
* '''k#''' - Performs the command only while you are kneeling. The number is required by the syntax but its value doesn't matter (e.g. <CODE>k1</CODE>). <CODE>(!k#)</CODE> performs the command only while you are NOT kneeling.

====Timing Checks====
* '''once''' - Performs the command once per target. Resets on room change.
* '''room''' - Performs the command once per room. Resets on room change.
* '''repeatdelay#''' - '''(New in v5.15.0)''' Throttles the command to once every # seconds per room, regardless of which target it's used against. Resets on room change. Example: <CODE>holler(repeatdelay60)</CODE> will not Holler again for 60 seconds after it last went off in that room.

====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.
* '''empowered#''' - '''(New in v5.16.0)''' Skips the command if an Empowered buff of +# or greater is already active, so a strong Coup de Grace bonus can't get overwritten by a weaker recast. <CODE>(!empowered#)</CODE> skips unless already at +# or greater.
* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds remaining. Supported for barrage, bearhug, coupdegrace, flurry, fury, garrote, pummel, shout, thrash, weed/kweed, yowlp. (Fixed in v5.16.0 — this check previously did nothing due to a bug.)
* '''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.16.0 |
+---------------------------------------------------------------------------+
| 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> |
+---------------------------------------------------------------------------+

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

'''(New in v5.16.0)''' With <CODE>debug combat</CODE> enabled, the log also tracks each target's health and status from the moment Bigshot first engages it, through every command tried against it, to its death — useful for figuring out why a particular command check fired or didn't fire against a specific creature.

==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 Bigshot/Changelog

2026-09-11T00:49:01Z

HORIBU1: updated to 5.16;0

{{3rd-party}}
== Change Log ==

<pre{{log2|background=none|border=none|margin-left=none|margin-right=none|font-size=93%}}>
v5.16.0 (2026-08-13)
- creature tracking is more accurate right after a kill or a room change, so targeting and looting are less likely to grab a stale target
- added checks for more creature states (calm, disoriented, hovering, immobilized, kneeling, sitting, sleeping, stunned, webbed, flying, rooted) and creature types (mounts, riders, mini-bosses, and more), so combat commands react to them correctly
- added checks for wounds, critical hits, and smites, so combat maneuvers can respond to them
- fixed a rare timing issue where looting could get interrupted mid-action if bigshot and the loot script were paused and resumed at nearly the same moment (e.g. by ecleanse), sometimes skipping or cutting off a loot/skin action
- coup de grace attempts are now double-checked right before they're sent, so bigshot stops wasting stamina on attempts that were already going to fail
- added an empowered<N> command option to skip a move when a strong enough Empowered buff is already active, so it can't get overwritten by a weaker recast
- added a thp<N> command option to only use a move when the target's health is at or below a set percentage
- fixed the buff<N> command option silently doing nothing
- added debug logging that tracks a target's health and status from when it's first engaged through every command tried against it to its death, for troubleshooting combat behavior
- added ;bigshot help, and unrecognized command-line options now print a warning and the help instead of doing nothing
v5.15.4 (2026-08-05)
- add additional messaging for cmd_unravel
v5.15.3 (2026-07-29)
- fix to remove EXPERIENCE scraping for field exp, require new Lich to get it automatically from feed
v5.15.2 (2026-07-27)
- fix priority hunt not retargeting when a higher priority creature arrives mid-fight
- compare target list rank instead of identity so a lower ranked creature never wins a check
- match priority targets with the same anchored name and noun rules used to select them
- keep the current target when a priority retarget has no replacement to offer
- fix eachtarget commands skipping every creature except the highest ranked one
- fix follower priority check reading an instance variable that was never set
- remove the unused room npc snapshot thread and its globals
v5.15.1 (2026-07-23)
- fix cmd_force re-issuing a maneuver on a passing roll
v5.15.0 (2026-07-19)
- add repeatdelay command check, throttles a command to once per N seconds per room, clears on room change
- bugfix for once command check raising when a creature has no prior commands
v5.14.4 (2026-07-15)
- fix some beast belly edge cases
v5.14.3 (2026-07-13)
- fix missing essence regex pattern
v5.14.2 (2026-07-06)
- fix cmd_shields missing regex
v5.14.1 (2026-06-18)
- remove greedy prone check for bullrush
v5.14.0 (2026-06-17)
- add new sacrifice command
- bugfix for creature escape result regex check
v5.13.3 (2026-06-16)
- bugfix for looting when in resting status
v5.13.2 (2026-06-15)
- bugfix in run_script to only do box_in_hand if hunting
v5.13.1 (2026-06-14)
- bugfix in resonance cmd
v5.13.0 (2026-05-17)
- add new resonance command for casting bolts
- add new UNHIDE event to allow for unhiding before fogging
v5.12.8 (2026-05-14)
- use gameobj id for wandolier instead of name after being found
v5.12.7 (2026-05-07)
- allow for wandolier command to take a noreserve option, defaults to use RESERVE system
v5.12.6 (2026-05-02)
- fix for boundary building to set a new status while building boundary list, useful for scripts like teleport.lic
v5.12.5 (2026-04-22)
- fix final_loot to now work for solo as well, helps pickup left behind loot by other players, poof'd creature loot, etc.
v5.12.4 (2026-04-10)
- fix for cmd_tether spell hindrance loop
v5.12.3 (2026-03-25)
- change to wander_stance if single_stop called (bigshot quick)
v5.12.2 (2026-03-11)
- fix to catch max inventory quantity item messaging
- fix in cmd_depress for result check
v5.12.1 (2026-02-08)
- fix for cast_signs/cmd_rapid to prevent double casting due to 0sec castRT.
v5.12.0 (2026-02-08)
- add ES/EB/EC/ED for spell, buff, cooldown, and debuff command checks
v5.11.4 (2026-01-14)
- add splashy command check for Rooms that are splashy(wet)
- add essence command check to check for sorcerer shadow essence
- unhide if hidden as a head/leader to allow followers to join
- add ATTACK event to attack routine if followers get separated
- allow non-incant spell COMMANDs to respect extra cast/evoke/channel
- force GROUP OPEN after disband when doing independent travel
v5.11.3 (2026-01-12)
- bugfix in follower rejoining leader
- bugfix for missing id's in attack stance, wander stance, and stand up
v5.11.2 (2026-01-09)
- optimize get_valid_neighbors to eval timeto as being valid numerics
v5.11.1 (2026-01-09)
- bugfix in sort_npcs
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>

Lich:Software/Installation

2026-09-11T00:45:05Z

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

{{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.21.0 supporting Ruby 4.0 - published September 10, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.20.1'''
<PRE>
### Bug Fixes (general)
* bound EAccess auth with a timeout so a stalled SGE backend can't hang Lich silently (#1502)
* Linux WINE and Wrayth FE detection (#1517)
* update Gemstone game-code validations (#1518)
* preserve bundled display-state tags on quiet-suppressed chunks (#1530)
* prevent a stray formatting character from appearing in Saga during quiet script output (#1532)

### Bug Fixes (dr)
* make $safe_pause_lock holder immune to pause (#1525)

### Bug Fixes (gs)
* critranks.rb tolerate nil table rows, fix reload!, index patterns … (#1522)
* combat module hardening - ordered processing, 22x faster parsing, double-count fix (#1523)
</PRE>
'''5.20.0'''
<PRE>
### Features (general)
* add concurrent runtime I/O and multi-client detach support (#1459)
* --bind-address speaks the same keywords as --detachable-client (#1461)
* GUI Launcher Improvements (#1463)
* Add supervised child script APIs (01 of 06) (#1474)
* Add forced script teardown command (06 of 06) (#1479)
* teardown and distinguishable errors for Script.run_child (#1501)

### Features (dr)
* DRCMM.moon_weapon_duration - read a moon weapon's remaining life (#1483)
* id-based creature tracking from crtrStatus + assess (#1485)
* capture room UID from <nav> tag; stop enforcing ShowRoomID; opt-in room-id placement (#1491)
* user-extensible scroll substitutions via settings (01 of 06) (#1512)
* user-extensible boxes and trash receptacles (03 of 06) (#1514)
* user-extensible summoned-weapon adjectives (04 of 06) (#1515)
* user-extensible flavor-text stripping (05 of 06) (#1516)

### Features (gs)
* gameobj add full_name matcher to type/sellable classification (#1453)

### Bug Fixes (general)
* prevent empty/partial GameObj registry reads during mid-stream refresh (#1370)
* no-op Gtk.lich_main_quit when no main loop is nested (#1464)
* correct path-flag aliases and document all path options (#1472)
* Synchronize script lifecycle transitions (02 of 06) (#1475)
* Coordinate script shutdown draining (03 of 06) (#1476)
* Harden script lifecycle ownership (05 of 06) (#1478)
* surface the underlying LoadError in dependency alerts (#1480)
* extract game-agnostic CreatureBase into lib/common (#1484)
* bound GemCheck alert dialogs with a timeout so they can't hang forever (#1488)
* identify Genie as the frontend for headless launches (#1490)
* restore detachable client disconnect notice to stdout (#1492)
* harden detachable client teardown and escape init payload (#1493)
* resolve GameObj status visibility during staged refresh (#1497)
* compact client write queue instead of ending the session (#1498)
* scrub startup credentials once login completes (#1499)
* Honor Simu-side teardown for 10 seconds (#1505)

### Bug Fixes (dr)
* resolve no-UID rooms carrying a stored UID instead of returning nil (#1467)
* equipmanager.rb - reliable ranged-weapon transitions - stow ammo after unload + verify offhand wield hand (#1468)
* common-healing.rb - DRCH.bind_wound: only dispose a dislodged item while it is in hand (#1469)
* preserve game RealID in room title (GS parity for ";display roomid title") (#1500)
* Refine need_buffs? logic for non-recast spells to correctly check cyclic spells. (#1503)
* reduce symbol-torn scale scrolls to gettable noun (#1506)
</PRE>
'''5.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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-09-11T00:44:38Z

HORIBU1: /* Installing the Latest Stable Release */ update for lich 5.21.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.21.9 supporting Ruby 4.0 - published September 10, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.20.1'''
<PRE>
### Bug Fixes (general)
* bound EAccess auth with a timeout so a stalled SGE backend can't hang Lich silently (#1502)
* Linux WINE and Wrayth FE detection (#1517)
* update Gemstone game-code validations (#1518)
* preserve bundled display-state tags on quiet-suppressed chunks (#1530)
* prevent a stray formatting character from appearing in Saga during quiet script output (#1532)

### Bug Fixes (dr)
* make $safe_pause_lock holder immune to pause (#1525)

### Bug Fixes (gs)
* critranks.rb tolerate nil table rows, fix reload!, index patterns … (#1522)
* combat module hardening - ordered processing, 22x faster parsing, double-count fix (#1523)
</PRE>
'''5.20.0'''
<PRE>
### Features (general)
* add concurrent runtime I/O and multi-client detach support (#1459)
* --bind-address speaks the same keywords as --detachable-client (#1461)
* GUI Launcher Improvements (#1463)
* Add supervised child script APIs (01 of 06) (#1474)
* Add forced script teardown command (06 of 06) (#1479)
* teardown and distinguishable errors for Script.run_child (#1501)

### Features (dr)
* DRCMM.moon_weapon_duration - read a moon weapon's remaining life (#1483)
* id-based creature tracking from crtrStatus + assess (#1485)
* capture room UID from <nav> tag; stop enforcing ShowRoomID; opt-in room-id placement (#1491)
* user-extensible scroll substitutions via settings (01 of 06) (#1512)
* user-extensible boxes and trash receptacles (03 of 06) (#1514)
* user-extensible summoned-weapon adjectives (04 of 06) (#1515)
* user-extensible flavor-text stripping (05 of 06) (#1516)

### Features (gs)
* gameobj add full_name matcher to type/sellable classification (#1453)

### Bug Fixes (general)
* prevent empty/partial GameObj registry reads during mid-stream refresh (#1370)
* no-op Gtk.lich_main_quit when no main loop is nested (#1464)
* correct path-flag aliases and document all path options (#1472)
* Synchronize script lifecycle transitions (02 of 06) (#1475)
* Coordinate script shutdown draining (03 of 06) (#1476)
* Harden script lifecycle ownership (05 of 06) (#1478)
* surface the underlying LoadError in dependency alerts (#1480)
* extract game-agnostic CreatureBase into lib/common (#1484)
* bound GemCheck alert dialogs with a timeout so they can't hang forever (#1488)
* identify Genie as the frontend for headless launches (#1490)
* restore detachable client disconnect notice to stdout (#1492)
* harden detachable client teardown and escape init payload (#1493)
* resolve GameObj status visibility during staged refresh (#1497)
* compact client write queue instead of ending the session (#1498)
* scrub startup credentials once login completes (#1499)
* Honor Simu-side teardown for 10 seconds (#1505)

### Bug Fixes (dr)
* resolve no-UID rooms carrying a stored UID instead of returning nil (#1467)
* equipmanager.rb - reliable ranged-weapon transitions - stow ammo after unload + verify offhand wield hand (#1468)
* common-healing.rb - DRCH.bind_wound: only dispose a dislodged item while it is in hand (#1469)
* preserve game RealID in room title (GS parity for ";display roomid title") (#1500)
* Refine need_buffs? logic for non-recast spells to correctly check cyclic spells. (#1503)
* reduce symbol-torn scale scrolls to gettable noun (#1506)
</PRE>
'''5.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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]]

Cysaegir

2026-09-04T19:06:21Z

HORIBU1: change image author credit

[[Image:Cysaegir (wiki).png|thumb|right|Cysaegir map by GM Xeraphina.<br>There is also an alternate Lich mapdb version: https://gswiki.play.net/File:Cysaegir_(mapdb).png]]

'''Cysaegir''' is a small [[Illistim]]-built town found off [[Whistler's Pass]]. Formerly named Glimae'den, it had been abandoned for some time when the [[Aelotoi]] arrived in [[Elanthia]] in the year 5103. [[Myasara Illistim]], wanting to help them along in their new lives in Elanthia, had the town cleaned up and reinhabited, and then gave it to the aelotoi. The name Cysaegir means "Sanctuary" in the aelotoi language, and it was named such as it represents the first true safe haven they have ever known. It is now inhabited by the aelotoi and a number of elves who run the shops and other services of the town.

The town itself is found in a lush forest, and portions of it are actually located in the [[Treetop Platform|treetops]]. It is rather small, but offers most standard town services, including [[citizenship]] available to all races, an inn, a bank, and lockers.

Due to the Aelotoi's recent arrival on Elanthia, they do not bear the same prejudices and stereotypes of the various races of Elanthia as the elves. Hence, Cysaegir is accommodating towards all races, offering fair prices towards non-elves.

==NPCs==
The following automated NPCs reside in [[Cysaegir]].

* [[a cheery clerk]]
* [[a cheerful workshop foreman]]
* [[a clerk (Cysaegir)|a clerk]]
* [[a dark-haired young woman]]
* [[a dog-faced dark grey fruit bat]]
* [[a gold-winged Aelotoi toddler]]
* [[a leathery old woman]]
* [[an Aelotoi clerk]]
* [[an attentive warehouse manager]]
* [[an old aelotoi woman]]
* [[an opaline blue swallowtail butterfly]]
* [[Hihaeim]]
* [[the Aelotoi magistrate]]
* [[the merchant Claeresse]]
* [[the merchant Claerine]]
* [[Urgaen]]

==Shops==
{{main|:Category:Cysaegir shops}}
{{#ask: [[Category:Cysaegir shops]][[Townshop-template-is::True]]
|?Shop portal
|?Shop portal location
|?Shop type
|?Shop wares
|?Shop specialty
|format=template
|limit=50
|link=none
|mainlabel=
|template=ShopTownTable
|introtemplate=ShopTownTableStart
|outrotemplate=Shop_table_end
}}

==Buildings==
The following locations, stores, and facilities can be found in [[Cysaegir]].

* [[Cysaegir Bank]]
* [[Gems of the Earth]]
* [[Glimae'den Wildwood]]
* [[Laetira's Dispensary]]
* [[Linsandrych Common]]
* [[Maeve's Furs]]
* [[Reformatory]]
* [[Rhyaesdid Hall]]
* [[Salon Saeliria]]
* [[Surname registry#Locations|Surname Registry]]
* [[Urgaen's Pawnshop]]

==Public Gathering Places==
{{#section-h:Node|[[Cysaegir]]}}

==Resources==
*[http://forums.play.net/forums/GemStone%20IV/Towns/Cysaegir/view Officials folder]

{{Aelotoi}}

[[Category:Cysaegir| ]]
[[Category:Ta'Illistim]]
[[Category:Towns]]
[[Category:Player Accessible]]

File:Cysaegir (wiki).png

2026-09-04T19:05:00Z

HORIBU1: HORIBU1 uploaded a new version of File:Cysaegir (wiki).png

The wiki version of the Cysaegir map.

This map was made by Tsoran and updated by Arianiss.

[https://gswiki.play.net/File:EN-Cysaegir.png Older versions.]

Lich:Software/Scripting reference

2026-08-31T20:38:39Z

HORIBU1: added links to newer API documentation sites

{{3rd-party}}{{TOCright|limit=3}}
=Current Documentation=
For up to date Lich API documentation, please visit the following websites as they will be more maintained and up to date than the documentation you will find on this page.
* [https://lich-5-docs.elanthia.online/ Lich-5-Docs]
* [https://deepwiki.com/elanthia-online/lich-5 DeepWiki]

=Older Documentation=
== variable ==
<div {{log}}>
variable[1]
</div>
<div {{log}}>
Script.current.vars[0]
</div>
<div {{log}}>
Script.current.vars[1]
</div>

*'''Returns:''' an array, possibly empty
*'''Synonyms:''' Script.current.vars, script.vars
*'''Description:''' An array containing the command line variables the user entered when starting the script. Index position 0 contains all the variables passed to it in a single string. Index positions 1 thru n correlate to space separated list of the values passed to the script. The third example above showing proper syntax for recalling the first variable passed to the script. While variable and script.vars still work, the current best practice is to use Script.current.vars to match appropriate Lich API usage.

== echo ==
<div {{log}}>
echo
</div>
<div {{log}}>
echo "Hi there!"
</div>
<div {{log}}>
echo "Line one", "Line two", "endlessly"
</div>
*'''Returns:''' a string
*'''Description:''' Displays '[script_name: the string it was given]' in the game window; if given multiple strings it echoes each string on its own line. If it's given no arguments, it simply prints a blank line without the '[script_name: ]' business.

== respond ==
<div {{log}}>
respond
</div>
<div {{log}}>
respond "I'm a string to display"
</div>
<div {{log}}>
respond "Line one", "Line two", "so on and so on"
</div>
*'''Returns:''' integer
*'''Description:''' Just like the 'echo' command, but does not display the script name. Since it's possible for Lich to be running two dozen scripts at the same time, it can get a little hard to know which script is saying what unless they use the 'echo' command and not the 'respond' command. Still, 'echo' can be a bit ugly for printing tables and whatnot, so use this instead if desired. The return value is how many characters the last string displayed contained.

== pause ==
<div {{log}}>
pause
</div>
<div {{log}}>
pause 3
</div>
<div {{log}}>
pause '2s'
</div>
<div {{log}}>
pause '3m'
</div>
<div {{log}}>
pause '1d'
</div>
*'''Returns:''' an integer
*'''Description:''' If given no arguments, pauses for one second. If given an integer, pauses for that many seconds. If given a string (as in the examples above), extracts the number to pause for from the string and pauses for that many seconds/hours/days (yeah, well, I was bored, so why not make it do days too). Return value is the number of seconds it paused for.

== Output ==

Sending output to the game as though typed by the player.

=== put ===
<div {{log}}>
put "look"
</div>
*'''Returns:''' the string that was sent
*'''Description:''' Identical to Wizard.

=== fput ===
<div {{log}}>
fput "stance defensive"
</div>
<div {{log}}>
fput "stance defensive", "are now in a defensive stance", "can't do that while dead", "etc"
</div>
*'''Returns:''' the string that was accepted as meaning the action succeeded (see below)
*'''Synonyms:''' forceput
*'''Description:''' It's named 'forceput' because originally it was intended to be used only infrequently, but as it's turned out there are very few times when 'put' is preferable. This command will continue to 'put' whatever string you give it, until it receives a line from the game that it doesn't recognize as one of the common "command rejected" responses (for example, "You can't do that while entangled in a web", "...wait x seconds" (RT), "Wait x seconds." (cast RT), "Sorry, you may only type ahead x lines", "You'll have to stand up first" (stands and reattempts), etc). If stunned, it will wait until you're no longer stunned to reattempt; if in RT (hard or soft), will wait 'x' seconds before reattempting. If you need to stand, it will do so and retry immediately. If it causes a type ahead error, it will pause for 1 second and then reattempt. This has a very high rate of success, but it is definitely not infallible -- it only checks the next line received from the game, and there's no guarantee the next line from the game has anything at all to do with what the 'fput' command just sent. Because of this it can often fail to realize the command wasn't really successful, particularly if the user is doing a lot of things at once. If given more than one string, the first string is taken as the command to send to the game, and all other strings are used as what to accept as meaning the action succeeded. BE CAREFUL with this behavior! It can very infrequently be extremely useful, but if not used cautiously, it can easily cause a script to mistakenly repeat an action many times in *very* rapid succession (which with CoL signs for instance can very easily kill you in less than a second flat).

=== multifput ===
<div {{log}}>
multifput "stance offensive", "incant 910", "stance defensive"
</div>
*'''Returns:''' a string (return value of the last 'fput' executed)
*'''Description:''' Takes multiple strings and executes an 'fput' command for every one sequentially.

=== dothis ===
<div {{log}}>
dothis "action here", /regex to match for success/
</div>
*'''Returns:''' a success string, or false
*'''Description:''' Similar to fput, but will continue to try the action until a success string is matched

=== dothistimeout ===
<div {{log}}>
dothistimeout "action here", time, /regex to match for success/
</div>
*'''Returns:''' a success string, or nil
*'''Description:''' Same as 'dothis', but if a success isn't seen in the given amount of time, returns a value of 'nil' and the script will move on.

=== move ===
<div {{log}}>
move 'northwest'
</div>
*'''Returns:''' true or false
*'''Description:''' Same as the Wizard 'move' command, but it will usually compensate for things like type ahead errors, RT, currently stunned, etc.; will also stand and re-attempt the movement if it's detected to be necessary. Returns 'true' if the move was executed properly, 'false' if it wasn't able to be performed (which is very rare due to the move command's error compensation measures).

=== multimove ===
<div {{log}}>
multimove 'nw', 'ne', 'go hole', 'climb stairs'
</div>
*'''Returns:''' true or false
*'''Description:''' Takes multiple directions to move in and executes the 'move' command for each one. Returns the value of the last 'move' command executed (true or false).

== Input ==

This is core line-by-line handling of full lines of input sent by the game to the player. For more complex filtering and handling, see "match" and "wait" sections.

=== get ===
<div {{log}}>
get
</div>
*'''Returns:''' a string
*'''Description:''' Fetches the next un-checked line of game data (while a script is running, it is given every game line, and these lines are available for a script to check/use at its leisure).

=== regetall ===
<div {{log}}>
regetall "Shaelun"
</div>
*'''Returns:''' an array of strings, or nil
*'''Description:''' Takes a string and returns an array of all game lines (since login) that match as having contained the given string (absolutely every single line since you logged in, Lich remembers them all). If a script is set as receiving the status data that doesn't show in the game window, those lines are also matched for; if the script is only being fed normal game data, that's the only history this command checks. If no matching lines were found, returns 'nil' (which is false in a logical comparison). As well as returning the matches, it also adds them to the script's game data stack so that subsequent 'get' commands will fetch them in order. The string to match for is actually optional, and if omitted, all lines are considered 'matching'.

=== reget ===
<div {{log}}>
reget 3
</div>
<div {{log}}>
reget 5, "Shaelun"
</div>
*'''Returns:''' an array of strings, or nil
*'''Description:''' Similar to 'regetall' in behavior, but it only checks the current RAM cache (every 2 minutes, Lich's 'memory' of game data is emptied out of RAM and stored in a temporary file on the hard disk so that the program doesn't take up more resources than is necessary -- these files are deleted when the program closes); it also takes an optional integer, which represents how many game lines back to check ('reget 5' would scan the last 5 lines from the game that are still in RAM). If the integer is omitted, will scan the entire existing RAM buffer (again, cleared every 2 minutes).

=== clear ===
<div {{log}}>
clear
</div>
*'''Returns:''' an array of strings (possible for the return array to be empty, but unlikely)
*'''Description:''' Empties ALL unchecked input to the script from ALL queues (normal game stack, unique script stack and upstream stack); the return value is whatever was in the game data stack before it was cleared (which could be nothing, in which case the return is an empty array).

== Wait ==

=== wait ===
<div {{log}}>
wait
</div>
*'''Returns:''' a string
*'''Description:''' Identical to Wizard; waits until a line from the game is seen. Returns the line (in actuality this command simply clears the game stack and executes a 'get').

=== waitrt ===
<div {{log}}>
waitrt
</div>
*'''Returns:''' an integer (Fixnum class)
*'''Description:''' Pauses for however many seconds you're currently in roundtime for. Return value is how many seconds paused. Waits until you're in roundtime if you aren't at the time this command is used, and therefore can hang endlessly.

=== waitrt? ===
<div {{log}}>
waitrt?
</div>
*'''Returns:''' an integer (Fixnum class)
*'''Description:''' Identical to 'waitrt', but does not wait until you're in roundtime and as such will not hang (but will not wait for any roundtime if the game hasn't sent that you're in roundtime yet).
*'''Note:''' Zero is a value, and ALL values in Ruby are evaluated to true, EXCEPT for FALSE and NIL. This means that !waitrt? will not do do a proper true/false check like it might in other languages.

=== waitcastrt ===
<div {{log}}>
waitcastrt
</div>
*'''Returns:''' an integer (Fixnum class)
*'''Description:''' Pauses for however many seconds you're currently in RT for. Return value is how many seconds paused. Waits until you're in RT if you aren't at the time this command is used, and therefore can hang endlessly.

=== waitcastrt? ===
<div {{log}}>
waitcastrt?
</div>
*'''Returns:''' an integer (Fixnum class)
*'''Description:''' Identical to 'waitcastrt', but does not wait until you're in cast roundtime and as such will not hang (but will not wait for any cast roundtime if the game hasn't sent that you're in cast roundtime yet).
*'''Note:''' Zero is a value, and ALL values in Ruby are evaluated to true, EXCEPT for FALSE and NIL. This means that !waitcastrt? will not do do a proper true/false check like it might in other languages.

=== waitfor ===
<div {{log}}>
waitfor " just arrived.", "More lines to waitfor if you desire", "endlessly"
</div>
*'''Returns:''' a string
*'''Description:''' Waits until a line from the game includes the string you gave it as an argument. The return value is the complete string from the game (in the example used here, if Shaelun entered the room, the command would return "Shaelun just arrived."). 'waitfor' is case insensitive (capital letters are considered matches even if the string it was given didn't have a capital letter there).

=== wait_while ===
<div {{log}}>
wait_while { percenthealth != 100 }
</div>
<div {{log}}>
wait_while("You do not have full health: waiting until you do.") { percenthealth != 100 }
</div>
*'''Returns:''' true/false
*'''Description:''' The script will wait while the given code block has a logical value of 'true', and will only continue on to the next line when/if the code block has a value of 'false'. If given the optional string to announce to the user, it will only display that string if it's going to be sitting there waiting for something -- if the command will not be waiting at all, it doesn't display the string to the user. Note that there's no limit to how long/complicated the code block can be; it was designed for very short logical comparisons like the example above, but need not be used that way.

=== wait_until ===
<div {{log}}>
wait_until("Waiting until 50 mana or more!") { checkmana(50) }
</div>
*'''Returns:''' true/false
*'''Description:''' Identical in all ways to 'wait_while', but does the opposite (waits UNTIL the given code block is true, not WHILE it's true). Also takes the optional string if desired.

== Match ==

Wizard-style "match" commands

=== matchtimeout ===
<div {{log}}>
matchtimeout 5, "string to watch for", "another", "endlessly"
</div>
*'''Returns:''' a string, or false
*'''Description:''' Same as 'waitfor', but if a match isn't seen in the given amount of time, returns a value of 'false' and the script will move on.

=== matchwait ===
<div {{log}}>
</div>
*'''Returns:''' a string
*'''Description:''' If used without any arguments, 100% identical to Wizard 'matchwait' commands. You can optionally give it arguments, in which case it acts identically to 'waitfor' in all ways except one: matches are case sensitive (for instance, matchwait "shaelun" will not match if the word "Shaelun" is seen from the game).

=== match ===
<div {{log}}>
match 'label', 'line to watch for'
</div>
<div {{log}}>
match "gameline", "gameline", "some other gameline", "so on and so forth"
</div>
*'''Returns:''' a string
*'''Description:''' If given exactly two arguments, identical to the Wizard 'match' command. If given *any* other number of arguments, it's a case sensitive version of 'waitfor' but instead of returning the entire matching game line, it returns only the portion of the string you asked it to watch for.

=== matchfind ===
<div {{log}}>
matchfind "A ? attacks you!", "A ? swings a ? at you!"
</div>
<div {{log}}>
person, weapon = matchfind "? swings a ? at you!"
</div>
*'''Returns:''' a string or an array
*'''Description:''' Same as 'waitfor', but returns only the portion of the line where the question mark(s) are. If given multiple question marks, returns an array containing the portions of the string (in order). Note that if you assign multiple variables to equal a single array, the array's elements are used in order and assigned to each variable (if there are fewer elements in the array than there are variables being assigned, variables receive a value of 'nil', and if there are more elements in the array than there are variables being assigned, the last variable is assigned an array with the remaining values). This is why the above usage example works (person, weapon =).

=== matchfindword ===
<div {{log}}>
weapon = matchfindword "Shaelun swings a ? at you!"
</div>
*'''Returns:''' a string (single word)
*'''Description:''' Identical to 'matchfind', but only looks for a single word where the question marks are. Note that a line won't match if more than one word is where the question mark is (in the above example, if the weapon were a "broadsword" it would match, but if it were a "sonic hammer of kai" there would be no match).

=== matchfindexact ===
<div {{log}}>
matchfindexact "? just arrived."
</div>
*'''Returns:''' a string
*'''Description:''' Version of matchfind meant for use in special cases; matchfind is very forgiving and will return and match anything (case insensitively) -- matchfindexact is very strict. It is case sensitive and cares about things like spaces, word boundaries (partial pieces of a word will not match, only whole words), the case of the string it's looking for, etc.. Use it if you need to use matchfind and want to make sure only a very specific line matches.

== Room ==

=== checkarea ===
<div {{log}}>
checkarea
</div>
<div {{log}}>
checkarea "illistim"
</div>
*'''Returns:''' a string, or true or false
*'''Description:''' By itself returns the geographical area of your current room, or if given a string to check for, returns true or false based on whether your current area matches the string or not.

=== checkroom ===
<div {{log}}>
checkroom
</div>
<div {{log}}>
checkroom "table"
</div>
*'''Returns:''' true or false, or a string
*'''Description:''' Identical to checkarea, but uses the room title instead of the geographical area.

=== checkpaths ===
<div {{log}}>
checkpaths
</div>
<div {{log}}>
checkpaths 'nw'
</div>
*'''Returns:''' an array of strings, or true/false
*'''Description:''' Returns an array consisting of the current 'Obvious exits:' directions if given no argument, or true/false based on whether all arguments given are currently available as exits or not.

=== checkoutside ===
<div {{log}}>
checkoutside
</div>
<div {{log}}>
outside?
</div>
*'''Returns:''' true/false
*'''Synonyms:''' outside?
*'''Description:''' Really simple, just returns true if you're outside, false if you aren't. Probably only of use to rangers writing their own spellup scripts or something, but either way: it's available if you have a use for it.

=== checknpcs ===
<div {{log}}>
if checknpcs
fput "attack"
end
</div>
<div {{log}}>
if checknpcs "big monster of doom", "small monster of doom"
put "Oh noes!"
end
</div>
<div {{log}}>
for npc in checknpcs
put "greet #{npc}"
end
</div>
*'''Returns:''' an array of strings, a string, or nil
*'''Description:''' If checknpcs is used without giving it npcs to check for, it returns an array of strings coresponding to the noun of each npc in the room, or nil if there are no npcs (does not return an empty array, so you can use "if checknpcs"). If chekcnpcs is given npcs to look for, it returns a string of the first matching npc it finds, or nil if none matched (any string evaluates to true, only nil and false evaluate to false in an if statement).

=== checkpcs ===
<div {{log}}>
checkpcs
</div>
<div {{log}}>
checkpcs "shaelun"
</div>
*'''Returns:''' array of strings, or true/false
*'''Description:''' Identical to 'checknpcs', but with the players currently present.

=== checkloot ===
<div {{log}}>
checkloot
</div>
*'''Returns:''' an array of strings (or an empty array if no items)
*'''Description:''' Returns an array consisting of the items currently in the room.

== Familiars ==

=== checkfamarea/checkfamroom ===
<div {{log}}>
checkfamarea
</div>
<div {{log}}>
checkfamarea "illistim"
</div>
*'''Returns:''' a string, or true/false
*'''Description:''' Identical to checkarea/checkroom, but check your familiar's current location instead of yours (only in Wizard and only if you have a familiar).

=== checkfampcs ===
<div {{log}}>
checkfampcs "shaelun"
</div>
<div {{log}}>
checkfampcs
</div>
*'''Returns:''' array of strings, or true/false
*'''Synonyms:''' checkfamnpcs
*'''Description:''' Identical to the above two, but tracks for your familiar's room instead. Not available in SF as of v3.06.

== Character ==

=== checkpoison ===
<div {{log}}>
checkpoison
</div>
*'''Returns:''' true/false
*'''Description:''' See checkdisease.

=== checkdisease ===
<div {{log}}>
checkdisease
</div>
*'''Returns:''' true/false
*'''Description:''' See checkpoison.

=== checkfried ===
<div {{log}}>
checkfried
</div>
*'''Returns:''' true or false
*'''Description:''' Returns true if you're fried, false if not.

=== checkmind ===
<div {{log}}>
checkmind
</div>
<div {{log}}>
checkmind(2)
</div>
*'''Returns:''' true or false, or a string
*'''Description:''' By itself returns a string representing the level of exp in your head ('clear as a bell', 'fried', 'muddled', etc). If given an integer, returns true or false if you have the corresponding level of exp in your head, with 0 being 'clear as a bell', 1 being 'fresh and clear', etc.

=== check_mind ===
<div {{log}}>
check_mind
</div>
<div {{log}}>
check_mind(50)
</div>
*'''Returns:''' true or false, or a string
*'''Description:''' By itself returns a string representing the level of exp in your head ('clear as a bell', 'fried', 'muddled', etc). If given an integer, returns true or false if you have the corresponding percentage of exp in your head.

=== percentmind ===
<div {{log}}>
percentmind
</div>
<div {{log}}>
percentmind(80)
</div>
*'''Returns:''' integer, or true or false
*'''Description:''' By itself returns an integer ranging from 0-100 representing the percentage of exp in your head. If given an integer, returns true or false if you have at least that percentage of experience. Both saturated and fried show up as 100 percent - a user interested in distinguishing between the two can add a checksaturated or saturated? qualifier to their percentmind check.

=== checkright/checkleft ===
<div {{log}}>
checkright
</div>
<div {{log}}>
checkleft "broadsword"
</div>
*'''Returns:''' true or false, or a string
*'''Synonyms:''' righthand?/lefthand?
*'''Description:''' Give them a string and will return true/false if it matches what you're holding, or the last word in the item name if used by itself. If your hands are currently empty, it will return 'nil' (identical to 'false' in a logical comparison) regardless of whether it was given an argument or not. This behavior can be useful to make absolutely certain a 'take' command succeeded, for instance.

=== checkstance ===
<div {{log}}>
checkstance
</div>
<div {{log}}>
checkstance "offensive"
</div>
<div {{log}}>
checkstance 0
</div>
*'''Returns:''' true or false, or a string
*'''Synonyms:''' stance
*'''Description:''' With no arguments, returns the string representing your current stance. With a numerical or string argument, returns a boolean flag indicating if the current stance matches the given string. For string based comparisons, this will correctly test against the stance values possible if using [[Combat Mastery]] or [[[[Warrior_Tricks#Stance_Perfection|Stance Perfection]]]], while integer based arguments will perform a precise comparison.

=== check(thing) ===
<div {{log}}>
checkstanding
</div>
<div {{log}}>
checkspell "spirit defense"
</div>
<div {{log}}>
checkdead
</div>
*'''Returns:''' mostly true/false
*'''Synonyms:''' checkstanding; checknotstanding; checksitting; checkprone; checkkneeling/kneeling?; checkprep/prepped?; checkmind; checkgrouped/checkjoined/joined?; checkwebbed/webbed?; checkstunned/stunned?; checkdead/dead?; checkhidden/checkhiding/hidden/hiding?; checkname/myname?; checkspell/checkactive/active?
*'''Description:''' Most are true if you are (checkstunned for example), false if you aren't; they all follow the same basic behavior as the above-documented 'check' commands.

=== checkname ===
<div {{log}}>
checkname
</div>
<div {{log}}>
checkname "Shaelun"
</div>
*'''Returns:''' string or true/false
*'''Description:''' True/false if given a string and the names match, or just returns the character name if given no arguments.

=== checkstamina ===
<div {{log}}>
checkstamina 50
</div>
<div {{log}}>
checkstamina
</div>
*'''Returns:''' true/false or an integer
*'''Description:''' Only in StormFront (there is no auto-updated stamina tag in Wizard). Given no arguments, returns your current stamina. Given a number, returns true/false based on whether you have at least or more than that number.

=== checkrt / checkcastrt ===
<div {{log}}>
checkrt
</div>
<div {{log}}>
checkcastrt
</div>
*'''Returns:''' value of roundtime
*'''Description:''' Returns a value of how much roundtime left. Useful for IF statements.

=== checkmana/checkhealth/checkspirit ===
<div {{log}}>
checkmana 50
</div>
*'''Returns:''' identical as above
*'''Synonyms:''' health, health?, mana, mana?, spirit, spirit?
*'''Description:''' Identical to checkstamina.

=== maxhealth/maxstamina/maxmana/maxspirit ===
<div {{log}}>
fput "eat my acantha leaf" while (checkhealth < maxhealth)
</div>
*'''Returns:''' integer
*'''Description:''' Returns your maximum health/spirit/stamina/mana as an integer (class Fixnum). Takes no arguments.

=== percenthealth/percentmana/percentspirit/percentstamina ===
<div {{log}}>
fput "eat my acantha leaf" while (percenthealth < 90)
</div>
*'''Returns:''' integer
*'''Description:''' Returns an integer (0-100) representing the percentage of your current health/mana/whatever in relation to your max.

=== checkspell ===
<div {{log}}>
checkspell "elemental defense i"
</div>
*'''Returns:''' true/false
*'''Synonyms:''' active?
*'''Description:''' Returns true if the spell you give it is active, false if it isn't (only available if you use the infomon script, since that's what keeps track of this).

=== Wounds ===
<div {{log}}>
Wounds.torso
</div>
<div {{log}}>
Wounds.neck
</div>
<div {{log}}>
Wounds.lhand
</div>
*'''Returns:''' an integer
*'''Variations:''' Wounds.head; Wounds.neck; Wounds.abs; Wounds.lhand; Wounds.rhand; Wounds.larm; Wounds.rarm; Wounds.chest; Wounds.back; Wounds.rleg; Wounds.lleg; Wounds.nerves
*'''Description:''' Returns the current wound rank (numerically). If I had 'deep gashes and serious bleeding' on my chest, Wounds.chest would return the integer 3. If I had no wound there, it would return 0.

=== Scars ===
<div {{log}}>
Scars.abs
</div>
<div {{log}}>
Scars.nerves
</div>
<div {{log}}>
Scars.rleg
</div>
*'''Returns:''' an integer
*'''Description:''' Identical to Wounds above, but for scars instead of wounds.

== Lich toggles ==

=== # QUIET ===
<div {{log}}>
# QUIET
</div>
*'''Returns:''' n/a
*'''Description:''' This is a special directive that must be a Ruby comment placed as above in the first line of the Lich script. Lich will ordinarily bookend the lifetime of a script with <code>--- Lich: (scriptname) active.</code> and <code>--- Lich: (scriptname) has exited.</code> This option omits those lines, allowing a script to start and exit silently.

=== hide_me ===
<div {{log}}>
hide_me
</div>
*'''Returns:''' updated value of the setting (true/false)
*'''Description:''' Toggles on/off the 'hidden' setting. When this setting is on (defaults to off), a script will not be listed when the user types ;list. It will still show up under ;list all. There is no way to prevent a script from being being displayed in ;list all.

=== i_stand_alone ===
<div {{log}}>
i_stand_alone
</div>
*'''Returns:''' updated value of the setting (true/false)
*'''Description:''' Toggles on/off. Removes a script from ALL data feeds; a script using this will receive no game lines and no unique data whatsoever (unless they toggle it back off). If Lich can more or less ignore that a script exists and not bother with keeping its data stacks up-to-the-second with game data and anything else it's requested, then a script has virtually no overhead whatsoever (meaning any resources it requires come only from what it does independantly). Useful for some scripts who have no need to eat up resources being fed game data (such as dict.lic).

=== no_kill_all ===
<div {{log}}>
no_kill_all
</div>
*'''Returns:''' updated value of the setting (true/false)
*'''Description:''' Toggles on/off the 'no kill all' setting: when this setting is on (defaults to off), a script will not be affected by the user typing ;kill all. A script with this set to on must be killed specifically (by typing ;kill [script], or just ;kill). There is no way to prevent a script from being killed when targeted by the user.

=== no_pause_all ===
<div {{log}}>
no_pause_all
</div>
*'''Returns:''' updated value of the setting (true/false)
*'''Description:''' Toggles on/off the 'no pause all' setting: when this setting is on (defaults to off), a script will not be affected by the user typing ;pause all. A script with this set to on must be killed specifically (by typing ;pause [script], or just ;pause). There is no way to prevent a script from being paused when targeted by the user.

=== silence_me ===
<div {{log}}>
silence_me
</div>
*'''Returns:''' updated value of the setting (true/false)
*'''Description:''' Toggles on/off the 'silenced' setting. A script with this on will not have commands it sends to the game echoed to your game window. A script run in SAFE mode cannot change this setting (attempting to do so will generate a warning and otherwise have no effect).

===status_tags===
<div {{log}}>
status_tags
</div>
*'''Returns:''' ?
*'''Description:'''Tells Lich to send this script XML tags rather than stripping them, or, if already doing so, tells Lich to go back to stripping the XML. If called with the argument "on" or "off", switches to that setting and echoes that it has done so.

=== toggle_echo ===
<div {{log}}>
toggle_echo
</div>
*'''Returns:''' updated value of the setting (true/false)
*'''Description:''' Toggles on/off the 'suppress echo' setting. A script with this on will not execute any 'echo' commands, but will silently ignore them instead; it's designed more for people who don't want clutter in their game window but still want to make use of an existing script. Commands sent to the game are still echoed to the game window.

=== toggle_unique ===
<div {{log}}>
toggle_unique
</div>
*'''Returns:''' updated value of the setting (true/false)
*'''Description:''' When a script is set as being 'unique', it does not receive normal game data; instead it only receives what the user sends to it by typing ;send to (script) (message). This is of use if a script wants to only act on a user's input or has no use for game data (it provides a method for scripts to make sure game data doesn't accidentally get recognized as a user's input, and also serves to prevent scripts from slowly eating away at system resources because the script never checks or clears its data buffer -- see the 'clear' command for more on that).

=== toggle_upstream ===
<div {{log}}>
toggle_upstream
</div>
*'''Returns:''' updated value of the setting (true/false)
*'''Description:''' This must be enabled to allow the script to intercept what you send to the game. See the separate upstream section for more detail.

== Lich::Util ==
=== issue_command() ===
<div {{log}}>
Lich::Util.issue_command(command, start_pattern, end_pattern = /<prompt/, include_end: true, timeout: 5, silent: nil, usexml: true, quiet: false)

Lich::Util.issue_command('tattoo menu', /List of flash tattoos available $Page \d+$:/
</div>
*'''Returns:''' returns result as an array of strings.
*'''Description:''' Will attempt to issue the command(string) given and capture the returning output from the begging start_pattern(regex) until the end_pattern(regex) is seen or the timeout(int) is reached. include_end(booleen) will indicate whether the last line of the end_pattern is included in the array. silent(boolean) will determine if the command is sent silently or echo'd to the frontend. usexml determines whether the start/end pattern is matching against the xml feed or plain txt feed. quiet flag determines whether the output is squelched or shown to the front end. The only required values needed are command and start_pattern. Everything else has default values that can be used or changed.

=== quiet_command_xml() ===
<div {{log}}>
Lich::Util.quiet_command_xml(command, start_pattern, end_pattern = /<prompt/, include_end = true, timeout = 5, silent = true)

Lich::Util.quiet_command_xml("tattoo menu", /List of flash tattoos available $Page \d+$:/)
</div>
*'''Returns:''' returns result as an array of strings.
*'''Description:''' Will attempt to issue the command(string) given and capture XML buffer lines once the start_pattern(regex) is seen till the end_pattern(regex) is seen or the timeout(int) is reached. include_end(booleen) will indicate whether the last line of the end_pattern is included in the array. silent(boolean) will determine if the command is sent silently or echo'd to the frontend. end_pattern, include_end, timeout, and silent do not need to be included unless changing the default values.

=== quiet_command() ===
<div {{log}}>
Lich::Util.quiet_command(command, start_pattern, end_pattern, include_end = true, timeout = 5, silent = true)

Lich::Util.quiet_command("tattoo menu", /List of flash tattoos available $Page \d+$:/, end_pattern = /Type TATTOO MENU again in the next minute to display the next group of flash tattoos\./)
</div>
*'''Returns:''' returns result as an array of strings.
*'''Description:''' Will attempt to issue the command(string) given and capture buffer lines once the start_pattern(regex) is seen till the end_pattern(regex) is seen or the timeout(int) is reached. include_end(booleen) will indicate whether the last line of the end_pattern is included in the array. silent(boolean) will determine if the command is sent silently or echo'd to the frontend. include_end, timeout, and silent do not need to be included unless changing the default values.

=== silver_count() ===
<div {{log}}>
Lich::Util.silver_count(timeout = 3)

Lich::Util.silver_count
</div>
*'''Returns:''' an integer of how much silver you have
*'''Description:''' useful to know the amount of silver one has on themselves.

== Lich::Messaging ==

=== monsterbold ===
<div {{log}}>
Lich::Messaging.monsterbold(msg)

Lich::Messaging.monsterbold("This text I want to monsterbold")
</div>
*'''Returns:''' an encoded string with proper monsterbold tags depending on FrontEnd used
*'''Description:''' Will take the string given and return it with monsterbold before/after and xml_encode the msg.

=== msg_format ===
<div {{log}}>
Lich::Messaging.msg_format(type, msg)

Lich::Messaging.msg_format("info", "Let's make this text pretty!")
</div>
*'''Returns:''' an encoded string with start and end tags to change the color in the FrontEnd
*'''Description:''' Returns the string given with color coding based on the type chosen. Current options are as follows:
** error, yellow, bold, monster, creature
** warn, orange, gold, thought
** info, teal, whisper
** green, speech, debug, light green

=== msg ===
<div {{log}}>
Lich::Messaging.msg(type, msg)

Lich::Messaging.msg("info", "Let's make this text pretty!")
</div>
*'''Description:''' sends the string given to the client encoded for the type given.

=== stream_window ===
<div {{log}}>
Lich::Messaging.stream_window(msg, window)

Lich::Messaging.stream_window("Let's send this to a different window!", "familiar")
</div>
*'''Description:''' send the string to the various stream window. Currently supports the familiar, speech, thoughts and loot window.

=== xml_encode ===
<div {{log}}>
Lich::Messaging.xml_encode(msg)

Lich::Messaging.xml("Let's encode some text!")
</div>
*'''Returns:''' an xml encoded text

=== mono ===
<div {{log}}>
Lich::Messaging.mono(msg)

Lich::Messaging.mono("Let's mono some code!")
</div>
*'''Returns:''' force mono formatted string to be displayed properly using XML output class of mono

== Settings ==

Settings are specific to the script itself. For example, a setting with the name "bank" in fetch_turnips.lic have no effect on the "bank" setting in buy_cheese.lic.

=== Settings.load ===
<div {{log}}>
Settings.load
</div>

=== Settings["SettingName"] ===
<div {{log}}>
Settings["SettingName"]
</div>

=== Settings.save ===
<div {{log}}>
Settings.save
</div>

=== Settings.clear ===
<div {{log}}>
Settings.clear
</div>
*'''Returns:''' either a hash representing your settings, or 'nil' if no settings for the script exist
*'''Description:''' Note that Settings.clear will erase all settings, but it will NOT save that on its own. Issue a Settings.save command after the Settings.clear if you want that script's settings reset permanently.

== Upstream ==

=== upstream_get ===
<div {{log}}>
upstream_get
</div>
*'''Returns:''' a string
*'''Description:''' Same thing as "get" except it fetches the last line the user sent to the game. A script has to ask Lich to give it this information by first using the "toggle_upstream" command.

=== upstream_get? ===
<div {{log}}>
upstream_get?
</div>
*'''Returns:''' a string
*'''Description:''' Attempts to get the last line the user sent to the game, but does not wait for a line to be sent. A script has to ask Lich to give it this information by first using the "toggle_upstream" command.

=== upstream_waitfor ===
<div {{log}}>
upstream_waitfor "climb stairs"
</div>
*'''Returns:''' a string
*'''Description:''' Identical to "waitfor" but only checks the upstream commands (the commands sent to the game by the user).

== Interscript communication ==

=== running? ===
<div {{log}}>
running? "test"
</div>
*'''Returns:''' true/false
*'''Description:''' Takes a string and returns true/false if the given script is active or not.

=== send_to_script ===
<div {{log}}>
send_to_script 'scriptname', 'message to send'
</div>
*'''Returns:''' true or false
*'''Description:''' The target script will be sent a string exactly as though it came from the game. Returns true if successful, false if the script wasn't found to be active.

=== send_scripts ===
<div {{log}}>
send_scripts "To the running scripts, this line looks identical to one that came from the game"
</div>
*'''Returns:''' true/false
*'''Description:''' Same as 'send_to_script', but sends a line to all scripts instead of just one.

=== start_script ===
<div {{log}}>
start_script "test"
</div>
<div {{log}}>
start_script "heal", [ "shaelun", "adhara" ]
</div>
*'''Returns:''' true/false
*'''Description:''' Simulates the user having entered ;test in the game entry box. Returns 'true' if the script was successfully started, 'false' if for any reason it couldn't be found/started. The optional second argument (which must be an array, as seen in the above example) can be used to simulate arguments to the script (the above example would simulate the user typing: ;heal shaelun adhara).

=== start_scripts ===
<div {{log}}>
start_scripts "test"
</div>
<div {{log}}>
start_scripts "test", "calcredux", "etc"
</div>
*'''Returns:''' true/false
*'''Description:''' Executes a "start_script" command for every argument given. Note that you cannot give a script arguments when using this command.

=== pause_script ===
<div {{log}}>
pause_script
</div>
<div {{log}}>
pause_script "test"
</div>
*'''Returns:''' true/false
*'''Description:''' If given no arguments, pauses the script using the command. If given a string, pauses the script who's name matches that string; if the script is not currently active, returns 'false' ('true' if the script was paused successfully).

=== unpause_script ===
<div {{log}}>
unpause_script "test"
</div>
*'''Returns:''' true/false
*'''Description:''' Unpauses the script you give it. Note that because of the way the 'script is paused' state is handled, it's conceivable for a script that was paused to actually still be executing commands internally for a brief time -- a script isn't actually "stopped dead in its tracks" until it attempts to interact with the game in some way (by fetching game data, sending game data, or by attempting a command that requires the script to be identified). Since most commands identify a script (including this one), this command cannot unpause the script itself: when it attempts to unpause itself, it will be identified as being paused and will be halted where it is until it's unpaused by another script or the user (or killed). When it is, it will be allowed to continue, and will then try to unpause itself (pointlessly, since it was just unpaused...).

=== kill_script ===
<div {{log}}>
kill_script "test"
</div>
*'''Returns:''' true/false
*'''Synonyms:''' kill_scripts, stop_script, stop_scripts
*'''Description:''' Simulates the user having entered ;kill test in the game entry box and hitting enter; takes multiple scripts to kill. If the script is not running, returns false; if the script was found to be active and was killed, returns true.

== Unique ==

See [[Lich_scripting_reference#toggle_unique|toggle_unique]] for more about the 'unique' stack.

=== unique_get ===
<div {{log}}>
unique_get
</div>
*'''Returns:''' a string
*'''Description:''' Fetches a line from the unique stack, as opposed to the game data stack ().

=== unique_send_to_script ===
<div {{log}}>
unique_send_to_script 'scriptname', 'message to send'
</div>
*'''Returns:''' true or false
*'''Description:''' Same as 'send_to_script', but the script will receive the string sent in its 'unique' stack instead of its 'game data' stack (see [[Lich_scripting_reference#toggle_unique|toggle_unique]] for more info).

=== unique_waitfor ===
<div {{log}}>
unique_waitfor "continue"
</div>
*'''Returns:''' a string
*'''Description:''' Same as 'waitfor' but acts on the 'unique' queue.

== Exit handling ==

=== exit ===
<div {{log}}>
exit
</div>
*'''Returns:''' does not return
*'''Description:''' Ends the script.

=== die_with_me ===
<div {{log}}>
die_with_me "test", "calcredux", "etc"
</div>
*'''Returns:''' true
*'''Description:''' If the given scripts are active at the time the script using this command ends ("exit", finishes, gets killed by the user, or dies in error) they'll all be killed automatically (produces no notification to avoid clutter, but the scripts are indeed stopped). The given scripts need not be running (or technically even exist) at the time this command is used -- it only updates the setting, and that setting isn't actually acted upon until the script is killed.

=== before_dying ===
<div {{log}}>
before_dying { echo "Oh God, why have you killed me dear user...?!" }
</div>
<div {{log}}>
before_dying { Settings.save }
</div>
*'''Returns:''' true
*'''Description:''' Performs the given actions right before the script exits. Note nothing is done at the time this command is used (it simply sets what should be done just before the script is killed). The block given to this command is actually wrapped up into a proc object (an object of the 'Procedure' class), and scheduled to be run when the script is killed/exits (if multiple procs exist, they are executed sequentially in the order they were declared). Because of this, the same 'binding' principles that apply to other proc objects apply here (in a nutshell, if a variable didn't exist when you declared the 'before_dying' stuff, then you can't use it in the 'before_dying' code; if it did exist at the time though, you *can* use it, even if it doesn't really exist in the script when it dies). Also note that if the command(s) take more than 0.5 seconds to complete, they're forcibly aborted and the script is killed regardless (this is to prevent a possibly bad situation where a script makes a mistake in the 'before_dying' command and is refusing to stop executing due to errors). Note that if a script is set as executing in SAFE mode, all the restrictions that normally apply will also apply in the 'before_dying' code block (this cannot circumvent that, nor can anything else for that matter).

=== undo_before_dying ===
<div {{log}}>
undo_before_dying
</div>
*'''Returns:''' true
*'''Description:''' Clears any 'before_dying' commands that have been used for the script.

=== abort! ===
<div {{log}}>
abort!
</div>
*'''Returns:''' does not return
*'''Description:''' Immediately kills the script, bypassing any 'before_dying' blocks that have been registered. Probably won't ever be of use, but it's a way to make the calling script go away as fast as possible (note that it isn't any faster than the 'exit' command is, it just makes sure that nothing except stopping the script happens).

== Spell ==

The Spell class combines spell information from spell-list.xml and character information from infomon to greatly simplify basic spell handling.

=== Spell[number].cast() ===
<div {{log}}>
Spell[503].cast
Spell[503].cast('Tilmen')
</div>
*'''Returns:''' returns result as string ( ie cast roundtime, hinderance, etc. )
*'''Description:''' Attempt to cast spell given using info from spell-list.xml

=== Spell[number].affordable? ===
<div {{log}}>
Spell[503].affordable?
</div>
*'''Returns:''' returns true or false
*'''Description:''' Useful for knowing if you have enough mana for spell

=== Spell[number].active? ===
<div {{log}}>
Spell[503].active?
</div>
*'''Returns:''' returns true or false if spell is active
*'''Description:''' Will return true if the spell is currently active on yourself, false if it is not.

=== Spell[number].timeleft ===
<div {{log}}>
Spell[503].timeleft
</div>
*'''Returns:''' returns number
*'''Description:''' Returns amount of time left as value

=== Spell[number].force_cast() ===
<div {{log}}>
Spell[503].force_cast
Spell[503].force_cast('Tilmen')
</div>
*'''Returns:''' returns result as string ( ie cast roundtime, hinderance, etc. )
*'''Description:''' Attempt to force cast spell

=== Spell[number].force_channel() ===
<div {{log}}>
Spell[503].force_channel
Spell[503].force_channel('Tilmen')
</div>
*'''Returns:''' returns result as string ( ie cast roundtime, hinderance, etc. )
*'''Description:''' Attempt to force channel spell

=== Spell[number].force_evoke() ===
<div {{log}}>
Spell[503].force_evoke
Spell[503].force_evoke('Tilmen')
</div>
*'''Returns:''' returns result as string ( ie cast roundtime, hinderance, etc. )
*'''Description:''' Attempt to force evoke spell

=== Spell[number].force_incant() ===
<div {{log}}>
Spell[503].force_incant
</div>
*'''Returns:''' returns result as string ( ie cast roundtime, hinderance, etc. )
*'''Description:''' Attempt to force incant spell

== Effect ==

=== active? ===
<div {{log}}>
Effects::Spells.active?("Call Familiar")

Effects::Spells.active?(920)

Effects::Cooldowns.active?("Mana Leech")

Effects::Buffs.active?("Rapid Fire")

Effects::Debuffs.active?("Silenced")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the given effect is currently active. Spells can be referenced by number or name, unless the spell does not have a number, then must be referenced by name. Name can only be used when FLAG ShowSpellName is set to ON.

=== time_left ===
<div {{log}}>
Effects::Spells.time_left("Call Familiar")

Effects::Spells.time_left(920)

Effects::Cooldowns.time_left("Mana Leech")

Effects::Buffs.time_left("Rapid Fire")

Effects::Debuffs.time_left("Silenced")
</div>
*'''Returns:''' time left in minutes as a floating number
*'''Description:''' Used to determine how much time is left on a given effect.

== Weapon ==
=== known? ===
<div {{log}}>
Weapon.known?(name)

Weapon.known?("Charge")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the weapon skill given is known to the character.

=== affordable? ===
<div {{log}}>
Weapon.affordable?(name)

Weapon.affordable?("Charge")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the weapon skill given is affordable for the character.

=== available? ===
<div {{log}}>
Weapon.available?(name)

Weapon.available?("Charge")
</div>
*'''Returns:''' true or false
*'''Description:''' Checks whether the weapon skill is known, currently affordable, and that no known current cooldown or Overexerted debuff would block it's use.

== CMan ==
=== known? ===
<div {{log}}>
CMan.known?(name)

CMan.known?("Garrote")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the cman skill given is known to the character.

=== affordable? ===
<div {{log}}>
CMan.affordable?(name)

CMan.affordable?("Garrote")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the cman skill given is affordable for the character.

=== available? ===
<div {{log}}>
CMan.available?(name)

CMan.available?("Garrote")
</div>
*'''Returns:''' true or false
*'''Description:''' Checks whether the cman skill is known, currently affordable, and that no known current cooldown or Overexerted debuff would block it's use.

== Shield ==

=== known? ===
<div {{log}}>
Shield.known?(name)

Shield.known?("Shield Charge")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the shield skill given is known to the character.

=== affordable? ===
<div {{log}}>
Shield.affordable?(name)

Shield.affordable?("Shield Charge")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the shield skill given is affordable for the character.

=== available? ===
<div {{log}}>
Shield.available?(name)

Shield.available?("Shield Charge")
</div>
*'''Returns:''' true or false
*'''Description:''' Checks whether the shield skill is known, currently affordable, and that no known current cooldown or Overexerted debuff would block it's use.

=== use ===
<div {{log}}>
Shield.use(name, target = "")

Shield.use("Shield Charge", "Wyrom")
Shield.use("Shield Charge", 9000)
</div>
*'''Description:''' Attempts to use the shield skill given on target specified. Target can be a GameObj, integer, or string. If no target given, will issue command with no target, relying on game-engine targeting.

== Armor ==
=== known? ===
<div {{log}}>
Armor.known?(name)

Armor.known?("Armor Blessing")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the armor skill given is known to the character.

== Feat ==
=== known? ===
<div {{log}}>
Feat.known?(name)

Feat.known?("Absorb Magic")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the feat skill given is known to the character.

=== affordable? ===
<div {{log}}>
Feat.affordable?(name)

Feat.affordable?("Absorb Magic")
</div>
*'''Returns:''' true or false
*'''Description:''' Used to detect whether the feat skill given is affordable for the character.

=== available? ===
<div {{log}}>
Feat.available?(name)

Feat.available?("Absorb Magic")
</div>
*'''Returns:''' true or false
*'''Description:''' Checks whether the feat skill is known, currently affordable, and that no known current cooldown or Overexerted debuff would block it's use.

== GameObj ==

The GameObj class tracks various objects in the same room as you, and makes their game id, name, noun, status, and contents available to you.

=== GameObj arrays ===

Several arrays are exposed by GameObj. They include:

==== GameObj.inv ====

*'''Returns:''' an array of objects of the GameObj class representing the things you are wearing.

==== GameObj.pcs ====

*'''Returns:''' an array of objects of the GameObj class representing the other players in the room, or nil if there are none.

==== GameObj.npcs ====

*'''Returns:''' an array of objects of the GameObj class representing the npcs in the room, or nil if there are none.

==== GameObj.loot ====

*'''Returns:''' an array of objects of the GameObj class representing the loot in the room, or nil if there is none. For the purposes of this function, loot is anything that Simu hasn't tagged with monster bold. Any exits or anything that shows up in the "You also see" line will be included.

==== GameObj.room_desc ====

*'''Returns:''' an array of objects of the GameObj class representing any links found in the room description, or nil if there are none.

==== GameObj.dead ====

*'''Returns:''' an array of objects of the GameObj class representing the dead '''npcs''' in the room, or nil if there are none.

==== GameObj.fam_pcs, GameObj.fam_npcs, GameObj.fam_loot, GameObj.fam_room_desc ====

*'''Returns:''' an array of objects of the GameObj class. Similar to the ones above, except for your familiar's room, and these don't stay up-to-date without having your familiar look at the room.

==== GameObj.targets ====

*'''Returns:''' an array of objects of the GameObj class representing the hostile npcs in the room, the mobs, the monsters, whatever you want to call them.

==== GameObj.target ====

*'''Returns:''' an object of the GameObj class representing the current target you have selected, if any.

=== Finding game objects with GameObj ===

Now that you've got an object or array of objects, here's what to do with them:

<div {{log}}>
target = GameObj.npcs.find { |npc| npc.status.nil? }<br>
if target<br>
   fput "attack ##{target.id}"<br>
end
</div>

*'''Description:''' This example shows (in an over-simplified way) the most common use of the GameObj class. First, "GameObj.npcs" gives an array of all the npcs in the room. Then, ".find" searches each item in that array. For each item in the array, the code inside the brackets following "GameObj.npcs.find" is run, and "npc" represents the item it's currently looking at. The code inside the brackets acts like an if statement, and as soon as it is true, "target" is assigned the npc object.

The "status" method applies to npcs and pcs (using it on others won't give an error, but it will always return nil). The status is basically whatever shows up after "that appears", "that is", or "who is". So, if you also see a kobold that appears stunned, its status will be "stunned". In the example, we're looking for an npc with a nil status, because that represents an npc that's standing and not stunned, dead, prone, etc. The game never shows "You also see a kobold that is standing."

Now suppose there's twenty kobolds in the room, and only the fifteenth one is standing. How can you be sure you attack the standing one? This is where the kobold's id comes in handy. Simu assigns an id to almost everything in the game. Stormfront uses these ids when you click on links. For the most part, these ids can be used just like nouns. "attack ##{target.id}" will attack the npc you found earlier, even if other npcs are walking in and out of the room. The double pound sign is not a typo.

=== Other GameObj methods ===

==== GameObj.containers ====

*'''Returns:''' a Hash of ids (as Strings) mapping to arrays of objects of the GameObj class. Each id represents an accessible container '''that GameObj is aware of''' with the given id. The id maps to an array of objects of the GameObj class representing that container's contents.

For a container to be added to the Hash, GameObj must first be made aware of its contents by some sort of interaction with the container, looking in it, opening it, and more. (Someone who knows the specific cases, please add detail!)

==== GameObj.right_hand, GameObj.left_hand ====

*'''Returns:''' an object of the GameObj class representing whatever is in your hand. Currently, if there is nothing in your hand, it still returns a GameObj where the name is "Empty".

==== Useful and hopefully self-explanatory methods to use once you have the right GameObj object====

<div {{log}}>
.id<br>
.name<br>
.noun<br>
.status<br>
.contents
</div>

== Script ==

The Script class deals with and runs scripts.

=== Script.start ===
*'''Description:''' Starts the specified script. Arguments for that script should be passed as a single string. A hash can also be passed with other script options (:quiet, :force, and you can also use :name and :args instead of passing one/two strings).

=== Script.run ===
*'''Description:''' Starts the specified script and waits while it runs. Arguments for that script should be passed as a single string. A hash can also be passed with other script options (:quiet, :force, and you can also use :name and :args instead of passing one/two strings).

=== Script.list, Script.running, Script.hidden ===
*'''Returns:''' An array of Script objects for every running/visible/invisible script.
*'''Note:''' This is not the same as ;list. The Script class does not have a defined to_s method.

=== Script.running? ===
*'''Description:''' Checks whether a script is running (paused or not)
*'''Returns:''' true or false

=== Script.pause ===
*'''Description:''' Pauses a script
*'''Returns:''' true if the script was paused successfully, false otherwise (script not running or already paused)

=== Script.unpause ===
*'''Description:''' Unpauses a script
*'''Returns:''' true if the script was unpaused successfully, false otherwise (script not running or was not paused)

=== Script.paused? ===
*'''Returns:''' true if a script is running and paused, false otherwise

=== Script.exists? ===
*'''Returns:''' true if a script with the given name is in the user's script directory, false otherwise. extension is optional.

=== Script.log ===
Appends to the script's .log file in the lich/log directory.

=== Script.db ===
Gets you a sqlite3 database for your script, of type SQLite3::Database (http://www.rubydoc.info/github/luislavena/sqlite3-ruby/SQLite3/Database)

=== Script.version ===
<div {{log}}>
Script.version("infomon")
</div>
*'''Returns:''' Ruby Gem version
*'''Description:''' Takes a string(script) and returns the current version in header of script as a Ruby Gem version

<div {{log}}>
Script.version("infomon", "1.18.0")
</div>
*'''Returns:''' true/false
*'''Description:''' Takes a string(script) and minimum required version

== Global variables ==

=== $PROGRAM_NAME ===
Ruby's global variable capturing current script -- in this case, the path to Lich.

=== $frontend ===
Frontend detected by Lich.

=== $login_time ===
Local time the current Lich session started.

== Lich Constants ==

=== LICH_DIR ===
Path of the current Lich directory.

=== SCRIPT_DIR ===
Path to directory Lich is using to for scripts.

=== DATA_DIR ===
Path to the directory Lich is using for data.

=== LOG_DIR ===
Path to the directory Lich is using for logs.

=== LICH_VERSION ===
Lich version.

== Builtin Lich shortcuts ==

These automatically perform multiple checks or commands.

=== take ===
<div {{log}}>
take "box", "coffer", "ruby", "etc"
</div>
*'''Returns:''' a string (the last line the 'fput' command saw)
*'''Description:''' Picks up every item listed and puts each one in turn into your 'lootsack:' setting by issuing the commands with fput.

=== fetchloot ===
<div {{log}}>
fetchloot
</div>
*'''Returns:''' a string
*'''Description:''' Performs a 'look' and takes/puts away all items on the ground that aren't listed in your 'excludeloot:' setting. Return value is the last line from the game.
*'''See also:''' GS now natively includes the command LOOT ROOM with a similar effect.

=== Lich.fetchloot ===
<div {{log}}>
Lich.fetchloot
</div>
*'''Returns:''' a string
*'''Description:''' Identical to 'fetchloot' in all ways except only the items listed in your 'treasure:' setting are fetched.

=== walk ===
<div {{log}}>
walk
</div>
*'''Returns:''' true or false
*'''Description:''' Moves in a random cardinal direction (what's seen in the 'Obvious exits:' line), storing the direction moved, and returning 'true' if there is a critter in the room or 'false' if there aren't any NPCs in the room. The stored direction will not be among the random directions chosen the next time the 'walk' command is used (unless it hits a dead-end, then it will backtrack the way it came).

=== run ===
<div {{log}}>
run if not health(50)
</div>
*'''Returns:''' true or false
*'''Description:''' Will execute a 'walk' command repeatedly until it enters a room with no critters, at which point it returns and the script will pick up execution on the next line (does not continue to run away).
*'''See also:''' wander.lic is a popular and sophisticated auto-moving creature-finding script.

=== watchhealth ===
<div {{log}}>
watchhealth(50) { echo "Uh, your health is below 50..." }
</div>
<div {{log}}>
watchhealth(50, proc_object)
</div>
*'''Returns:''' nothing useful
*'''Description:''' Returns immediately so that the calling script continues to run as normal, and while it does, monitors your health. If it falls below the number you give it, executes the block you passed to it. Only does this once -- if you want it to repeat as the script executes (be careful, chances are your health will still be below 50 after the block executes once) then pass watchhealth a proc object that includes a line registering itself over again (as in, a proc that includes a 'watchhealth(#, self)' thingie). If your health never falls below the number you give it, then nothing happens; once the script ends, it stops watching.

== goto ==
<div {{log}}>
goto "MainLabel"
</div>
*'''Returns:''' (has no return value, the current execution stack is discarded and the jump never returns)
*'''Description:''' Identical to standard Wizard/SF scripts; the label to jump to has to be in quotes, and it is (kinda sorta) case insensitive. The label declaration itself (the LABEL: line) MUST NOT be in quotes: only the name of the label when you use the goto command. If there are two labels with the same name but different capitalizations, the goto command will attempt to be case sensitive.

== See also ==
*[[The Lich]]

== References ==
*The initial content of this article was copied from the scripting documentation posted by Tillmen which formerly resided at http://lichproject.com/

[[category:Scripts]]

Lich:Software/Installation

2026-08-31T18:23:24Z

HORIBU1: /* Lich Changelog */ add 5.20.1 changelog

{{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.20.1 supporting Ruby 4.0 - published August 20, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.20.1'''
<PRE>
### Bug Fixes (general)
* bound EAccess auth with a timeout so a stalled SGE backend can't hang Lich silently (#1502)
* Linux WINE and Wrayth FE detection (#1517)
* update Gemstone game-code validations (#1518)
* preserve bundled display-state tags on quiet-suppressed chunks (#1530)
* prevent a stray formatting character from appearing in Saga during quiet script output (#1532)

### Bug Fixes (dr)
* make $safe_pause_lock holder immune to pause (#1525)

### Bug Fixes (gs)
* critranks.rb tolerate nil table rows, fix reload!, index patterns … (#1522)
* combat module hardening - ordered processing, 22x faster parsing, double-count fix (#1523)
</PRE>
'''5.20.0'''
<PRE>
### Features (general)
* add concurrent runtime I/O and multi-client detach support (#1459)
* --bind-address speaks the same keywords as --detachable-client (#1461)
* GUI Launcher Improvements (#1463)
* Add supervised child script APIs (01 of 06) (#1474)
* Add forced script teardown command (06 of 06) (#1479)
* teardown and distinguishable errors for Script.run_child (#1501)

### Features (dr)
* DRCMM.moon_weapon_duration - read a moon weapon's remaining life (#1483)
* id-based creature tracking from crtrStatus + assess (#1485)
* capture room UID from <nav> tag; stop enforcing ShowRoomID; opt-in room-id placement (#1491)
* user-extensible scroll substitutions via settings (01 of 06) (#1512)
* user-extensible boxes and trash receptacles (03 of 06) (#1514)
* user-extensible summoned-weapon adjectives (04 of 06) (#1515)
* user-extensible flavor-text stripping (05 of 06) (#1516)

### Features (gs)
* gameobj add full_name matcher to type/sellable classification (#1453)

### Bug Fixes (general)
* prevent empty/partial GameObj registry reads during mid-stream refresh (#1370)
* no-op Gtk.lich_main_quit when no main loop is nested (#1464)
* correct path-flag aliases and document all path options (#1472)
* Synchronize script lifecycle transitions (02 of 06) (#1475)
* Coordinate script shutdown draining (03 of 06) (#1476)
* Harden script lifecycle ownership (05 of 06) (#1478)
* surface the underlying LoadError in dependency alerts (#1480)
* extract game-agnostic CreatureBase into lib/common (#1484)
* bound GemCheck alert dialogs with a timeout so they can't hang forever (#1488)
* identify Genie as the frontend for headless launches (#1490)
* restore detachable client disconnect notice to stdout (#1492)
* harden detachable client teardown and escape init payload (#1493)
* resolve GameObj status visibility during staged refresh (#1497)
* compact client write queue instead of ending the session (#1498)
* scrub startup credentials once login completes (#1499)
* Honor Simu-side teardown for 10 seconds (#1505)

### Bug Fixes (dr)
* resolve no-UID rooms carrying a stored UID instead of returning nil (#1467)
* equipmanager.rb - reliable ranged-weapon transitions - stow ammo after unload + verify offhand wield hand (#1468)
* common-healing.rb - DRCH.bind_wound: only dispose a dislodged item while it is in hand (#1469)
* preserve game RealID in room title (GS parity for ";display roomid title") (#1500)
* Refine need_buffs? logic for non-recast spells to correctly check cyclic spells. (#1503)
* reduce symbol-torn scale scrolls to gettable noun (#1506)
</PRE>
'''5.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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-08-31T18:21:08Z

HORIBU1: /* Installing the Latest Stable Release */ update for 5.20.1 release

{{3rd-party}}
=About=

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

=Installing the Latest Stable Release=

'''The latest stable lich version is 5.20.1 supporting Ruby 4.0 - published August 20, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.20.0'''
<PRE>
### Features (general)

* add concurrent runtime I/O and multi-client detach support (#1459)
* --bind-address speaks the same keywords as --detachable-client (#1461)
* GUI Launcher Improvements (#1463)
* Add supervised child script APIs (01 of 06) (#1474)
* Add forced script teardown command (06 of 06) (#1479)
* teardown and distinguishable errors for Script.run_child (#1501)

### Features (dr)

* DRCMM.moon_weapon_duration - read a moon weapon's remaining life (#1483)
* id-based creature tracking from crtrStatus + assess (#1485)
* capture room UID from <nav> tag; stop enforcing ShowRoomID; opt-in room-id placement (#1491)
* user-extensible scroll substitutions via settings (01 of 06) (#1512)
* user-extensible boxes and trash receptacles (03 of 06) (#1514)
* user-extensible summoned-weapon adjectives (04 of 06) (#1515)
* user-extensible flavor-text stripping (05 of 06) (#1516)

### Features (gs)

* gameobj add full_name matcher to type/sellable classification (#1453)

### Bug Fixes (general)

* prevent empty/partial GameObj registry reads during mid-stream refresh (#1370)
* no-op Gtk.lich_main_quit when no main loop is nested (#1464)
* correct path-flag aliases and document all path options (#1472)
* Synchronize script lifecycle transitions (02 of 06) (#1475)
* Coordinate script shutdown draining (03 of 06) (#1476)
* Harden script lifecycle ownership (05 of 06) (#1478)
* surface the underlying LoadError in dependency alerts (#1480)
* extract game-agnostic CreatureBase into lib/common (#1484)
* bound GemCheck alert dialogs with a timeout so they can't hang forever (#1488)
* identify Genie as the frontend for headless launches (#1490)
* restore detachable client disconnect notice to stdout (#1492)
* harden detachable client teardown and escape init payload (#1493)
* resolve GameObj status visibility during staged refresh (#1497)
* compact client write queue instead of ending the session (#1498)
* scrub startup credentials once login completes (#1499)
* Honor Simu-side teardown for 10 seconds (#1505)

### Bug Fixes (dr)

* resolve no-UID rooms carrying a stored UID instead of returning nil (#1467)
* equipmanager.rb - reliable ranged-weapon transitions - stow ammo after unload + verify offhand wield hand (#1468)
* common-healing.rb - DRCH.bind_wound: only dispose a dislodged item while it is in hand (#1469)
* preserve game RealID in room title (GS parity for ";display roomid title") (#1500)
* Refine need_buffs? logic for non-recast spells to correctly check cyclic spells. (#1503)
* reduce symbol-torn scale scrolls to gettable noun (#1506)
</PRE>
'''5.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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]]

Barkskin (605)

2026-08-31T16:56:21Z

HORIBU1: add summary tables

{{Spell
| mnemonic = BARKSKIN
| custdur = {{Spellbox block | duration = 60 sec | span = [[Solid block]], 5 min cooldown}}
| type = Defensive
| subtype = Absorb
| ds = None
| td = None
| enhancement = absorb next offensive action
| availability = all
| navigation = {{Ranger base navigation}}
}}
__NOTOC__
<section begin=description /><noinclude>'''Barkskin''' allows</noinclude><includeonly>Allows</includeonly> the Ranger to surround themselves with a thick layer of bark, which will absorb the next instance of a physical [[attack]], [[SMRv2|SMRv2 maneuver]], [[bolt]] spell, or [[warding]] spell that would have otherwise successfully struck them.<section end=description />

On attacks that would have only moderately been successful, the bark has a '''50 + ([[Spiritual Lore, Blessings]] ranks / 2) %''' chance of enduring. Moderate success is defined as a successful [[endroll]] threshold of no more than '''20 + ([[Survival]] skill / 10)'''.

{| class="wikitable" style="text-align: center;"
! [[Spiritual Lore, Blessings]] ranks
| 0 || 10 || 20 || 30 || 40 || 50 || 60 || 70 || 80 || 90 || 100
|-
! Chance to endure
| 50% || 55% || 60% || 65% || 70% || 75% || 80% || 85% || 90% || 95% || 100%
|}

{| class="wikitable" style="text-align: center;"
! [[Survival]] skill
| 100 || 150 || 200 || 250 || 300 || 350 || 400
|-
! Moderate success endroll threshold
| 130 || 135 || 140 || 145 || 150 || 155 || 160
|}

Barkskin has a five minute character-specific cooldown after successfully absorbing an effect during which that character may not gain Barkskin again.

{{Usage-evoke-self|s=605|d=to cast a [[group]] version of the spell for 15 mana, at 50 ranks of [[Spiritual Lore, Blessings]]}}
== Lore Benefits ==
Training in [[Spiritual Lore, Blessings]] increases the chance of Barkskin enduring past the initial absorb at a rate of +1 per 2 ranks, for moderate attack successes only.

Additionally, at 15 Blessings lore ranks, the Ranger may {{boldmono|COMMUNE}} with nature to cast the spell while incapacitated (but not while in [[roundtime]]) once per hour.

At 50 Blessings lore ranks, the Ranger may {{boldmono|[[EVOKE]]}} the spell to affect the Ranger’s entire group for 15 [[mana]].

== Messaging ==
;Cast
<pre{{log2}}>
You gesture.
A knobby layer of bark swiftly forms on you.
</pre>

;Cast, on cooldown
<pre{{log2}}>
You gesture.
A knobby layer of bark begins to form on you, but rapidly crumbles away.
</pre>

;Absorb
<pre{{log2}}>
TARGET tries to bite you!
The layer of bark on you hardens and absorbs the attack! The bark crackles as it crumbles to dust.
</pre>

== Resources ==
* [[/saved posts | Saved Posts]]
* [[Ranger Base/saved posts]]
* [http://forums.play.net/forums/GemStone%20IV/Professions/Ranger/view Officials folder]

[[Category:Ranger]]

High End Scrip Shop/shop list August 2026

2026-08-21T17:54:19Z

HORIBU1: add SK/MK list from discord announcement

<div class="alert alert-info"><center>'''For general information, including travel and activities, see: [[:Category:Duskruin|Duskruin]]<br><br><big>[[High End Scrip Shop/shop list August 2026|High End Scrip Shop Listing]]</big>'''</center></div>
<br>
{{TOCright|limit=2}}
[[Image:Duskruin Arena 202208.png|600px|center|Bloodriven Village grounds map by Rozy and MiceSqueaks. Updated by Arenglae on 8/16/22.|alt=The map is a representational depiction of the in-game rooms for Bloodriven Village and its Duskruin Arena, using primarily black and blue on white with several rooms numbered. Labeled portions of the map include the Kraet Encampment, the Caligae of the Colossus, the Sewers entrance, the Celestial Temple, the Dueling Sands, and where to exit to return to town.]]
{{big|'''All prices in [[bloodscrip]].}}<br>
Many services that were previously located in the High End Scrip Shop can now be found in its automated counterpart, [[BVShop:The Annex|the Annex]].
{{#section:Category:Duskruin|refunds}}

[[Category:HESS lists]]

__NoTOC__
<onlyinclude>{{Tempshop
|look=a dimly lit tunnel |realrnum= 8213008|mapid= |rnum= |portal= dimly tunnel}}
===Duskruin Arena, Scrip Shop===
{{RoomDescription|
|roomname=Duskruin Arena, Scrip Shop
|desc=Luminescent green moss lines the slick stone walls of this small chamber and provides adequate lighting despite a lack of windows or candles. Thin pathways between various sized containers and tables impede navigation to a beaded curtain. You also see a faded blue tanik strongbox, a battered wooden treasure chest, a weathered rowan crate, a metal-framed dark walnut display, a knotted length of hemp rope and a very important sign.
|realrnum= 8212527
|rnum=
|exits=
|paths= out}}
<blockquote>
{{sign|margin-right=40%|sign='''a very important sign'''
<nowiki>
Traveling
In the Common language, it reads:
On purchased services in HESS, if the certificate is unredeemed, the refund request must be made within 24 hours of purchase. If the certificate is redeemed, the refund request must be made within 24 hours of the service being applied.

There is a 10% bloodscrip fee for all refunds/exchanges.

Certificates purchased via ATTUNE will permanently attune both the certificate AND any item they are applied to to the account of the purchaser of the certificate.
</nowiki>}}
</blockquote>
{{big|'''Some items sold in this shop may be purchased with account attunement for a discounted price (Prime only). [[Item_attunement#Purchase_Attunement|Attunement]] is permanent and cannot be removed.}}

'''Attunement Discount Legend
<br><nowiki>*</nowiki> Account attunement available for a 25% discount.
<br>
<blockquote>
{{Container2||container=In the blue tanik strongbox you see:||contents= a faded activator receipt, a bronzed boot, an ink black armor knickknack, an ink black sword gaud, a small capyxita postcard, a bubble-shaped contract, an ivory castle miniature, a faceted crystal icicle, a miniature bronze awl, and a miniature clockwork crossbow.}}
</blockquote>
<blockquote>
{| class="wikitable col-3-right" {{prettytable}} style="width: 80%;" aria-label="In a faded blue tanik strongbox"
|-
! scope="col" style="max-width: 25%;" | Item
! scope="col" style="max-width: 15%;" | Type
! scope="col" | Info
! scope="col" style="width: 40%;" | Details
! scope="col" | Price
|-
| style="vertical-align: top; white-space: nowrap;" | a faded activator receipt ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: MIU Activator Change
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887507" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887507">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A faded activator receipt will grant the ability to change the activation verb (tap/rub/wave/raise) on an item. Requested activator must be eligible for the spell. Please note that items with the "multi-wand" script are ineligible for this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 25,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a bronzed boot ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Convert Non-UCS to UCS
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887506" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887506">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A bronzed boot grants the ability to convert unscripted, non-UCS handwear/footwear to the UCS equivalent in the same slot. The handwear/footwear must be made of plain cloth or plain leather. The boot can be redeemed with pocketed items, but the container property will be removed. Cobbled and Enhancive items are permitted, but no other original item properties will carry over to the UCS item. Flare Gloves can be converted to UCS using a kaleidoscopic rune expression.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 5,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ink black armor knickknack ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Ethereal Armor Add
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887505" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887505">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ink black armor knickknack entitles the redeemer to add the Ethereal Armor script to an existing armor piece at Tier 1/OTS with no additional unlocks.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 250,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ink black sword gaud ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Ethereal Weapon Add
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887504" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887504">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ink black sword gaud entitles the redeemer to add the Ethereal Weapon script to an existing weapon at Tier 1/OTS with no additional unlocks.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 187,500
|-
| style="vertical-align: top; white-space: nowrap;" | a small capyxita postcard ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Prop Spell Circle Change
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887503" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887503">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A small capyxita postcard will grant the ability to change the spell circle on an existing spell prep prop to another spell circle.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 5,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a bubble-shaped contract ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Minor Bubble Flare Potency
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887502" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887502">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A bubble-shaped contract will grant +1 (cap of +50) to an existing bubble-flared weapon.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 12,500*
|-
| style="vertical-align: top; white-space: nowrap;" | an ivory castle miniature ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Elven Armor Script Add
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887501" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887501">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ivory castle miniature will grant the ability to add the Elven Armor script to eligible (unscripted) armor at Tier 1 with no unlocks.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 50,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a faceted crystal icicle ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Climatewear Script Add
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887500" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887500">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A faceted crystal icicle will grant the ability to add the Climatewear script to an eligible worn container at Tier 1 with no additional unlocks.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 40,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a miniature bronze awl ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: AG Change
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887499" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887499">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A miniature bronze awl will grant the user the ability to change armor to another armor group. Some items may be ineligible due to scripts. If the existing material is not valid for the new armor group, it will be converted to a standard material (e.g. going from full plate to double leathers will change the material into standard leather. All requests will be reviewed before final approval and could result in the inability to change the AG group.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 300,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a miniature clockwork crossbow ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Mechanical Xbow Script Add
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887498" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887498">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A miniature clockwork crossbow will grant the ability to add the Mechanical Crossbow script to eligible, unscripted mechanical crossbows at Tier 1 with no additional unlocks. Hand crossbows are ineligible.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 50,000*
|-
|}
</blockquote>
<blockquote>
{{Container2||container=In the wooden treasure chest you see:||contents= a palm-sized golvern sundial, a brass-traced armillary sphere, a petrified seedpod, a tiny cedar trail marker, a palm-sized obsidian effigy, a dull blue sheet, a tiny mithril anvil, a kaleidoscopic rune expression, a miniature ink-splattered book, a lesser transmutation message, a fusion adding agreement, and a rusting helmet-shaped curio.}}
</blockquote>
<blockquote>
{| class="wikitable col-3-right" {{prettytable}} style="width: 80%;" aria-label="In a battered wooden treasure chest"
|-
! scope="col" style="max-width: 25%;" | Item
! scope="col" style="max-width: 15%;" | Type
! scope="col" | Info
! scope="col" style="width: 40%;" | Details
! scope="col" | Price
|-
| style="vertical-align: top; white-space: nowrap;" | a palm-sized golvern sundial ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Script Add - Solar Weapon
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-300522782" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-300522782">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A palm-sized golvern sundial will grant the ability to add the Solar Weapon script to an eligible unscripted Weapon.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 50,000
|-
| style="vertical-align: top; white-space: nowrap;" | a brass-traced armillary sphere ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Script Add - Nebular Weapon
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-300519972" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-300519972">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A brass-traced armillary sphere will grant the ability to add the Nebular Weapon script to an eligible unscripted Weapon.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 50,000
|-
| style="vertical-align: top; white-space: nowrap;" | a petrified seedpod ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Script Add - Phytomorphic Weapon/Shield
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-300507958" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-300507958">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A petrified seedpod will grant the ability to add the Phytomorophic script to an eligible unscripted Weapon or Shield.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 50,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a tiny cedar trail marker ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Script Add - Survivalist Kit
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887496" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887496">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A tiny cedar trail marker will grant the ability to add the Survivalist's Kit script to an eligible unscripted item. Item must be a shoulder-worn or belt-worn container.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 50,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a palm-sized obsidian effigy ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Script Add - Nightbringer
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887495" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887495">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A palm-sized obsidian effigy grants the Nightbringer script at Tier 1/OTS to an unscripted weapon. UCS gear (boots/gloves) is ineligible.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 50,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a dull blue sheet ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: DB Transfer
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887494" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887494">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A dull blue sheet will move defensive bonus (DB) from one eligible DB item to another eligible DB item. Weapons are not eligible. Zelnorn and urglaes items are not eligible. The target item cannot exceed +50 DB.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 25,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a tiny mithril anvil ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Reforge Weapon
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887493" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887493">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A tiny mithril anvil will grant the user the ability to change a weapon to another within the same category (OHE, OHB, etc.) Reforging into a claidhmore is not possible, but you can reforge out of it and lose 40 CER. Some restrictions may apply, especially in the case of scripted items. All conversion requests will be reviewed before final approval and could result in the inability to reforge the requested weapon. If the item has over 20 CER, the reforged weapon will be reduced to 20 CER. Both the old and new weapon must use exactly the same weapon skill. In addition, the new weapon will be reforged into the new base and use an appropriate noun for that base. Some scripts will prevent a weapon from being reforged, including Arcane Sidearms.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 200,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a kaleidoscopic rune expression ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Non-UCS FlareGloves to UCS
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887492" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887492">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A kaleidoscopic rune expression will grant the ability to convert non-UCS FlareGloves to UCS (hand-worn). The original gloves must be made of plain cloth or plain leather. All unlocked flares and addons, pockets, and enhancive properties will carry over. Conversion does not include an alteration, but the existing noun and/or material may be changed if found to be unsuitable for UCS hand-worn items.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 20,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a miniature ink-splattered book ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Convert Spell Circle Item to Tattoo
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887491" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887491">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A miniature ink-splattered book will grant the ability to convert a Spell Circle Enhancive item to an existing tattoo. The tattoo must not already be enhancive, and must not be scripted. The origin item will be preserved, but lose the Spell Circle Enhancive property.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 25,000
|-
| style="vertical-align: top; white-space: nowrap;" | a lesser transmutation message ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Lesser Transmutation
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887490" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887490">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A lesser transmutation message will grant the ability to have one item transmuted to another item's material. The two items must be of the same material type (metal to metal, wood to wood, etc.) and the transmuted material cannot have any innate properties (ie: no sephwir, coraesine, etc.) This will NOT affect enchant, flares, or any other properties that either item may or may not have. Please note that the item weight is reset to the base weight of the new material. This change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 15,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a fusion adding agreement ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Fusion Add
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887489" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887489">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A fusion adding agreement will grant the ability to add the fusion script with 2-slots to a non-fusion armament. UCS equipment is ineligible.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 250,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a rusting helmet-shaped curio ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Convert Helm to Helm
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887488" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887488">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A rusting helmet-shaped curio will grant the ability to convert one helm type into another helm type. (eg. A Helm into a Greathelm, for instance.)
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 5,000*
|-
|}
</blockquote>
<blockquote>
{{Container2||container=In the rowan crate you see:||contents= a folded shield resize bill, a defender boost slip, a fresh defender label, a miniature obsidian inkpot, a silvery asg change proclamation, an ink-stained napkin, a lump of pure coraesine ore, a dog-eared leather primer, a small chunk of pumice, and a twisted hawthorn branch.}}
</blockquote>
<blockquote>
{| class="wikitable col-3-right" {{prettytable}} style="width: 80%;" aria-label="In a weathered rowan crate"
|-
! scope="col" style="max-width: 25%;" | Item
! scope="col" style="max-width: 15%;" | Type
! scope="col" | Info
! scope="col" style="width: 40%;" | Details
! scope="col" | Price
|-
| style="vertical-align: top; white-space: nowrap;" | a folded shield resize bill ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Shield Resize
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887486" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887486">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A folded shield resize bill grants the ability to have your shield resized. (Previous "one step" requirement has been removed.)
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 25,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a defender boost slip ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Defender Boost
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887485" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887485">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A defender boost slip will grant the ability to increase a defender item by +1.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 25,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a fresh defender label ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Defender Add
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887484" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887484">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A fresh defender label will grant the addition of the defender ability to an eligible weapon, beginning with +2. The item must not already be a defender item or have an existing property that would otherwise render the item ineligible (ie: an existing flare). This ability is capped at +50.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 100,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a miniature obsidian inkpot ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: SK/MK Item to SK/MK Tattoo
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887483" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887483">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A miniature obsidian inkpot will grant the ability to convert an SK (self-knowledge) or MK (martial knowledge) item to an existing SK or MK Tattoo. Source item will be deleted.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 25,000
|-
| style="vertical-align: top; white-space: nowrap;" | a silvery asg change proclamation ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Armor ASG Change
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887482" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887482">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A silvery asg change proclamation grants the ability to have your armor subgroup changed to another subgroup within the group (cloth, leather, scale, chain, or plate). There may be some exclusions. Karma Armor, for example, is ineligible.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 150,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ink-stained napkin ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: X-Day Item to Tattoo
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887481" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887481">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ink-stained napkin will grant the ability to convert an x-day item into an x-day tattoo. The tattoo must already exist and be unscripted. This service does not include application of a tattoo. This will also switch the activation from Magic Item Use to Arcane Symbols. Note that while multi-wands are eligible, spells will lose the multi-cast benefit.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 5,000
|-
| style="vertical-align: top; white-space: nowrap;" | a lump of pure coraesine ore ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Pure Coraesine Ore
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887480" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887480">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A lump of pure coraesine ore will grant the user a bladed weapon of pure coraesine.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 400,000
|-
| style="vertical-align: top; white-space: nowrap;" | a dog-eared leather primer ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Skill Booster Enhancive
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887479" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887479">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A dog-eared leather primer will grant the user a 1x/day enhancive that grants +5 to any SKILL RANK for 10 minutes. Subsequent purchases can be made to stack either the bonus (up to +20 total) or the uses per day.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 100,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a small chunk of pumice ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Rune Tattoo Spell Removal
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887478" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887478">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A small chunk of pumice will grant the user removal of a single spell from a rune tattoo.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 2,500
|-
| style="vertical-align: top; white-space: nowrap;" | a twisted hawthorn branch ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Rune Tattoo Spell Move
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188887477" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188887477">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A twisted hawthorn branch will grant the user the ability to move a single spell from one rune tattoo to another rune tattoo.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 2,500
|-
|}
</blockquote>
<blockquote>
{{Container2||container=On the dark walnut display you see:||contents= an ingot of gornar, an ingot of zorchar, an ingot of rhimar, an ingot of drakar, an ingot of eonake, an ingot of adamantine, a twig of sephwir, a twig of faewood, an ingot of kroderine, an ingot of white alloy, an ingot of zelnorn, an ingot of somnis, and an ingot of obskruul.}}
</blockquote>
<blockquote>
{| class="wikitable col-3-right" {{prettytable}} style="width: 80%;" aria-label="On a metal-framed dark walnut display"
|-
! scope="col" style="max-width: 25%;" | Item
! scope="col" style="max-width: 15%;" | Type
! scope="col" | Info
! scope="col" style="width: 40%;" | Details
! scope="col" | Price
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of gornar ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Inter. Transmute to Gornar
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299949531" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299949531">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of gornar will allow a valid item to be transmuted to gornar. The item must meet all applicable restrictions of the transmuted material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 20,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of zorchar ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Inter. Transmute to Zorchar
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299949014" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299949014">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of zorchar will allow a valid item to be transmuted to zorchar. The item must meet all applicable restrictions of the transmuted material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 20,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of rhimar ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Inter. Transmute to Rhimar
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299947407" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299947407">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of rhimar will allow a valid item to be transmuted to rhimar. The item must meet all applicable restrictions of the transmuted material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 20,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of drakar ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Inter. Transmute to Drakar
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299941963" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299941963">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of drakar will allow a valid item to be transmuted to drakar. The item must meet all applicable restrictions of the transmuted material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 20,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of eonake ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Inter. Transmute to Eonake
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299936328" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299936328">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of eonake will allow a valid item to be transmuted to eonake. The item must meet all applicable restrictions of the transmuted material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 20,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of adamantine ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Transmute to Adamantine
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299930894" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299930894">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of adamantine will grant the user the ability to transmute a valid armament to adamantine. Runestaves, bows, and UCS gear (boots/gloves) are ineligible. The item must meet all applicable restrictions of that material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 75,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a twig of sephwir ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Inter. Transmute to Sephwir
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299920602" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299920602">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A twig of sephwir will allow a valid item to be transmuted to sephwir. The item must meet all applicable restrictions of the transmuted material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 100,000*
|-
| style="vertical-align: top; white-space: nowrap;" | a twig of faewood ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Inter. Transmute to Faewood
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299916306" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299916306">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A twig of faewood will allow a valid item to be transmuted to faewood. The item must meet all applicable restrictions of the transmuted material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 20,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of kroderine ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Transmute to Kroderine
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299836362" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299836362">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of kroderine will grant the user the ability to transmute a valid armament to kroderine. Runestaves, bows, and UCS gear (boots/gloves) are ineligible. Any special abilities such as ensorcel, sanctification, etc., will be replaced with dispel flares (3 for weapons and shields, and 5 for armor). The enchant is set to 22. The item must meet all applicable restrictions of that material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item's enchant will be +22, regardless of the original enchant. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 50,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of white alloy ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Transmute to White Alloy
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299826419" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299826419">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of white alloy will grant the user the ability to transmute a valid weapon to white alloy. Weapons only - runestaves, bows, and UCS gear (boots/gloves) are ineligible. The item must meet all applicable restrictions of that material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 125,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of zelnorn ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Transmute to Zelnorn
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299821389" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299821389">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of zelnorn will grant the user the ability to transmute a valid armament (no greater than 10x) to zelnorn. Armor accessories, runestaves, bows, and UCS gear (boots/gloves) are ineligible. The existing enchant bonus is split between the AS/DS bonus, and any special ability will be lost. The item must meet all applicable restrictions of that material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service. This service is retiring after August 2024.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 100,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of somnis ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Transmute to Somnis-Greater
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299814602" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299814602">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of somnis will grant the user the ability to transmute a valid weapon to somnis. The item must meet all applicable restrictions of that material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. There is a 25% surcharge for katanas and naginatas and a 50% surcharge for claidhmores. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service. Some items could be ineligible due to existing scripts or properties.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 300,000*
|-
| style="vertical-align: top; white-space: nowrap;" | an ingot of obskruul ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Transmute to Obskruul
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-299781980" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-299781980">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
An ingot of obskruul will grant the user the ability to transmute a valid metal weapon, armor, or shield to obskruul. The item must meet all applicable restrictions of that material to be valid for the service. Some items may be ineligible and might not be assessed until after redemption. All final transmutes will be at the highest tier of the end material, if applicable. There is a 25% surcharge for katanas and naginatas and a 50% surcharge for claidhmores. The item weight is reset to the base weight of the new material; the transmuted item will retain the enchant of the source item. This material change may result in updates to reflect the new material, but a full alteration is not included in this service.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 75,000*
|-
|}
</blockquote>
===Scrip Shop, Upstairs===
{{RoomDescription|
|roomname=Scrip Shop, Upstairs
|desc=The tall metal-framed windows enclosing the room have been boarded shut, the iron nails sticking out in irregular angles to create makeshift hooks. Heavy, hole-ridden sheets of green velvet loosely cover a series of pristine wooden crates, the fabric pooling across the knitted rugs covering the dusty planks. A pair of driftwood-carved sculptures flank a gilt-painted curio in the far corner, the open doors draped in a fine layer of brittle cobwebs.
|realrnum= 8212997
|rnum=
|exits=
|paths= down}}
<blockquote>
{{Container2||container=In the gilt-painted curio you see:||contents= a shield-inked paper and a dagger-inked pell.}}
</blockquote>
<blockquote>
{| class="wikitable col-3-right" {{prettytable}} style="width: 80%;" aria-label="In a gilt-painted curio"
|-
! scope="col" style="max-width: 25%;" | Item
! scope="col" style="max-width: 15%;" | Type
! scope="col" | Info
! scope="col" style="width: 40%;" | Details
! scope="col" | Price
|-
| style="vertical-align: top; white-space: nowrap;" | a shield-inked paper ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Add MK Attack to Tattoo
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188892027" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188892027">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A shield-inked paper will allow the redeemer to add a Martial Knowledge (MK) Attack to an existing tattoo. This MK will begin at Rank 1. Berserk is not eligible for selection.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 200,000
|-
| style="vertical-align: top; white-space: nowrap;" | a dagger-inked pell ||style="vertical-align: top; white-space: nowrap;"|
|style="vertical-align: top; text-align: left;"| < 1 lb<br> ||style="width: 40%; vertical-align: top; text-align: left;"| <pre style="border: none; font-family: sans-serif; padding: 0; margin: 0;"><nowiki>
Service: Add MK Setup to Tattoo
</nowiki></pre>
<nowiki>
</nowiki> <div class="mw-customtoggle-188892026" role="link" style="text-decoration: underline">Analyze</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-188892026">
'''Analyze:'''<pre style="border: none; font-family: sans-serif; padding: .5em; margin: .25em 0;"><nowiki>
A dagger-inked pell will allow the redeemer to add a Martial Knowledge (MK) Setup to an existing tattoo. This MK will begin at Rank 1.
</nowiki></pre>
</div>
|style="white-space:nowrap; vertical-align: top; text-align: right;"| 300,000
|-
|}
</blockquote>
===Scrip Shop, Meditation Room===
{{RoomDescription|
|roomname=Scrip Shop, Meditation Room
|desc=Quarantined from the chaos of the adjacent chamber, sizable throws of snow leopard fur line both the floor and walls, meticulously aligned to create a hypnotizing pattern of dark spots. Stone pedestals inlaid with ur-barath sconces bear candles that release a gentle, soothing fragrance into the air, erasing all evidence of the musty scent in neighboring areas. White fur rugs form a circle inside the pedestal boundary, each one spaced far enough from the next to allow for adequate distancing. You also see a perky bearded dabbler and a beaded curtain.
|realrnum= 8212719
|rnum=
|exits=
|paths= none}}
<blockquote>
{{sign|margin-right=40%|sign='''a perky bearded dabbler'''
<nowiki>
A perky bearded dabbler says, "I can remove certain properties on many items. ASK ME about REMOVE to see what kinds of things I'm able to do for you. My standard fee is 5000 bloodscrip, but for a script that has no mechanical value whatsoever, I will charge you only 1000 bloodscrip. The script must be one that I am familiar with, so if I am not, I'll have to get permission first. It shouldn't take too long, though."
</nowiki>
<noinclude>
Elegantly barrel-chested and graced with a flowing mane of flaxen tresses, a perky bearded dabbler is short of stature and nimble. Her eyes reflect a good-natured flirtatiousness that is expressed in her ready smile and the gentle sway of her hips. A plethora of bejeweled braids adorns her chin, though they have been parted into two groups to better show off her barely buttoned shirt, which is tucked into a pair of form-fitting leather trousers.
</noinclude>
}}
</blockquote>
</onlyinclude>== Duskruin SK/MK List for August 2026 ==
<blockquote>
'''''Spell Knowledge'''''
{| class="wikitable sortable"
|-
! scope="col"|Spell
! scope="col"|Spell Name
! scope="col"|Tier
|-
| scope="row" role="rowheader"|515
|Rapid Fire
|1
|-
| scope="row" role="rowheader"|1109
|Empathic Focus
|2
|-
| scope="row" role="rowheader"|215
|Heroism
|3
|-
| scope="row" role="rowheader"|1202
|Iron Skin
|3
|-
| scope="row" role="rowheader"|605
|Barkskin
|4
|-
| scope="row" role="rowheader"|913
|Melgorehn's Aura
|4
|-
| scope="row" role="rowheader"|1606
|Dauntless
|4
|-
| scope="row" role="rowheader"|1711
|Mystic Focus
|4
|-
| scope="row" role="rowheader"|117
|Spirit Strike
|6
|-
| scope="row" role="rowheader"|608
|Camouflage
|6
|-
| scope="row" role="rowheader"|1705
|Martial Prowess
|6
|-
| scope="row" role="rowheader"|1408
|Astral Spear
|6
|-
| scope="row" role="rowheader"|1206
|Telekinesis
|6
|-
| scope="row" role="rowheader"|1706
|Flaming Aura
|6
|-
| scope="row" role="rowheader"|1204
|Foresight
|7
|-
| scope="row" role="rowheader"|510
|Hurl Boulder
|7
|-
| scope="row" role="rowheader"|1713
|Death Cloud
|7
|-
| scope="row" role="rowheader"|413
|Elemental Saturation
|7
|-
| scope="row" role="rowheader"|116
|Locate Person
|7
|-
| scope="row" role="rowheader"|1701
|Arcane Decoy
|7
|-
| scope="row" role="rowheader"|204
|Unpresence
|8
|-
| scope="row" role="rowheader"|203
|Manna
|8
|-
| scope="row" role="rowheader"|1205
|Glamour
|8
|}</blockquote>
<blockquote>
'''''Martial Knowledge'''''
{| class="wikitable"
! colspan="2"| MK Tattoo - Allowed Maneuvers
|-
! scope="col"|Setups
! scope="col"|Attacks
|-
| scope="row"| Dirtkick || Exsanguinate
|-
| scope="row"| Sweep || Leap Attack
|-
| scope="row"| Divert || Coup de Grace
|-
| scope="row"| Dislodge ||
|-
| scope="row"| Haymaker ||
|}</blockquote>

[[Tempshop name::Duskruin Arena| ]]{{DEFAULTSORT:Duskruin Arena, Scrip Shop}}[[Category:Traveling August 2026 shops]][[Category:HESS lists]]

Leybound Compass

2026-08-21T16:33:58Z

HORIBU1: update release venue and year

<table><tr valign="top"><td>
The '''Leybound Compass''' is a scripted pin that provides various time-related mechanical effects based on its tier. Unlike items that are powered by feeding them other magic items, the compass draws on the wearer's own spells and combat flares. At tier 1, the compass can extend the duration of the wearer's beneficial spells. At tier 2, the compass can force every effect with a standard flare chance to trigger at once on the wearer's next attack. At tier 3, the compass grants a passive chance on attack to slow the target and hasten the wearer, and can guarantee this effect for a short time on demand. And at tier 4, the compass allows the wearer to recall an alternate version of a recently-visited room, along with the vitals they had when they left it. The Leybound Compass was sold in the [[BVShop:Once Upon a Time|Once Upon a Time]] shop. 
{{stub}}
{{TOC limit|2}}
{{itemtier 
|tier=Tier 1/OTS 
|itemsummary=An OTS Leybound Compass grants Stretch Time. {{boldmono|STRETCH}} extends the duration of the wearer's beneficial spells -- both spells the wearer knows and any granted by Invoker -- by 30 minutes, subject to each spell's normal maximum duration (4 hours for most spells, 60 seconds for Haste, etc.). Usable once every 2.5 hours. 
|analyze= 
You analyze the dented brass compass and sense that the creator has provided the following information:

{{blue|OVERVIEW}}

Hello there, intrepid player! This dented brass compass is a Leybound Compass item. Rather than being fed other magical items, this compass draws on your own spells and combat flares to bend time in your favor.

{{blue|UNLOCKS}}

Tier 1 - OTS. STRETCH extends the duration of your beneficial spells (both spells you know and any granted by Invoker) by 30 minutes, subject to each spell's normal duration cap. Usable once every 2.5 hours.
Tier 2 - TAP causes your next attack to trigger every effect with a standard flare chance at once (flares, ensorcells, weapon flares, etc.). Effects that calculate their chance differently than a standard flare (such as lore flares) are excluded, as is Xaz. 3 minute cooldown.
Tier 3 - Adds a passive standard-flare-chance effect on attack: an SMR attempt against the target that, on success, inflicts a 3 second Slow and grants you a brief haste effect (reducing RT/Cast RT by 1, floor of 1 second). RUB guarantees this flare for 30 seconds. Usable once every 3 minutes.
Tier 4 - BESEECH recalls an alternate version of one of the last 10 rooms you've visited -- prioritizing the room with the fewest creatures, breaking ties by distance -- provided a valid path exists. You arrive restored to the health, mana, stamina, and spirit you had when you left that room, standing and unstunned. Requires that you not be in roundtime or unconscious. Usable once per login day.

Currently this compass is {{blue|Tier 1}}

COOLDOWNS:
Stretch Time: {{blue|READY}}
Temporal Alignment: {{blue|READY}}
Hastened Movements: {{blue|READY}}
Temporal Anchor: {{blue|READY}} 





ALTERING


|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"|PIN
| {{addmetext}}
| {{addmetext}}
|-
! scope="row" role="rowheader"|UNPIN
| {{addmetext}}
| {{addmetext}}
|-
! scope="row" role="rowheader" rowspan="2"|STRETCH
|  {{addmetext}}
|  {{addmetext}}
|-
| colspan="2" style="text-align:center"|Extends the duration of your beneficial spells (known + Invoker-granted) by 30 minutes, subject to each spell's normal duration cap. Usable once every 2.5 hours.
|}
{{itemtier 
|tier=Tier 2 
|itemsummary=At Tier 2, the Leybound Compass gains Temporal Alignment. {{boldmono|TAP}} causes the wearer's next attack to trigger every effect with a standard flare chance at once -- flares, ensorcells, weapon flares, and similar effects. Effects that calculate their chance differently than a standard flare (such as lore flares) are excluded, as is Xaz. 3 minute cooldown, tracked per character rather than per item. 
|analyze= 
|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" rowspan="2"|TAP
| As you tap your Leybound Compass, its needle begins to spin through a blur of possible moments. Each flicker collapses into the next, gathering around you until the future converges upon a single point. 
|  {{addmetext}}
|-
| colspan="2" style="text-align:center"|Triggers every effect with a standard flare chance at once on your next attack. 3 minute cooldown (character-based).
|}
{{itemtier 
|tier=Tier 3 
|itemsummary=At Tier 3, the Leybound Compass gains Hastened Movements. The wearer gains a passive standard-flare-chance effect on attack: an SMR attempt against the target that, on success, inflicts a 3 second Slow and grants the wearer a brief haste effect (reducing RT/Cast RT by 1, with a floor of 1 second). {{boldmono|RUB}} guarantees this flare for 30 seconds. 3 minute cooldown. 
|analyze= 
|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" rowspan="2"|RUB
|  {{addmetext}}
|  {{addmetext}}
|-
| colspan="2" style="text-align:center"|Guarantees the Hastened Movements flare for 30 seconds. Usable once every 3 minutes.
|}
{{itemtier 
|tier=Tier 4 
|itemsummary=Fully unlocked, a Leybound Compass gains Temporal Anchor. {{boldmono|BESEECH}} recalls an alternate version of one of the last 10 rooms the wearer has visited -- provided a valid path exists, prioritizing the room with the fewest creatures and breaking ties by distance -- restoring the wearer to the health, mana, stamina, and spirit they had when they left that room. The wearer arrives standing and unstunned. Usable while incapacitated so long as the wearer is not in roundtime and not unconscious. Once per login day. 
|analyze= 
|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" rowspan="2"|BESEECH
|  {{addmetext}}
|  {{addmetext}}
|-
| colspan="2" style="text-align:center"|Recalls an alternate version of a recently-visited room and restores prior vitals. Requires the wearer not be in roundtime or unconscious. Once per login day.
|}
* 
</td><td>
{{iteminfo
|type=Mechanical 
|itemclass=Accessory 
|itemtype=Pin 
|alter= 
|ld= 
|feature= 
|customize= 
|custom= 
|origmerch= 
|releasevenue=Duskruin 
|releaseyear=2026 
|questitem= 
|tiered=Yes 
|tiersnumber=4 
|unlock= 
|legendary= 
|demeanor= 
|loresong= 
|corrscript= 
|attune= 
|attunement= 
|affinity= 
|spell= 
|enhancive= 
|swap= 
|add= 
|restrictions= 
}}
{{itemverb
|verb=BESEECH 
|verb2=PIN
|verb3=RUB
|verb4=STRETCH
|verb5=TAP
|verb6=UNPIN
}}
</td></tr></table>

Leybound Compass

2026-08-21T16:32:30Z

HORIBU1: initial creation

<table><tr valign="top"><td>
The '''Leybound Compass''' is a scripted pin that provides various time-related mechanical effects based on its tier. Unlike items that are powered by feeding them other magic items, the compass draws on the wearer's own spells and combat flares. At tier 1, the compass can extend the duration of the wearer's beneficial spells. At tier 2, the compass can force every effect with a standard flare chance to trigger at once on the wearer's next attack. At tier 3, the compass grants a passive chance on attack to slow the target and hasten the wearer, and can guarantee this effect for a short time on demand. And at tier 4, the compass allows the wearer to recall an alternate version of a recently-visited room, along with the vitals they had when they left it. The Leybound Compass was sold in the [[BVShop:Once Upon a Time|Once Upon a Time]] shop. 
{{stub}}
{{TOC limit|2}}
{{itemtier 
|tier=Tier 1/OTS 
|itemsummary=An OTS Leybound Compass grants Stretch Time. {{boldmono|STRETCH}} extends the duration of the wearer's beneficial spells -- both spells the wearer knows and any granted by Invoker -- by 30 minutes, subject to each spell's normal maximum duration (4 hours for most spells, 60 seconds for Haste, etc.). Usable once every 2.5 hours. 
|analyze= 
You analyze the dented brass compass and sense that the creator has provided the following information:

{{blue|OVERVIEW}}

Hello there, intrepid player! This dented brass compass is a Leybound Compass item. Rather than being fed other magical items, this compass draws on your own spells and combat flares to bend time in your favor.

{{blue|UNLOCKS}}

Tier 1 - OTS. STRETCH extends the duration of your beneficial spells (both spells you know and any granted by Invoker) by 30 minutes, subject to each spell's normal duration cap. Usable once every 2.5 hours.
Tier 2 - TAP causes your next attack to trigger every effect with a standard flare chance at once (flares, ensorcells, weapon flares, etc.). Effects that calculate their chance differently than a standard flare (such as lore flares) are excluded, as is Xaz. 3 minute cooldown.
Tier 3 - Adds a passive standard-flare-chance effect on attack: an SMR attempt against the target that, on success, inflicts a 3 second Slow and grants you a brief haste effect (reducing RT/Cast RT by 1, floor of 1 second). RUB guarantees this flare for 30 seconds. Usable once every 3 minutes.
Tier 4 - BESEECH recalls an alternate version of one of the last 10 rooms you've visited -- prioritizing the room with the fewest creatures, breaking ties by distance -- provided a valid path exists. You arrive restored to the health, mana, stamina, and spirit you had when you left that room, standing and unstunned. Requires that you not be in roundtime or unconscious. Usable once per login day.

Currently this compass is {{blue|Tier 1}}

COOLDOWNS:
Stretch Time: {{blue|READY}}
Temporal Alignment: {{blue|READY}}
Hastened Movements: {{blue|READY}}
Temporal Anchor: {{blue|READY}} 





ALTERING


|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"|PIN
| {{addmetext}}
| {{addmetext}}
|-
! scope="row" role="rowheader"|UNPIN
| {{addmetext}}
| {{addmetext}}
|-
! scope="row" role="rowheader" rowspan="2"|STRETCH
|  {{addmetext}}
|  {{addmetext}}
|-
| colspan="2" style="text-align:center"|Extends the duration of your beneficial spells (known + Invoker-granted) by 30 minutes, subject to each spell's normal duration cap. Usable once every 2.5 hours.
|}
{{itemtier 
|tier=Tier 2 
|itemsummary=At Tier 2, the Leybound Compass gains Temporal Alignment. {{boldmono|TAP}} causes the wearer's next attack to trigger every effect with a standard flare chance at once -- flares, ensorcells, weapon flares, and similar effects. Effects that calculate their chance differently than a standard flare (such as lore flares) are excluded, as is Xaz. 3 minute cooldown, tracked per character rather than per item. 
|analyze= 
|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" rowspan="2"|TAP
| As you tap your Leybound Compass, its needle begins to spin through a blur of possible moments. Each flicker collapses into the next, gathering around you until the future converges upon a single point. 
|  {{addmetext}}
|-
| colspan="2" style="text-align:center"|Triggers every effect with a standard flare chance at once on your next attack. 3 minute cooldown (character-based).
|}
{{itemtier 
|tier=Tier 3 
|itemsummary=At Tier 3, the Leybound Compass gains Hastened Movements. The wearer gains a passive standard-flare-chance effect on attack: an SMR attempt against the target that, on success, inflicts a 3 second Slow and grants the wearer a brief haste effect (reducing RT/Cast RT by 1, with a floor of 1 second). {{boldmono|RUB}} guarantees this flare for 30 seconds. 3 minute cooldown. 
|analyze= 
|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" rowspan="2"|RUB
|  {{addmetext}}
|  {{addmetext}}
|-
| colspan="2" style="text-align:center"|Guarantees the Hastened Movements flare for 30 seconds. Usable once every 3 minutes.
|}
{{itemtier 
|tier=Tier 4 
|itemsummary=Fully unlocked, a Leybound Compass gains Temporal Anchor. {{boldmono|BESEECH}} recalls an alternate version of one of the last 10 rooms the wearer has visited -- provided a valid path exists, prioritizing the room with the fewest creatures and breaking ties by distance -- restoring the wearer to the health, mana, stamina, and spirit they had when they left that room. The wearer arrives standing and unstunned. Usable while incapacitated so long as the wearer is not in roundtime and not unconscious. Once per login day. 
|analyze= 
|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" rowspan="2"|BESEECH
|  {{addmetext}}
|  {{addmetext}}
|-
| colspan="2" style="text-align:center"|Recalls an alternate version of a recently-visited room and restores prior vitals. Requires the wearer not be in roundtime or unconscious. Once per login day.
|}
* 
</td><td>
{{iteminfo
|type=Mechanical 
|itemclass=Accessory 
|itemtype=Pin 
|alter= 
|ld= 
|feature= 
|customize= 
|custom= 
|origmerch= 
|releasevenue=Once Upon a Time 
|releaseyear= 
|questitem= 
|tiered=Yes 
|tiersnumber=4 
|unlock= 
|legendary= 
|demeanor= 
|loresong= 
|corrscript= 
|attune= 
|attunement= 
|affinity= 
|spell= 
|enhancive= 
|swap= 
|add= 
|restrictions= 
}}
{{itemverb
|verb=BESEECH 
|verb2=PIN
|verb3=RUB
|verb4=STRETCH
|verb5=TAP
|verb6=UNPIN
}}
</td></tr></table>

BVShop:Once Upon a Time

2026-08-21T16:31:14Z

HORIBU1: initial creation

{{TOCright}}
==Current Shop Listing==
{{:BVShop:Once Upon a Time/August 2026}}
==Previous Shop Listings==
{{Special:PrefixIndex/{{FULLPAGENAME}}/|stripprefix=yes|hideredirects=yes}}
{{DEFAULTSORT:Once Upon a Time}}
[[Category:Bloodriven Village shops]]

Lich:Software/Installation

2026-08-14T19:16:37Z

HORIBU1: /* Lich Changelog */ add 5.20.0 changelog

{{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.20.0 supporting Ruby 4.0 - published August 11, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.20.0'''
<PRE>
### Features (general)

* add concurrent runtime I/O and multi-client detach support (#1459)
* --bind-address speaks the same keywords as --detachable-client (#1461)
* GUI Launcher Improvements (#1463)
* Add supervised child script APIs (01 of 06) (#1474)
* Add forced script teardown command (06 of 06) (#1479)
* teardown and distinguishable errors for Script.run_child (#1501)

### Features (dr)

* DRCMM.moon_weapon_duration - read a moon weapon's remaining life (#1483)
* id-based creature tracking from crtrStatus + assess (#1485)
* capture room UID from <nav> tag; stop enforcing ShowRoomID; opt-in room-id placement (#1491)
* user-extensible scroll substitutions via settings (01 of 06) (#1512)
* user-extensible boxes and trash receptacles (03 of 06) (#1514)
* user-extensible summoned-weapon adjectives (04 of 06) (#1515)
* user-extensible flavor-text stripping (05 of 06) (#1516)

### Features (gs)

* gameobj add full_name matcher to type/sellable classification (#1453)

### Bug Fixes (general)

* prevent empty/partial GameObj registry reads during mid-stream refresh (#1370)
* no-op Gtk.lich_main_quit when no main loop is nested (#1464)
* correct path-flag aliases and document all path options (#1472)
* Synchronize script lifecycle transitions (02 of 06) (#1475)
* Coordinate script shutdown draining (03 of 06) (#1476)
* Harden script lifecycle ownership (05 of 06) (#1478)
* surface the underlying LoadError in dependency alerts (#1480)
* extract game-agnostic CreatureBase into lib/common (#1484)
* bound GemCheck alert dialogs with a timeout so they can't hang forever (#1488)
* identify Genie as the frontend for headless launches (#1490)
* restore detachable client disconnect notice to stdout (#1492)
* harden detachable client teardown and escape init payload (#1493)
* resolve GameObj status visibility during staged refresh (#1497)
* compact client write queue instead of ending the session (#1498)
* scrub startup credentials once login completes (#1499)
* Honor Simu-side teardown for 10 seconds (#1505)

### Bug Fixes (dr)

* resolve no-UID rooms carrying a stored UID instead of returning nil (#1467)
* equipmanager.rb - reliable ranged-weapon transitions - stow ammo after unload + verify offhand wield hand (#1468)
* common-healing.rb - DRCH.bind_wound: only dispose a dislodged item while it is in hand (#1469)
* preserve game RealID in room title (GS parity for ";display roomid title") (#1500)
* Refine need_buffs? logic for non-recast spells to correctly check cyclic spells. (#1503)
* reduce symbol-torn scale scrolls to gettable noun (#1506)
</PRE>
'''5.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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-08-14T19:15:43Z

HORIBU1: /* Installing the Latest Stable Release */ update for 5.20.0 release

{{3rd-party}}
=About=

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

=Installing the Latest Stable Release=

'''The latest stable lich version is 5.20.0 supporting Ruby 4.0 - published August 11, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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]]

Saga

2026-08-14T01:09:15Z

HORIBU1: initial creation

'''Saga''' is an officially supported front end (FE) for [[GemStone IV]] and [[DragonRealms]], currently in '''beta''', offered by Simutronics as an alternative to [[Wrayth]]. It is a modern, cross-platform client built with Electron, React, and TypeScript that speaks the GemStone IV/DragonRealms protocol natively and renders the game stream into dockable panels, replacing the old Wrayth/Stormfront client. It supports [[Lich:Software|Lich]] scripting.

Download / info page: https://www.play.net/gs4/play/saga-info.asp

Because Saga is in active beta, features and settings menus described here may change between releases.

==Getting Started==

# Go to https://www.play.net/gs4/play/saga-info.asp and click the download button for your platform.
#* '''Windows''' (10/11, x64 and ARM64) — installs automatically and checks for/installs updates going forward.
#* '''macOS''' — separate builds for Apple Silicon and Intel. Experimental; does not yet auto-update.
#* '''Linux''' — distributed as an AppImage (x86_64). Experimental; does not yet auto-update.
# Run the installer (Windows) or launch the downloaded build (Mac/Linux).
#* On Windows, the first launch may trigger a SmartScreen warning because the builds aren't code-signed yet during the beta. Choose "More info → Run anyway" to continue — this is expected and not a sign of a problem.
# Log in from inside Saga. Saga completely replaces the Simutronics Game Launcher/SGE with its own login screen — there is no separate launcher install and no <code>.sal</code> handshake file to deal with.
# New players can use the guided character creation flow built into the login screen; returning players get a Quick Logins grid with one click per character.

== Features ==

A few things Saga does that Wrayth doesn't:

* '''Cloud-synced settings''' — per-character settings (layout, highlights, preferences) sync automatically, so logging in from a different computer picks up where you left off.
* '''Inventory Manager''' — a live, structured view of everything worn, held, and on the ground as container cards you can open and nest (in/on/behind/under). Dragging an item between containers has Saga plan and issue the actual game commands for you. Weight/capacity show in sortable columns, and an inspector pane collects an item's LOOK/ANALYZE/RECALL output in one place.
* '''Custom panels''' — a widget palette (vitals bars, timer rings, compass rose, loadout rows, gauges) you assemble into your own panels. Floating script windows or server dialogs can be promoted into a docked panel that persists across logins.
* '''Scripting and highlights''' — full support for the classic script language with an editor and recording, switchable macro sets, layered highlights with capture-group precision and per-rule sounds, regex triggers with cooldowns, and a settings importer for existing Wrayth configs.
* '''Interactive maps''' — in-client area maps that dock into your layout or float standalone, with click-to-travel.
* '''Accessibility''' — a dedicated screen-reader mode.
* '''Environmental ambience''' — full-screen weather/ambient effects (snow, rain, sandstorm, embers, aurora) paired with panel skins that restyle the interface to match.

== Login with Lich ==

Saga can be used with [[Lich:Software|Lich]] in one of two ways:

* '''Saga Direct''' — After logging into Saga normally, go to '''File → Enable Login with Lich'''. Then disconnect and return to the login screen; a new "Via Lich" option will appear under the connect options. (Requires Lich v5.19+.)
* '''Lich Launcher GUI''' — (Requires Lich v5.20+.) The Lich Launcher autodetects Saga on both macOS and Windows as an available client when creating a saved entry, so you can select it directly without the manual toggle above.

If Lich still isn't connecting after trying the above, a refresh install of Lich is recommended — make sure you're on the latest version first. For further help, see the #help channel on the [https://discord.gg/KF9Wr8u Official Gemstone Discord].

== Settings ==

Saga stores settings (highlights, macros, scripts, panel layouts, etc.) per character and syncs them to the cloud automatically. If you're moving from Wrayth, you can bring your existing settings over:

# In Wrayth, go to '''Options → Settings → Export''' and export your settings to a file.
# In Saga, go to '''Settings → Import Settings''' and select the exported file.

=== Appearance ===

* '''Fonts''': Settings → Appearances & Themes → Fonts.
* '''Link/bold text/room name size''': Settings → Presets. The rightmost box controls font size (shown as "-" at default size).
* '''Per-panel look (background, trim, font)''': Right-click the panel you want to change.
* '''Roundtime display (RT / Cast RT wheel) and status icon size''': Settings → Appearances & Themes → Status Bar.
* '''Loadout panel text''': Settings → Appearances & Themes, bottom left (not under the panel's own alternative-text settings, despite being panel-specific).

=== Panels ===

* To stop thoughts, logins, deaths, etc. from displaying in your main story window, open a dedicated panel for that stream via '''View → Panels'''.
* To see your statuses in a separate panel: not yet available; on the development backlog.
* To make vitals display vertically instead of horizontally: not yet available as a built-in option. In the meantime, create a '''custom panel''' ('''View → Custom Panel'''), which allows flexible layout of individual elements (see [[#Features|Custom panels]] above).
* To pop a text panel (thoughts, speech, familiar, etc.) into its own tab, click and drag it onto another text panel.
* To remove a tab, click and drag it out of the header and release.

== Rest Mode ==

As in Wrayth, pressing CTRL-R puts you into rest mode, which periodically sends the EXP command to prevent an idle timeout.

== Logging ==

Logging is configured per-window from the Windows pane, similar to Wrayth.

== Backup ==

'''Backup Saga Settings and Scripts Regularly'''

Even though settings sync to the cloud, it's worth keeping your own backup of your macros, scripts, highlights, panel layout, and more:

# In Saga, go to '''Settings → Export'''.
# Save the exported file somewhere safe — cloud storage (Dropbox, Google Drive) or emailed to yourself both work well. Consider including the date and character name in the filename rather than overwriting a single backup file each time.
# Repeat this for each character, since each has its own settings.

== FAQ ==

=== Official FAQ ===

From the [https://www.play.net/gs4/play/saga-info.asp Saga info page]:

; Is Saga an official Simutronics product?
: Yes. Saga is an officially supported client for GemStone IV and DragonRealms, currently in beta, offered as an alternative to Wrayth.

; Is it safe to use?
: Saga connects to the game the same way Wrayth or SGE does, using your normal account login. The builds aren't currently code-signed, so Windows SmartScreen may warn you on first launch — this is expected during the beta and not a sign of a problem.

; Does this work with/require the SGE (Simutronics Game Entry) application?
: No. Saga completely replaces the SGE with its own modern login solution.

; What does "beta" mean here?
: Saga is under active development. Features may change between releases, and you may run into rough edges. It updates itself automatically, so you'll always be running the latest version without needing to reinstall.

; I found a bug, or Saga isn't working — who do I contact?
: You can report a bug or request a feature from inside Saga via '''File → Report Bug / Feature Request...'''.

; Why am I downloading a file from GitHub for this?
: While in beta, builds are hosted on the author's GitHub repository — GameMaster Auchand from GemStone IV.

=== Community FAQ ===

The following is drawn from an unofficial FAQ compiled by GM Casil and may not stay accurate as Saga continues development.

; How do I change links/bold text/room name size?
: Settings → Presets. The rightmost box is the font size (shows as "-" when at default size).

; How do I make Lich work?
: A refresh install of Lich is recommended, but at minimum make sure Lich is updated. Log in with Saga, then go to '''File → Enable login with Lich'''. Go to '''File → Return to login'''. Click "Connect", then "Via Lich", and point it to your Lich folder. Log in. If it's still not working, ask for help in the #help channel on the [https://discord.gg/KF9Wr8u Official Gemstone Discord].

; How do I get the roundtime wheel off my screen?
: Settings → Appearances & Themes → Status Bar. From here you can change how roundtime (RT and Cast RT) displays, and the size of the status icons in the corner.

; How do I change font?
: Settings → Appearances & Themes → Fonts.

; How do I change how a specific panel looks?
: Right-click the panel. You can update the background, trim, and font per panel this way.

; How do I make thoughts/logins/deaths stop displaying in my story window?
: View → Panels. From here you can open dedicated panels for different streams.

; How do I make something a tab or pop a tab out?
: To remove a tab, click and drag on the tab until it's out of the header, then release. To make a tab, click and drag a text-only panel (thoughts, speech, familiar, etc.) onto another text panel.

; How do I import highlights, scripts, etc. from Wrayth?
: Export your settings in Wrayth ('''Options → Settings → Export'''). In Saga, use '''Settings → Import Settings'''.

; How do I change the Lich command color?
: Not currently possible.

; How do I change the loadout panel text?
: It isn't in the panel's alternative-text settings — it's under '''Settings → Appearance & Themes''', bottom left. It's an unusual location since the loadout panel was one of the first panels built; moving it has been added to the backlog.

; How do you make vitals vertical instead of horizontal?
: Not built in yet. Create a custom panel under '''View → Custom Panel''' — custom panels are powerful and can be arranged this way, though some snapping/nudging behavior for them is a known rough edge that's been raised with the devs.

; What about putting my statuses in a separate panel?
: On the development backlog.

== Unofficial Plugins ==

See [[Lich:Software]].

== Other FEs ==
*[[Wrayth]] - previous official Windows front end
*[[Wizard (front end)]] - official Windows front end
*[[Avalon]] - official Mac OS X front end
*[[Lich:Software]] - unofficial scripting addon, works with any of Saga/Wrayth/Wizard/Avalon.

[[Category:Front Ends]]
[[Category:New Player]]

Portmaster

2026-07-31T16:01:51Z

HORIBU1: update IMT to mirror the other location sand use RealID instead of LichID

== Portmasters of Elanthia ==
Portmasters of Elanthia are NPCs stationed in every seaport within the [[Open Sea Adventures]] system. They offer a fast ferry service between ports, allowing players to travel quickly across Elanthia's expanded maritime network. To use the service, simply {{boldmono|ASK PORTMASTER ABOUT TRAVEL}}. Passage costs 25,000 - 35,000 silvers depending on the trip, and ferries depart almost immediately after the request. Trips take ten minutes. Trips during holidays and festivals may be discounted.

== Locations ==
* [[Icemule Trace]] - The Frostmain, Black Jetty (u7133026)
* [[Kraken's Fall]] - Kraken's Fall, First Pier (u7118259)
* [[River's Rest]] - River's Rest, Dilapidated Pier (u2101030)
* [[Solhaven]] - Marshtown, Fewr's Pier (u4744014)
* [[Ta'Vaalor]] - Mistwatch (Lich ID# 31493) (u7136032)
* [[Teras Isle]] - Copper Avenue, West Docks (u3002033)
* [[Wehnimer's Landing]] - Wehnimer's, North Dock (u7111)
* [[Glaoveln]] - Glaoveln, Pulct Docks (u4426101)
* [[Nielira Harbor]] - Nielira Harbor, Boardwalk (u14150050)
* [[Brisker's Cove]] - Comyner's Docks, Pier 5 (u7140125)
* [[Sleeping Drake Harbor]] - Sleeping Drake Harbor, Docks (u7142028)
* [[Flotilla]] - Twisted Tentacle Overlook (u7134031)

[[Category:Open_Sea_Adventures]]

Icy cloak

2026-07-28T14:50:44Z

HORIBU1: added clarification about origin of the item being a reward from SimuCon 2023

<table><tr valign="top"><td>
'''Ice cloaks''' are highly scripted cloaks that were introduced as the attendee goodie bag scripted item from [[:Category:SimuCon|SimuCon 2023]]. They were made available to be purchased off the shelf at [[:Category:Currents of Myth|Currents of Myth]], the 2026 [[:Category:Premium Festival|Premium Festival]]. They have a normal side and an empowered side that are both fully alterable ([[long description]] and [[show description]]) and have ambient messaging while empowered. The empowered side reflects the icy nature of the cloak.
{{TOC limit|2}}
==Analyze==
<pre{{log2}}>You analyze the cerulean nyra cloak and sense that the creator has provided the following information:

This cerulean nyra cloak will react to ice and water spells being cast at it and transform into an ice-covered cloak!
While in this state it has ambient messaging.
Verbs: BOW, PULL, PUSH, SHAKE, WAVE, ATTEND, CLEAN, PINCH, NUDGE, PROD, WAGGLE, and INVOKE.

It is fully alterable, but the fabric form must remain actual fabric. The icy form is also alterable, and the ice-clad description (long + show) can make reference to the cloak being EMPOWERED.

When altering cloaks, please keep in mind that the messaging references a long garment.
The ice crystal color may also be customized. There's more room than the traditional 15, so color descriptions needn't be one word
only, but let's keep it reasonable. "Azure and silver" = Okay. "Gold-hearted scarlet" = Okay.
Brightly luminescent absinthe green-tinged aquamarine and cerulean = Too much.

CURRENT SETTINGS:
Normal cloak: a shimmering cerulean nyra cloak layered with crystal droplets
Show of normal cloak: Dyed a rich shade of cerulean, the cloak is woven from shimmering glassthread nyra. Layers of tiny droplets are sewn into the material, creating a fall of crystals down the garment's length. A cluster of veilspire pearls set in an oval frame of silver clasps the cloak over one shoulder.

Iced Over cloak: a flowing ice-covered cloak layered with frosted droplets
Show of Iced Over cloak: Dyed a rich shade of cerulean, the cloak is woven from shimmering glassthread nyra. Layers of frosted droplets cover the material, creating a fall of ice down the garment's length. A cluster of veilspire pearls set in an oval frame of silver clasps the cloak over one shoulder.

Ice color: cerulean-flecked silver

You can tell that the cloak is as light as it can get and that its pockets could not possibly get any deeper.</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="2"|ATTEND
! scope="row" role="rowheader"|Normal
|You briskly ruffle your hands through the excess fabric of your cerulean nyra cloak, causing any wrinkles to fall away and leaving the lengths to drape in smooth folds.
|(Character) briskly ruffles (her/his) hands through the excess fabric of (her/his) cerulean nyra cloak, causing ripples in the fabric that race from hip to hem.
|-
! scope="row" role="rowheader"|Empowered
|You briskly ruffle your hands through the excess fabric of your ice-covered cloak, and tendrils of cerulean-flecked silver icy mist chased by snowflakes follow the motion of your hands before retreating again to the fabric of your ice-covered cloak.
|(Character) briskly ruffles (her/his) hands through the excess fabric of (her/his) ice-covered cloak, and threads of cerulean-flecked silver icy mist chased by snowflakes follow (her/his) hands before retreating again to the fabric of (her/his) ice-covered cloak.
|-
! scope="row" role="rowheader" rowspan="2"|BOW
! scope="row" role="rowheader"|Normal
|You gently take hold of a fold of your cerulean nyra cloak with your left hand and pull it behind you, your right hand in front of you as you take a short bow.
|(Character) gently takes hold of a fold of (her/his) cerulean nyra cloak with (her/his) left hand and pulls it behind (her/him), (her/his) right hand in front of (her/his) body as (she/he) takes a short bow.
|-
! scope="row" role="rowheader"|Empowered
|You bow deeply, sweeping your ice-covered cloak behind you. As your fingers brush across the fabric of your ice-covered cloak, a series of chasms open in the icy surface, each releasing plumes of cerulean-flecked silver vapor. The mist shatters, sending shards of colorful ice flying. Before the small chunks make contact with anything, they dissipate into a fine, cooling mist.
|(Character) bows deeply, sweeping (her/his) ice-covered cloak behind (her/him). As (her/his) fingers brush across the fabric of (her/his) ice-covered cloak, a series of chasms open in the icy surface, each releasing plumes of cerulean-flecked silver vapor. The mist shatters, sending shards of colorful ice flying. Before the small chunks make contact with anything, they dissipate into a fine, cooling mist.
|-
! scope="row" role="rowheader"|CAST
! scope="row" role="rowheader"|Ice activating
|You channel at a shimmering cerulean nyra cloak layered with crystal droplets.<br/>As the ice breaks upon the cerulean nyra cloak, the cold is absorbed into the fabric, each thread subtly backlit by a faint glacial light. In a rush that causes the air to distort, cerulean-flecked silver crystals race to cover the garment in a cloak of living ice as a flowing ice-covered cloak layered with frosted droplets is revealed.
|(Character) channels at a shimmering cerulean nyra cloak layered with crystal droplets.<br/>As the ice breaks upon the cerulean nyra cloak, the cold is absorbed into the fabric, each thread subtly backlit by a faint glacial glow. In a rush that causes the air to distort, cerulean-flecked silver crystals race to cover the garment in a cloak of living ice as a flowing ice-covered cloak layered with frosted droplets is revealed.
|-
! scope="row" role="rowheader" rowspan="2"|CLEAN
! scope="row" role="rowheader"|Normal
|You make a cursory account of yourself, brushing your hands across the front of your cerulean nyra cloak and assuring yourself that everything is perfectly in place.
|(Character) brushes (her/his) hands across the front of (her/his) cerulean nyra cloak, as if assuring (herself/himself) everything is perfectly in place.
|-
! scope="row" role="rowheader"|Empowered
|With a disaffected nonchalance, you brush at the shoulder of your ice-covered cloak, throwing shimmering cerulean-flecked silver ice crystals from your fingertips as you arch a single brow.
|(Character) brushes at the shoulder of (her/his) ice-covered cloak with a disaffected nonchalance, and a flurry of shimmering cerulean-flecked silver ice crystals are thrown from (her/his) fingertips as (she/he) arches a single brow.
|-
! scope="row" role="rowheader" rowspan="2"|INVOKE
! scope="row" role="rowheader"|Normal
|The cerulean nyra cloak must be iced over to do that!
|
|-
! scope="row" role="rowheader"|Empowered
|You concentrate on the magical ice of your ice-covered cloak...<br/>Illuminated with brilliant cerulean-flecked silver energy, the ice of your ice-covered cloak blossoms into a shrieking snowstorm that engulfs you! The frigid ice of the cocoon does nothing to impede your vision. With a cracking roar, the ice swirls around you, throwing off a cascade of shimmering cerulean-flecked silver ice crystals. Faster and faster the blizzard rages and with a sudden hiss, it vanishes, leaving you unharmed but certainly the center of attention.
|Illuminated with brilliant cerulean-flecked silver energy, the ice of (Character)'s ice-covered cloak blossoms into a shrieking snowstorm that engulfs (her/him)! With a roar, the frigid cocoon begins to swirl around (her/him), throwing off a cascade of shimmering cerulean-flecked silver ice crystals. Faster and faster the blizzard rages around (Character)!<br/>With a guttering hiss, the snowstorm vanishes, leaving (Character) unharmed in its center. Tiny snowflakes swirl around (her/him) for a moment before winking out. A faint cerulean-flecked silver light illuminates (her/his) eyes.
|-
! scope="row" role="rowheader" rowspan="2"|NUDGE
! scope="row" role="rowheader"|Normal
|With your hand inside the cerulean nyra cloak, you give it a small nudge, causing the fabric to puff out briefly before falling back into place.
|(Character) flicks (her/his) hand inside the fabric of (her/his) cerulean nyra cloak, causing it to puff out briefly before falling back into place.
|-
! scope="row" role="rowheader"|Empowered
|With your hand inside the ice-covered cloak, you give it a small nudge. In response, a spray of glittering cerulean-flecked silver snowflakes are thrown from your shoulders, and as they fall, they dim into a hazy mist winking out at your heels.
|A spray of glittering cerulean-flecked silver snowflakes erupts from the shoulders of (Character)'s ice-covered cloak! As the shimmering ice crystals fall, they dim into a hazy mist before winking out around (her/his) heels.
|-
! scope="row" role="rowheader" rowspan="2"|PINCH
! scope="row" role="rowheader"|Normal
|You idly pick at an invisible flaw in the fabric of your cerulean nyra cloak.
|
|-
! scope="row" role="rowheader"|Empowered
|You idly pick at an invisible flaw in the fabric of your ice-covered cloak and give a start when the ice engulfing the fabric spreads to your fingertips. With a smoldering glare, you focus your gaze on the cerulean-flecked silver ice on your fingertip, and it shrinks and shudders before spreading back to the frigid covering on your cloak that birthed it.
|(Character) idly picks at an invisible flaw in the fabric of (her/his) ice-covered cloak. A cluster of cerulean-flecked silver ice leaps from the frigid garment to engulf (her/his) fingertips. With a smoldering glare, (she/he) focuses (her/his) gaze on the ice on (her/his) fingertip, and it shrinks and shudders before vacating (her/his) fingertip and spreading back to the frigid covering on (her/his) cloak that birthed it.
|-
! scope="row" role="rowheader" rowspan="2"|PROD
! scope="row" role="rowheader"|Normal
|Your cerulean nyra cloak is not currently iced over; there is nothing to extinguish.
|
|-
! scope="row" role="rowheader"|Empowered
|With a discordant cracking sound, the cerulean-flecked silver ice covering the surface of your cerulean nyra cloak recedes into the fabric, leaving naught behind but a faint chill in the air.
|With a discordant cracking sound, the cerulean-flecked silver ice covering the surface of (Character)'s cerulean nyra cloak recedes into the fabric of the garment, leaving naught behind but a faint chill in the air.
|-
! scope="row" role="rowheader" rowspan="2"|PULL
! scope="row" role="rowheader"|Normal
|Hooking two fingers discreetly in the excess fabric of your cerulean nyra cloak, you give it the subtlest tug, causing the garment to sway and swoosh, then settle in perfect folds about your legs.
|A gentle touch from (Character) causes the fabric of (her/his) cerulean nyra cloak to sway and swoosh before settling in perfect folds about (her/his) legs.
|-
! scope="row" role="rowheader"|Empowered
|You gather a handful of fabric within your hand, clenching the cloak tightly. Thin tendrils of frost soon creep upwards along your palm and you let go, the cerulean-flecked silver mist glazing over the fabric once again.
|(Character) gathers a handful of fabric within (her/his) hand, clenching (her/his) cloak tightly. Thin tendrils of frost soon creep upwards along (her/his) palm as (her/his) fingers begin to turn blue. (Character) releases the fabric, the cerulean-flecked silver mist-like frost glazing over the fabric once again.
|-
! scope="row" role="rowheader" rowspan="2"|PUSH
! scope="row" role="rowheader"|Normal
|You stiffly smooth your hands over the fabric of your cerulean nyra cloak before clasping them behind your back.
|(Character) smooths (her/his) hands over the fabric of (her/his) cerulean nyra cloak before clasping them behind (her/his) back.
|-
! scope="row" role="rowheader"|Empowered
|You stiffly smooth your hands over the fabric of your ice-covered cloak, the cerulean-flecked silver ice crystals darkening under your touch, before clasping them behind your back. The ice crystals follow the motion of your hands as a frosty deluge of cerulean-flecked silver crystals ripples across the front of your cloak.
|(Character) smooths (her/his) hands over the fabric of (her/his) ice-covered cloak, the cerulean-flecked silver ice crystals darkening under (her/his) touch, before clasping them behind (her/his) back. The ice crystals follow the motion of (her/his) hands as a frosty deluge of cerulean-flecked silver crystals ripples across the front of (her/his) cloak.
|-
! scope="row" role="rowheader" rowspan="2"|SHAKE
! scope="row" role="rowheader"|Normal
|You give your cerulean nyra cloak a lazy shake, clearing any dust or debris from its surface.
|(Character) gives (her/his) cerulean nyra cloak a lazy shake, clearing any dust or debris from its surface.
|-
! scope="row" role="rowheader"|Empowered
|An avalanche of cerulean-flecked silver crystals forms at the shoulders of your ice-covered cloak, quickly gaining momentum as it falls down the length of your ice-covered cloak. As the cerulean-flecked silver cascade reaches the lower edge of the garment it tumbles and disperses into a fine layer of cool mist, pooling at your feet.
|An avalanche of cerulean-flecked silver crystals forms at the shoulders of (Character)'s ice-covered cloak, quickly gaining momentum as it falls down the length of the garment. As the cerulean-flecked silver cascade reaches the lower edge of the cloak it tumbles and disperses into a fine layer of cool mist, pooling at (her/his) feet.
|-
! scope="row" role="rowheader" rowspan="2"|WAGGLE
! scope="row" role="rowheader"|Normal
|You subtly pull your hands inside your cerulean nyra cloak as you feed the fabric a tiny flow of mana. In a rush that causes the air to distort, cerulean-flecked silver ice crystals erupt and race to cover the garment in a cloak of crystalline ice scales as a flowing ice-covered cloak layered with frosted droplets is revealed.
|The cerulean nyra cloak wrapped around (Character) suddenly shimmers. In a rush that causes the air to distort, cerulean-flecked silver ice crystals erupt and race to cover the garment in a cloak of crystalline ice scales as a flowing ice-covered cloak layered with frosted droplets is revealed.
|-
! scope="row" role="rowheader"|Empowered
|Your ice-covered cloak is already iced over!
|
|-
! scope="row" role="rowheader" rowspan="2"|WAVE
! scope="row" role="rowheader"|Normal
|Taking each side of your cerulean nyra cloak in hand, you swish the garment back and forth, creating a soft rustling whisper of fabric.
|Taking each side of (her/his) cerulean nyra cloak in hand, (Character) swishes the garment back and forth, creating a soft rustling whisper of fabric.
|-
! scope="row" role="rowheader"|Empowered
|Taking each side of your ice-covered cloak in hand, you swish the cerulean-flecked silver ice-covered fabric of your cloak back and forth, casting a flurry of sparkling snowflakes into the air accompanied by an insistent cracking sound like a piece of fracturing ice.
|Taking each side of (her/his) ice-covered cloak in hand, (Character) swishes the cerulean-flecked silver ice-covered fabric of (her/his) cloak back and forth, casting a flurry of sparkling snowflakes into the air accompanied by an insistent cracking sound like a piece of fracturing ice.
|}
==Additional Information==
The cloak enters its empowered state when an ice or water spell is cast or channeled at it; the messaging above was captured using [[Major Cold (907)]]. The wearer may also empower the cloak without a spell by using {{boldmono|WAGGLE}}, and may return it to its normal state at any time with {{boldmono|PROD}}.

{{boldmono|INVOKE}} is only documented in the empowered state. {{boldmono|PROD}} used in the normal state returns an informational message rather than scripted messaging.

According to the item's owner, the ice does not wear off on its own and must be manually returned to normal with {{boldmono|PROD}}; this has not been independently confirmed with a long-duration test. {{boldmono|WAGGLE}} while already empowered returns a refusal message rather than re-triggering the effect. {{boldmono|INVOKE}} while not empowered similarly returns a refusal message rather than doing nothing silently.

The item was obtained as a raffle prize during Currents of Myth 2026 rather than purchased directly from a merchant; the specific raffle is not otherwise documented here. Per the owner, it has no tiers and is fully unlocked as obtained. As of this writing it is also the only ice-themed cloak of its kind.
===Empowered Ambients===
{| {{verbtable}}
|- {{verbtableheader|90}}
! scope="col"|First
! scope="col"|Third
|-
| scope="row" | A blizzard of pale cerulean-flecked silver snowflakes rolls across the fabric of your ice-covered cloak, crashing against the hem in a vibrant, chilly display.
| A blizzard of pale cerulean-flecked silver snowflakes rolls across the fabric of (Character)'s ice-covered cloak, crashing against the hem in a vibrant, chilly display.
|-
| scope="row" | A layer of cerulean-flecked silver rime creeps slowly across your ice-covered cloak, the misty hoarfrost glazing over the fabric.
| A layer of cerulean-flecked silver rime creeps slowly across (Character)'s ice-covered cloak, the misty hoarfrost glazing over the fabric.
|-
| scope="row" | Chasms of razor-edged cerulean-flecked silver frost form along the fabric of your ice-covered cloak, the ice cracking into splayed crystalline patterns across the shoulders and chest before fusing together into a perfectly smooth finish once again.
| Chasms of razor-edged cerulean-flecked silver frost form along the fabric of (Character)'s ice-covered cloak, the ice cracking into splayed crystalline patterns across (her/his) shoulders and chest before fusing together into a perfectly smooth finish once again.
|-
| scope="row" | A sudden chill sweeps through the area as the cerulean-flecked silver mist that encases your ice-covered cloak evaporates away and reforms into a complex crystalline pattern on the surface of the cloak.
| A sudden chill sweeps through the area, emanating from (Character) as the cerulean-flecked silver mist that encases (her/his) ice-covered cloak evaporates and reforms into a complex crystalline pattern on the surface of the cloak.
|-
| scope="row" | Formations of slender icicles suddenly jut from the shoulders of your ice-covered cloak, framing your body in oversized, frigid pauldrons of cerulean-flecked silver ice before melting back into the fabric of your cloak once again.
| Formations of slender icicles suddenly jut from the shoulders of (Character)'s ice-covered cloak, framing (her/his) body in oversized, frigid pauldrons of cerulean-flecked silver ice before melting back into the fabric of (her/his) cloak once again.
|-
| scope="row" | A film of cerulean-flecked silver icy mist hardens along the edge of your ice-covered cloak, reflecting rainbow-like patterns in the folds of the fabric. With a sudden creaking sound, the ice shatters into a shower of snowflakes.
| Layers of cerulean-flecked silver icy mist harden along the skirts of (Character)'s ice-covered cloak, reflecting rainbow-like patterns in the folds of the fabric. With a sudden creaking sound, the ice shatters into a shower of snowflakes.
|-
| scope="row" | Elongated icicles of cerulean-flecked silver mist jut outward from the sleeves of your ice-covered cloak, lasting but a moment before shattering in frigid puffs of colorful ice crystals and mist.
| Elongated icicles of cerulean-flecked silver mist jut outward from the sleeves of (Character)'s ice-covered cloak, lasting but for a moment before shattering in frigid puffs of colorful ice crystals and mist.
|-
| scope="row" | Tendrils of cerulean-flecked silver icy mist pool at your feet, billowing from beneath your ice-covered cloak.
| Tendrils of cerulean-flecked silver icy mist pool at (Character)'s feet, billowing from beneath (her/his) ice-covered cloak.
|}
==See Also==
* [[Icy gown]]
* [[Fiery cloak]]
</td><td>
{{iteminfo
|type=Fluff 
|itemclass=Clothing 
|itemtype=Cloak 
|alter=Yes 
|ld=Yes 
|feature= 
|customize=Yes 
|custom=Ice crystal color 
|origmerch= 
|releasevenue=Currents of Myth 
|releaseyear=2026 
|questitem= 
|tiered= 
|tiersnumber= 
|unlock= 
|legendary= 
|demeanor= 
|loresong= 
|corrscript= 
|attune= 
|attunement= 
|affinity= 
|spell= 
|enhancive= 
|swap= 
|add= 
|restrictions=Must remain actual fabric.<br>Messaging references a long garment.<br>Ice crystal color must be kept to a reasonable length. 
}}
{{itemverb
|verb=ATTEND 
|verb2=BOW
|verb3=CAST
|verb4=CLEAN
|verb5=INVOKE
|verb6=NUDGE
|verb7=PINCH
|verb8=PROD
|verb9=PULL
|verb10=PUSH
|verb11=SHAKE
|verb12=WAGGLE
|verb13=WAVE
}}
</td></tr></table>

SimuCon 2025

2026-07-22T15:34:44Z

HORIBU1: /* Attendee Ticket Options */ fix year for attendee spirit beast

'''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 10 through Sunday, July 13, 2025 at the Sheraton Westport Plaza Hotel. Room reservation link Room reservation link [https://www.marriott.com/event-reservations/reservation-link.mi?id=1741039429417&key=GRP&app=resvlink here].

==2025 Schedule==
===Main Schedule===
All times CST (CENTRAL TIME)

{| class="wikitable"
! colspan="8" |Activity: See printed schedule for correct location.
|-
!Day
!Time
! colspan="6" |Activity
|-
| rowspan="2" style="text-align: center;font-weight:bold; vertical-align:top;" |Wednesday<br />July 9th
|-
| style="text-align: right" |3:00 PM
| colspan="6" style="text-align: center;background-color: #F2DDDC;" |Lend a hand with setup and hang out (Check-in starts on Thursday)
|-
| rowspan="15" style="text-align: center;font-weight:bold; vertical-align:top;" |Thursday<br />July 10th
|-
| style="text-align: right" |All Day
| colspan="6" style="text-align: center;background-color: #FFFFFF;" |Check-in and Socialize
|-
| style="text-align: right" |9:00 AM
| colspan="6" style="text-align: center;background-color: #FFFFFF;" | Coffee, Tea, and Water
|-
| style="text-align: right" |12:00 PM
| colspan="6" style="text-align: center;background-color: #FFFFFF;" |Lunch break (on your own)
|-
| style="text-align: right" |2:00 PM
| colspan="6" rowspan="2" style="text-align: center;background-color: #FFE6CC;" | Betrayer's Session 1
|-
| style="text-align: right" |3:00 PM
|-
| style="text-align: right" |4:00 PM
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: red;" |GS - Who in the Whatnow?
| colspan="2" rowspan="1" style="text-align: center;background-color: #FFFED6; color: red;" |D&D Session 0 **
|-
| style="text-align: right" |5:00 PM
| colspan="6" rowspan="1" style="text-align: center;background-color: #FFFFFF;" |Dinner break (on your own)
|-
| style="text-align: right" |6:00 PM
| colspan="4" rowspan="1" style="text-align: center;background-color: #FFFFFF;" |
| colspan="2" rowspan="3" style="text-align: center;background-color: #FFFED6; color: red;" |D&D One-Shot **
|-
| style="text-align: right" |7:00 PM
| colspan="4" rowspan="2" style="text-align: center;background-color: #FFE6CC;" | Betrayer's Session 2
|-
| style="text-align: right" |8:00 PM
|-
| style="text-align: right" |9:00 PM
| colspan="5" rowspan="3" style="text-align: center;background-color: #FFFED6; color: blue;" | Ice Breaker Event
| colspan="1" rowspan="3" style="text-align: center;background-color: #FFFED6; color: red;" |D&D One-Shot **
|-
| style="text-align: right" |10:00 PM
|-
| style="text-align: right" |11:00 PM
|-
| style="text-align: right" |1:00 AM
| colspan="6" style="text-align: center;background-color: #F2DDDC;" | Quiet Hours - Volume down, liquor bottles away
|-
|-
| rowspan="20" style="text-align: center;font-weight:bold; vertical-align:top;" |Friday<br />July 11th
|-
| style="text-align: right" |All Day
| colspan="6" style="text-align: center;background-color: #FFFFFF;" |Check-in and Socialize
|-
| style="text-align: right" |9:00 AM
| colspan="6" style="text-align: center;background-color: #FFFFFF;" | Coffee, Tea, and Water
|-
|style="text-align: center" |'''Instance'''
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: red;" |Gemstone
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: #BF40BF;" |Dragon Realms
|-
| style="text-align: right" |10:00 AM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" |Panel: ALTER and You
| colspan="3" rowspan="2" style="text-align: left;background-color: #D6FFE7; color: #BF40BF;" |PANEL: Live Dev
|-
| style="text-align: right" |11:00 AM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" |Panel: Premium Benefits
|-
| style="text-align: right" |12:00 PM
| colspan="4" rowspan="2" style="text-align: center;background-color: #FFFFFF;" |Lunch break (on your own)
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: red;" |Blood on the Clocktower
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6;" |Lunch with Staff (perk)
|-
| rowspan="1" style="text-align: center" |1:00 PM
|-
|style="text-align: center" |'''Instance'''
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: red;" |Gemstone
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: #BF40BF;" |Dragon Realms
|-
| style="text-align: right" |2:00 PM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" | Panel: World Announcements & OSA Workshop
| colspan="3" rowspan="2" style="text-align: left;background-color: #D6FFE7; color: #BF40BF;" |Panel: Alteration and Item Design
|-
| style="text-align: right" |3:00 PM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" | Panel: Duskruin
|-
| style="text-align: right" |4:00 PM
| colspan="6" rowspan="1" style="text-align: center;background-color: #FFE6CC;" |Panel Breaks
|-
| style="text-align: right" |5:00 PM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" | Blindfolded Duskruin Endless
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6FFE7; color: #BF40BF;" | Blindfolded PvP
|-
| style="text-align: right" |6:00 PM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" | Droughtman's Challenge (Prime & Shattered)
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6FFE7; color: #BF40BF;" | Basic Orienteering
|-
| style="text-align: right" |7:00 PM
| colspan="6" rowspan="1" style="text-align: center;background-color: #FFFFFF;" |Dinner break (on your own)
|-
| style="text-align: right" |8:00 PM
| colspan="5" rowspan="1" style="text-align: center;background-color: #FFFFFF;" |
| colspan="1" rowspan="3" style="text-align: center;background-color: #FFFED6; color: red;" |D&D One-Shot **
|-
| style="text-align: right" |9:00 PM
| colspan="5" rowspan="2" style="text-align: center;background-color: #FFFED6; color: blue;" | Live Alterations
|-
| style="text-align: right" |10:00 PM
|-
| style="text-align: right" |11:00 PM
| colspan="6" rowspan="1" style="text-align: center;background-color: #FFE6CC;" |Socializing
|-
| style="text-align: right" |1:00 AM
| colspan="65"" style="text-align: center;background-color: #F2DDDC;" |Quiet Hours - Volume down, liquor bottles away
|-
| rowspan="20" style="text-align: center;font-weight:bold; vertical-align:top;" |Saturday<br />July 12th
|-
| style="text-align: right" |All Day
| colspan="6" style="text-align: center;background-color: #FFFFFF;" |Check-in and Socialize
|-
| style="text-align: right" |9:00 AM
| colspan="5" style="text-align: center;background-color: #FFFFFF;" | Coffee, Tea, and Water
| colspan="1" rowspan="4" style="text-align: center;background-color: #FFFED6; color: red;" |D&D One-Shot **
|-
|style="text-align: center" |'''Instance'''
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: red;" |Gemstone
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: #BF40BF;" |Dragon Realms
| colspan="1" rowspan="3" style="text-align: center;background-color: #FFFFFF;" |
|-
| style="text-align: right" |10:00 AM
| colspan="2" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" |Panel: What's New?
| colspan="2" rowspan="2" style="text-align: left;background-color: #D6FFE7; color: #BF40BF;" |PANEL: History and Lore
|-
| style="text-align: right" |11:00 AM
| colspan="2" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" |Panel: Creating Items
|-
| style="text-align: right" |12:00 PM
| colspan="4" rowspan="3" style="text-align: center;background-color: #FFFFFF;" |Lunch break (on your own)
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: red;" |Blood on the Clocktower
| colspan="1" rowspan="3" style="text-align: center;background-color: #FFFED6; color: red;" |Sip and Paint
|-
| style="text-align: right" |1:00 PM
|-
| style="text-align: right" |2:00 PM
| colspan="1" rowspan="1" style="text-align: center;background-color: #FFFED6; color: red;" |
|-
|style="text-align: center" |'''Instance'''
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: red;" |Gemstone
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: #BF40BF;" |Dragon Realms
|-
| style="text-align: right" |3:00 PM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" | Panel: Gemstones
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6FFE7; color: #BF40BF;" | Informal Q & A
|-
| style="text-align: right" |4:00 PM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" | Panel: Sailor's Grief
| colspan="3" rowspan="1" style="text-align: center;background-color: #FFE6CC;" |Panel Breaks
|-
| style="text-align: right" |5:00 PM
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6F3FF; color: red;" | Exploration
| colspan="3" rowspan="1" style="text-align: left;background-color: #D6FFE7; color: #BF40BF;" |
|-
| style="text-align: right" |6:00 PM
| colspan="6" rowspan="2" style="text-align: center;background-color: #FFFFFF;" |Dinner break (on your own)
|-
| style="text-align: right" |7:00 PM
|-
| style="text-align: right" |8:00 PM
| colspan="6" rowspan="1" style="text-align: center;background-color: #FFE6CC;" |Costume Party Contest
|-
| style="text-align: right" |9:00 PM
| colspan="6" rowspan="1" style="text-align: center;background-color: #FFE6CC;" | Raffles
|-
| style="text-align: right" |10:00 PM
| colspan="6" rowspan="2" style="text-align: center;background-color: #FFE6CC;" | Music
|-
| style="text-align: right" |11:00 PM
|-
| style="text-align: right" |1:00 AM
| colspan="6" style="text-align: center;background-color: #F2DDDC;" | Quiet Hours - Volume down, liquor bottles away
|-
| rowspan="4" style="text-align: center;font-weight:bold; vertical-align:top;" |Sunday<br>July 13th
|-
| style="text-align: right" |All Day
| colspan="6" style="text-align: center;background-color: #FFFFFF;" |Check-in and Socialize
|-
| style="text-align: right" |9:00 PM
| colspan="6" style="text-align: center;background-color: #F2DDDC;" |Socialize/Clean up!
|-
| style="text-align: right" |2:00 AM
| colspan="6" style="text-align: center;background-color: #F2DDDC;" |Rooms Close - Con Ends!
|-
|}

For the Live Alteration Sessions:<br>
- First come, first served! If you would rather socialize, then feel free to let GM Thandiwe know, and she will send you an alteration token that you can REDEEM in-game. It will have an expiration on it, though, so be aware of that.

<nowiki>*</nowiki>This event requires a laptop or use of one of the workstations provided in the main conference room to access the game.

<nowiki>**</nowiki>D&D One Shots: You must pre-register for a session in the Box Office. It is strongly recommended to attend Session 0.

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===
The following Gemstone IV panels will be streamed. All times CST (CENTRAL TIME)

Streaming link: [https://www.twitch.tv/simuradio SimuRadio]

{| class="wikitable"
!Day
!Time
!Panel
|-
|'''Friday, July 11th'''
|10:00 AM
|[https://docs.google.com/presentation/d/e/2PACX-1vQ4a0-F_noQJuZt1KJJJgNkSVqQdaE3cHkUE2axPkcVlJ4eErdmo80xWnFs1UhSF4HB58fNwlbuskuh/pub?start=true&loop=false&delayms=10000 Panel: ALTER and YOU]
|-
|'''Friday, July 11th'''
|11:00 AM
|[https://docs.google.com/presentation/d/e/2PACX-1vTAzCR6A6b_KfVLMyOmnnQ40pvjbcMaFdNnL8Qr3I27DuBL3PI5o2NSRd5mwoxhFDX8egZbbE3qPIVd/pub?start=true&loop=false&delayms=10000 Panel: Premium Benefits]
|-
|'''Saturday, July 12th'''
|3:00 PM
|Panel: Gemstones
|-
|'''Saturday, July 12th'''
|4:00 PM
|Panel: Sailor's Grief
|}

=== Unstreamed Panels ===
* [https://docs.google.com/presentation/d/e/2PACX-1vRuao5m6EL1SleZsg5zH4ulRJxEll5QLV4ukhbM15k_eEpeGbTK1UvF_QCG06x2kW44lPYsadcoCJdp/pub?start=true&loop=false&delayms=10000 Duskruin Panel]
* [https://docs.google.com/presentation/d/e/2PACX-1vQ5tLmNfrX2D8F9ciDO81eiB9I7e_jgmxK6_bgrHWeSNB7ZZf57fWep6YhbwZA16S6io2cAb5l0z7Zh/pub?start=true&loop=false&delayms=10000 World Announcements & OSA]
* [https://docs.google.com/presentation/d/e/2PACX-1vRdLYjYoyhllY0TkeOaS0OwLxSGMYYTZD_UkVIvxUQ25sriFx2Ly39luSTjH_E8F3dRl6HE0qNo4_mT/pub?start=true&loop=false&delayms=10000 What's New?]
* [https://docs.google.com/presentation/d/e/2PACX-1vTeS59eQ1ZOVf_6vd3YfT64Vbbu0NNQUgrndvXzSbafKAKKeuW7F9hqN4cU6gpBAoPFT4B5BF8tz2RF/pub?start=true&loop=false&delayms=10000 Gemstones]
* [https://docs.google.com/presentation/d/e/2PACX-1vRoADIRpPaU_w3mOh_GFPFobazx0_aVpvV8A81vpAysvydJs9C3Tj7oATUx0I9EI92RRl8kPlwT7rHL/pub?start=false&loop=false&delayms=3000 Sailor's Grief]

==Attendee List==
===Prime Players===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* [[Altheren (prime)|Altheren]]
* Amerek
* Callayne
* Citan
* [[Delindra (prime)|Delindra]]
* [[Dergoatean (prime)|Dergoatean]]
* Desorceri
* Durakar
* [[Elgrim (prime)|Elgrim]]
* [[Fyg (prime)|Fyg]]
* Julenne
* Liras
* [[Maylan (prime)|Maylan]]
* Madmountan
* Mourdeyan
* Raelee
* Ramladu
* Roblar
* Valanis
* Zangow
</div>

===Platinum Players===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* Deleu
</div>

===Shattered Players===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* Drekoi
* Omrii
* Tysong
</div>

===Game Staff===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* Aergo
* Auchand
* Haxus
* <s>Ivry</s>
* Kaonashi
* Lydil
* Mestys
* Nyxus
* Tago
* Thandiwe
* Valyrka
* Xeraphina
</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==
Ticketing is handled through the play.net [https://www.play.net/gs4/quests/ Box Office] page. '''Be sure to click on the Details button in the Box Office to view the specifics of your selection.''' To attend, a badge is required and all attendees must display their badge at all times while in the official event rooms. Badges can be purchased at the door, but will be more expensive.

===Non-Attendee Options===
'''Non-Attendee Goodie Bag: $40 - 1000 Available'''
* 4x RPA orb (account attuned)
* Chronomage Spheres, 1x per town
* Urchin Guide, 90 days
* Adv Guild Vouchers, 20 uses
* Quest Orb, 1 use

'''Extra Special Item: $40 - 1000 Available'''

This an ADDITIONAL special item!
*A unique Spirit Beast available only at SimuCon 2025!

===Attendee Ticket Options===
'''Badge (Option 10 in the Box Office): $40 Base Price - 1000 Available'''
All attendees must display their badge at all times while in the official event rooms. Includes:

Attendee Goodie Bag
* 4x RPA orb (account attuned)
* Chronomage Spheres, 1x per town
* Urchin Guide, 90 days
* Adv Guild Vouchers, 20 uses
* Quest Orb, 1 use
* Special Attendee-only Scripted Item! (account attuned)
* Title: Kindred Spirit

'''Extra Special Item: $40 Add-On - 1000 Available'''

This an ADDITIONAL special item!
* A unique Spirit Beast available only at SimuCon 2025!

'''Character Portrait: $250 Add-On - 8 Available'''

A rendering of your character, copy to be provided to you and included in your character's LOOK in game.

Provide your character's full LOOK description. Include as much detail as possible to convey to the artist a clear vision of your character.
* You may note one or two items that you want specifically depicted. If you prefer a certain pose, specify it.
You will be provided with a composite sketch and allowed one round of revision before the final product is completed.

Images will be delivered in the following formats -
* Low res:830x1080 (to fit within the Wiki upload file size limit, if you want to display your image there)
* High res:2400x3000 pixels. (print size of 8x10)

'''Custom Room: $250 Add-On - 3 Available'''

Purchaser will work with a GM to create a unique room that will be deployed to all instances of the game.

'''Custom Siegery Set: $200 Add-On - 10 Available'''

This package contains:
* 1 repair / carrying case
* 1 (choice of) castle or fortress
* 2 siege weapons
* 2 soldiers
* You can design the appearance of each piece, and we will write custom messaging to match!

'''D&D One-Shot Game: $5 Add-On - 15 Available'''

Participate in one of the Elanthia-themed One-Shot campaigns. You will receive a pouch of dice to play the game with!

'''Lunch with Simutronics: $150 Add-On - 3 Available'''

Participate in the small group lunch on Friday at noon with DR PM Lyneya, GS PM Wyrom (tentative, and Simutronics CEO Skippy, Chris in Billing, and Mike the New Tech Guy.

'''Simu Swag: $50 Add-On - 25 Available'''

SimuCon branded bag containing:
* 2024 Ceramic Mug
* 2024 SimuCon T-shirt
* ... and other stuff!

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

2026-07-22T15:34:21Z

HORIBU1: /* Attendee Ticket Options */ fix year for attendee spirit beast

'''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 2026 are Thursday, July 9 through Sunday, July 12, 2026 at the Sheraton Westport Plaza Hotel. Room reservation link Room reservation link [https://www.marriott.com/event-reservations/reservation-link.mi?id=1770159231629&key=GRP&app=resvlink here]

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

{| class="wikitable"
! colspan="10" |Activity: See printed schedule for correct location.
|-
!Day
!Time
! colspan="8" |Activity
|-
| rowspan="2" style="text-align: center;font-weight:bold; vertical-align:top;" |Wednesday<br />July 8th
|-
| style="text-align: right" |3:00 PM
| colspan="8" style="text-align: center;background-color: #F2DDDC;" |Lend a hand with setup and hang out (Check-in starts on Thursday)
|-
| rowspan="16" style="text-align: center;font-weight:bold; vertical-align:top;" |Thursday<br />July 9th
|-
| style="text-align: right" |All Day
| colspan="8" style="text-align: center;background-color: #FFFFFF;" |Check-in and Socialize
|-
| style="text-align: right" |9:00 AM
| colspan="8" style="text-align: center;background-color: #FFFFFF;" | Coffee, Tea, and Water
|-
| style="text-align: right" |12:00 PM
| colspan="8" style="text-align: center;background-color: #FFFFFF;" |Lunch break (on your own)
|-
| style="text-align: right" |2:00 PM
| colspan="7" rowspan="3" style="text-align: center;background-color: #FFE6CC;" | Live Alterations
|-
| style="text-align: right" |3:00 PM
|-
| style="text-align: right" |4:00 PM
| colspan="1" rowspan="1" style="text-align: center;background-color: #FFFED6; color: red;" |D&D Session 0 **
|-
| style="text-align: right" |5:00 PM
| colspan="8" rowspan="1" style="text-align: center;background-color: #FFFFFF;" |Dinner break (on your own)
|-
| style="text-align: right" |6:00 PM
| colspan="7" rowspan="2" style="text-align: center;background-color: #FFFFFF;" |Dinner break (on your own)
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: #BF40BF;" |D&D One-Shot **
|-
| style="text-align: right" |7:00 PM
|-
| style="text-align: right" |7:30 PM
| colspan="8" style="text-align: center;background-color: #FFFED6; color: #BF40BF;" | Presentation: Saga
|-
| style="text-align: right" |8:00 PM
| colspan="7" rowspan="3" style="text-align: center;background-color: #FFE6CC;" | SINGO
|-
| style="text-align: right" |9:00 PM
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: #BF40BF;" |D&D One-Shot **
|-
| style="text-align: right" |10:00 PM
|-
| style="text-align: right" |11:00 PM
| colspan="8" rowspan="1" style="text-align: center;background-color: #FFE6CC;" | Socializing
|-
| style="text-align: right" |1:00 AM
| colspan="8" style="text-align: center;background-color: #F2DDDC;" | Quiet Hours - Volume down, liquor bottles away
|-
|-
| rowspan="20" style="text-align: center;font-weight:bold; vertical-align:top;" |Friday<br />July 10th
|-
| style="text-align: right" |All Day
| colspan="8" style="text-align: center;background-color: #FFFFFF;" |Check-in and Socialize
|-
| style="text-align: right" |9:00 AM
| colspan="8" style="text-align: center;background-color: #FFFFFF;" | Coffee, Tea, and Water
|-
|style="text-align: center" |'''Instance'''
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" |Gemstone
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" |Dragon Realms
|-
| style="text-align: right" |10:00 AM
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Dev
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Auchand, Nyxus, and Friends
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | Live Dev
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" |Paklin / Zadraes (remote)
|-
| style="text-align: right" |11:00 AM
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Mounts!
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Aergo, Auchand, and Thandiwe
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | World Building
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" |Lyneya / Ulerith (remote)
|-
| style="text-align: right" |12:00 PM
| colspan="6" rowspan="2" style="text-align: center;background-color: #FFFFFF;" |Lunch break (on your own)
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: #BF40BF;" |Blood on the Clocktower
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6;" |Lunch with Staff (perk)
|-
| rowspan="1" style="text-align: center" |1:00 PM
|-
|style="text-align: center" |'''Instance'''
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" |Gemstone
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" |Dragon Realms
|-
| style="text-align: right" |2:00 PM
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6F3FF;" | Panel Break
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | Lyneya's Project
|-
| style="text-align: right" |3:00 PM
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Quests Feedback Workshop
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Nyxus, Kaonashi, Marstreforn
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | Wiki Work with Miskton
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | Player-run: Miskton
|-
| style="text-align: right" |4:00 PM
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | HALP!!1one!!
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Valyrka, Haxus, and Kaonashi
| colspan="4" rowspan="1" style="text-align: center;background-color: #FFE6CC;" |Panel Breaks
|-
| style="text-align: right" |5:00 PM
| colspan="6" rowspan="1" style="text-align: center;background-color: #D6F3FF;" | Panel Break
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: red;" |D&D One-Shot **
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: red;" |D&D One-Shot **
|-
| style="text-align: right" |6:00 PM
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | GS Raffles
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | DR Raffles
|-
| style="text-align: right" |7:00 PM
| colspan="8" rowspan="1" style="text-align: center;background-color: #FFFFFF;" |Dinner break (on your own)
|-
| style="text-align: right" |8:00 PM
| colspan="6" rowspan="1" style="text-align: center;background-color: #FFFFFF;" |Dinner break (on your own)
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: red;" |D&D One-Shot **
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: red;" |D&D One-Shot **
|-
| style="text-align: right" |9:00 PM
| colspan="6" rowspan="`" style="text-align: center;background-color: #FFFED6;" | Play Stupid Games, Win Stupid Prizes
|-
| style="text-align: right" |10:00 PM
| colspan="8" rowspan="2" style="text-align: center;background-color: #FFFED6;" | Play Stupid Games, Win Stupid Prizes
|-
| style="text-align: right" |11:00 PM
|-
| style="text-align: right" |1:00 AM
| colspan="8" style="text-align: center;background-color: #F2DDDC;" |Quiet Hours - Volume down, liquor bottles away
|-
| rowspan="20" style="text-align: center;font-weight:bold; vertical-align:top;" |Saturday<br />July 11th
|-
| style="text-align: right" |All Day
| colspan="8" style="text-align: center;background-color: #FFFFFF;" |Check-in and Socialize
|-
| style="text-align: right" |9:00 AM
| colspan="8" style="text-align: center;background-color: #FFFFFF;" | Coffee, Tea, and Water
|-
|style="text-align: center" |'''Instance'''
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" |Gemstone
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" |Dragon Realms
|-
| style="text-align: right" |10:00 AM
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Inquisitor

| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" |Kaonashi and Thandiwe
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | History Without Homework: Event Callbacks
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" |Irenos
|-
| style="text-align: right" |11:00 AM
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" |World
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" |Thandiwe, Marstreforn, Xynwen, Kaonashi
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | Getting Started with PvP
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | Sheearyn / Navesi / Kethrai / Crobin
|-
| style="text-align: right" |12:00 PM
| colspan="6" rowspan="2" style="text-align: center;background-color: #FFFFFF;" |Lunch break (on your own)
| colspan="1" rowspan="2" style="text-align: center;background-color: #FFFED6; color: red;" |Blood on the Clocktower
| colspan="1" rowspan="4" style="text-align: center;background-color: #FFFED6; color: red;" |Sip and Paint
|-
| style="text-align: right" |1:00 PM
|-
|style="text-align: center" |'''Instance'''
| colspan="4" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" |Gemstone
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" |Dragon Realms
|-
| style="text-align: right" |2:00 PM
| colspan="2" rowspan="2" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | The Dark Crystal
| colspan="2" rowspan="2" style="text-align: center;background-color: #D6F3FF; color: #BF40BF;" | Auchand and Nyxus
| colspan="3" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | Panel Break
|-
| style="text-align: right" |3:00 PM
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | Informal Q&A
| colspan="2" rowspan="1" style="text-align: center;background-color: #D6FFE7; color: blue;" | All GMs
|-
| style="text-align: right" |4:00 PM
| colspan="8" rowspan="1" style="text-align: center;background-color: #D6F3FF; color: blue;" | Workshop: Lynena's Project
|-
| style="text-align: right" |5:00 PM
| colspan="8" rowspan="3" style="text-align: center;background-color: #FFFFFF;" |Dinner break (on your own)
|-
| style="text-align: right" |6:00 PM
|-
| style="text-align: right" |7:00 PM
|-
| style="text-align: right" |8:00 PM
| colspan="8" rowspan="1" style="text-align: center;background-color: #FFE6CC;" |Costume Contest
|-
| style="text-align: right" |9:00 PM
| colspan="8" rowspan="3" style="text-align: center;background-color: #FFE6CC;" | Music
|-
| style="text-align: right" |10:00 PM
|-
| style="text-align: right" |11:00 PM
|-
| style="text-align: right" |1:00 AM
| colspan="8" style="text-align: center;background-color: #F2DDDC;" | Quiet Hours - Volume down, liquor bottles away
|-
| rowspan="8" style="text-align: center;font-weight:bold; vertical-align:top;" |Sunday<br>July 12th
|-
| style="text-align: right" |All Day
| colspan="8" style="text-align: center;background-color: #FFFFFF;" |Check-in and Socialize
|-
| style="text-align: right" |9:00 PM
| colspan="8" style="text-align: center;background-color: #F2DDDC;" |Socialize/Clean up!
|-
| style="text-align: right" |2:00 PM
| colspan="8" style="text-align: center;background-color: #F2DDDC;" |Rooms Close - Con Ends!
|-
|}

For the Live Alteration Sessions:<br>
- First come, first served! If you would rather socialize, then feel free to let GM Thandiwe know, and she will send you an alteration token that you can REDEEM in-game. It will have an expiration on it, though, so be aware of that.

<nowiki>*</nowiki>This event requires a laptop or use of one of the workstations provided in the main conference room to access the game.

<nowiki>**</nowiki>D&D One Shots: You must pre-register for a session in the Box Office. It is strongly recommended to attend Session 0.

===Twitch Streaming Schedule===
The following Gemstone IV panels will be streamed. All times CST (CENTRAL TIME)

==== Friday Panels ====
10:00 AM - [https://docs.google.com/presentation/d/e/2PACX-1vQh19cV5YkFIN9CC7LqhCEN0BpRcE5KCT6u_SY7-PbRBkMA7vpPnLYW5yUmX2EJ36n6Usuyk2gCvUCr/pub?start=true&loop=true&delayms=10000 The Dev Panel] (slide) - [https://www.youtube.com/watch?v=TcMjfQkLZFU Dev Panel] (YouTube)

11:00 AM - [https://docs.google.com/presentation/d/e/2PACX-1vT-pjLaZ0ZiEcp4ALoYInYh-n5xg74_dmNAS0vFliYtPSm7U52TaIT379RBrQi3dc0pUIroyRakctr0/pub?start=true&loop=true&delayms=10000 Mounts] (slide) - [https://www.youtube.com/watch?v=RgJgoXF7-sw Mounts] (YouTube)

4:00 PM - [https://docs.google.com/presentation/d/e/2PACX-1vRosu1wtQRbv_E6QXjTueUzJdUiAvbHMOjD-GMm8ZSHwC-3w9ugvnPmsVdbx0Cjp70Dcp6WdlEojc4J/pub?start=true&loop=true&delayms=10000 HALP!!1one!!] (slide) - [https://www.youtube.com/watch?v=eBd15ZqCaX8 HALP!!1one!!] (YouTube)

==== Saturday Panels ====

2:00 PM - [https://www.youtube.com/watch?v=cNVK6QSHp84 Saga] (YouTube)

Streaming link: [https://www.twitch.tv/simuradio SimuRadio]

=== Discord Streaming Schedule ===

==== Saturday Panels ====

10:00 AM - [https://docs.google.com/presentation/d/e/2PACX-1vQFNTMDS4XLi0XdC8IYhS8moYp6MWFlR3w4mTMlDGzJD6oajE6jqqm9PmKNeVEqIJhIQLAcoiBeTbXt/pub?start=true&loop=true&delayms=10000 Inquisitors]

11:00 AM - [https://docs.google.com/presentation/d/e/2PACX-1vSLle1zoesyIrzd0Getrs3hzkLuAHvHzMWKO0eI29I0YKgNnEVimzYQD7pgy1HA1cBW_d30UKJxHiwR/pub?start=true&loop=true&delayms=10000 World]

=== Unstreamed Panels ===

==Attendee List==
===Prime Players===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* Altheren
* Amerek
* Blanks
* Callayne
* Citan
* Delindra
* Deza
* Drekoi
* Elgrim
* Erienne
* Eruheran
* Faerous
* Falvicar
* Fizzleworth
* Fyg
* HebrewToYou
* Hexbane
* Julenne
* Katiesa
* Kragdruk
* Leifa
* Liras
* Maags
* Maylan
* Naamit
* Oogey
* Opalina
* Peche
* Puptilian
* Raelee
* Regwen
* Roblar
* Saesyra
* Taulramil
* Tranquia
* Zangow
* Zyandi
</div>

===Shattered Players===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* Penny
* Sue
* Tysong
</div>

===Game Staff===
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* GM Auchand
* GM Aergo
* GM Flannihan
* GM Ivry
* GM Kaonashi
* GM Lydil
* GM Marstreforn
* GM Mestys
* GM Nyxus
* GM Tago
* GM Thandiwe
* GM Valyrka
* GM Xynwen
</div>

==Frequently Asked Questions==
===How much does SimuCon cost?===
Attendance badges have previously cost $100 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=1770159231629&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=1770159231629&key=GRP&app=resvlink 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||11960 Westline Industrial Dr, St. Louis, MO 63146 ||https://www.agatheringplace.com/
|}

==Ticketing==
Ticketing is handled through the play.net [https://www.play.net/simucon/register/home.asp Simucon Box Office] page. To attend, a badge is required and all attendees must display their badge at all times while in the official event rooms. Badges likely can be purchased at the door, but will be more expensive.

===Non-Attendee Options===
'''Non-Attendee Goodie Bag: $40 - 999 Available'''
* goodies unknown at this time

'''Extra Special Item: $40 - 999 Available'''

This an ADDITIONAL special item!
*A unique Spirit Beast available only at SimuCon 2026!

===Attendee Ticket Options===
'''Badge: $100 Base Price - 999 Available'''
All attendees must display their badge at all times while in the official event rooms. Includes:

Attendee Goodie Bag
* goodies unknown at this time

'''Extra Special Item: $40 Add-On - 999 Available'''

This an ADDITIONAL special item!
* A unique Spirit Beast available only at SimuCon 2026!

'''Character Portrait: $250 Add-On - 5 Available'''
A rendering of your character, copy to be provided to you and included in your character's LOOK in game.

Provide your character's full LOOK description. Include as much detail as possible to convey to the artist a clear vision of your character.
* You may note one or two items that you want specifically depicted. If you prefer a certain pose, specify it.
You will be provided with a composite sketch and allowed one round of revision before the final product is completed.

Images will be delivered in the following formats -
* Low res:830x1080 (to fit within the Wiki upload file size limit, if you want to display your image there)
* High res:2400x3000 pixels. (print size of 8x10)

'''Custom Room: $250 Add-On - 3 Available'''

Purchaser will work with a GM to create a unique room that will be deployed to all instances of the game.

'''Sip & Paint: $50 Add-On - 10 Available'''

Join artist Rita Craighead as she guides you through an afternoon of painting your very own masterpiece! Each step will be explained and demonstrated, along with some helpful tips and tricks to bring out the best in your work.

'''D&D One-Shot Game: $15 Add-On - 15 Available'''

Participate in one of the Elanthia-themed One-Shot campaigns. You will receive a pouch of dice to play the game with!

'''Lunch with Simutronics: $150 Add-On - 3 Available'''

Participate in the small group lunch on Friday at noon.

==See Also==
*[https://discord.gg/ypGH9P4AsB Official Simutronics Discord Server]
*[https://elanthipedia.play.net/SimuCon DragonRealms Simucon Page] (DR's Wiki Page)

[[Category:SimuCon]]

Lich:Software/Installation

2026-07-21T00:24:54Z

HORIBU1: /* Lich Changelog */ update to 5.19.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.19.1 supporting Ruby 4.0 - published July 20, 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====
# You must be running Ruby 4.0 or greater for Lich 5.19 +. If unsure, please update both (see below)!
# '''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).

'''Step 1.'''
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 libcairo2-dev libgirepository1.0-dev libgtk-3-dev gobject-introspection
</pre>

{{side box|NOTE: If you are updating an existing Ruby installation rather than installing from scratch, skip steps 2, 3, and 4. Instead, update your ruby-build with the following command, and then proceed to Step 5.<pre>git -C ~/.rbenv/plugins/ruby-build pull</pre>}}

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

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

'''Step 4.'''
Download the tools to let rbenv install Ruby on its own, then install Ruby 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</pre>

'''Step 5.'''
<pre>rbenv install 4.0.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.5 -v
rbenv global 4.0.5
</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 ~/Lich5
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.

Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support
</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 cairo-devel curl gcc gdbm gdbm-devel gdk-pixbuf2-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 ~/Lich5
bundle install
</pre>

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

5b. Warlock:
download from https://sproctor.github.io/warlock3/download.html
run lich the normal way with ruby
<pre{{log2|margin-right=35%}}>
ruby ~/lich5/lich.rbw
</pre>
use use your login information with these settings to use lich launcher https://github.com/sproctor/warlock3/wiki/Lich-support

</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.19.1'''
<PRE>
### Bug Fixes (general)
* lower game socket keepalive idle from 120s to 30s (#1449)
* resilient ActiveSessions ownership + shutdown watchdog (#1452)
* Quit Gtk.main cleanly (#1455)
* Refactor regex to string comparisons for ARGV options (#1456)

### Bug Fixes (gs)
* ingest newly-exposed mindState experience and roommeta room fields (#1450)
</PRE>
'''5.19.0'''
<PRE>
### Features (general)
* Add character generator support via EAccess protocol (#1384)
* Add modern script command shutdown method (#1385)
* migrate the server-stream parser from REXML to Ox, with pipe-mode benchmark harness and DR parser coverage (#1396)
* enumerate script subdirs with file glob (#1397)
* add --bind-address option to set listen socket address (#1405)
* add central method to determine lich ver (#1417)
* setup_files: support scripts/data/custom for user data overrides (#1431)
* Modify running? method to support optional exact matching of script names (#1436)
* keyword bind hosts for the detachable client (tailscale/lan/any) (#1437)
* add roomlinks/roommono toggles for room display (#1438)
* self-healing gem requires (#1439)
* various Saga FE compatibility tweaks (#1443)
* add macOS limited gem recovery (#1448)

### Features (dr)
* Capture combat position from the balance status line (#1400)
* detect scheduled shutdown and expose it on DRParser (#1409)
* xmlparser: add structured parser for the assess (combat situation) stream (#1413)
* Implement DRCA.need_buffs? method for buff checks (#1428)

### Features (gs)
* anchor Infomon parser regex unions to line start (#1391)
* creature xml additions (#1425)
* add creature template library (#1427)

### Bug Fixes (general)
* surface a failed Game.open in the connect timeout (#1408)
* bound long-session memory growth (index/hook/watchfor/buffer leaks) (#1410)
* improve and harden shutdown (#1416)
* use bundler to check for required Ruby gems (#1420)
* pin lich directory for gemfile check (#1423)
* Show CLI login ARGV for SAL connections (#1424)
* increase read timeout on idle socket to 300 seconds (#1426)
* monkeypatch gi for memoryreleaser / asyncprocessor until patched upstream (#1429)
* Mapdb sort tags by downcase and original case (#1433)
* stop locking the load path at boot; keep Gemfile.lock in sync on self-update (#1434)
* minimum Ruby 4.0 required & migrate Ruby version check (#1444)
* align --announce with --update for Ruby version (#1447)

### Bug Fixes (dr)
* BalanceValue regex to match combat status lines (#1398)
* equipmanager.rb - Fix unload weapon detection when AimTimerDialog tag is prepended (#1414)

### Bug Fixes (gs)
* global_defs update pushStream regex to include 'reserve' id (#1379)
* psms Warcry.available? correction (#1387)
* xmlparser support new field exp, climate, terrain XML feeds (#1388)
* global_defs move() update regex for standing condition (#1407)
* Currency add method to retrieve aevit event currency (#1411)
* Stash check result type before comparing regex for wear_to_inv (#1430)
</PRE>
'''5.18.0'''
<PRE>
### Features (dr)
* common-crafting add method for creating mechanisms (#1375)

### Bug Fixes (general)
* stringproc normalize CRLF | CR to LF (#1378)
* rubocop custom cop ascii only cleanup (#1382)

### Bug Fixes (dr)
* equipmanager update to assume missing items aren't worn (#1376)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1326)
</PRE>
'''5.17.3'''
<PRE>
### Bug Fixes (general)
* Script module replace MemoryReleaser with GC.start for cleanup (#1364)
* Add sqlite busy timeout policy to core (#1365)
* Script#kill remove GC.start and add optional instrumentation (#1368)
* reorder shutdown ala MahtraDR and detect script teardown de... (#1369)
</PRE>
'''5.17.2'''
<PRE>
### Bug Fixes (general)
* harden custom repo identity, collision, and contract boundaries (#1333)
* stop SessionLifecycle before closing database on normal exit (#1334)
* harden FeatureFlags for closed db handle (#1335)
* SynchronizedSocket write resilience and zombie client elimination (#1338)
* correct RP timing issue for release notes (#1348)
* gate object cleanup in GTK queue (#1354)
* recover from cross-process zombie in ActiveSessions service (#1355)
* Improve shutdown session state handling (#1359)
* non-ascii hygeine to address rubocop errors (#1360)
* Remove debug log IO from heartbeat tick loop (#1363)

### Bug Fixes (dr)
* DRC text2num correction for thousand (#1343)

### Bug Fixes (gs)
* Overwatch add REVEALED_EXPLODES regex pattern (#1356)
* Stash add_to_bag result type check before regex compare (#1357)
</PRE>
'''5.17.1'''
<PRE>
### Bug Fixes (general)
* enable heartbeat-driven failover for ActiveSessions service owner (#1340)
* copy Gemfile and LICENSE during self-update (#1345)
* Add top-level parse_args/display_args bridge to global_defs (#1346)

### Bug Fixes (dr)
* replace undefined custom_require in check_moonwatch (#1336)
* set_stance places 100 in the correct positional slot (#1337)
* cache SlackBot users list to prevent API throttling (#1342)
* Add CORE_AUTOSTART sentinel to skip dependency.lic autostart helpers (#1344)

### Bug Fixes (gs)
* Infomon Status.cutthroat? Effect Debuff correction (#1331)
* add support for RESERVE xml in GameObj.reserve (#1341)
</PRE>
'''5.17.0'''
<PRE>
### Features (general)
* custom 3rd-party repo support for ScriptSync (#1285)
* Add get_settings, get_data, start_scripts_if_available to core (#1305)
* Add Map.apply_wayto_overrides for personal map overrides (#1306)

### Features (dr)
* Decouple SetupFiles from script-scoped echo and XML feed timing (#1304)
* Add game flags and obsolete script warnings to DRInfomon startup (#1307)

### Bug Fixes (general)
* use :__unset for --without-frontend CLI request YAML matches (#1301)
* prevent zombie server deadlock in Active Sessions accept loop (#1302)
* improve MacOS keychain system check for older OS variants (#1310)
* stub sync_all_repos to prevent leaked thread in games_spec (#1311)
* enforce beta confirmation 10s timeout (#1315)
* use send(:respond) in StatusReporter fallback path (#1316)
* ensure SessionLifecycle.stop runs on abnormal exit (#1317)
* address ActiveSessions lifecycle hot path feature-flag polling (#1325)
* catch ECONNRESET in _puts and bound walk_to retry depth (#1327)
* safeguard gtk logo.png loading (#1329)

### Bug Fixes (gs)
* Add InnCheckedOut pattern to parser (#1309)
* Claim corrections to handle mounts in room_players stream (#1324)
</PRE>
'''5.16.2'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)
* repair regression on gui button reenable from refactor (#1297)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.1'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)
* narrow safe_write rollback scope so cleanup failure preserves successful write (#1287)
* fix three revert bugs in SnapshotManager (#1289)
* guard nil release asset and validate before deleting lib/ (#1290)
* guard nil stable version in beta channel resolution (#1291)
* remove dead code in BranchInstaller (#1292)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)
* forward vitality and dead fields in perceive_health (#1288)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.16.0'''
<PRE>
### Features (general)
* session summary store and reporting (#1247)
* add core classes, ScriptSync, and login auto-sync (#1273)
* Add active sessions API (#1274)
* Add session status CLI query (#1276)
* configurable debug log retention (#1282)

### Features (dr)
* common-healing.rb - add vitality parsing to HealthResult (#1265)

### Bug Fixes (general)
* handle auth exceptions in manual login to prevent hang on bad password (#1267)
* set SO_REUSEADDR before bind to allow immediate port reuse (#1268)
* Persistent Launcher re-enable play button post launch (#1269)
* Restore manual login behaviors to not require saved entry t... (#1270)
* log and re-raise unexpected errors in saved login auth handler (#1271)

### Bug Fixes (dr)
* common-items.rb - move pattern from failure to success block (#1262)
* buffer_room_objs missed split components with leading stream tags (#1284)
* common-items.rb - get_item_unsafe false positives via XML feed verification (#1286)

### Bug Fixes (gs)
* Infomon xmlparser additional npc death messaging (#1275)
* Infomon xmlparser additional npc death messaging (#1281)
</PRE>
'''5.15.1'''
<PRE>
### Bug Fixes (general)
* Mutli-launch persistent login GUI (#1245)
* Remove Windows OS CMD prompt flash (#1255)
* guard against broken pipe errors in Game._puts and send_to_client (#1260)
* add timeout safety to fput to prevent infinite hangs (#1261)

### Bug Fixes (dr)
* anchor stow success pattern to prevent fan close recovery bypass (#1254)
* add bounded recursion depth limits to 9 methods (#1257)
* stow_helper failure detection + unload_weapon ammo recovery (#1259)
</PRE>
'''5.15.0'''
<PRE>
### Features (general)
* add InstanceSettings for core Settings API access (#1233)

### Features (gs)
* Overwatch module into core (#1201)

### Bug Fixes (general)
* fix GameObj container initialization and add clear_all_containers (#1226)
* GameObj object dedupe & GC (#1234)
* script.rb show Script.kill source (#1235)
* Exit quickly on CLI authentication failure (#1237)
* suppress wine detection noise and skip when unneeded (#1244)

### Bug Fixes (dr)
* DR modules fixes and enhancements (#1232)

### Bug Fixes (gs)
* psms.rb add additional failure matches (#1238)
* Bounty parser fix regex pattern for skin retrieval task (#1242)
</PRE>
'''5.14.2'''
<PRE>
### Bug Fixes (general)
* add retry with exponential backoff for all login authentication (#1205)
* update.rb allow for bugfix betas and branch updates (#1211)

### Bug Fixes (gs)
* infomon.rb bug in _key transformation (#1216)
</PRE>
'''5.14.1'''
<PRE>
### Bug Fixes (general)
* Change server_time_offset in XMLParser to be float instead of int (#1184)
* change encodings in main.rb to wizard FE only (#1199)

### Bug Fixes (gs)
* Infomon parser.rb update Account.subscription/type (#1192)
* spell.rb add last_cast to track last time casted (#1193)
* stash.rb additional improvements with ReadyList/StowList (#1197)
* Infomon parser.rb bug in EnhanciveEnd (#1198)
</PRE>
'''5.14.0'''
<PRE>
### Features (general)
* Add Genie map cross-reference fields to the DragonRealms map data model (#1169)

### Features (dr)
* DRExpMonitor move into core lich (#1154)

### Features (gs)
* add Enhancive module for enhancive item bonus tracking (#1113)
* add QStrike module for optimal stamina-based RT reduction (#1114)

### Bug Fixes (general)
* remove strip! from settingsInfo replacement (#1161)
* map_base.rb sort JSON better (#1171)

### Bug Fixes (dr)
* logbook_item recovery when crafted item not in hand (#1175)

### Bug Fixes (gs)
* xmlparser.rb capture additional death messaging (#1158)
* stash.rb ReadyList sheath handling and update inventory checks (#1166)
</PRE>
'''5.13.6'''
<PRE>
### Bug Fixes (general)
* allow --add-account to run without yaml and dat (#1143)
* enable --login for multi-variable custom launch commands (#1144)
* update.rb pervent update if MIN_RUBY not met (#1146)
* messaging.rb return "" for xml_encode with Wizard (#1147)
* prevent closing connection on module reload (#1148)
* Allow hmr to work on global_defs.rb (#1156)

### Bug Fixes (dr)
* buffer split room obj lines and merge instead of appending closing tag to broken line (#1149)
* add buffering for multiline room players (#1151)
* add verify_script def here instead of depending on dependency (#1155)

### Bug Fixes (gs)
* infomon.rb added updated_at field to upsert_batch (#1145)
* stowlist.rb check method fix when dead (#1152)
* readylist.rb check method fix when dead (#1153)
</PRE>
'''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-07-20T23:56:18Z

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

Lich:Software/Mac Installation

2026-07-19T20:50:41Z

HORIBU1: /* The Process */ add ox gem, need to change whole page to use bundle install instead of gem install

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

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

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

==Before You Start==

You will need to install a few things.

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

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

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

==The Process==

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

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

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

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

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

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

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

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

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

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

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

* <code>rbenv versions</code>

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

# <code>rbenv install 4.0.5</code>
# <code>rbenv global 4.0.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 4.0.5 (2026-05-20 revision 64336ffd0e) +PRISM [arm64-darwin25]</code>

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

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

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

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

Now run a quick test to see if things work:

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

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

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

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

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

==Lich for Other Front Ends==

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

https://warlockfe.github.io/

Configuration for Mac (and other OS types) here:

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

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

{{Third-Party Software}}

Lich:Script allmine

2026-07-13T19:23:08Z

HORIBU1: /* Script Source */ switched to syntaxhighlight instead of pre tag for proper code highlights

{{3rd-party}}
[[File:Allmine.jpg|thumb|right|alt=Screenshot of script working in GSIV|Screenshot of script working in GSIV]]
{{script
|title = AllMine
|author = Triex
|compat = WR/WFE
}}

'''AllMine''' is a [[Lich]] script that guards a placed [[All Mine]] item (a basket, bowl, or similar placeable object like Dhu Kittens) against being accidentally left behind. All Mine items can only be picked up by their owner for a set window after being placed, but players who wander off or log out without retrieving one risk losing it once that window lapses. AllMine hard-blocks movement and logoff commands while the item is on the ground, and raises repeating alerts if it is left behind anyway.

== Overview ==

Once armed, AllMine intercepts outgoing movement and quit/exit commands and refuses to send them to the game while the configured item remains on the ground in the current room. Sending the identical command a second time within 10 seconds overrides the block, so a deliberate decision to leave the item behind is still possible — the script only guards against accidental departures.

If the item is left behind regardless (for example, if the block is paused, or the player disconnects), a background watchdog raises a repeating alert describing where the item was placed and when. The watchdog never attempts to retrieve the item automatically or move the character — it is alert-only by design.

== Features ==

* Detects when the configured item is placed or dropped, and arms automatically
* Also arms if the item is already on the ground when the script starts, or if a held item transitions to the ground without a recognized message
* Hard-blocks compass movement, all documented GemStone IV movement styles (crawl, limp, march, sashay, skip, sneak, stride, stumble, trudge, prance, and normal walking), and QUIT/EXIT, while the item is on the ground
* 10-second identical re-send bypass, so a deliberate departure is one extra keystroke rather than a separate confirmation command
* Repeating alert (default every 15 seconds) if the item is left behind, silenced with a single command once acknowledged
* Recognizes when the item is recovered and lifts the block automatically
* Persists its state across a Lich restart, so a crash or disconnect while the item is deployed is not silent — the script announces the item's last known location on the next launch
* Works with any All Mine item by noun (bowl, basket, etc.) — not hard-coded to one item

== Requirements ==

* [[Lich]] 5, with Ruby-based script support
* GemStone IV, any supported front end (tested on Wrayth)

== Installation ==

Save the script as <code>allmine.lic</code> in the Lich scripts directory. No dependencies beyond core Lich5.

== Getting Started ==

Configure the noun of the item once, then start the monitor:

<pre{{log2}}>
;allmine set bowl
;allmine
</pre>

The monitor must be running for the movement block and watchdog to be active. If the item's noun is changed while the monitor is already running, restart it so the detection patterns rebuild.

== Commands ==

{| class="wikitable"
|-
! Command !! Description
|-
| <code>;allmine set <noun></code> || Configure the item's noun (for example, <code>bowl</code>)
|-
| <code>;allmine</code> (no arguments) || Start the monitor
|-
| <code>;allmine arm</code> || Manually arm on a matching item already on the ground in the current room
|-
| <code>;allmine status</code> || Show current configuration and state
|-
| <code>;allmine ack</code> || Silence a left-behind alert without clearing the deployed state
|-
| <code>;allmine clear</code> || Manually clear the deployed state (for example, if the item was recovered by other means)
|-
| <code>;allmine pause</code> || Disable the movement block; the watchdog continues to run
|-
| <code>;allmine resume</code> || Re-enable the movement block
|-
| <code>;allmine debug</code> || Toggle echoing of raw upstream command lines, for troubleshooting
|-
| <code>;allmine verb add <verb></code> || Add a custom movement verb to the block list
|-
| <code>;allmine verb remove <verb></code> || Remove a previously added custom movement verb
|}

== Default Blocked Commands ==

* Compass directions: n, north, s, south, e, east, w, west, ne, northeast, nw, northwest, se, southeast, sw, southwest, u, up, d, down, out
* Movement verbs: go, climb, swim, jump, leap, dive, vault, enter, board, ride, walk, crawl, limp, march, sashay, skip, sneak, stride, stumble, trudge, prance
* Logoff: quit, exit

Additional verbs can be added per character with <code>;allmine verb add <verb></code>.

== Notes ==

* The watchdog does not automatically return the character to the item's location or attempt to retrieve it. This is intentional — the script only alerts.
* Whether script-generated movement (as opposed to typed commands) is intercepted by the movement block has not been independently confirmed for every possible calling script; the watchdog's left-behind alert serves as a backstop regardless.

== Script Source ==

<syntaxhighlight lang="ruby">
=begin

allmine.lic - All Mine item guard

Prevents accidentally leaving a placed All Mine item (basket, bowl, etc.)
behind when moving rooms or logging off. Hard-blocks movement/quit while
the item is on the ground, with a 10-second re-send bypass. A watchdog
thread fires repeating alerts (no auto-return) if the item is left behind
anyway.

;allmine set <noun> configure the item noun (e.g. bowl)
;allmine arm manually arm on an item already on the ground
;allmine status show current state
;allmine ack acknowledge/silence a left-behind alert
;allmine clear manually clear deployed state
;allmine pause disable the movement block (monitoring continues)
;allmine resume re-enable the movement block
;allmine verb add <v> add a custom movement verb to block
;allmine verb remove <v>
;allmine help show help

Run with no arguments to start the monitor. Subcommands may be issued
while the monitor runs; they modify shared settings and exit.

NOTE: It is unverified whether script-generated movement (e.g. go2's
fput) passes through UpstreamHook. If it bypasses the block, the
watchdog alert still catches the left-behind item. Test live.

author: Triex
game: GSIV
tags: utility, allmine
version: 0.3.1

changelog:
0.3.1 (2026-07-13):
Fix mojibake in bold alert text (replaced em dash with plain hyphen;
file is now pure ASCII). Added full GSIV movement style verb list
(crawl, limp, march, sashay, skip, sneak, stride, stumble, trudge,
prance) plus walk -- previously only compass verbs like sashay
passed through unblocked.
0.3.0 (2026-07-13):
Fix movement block never firing: hooks no longer touch CharSettings
(unavailable in hook context); state mirrored into module ivars.
Tolerant upstream command parsing (optional <c> prefix). Added
;allmine debug to echo raw upstream lines.
0.2.0 (2026-07-13):
Arm when the item is already on the ground at monitor start, when a
held item transitions to ground loot (missed place message), or via
manual ;allmine arm.
0.1.0 (2026-07-13):
Initial release. Deploy/pickup detection, hard-block with 10s
re-send bypass, alert-only watchdog, crash persistence.

=end

module AllMine
UP_HOOK = 'AllMine::upstream'
DOWN_HOOK = 'AllMine::downstream'

BYPASS_WINDOW = 10 # seconds: identical re-sent command passes through
ALERT_INTERVAL = 15 # seconds between repeating left-behind alerts
POLL_INTERVAL = 1 # watchdog poll rate

# Single-word directional commands (whole command must match).
DIRS = %w[n north s south e east w west
ne northeast nw northwest se southeast sw southwest
u up d down out].freeze

# Verbs that take an argument and cause movement (first word must match).
# Includes GSIV movement styles (confirmed via in-game MOVEMENT command:
# Normal, Crawl, Limp, March, Sashay, Skip, Sneak, Stride, Stumble,
# Trudge, Prance) plus other common movement verbs. Extend with
# ;allmine verb add <verb>.
MOVE_VERBS = %w[go climb swim jump leap dive vault enter board ride walk
crawl limp march sashay skip sneak stride stumble trudge prance].freeze

# Logoff commands (whole command must match).
QUIT_CMDS = %w[quit exit].freeze

@last_blocked = nil
@pending_deploy_at = nil
@last_held_id = nil
@loot_miss_count = 0
@last_alert_at = Time.at(0)
@pending_clear_at = nil
@hs_noun = @hs_item_id = @hs_extra = nil
@hs_deployed = @hs_paused = @hs_debug = false

def self.settings
CharSettings['allmine'] ||= {}
CharSettings['allmine']
end

def self.bold(msg)
_respond Lich::Messaging.monsterbold(msg)
end

def self.info(msg)
_respond Lich::Messaging.msg_format('teal', "[AllMine] #{msg}")
end

def self.caution(msg)
_respond Lich::Messaging.msg_format('orange', "[AllMine] #{msg}")
end

# ---------------------------------------------------------------- state

def self.deployed?
settings['deployed'] == true
end

def self.set_deployed(item_id)
settings['deployed'] = true
settings['item_id'] = item_id
settings['room_id'] = (Room.current.id rescue nil)
settings['placed_at'] = Time.now.to_i
settings['acked'] = false
@loot_miss_count = 0
sync_hook_state
info "Your #{settings['noun']} (ID #{item_id || 'unknown'}) is now on the ground in room #{settings['room_id'] || 'unmapped'}. Movement is guarded."
end

def self.clear_deployed(reason)
settings['deployed'] = false
settings['item_id'] = nil
settings['acked'] = false
@loot_miss_count = 0
@pending_clear_at = nil
sync_hook_state
info "Your #{settings['noun']} has been recovered (#{reason}). Movement is no longer guarded."
end

def self.item_on_ground?
id = settings['item_id']
if id
GameObj.loot.to_a.any? { |o| o.id == id }
else
noun = settings['noun']
return false unless noun
GameObj.loot.to_a.any? { |o| o.noun == noun }
end
end

def self.item_in_hands?
id = settings['item_id']
return false unless id
[GameObj.right_hand, GameObj.left_hand].any? { |h| h && h.id == id }
end

# ------------------------------------------------------------ movement

def self.blocked_command?(cmd)
words = cmd.downcase.split
return false if words.empty?
first = words.first
if words.length == 1
return :quit if QUIT_CMDS.include?(first)
return :move if DIRS.include?(first)
end
return :move if MOVE_VERBS.include?(first) || (@hs_extra || []).include?(first)
false
end

# ---------------------------------------------------------------- hooks

# Hooks execute in Lich's stream context, not this script's thread, so
# they must never touch CharSettings (script-scoped). All state they
# need is mirrored into module ivars by sync_hook_state, which runs in
# the script thread. set_deployed/clear_deployed also update the mirror
# immediately.
def self.sync_hook_state
@hs_noun = settings['noun']
@hs_deployed = settings['deployed'] == true
@hs_paused = settings['paused'] == true
@hs_item_id = settings['item_id']
@hs_extra = (settings['extra_verbs'] || []).dup
@hs_debug = settings['debug'] == true
end

def self.install_hooks
noun = Regexp.escape(settings['noun'])
place_re = /You carefully place your [^.]*\b#{noun} on the ground\./
pickup_re = /You pick up [^.]*\b#{noun}\./

DownstreamHook.add(DOWN_HOOK, proc { |xml|
begin
if xml =~ place_re
@pending_deploy_at = Time.now
elsif xml =~ pickup_re && @hs_deployed
@pending_clear_at = Time.now # watchdog confirms and clears
end
rescue => e
respond "[AllMine] Downstream hook error: #{e}" rescue nil
end
xml
})

UpstreamHook.add(UP_HOOK, proc { |line|
begin
respond "[AllMine DEBUG] upstream: #{line.inspect}" if @hs_debug
next line unless @hs_deployed
next line if @hs_paused
# Client command framing is not documented; tolerate an optional
# <c> prefix anywhere-leading, else take the raw line.
cmd = line.sub(/\A\s*(?:<c>)?/, '').strip
next line if cmd.empty?
kind = AllMine.blocked_command?(cmd)
next line unless kind

on_ground = begin
if @hs_item_id
GameObj.loot.to_a.any? { |o| o.id == @hs_item_id }
else
GameObj.loot.to_a.any? { |o| o.noun == @hs_noun }
end
rescue
true # if the check itself fails, block rather than risk the item
end
next line unless on_ground

key = cmd.downcase
if @last_blocked && @last_blocked[:cmd] == key &&
(Time.now - @last_blocked[:time]) <= BYPASS_WINDOW
@last_blocked = nil
next line # intentional: identical command re-sent within window
end

@last_blocked = { cmd: key, time: Time.now }
if kind == :quit
AllMine.bold "*** YOUR #{@hs_noun.upcase} IS STILL ON THE GROUND - repeat #{cmd.upcase} within #{BYPASS_WINDOW} seconds to log off anyway. ***"
else
AllMine.bold "*** YOUR #{@hs_noun.upcase} IS STILL ON THE GROUND - repeat the command within #{BYPASS_WINDOW} seconds to leave anyway. ***"
end
next nil
rescue => e
respond "[AllMine] Upstream hook error: #{e}" rescue nil
next line
end
})
end

def self.remove_hooks
DownstreamHook.remove(DOWN_HOOK)
UpstreamHook.remove(UP_HOOK)
end

# ------------------------------------------------------------- watchdog

def self.watchdog_tick
sync_hook_state
noun = settings['noun']

# Track the id of a held item matching the noun, so a deploy can be
# attributed to the exact item that just left our hands.
[GameObj.right_hand, GameObj.left_hand].each do |h|
@last_held_id = h.id if h && h.id && h.noun == noun
end

# Pickup message seen by the downstream hook: confirm and clear.
if @pending_clear_at && deployed?
if settings['item_id'].nil? || item_in_hands?
clear_deployed('picked up')
return
elsif Time.now - @pending_clear_at > 3
@pending_clear_at = nil # pickup message was for a different item
end
end

# Complete a pending deploy: item should now appear in room loot.
if @pending_deploy_at
match = nil
if @last_held_id
match = GameObj.loot.to_a.find { |o| o.id == @last_held_id }
end
match ||= GameObj.loot.to_a.find { |o| o.noun == noun }
if match
@pending_deploy_at = nil
set_deployed(match.id)
elsif Time.now - @pending_deploy_at > 5
@pending_deploy_at = nil
set_deployed(nil) # deploy seen but id unresolved; guard by noun
end
return
end

unless deployed?
# Backup arm: an item we were holding (matching noun) is now on the
# ground - covers missed/unrecognized place messaging.
if @last_held_id && GameObj.loot.to_a.any? { |o| o.id == @last_held_id }
set_deployed(@last_held_id)
end
return
end

# Backup clear: item is back in our hands (missed pickup message).
if item_in_hands?
clear_deployed('back in your hands')
return
end

# Left-behind detection.
left_behind = false
here = (Room.current.id rescue nil)
if here && settings['room_id'] && here != settings['room_id']
left_behind = true
@loot_miss_count = 0
elsif !item_on_ground?
# Could be lag or an unmapped-room move; require persistence.
@loot_miss_count += 1
left_behind = true if @loot_miss_count >= 3
else
@loot_miss_count = 0
end

if left_behind && !settings['acked']
if Time.now - @last_alert_at >= ALERT_INTERVAL
@last_alert_at = Time.now
where = settings['room_id'] ? "room #{settings['room_id']} (;go2 #{settings['room_id']})" : 'an unknown room'
placed = settings['placed_at'] ? Time.at(settings['placed_at']).strftime('%H:%M') : '?'
bold "*** ALL MINE ALERT: Your #{settings['noun']} was left behind in #{where}, placed at #{placed}. Use ;allmine ack to silence this alert. ***"
end
end
end

# ------------------------------------------------------------- commands

def self.command(args)
case args
when /^set\s+(\w+)$/i
settings['noun'] = $1.downcase
info "Item noun set to '#{settings['noun']}'. If the monitor is already running, restart it so the message patterns rebuild."
when /^status$/i
info "Item noun: #{settings['noun'] || 'not set'}"
if deployed?
placed = settings['placed_at'] ? Time.at(settings['placed_at']).strftime('%Y-%m-%d %H:%M') : 'unknown'
info "Deployed: yes - item ID #{settings['item_id'] || 'unknown'}, room #{settings['room_id'] || 'unknown'}, placed at #{placed}"
else
info 'Deployed: no'
end
info "Movement block paused: #{settings['paused'] ? 'yes' : 'no'}"
info "Custom movement verbs: #{(settings['extra_verbs'] || []).empty? ? 'none' : settings['extra_verbs'].join(', ')}"
info "Monitor running: #{Script.list.count { |s| s.name == Script.current.name } > 1 ? 'yes' : 'no'}"
when /^arm$/i
noun = settings['noun']
if noun.nil?
caution 'No item noun configured. Use ;allmine set <noun> first.'
elsif (match = GameObj.loot.to_a.find { |o| o.noun == noun })
set_deployed(match.id)
else
caution "No #{noun} was found on the ground in this room."
end
when /^ack$/i
settings['acked'] = true
info 'Alert acknowledged. The deployed state remains until the item is recovered or cleared with ;allmine clear.'
when /^clear$/i
settings['deployed'] = false
settings['item_id'] = nil
settings['acked'] = false
info 'Deployed state cleared.'
when /^debug$/i
settings['debug'] = !settings['debug']
if settings['debug']
caution 'Debug mode ON - every upstream line will be echoed in raw form. Toggle off with ;allmine debug.'
else
info 'Debug mode off.'
end
when /^pause$/i
settings['paused'] = true
caution 'Movement block PAUSED. Watchdog alerts remain active.'
when /^resume$/i
settings['paused'] = false
info 'Movement block resumed.'
when /^verb\s+add\s+(\w+)$/i
settings['extra_verbs'] ||= []
v = $1.downcase
if settings['extra_verbs'].include?(v) || MOVE_VERBS.include?(v)
info "The verb '#{v}' is already blocked."
else
settings['extra_verbs'].push(v)
info "Added movement verb '#{v}'."
end
when /^verb\s+remove\s+(\w+)$/i
settings['extra_verbs'] ||= []
v = $1.downcase
if settings['extra_verbs'].delete(v)
info "Removed movement verb '#{v}'."
else
caution "The verb '#{v}' is not in the custom verb list."
end
else
info 'Usage: set <noun> | arm | status | ack | clear | pause | resume | debug | verb add <verb> | verb remove <verb>'
info "Blocked by default: #{DIRS.join(' ')} | #{MOVE_VERBS.join(' ')} | #{QUIT_CMDS.join(' ')}"
end
end

# ---------------------------------------------------------------- main

def self.run
unless settings['noun']
caution "No item noun configured. Use ;#{Script.current.name} set <noun> (for example, ;#{Script.current.name} set bowl)."
exit
end

if Script.list.count { |s| s.name == Script.current.name } > 1 && Script.current.vars[0].to_s.strip.empty?
caution 'The monitor is already running.'
exit
end

# Crash/disconnect recovery: stale deployed flag from a prior session.
if deployed?
where = settings['room_id'] ? "room #{settings['room_id']} (;go2 #{settings['room_id']})" : 'an unknown room'
placed = settings['placed_at'] ? Time.at(settings['placed_at']).strftime('%Y-%m-%d %H:%M') : 'an unknown time'
bold "*** ALL MINE: A prior session shows your #{settings['noun']} may still be on the ground in #{where}, placed at #{placed}. Use ;allmine clear if it has been recovered. ***"
end

before_dying {
AllMine.remove_hooks
if AllMine.deployed?
AllMine.bold "*** AllMine is exiting while your #{AllMine.settings['noun']} is still on the ground! ***"
end
}

sync_hook_state
install_hooks
info "Monitoring your #{settings['noun']}. The movement block is active with a #{BYPASS_WINDOW}-second re-send bypass, and the watchdog will alert (but never auto-return) if the item is left behind."

# Start-time arm: item matching the noun is already on the ground in
# this room (placed before the monitor started).
if !deployed? && (match = GameObj.loot.to_a.find { |o| o.noun == settings['noun'] })
set_deployed(match.id)
caution "Note: armed from a #{settings['noun']} already on the ground here. If it is not yours, use ;#{Script.current.name} clear."
end

loop {
watchdog_tick
sleep POLL_INTERVAL
}
end
end

if (args = Script.current.vars[0].to_s.strip) && !args.empty?
AllMine.command(args)
else
AllMine.run
end
</syntaxhighlight>

Lich:Script Alias

2026-06-30T16:19:39Z

HORIBU1: /* Alias examples */ add more examples

{{3rd-party}}
Alias is a default/core Lich scripted for creating in game shortcuts for any desired scripts or functions

==What does it do?==
Alias makes an alias!

==How do I get it?==
<CODE>;alias</CODE> is installed by default for Lich and no user installation should be necessary

==How does it work?==
Alias creates user shortcuts. If you have a common set scripts or don't want to type a long thing out, you can use the Alias script to create a shortened version for one or several combined commands. Think of if like a macro on steroids.
==Alias examples==
Below are examples of various aliases (one-liners) that are used to perform macros and/or Lich scripting:

{| class="wikitable"
|-
! trigger !! description !! target
|-
| wag1
| cast missing spells after dispelled
| <code><nowiki>;ewaggle --stop-at=1</nowiki></code>
|-
| ;wagglemax
| attempt to max cast all spells at self/target
| <code><nowiki>;eq Script.start("waggle", "--start-at=250 --stop-at=250 --stop-before=999 \?")</nowiki></code>
|-
| disband
| will DISBAND and immediately open GROUP again
| <code><nowiki>disband\rgroup open</nowiki></code>
|-
| leave
| will LEAVE group and immediately open GROUP status again
| <code><nowiki>leave\rgroup open</nowiki></code>
|-
| wear
| will WEAR the item you attempt and immediately try to SORT your inventory
| <code><nowiki>;eq fput("wear \?"); waitrt?; fput("sort auto headtotoe")</nowiki></code>
|-
| getbounty
| will run to advguild and get new bounty
| <code><nowiki>;e Script.run('go2', 'advguild');fput("ask ##{GameObj.npcs.last.id} for bounty")</nowiki></code>
|-
| groupall
| will attempt to GROUP every character in room into your group
| <code><nowiki>;e GameObj.pcs.each { |pc| fput "group #{pc.noun}" }</nowiki></code>
|-
| quitxp
| wait until empty mind, full health/mana/spirit before QUITing
| <code><nowiki>;e wait_until { Char.percent_mind.eql?(0) && Char.percent_health.eql?(100) && Char.percent_mana.eql?(100) && Char.percent_spirit.eql?(100)}; fput('quit')</nowiki></code>
|}

==In game help output==
<PRE>
;alias help

Usage:

;alias setup
Opens a window to configure aliases.
;alias add <trigger> = <target>
;alias add --global <trigger> = <target>
Creates a new alias. When you send a command that starts with <trigger>, it will be replaced
with <target>. If --global is specified, the alias will be active for all characters.
\r and \? in the target are treated special.

;alias remove <trigger>
;alias remove --global <trigger>
Deletes the given alias

;alias list
Lists the currently active aliases

Examples:

;alias add zap = ;eq cast(901, "\?")
;alias add --global ;code = ;lnet chat on code
;alias add --global ls = look
</PRE>
{{Third-Party Software}}

Lich:Script Alias

2026-06-30T16:15:37Z

HORIBU1: /* Alias examples */ fix formating

{{3rd-party}}
Alias is a default/core Lich scripted for creating in game shortcuts for any desired scripts or functions

==What does it do?==
Alias makes an alias!

==How do I get it?==
<CODE>;alias</CODE> is installed by default for Lich and no user installation should be necessary

==How does it work?==
Alias creates user shortcuts. If you have a common set scripts or don't want to type a long thing out, you can use the Alias script to create a shortened version for one or several combined commands. Think of if like a macro on steroids.
==Alias examples==
Below are examples of various aliases (one-liners) that are used to perform macros and/or Lich scripting:

{| class="wikitable"
|-
! trigger !! description !! target
|-
| wag1
| cast missing spells after dispelled
| <code><nowiki>;ewaggle --stop-at=1</nowiki></code>
|-
| disband
| will DISBAND and immediately open GROUP again
| <code><nowiki>disband\rgroup open</nowiki></code>
|-
| leave
| will LEAVE group and immediately open GROUP status again
| <code><nowiki>leave\rgroup open</nowiki></code>
|-
| wear
| will WEAR the item you attempt and immediately try to SORT your inventory
| <code><nowiki>;eq fput("wear \?"); waitrt?; fput("sort auto headtotoe")</nowiki></code>
|-
| getbounty
| will run to advguild and get new bounty
| <code><nowiki>;e Script.run('go2', 'advguild');fput("ask ##{GameObj.npcs.last.id} for bounty")</nowiki></code>
|-
| groupall
| will attempt to GROUP every character in room into your group
| <code><nowiki>;e GameObj.pcs.each { |pc| fput "group #{pc.noun}" }</nowiki></code>
|}

==In game help output==
<PRE>
;alias help

Usage:

;alias setup
Opens a window to configure aliases.
;alias add <trigger> = <target>
;alias add --global <trigger> = <target>
Creates a new alias. When you send a command that starts with <trigger>, it will be replaced
with <target>. If --global is specified, the alias will be active for all characters.
\r and \? in the target are treated special.

;alias remove <trigger>
;alias remove --global <trigger>
Deletes the given alias

;alias list
Lists the currently active aliases

Examples:

;alias add zap = ;eq cast(901, "\?")
;alias add --global ;code = ;lnet chat on code
;alias add --global ls = look
</PRE>
{{Third-Party Software}}

Lich:Script Alias

2026-06-30T16:11:53Z

HORIBU1: /* Alias examples */ update wear alias

{{3rd-party}}
Alias is a default/core Lich scripted for creating in game shortcuts for any desired scripts or functions

==What does it do?==
Alias makes an alias!

==How do I get it?==
<CODE>;alias</CODE> is installed by default for Lich and no user installation should be necessary

==How does it work?==
Alias creates user shortcuts. If you have a common set scripts or don't want to type a long thing out, you can use the Alias script to create a shortened version for one or several combined commands. Think of if like a macro on steroids.
==Alias examples==
Below are examples of various aliases (one-liners) that are used to perform macros and/or Lich scripting:

{| class="wikitable"
|-
! trigger !! description !! target
|-
| wag1
| cast missing spells after dispelled
| <code>;ewaggle --stop-at=1</code>
|-
| disband
| will DISBAND and immediately open GROUP again
| <code>disband\rgroup open</code>
|-
| leave
| will LEAVE group and immediately open GROUP status again
| <code>leave\rgroup open</code>
|-
| wear
| will WEAR the item you attempt and immediately try to SORT your inventory
| <code>;eq fput("wear \?"); waitrt?; fput("sort auto headtotoe")</code>
|-
| getbounty
| will run to advguild and get new bounty
| <code>;e Script.run('go2', 'advguild');fput("ask ##{GameObj.npcs.last.id} for bounty")</code>
|-
| groupall
| will attempt to GROUP every character in room into your group
| <code>;e GameObj.pcs.each { |pc| fput "group #{pc.noun}" }</code>
|}

==In game help output==
<PRE>
;alias help

Usage:

;alias setup
Opens a window to configure aliases.
;alias add <trigger> = <target>
;alias add --global <trigger> = <target>
Creates a new alias. When you send a command that starts with <trigger>, it will be replaced
with <target>. If --global is specified, the alias will be active for all characters.
\r and \? in the target are treated special.

;alias remove <trigger>
;alias remove --global <trigger>
Deletes the given alias

;alias list
Lists the currently active aliases

Examples:

;alias add zap = ;eq cast(901, "\?")
;alias add --global ;code = ;lnet chat on code
;alias add --global ls = look
</PRE>
{{Third-Party Software}}

Lich:Script Alias

2026-06-30T16:09:02Z

HORIBU1: /* Alias examples */ more examples

{{3rd-party}}
Alias is a default/core Lich scripted for creating in game shortcuts for any desired scripts or functions

==What does it do?==
Alias makes an alias!

==How do I get it?==
<CODE>;alias</CODE> is installed by default for Lich and no user installation should be necessary

==How does it work?==
Alias creates user shortcuts. If you have a common set scripts or don't want to type a long thing out, you can use the Alias script to create a shortened version for one or several combined commands. Think of if like a macro on steroids.
==Alias examples==
Below are examples of various aliases (one-liners) that are used to perform macros and/or Lich scripting:

{| class="wikitable"
|-
! trigger !! description !! target
|-
| wag1
| cast missing spells after dispelled
| <code>;ewaggle --stop-at=1</code>
|-
| disband
| will DISBAND and immediately open GROUP again
| <code>disband\rgroup open</code>
|-
| leave
| will LEAVE group and immediately open GROUP status again
| <code>leave\rgroup open</code>
|-
| wear
| will WEAR the item you attempt and immediately try to SORT your inventory
| <code>wear \?\rsort auto headtotoe</code>
|-
| getbounty
| will run to advguild and get new bounty
| <code>;e Script.run('go2', 'advguild');fput("ask ##{GameObj.npcs.last.id} for bounty")</code>
|-
| groupall
| will attempt to GROUP every character in room into your group
| <code>;e GameObj.pcs.each { |pc| fput "group #{pc.noun}" }</code>
|}

==In game help output==
<PRE>
;alias help

Usage:

;alias setup
Opens a window to configure aliases.
;alias add <trigger> = <target>
;alias add --global <trigger> = <target>
Creates a new alias. When you send a command that starts with <trigger>, it will be replaced
with <target>. If --global is specified, the alias will be active for all characters.
\r and \? in the target are treated special.

;alias remove <trigger>
;alias remove --global <trigger>
Deletes the given alias

;alias list
Lists the currently active aliases

Examples:

;alias add zap = ;eq cast(901, "\?")
;alias add --global ;code = ;lnet chat on code
;alias add --global ls = look
</PRE>
{{Third-Party Software}}