GemStone IV Wiki - User contributions [en]

Lich:Script Bigshot

2022-07-27T00:19:24Z

WHYARETHERENOUSERNAMES5: /* Command Checks */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot/Changelog|Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Quiet followers - Followers will wait until leader is done with both actions and resting scripts to begin using their own.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)
* Flee from webs - Enabling this check box will force Bigshot to flee from webs.
* Flee from voids- Enabling this check box will force Bigshot to flee from voids.

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]], Voln [[Symbol of Return]], [[Traveler's Song (1020)]], or [[Familiar Gate (930)]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails. Setting to Traveler's Song will attempt once and continue. Setting to Familiar Gate will attempt to summon a portal once and walk through it.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Delay looting - delays looting of creatures in a room.
* Pull players to feet - attempt to pull players to their feet upon passing them in a room
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game. (XML regex matching)
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])
* Activate weapon reactions - Will initiate reactive strikes when the opportunity presents itself

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** leech - Performs a [[Mana Leech (516)]] on target if cooldown is under 15 minutes.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force incant 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** dislodge <location> - Dislodge from location specified: dislodge eye neck
** stomp - Will perform a stomp attack. Channels 909 if not active. Can also add 909 to society abilities to keep it active.
** dhurl - Hurl your weapon and recovers it. Works with weapon bonding auto return and the recover verb.
** assume <aspect> <aspect/evoke> - Will cycle between two aspects, or evoke a single aspect. Also works in society ability box. "650 <aspect> <aspect/evoke>"
** briar <weapon> - activate the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
** stance perfection - Put 10, 20, 30, ect in your attack stance box to take advantage of stance perfection.

*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*frozen - Checks to see if target is not frozen. Performs command if target is not frozen. Broke out of prone check for archers against creatures that deflect ranged.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*tailwind - Checks for Tailwind buff from Breeze. (tailwind) (!tailwind)
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*justice - Checks for charges of Swift Justice. (justice) do skill with charges (!justice) do skill with no charges
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp
*censer - Attempt to cast 320 before your command checking mana and cooldown. 309(censer), 335(censer mob3), attack(censer)
**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.
**If command is not a spell, will only check you have enough mana for the censer.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Monitoring Tab==
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-07-27T00:18:13Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot/Changelog|Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Quiet followers - Followers will wait until leader is done with both actions and resting scripts to begin using their own.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)
* Flee from webs - Enabling this check box will force Bigshot to flee from webs.
* Flee from voids- Enabling this check box will force Bigshot to flee from voids.

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]], Voln [[Symbol of Return]], [[Traveler's Song (1020)]], or [[Familiar Gate (930)]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails. Setting to Traveler's Song will attempt once and continue. Setting to Familiar Gate will attempt to summon a portal once and walk through it.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Delay looting - delays looting of creatures in a room.
* Pull players to feet - attempt to pull players to their feet upon passing them in a room
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game. (XML regex matching)
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])
* Activate weapon reactions - Will initiate reactive strikes when the opportunity presents itself

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** leech - Performs a [[Mana Leech (516)]] on target if cooldown is under 15 minutes.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force incant 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** dislodge <location> - Dislodge from location specified: dislodge eye neck
** stomp - Will perform a stomp attack. Channels 909 if not active. Can also add 909 to society abilities to keep it active.
** dhurl - Hurl your weapon and recovers it. Works with weapon bonding auto return and the recover verb.
** assume <aspect> <aspect/evoke> - Will cycle between two aspects, or evoke a single aspect. Also works in society ability box. "650 <aspect> <aspect/evoke>"
** briar <weapon> - activate the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
** stance perfection - Put 10, 20, 30, ect in your attack stance box to take advantage of stance perfection.

*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*tailwind - Checks for Tailwind buff from Breeze. (tailwind) (!tailwind)
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*justice - Checks for charges of Swift Justice. (justice) do skill with charges (!justice) do skill with no charges
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp
*censer - Attempt to cast 320 before your command checking mana and cooldown. 309(censer), 335(censer mob3), attack(censer)
**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.
**If command is not a spell, will only check you have enough mana for the censer.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Monitoring Tab==
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Compartmentalized quiver

2022-07-16T03:44:28Z

WHYARETHERENOUSERNAMES5: /* Flare/Material/Status Messaging */

