Lich:Script Bigshot - Revision history

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

2026-09-14T20:55:19Z

Creature Checks: add lying command check

← Older revision		Revision as of 15:55, 14 September 2026
Line 349:		Line 349:
	* '''stunned''' - Target is stunned.		* '''stunned''' - Target is stunned.
	* '''webbed''' - Target is webbed.		* '''webbed''' - Target is webbed.
			* '''lying''' - Target is lying down (prone).

	Creature type/classification checks, also read from the game feed. Each performs the command only when the target carries that classification (add <CODE>!</CODE> to require that it does not):		Creature type/classification checks, also read from the game feed. Each performs the command only when the target carries that classification (add <CODE>!</CODE> to require that it does not):

HORIBU1: A few changes to remove version notes

2026-09-11T00:59:52Z

A few changes to remove version notes

HORIBU1: updated to latest 5.16.0 content

2026-09-11T00:50:14Z

updated to latest 5.16.0 content

← Older revision		Revision as of 19:50, 10 September 2026
Line 35:		Line 35:
	* <CODE>;bigshot display</CODE> - Shows all your current settings.		* <CODE>;bigshot display</CODE> - Shows all your current settings.
	* <CODE>;bigshot reset</CODE> - Resets your targetable and untargetable lists. Useful if Bigshot will not target something it should.		* <CODE>;bigshot reset</CODE> - Resets your targetable and untargetable lists. Useful if Bigshot will not target something it should.
	* <CODE>;bigshot ranger</CODE> or <CODE>;bigshot companion</CODE> - Resets the ranger companion setting so you can reconfigure it. Use this when you change your companion.
	* <CODE>;bigshot profile save <name></CODE> - Saves a profile in YAML format to your character's profile folder. Also accessible via the Profiles tab.		* <CODE>;bigshot profile save <name></CODE> - Saves a profile in YAML format to your character's profile folder. Also accessible via the Profiles tab.
	* <CODE>;bigshot profile load <name></CODE> - Loads a profile from your character's profile folder. Also accessible via the Profiles tab.		* <CODE>;bigshot profile load <name></CODE> - Loads a profile from your character's profile folder. Also accessible via the Profiles tab.
Line 41:		Line 40:
	* <CODE>;bigshot list</CODE> - Displays all initialized variable values (useful for troubleshooting).		* <CODE>;bigshot list</CODE> - Displays all initialized variable values (useful for troubleshooting).
	* <CODE>;bigshot test <method> <args></CODE> - Runs a specific internal method for testing purposes.		* <CODE>;bigshot test <method> <args></CODE> - Runs a specific internal method for testing purposes.
			* <CODE>;bigshot help</CODE> - '''(New in v5.16.0)''' Prints a quick-reference table of every command-line option listed in this section. Typing an option Bigshot doesn't recognize now prints this same help (with a warning naming the bad option) instead of silently doing nothing.
	* <CODE>;bigshot <creature></CODE> - Any input that does not match the above commands defaults to ranger tracking (e.g., <CODE>;bigshot single giant rat</CODE> will track and hunt a giant rat).
			* <CODE>;bigshot <mode> <creature></CODE> - Rangers only: combine one of the modes above (<CODE>solo</CODE>, <CODE>single</CODE>, <CODE>bounty</CODE>, <CODE>quick</CODE>, or <CODE>once</CODE>) with a creature name to TRACK toward that creature instead of wandering, e.g., <CODE>;bigshot single giant rat</CODE>. A creature name with no mode in front of it (just <CODE>;bigshot giant rat</CODE>) is not recognized.

	==The Profile Tab==		==The Profile Tab==
