# Weapon Output Sheet Tokens

The below Tokens control how weapon and weapon proficency information is presented in Output Sheets (OS).

Token Name: WEAPON.[q.][r.]s.[RANGELIST.t.u.][AMMUNITION.v.w.][CONTENTS.x.y.]z

Variables Used (q): Text (Merge Type - Optional).

- MERGEALL - Causes all weapons with the same name to be merged - default behavior.
- MERGELOC - Causes all weapons with the same name and in the same location to be merged.
- MERGENONE - No weapons with the same name are merged.

Variables Used (r): Text (Weapon Status - Optional).

- CARRIED - Creates a 0-based index of carried or equipped weapons.
- EQUIPPED - Creates a 0-based index of equipped weapons.
- NOT_CARRIED - Creates a 0-based index of weapons that are not carried or equipped.
- NOT_EQUIPPED - Creates a 0-based index of weapons that are not equipped (although they may be carried).

Variables Used (s): Number - The weapons position in the character's weapon list - 0-based index

Subtoken Name:RANGELIST (Optional)

Variables Used (t): Number (The n-th range increment of the selected weapon - 0-based index).

Variables Used (u): Text (Weapon Property).

- None - Displays n-th range increment of the selected weapon.
- DAMAGE - Displays the damage for the n-th range increment of the selected weapon.
- TOTALHIT - Displays the complete hit progression for the n-th range increment of the selected weapon.
- TOTALHIT.x - Displays the x-th attacks to hit modifier for the n-th range increment of the selected weapon (0-based index).

Subtoken Name:AMMUNITION (Optional - Can only be used with RANGELIST)

Variables Used (v): Number (Displays the name of the n-th ammunition that will fit the selected weapon, 0-based index).

Variables Used (w): Text (Weapon Property).

- None - Displays y-th range increment of the selected weapon.
- DAMAGE - Displays the damage for the y-th range increment of the selected weapon.
- SPROP - Displays the special properties for the y-th ammunition contained by the selected weapon.
- TOTALHIT - Displays the complete hit progression for the y-th range increment of the selected weapon.
- TOTALHITx - Displays the x-th attacks to hit modifier for the range increment of the selected weapon (0-based index).

What it does:

The count of ammunition types that will fit the selected weapon.

Subtoken Name:CONTENTS (Optional - Can only be used with RANGELIST)

Variables Used (x): Number (Displays the name of the n-th ammunition contained by the selected weapon, 0-based index).

What it does:

The count of ammunition contained by the selected weapon.

Variables Used (z): Text (The weapon property to be output).