<table><tr valign="top"><td>
'''Compartment quivers''' were initially released during [[Duskruin Arena| December 2018 Duskruin Arena]] and sold at [[:BVShop:Bundle_Up|Bundle Up]] to assist with ammo handling prior to the archery updates. The concept was designed and delivered by '''GM Avaluka'''.
{{TOC limit|2}}
==Analyze==
Below is the base {{boldmono|ANALYZE}} for compartment quivers. Additional information found in the {{boldmono|ANALYZE}} as part of tier unlocks can be found beneath each additional tier.
<pre{{log2}}>
You analyze your quiver and sense that the creator has provided the following information:
~Compartmentalized Quiver~
Compartmentalized quivers keep your ammo collection neat, tidy, and all in one place!
~General Script Info~
* Once unlocked, these quivers gain access to weightless extra compartments to store ammo bundles.
* Only the currently selected compartment's contents will count towards encumbrance.
* Each compartment only holds 1 bundle.
* Use READY AMMO on the quiver itself and it will use whichever bundle is in the current compartment when you FIRE.
* Quivers can be shoulder, belt, or thigh-worn.
~Alteration Guidelines~
* Alterations to the 15/15/15 and long description are fine, though shows are not possible.
* Quivers <span style="color:blue">MUST</span> be made of metal and have the noun 'quiver'.
* You may <span style="color:blue">NOT</span> describe the quiver's wear location, such as using the words belt or thigh.
~Unlock Status~
This quiver is currently off-the-shelf (Tier 1 of 3).
At this tier, you have access to the verbs: RUB, CLEAN, GET, DROP/PUT.
~Features~
* Nothing special - it's pretty plain right now!
~Custom Description~
Your quiver's article is currently set to a/an .
Your quiver currently does not have a custom long description.
This quiver cannot be lightened or deepened.
</pre>
{{itemtier
|tier= Tier 1
|itemsummary=
|analyze=
|inspect= The quiver appears to be made of metal. It looks like it would be best worn attached to a thigh. It looks to have only a single compartment inside.
|affinity= 
|itemverbtable=
}} <h4>Shoulder-worn</h4>
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! RUB
| You rest your right hand on top of the quiver at your shoulder, your tempest grey eyes alert for threats.
| XXX rests her right hand on top of the quiver at her shoulder, her tempest grey eyes alert for threats.
|-
! CLEAN
| Slinging your quiver from your shoulder, you fastidiously wipe down its metal surface, removing any lingering dirt. Satisfied, you sling your quiver back over your shoulder in one smooth motion.
| Slinging her quiver from her shoulder, XXX fastidiously wipes down its metal surface, removing any lingering dirt. Satisfied, XXX slings her quiver back over her shoulder in one smooth motion.
|-
! GET
| Reaching toward the quiver at your shoulder, you slide out a bundle of arrows in one smooth motion.
| Moving smoothly, XXX reaches toward the quiver at her shoulder and slides a bundle of arrows inside it.
|-
! PUT
| Moving smoothly, you reach toward the quiver at your shoulder and slide a bundle of arrows inside it.
| Moving smoothly, XXX reaches toward the quiver at her shoulder and slides a bundle of arrows inside it.
|}
====Belt-worn====
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! RUB
| You rest your right hand on the arrows inside the quiver at your belt, your tempest grey eyes alert for threats.
| XXX rests her right hand on the arrows inside the quiver at her belt, her tempest grey eyes alert for threats.
|-
! CLEAN
| Detaching your quiver from your belt, you fastidiously wipe down its metal surface, removing any lingering dirt. Satisfied, you re-attach your quiver to your belt.
| Detaching her quiver from her belt, XXX fastidiously wipes down its metal surface, removing any lingering dirt. Satisfied, XXX re-attaches her quiver to her belt.
|-
! GET
| Reaching toward the quiver at your belt, you slide out a bundle of arrows in one smooth motion.
| Reaching toward the quiver at her belt, XXX slides out a bundle of arrows in one smooth motion.
|-
! PUT
| Moving smoothly, you reach toward the quiver at your belt and slide a bundle of arrows inside it.
| Moving smoothly, XXX reaches toward the quiver at her belt and slides a bundle of arrows inside it.
|}
====Thigh-worn====
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! RUB
| You rest your right hand on the arrows inside the quiver at your thigh, your tempest grey eyes alert for threats.
| XXX rests her right hand on the arrows inside the quiver at her thigh, her tempest grey eyes alert for threats.
|-
! CLEAN
| Unstrapping your quiver from your thigh, you fastidiously wipe down its metal surface, removing any lingering dirt. Satisfied, you re-strap your quiver to your thigh.
| Unstrapping her quiver from her thigh, XXX fastidiously wipes down its metal surface, removing any lingering dirt. Satisfied, XXX re-straps her quiver to her thigh.
|-
! GET
| Reaching toward the quiver strapped to your thigh, you slide out a bundle of arrows in one smooth motion.
| Reaching toward the quiver strapped to her thigh, XXX slides out a bundle of arrows in one smooth motion.
|-
! PUT
| Moving smoothly, you reach toward the quiver strapped to your thigh and slide a bundle of arrows inside it.
| Moving smoothly, XXX reaches toward the quiver strapped to her thigh and slides a bundle of arrows inside it.
|}
{{itemtier 
|tier= Tier 2
|itemsummary= At Tier 2, compartment quivers are able to have additional compartments unlocked via certificate, up to a total of 4. Additional ammo will be weightless, and you will fire automatically from the current compartment.
|analyze= ~Unlock Status~
This quiver is currently unlocked once (Tier 2 of 3).
At this tier, you have access to the verbs: RUB, CLEAN, GET, DROP/PUT, NUDGE, TINKER, TURN, TOUCH.
You can use INSPECT to see the configuration of the compartments and their contents.
~Features~
* Weightless Compartments
Extra compartments for this quiver will hold ammo weightlessly.
This quiver currently has a total of 2 compartments out of a maximum of 4.
- TURN the quiver to switch compartments, as only the current one will let you use the ammo.
- The quiver will automatically use the ammo in the current compartment when FIREing.
* Ammo Display
Use TOUCH to toggle including the current ammo in the quiver's description.
~Custom Description~
Your quiver's article is currently set to a/an .
Your quiver currently does not have a custom long description.
This quiver cannot be lightened or deepened.
|inspect=The quiver appears to be made of metal. It looks like it would be best worn attached to a thigh. It looks to have 2 compartments inside with the following configuration:
<span style="color:blue">*1.* a bundle of arrows (a wooden arrow) [Current] [--DEFAULT--]</span>
2. Empty
Type TURN quiver TO # to turn to a specific compartment.
|affinity= 
|itemverbtable= yes
}}
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! rowspan="3" | NUDGE
| '''Shoulder:'''<br>You roll your shoulders to loosen them, causing your quiver to shift slightly against its straps. In one smooth motion, you draw out partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, you slide it back into place.
| XXX rolls her shoulders to loosen them, the movement causing her quiver to shift against its straps. In one smooth motion, she draws partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, XXX slides it back into place.
|-
| '''Belt:'''<br>Stretching to one side, you pause to adjust the quiver at your belt, shifting it to rest against your other hip. In one smooth motion, you draw out a wooden arrow partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, you slide it back into place.
| Stretching to one side, XXX pauses to adjust the quiver at her belt, shifting it to rest against her other hip. In one smooth motion, she draws a wooden arrow partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, XXX slides it back into place.
|-
| '''Thigh:'''<br>Extending one leg forward in a limber stretch, you pause to adjust the quiver strapped to your thigh, settling it more securely in place. In one smooth motion, you draw out a wooden arrow partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, you slide it back into place.
| Extending one leg forward in a limber stretch, XXX pauses to adjust the quiver strapped to her thigh, settling it more securely in place. In one smooth motion, she draws a wooden arrow partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, XXX slides it back into place.
|-
! TINKER
| Taking a firm grip on the glaesine top of your quiver, you give it a hard spin, letting it twirl with a rhythmic set of clicks and whirs. As it slows to a stop, you cock one ear to the side to listen to the mechanical noises, frowning in concentration. You shake your head in bewilderment, unable to really tell much from the noises other than it's working as intended.
| Taking a firm grip on the glaesine top of her quiver, XXX gives it a hard spin, letting it twirl with a rhythmic set of clicks and whirs. As it slows to a stop, she cocks one ear to the side to listen to the mechanical noises, frowning in concentration. XXX shakes her head in bewilderment, apparently not hearing anything out of the ordinary.
|-
! TURN
| Several clicks sound as you rotate the glaesine top of your quiver, turning to the next compartment.<br>As the new compartment clicks into place, you can see that it's empty.<br>As the new compartment clicks into place, a bundle of arrows can be seen nestled within.
| Several clicks sound as XXX rotates the glaesine top of her quiver, turning to the next compartment.
|-
! TOUCH
| You run your hand along the base of your quiver and depress the bottom inward, ensuring that a portion of any ammo inside will show above the rim. The quiver gives a satisfying *click* noise.
| XXX runs her hand along the base of her quiver and depresses the bottom inward, ensuring any ammo inside will show above the rim. The quiver gives a satisfying *click* noise.
|}
{{itemtier 
|itemsummary= At tier 3, additional compartments can be unlocked by certificate, up to a total of 6, and each compartment can be attuned to a specific creature. The quiver can be fed gems to assist with a creature bane affect.
Flares can be displayed.
|tier= Tier 3
|analyze= ~Unlock Status~
This quiver is currently fully unlocked (Tier 3 of 3).
At this tier, you have access to the verbs: RUB, CLEAN, GET, DROP/PUT, NUDGE, TINKER, TURN, TOUCH, POINT, PINCH, SPIN, PUSH, PROD.
You can use INSPECT to see the configuration of the compartments and their contents.
~Features~
* Weightless Compartments
Extra compartments for this quiver will hold ammo weightlessly.
This quiver currently has a total of 2 compartments out of a maximum of 6.
- TURN the quiver to switch compartments, as only the current one will let you use the ammo.
- The quiver will automatically use the ammo in the current compartment when FIREing.
* Ammo Display
Use TOUCH to toggle including the current ammo in the quiver's description.
* Creature Attunement
Each compartment can be attuned to a specific creature, or fine-tuned to focus on a general feature of that foe.
When you FIRE, the quiver will automatically switch to the ammo you have attuned to that creature, or the closest match.
You can set a default compartment as a fallback for foes you haven't attuned.
- POINT the quiver at a foe to attune it.
- SPIN the quiver to fine-tune the focus, such as focusing only on undead or trolls.
- PINCH the quiver to clear that compartment's attunement.
- POINT at the quiver to set a default compartment.
* Creature Bane
Feed the quiver gems to power a bane effect.
Each compartment can have its own bane and charges, and it is based off of the attunement set with POINT.
- Use PUSH to feed any gem, with more valuable gems giving more charges.
* Flare Display
Use PROD to toggle a special description based on the ammo's properties.
~Custom Description~
Your quiver's article is currently set to a/an .
Your quiver currently does not have a custom long description.

|affinity= 
|itemverbtable= yes
}}
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! rowspan="2" | POINT
| Reaching to the side of the dial of your quiver's current compartment, you flip a lever into place, ensuring the mechanism will stop there as a default.
| XXX fiddles with something on the side of her quiver.
|-
| ''At Creature'':<br>Focusing intently on a greater burrow orc, you fiddle with the dial on your ora quiver, attuning it to a new setting. You are pretty sure it will now be attuned to a greater burrow orc, though likely spinning the dial can narrow the focus.<br>Roundtime: 5 sec.
| Focusing intently on a greater burrow orc, XXX fiddles with something on his ora quiver.
|-
! PINCH
| With a deft spin, you twirl the dial of your quiver's current compartment, clearing any attunement it may have had.
| XXX deftly spins a dial on her quiver, causing a chorus of clicking noises.
|-
! rowspan="2" | SPIN
| How are you expecting to adjust the focus of that compartment when it is not even attuned to anything?
| rowspan="2" | N/A
|-
| ''When Attuned'': Narrowing your blue-green eyes in concentration, you slightly twist the dial for the current compartment of your ora quiver, minutely adjusting the focus of the attunement. You are pretty sure it will now focus on Orcs.
|-
! rowspan="2" | PUSH
| You need a gem in your right or left hand to push into the quiver's slot.
| N/A
|-
| ''With gem in hand'': Reaching forward, you press an uncut diamond into the gem slot at the base of your ora quiver's current compartment. The gem vibrates slightly as it settles in place and a low hum builds. A bright flash erupts from the quiver before it falls silent.
| Reaching forward, XXX presses an uncut diamond into the gem slot at the base of his ora quiver's current compartment. The gem vibrates slightly as it settles into place and a low hum builds. A bright flash erupts from the quiver before it falls silent.
|-
! PROD
| You depress a cleverly hidden button on the side of your quiver. A subtle humming noise starts up accompanied by a whir of gears.<br>With a crackling and splintering sound, a latticework of wood weaves itself around the quiver.
| XXX depresses a cleverly hidden button on the side of her quiver. A subtle humming noise starts up accompanied by a whir of gears.<br>With a crackling and splintering sound, a latticework of wood weaves itself around the quiver.
|}
{{itemtier 
|tier= Wear Unlock
|itemsummary= This a separate feature unlock available through a certificate and allows the quiver to be swappable between worn locations (shoulder, belt, thigh). This can be unlocked starting at the first tier.
|analyze= 
|affinity= 
|itemverbtable= yes
}}
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! rowspan=3 | FOLD
| With a deft hand, you adjust the straps on the back of your quiver, looping them around to allow it to hang from a belt.
| With a deft hand, XXX adjusts the straps on the back of her quiver, looping them around to allow it to hang from a belt.
|-
| With a deft hand, you adjust the straps on the back of your quiver, looping them into a round noose to let it be strapped to a thigh.
| With a deft hand, XXX adjusts the straps on the back of her quiver, looping them into a round noose to let it be strapped to a thigh.
|-
| With a deft hand, you adjust the straps on the back of your quiver, lengthening them so it can be easily slung over a shoulder.
| With a deft hand, XXX adjusts the straps on the back of her quiver, lengthening them so it can be easily slung over a shoulder.
|-
! rowspan=9 | PULL
| You tug at the straps of your quiver, adjusting the fit where it is slung over your shoulder. You feel people will be better able to tell where you are wearing your quiver now.
| rowspan="2" | XXX tugs at the straps of her quiver, adjusting the fit where it is slung over her shoulder.
|-
| You tug at the straps of your quiver, adjusting the fit where it is slung over your shoulder. You feel people will be less able to tell where you are wearing your quiver now.
|-
| colspan="2" style="text-align: center" | '''''a quiver poking above one shoulder'''''
|-
| You tug at the straps of your quiver, adjusting the fit where it hangs from your belt. You feel people will be better able to tell where you are wearing your quiver now.
| rowspan="2" | XXX tugs at the straps of her quiver, adjusting the fit where it hangs from XXX belt.
|-
| You tug at the straps of your quiver, adjusting the fit where it hangs from your belt. You feel people will be less able to tell where you are wearing your quiver now.
|-
| colspan="2" style="text-align: center" | '''''a quiver hanging from a belt loop'''''
|-
| You tug at the straps of your quiver, adjusting the fit where it is strapped to your thigh. You feel people will be better able to tell where you are wearing your quiver now.
| rowspan="2"| XXX tugs at the straps of her quiver, adjusting the fit where it is strapped to her thigh.
|-
| You tug at the straps of your quiver, adjusting the fit where it is strapped to your thigh. You feel people will be less able to tell where you are wearing your quiver now.
|-
| colspan="2" style="text-align: center" | '''''a quiver strapped to one thigh'''''
|}
==Additional Information==
===Flare/Material/Status Messaging===
Each flare type, as well as material if the ammo does not have a flare (wood, metal or bone), or blessed status results in a different long description for the quiver plus different messages for the various verbs.

*Acid - a corroded faenor quiver covered in an intricate pattern of acid stains
*Bless - a gleaming faenor quiver surrounded by a brilliant white glow
*Cold - an icy faenor quiver covered in a thin layer of glittering frost
*Disruption - a distorted faenor quiver surrounded by an indistinct haze
*Disintegration - a dull faenor quiver with several semi-transparent patches
*Electricity - a blackened faenor quiver surrounded by a corona of bright blue energy
*Fire - a singed faenor quiver wreathed in a halo of flickering flames
*Grapple - a twisted golvern quiver decorated with a spiralling pattern
*Impact - a warped faenor quiver covered in several dents
*Steam - a shiny faenor quiver wreathed in a cloud of steam
*Unbalance - an angular faenor quiver etched with a design of interlocking geometric shapes
*Vacuum - a smooth faenor quiver encased in a layer of void black energy

*Bone - a weathered golvern quiver decorated with various small bones
*Wood - a moss-covered faenor quiver braced with a latticework of wood (wood,faewood,glowbark,fireleaf,wyrwood,ect)

==Resources==
* [[/saved posts | Saved posts]]
* [[Ranged_Weapons| Ranged Weapons]]
* [[Art of the Bow (guide)]]
* [[Fletching]]

</td><td>
{{iteminfo
|type= Mechanical 
|type2= 
|itemclass= Container
|itemtype= Quiver 
|itemtype2=
|itemtype3=
|itemtype4=
|itemtype5=
|itemtype6=
|itemtype7=
|itemtype8=
|alter= Yes, Base and LONG only.
|ld= No 
|feature= 
|feature2=
|feature3=
|feature4=
|feature5=
|feature6=
|feature7=
|feature8=
|customize= 
|custom= 
|custom2=
|custom3=
|custom4=
|custom5=
|origmerch= 
|releasevenue= Duskruin Arena
|tiered= Yes 
|tiersnumber= 3 
|unlock= Automated unlocking certificate 
|unlock2=
|auction= 
|demeanor= 
|loresong= 
|attune= 
|attunement= 
|affinity= 
|hideable= 
|hide= 
|spell= 
|spell2=
|spell3=
|spell4=
|enhancive= 
|swap= 
|add= 
|restrictions= Cannot be altered with a SHOW.<br>Must be metal.<br>Tier 2 and up need a minimum of 2 compartments.
}}
{{itemverb
|verb= RUB
|verb2= CLEAN
|verb3= GET
|verb4= PUT
|verb5= NUDGE
|verb6= TINKER
|verb7= TURN
|verb8= TOUCH
|verb9= POINT
|verb10= PINCH
|verb11= SPIN
|verb12= PUSH
|verb13= PROD
|verb14=
|verb15=
|verb16=
|verb17=
|verb18=
|verb19=
|verb20=
|verb21=
|verb22=
|verb23=
|verb24=
|verb25=
|verb26=
}}
</td></tr></table>