Line 198:		Line 198:
	** '''<spell number>''' - Casts the specified spell using PREPARE and CAST.		** '''<spell number>''' - Casts the specified spell using PREPARE and CAST.
	** '''wand''' - Gets a wand from your specified container and WAVEs it at the target.		** '''wand''' - Gets a wand from your specified container and WAVEs it at the target.
	** '''wandolier''' - Similar to wand, but designed for wandoliers. Gets a wand from the fresh wand container and waves it; rubs the container if no wands are found. Default waves in offensive stance. Use <CODE>wandolier defensive</CODE> to wave in a different stance.		** '''wandolier <stance> <noreserve>''' - Similar to wand, but designed for wandoliers. Gets a wand from the fresh wand container and waves it; rubs the container if no wands are found. Default waves in offensive stance and automatically adds the wand to your RESERVE list. Use <CODE>wandolier defensive</CODE> to wave in a different stance, and add <CODE>noreserve</CODE> to skip the RESERVE step, e.g., <CODE>wandolier defensive noreserve</CODE>.
			** '''resonance <spell id> <spell id> ...''' - Casts Resonance Bolt, picking randomly among the listed spell numbers each time (never repeating the one it just used back-to-back). Example: <CODE>resonance 511 512 513</CODE>.
			** '''sacrifice''' - Performs a Voln Sacrifice on the current target's corpse for favor. Only attempts it when you have 2+ spirit, the ability is off cooldown, and the corpse appraises as suitable for sacrifice.
	** '''fire''' - Gets ammunition from your specified container and FIREs at the target. Aims based on Archery aiming settings on the Attacking tab.		** '''fire''' - Gets ammunition from your specified container and FIREs at the target. Aims based on Archery aiming settings on the Attacking tab.
	** '''aim <location>''' - Aims at the specified body location.		** '''aim <location>''' - Aims at the specified body location.
Line 317:		Line 319:
	* '''e#''' - Requires encumbrance percentage to be at or below #.		* '''e#''' - Requires encumbrance percentage to be at or below #.
	* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).		* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).
			* '''thp#''' - '''(New in v5.16.0)''' Requires the ''target's'' health to be at or below #% (this is the target's health, unlike h# above which checks your own). <CODE>(!thp#)</CODE> requires the target's health to be above #%. If Bigshot can't determine the target's health, the command is skipped.

	====Creature Checks====		====Creature Checks====
Line 335:		Line 338:
	* '''noncorporeal''' - Performs the command if the NPC is [[noncorporeal\|non-corporeal]] undead.		* '''noncorporeal''' - Performs the command if the NPC is [[noncorporeal\|non-corporeal]] undead.
	* '''ancient''' - Checks for grizzled/ancient creatures.		* '''ancient''' - Checks for grizzled/ancient creatures.

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

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

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

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

	====Self Checks====		====Self Checks====
Line 343:		Line 379:
	* '''outside''' - Performs the command if the room is outdoors.		* '''outside''' - Performs the command if the room is outdoors.
	* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.		* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.
			* '''k#''' - Performs the command only while you are kneeling. The number is required by the syntax but its value doesn't matter (e.g. <CODE>k1</CODE>). <CODE>(!k#)</CODE> performs the command only while you are NOT kneeling.

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

	====Buff Checks====		====Buff Checks====
Line 368:		Line 406:
	* '''coupdegrace''' - Checks for the Empowered buff from Coup de Grace.		* '''coupdegrace''' - Checks for the Empowered buff from Coup de Grace.
	* '''animate''' - Checks for whether you have an animate present.		* '''animate''' - Checks for whether you have an animate present.
			* '''empowered#''' - '''(New in v5.16.0)''' Skips the command if an Empowered buff of +# or greater is already active, so a strong Coup de Grace bonus can't get overwritten by a weaker recast. <CODE>(!empowered#)</CODE> skips unless already at +# or greater.
	* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds. Supported for barrage, bearhug, coupdegrace, fury, ~~flurry~~, pummel, thrash, ~~shout~~, yowlp, ~~garrote~~.		* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds remaining. Supported for barrage, bearhug, coupdegrace, flurry, fury, garrote, pummel, shout, thrash, weed/kweed, yowlp. (Fixed in v5.16.0 — this check previously did nothing due to a bug.)
	* '''censer''' - Attempts to cast 320 before your command, checking mana and cooldown. Examples: <CODE>309(censer)</CODE>, <CODE>335(censer mob3)</CODE>, <CODE>attack(censer)</CODE>		* '''censer''' - Attempts to cast 320 before your command, checking mana and cooldown. Examples: <CODE>309(censer)</CODE>, <CODE>335(censer mob3)</CODE>, <CODE>attack(censer)</CODE>
	** If the command is a spell, censer only casts if you have mana for both 320 and the spell.		** If the command is a spell, censer only casts if you have mana for both 320 and the spell.