- ATTACKS - The number of attacks for weapon type (ie: 2 for double headed, etc).
- ATTACKS - The number of attacks for weapon type (ie: 2 for double headed, etc).
- BASEDAMAGE - The weapon's unadjusted damage (e.g. 1d8+3).
- BASEDAMAGEBONUS - The weapon's unadjusted damage bonus (e.g. +3).
- BASEHIT - The weapon's to hit containing most adjustments (no adjustment for two weapon fighting, even if weapons are equipped that way in the program).
- BASICDAMAGE - The weapon's damage including most adjustments (no adjustment for which hand or hands are wielding the weapon).
- BONUSDAMAGE - The weapon's bonus to damage (+1, etc.).
- CATEGORY - The weapons category, such as Mithril, Melee, Slashing, etc.
- CRIT - Weapon's Critical Range (ie 20 = 1, 19-20 = 2, 18-20 = 3, 17-20 = 4).
- DAMAGE - The amount of damage the weapon does.
- FEATHIT - Bonus to hit, based on feats.
- HAND - Hand that weapon is currently equipped in, Else none.
- HEFT - Returns LIGHT, MEDIUM or HEAVY, looking for weapon size and character size. If the weapon is smaller, then it is LIGHT.
- HIT - Weapon's modified bonus to hit, from character's total to hit bonus.
- LONGNAME - A more descriptive name.
- MAGICDAMAGE - Weapon's magical bonus to damage.
- MAGICHIT - Weapon's magical bonus to hit.
- MISC - Returns all miscellaneous to hit bonuses.
- MULT - Multiplier of Critical.
- NAME(.NOSTAR) - Weapon's name (which matches the entry from the WEAPONPROF.LST file). If .NOSTAR is appended, the asterisk indicating whether the weapon is equipped will be stripped from the output.
- NUMATTACKS - Displays the number of attacks the PC gets with the selected weapon.
- OHDAMAGE - Displays the damage done by an offhand attack with the selected weapon (e.g. 1d8+1).
- OHDAMAGEBONUS - Displays the damage bonus done by an offhand attack with the selected weapon (e.g. +1).
- RANGE - Range of weapon, in feet.
- RANGENOUNITS - Range of weapon, in feet (no ' indicator).
- RATEOFFIRE - Rate of fire of the weapon, displayed as listed in the LST files following the RATEOFFIRE tag.
- REACH - Reach of weapon, in feet.
- SIZE - Size of weapon.
- SIZEMOD - Returns the character size modifier.
- SPROP - Special Properties of weapon.
- TEMPLATE - Bonus to hit, from templates.
- THDAMAGE - Displays the damage done by a two-handed attack with the selected weapon (e.g. 2d6+4).
- THDAMAGEBONUS - Displays the damage bonus done by a two-handed attack with the selected weapon (e.g. +4).
- TOTALHIT.x - The weapon's adjusted to hit bonuses for all attacks, or for attack x if it is specified (0-based index).
- TWOHIT - The weapon's to hit bonuses if used in the off hand.
- TWPHITH - The weapon's to hit bonuses if used in the primary hand with a heavy weapon in the other hand.
- TWPHITL - The weapon's to hit bonuses if used in the primary hand with a light weapon in the other hand.
- TYPE - Type of damage the weapon does.
- WT - Weight of weapon in lbs.

What it does:

Displays various information about a character´s weapons.

With the optional RANGELIST Subtoken.

- Displays various attack information about a weapon depending on the range increment.
- The SHORTRANGE (as defined in the miscinfo.lst) is inserted into the range array if it is not already one of the weapon's standard increments.

Example:

`WEAPON.0.SIZE`

Displays the size of the first weapon.

`WEAPON.0.RANGELIST.0.DAMAGE`

Would display the damage for the the 1st range increment for the 1st weapon.

`WEAPON.0.RANGELIST.0.CONTENTS.0.DAMAGE`

Displays the damage of the 1st type of contained ammunition for point blank range fired by the 1st weapon.

`WEAPON.0.RANGELIST.0.AMMUNITION.0.DAMAGE`

Displays the damage from the 1st type of compatible ammunition at point blank range for the 1st weapon.

Token Name: WEAPONH.[r.][s.][RANGELIST.t.u.][AMMUNITION.v.w.][CONTENTS.x.y.]z

Variables Used (r): Text (Merge Type - Optional).

- MERGEALL - Causes all weapons with the same name to be merged - default behavior.
- MERGELOC - Causes all weapons with the same name and in the same location to be merged.
- MERGENONE - No weapons with the same name are merged.

Variables Used (s): Text (Weapon Status - Optional).

- CARRIED - Creates a 0-based index of carried or equipped weapons.
- EQUIPPED - Creates a 0-based index of equipped weapons.
- NOT_CARRIED - Creates a 0-based index of weapons that are not carried or equipped.
- NOT_EQUIPPED - Creates a 0-based index of weapons that are not equipped (although they may be carried).

Subtoken Name:RANGELIST (Optional)

Variables Used (t): Number (The n-th range increment of the selected weapon - 0-based index).

Variables Used (u): Text (Weapon Property).

- None - Displays n-th range increment of the selected weapon.
- DAMAGE - Displays the damage for the n-th range increment of the selected weapon.
- TOTALHIT - Displays the complete hit progression for the n-th range increment of the selected weapon.
- TOTALHIT.x - Displays the x-th attacks to hit modifier for the n-th range increment of the selected weapon (0-based index).

Subtoken Name:AMMUNITION (Optional - Can only be used with RANGELIST)

Variables Used (v): Number (Displays the name of the n-th ammunition that will fit the selected weapon, 0-based index).

Variables Used (w): Text (Weapon Property).

- None - Displays y-th range increment of the selected weapon.
- DAMAGE - Displays the damage for the y-th range increment of the selected weapon.
- SPROP - Displays the special properties for the y-th ammunition contained by the selected weapon.
- TOTALHIT - Displays the complete hit progression for the y-th range increment of the selected weapon.
- TOTALHITx - Displays the x-th attacks to hit modifier for the range increment of the selected weapon (0-based index).

What it does:

The count of ammunition types that will fit the selected weapon.

Subtoken Name:CONTENTS (Optional - Can only be used with RANGELIST)

Variables Used (x): Number (Displays the name of the n-th ammunition contained by the selected weapon, 0-based index).

What it does:

The count of ammunition contained by the selected weapon.

Variables Used (z): Text (The weapon property to be output).

- ATTACKS - The number of attacks for weapon type (ie: 2 for double headed, etc).
- ATTACKS - The number of attacks for weapon type (ie: 2 for double headed, etc).
- BASEDAMAGE - The weapon's unadjusted damage (e.g. 1d8+3).
- BASEDAMAGEBONUS - The weapon's unadjusted damage bonus (e.g. +3).
- BASEHIT - The weapon's to hit containing most adjustments (no adjustment for two weapon fighting, even if weapons are equipped that way in the program).
- BASICDAMAGE - The weapon's damage including most adjustments (no adjustment for which hand or hands are wielding the weapon).
- BONUSDAMAGE - The weapon's bonus to damage (+1, etc.).
- CATEGORY - The weapons category, such as Mithril, Melee, Slashing, etc.
- CRIT - Weapon's Critical Range (ie 20 = 1, 19-20 = 2, 18-20 = 3, 17-20 = 4).
- DAMAGE - The amount of damage the weapon does.
- FEATHIT - Bonus to hit, based on feats.
- HAND - Hand that weapon is currently equipped in, Else none.
- HEFT - Returns LIGHT, MEDIUM or HEAVY, looking for weapon size and character size. If the weapon is smaller, then it is LIGHT.
- HIT - Weapon's modified bonus to hit, from character's total to hit bonus.
- LONGNAME - A more descriptive name.
- MAGICDAMAGE - Weapon's magical bonus to damage.
- MAGICHIT - Weapon's magical bonus to hit.
- MISC - Returns all miscellaneous to hit bonuses.
- MULT - Multiplier of Critical.
- NAME(.NOSTAR) - Weapon's name (which matches the entry from the WEAPONPROF.LST file). If .NOSTAR is appended, the asterisk indicating whether the weapon is equipped will be stripped from the output.
- NUMATTACKS - Displays the number of attacks the PC gets with the selected weapon.
- OHDAMAGE - Displays the damage done by an offhand attack with the selected weapon (e.g. 1d8+1).
- OHDAMAGEBONUS - Displays the damage bonus done by an offhand attack with the selected weapon (e.g. +1).
- RANGE - Range of weapon, in feet.
- RANGENOUNITS - Range of weapon, in feet (no ' indicator).
- RATEOFFIRE - Rate of fire of the weapon, displayed as listed in the LST files following the RATEOFFIRE tag.
- REACH - Reach of weapon, in feet.
- SIZE - Size of weapon.
- SIZEMOD - Returns the character size modifier.
- SPROP - Special Properties of weapon.
- TEMPLATE - Bonus to hit, from templates.
- THDAMAGE - Displays the damage done by a two-handed attack with the selected weapon (e.g. 2d6+4).
- THDAMAGEBONUS - Displays the damage bonus done by a two-handed attack with the selected weapon (e.g. +4).
- THHIT - Displays the to-hit bonus when using a weapon with two hands.
- TOTALHIT.x - The weapon's adjusted to hit bonuses for all attacks, or for attack x if it is specified (0-based index).
- TWOHIT - The weapon's to hit bonuses if used in the off hand.
- TWPHITH - The weapon's to hit bonuses if used in the primary hand with a heavy weapon in the other hand.
- TWPHITL - The weapon's to hit bonuses if used in the primary hand with a light weapon in the other hand.
- TYPE - Type of damage the weapon does.
- WT - Weight of weapon in lbs.

What it does:

Displays various information about a character´s Unarmed Strike (in order to have this option available you must have chosen at least 1 of the Unarmed Strike item in the Items tab).

With the optional RANGELIST Subtoken.

- Displays various attack information about a weapon depending on the range increment.
- The SHORTRANGE (as defined in the miscinfo.lst) is inserted into the range array if it is not already one of the weapon's standard increments.

Example:

`WEAPONH.DAMAGE`

Displays the damage of the character´s Unarmed Attack.

Token Name: WEAPONO.[r.][s.][RANGELIST.t.u.][AMMUNITION.v.w.][CONTENTS.x.y.]z

Variables Used (r): Text (Merge Type - Optional).

- MERGEALL - Causes all weapons with the same name to be merged - default behavior.
- MERGELOC - Causes all weapons with the same name and in the same location to be merged.
- MERGENONE - No weapons with the same name are merged.

Variables Used (s): Text (Weapon Status - Optional).

- CARRIED - Creates a 0-based index of carried or equipped weapons.
- EQUIPPED - Creates a 0-based index of equipped weapons.
- NOT_CARRIED - Creates a 0-based index of weapons that are not carried or equipped.
- NOT_EQUIPPED - Creates a 0-based index of weapons that are not equipped (although they may be carried).

Subtoken Name:RANGELIST (Optional)

Variables Used (t): Number (The n-th range increment of the selected weapon - 0-based index).

Variables Used (u): Text (Weapon Property).

- None - Displays n-th range increment of the selected weapon.
- DAMAGE - Displays the damage for the n-th range increment of the selected weapon.
- TOTALHIT - Displays the complete hit progression for the n-th range increment of the selected weapon.
- TOTALHIT.x - Displays the x-th attacks to hit modifier for the n-th range increment of the selected weapon (0-based index).

Subtoken Name:AMMUNITION (Optional - Can only be used with RANGELIST)

Variables Used (v): Number (Displays the name of the n-th ammunition that will fit the selected weapon, 0-based index).

Variables Used (w): Text (Weapon Property).

- None - Displays y-th range increment of the selected weapon.
- DAMAGE - Displays the damage for the y-th range increment of the selected weapon.
- SPROP - Displays the special properties for the y-th ammunition contained by the selected weapon.
- TOTALHIT - Displays the complete hit progression for the y-th range increment of the selected weapon.
- TOTALHITx - Displays the x-th attacks to hit modifier for the range increment of the selected weapon (0-based index).

What it does:

The count of ammunition types that will fit the selected weapon.

Subtoken Name:CONTENTS (Optional - Can only be used with RANGELIST)

Variables Used (x): Number (Displays the name of the n-th ammunition contained by the selected weapon, 0-based index).

What it does:

The count of ammunition contained by the selected weapon.

Variables Used (z): Text (The weapon property to be output).

- ATTACKS - The number of attacks for weapon type (ie: 2 for double headed, etc).
- ATTACKS - The number of attacks for weapon type (ie: 2 for double headed, etc).
- BASEDAMAGE - The weapon's unadjusted damage (e.g. 1d8+3).
- BASEDAMAGEBONUS - The weapon's unadjusted damage bonus (e.g. +3).
- BASEHIT - The weapon's to hit containing most adjustments (no adjustment for two weapon fighting, even if weapons are equipped that way in the program).
- BASICDAMAGE - The weapon's damage including most adjustments (no adjustment for which hand or hands are wielding the weapon).
- BONUSDAMAGE - The weapon's bonus to damage (+1, etc.).
- CATEGORY - The weapons category, such as Mithril, Melee, Slashing, etc.
- CRIT - Weapon's Critical Range (ie 20 = 1, 19-20 = 2, 18-20 = 3, 17-20 = 4).
- DAMAGE - The amount of damage the weapon does.
- FEATHIT - Bonus to hit, based on feats.
- HAND - Hand that weapon is currently equipped in, Else none.
- HEFT - Returns LIGHT, MEDIUM or HEAVY, looking for weapon size and character size. If the weapon is smaller, then it is LIGHT.
- HIT - Weapon's modified bonus to hit, from character's total to hit bonus.
- LONGNAME - A more descriptive name.
- MAGICDAMAGE - Weapon's magical bonus to damage.
- MAGICHIT - Weapon's magical bonus to hit.
- MISC - Returns all miscellaneous to hit bonuses.
- MULT - Multiplier of Critical.
- NAME(.NOSTAR) - Weapon's name (which matches the entry from the WEAPONPROF.LST file). If .NOSTAR is appended, the asterisk indicating whether the weapon is equipped will be stripped from the output.
- NUMATTACKS - Displays the number of attacks the PC gets with the selected weapon.
- OHDAMAGE - Displays the damage done by an offhand attack with the selected weapon (e.g. 1d8+1).
- OHDAMAGEBONUS - Displays the damage bonus done by an offhand attack with the selected weapon (e.g. +1).
- RANGE - Range of weapon, in feet.
- RANGENOUNITS - Range of weapon, in feet (no ' indicator).
- RATEOFFIRE - Rate of fire of the weapon, displayed as listed in the LST files following the RATEOFFIRE tag.
- REACH - Reach of weapon, in feet.
- SIZE - Size of weapon.
- SIZEMOD - Returns the character size modifier.
- SPROP - Special Properties of weapon.
- TEMPLATE - Bonus to hit, from templates.
- THDAMAGE - Displays the damage done by a two-handed attack with the selected weapon (e.g. 2d6+4).
- THDAMAGEBONUS - Displays the damage bonus done by a two-handed attack with the selected weapon (e.g. +4).
- TOTALHIT.x - The weapon's adjusted to hit bonuses for all attacks, or for attack x if it is specified (0-based index).
- TWOHIT - The weapon's to hit bonuses if used in the off hand.
- TWPHITH - The weapon's to hit bonuses if used in the primary hand with a heavy weapon in the other hand.
- TWPHITL - The weapon's to hit bonuses if used in the primary hand with a light weapon in the other hand.
- TYPE - Type of damage the weapon does.
- WT - Weight of weapon in lbs.

What it does:

Displays various information about a character´s off-hand weapon (marked as Off Hand in the Hand selection).

With the optional RANGELIST Subtoken.

- Displays various attack information about a weapon depending on the range increment.
- The SHORTRANGE (as defined in the miscinfo.lst) is inserted into the range array if it is not already one of the weapon's standard increments.

Example:

`WEAPONO.SIZE`

Displays the size of the character´s off-hand weapon (marked as Off Hand in the Hand selection).

Token Name: WEAPONP.[r.][s.][RANGELIST.t.u.][AMMUNITION.v.w.][CONTENTS.x.y.]z

Variables Used (r): Text (Merge Type - Optional).

- MERGEALL - Causes all weapons with the same name to be merged - default behavior.
- MERGELOC - Causes all weapons with the same name and in the same location to be merged.
- MERGENONE - No weapons with the same name are merged.

Variables Used (s): Text (Weapon Status - Optional).

- CARRIED - Creates a 0-based index of carried or equipped weapons.
- EQUIPPED - Creates a 0-based index of equipped weapons.
- NOT_CARRIED - Creates a 0-based index of weapons that are not carried or equipped.
- NOT_EQUIPPED - Creates a 0-based index of weapons that are not equipped (although they may be carried).

Subtoken Name:RANGELIST (Optional)

Variables Used (t): Number (The n-th range increment of the selected weapon - 0-based index).

Variables Used (u): Text (Weapon Property).

- None - Displays n-th range increment of the selected weapon.
- DAMAGE - Displays the damage for the n-th range increment of the selected weapon.
- TOTALHIT - Displays the complete hit progression for the n-th range increment of the selected weapon.
- TOTALHIT.x - Displays the x-th attacks to hit modifier for the n-th range increment of the selected weapon (0-based index).

Subtoken Name:AMMUNITION (Optional - Can only be used with RANGELIST)

Variables Used (v): Number (Displays the name of the n-th ammunition that will fit the selected weapon, 0-based index).

Variables Used (w): Text (Weapon Property).

- None - Displays y-th range increment of the selected weapon.
- DAMAGE - Displays the damage for the y-th range increment of the selected weapon.
- SPROP - Displays the special properties for the y-th ammunition contained by the selected weapon.
- TOTALHIT - Displays the complete hit progression for the y-th range increment of the selected weapon.
- TOTALHITx - Displays the x-th attacks to hit modifier for the range increment of the selected weapon (0-based index).

What it does:

The count of ammunition types that will fit the selected weapon.

Subtoken Name:CONTENTS (Optional - Can only be used with RANGELIST)

Variables Used (x): Number (Displays the name of the n-th ammunition contained by the selected weapon, 0-based index).

What it does:

The count of ammunition contained by the selected weapon.

Variables Used (z): Text (The weapon property to be output).

- ATTACKS - The number of attacks for weapon type (ie: 2 for double headed, etc).
- ATTACKS - The number of attacks for weapon type (ie: 2 for double headed, etc).
- BASEDAMAGE - The weapon's unadjusted damage (e.g. 1d8+3).
- BASEDAMAGEBONUS - The weapon's unadjusted damage bonus (e.g. +3).
- BASEHIT - The weapon's to hit containing most adjustments (no adjustment for two weapon fighting, even if weapons are equipped that way in the program).
- BASICDAMAGE - The weapon's damage including most adjustments (no adjustment for which hand or hands are wielding the weapon).
- BONUSDAMAGE - The weapon's bonus to damage (+1, etc.).
- CATEGORY - The weapons category, such as Mithril, Melee, Slashing, etc.
- CRIT - Weapon's Critical Range (ie 20 = 1, 19-20 = 2, 18-20 = 3, 17-20 = 4).
- DAMAGE - The amount of damage the weapon does.
- FEATHIT - Bonus to hit, based on feats.
- HAND - Hand that weapon is currently equipped in, Else none.
- HEFT - Returns LIGHT, MEDIUM or HEAVY, looking for weapon size and character size. If the weapon is smaller, then it is LIGHT.
- HIT - Weapon's modified bonus to hit, from character's total to hit bonus.
- LONGNAME - A more descriptive name.
- MAGICDAMAGE - Weapon's magical bonus to damage.
- MAGICHIT - Weapon's magical bonus to hit.
- MISC - Returns all miscellaneous to hit bonuses.
- MULT - Multiplier of Critical.
- NAME(.NOSTAR) - Weapon's name (which matches the entry from the WEAPONPROF.LST file). If .NOSTAR is appended, the asterisk indicating whether the weapon is equipped will be stripped from the output.
- NUMATTACKS - Displays the number of attacks the PC gets with the selected weapon.
- OHDAMAGE - Displays the damage done by an offhand attack with the selected weapon (e.g. 1d8+1).
- OHDAMAGEBONUS - Displays the damage bonus done by an offhand attack with the selected weapon (e.g. +1).
- RANGE - Range of weapon, in feet.
- RANGENOUNITS - Range of weapon, in feet (no ' indicator).
- RATEOFFIRE - Rate of fire of the weapon, displayed as listed in the LST files following the RATEOFFIRE tag.
- REACH - Reach of weapon, in feet.
- SIZE - Size of weapon.
- SIZEMOD - Returns the character size modifier.
- SPROP - Special Properties of weapon.
- TEMPLATE - Bonus to hit, from templates.
- THDAMAGE - Displays the damage done by a two-handed attack with the selected weapon (e.g. 2d6+4).
- THDAMAGEBONUS - Displays the damage bonus done by a two-handed attack with the selected weapon (e.g. +4).
- TOTALHIT.x - The weapon's adjusted to hit bonuses for all attacks, or for attack x if it is specified (0-based index).
- TWOHIT - The weapon's to hit bonuses if used in the off hand.
- TWPHITH - The weapon's to hit bonuses if used in the primary hand with a heavy weapon in the other hand.
- TWPHITL - The weapon's to hit bonuses if used in the primary hand with a light weapon in the other hand.
- TYPE - Type of damage the weapon does.
- WT - Weight of weapon in lbs.

What it does:

Displays various information about a character´s primary weapon (marked as Primary in the Hand selection).

With the optional RANGELIST Subtoken.

- Displays various attack information about a weapon depending on the range increment.
- The SHORTRANGE (as defined in the miscinfo.lst) is inserted into the range array if it is not already one of the weapon's standard increments.

Example:

`WEAPONP.WT`

Displays the weight of the character´s primary weapon (marked as Primary in the Hand selection).

Token Name: WEAPONPROFS

What it does:

Displays the characters weapon proficiencies.

Example:

`WEAPONPROFS`

Displays the characters weapon proficiencies.