Compartmentalized quiver

2022-07-16T03:30:15Z

WHYARETHERENOUSERNAMES5: /* Flare/Material/Status Messaging */

<table><tr valign="top"><td>
'''Compartment quivers''' were initially released during [[Duskruin Arena| December 2018 Duskruin Arena]] and sold at [[:BVShop:Bundle_Up|Bundle Up]] to assist with ammo handling prior to the archery updates. The concept was designed and delivered by '''GM Avaluka'''.
{{TOC limit|2}}
==Analyze==
Below is the base {{boldmono|ANALYZE}} for compartment quivers. Additional information found in the {{boldmono|ANALYZE}} as part of tier unlocks can be found beneath each additional tier.
<pre{{log2}}>
You analyze your quiver and sense that the creator has provided the following information:
~Compartmentalized Quiver~
Compartmentalized quivers keep your ammo collection neat, tidy, and all in one place!
~General Script Info~
* Once unlocked, these quivers gain access to weightless extra compartments to store ammo bundles.
* Only the currently selected compartment's contents will count towards encumbrance.
* Each compartment only holds 1 bundle.
* Use READY AMMO on the quiver itself and it will use whichever bundle is in the current compartment when you FIRE.
* Quivers can be shoulder, belt, or thigh-worn.
~Alteration Guidelines~
* Alterations to the 15/15/15 and long description are fine, though shows are not possible.
* Quivers <span style="color:blue">MUST</span> be made of metal and have the noun 'quiver'.
* You may <span style="color:blue">NOT</span> describe the quiver's wear location, such as using the words belt or thigh.
~Unlock Status~
This quiver is currently off-the-shelf (Tier 1 of 3).
At this tier, you have access to the verbs: RUB, CLEAN, GET, DROP/PUT.
~Features~
* Nothing special - it's pretty plain right now!
~Custom Description~
Your quiver's article is currently set to a/an .
Your quiver currently does not have a custom long description.
This quiver cannot be lightened or deepened.
</pre>
{{itemtier
|tier= Tier 1
|itemsummary=
|analyze=
|inspect= The quiver appears to be made of metal. It looks like it would be best worn attached to a thigh. It looks to have only a single compartment inside.
|affinity= 
|itemverbtable=
}} <h4>Shoulder-worn</h4>
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! RUB
| You rest your right hand on top of the quiver at your shoulder, your tempest grey eyes alert for threats.
| XXX rests her right hand on top of the quiver at her shoulder, her tempest grey eyes alert for threats.
|-
! CLEAN
| Slinging your quiver from your shoulder, you fastidiously wipe down its metal surface, removing any lingering dirt. Satisfied, you sling your quiver back over your shoulder in one smooth motion.
| Slinging her quiver from her shoulder, XXX fastidiously wipes down its metal surface, removing any lingering dirt. Satisfied, XXX slings her quiver back over her shoulder in one smooth motion.
|-
! GET
| Reaching toward the quiver at your shoulder, you slide out a bundle of arrows in one smooth motion.
| Moving smoothly, XXX reaches toward the quiver at her shoulder and slides a bundle of arrows inside it.
|-
! PUT
| Moving smoothly, you reach toward the quiver at your shoulder and slide a bundle of arrows inside it.
| Moving smoothly, XXX reaches toward the quiver at her shoulder and slides a bundle of arrows inside it.
|}
====Belt-worn====
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! RUB
| You rest your right hand on the arrows inside the quiver at your belt, your tempest grey eyes alert for threats.
| XXX rests her right hand on the arrows inside the quiver at her belt, her tempest grey eyes alert for threats.
|-
! CLEAN
| Detaching your quiver from your belt, you fastidiously wipe down its metal surface, removing any lingering dirt. Satisfied, you re-attach your quiver to your belt.
| Detaching her quiver from her belt, XXX fastidiously wipes down its metal surface, removing any lingering dirt. Satisfied, XXX re-attaches her quiver to her belt.
|-
! GET
| Reaching toward the quiver at your belt, you slide out a bundle of arrows in one smooth motion.
| Reaching toward the quiver at her belt, XXX slides out a bundle of arrows in one smooth motion.
|-
! PUT
| Moving smoothly, you reach toward the quiver at your belt and slide a bundle of arrows inside it.
| Moving smoothly, XXX reaches toward the quiver at her belt and slides a bundle of arrows inside it.
|}
====Thigh-worn====
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! RUB
| You rest your right hand on the arrows inside the quiver at your thigh, your tempest grey eyes alert for threats.
| XXX rests her right hand on the arrows inside the quiver at her thigh, her tempest grey eyes alert for threats.
|-
! CLEAN
| Unstrapping your quiver from your thigh, you fastidiously wipe down its metal surface, removing any lingering dirt. Satisfied, you re-strap your quiver to your thigh.
| Unstrapping her quiver from her thigh, XXX fastidiously wipes down its metal surface, removing any lingering dirt. Satisfied, XXX re-straps her quiver to her thigh.
|-
! GET
| Reaching toward the quiver strapped to your thigh, you slide out a bundle of arrows in one smooth motion.
| Reaching toward the quiver strapped to her thigh, XXX slides out a bundle of arrows in one smooth motion.
|-
! PUT
| Moving smoothly, you reach toward the quiver strapped to your thigh and slide a bundle of arrows inside it.
| Moving smoothly, XXX reaches toward the quiver strapped to her thigh and slides a bundle of arrows inside it.
|}
{{itemtier 
|tier= Tier 2
|itemsummary= At Tier 2, compartment quivers are able to have additional compartments unlocked via certificate, up to a total of 4. Additional ammo will be weightless, and you will fire automatically from the current compartment.
|analyze= ~Unlock Status~
This quiver is currently unlocked once (Tier 2 of 3).
At this tier, you have access to the verbs: RUB, CLEAN, GET, DROP/PUT, NUDGE, TINKER, TURN, TOUCH.
You can use INSPECT to see the configuration of the compartments and their contents.
~Features~
* Weightless Compartments
Extra compartments for this quiver will hold ammo weightlessly.
This quiver currently has a total of 2 compartments out of a maximum of 4.
- TURN the quiver to switch compartments, as only the current one will let you use the ammo.
- The quiver will automatically use the ammo in the current compartment when FIREing.
* Ammo Display
Use TOUCH to toggle including the current ammo in the quiver's description.
~Custom Description~
Your quiver's article is currently set to a/an .
Your quiver currently does not have a custom long description.
This quiver cannot be lightened or deepened.
|inspect=The quiver appears to be made of metal. It looks like it would be best worn attached to a thigh. It looks to have 2 compartments inside with the following configuration:
<span style="color:blue">*1.* a bundle of arrows (a wooden arrow) [Current] [--DEFAULT--]</span>
2. Empty
Type TURN quiver TO # to turn to a specific compartment.
|affinity= 
|itemverbtable= yes
}}
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! rowspan="3" | NUDGE
| '''Shoulder:'''<br>You roll your shoulders to loosen them, causing your quiver to shift slightly against its straps. In one smooth motion, you draw out partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, you slide it back into place.
| XXX rolls her shoulders to loosen them, the movement causing her quiver to shift against its straps. In one smooth motion, she draws partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, XXX slides it back into place.
|-
| '''Belt:'''<br>Stretching to one side, you pause to adjust the quiver at your belt, shifting it to rest against your other hip. In one smooth motion, you draw out a wooden arrow partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, you slide it back into place.
| Stretching to one side, XXX pauses to adjust the quiver at her belt, shifting it to rest against her other hip. In one smooth motion, she draws a wooden arrow partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, XXX slides it back into place.
|-
| '''Thigh:'''<br>Extending one leg forward in a limber stretch, you pause to adjust the quiver strapped to your thigh, settling it more securely in place. In one smooth motion, you draw out a wooden arrow partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, you slide it back into place.
| Extending one leg forward in a limber stretch, XXX pauses to adjust the quiver strapped to her thigh, settling it more securely in place. In one smooth motion, she draws a wooden arrow partway from a bundle of arrows in the quiver, testing the ease of movement. With a nod of satisfaction, XXX slides it back into place.
|-
! TINKER
| Taking a firm grip on the glaesine top of your quiver, you give it a hard spin, letting it twirl with a rhythmic set of clicks and whirs. As it slows to a stop, you cock one ear to the side to listen to the mechanical noises, frowning in concentration. You shake your head in bewilderment, unable to really tell much from the noises other than it's working as intended.
| Taking a firm grip on the glaesine top of her quiver, XXX gives it a hard spin, letting it twirl with a rhythmic set of clicks and whirs. As it slows to a stop, she cocks one ear to the side to listen to the mechanical noises, frowning in concentration. XXX shakes her head in bewilderment, apparently not hearing anything out of the ordinary.
|-
! TURN
| Several clicks sound as you rotate the glaesine top of your quiver, turning to the next compartment.<br>As the new compartment clicks into place, you can see that it's empty.<br>As the new compartment clicks into place, a bundle of arrows can be seen nestled within.
| Several clicks sound as XXX rotates the glaesine top of her quiver, turning to the next compartment.
|-
! TOUCH
| You run your hand along the base of your quiver and depress the bottom inward, ensuring that a portion of any ammo inside will show above the rim. The quiver gives a satisfying *click* noise.
| XXX runs her hand along the base of her quiver and depresses the bottom inward, ensuring any ammo inside will show above the rim. The quiver gives a satisfying *click* noise.
|}
{{itemtier 
|itemsummary= At tier 3, additional compartments can be unlocked by certificate, up to a total of 6, and each compartment can be attuned to a specific creature. The quiver can be fed gems to assist with a creature bane affect.
Flares can be displayed.
|tier= Tier 3
|analyze= ~Unlock Status~
This quiver is currently fully unlocked (Tier 3 of 3).
At this tier, you have access to the verbs: RUB, CLEAN, GET, DROP/PUT, NUDGE, TINKER, TURN, TOUCH, POINT, PINCH, SPIN, PUSH, PROD.
You can use INSPECT to see the configuration of the compartments and their contents.
~Features~
* Weightless Compartments
Extra compartments for this quiver will hold ammo weightlessly.
This quiver currently has a total of 2 compartments out of a maximum of 6.
- TURN the quiver to switch compartments, as only the current one will let you use the ammo.
- The quiver will automatically use the ammo in the current compartment when FIREing.
* Ammo Display
Use TOUCH to toggle including the current ammo in the quiver's description.
* Creature Attunement
Each compartment can be attuned to a specific creature, or fine-tuned to focus on a general feature of that foe.
When you FIRE, the quiver will automatically switch to the ammo you have attuned to that creature, or the closest match.
You can set a default compartment as a fallback for foes you haven't attuned.
- POINT the quiver at a foe to attune it.
- SPIN the quiver to fine-tune the focus, such as focusing only on undead or trolls.
- PINCH the quiver to clear that compartment's attunement.
- POINT at the quiver to set a default compartment.
* Creature Bane
Feed the quiver gems to power a bane effect.
Each compartment can have its own bane and charges, and it is based off of the attunement set with POINT.
- Use PUSH to feed any gem, with more valuable gems giving more charges.
* Flare Display
Use PROD to toggle a special description based on the ammo's properties.
~Custom Description~
Your quiver's article is currently set to a/an .
Your quiver currently does not have a custom long description.

|affinity= 
|itemverbtable= yes
}}
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! rowspan="2" | POINT
| Reaching to the side of the dial of your quiver's current compartment, you flip a lever into place, ensuring the mechanism will stop there as a default.
| XXX fiddles with something on the side of her quiver.
|-
| ''At Creature'':<br>Focusing intently on a greater burrow orc, you fiddle with the dial on your ora quiver, attuning it to a new setting. You are pretty sure it will now be attuned to a greater burrow orc, though likely spinning the dial can narrow the focus.<br>Roundtime: 5 sec.
| Focusing intently on a greater burrow orc, XXX fiddles with something on his ora quiver.
|-
! PINCH
| With a deft spin, you twirl the dial of your quiver's current compartment, clearing any attunement it may have had.
| XXX deftly spins a dial on her quiver, causing a chorus of clicking noises.
|-
! rowspan="2" | SPIN
| How are you expecting to adjust the focus of that compartment when it is not even attuned to anything?
| rowspan="2" | N/A
|-
| ''When Attuned'': Narrowing your blue-green eyes in concentration, you slightly twist the dial for the current compartment of your ora quiver, minutely adjusting the focus of the attunement. You are pretty sure it will now focus on Orcs.
|-
! rowspan="2" | PUSH
| You need a gem in your right or left hand to push into the quiver's slot.
| N/A
|-
| ''With gem in hand'': Reaching forward, you press an uncut diamond into the gem slot at the base of your ora quiver's current compartment. The gem vibrates slightly as it settles in place and a low hum builds. A bright flash erupts from the quiver before it falls silent.
| Reaching forward, XXX presses an uncut diamond into the gem slot at the base of his ora quiver's current compartment. The gem vibrates slightly as it settles into place and a low hum builds. A bright flash erupts from the quiver before it falls silent.
|-
! PROD
| You depress a cleverly hidden button on the side of your quiver. A subtle humming noise starts up accompanied by a whir of gears.<br>With a crackling and splintering sound, a latticework of wood weaves itself around the quiver.
| XXX depresses a cleverly hidden button on the side of her quiver. A subtle humming noise starts up accompanied by a whir of gears.<br>With a crackling and splintering sound, a latticework of wood weaves itself around the quiver.
|}
{{itemtier 
|tier= Wear Unlock
|itemsummary= This a separate feature unlock available through a certificate and allows the quiver to be swappable between worn locations (shoulder, belt, thigh). This can be unlocked starting at the first tier.
|analyze= 
|affinity= 
|itemverbtable= yes
}}
{| {{verbtable}}
|- {{verbtableheader}}
! style="width:5em;"|Verb
! style="width:35em;"|First
! style="width:35em;"|Third
|-
! rowspan=3 | FOLD
| With a deft hand, you adjust the straps on the back of your quiver, looping them around to allow it to hang from a belt.
| With a deft hand, XXX adjusts the straps on the back of her quiver, looping them around to allow it to hang from a belt.
|-
| With a deft hand, you adjust the straps on the back of your quiver, looping them into a round noose to let it be strapped to a thigh.
| With a deft hand, XXX adjusts the straps on the back of her quiver, looping them into a round noose to let it be strapped to a thigh.
|-
| With a deft hand, you adjust the straps on the back of your quiver, lengthening them so it can be easily slung over a shoulder.
| With a deft hand, XXX adjusts the straps on the back of her quiver, lengthening them so it can be easily slung over a shoulder.
|-
! rowspan=9 | PULL
| You tug at the straps of your quiver, adjusting the fit where it is slung over your shoulder. You feel people will be better able to tell where you are wearing your quiver now.
| rowspan="2" | XXX tugs at the straps of her quiver, adjusting the fit where it is slung over her shoulder.
|-
| You tug at the straps of your quiver, adjusting the fit where it is slung over your shoulder. You feel people will be less able to tell where you are wearing your quiver now.
|-
| colspan="2" style="text-align: center" | '''''a quiver poking above one shoulder'''''
|-
| You tug at the straps of your quiver, adjusting the fit where it hangs from your belt. You feel people will be better able to tell where you are wearing your quiver now.
| rowspan="2" | XXX tugs at the straps of her quiver, adjusting the fit where it hangs from XXX belt.
|-
| You tug at the straps of your quiver, adjusting the fit where it hangs from your belt. You feel people will be less able to tell where you are wearing your quiver now.
|-
| colspan="2" style="text-align: center" | '''''a quiver hanging from a belt loop'''''
|-
| You tug at the straps of your quiver, adjusting the fit where it is strapped to your thigh. You feel people will be better able to tell where you are wearing your quiver now.
| rowspan="2"| XXX tugs at the straps of her quiver, adjusting the fit where it is strapped to her thigh.
|-
| You tug at the straps of your quiver, adjusting the fit where it is strapped to your thigh. You feel people will be less able to tell where you are wearing your quiver now.
|-
| colspan="2" style="text-align: center" | '''''a quiver strapped to one thigh'''''
|}
==Additional Information==
===Flare/Material/Status Messaging===
Each flare type, as well as material if the ammo does not have a flare (wood, metal or bone), or blessed status results in a different long description for the quiver plus different messages for the various verbs.