Line 630:		Line 669:
	<pre{{log2}}>		<pre{{log2}}>
	+---------------------------------------------------------------------------+		+---------------------------------------------------------------------------+
	\| Bigshot Debug Help v5.11.4 \|		\| Bigshot Debug Help v5.16.0 \|
	+---------------------------------------------------------------------------+		+---------------------------------------------------------------------------+
	\| Debug options have changed to be more helpful. \|		\| Debug options have changed to be more helpful. \|
Line 647:		Line 686:

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

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

	==Ingame Screenshot==		==Ingame Screenshot==

WHITEJ63: /* The Attacking Tab */ clarified that 'flee from environmental damage' does not work when using ;bigshot quick

2026-07-16T22:10:35Z

The Attacking Tab: clarified that 'flee from environmental damage' does not work when using ;bigshot quick

← Older revision		Revision as of 17:10, 16 July 2026
Line 178:		Line 178:
	* '''...but don't count these''' - Bigshot ignores these monsters when evaluating flee count. Useful when low-level monsters are mixed into your hunting area.		* '''...but don't count these''' - Bigshot ignores these monsters when evaluating flee count. Useful when low-level monsters are mixed into your hunting area.
	* '''...and always flee from''' - Bigshot immediately flees from these monsters. Useful when your hunting area has higher-level or dangerous monsters mixed in.		* '''...and always flee from''' - Bigshot immediately flees from these monsters. Useful when your hunting area has higher-level or dangerous monsters mixed in.
	* '''flee from environment message''' - Bigshot flees whenever the game sends a message matching this text (uses XML regex matching).		* '''flee from environment message''' - Bigshot flees whenever the game sends a message matching this text (uses XML regex matching). Note: This does not work when using <CODE>;bigshot quick.</CODE>
	* '''wait before wandering to another room''' - Time in seconds before moving to a new room. Default is 0.3. Set to 0 to move instantly (can be spammy for others in the area).		* '''wait before wandering to another room''' - Time in seconds before moving to a new room. Default is 0.3. Set to 0 to move instantly (can be spammy for others in the area).
	* '''Approach lone targets only''' - Forces Bigshot to only begin combat against creatures that are alone in a room.		* '''Approach lone targets only''' - Forces Bigshot to only begin combat against creatures that are alone in a room.
Line 645:		Line 645:
	\| ;bigshot debug combat commands status <true/false> \|		\| ;bigshot debug combat commands status <true/false> \|
	+---------------------------------------------------------------------------+		+---------------------------------------------------------------------------+
	</pre>

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

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

2026-03-17T16:01:33Z

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

← Older revision		Revision as of 11:01, 17 March 2026
Line 266:		Line 266:
	* '''stance perfection''' - Put 10, 20, 30, etc. in your attack stance box to take advantage of stance perfection.		* '''stance perfection''' - Put 10, 20, 30, etc. in your attack stance box to take advantage of stance perfection.
	* '''chastise, excoriate''' - Performs the FEAT if available and affordable.		* '''chastise, excoriate''' - Performs the FEAT if available and affordable.
	* '''rebuke''' - Performs Righteous Rebuke.
	* '''scourge''' - Performs Ardor of the Scourge.
	* '''momentum''' - Performs Glorious Momentum.

	===Gemstone Activation===		===Gemstone Activation===

WHIGHTCNIGHT: /* Command Checks */

2026-03-17T15:41:30Z

Command Checks

← Older revision		Revision as of 10:41, 17 March 2026
Line 313:		Line 313:
	Each check also has an inverse — prefix with <CODE>!</CODE> to negate. Example: <CODE>kill(!m20 !s5 !e20)</CODE>		Each check also has an inverse — prefix with <CODE>!</CODE> to negate. Example: <CODE>kill(!m20 !s5 !e20)</CODE>

	====Resource and Status Checks:====		====Resource and Status Checks====
	* '''s#''' - Requires at least # stamina.		* '''s#''' - Requires at least # stamina.
	* '''m#''' - Requires at least # mana.		* '''m#''' - Requires at least # mana.
Line 321:		Line 321:
	* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).		* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).

	====Creature Checks:====		====Creature Checks====
	* '''mob#''' - Requires at least # NPCs in the room. Only useful for 2 or more creatures.		* '''mob#''' - Requires at least # NPCs in the room. Only useful for 2 or more creatures.
	<PRE>To further clarify the mob# implementation:		<PRE>To further clarify the mob# implementation:
Line 339:		Line 339:
	* '''ancient''' - Checks for grizzled/ancient creatures.		* '''ancient''' - Checks for grizzled/ancient creatures.

	====Self Checks:====		====Self Checks====
	* '''hidden''' - Performs the command if you are currently hidden.		* '''hidden''' - Performs the command if you are currently hidden.
	* '''poison''' - Performs the command if you are currently poisoned.		* '''poison''' - Performs the command if you are currently poisoned.
Line 347:		Line 347:
	* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.		* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.

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

	====Buff Checks:====		====Buff Checks====
	* '''barrage''' - Checks for the Enhanced Dexterity buff from Barrage.		* '''barrage''' - Checks for the Enhanced Dexterity buff from Barrage.
	* '''fury''' - Checks for the Enhanced Constitution buff from Fury.		* '''fury''' - Checks for the Enhanced Constitution buff from Fury.
Line 376:		Line 376:
	** If the command is not a spell, censer only checks you have enough mana for 320.		** If the command is not a spell, censer only checks you have enough mana for 320.

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

WHIGHTCNIGHT: /* Command Checks */ header changes

2026-03-17T15:40:02Z

Command Checks: header changes

← Older revision		Revision as of 10:40, 17 March 2026
Line 313:		Line 313:
	Each check also has an inverse — prefix with <CODE>!</CODE> to negate. Example: <CODE>kill(!m20 !s5 !e20)</CODE>		Each check also has an inverse — prefix with <CODE>!</CODE> to negate. Example: <CODE>kill(!m20 !s5 !e20)</CODE>

	~~'''~~Resource and Status Checks:~~'''~~		====Resource and Status Checks:====
	* '''s#''' - Requires at least # stamina.		* '''s#''' - Requires at least # stamina.
	* '''m#''' - Requires at least # mana.		* '''m#''' - Requires at least # mana.
Line 321:		Line 321:
	* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).		* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).

	~~'''~~Creature Checks:~~'''~~		====Creature Checks:====
	* '''mob#''' - Requires at least # NPCs in the room. Only useful for 2 or more creatures.		* '''mob#''' - Requires at least # NPCs in the room. Only useful for 2 or more creatures.
	<PRE>To further clarify the mob# implementation:		<PRE>To further clarify the mob# implementation:
Line 339:		Line 339:
	* '''ancient''' - Checks for grizzled/ancient creatures.		* '''ancient''' - Checks for grizzled/ancient creatures.

	~~'''~~Self Checks:~~'''~~		====Self Checks:====
	* '''hidden''' - Performs the command if you are currently hidden.		* '''hidden''' - Performs the command if you are currently hidden.
	* '''poison''' - Performs the command if you are currently poisoned.		* '''poison''' - Performs the command if you are currently poisoned.
Line 347:		Line 347:
	* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.		* '''splashy''' - Checks if the room is "splashy" (wet) via Room.tags. Useful for avoiding lightning attacks in wet rooms.

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

	~~'''~~Buff Checks:~~'''~~		====Buff Checks:====
	* '''barrage''' - Checks for the Enhanced Dexterity buff from Barrage.		* '''barrage''' - Checks for the Enhanced Dexterity buff from Barrage.
	* '''fury''' - Checks for the Enhanced Constitution buff from Fury.		* '''fury''' - Checks for the Enhanced Constitution buff from Fury.
Line 376:		Line 376:
	** If the command is not a spell, censer only checks you have enough mana for 320.		** If the command is not a spell, censer only checks you have enough mana for 320.

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

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

2026-02-09T16:57:34Z

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

← Older revision		Revision as of 11:57, 9 February 2026
Line 375:		Line 375:
	** If the command is a spell, censer only casts if you have mana for both 320 and the spell.		** If the command is a spell, censer only casts if you have mana for both 320 and the spell.
	** If the command is not a spell, censer only checks you have enough mana for 320.		** If the command is not a spell, censer only checks you have enough mana for 320.

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

	===Example Attack Routines===		===Example Attack Routines===

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

2026-02-08T00:57:08Z

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

Show changes

HORIBU1: /* Command Checks */ add essence and splashy command checks

2026-01-26T17:24:12Z

Command Checks: add essence and splashy command checks