*Acid - a corroded faenor quiver covered in an intricate pattern of acid stains
*Bless - a gleaming faenor quiver surrounded by a brilliant white glow
*Cold - an icy faenor quiver covered in a thin layer of glittering frost
*Disruption - a distorted faenor quiver surrounded by an indistinct haze
*Disintegration - a dull faenor quiver with several semi-transparent patches
*Electricity - a blackened faenor quiver surrounded by a corona of bright blue energy
*Fire - a singed faenor quiver wreathed in a halo of flickering flames
*Impact - a warped faenor quiver covered in several dents
*Steam - a shiny faenor quiver wreathed in a cloud of steam
*Unbalance - an angular faenor quiver etched with a design of interlocking geometric shapes
*Vacuum - a smooth faenor quiver encased in a layer of void black energy

==Resources==
* [[/saved posts | Saved posts]]
* [[Ranged_Weapons| Ranged Weapons]]
* [[Art of the Bow (guide)]]
* [[Fletching]]

</td><td>
{{iteminfo
|type= Mechanical 
|type2= 
|itemclass= Container
|itemtype= Quiver 
|itemtype2=
|itemtype3=
|itemtype4=
|itemtype5=
|itemtype6=
|itemtype7=
|itemtype8=
|alter= Yes, Base and LONG only.
|ld= No 
|feature= 
|feature2=
|feature3=
|feature4=
|feature5=
|feature6=
|feature7=
|feature8=
|customize= 
|custom= 
|custom2=
|custom3=
|custom4=
|custom5=
|origmerch= 
|releasevenue= Duskruin Arena
|tiered= Yes 
|tiersnumber= 3 
|unlock= Automated unlocking certificate 
|unlock2=
|auction= 
|demeanor= 
|loresong= 
|attune= 
|attunement= 
|affinity= 
|hideable= 
|hide= 
|spell= 
|spell2=
|spell3=
|spell4=
|enhancive= 
|swap= 
|add= 
|restrictions= Cannot be altered with a SHOW.<br>Must be metal.<br>Tier 2 and up need a minimum of 2 compartments.
}}
{{itemverb
|verb= RUB
|verb2= CLEAN
|verb3= GET
|verb4= PUT
|verb5= NUDGE
|verb6= TINKER
|verb7= TURN
|verb8= TOUCH
|verb9= POINT
|verb10= PINCH
|verb11= SPIN
|verb12= PUSH
|verb13= PROD
|verb14=
|verb15=
|verb16=
|verb17=
|verb18=
|verb19=
|verb20=
|verb21=
|verb22=
|verb23=
|verb24=
|verb25=
|verb26=
}}
</td></tr></table>

Lich:Script Bigshot

2022-07-15T23:44:19Z

WHYARETHERENOUSERNAMES5: /* Command Checks */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot/Changelog|Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Quiet followers - Followers will wait until leader is done with both actions and resting scripts to begin using their own.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)
* Flee from webs - Enabling this check box will force Bigshot to flee from webs.
* Flee from voids- Enabling this check box will force Bigshot to flee from voids.

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]], Voln [[Symbol of Return]], [[Traveler's Song (1020)]], or [[Familiar Gate (930)]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails. Setting to Traveler's Song will attempt once and continue. Setting to Familiar Gate will attempt to summon a portal once and walk through it.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Delay looting - delays looting of creatures in a room.
* Pull players to feet - attempt to pull players to their feet upon passing them in a room
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game. (XML regex matching)
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])
* Activate weapon reactions - Will initiate reactive strikes when the opportunity presents itself

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** leech - Performs a [[Mana Leech (516)]] on target if cooldown is under 15 minutes.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** 1040 - To use Troubadour's Rally you no longer need to shout: 1040, 1040(m100) #shout 1040 will attempt to warcry shout.
** stomp - Will perform a stomp attack. Channels 909 if not active. Can also add 909 to society abilities to keep it active.
** dhurl - Hurl your weapon and recovers it. Works with weapon bonding auto return and the recover verb.
** assume <aspect> <aspect/evoke> - Will cycle between two aspects, or evoke a single aspect. Also works in society ability box. "650 <aspect> <aspect/evoke>"
** briar <weapon> - activate the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
** stance perfection - Put 10, 20, 30, ect in your attack stance box to take advantage of stance perfection.

*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*tailwind - Checks for Tailwind buff from Breeze. (tailwind) (!tailwind)
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*justice - Checks for charges of Swift Justice. (justice) do skill with charges (!justice) do skill with no charges
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp
*censer - Attempt to cast 320 before your command checking mana and cooldown. 309(censer), 335(censer mob3), attack(censer)
**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.
**If command is not a spell, will only check you have enough mana for the censer.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Monitoring Tab==
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Camouflage (608)

2022-07-10T00:22:33Z

WHYARETHERENOUSERNAMES5: /* Lore Benefits */

{{spell |
| name = Camouflage
| number = 608
| mnemonic = CAMOUFLAGE
| duration = Immediate
| type = Offensive
| subtype = Attack Boost
| weapon = None
| enhancement = +30 [[Attack Strength|AS]]/+18 [[Casting strength|CS]] (Spiritual), Auto-Hide
| requirements = None
| availability = [[Self-cast]]
| navigation = {{Ranger base navigation}}
}}

'''Camouflage''' blends the caster into the surroundings, placing them into [[hidden|hiding]] and adding +30 to [[attack strength]] (AS) on the next [[melee]] attack or [[bolt]] spell, or +18 Spiritual [[casting strength]] (CS) to the next [[warding]] spell. It also provides a bonus to remaining unseen while hidden, and a level-based bonus to{{boldmono| [[UNHIDE|UNHIDing]] }}unseen. If the ranger is discovered from hiding, or if the ranger moves or sneaks, the +30 AS bonus no longer applies. Archers may use this spell for a bonus to remain hidden while sniping.

Camouflage also provides a bonus to the ranger who has acquired the [[Shadow Mastery]] [[Combat Maneuver]] (CMAN) skill. While [[Sneaking (617)|sneaking]], the caster retains 10% of the AS bonus per Shadow Mastery rank. The results are cumulative, so every room that the ranger sneaks will reduce the AS bonus retained until it reaches zero. In addition, the casting [[roundtime]] of Camouflage is reduced by 1 second each at ranks 4 and 5 of Shadow Mastery, to a minimum of 1 second casting roundtime.

{{boldmono|[[TRACK (verb)|TRACK]]}} works with Camouflage in the following way: You lose the Camouflage AS/CS Boost while tracking, just like you do when moving or sneaking normally, but you do not get automatically revealed from hiding like normal. When tracking successfully, you stay hidden unless a creature discovers you.

Camouflage can be used indoors if the ranger first casts the spell [[Nature's Touch (625)]].

{{usage|s=608}}

== Lore Benefits ==
At 20 ranks of [[Spiritual Lore, Blessings]], Camouflage will also apply to the Ranger’s active [[animal companion]] when it is in the same room, providing a [[SMRv2]] bonus of +30 to its next attack when it is able to attack from hiding in that room. The Ranger’s active [[animal companion]] must be in offensive to benefit from camo.

== Resources ==
*[[Ranger Base/saved posts]]

Camouflage (608)

2022-07-10T00:12:19Z

WHYARETHERENOUSERNAMES5: /* Lore Benefits */

{{spell |
| name = Camouflage
| number = 608
| mnemonic = CAMOUFLAGE
| duration = Immediate
| type = Offensive
| subtype = Attack Boost
| weapon = None
| enhancement = +30 [[Attack Strength|AS]]/+18 [[Casting strength|CS]] (Spiritual), Auto-Hide
| requirements = None
| availability = [[Self-cast]]
| navigation = {{Ranger base navigation}}
}}

'''Camouflage''' blends the caster into the surroundings, placing them into [[hidden|hiding]] and adding +30 to [[attack strength]] (AS) on the next [[melee]] attack or [[bolt]] spell, or +18 Spiritual [[casting strength]] (CS) to the next [[warding]] spell. It also provides a bonus to remaining unseen while hidden, and a level-based bonus to{{boldmono| [[UNHIDE|UNHIDing]] }}unseen. If the ranger is discovered from hiding, or if the ranger moves or sneaks, the +30 AS bonus no longer applies. Archers may use this spell for a bonus to remain hidden while sniping.

Camouflage also provides a bonus to the ranger who has acquired the [[Shadow Mastery]] [[Combat Maneuver]] (CMAN) skill. While [[Sneaking (617)|sneaking]], the caster retains 10% of the AS bonus per Shadow Mastery rank. The results are cumulative, so every room that the ranger sneaks will reduce the AS bonus retained until it reaches zero. In addition, the casting [[roundtime]] of Camouflage is reduced by 1 second each at ranks 4 and 5 of Shadow Mastery, to a minimum of 1 second casting roundtime.

{{boldmono|[[TRACK (verb)|TRACK]]}} works with Camouflage in the following way: You lose the Camouflage AS/CS Boost while tracking, just like you do when moving or sneaking normally, but you do not get automatically revealed from hiding like normal. When tracking successfully, you stay hidden unless a creature discovers you.

Camouflage can be used indoors if the ranger first casts the spell [[Nature's Touch (625)]].

{{usage|s=608}}

== Lore Benefits ==
At 20 ranks of [[Spiritual Lore, Blessings]], Camouflage will also apply to the Ranger’s active [[animal companion]] when it is in the same room, providing a [[SMRv2]] bonus of +30 to its next attack when it is able to attack from hiding in that room. The Ranger’s active [[animal companion]] must be behaving offensive to benefit from camo.

== Resources ==
*[[Ranger Base/saved posts]]

Aura

2022-06-30T15:13:29Z

WHYARETHERENOUSERNAMES5: /* Systems and Skills Affected by Aura */

{{ stat
| type=Mental and Physical
| prime=[[Bard]], [[Sorcerer]], [[Wizard]]
| aelotoi=-
| dwarf=-10
| elf=+5
| delf=+10
| helf=-
| sylvan=+5
| erithian=-
| bgnome=+5
| fgnome=-
| giant=-5
| halfling=-5
| human=-
| hkrol=-
}}

'''Aura''' measures a character's connection to the magical nature of Elanthia, in all forms. This includes the [[elemental]], [[spiritual]], and [[mental]] spheres of magic. Aura also determines the number of [[spirit point]]s a character possesses, having one spirit point per 10 aura, rounded to the nearest tenth. Therefore, a character with 95 aura has 10 spirit points.

Aura is a factor in the initial [[mana]] capacity of the bard, [[rogue]], sorcerer, [[warrior]], and wizard professions.

== Systems and Skills Affected by Aura ==
{|
|- valign=top
|width=40%|
*[[Bard Base]] [[casting strength]]
*Initial [[Mana]] capacity for some professions
*[[Major Elemental]] [[casting strength]]
*[[Minor Elemental]] [[casting strength]]
*[[Sorcerer Base]] [[casting strength]]
*[[Wizard Base]] [[casting strength]]
*Elemental [[target defense]]
|
*[[Remove Curse (315)]]
*[[Unlock (407)]] and [[Disarm (408)]]
*[[Resist Nature (620)]] No longer a factor
*[[Grasp of the Grave (709)]]
*[[Curse (715)]]
*[[Planar Shift (740)]]
*[[Familiar Gate (930)]]
|}

==Related Recipe==
*[[Aura crystal]]

== Resources ==
*[http://www.play.net/gs4/info/stats.asp#aura Stats: Aura], on Play.net

{{Statistic}}

Lich:Script Bigshot

2022-04-17T16:12:12Z

WHYARETHERENOUSERNAMES5: /* Command Checks */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** 1040 - To use Troubadour's Rally you no longer need to shout: 1040, 1040(m100) #shout 1040 will attempt to warcry shout.
** stomp - Will perform a stomp attack. Channels 909 if not active. Can also add 909 to society abilities to keep it active.
** dhurl - Hurl your weapon and recovers it. Works with weapon bonding auto return and the recover verb.
** assume <aspect> <aspect/evoke> - Will cycle between two aspects, or evoke a single aspect. Also works in society ability box. "650 <aspect> <aspect/evoke>"
** briar <weapon> - activate the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
** stance perfection - Put 10, 20, 30, ect in your attack stance box to take advantage of stance perfection.

*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*justice - Checks for charges of Swift Justice. (justice) do skill with charges (!justice) do skill with no charges
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp
*censer - Attempt to cast 320 before your command checking mana and cooldown. 309(censer), 335(censer mob3), attack(censer)
**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.
**If command is not a spell, will only check you have enough mana for the censer.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-04-03T21:30:07Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** 1040 - To use Troubadour's Rally you no longer need to shout: 1040, 1040(m100) #shout 1040 will attempt to warcry shout.
** stomp - Will perform a stomp attack. Channels 909 if not active. Can also add 909 to society abilities to keep it active.
** dhurl - Hurl your weapon and recovers it. Works with weapon bonding auto return and the recover verb.
** assume <aspect> <aspect/evoke> - Will cycle between two aspects, or evoke a single aspect. Also works in society ability box. "650 <aspect> <aspect/evoke>"
** briar <weapon> - activate the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
** stance perfection - Put 10, 20, 30, ect in your attack stance box to take advantage of stance perfection.

*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp
*censer - Attempt to cast 320 before your command checking mana and cooldown. 309(censer), 335(censer mob3), attack(censer)
**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.
**If command is not a spell, will only check you have enough mana for the censer.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-04-03T21:28:28Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** 1040 - To use Troubadour's Rally you no longer need to shout: 1040, 1040(m100) #shout 1040 will attempt to warcry shout.
** stomp - Will perform a stomp attack. Channels 909 if not active. Can also add 909 to society abilities to keep it active.
** dhurl - Hurl your weapon and recovers it. Works with weapon bonding auto return and the recover verb.
** assume <aspect> <aspect/evoke> - Will cycle between two aspects, or evoke a single aspect.
** briar <weapon> - activate the AS buff on briar weapons. Tracks weapon charge and uses on cooldown.
** stance perfection - Put 10, 20, 30, ect in your attack stance box to take advantage of stance perfection.

*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp
*censer - Attempt to cast 320 before your command checking mana and cooldown. 309(censer), 335(censer mob3), attack(censer)
**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.
**If command is not a spell, will only check you have enough mana for the censer.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-16T22:26:42Z

WHYARETHERENOUSERNAMES5: /* Commands Tab */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** 1040 - To use Troubadour's Rally you no longer need to shout: 1040, 1040(m100) #shout 1040 will attempt to warcry shout.
*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp
*censer - Attempt to cast 320 before your command checking mana and cooldown. 309(censer), 335(censer mob3), attack(censer)
**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.
**If command is not a spell, will only check you have enough mana for the censer.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-10T22:57:08Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** surge - Will keep surge of strength up. surge or surge(surge) will cast even on cooldown, surge(!surge) will only cast when not on cooldown.
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** 1040 - To use Troubadour's Rally you no longer need to shout: 1040, 1040(m100) #shout 1040 will attempt to warcry shout.
*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-10T21:45:08Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout - Will perform warcry shout. Must use a command check or it will shout every loop: shout(!shout),shout(buff10 s25)
** yowlp - Will perform warcry yowlp. Must use a command check or it will yowlp every loop: yowlp(!yowlp), yowlp(buff10 s10)
** holler - Will perform warcry holler every loop taunting all the mobs. holler(s60)
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
** 1040 - To use Troubadour's Rally you no longer need to shout: 1040, 1040(m100) #shout 1040 will attempt to warcry shout.
*** You may need to '''SKILLS FULL/CMAN INFO/WEAPON INFO/SHIELD INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-09T07:05:34Z

WHYARETHERENOUSERNAMES5: /* Example Attack Routines */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout, yowlp, holler - Will perform these only if the buff is not present. holler will execute each loop of commands.
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
*** You may need to '''SKILLS FULL/CMAN INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>surge(!surge), bullrush, bearhug, pummel, attack</PRE>

Will cast surge when not on cooldown, and bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>surge, shout(buff10), shield strike, pummel(buff60), attack(x2)</PRE>

Will keep surge active, casting during cooldown for 60 stamina. Next it will shout and refresh shout when there is less than 11 seconds left on the duration. Third it will shield strike followed up with a pummel once every minute. It will finish off with 2 attacks.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-09T06:58:30Z

WHYARETHERENOUSERNAMES5: /* Command Checks */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.
* Stop for dead players - checkbox will pause bigshot if you encounter a dead player

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout, yowlp, holler - Will perform these only if the buff is not present. holler will execute each loop of commands.
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
*** You may need to '''SKILLS FULL/CMAN INFO''' if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.
*buffXX - Fire ability when buff duration is <= XX. Supported for barrage,bearhug,fury,flurry,pummel,thrash,shout,yowlp

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>bullrush, bearhug, pummel, attack</PRE>

Will bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-08T08:17:47Z

WHYARETHERENOUSERNAMES5: /* Commands Tab */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout, yowlp, holler - Will perform these only if the buff is not present. holler will execute each loop of commands.
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
*** You may need to SKILLS FULL if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>shroud(s35 !hidden mob2), divert target(s25 hidden mob2), ambush(hidden), flurry, attack</PRE>

If there is more than one mob, it will hide with shroud and divert one of the targets. Third command will ambush if hidden. Fourth will flurry on cooldown followed up with attack to finish anything off.

<PRE>bullrush, bearhug, pummel, attack</PRE>

Will bullrush to bust up and apply vulnerable, then bearhug which is faster if target is vulnerable. Third we will pummel on cooldown and attack when nothing else is available.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-08T07:58:35Z

WHYARETHERENOUSERNAMES5: /* Example Attack Routines */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout, yowlp, holler - Will perform these only if the buff is not present. holler will execute each loop of commands.
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
*** You may need to SKILLS FULL if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>holler, shield throw(mob3), flurry, thrash, attack</PRE>

Will open up with a taunt from holler, then shield throw if there are at least 3 targets. Third command will flurry on cooldown. Fourth will thrash on cooldown. Finally we will attack if everything else ends up on cooldown or we run out of stamina.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-08T07:47:32Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout, yowlp, holler - Will perform these only if the buff is not present. holler will execute each loop of commands.
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick
*** You may need to SKILLS FULL if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-08T07:44:39Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - Assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - Setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - AOE will execute on cooldown, limit with check volley(mob3).
** shout, yowlp, holler - Will perform these only if the buff is not present. holler will execute each loop of commands.
** bellow, growl, cry - Offensive warcries can be used with target for single target or all for aoe.
** shield bash, shield charge, shield pin, shield push, shield strike, shield trample, shield throw
** bearhug, bullrush, coupdegrace, cpress, cutthroat, dirtkick, dislodge, divert, eviscerate, exsanguinate, eyepoke, feint, footstomp, garrote, gkick, hamstring, haymaker, headbutt, kneebash, leapattack, mblow, mug, nosetweak, sattack, sblow, scleave, shroud, spunch, sthieve, subdue, sunder, sweep, swiftkick, tackle, templeshot, throatchop, trip, truestrike, vaultkick

** You may need to SKILLS FULL if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-08T07:29:49Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pindown, twinhammer - setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - aoe will execute on cooldown, limit with check volley(mob3).
** shout, yowlp - will perform these only if the buff is not present.
** bellow, growl, cry - offensive warcries can be used with target for single target or all for aoe.
** You may need to SKILLS FULL if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-08T01:33:07Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pin down, twinhammer - setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - aoe will execute on cooldown, limit with check volley(mob3).
** shout, yowlp - will perform these only if the buff is not present.
** bellow, growl, cry - offensive warcries can be used with target for single target or all for aoe.
** You may need to SKILLS FULL if you've recently changed training or skills are being outright skipped.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-07T23:23:55Z

WHYARETHERENOUSERNAMES5: /* PSM3 Integration */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pin down, twinhammer - setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - aoe will execute on cooldown, limit with check volley(mob3).
** shout, yowlp - will perform these only if the buff is not present.
** bellow, growl, cry - offensive warcries can be used with target for single target or all for aoe.

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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

Lich:Script Bigshot

2022-03-07T23:18:13Z

WHYARETHERENOUSERNAMES5: /* Commands Tab */

When it comes to Lich scripts, Bigshot takes the cake. Bigshot can fully automate hunting to a point where you do not even have to be at your computer. Take care, though, as /afk scripting on any server but Shattered is in violation of game policy and can have some nasty consequences.

==Changelog==
*[[Script Bigshot Changelog]]

==What Does Bigshot Do?==

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

==How Do I Get It?==

Grab it from the Repository: ;repository download Bigshot

Once it is done, ;trust Bigshot.

==How Do I Make it GO!?==

It is a bit complicated. As with most scripts, using a SETUP command will open a graphical user interface for configuring the script. Use ;bigshot setup to open this dialog. This will open a window with the following tabs:
* General - General configuration for non-hunting options.
* Resting - Set up your resting routine and location.
* Hunting Map - Create a hunting map by adding BOUNDARIES and a starting room.
* Hunting - Specify what you are hunting and how.
* Attacking - Create a customized attack routine designed to murder your foes.
* UAC Options - Options for a uac routine
* MSTRIKE Options - Options for using MSTRIKE
* Should_hunt? - Set conditions for Bigshot to know when to start hunting.
* Should_rest? - Set conditions for when you want Bigshot to stop hunting and rest.
* Ammo/Wands - Let Bigshot know where you keep your arrows and wands.

We will take a closer look at each of these individually further on.

There is also several other commands you can do for more functionality.
* ;bigshot quick - Special hunting mode that kills everything in the room your in and quits bigshot. Wont wander at all, and wont attempt to rest. Has its own hunting commands and hunting targets.
* ;bigshot head/tail - This is for Multi-Account hunting. It only works for a single computer. Every character needs to be setup for the hunting area your going to. You start it by having your following characters join your head character. The following characters need to be running bigshot with ;bigshot tail. Once that happens, have the leader of the group do ;Bigshot head. They will then procede to hunt in the area you have setup.
* ;bigshot display - Shows all your current settings.
* ;bigshot reset - Resets all your targetable and untargetable lists. Useful if you find bigshot won't targets something it should.
* ;bigshot ranger or ;bigshot companion - Resets ranger companion setting so you can set it again. Used when you change your companion.
* ;bigshot profile save <name here> - Saves a profile in YAML format in your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot profile load <name here> - Loads a profile from your LICHFOLDER\scripts\bigshot_profiles folder.
* ;bigshot single - When used solo, will execute a single hunting routine, return to your resting location and then exit

==The General Tab==
On this tab, you will see four check boxes. They are:
* Engage deadman's switch - Selecting this option will force Bigshot to quit Gemstone IV when your character is at less than 40% health, allowing you to log back on and assess the situation manually later.
* Depart/rerun if dead - Enabling this option will force a DEPART, causing your character to wake up in the Temple with low spirit. Following this, Bigshot will re-start, starting a fresh hunt. If you do not have a Check Spirit value set in your Should_hunt? tab, you will start hunting without recuperating lost stats.
* Monitor interaction - Running scripts automates most functions and happens rather mechanically. Most anyone can tell if you are scripting just by watching you. Checking this box will pop up a window whenever Bigshot thinks that someone or something is trying to interact with you.
* Flee from clouds - Enabling this check box will force Bigshot to flee from Cloud spells such as 125(Call Lightning with its Ominous Cloud), 1704 (Stun Cloud) and 1713 (Death Cloud)
* Flee from vines - Enabling this check box will force Bigshot to flee from Vine spell such as 610(Tangle Weed)

==The Resting Tab==
Short and sweet, here is where we setup our resting routines. During REST mode, Bigshot uses the EXP command and checks your mind, hit points, wound status, mana and spirit. Once all of these values are at the specified Should_hunt? settings, Bigshot leaves REST mode and begins a HUNT.
* room id: - This is the room that Bigshot will return to for resting. Use Room Numbers from Narost / Go2. For example, 228 is Town Square Central in Wenhimer's Landing - a supernode!
* pre-rest commands: - These commands run before entering REST mode. An example routine is: 'shea, wear shield, sit, stance offensive, rest'. This will sheath your weapon, wear your shield, sit, enter offensives stance and use the REST verb. Casters able to should use the MEDITATE verb.
* active resting scripts: - Active resting scripts are scripts that will be run upon entering REST mode. These scripts should be things that you do after a hunt: get healed, empty your bags, spell up. An example list is: 'sloot sell, waggle, useherbs pack'. This will use Sloot to sell according to the options set with Sloot. After selling, it will use Waggle to spell you up according to however Waggle is setup. Finally, useherbs will check your PACK and use herbs stored there to heal whatever wounds you have.
* Fog Option: - Uses [[Spirit Guide (130)]] or Voln [[Symbol of Return]] when heading back to rest. Setting it to None does nothing. Setting it to 130 will cause it to use 130 first then if that fails symbol of return. Symbol of return will use that first, then 130 if that fails.

==The Hunting Map Tab==
Your hunting map is a series of Boundaries - rooms that Bigshot will not enter - and a Start room - the first room that Bigshot moves to when a hunt starts. These function very similarly to the boundaries in the ;Wander script, but are stored in Bigshot's configuration files and not in a character cache as with ;Wander. Luckily, some very enterprising gnomes have put together a List of Hunting Areas and Boundaries, taking some of the legwork out of the deal.
* starting room ID: - This is the first room that Bigshot goes to when hunting. You may set this to any room within the Boundaries that you set with the second option.
* boundary rooms: - Boundary rooms are walls. Bigshot will not enter a Boundary room!

<PRE>X-X-B - A - 0 - 0 - 0
| |
X-X-X</PRE>
Imagine a hunting area that is a six room square. To enter this square, one must GO DOORWAY from room A. You would set the room outside of the square - ie room A - before you GO DOORWAY, as a boundary. Then, you would set room B to the Starting Room. From there, Bigshot will move to room B and then wander around inside the Boundary - ie the square hunting area - until it your '''Should_rest?''' conditions are met.

* Wait before wandering to another room: - Time you wait before leaving a room to find some creatures. Default is 0.3 seconds

==The Hunting Tab==
The bread and butter of Bigshot, Hunting is where you define what monsters you are hunting and what non-attack abilities you want to use.
* valid targets: - These are the monsters you are hunting. Bigshot will most easily recognize monsters based on the NOUNs or their name. For example, 'a large ogre' can be targetted with just 'ogre'. Using longer descriptors can be troublesome, and you should copy a monster's name directly from the game front end to avoid troubles. You can use multiple entries separated by commas. For example: 'manticore, thrak' will kill manticores and thraks.
* quickhunt targets: - These are monsters you have designated attacks for when your using the ;bigshot quick option for hunting.
* attack stance: - Specify what stance you want to attack from. Bigshot will remain in Stance Defensive until an attack command is issued, whereupon it will stance to your Attack Stance and execute your Attacking routine. Bigshot recognizes all stances from the game, Offensive ->-> Defensive.
* pre-hunt commands: - These commands will be executed before Bigshot uses Go2 to travel to your hunt's Starting Room. As an example: 'gird, stance defensive'. This will ensure that you have readied your weapon and are in Defensive stance before traveling. Set short lived combat spells like 1605 (Arm of the Arkati) to be cast in this line.
* active hunting scripts: - Active hunting scripts are scripts that will run while Bigshot is in Hunt mode. Many of these scripts have been made obsolete by the next option. Clever scripters have written some nice scripts that will keep certain spells up, execute cmans based on conditions etc. If you need a complex action to run while Hunting that Bigshot does not have the capacity for, an active hunting script may be called for.
* society abilities/spells/cmans: - Bigshot can be asked to keep certain abilities up at all times during a hunt. Hovering your mouse over this field will display a list of cmans and society abilities specified by their numerical designations. Spells may also be added here. Separate all values by commas. For example, entering '506' will keep the spell Haste up during Hunts, casting whenever it has worn off.
* loot script - Bigshot will call a loot script to loot your kills for you. Sloot and Sloot2 are common scripts used here. Be sure to use the SETUP command on whatever loot script you use, as if it is not configured properly, Bigshot will likely error.
* wracking spirit >= - Setting a value here will WRACK for mana if your spirit is greater than or equal to the value specified. Setting 6, for example, will WRACK down to 5 spirit. This will ONLY function if you have the 'Use sign of wracking/sigil of power' box checked.
* Use sign of wracking/sigil of power - checkbox to enable the use of wracking
* Priority hunt - checkbox to enable the use of the priority system for hunting. This allows you to change targets based on the order listed in valid targets/quickhunt targets. For example, your hunting thunder trolls, wind witches, and puma. Your valid target order is wind witch, thunder troll, puma. Your currently attacking a puma, when a thunder troll walks in. You will switch to the attacking the thunder troll because its before the puma in the valid targets list. After killing the thunder troll, you go back to the puma, only to have a wind witch walk into your room. You will again switch to the wind witch because its in front of the puma. Hope you get the idea. When using the ;bigshot quick option, it will base the order of targets by your quickhunt targets first, then the order of the targets in the room that don't match any of your quickhunt targets. Example, bandits are in your quickhunt targets. You type ;bigshot quick when you get ambushed in the room. Currently in the room is a large ogre and three bandits. The order of targets will be the bandits first, then the large ogre.

===Hunting Target Examples===
All of the examples below will work for both the 'valid targets' and 'quickhunt targets' entries.
* A hunting option only using the default command (a) for each creature in an area:
<pre>crazed zombie, niirsha, sacristan spirit</pre>
* A hunting option using custom hunt commands depending on the creature. In this case it will use command (a) for a [[crazed zombie]] and a [[sacristan spirit]], while using (b) for a [[niirsha]]:
<pre>crazed zombie(a), niirsha(b), sacristan spirit(a)</pre>
* A hunting option that will include the [[:Category:Boss creatures|Boss Creatures]] variations as valid targets:
<pre>(?:adroit |afflicted |apt |barbed |belligerent |blurry |canny |combative |dazzling |deft |diseased |drab |dreary |ethereal |flashy |flexile |flickering |flinty |frenzied |ghastly |ghostly |gleaming |glittering |glorious |glowing |grotesque |hardy |illustrious |indistinct |keen |lanky |luminous |lustrous |muculent |nebulous |oozing |pestilent |radiant |raging |ready |resolute |robust |rune-covered |shadowy |shielded |shifting |shimmering |shining |sickly green |sinuous |slimy |sparkling |spindly |spiny |stalwart |steadfast |stout |tattooed |tenebrous |tough |twinkling |unflinching |unyielding |wavering |wispy )?crazed zombie, niirsha, sacristan spirit</pre>
* Some additional advanced options for identifying valid targets:
<pre>
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:dissembler|sorcerer|sorceress|warlock|witch)(a)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:barbarian|blackguard|fighter|marauder|soldier|warrior)(b)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:adept|archmage|elementalist|mage|warmage)(c)
(?:seasoned |grizzled |battle-scarred |weathered |veteran |hulking |haggard )?Grimswarm (?:giant|troll|orc) (?:hunter|huntmaster|huntmistress|ranger)(d)
(?:seasoned )?(?:dwarven|elven|halfling|erithian|human|giantman|half-krolvin|gnomish|half-elven) (?:thief|rogue|bandit|mugger|outlaw|highwayman|marauder|brigand|thug|robber)(e)
(?:shopkeeper|innkeeper|bartender|patrol leader|bandit lord|bandit lady|gypsy queen|gypsy king|guard captain|wall captain|drill sergeant|stable hostler|dungeon master|master torturer|butler|cook|
knight captain|foreign dignitary|royal prince|royal princess|royal jester|royal emperor|royal empress)(f)

To attack everything in the room (?:.*)</pre>

==The Attacking Tab==
* Ambush aiming locations (head, etc): - Allows you to specify what order you aim for ambush. Default is head, right leg, left leg, chest.
* Archery aiming locations (head, etc): - Allows you to specify what order you aim for archery. Loops through your aiming locations once you hit the area your aiming at.
* flee if enemy count is > - Flees the room if the total number of enemies in the room exceeds the value. Set this to 1 if you want to engage single targets.
* ...but don't count these: - Bigshot will ignore monsters specified in this line when eveluating if it should flee based on how many monsters are in the room. Useful for when you are hunting in an area with extremely low level monsters mixed in with your targets.
* ...and always flee from: - Bigshot will always flee from the specified monster as soon as possible. Extremely useful if your hunting area has higher level and/or extremely dangerous monsters mixed in with your intented target(s).
* flee from environment message: - Will flee whenever anything you put in here gets sent from the game.
* Wait before wandering to another room: - time you spend before moving to a new room. Default is 0.3 seconds. You can set it to 0 to move instantly. Tends to be spammy for anyone in the same hunting area.
* Spam attacks - This check box will force Bigshot to execute attack commands at an extremely high speed, cutting down on lag times. If you want to squeeze in the maximum number of swings or casts during an enemy's round-time, make sure this is checked.
* Approach lone targets only - Forces Bigshot to only begin combats against creatures that are alone.
* Bless weapon? - Performs a Consecrate (1604), then a Cleric Bless or Voln Bless on whatever weapon loses its bless during hunting. If you can't bless your weapon while hunting will return you to your rest area and quit the script.
* Flee from boon - Enabling this check box will force Bigshot to flee from all boon/gifted/boss creatures (available in [https://github.com/elanthia-online/scripts/pull/449/commits/afade49e25dd6042c30b6d62fec4d65376667f80 v4.3.0])

==Commands Tab==
The true guts of Bigshot, this is where you specify your Attack Routine.
* hunting commands - These are the commands that Bigshot will evaluate (ie execute) when it is in the room with a valid target (one that you specified in your Hunting section. These commands are separated by a comma. Bigshot recognizes most hunting verbs and, failing that, will use an fput command (a direct entry method) and just execute the commands directly as written. The following are a list of usable hunting commands:
** kill - Attacks using the KILL verb.
** incant <spell number> - ** incant <spell number> - Casts the specified spell with the INCANT verb. This will automatically stance into offensive for bolt and other stance-sensitive spells. A caster may CHANNEL the spell using [[INCANT (verb)]] to INCANT SET CHANNEL <spell> (a standard GSIV verb, not part of Lich). Alternatively, a caster may CHANNEL spells by using the SET verb (a standard GSIV verb, not part of Lich) to SET ChannelIncant ON. This will CHANNEL an INCANTed spell if the caster is in a stance higher than neutral.
** channel <spell number> - Channels the specified spell at the target. This requires a stance higher than neutral to have any effect.
** <Spell Number> - Casts the specified spell with the PREPARE and CAST verbs.
** wand - As in, 'wand target'. Gets a wand from the specified storage and WAVES it at the target.
** fire - As in, 'fire target'. Gets ammunition from the specified storage and FIREs it at the target. Will attempt to aim based on settings on hunting tab.
*** The above listed commands should be used with the (x#) syntax. For example, kill target (x3) will swing three times at the target before re-evaluating the attack routine. If the (xx) variable is used, Bigshot will continue using the specified attack command up to five (5) times. Example: '903 target (xx)' will continue to cast 903 at the target (5) times before restarting the attack routine or until it is dead. If you want to ensure the routine does not restart, using a sufficiently large number should suffice (e.g. x100). Bigshot may also be set to only execute a command based on how much mana or stamina you currently have. For mana, use the (m##) command. '920 target (m50)' will only cast 920 (Implosion) if you have 50 or more mana. Similarly, 'cman feint target (s10)' will only execute the combat maneuver Feint on the target if you have 10 or more stamina
** aim <location> - Aims at the specified location.
** ambush - Uses the AMBUSH verb to attack. Will aim based on settings in Hunting tab. Also will aim dynamically, "Ambush head" would aim at the head, overwriting any settings or defaults for that attack.
** wait <time> - Bigshot may Stance Dance by using the WAIT command. Bigshot will stay in Stance Defensive until the specified time is over OR the target swings / casts, whereupon it will evaluate the rest of the Attack Routine, changing into your specified attack stance.
** mstrike - As in, 'mstrike target'. Mstrike depending on mstrike cooldown and stamina. Has its own option page. Can also be used with UAC, "mstrike punch".
** berserk - Executes the BERSERK verb and stands by until it fades.
** throw - Empties hands, Attempts throw, get the stuff you emptied.
** weed/kweed - Casts 610 at target. Using "kweed" as your command will cast 610 from offensive stance.
** unarmed - Uses the Bigshot UAC routine. Routine will attack with appropriate attacks to rank up and use mstrike based on mstrike options page. Usage "unarmed (punch|jab|kick|grapple)".
** smite - Performs an [[Order of Voln]] [[Kai's_Smite|Smite]] on target until successful.
** script <script name> - Executes a specified custom attack script.
** hide - Continue hiding until you're actually hidden. Or it's tired of trying.
** sleep - As in, 'sleep 10'. Pause bigshot. Useful with fried hunting commands such as: '410, sleep 15' will E-wave then wait 15 seconds and e-wave again if there are valid targets.
** stance - As in, 'stance defense'. Change stances.
** nudgeweapons - Move all weapons on the ground to an adjacent room. Useful for casting Implosion (720).
** force <cmd> until <endroll> - As in, 'force 1002 until 101'. Continue issuing a command until a desired endroll. Only works for normal looking swings/spells/cmans.
* hunting commands (b) - Attack routines set up for a monster flagged (b) in the Hunting section.
* hunting commands (c) - Attack routines set up for a monster flagged (c) in the Hunting section.
* hunting commands (d) - Attack routines set up for a monster flagged (d) in the Hunting section.
* hunting commands (e) - Attack routines set up for a monster flagged (e) in the Hunting section.
* hunting commands (f) - Attack routines set up for a monster flagged (f) in the Hunting section.
* hunting commands (g) - Attack routines set up for a monster flagged (g) in the Hunting section.
* hunting commands (h) - Attack routines set up for a monster flagged (h) in the Hunting section.
* hunting commands (i) - Attack routines set up for a monster flagged (i) in the Hunting section.
* hunting commands (j) - Attack routines set up for a monster flagged (j) in the Hunting section.
* fried hunting commands - Commands executed specifically when fried. Useful when hunting in a group.
* quick hunting commands - Commands executed specifically when using ;bigshot quick.

===PSM3 Integration===
* hunting commands - Bigshot now supports weapon/shield skills and warcries. Assaults will wait until they finish or are interuppted. These commands are separated by a comma. The following are a list of usable hunting commands:
** barrage, flurry, fury, gthrusts, pummel, thrash - assaults will wait until attacks are completed/interrupted.
** charge, cripple, dizzyingswing, pin down, twinhammer - setups will execute on cooldown so make sure to check for prone/stun/root/ect.
** clash, cyclone, pulverize, volley, wblade, whirlwind - aoe will execute on cooldown, limit with check volley(mob3).

===Command Checks===
Additional checks you can add to any command to customize the attack to your desired scenario.
Each check below can be used by itself or with any other check. Put them inside () with a space between each additional check. Example - Kill(m20 s5 e20)
<p>Each of these also has an inverse or opposite.
Just put a ! in front of the command. Example - Kill(!m20 !s5 !e20)
*s# - Checks that you have the required stamina
*m# - Checks that you have the required mana
*h# - Checks that you have the required health but based on a percentage instead of fixed number
*v# - Checks that you have the required spirit
*e# - Checks that your encumbrance percentage is at or below
*tier# - Checks for your current UAC tier (1,2,3). Performs command if UAC Tier is equal or greater.
*mob# - Checks for the number of npcs in room. Performs command if npcs in room is equal to or more than number specified.
*prone - Checks to see if target is not sleeping|webbed|stunned|kneeling|sitting|lying down|prone|frozen|held in place. Performs command if target status is not one of the previous.
*undead - Checks to see if target is undead. Performed command if target is undead.
*flying - Checks to see if target is flying. Performed command if target is flying.
*hidden - Checks to see if your currently hidden.
*poison - Checks to see if your currently poisoned.
*disease - Checks to see if your currently diseased.
*noncorporeal - Checks to see if NPC is [[noncorporeal|non-corporeal]] undead
*pcs - Checks to see if there are any PCS in room that are also not in your group
*outside - Checks to see if the room you are in is outside
*barrage - Checks for the Enhanced Dexterity buff from Barrage.
*fury - Checks for the Enhanced Constitution buff from Fury.
*flurry - Checks for the Slashing Strikes buff from Flurry.
*pummel - Checks for the Concussive Blows buff from Pummel.
*thrash - Checks for the Forceful Blows buff from Thrash.
*vigor - Checks for the Tangleweed Vigor buff from Tangleweed.
*reflex - Checks for the Arcane Reflex buff from Nature's Touch.
*shout - Checks for the Empowered buff from Shout.
*yowlp - Checks for the Yertie's Yowlp buff from Yowlp.

===Additional Options===
*haste or 506 - Placing this in front of any command will cause you to cast 506 before doing that command. It only casts if it isn't currently up or has less than 3 seconds left on its timer.
<PRE>wait 10, haste kill target (x3)</PRE>

===Example Attack Routines===
<PRE>wait 10, kill target (x3)</PRE>

Waits 10 seconds for the monster to swing or cast and then immediately counter attacks from the specified attack stance set in the Hunting tab. Swings a total of three times before going into Defensive stance and waiting 10 seconds again.

<PRE>wait 15, incant 505, incant 903 (xx)</PRE>

Waits 15 seconds before INCANTing 505 (Hand of Tonis), hopefully knocking down or stunning the target. Following this, Bigshot casts 903 (minor water) repeatedly until the target is dead (up to 5 times).

<PRE>stance defensive and 1615 target, kill target (x100)</PRE>

Casts 1615 (Divine Strike) at the target from Defensive stance, possibly forcing the target to kneel. Then, uses the kill verb to swing continuously until the target is dead or 100 times..whichever happens first.

<PRE>force cman feint target until 101, kill target x2</PRE>

Uses the Combat Maneuver FEINT against the target until a successful end roll and then hits the target twice before trying to FEINT again.

<PRE>stance defensive and hide, ambush target left leg</PRE>

Hides from Defensive stance and then ambushes that the target's left leg. Once round-time is up, repeats (ie HIDES again from defensive stance).

<PRE>incant 720(m50), incant 708, incant 702 channel(xx)</PRE>

Casts 720 (Implosion) at the target if your character has 50 or more mana. Then, INCANTs 708 (Limb Disruption) at the target, using the default AIM location (if set). Finally, casts 702 (Mana Disruption) at the target up to (5) times or until it is dead.

<PRE>prep 708, cast at target left leg / prep 708 channel at target left leg</PRE>

Prepares 708 (Limb Disruption) and CASTs it at the target's left leg. The second prepares the same spell and then CHANNELs it at the target's left leg.

<PRE>wait 30, unarmed punch</PRE>

Waits 30 seconds or until your target attacks. Begins attacked with UAC combat using Punch to tier up.

<PRE>shield charge target(s15 prone), ambush, mstrike</PRE>

Will shield charge the target if your character has 15 or more stamina and the target is NOT prone.

The second command will then ambush based on the settings in the "Attacking" Tab - in this case a custom order of head, neck, right leg, back was given so Bigshot will first try to Ambush the head unless the head is too injured or the head cannot be reached followed by the neck then right leg then back.

Bigshot will then focus mstrike the target unless the creature count is equal to or greater than the setting in the MSTRIKE Tab, in which case it will open mstrike instead. If you put "mstrike target", Bigshot will always focused mstrike regardless of the settings in the MSTRIKE Tab. Alternatively, you can set the "Unfocused MSTRIKE when creatures equal or greater" to a large number, to always focus your mstrikes (or set it to 1 to always open mstrike).

<PRE>bellow all, wblade(mob3), flurry(!flurry), attack</PRE>

Will aoe bellow, then whirling blade if there are at least 3 targets. The third command will flurry if you don't have the slashing strikes buff. Finally it will attack and continue to attack until one of the previous attacks become available.

<PRE>pin down(mob4), volley(mob2), weed(!vigor !reflex), barrage(!barrage), incant 616 target(m16 reflex), fire</PRE>

Will open up with pin down if there are at least 4 targets, then will volley if there are at least 2 targets. The third command will cast tangleweed if you do not have the tangleweed vigor buff or the arcane reflex buff. Our fourth command will barrage unless we have the enhanced dexterity buff from barage. Fifth we will cast a 1 second spike thorn if we do have 16 mana and do have the arcane reflex buff. Finally we will fire until one of our other commands become available.

==UAC Options==
The various options for configuring how UAC works:
* '''Tier 3 Attack'''
** The attack used when you have reached excellent in the UAC tier
** Options are jab, punch, grapple, or kick
* '''Aim at location (head, etc)'''
** Used for aimed UAC Combat, which requires ambush training to be effective
** Leave blank when you don't want to aim.
* '''MSTRIKE when creatures equal or greater'''
** Determines how many creatures must be present before using MSTRIKE
* '''Use Voln SMITE?'''
** Will perform a Voln SMITE on [[Non-corporeal]] undead

===UAC Setup===
Frequently, people have trouble setting up Bigshot to work with Unarmed Combat. Bigshot only requires minimal configuration to ensure UAC works well.
#UAC tab: Input your '''Tier 3 Attack''' (jab, punch, grapple, or kick)
#Commands tab: Input your '''hunting commands(a)''' option as '''unarmed jab'''

Important notes to keep in mind on how UAC works in Bigshot:
* The hunting option '''unarmed jab''' can be replaced by any UAC attack type (e.g. '''unarmed punch''')
* UAC follow up strikes will be selected over the base or tier 3 attack
* Tier 3 attacks will be used only when positioning is excellent

There is almost no reason to ever use anything other than '''unarmed jab'' as the hunting command, and either '''grapple''' or '''kick''' as the Tier 3 attack.

===UAC with combo.lic===

(It is not recommended to use combo.lic over the native unarmed punch/kick/grapple options from Bigshot v3.93 and forward)

Many people It is important to note that while the combo.lic script is what many people use for unarmed combat, it requires additional setup within combo to work with Bigshot.
To make Bigshot work with the combo.lic script:

#Hunting tab: enter '''script combo'''
#UAC tab: enter '''grapple''' beside "Tier 3 Attack" (or could enter jab, punch, or kick)
#Set ''';combo tierup grapple''' (could substitute jab, punch, or kick, rather than grapple)
#Refer to ''';combo help''' if you have trouble with step 3

==MSTRIKE Options==
MSTRIKE attack now has options for when it should be used.
* '''MSTRIKE during cooldown stamina requirement'''
** Allows you to specify how much stamina you want before it will MSTRIKE during the MSTRIKE Cooldown
** Be careful when setting this too low as it can pop your muscles
** Leave blank for it to use your max stamina.
* '''QUICKSTRIKE stamina requirement'''
** Like above but instead for using QUICKSTRIKE during the MSTRIKE routine.
* '''Unfocused MSTRIKE when creatures equal or greater'''
** Number of creatures in room before you do an unfocused mstrike. Default is 2.
* '''MSTRIKE during cooldown'''
**Toggle for MSTRIKEing during its cooldown period
* '''Use QUICKSTRIKE for MSTRIKE'''
** Toggle for using QUICKSTRIKE when you MSTRIKE

==The Should_hunt? Tab==
Bigshot evaluates the conditions set on this tab to determine if you are ready to hunt or not.
* '''when percent mind <='''
** Setting this to 51 will rest until Cleared. Setting at 65 will wait until Muddled.
* '''and percent mana>='''
** Determines the percent total of your maximum mana that must be present before hunting
** Setting below 50 will result in quick, uneventful hunts if you cast much. Generally, this is set at 95 or higher.
* '''and CHECKspirit >='''
** Bigshot will check to see that your current Spirit value is higher than what is listed here.
** Make sure that you have this set high enough that Bigshot won't hunt immediately after DEPARTing if you have Depart / re-run Bigshot checked on the General tab.

==The Should_rest? Tab==
Bigshot evaluates these conditions and, when they are met, will go to your resting room set on the Resting tab and execute any resting scripts you have set.
* '''when percent mind >='''
** Rests when your mind has reached this threshold. Generally, set this to 100 to rest when fried.
* '''and used lte boosts >='''
** The number of LTE boosts it will attempt to use after reaching your `when percent mind` threshold
* '''and extra kills >='''
** The number of extra monsters to kill after reaching your `when percent mind` threshold and after LTE boosts used
* '''or percentmana <='''
** Forces Bigshot to rest when your percentage of mana is at or below this threshold.
** This can be set to 0, but leaving a bit in the tank can be good if you have to use 406 (Unlock) to open the WL Graveyard gate.
* '''or percentencumbrance >='''
** Forces Bigshot to rest when you have reached a given level of encumbrance.
* '''or wounded eval'''
** Allows you to set an evaluation phrase to determine if you are too wounded to continue hunting. Wound evaluations can send you home on nearly any wounded condition of your choice: bleeding, level 2 wound, can't cast, too many scars etc.

The following is a wounded evaluation that will rest whenever you have any level II wounds.

<PRE>XMLData.injuries.any?{|key,value| value["wound"] > 1} || percenthealth <= 70</PRE>

The following is a wound evaluation that will take you home if you can not cast anymore (nerves, level 2 head/eyes, bad scars etc.):

<PRE>bleeding? || percenthealth <= 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 > 0 && [Wounds.rightArm, Wounds.rightHand, Scars.leftArm, Scars.leftHand].max > 0)</PRE>

==The Ammo/Wands Tab==
Here you find the settings to tell Bigshot where you keep all of your nifty wands and bolts and arrows. If your attack routine involves FIRE or WAND verbs, these fields must be set lest Bigshot hang up.
* find ammo in this container: - Leave BLANK if having Bigshot use FIRE without getting ammo out (Archery 2020 Update). Rather self explanatory, this field holds the location of your ammunition storage, be it a wand harness, a quiver or just your backpack.
* use this ammo type: - Leave BLANK to have Bigshot use FIRE without getting any ammo (Archery 2020 Update). Again, like specifying monsters, Bigshot is most sensative about the NOUNs that you use here. If you
* fresh wand container: - Bigshot looks in this container to find fesh wands to WAVE.
* dead wand container: - ...And then will deposit the used up wands in this container.
* use this wand type: - Here you specify which particular wand type you want to use. Bigshot will then pull only these kinds for WAVEing. Can have multiple types listed. Seperate each one with a comma. Example: "aquamarine wand, bloodwood wand, etc"
* Hide while waiting to pick up ammo - Checking this box will have Bigshot hide when gathering up your spent arrows and bolts.
* Use wands when out of mana - Bigshot will pull whatever wand you have specified in the use this wand type field and automatically stance to your attacking stance and WAVE your wand at valid targets until you are out of wands OR hit your resting conditions.

==Ingame Screenshot==
<gallery perrow="4">
File:bigshot-1.PNG|General
File:bigshot-2.PNG|Resting
File:bigshot-3.PNG|Hunting Map
File:bigshot-4.PNG|Hunting
File:bigshot-5.PNG|Attacking
File:bigshot-6.PNG|Should_hunt?
File:bigshot-7.PNG|Should_rest?
File:bigshot-8.PNG|Ammo/Wands
</gallery>

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

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