← Older revision		Revision as of 12:24, 26 January 2026
Line 329:		Line 329:
	*momentum - Checks for Glorious Momentum buff		*momentum - Checks for Glorious Momentum buff
	*coupdegrace - Checks for Empowered buff.		*coupdegrace - Checks for Empowered buff.
			*essence# - checks you have the required Shadow Essence
			*splashy - checks if the room is "splashy" via Room.tags, useful to not do lightning attacks in wet rooms
	**If command is a spell, will only cast censer if you have the mana for censer and the spell you intend.		**If command is 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.		**If command is not a spell, will only check you have enough mana for the censer.

← Older revision		Revision as of 19:59, 10 September 2026
Line 40:		Line 40:
	* <CODE>;bigshot list</CODE> - Displays all initialized variable values (useful for troubleshooting).		* <CODE>;bigshot list</CODE> - Displays all initialized variable values (useful for troubleshooting).
	* <CODE>;bigshot test <method> <args></CODE> - Runs a specific internal method for testing purposes.		* <CODE>;bigshot test <method> <args></CODE> - Runs a specific internal method for testing purposes.
	* <CODE>;bigshot help</CODE> - ~~'''(New in v5.16.0)'''~~ Prints a quick-reference table of every command-line option listed in this section. Typing an option Bigshot doesn't recognize ~~now~~ prints this same help (with a warning naming the bad option) instead of silently doing nothing.		* <CODE>;bigshot help</CODE> - Prints a quick-reference table of every command-line option listed in this section. Typing an option Bigshot doesn't recognize prints this same help (with a warning naming the bad option) instead of silently doing nothing.
	* <CODE>;bigshot <mode> <creature></CODE> - Rangers only: combine one of the modes above (<CODE>solo</CODE>, <CODE>single</CODE>, <CODE>bounty</CODE>, <CODE>quick</CODE>, or <CODE>once</CODE>) with a creature name to TRACK toward that creature instead of wandering, e.g., <CODE>;bigshot single giant rat</CODE>. A creature name with no mode in front of it (just <CODE>;bigshot giant rat</CODE>) is not recognized.		* <CODE>;bigshot <mode> <creature></CODE> - Rangers only: combine one of the modes above (<CODE>solo</CODE>, <CODE>single</CODE>, <CODE>bounty</CODE>, <CODE>quick</CODE>, or <CODE>once</CODE>) with a creature name to TRACK toward that creature instead of wandering, e.g., <CODE>;bigshot single giant rat</CODE>. A creature name with no mode in front of it (just <CODE>;bigshot giant rat</CODE>) is not recognized.

Line 319:		Line 319:
	* '''e#''' - Requires encumbrance percentage to be at or below #.		* '''e#''' - Requires encumbrance percentage to be at or below #.
	* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).		* '''essence#''' - Requires at least # Shadow Essence (Sorcerer).
	* '''thp#''' - ~~'''(New in v5.16.0)'''~~ Requires the ''target's'' health to be at or below #% (this is the target's health, unlike h# above which checks your own). <CODE>(!thp#)</CODE> requires the target's health to be above #%. If Bigshot can't determine the target's health, the command is skipped.		* '''thp#''' - Requires the ''target's'' health to be at or below #% (this is the target's health, unlike h# above which checks your own). <CODE>(!thp#)</CODE> requires the target's health to be above #%. If Bigshot can't determine the target's health, the command is skipped.

	====Creature Checks====		====Creature Checks====
Line 339:		Line 339:
	* '''ancient''' - Checks for grizzled/ancient creatures.		* '''ancient''' - Checks for grizzled/ancient creatures.

	~~'''(New in v5.16.0)'''~~ The following checks read the target's live status directly from the game feed, so they can be more precise than the umbrella '''prone''' check above. Each performs the command only when the target IS in that state (add <CODE>!</CODE> to require that it is NOT):		The following checks read the target's live status directly from the game feed, so they can be more precise than the umbrella '''prone''' check above. Each performs the command only when the target IS in that state (add <CODE>!</CODE> to require that it is NOT):
	* '''calm''' - Target is calmed.		* '''calm''' - Target is calmed.
	* '''disoriented''' - Target is disoriented.		* '''disoriented''' - Target is disoriented.
Line 350:		Line 350:
	* '''webbed''' - Target is webbed.		* '''webbed''' - Target is webbed.

	~~'''(New in v5.16.0)'''~~ Creature type/classification checks, also read from the game feed. Each performs the command only when the target carries that classification (add <CODE>!</CODE> to require that it does not):		Creature type/classification checks, also read from the game feed. Each performs the command only when the target carries that classification (add <CODE>!</CODE> to require that it does not):
	* '''mount''' - Target is a mount.		* '''mount''' - Target is a mount.
	* '''rider''' - Target is riding a mount.		* '''rider''' - Target is riding a mount.
Line 361:		Line 361:
	* '''sympathetic''' - Target is flagged as sympathetic (non-hostile).		* '''sympathetic''' - Target is flagged as sympathetic (non-hostile).

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

	~~'''(New in v5.16.0)'''~~ Target-specific UCS positioning checks — these read the ''target's'' individual unarmed-combat positioning, unlike the '''tier#''' checks above which track your own overall UAC tier. Each performs the command only when your positioning against ''that specific target'' matches (add <CODE>!</CODE> to require that it does not):		Target-specific UCS positioning checks — these read the ''target's'' individual unarmed-combat positioning, unlike the '''tier#''' checks above which track your own overall UAC tier. Each performs the command only when your positioning against ''that specific target'' matches (add <CODE>!</CODE> to require that it does not):
	* '''ucsdecent''' - Positioning is "decent".		* '''ucsdecent''' - Positioning is "decent".
	* '''ucsgood''' - Positioning is "good".		* '''ucsgood''' - Positioning is "good".
Line 384:		Line 384:
	* '''once''' - Performs the command once per target. Resets on room change.		* '''once''' - Performs the command once per target. Resets on room change.
	* '''room''' - Performs the command once per room. Resets on room change.		* '''room''' - Performs the command once per room. Resets on room change.
	* '''repeatdelay#''' - ~~'''(New in v5.15.0)'''~~ Throttles the command to once every # seconds per room, regardless of which target it's used against. Resets on room change. Example: <CODE>holler(repeatdelay60)</CODE> will not Holler again for 60 seconds after it last went off in that room.		* '''repeatdelay#''' - Throttles the command to once every # seconds per room, regardless of which target it's used against. Resets on room change. Example: <CODE>holler(repeatdelay60)</CODE> will not Holler again for 60 seconds after it last went off in that room.

	====Buff Checks====		====Buff Checks====
Line 406:		Line 406:
	* '''coupdegrace''' - Checks for the Empowered buff from Coup de Grace.		* '''coupdegrace''' - Checks for the Empowered buff from Coup de Grace.
	* '''animate''' - Checks for whether you have an animate present.		* '''animate''' - Checks for whether you have an animate present.
	* '''empowered#''' - ~~'''(New in v5.16.0)'''~~ Skips the command if an Empowered buff of +# or greater is already active, so a strong Coup de Grace bonus can't get overwritten by a weaker recast. <CODE>(!empowered#)</CODE> skips unless already at +# or greater.		* '''empowered#''' - Skips the command if an Empowered buff of +# or greater is already active, so a strong Coup de Grace bonus can't get overwritten by a weaker recast. <CODE>(!empowered#)</CODE> skips unless already at +# or greater.
	* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds remaining. Supported for barrage, bearhug, coupdegrace, flurry, fury, garrote, pummel, shout, thrash, weed/kweed, yowlp. ~~(Fixed in v5.16.0 — this check previously did nothing due to a bug.)~~		* '''buffXX''' - Fires the ability when the buff duration is <= XX seconds remaining. Supported for barrage, bearhug, coupdegrace, flurry, fury, garrote, pummel, shout, thrash, weed/kweed, yowlp.
	* '''censer''' - Attempts to cast 320 before your command, checking mana and cooldown. Examples: <CODE>309(censer)</CODE>, <CODE>335(censer mob3)</CODE>, <CODE>attack(censer)</CODE>		* '''censer''' - Attempts to cast 320 before your command, checking mana and cooldown. Examples: <CODE>309(censer)</CODE>, <CODE>335(censer mob3)</CODE>, <CODE>attack(censer)</CODE>
	** If the command is a spell, censer only casts if you have mana for both 320 and the spell.		** If the command is a spell, censer only casts if you have mana for both 320 and the spell.
Line 687:		Line 687:
	Debug log files are stored in your Lich5 logs directory under <CODE>debug/<Game>-<CharacterName>/bigshot.log</CODE> and rotate daily.		Debug log files are stored in your Lich5 logs directory under <CODE>debug/<Game>-<CharacterName>/bigshot.log</CODE> and rotate daily.

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

	==Ingame Screenshot==		==Ingame Screenshot==