Game Mode: sizeAdjustment.lst

The sizeAdjustment.lst is a part of the "game mode".

sizeAdjustment.lst defines:

The sizeAdjustment.lst files can be found in the system/gameModes/<game_mode_name>/ directory for each game mode.

Structure of the sizeAdjustment.lst file

Each creature size is identified by a SIZENAME .

Tokens are added to the SIZENAME to indicate the in-game effects of the creature's size. The SIZENUM token is mandatory; all others are optional.

A typical size definition, from system/gameModes/35e/sizeAdjustment.lst , looks like:

SIZENAME:S
  →  ABB:S
  →  DISPLAYNAME:Small
  →  BONUS:ITEMCOST|TYPE=Ammunition,TYPE=Armor,TYPE=Shield,TYPE=Weapon|1
SIZENAME:S
  →  BONUS:ITEMWEIGHT|TYPE=Ammunition,TYPE=Armor,TYPE=Shield,TYPE=Weapon|0.5
  →  BONUS:ITEMWEIGHT|TYPE=Goods|0.25
SIZENAME:S
  →  BONUS:ACVALUE|TYPE.Armor,TYPE.Shield|1
  →  BONUS:COMBAT|AC|1|TYPE=Size
  →  BONUS:COMBAT|TOHIT|1|TYPE=SIZE
  →  BONUS:COMBAT|TOHIT.GRAPPLE|-5|TYPE=Size
SIZENAME:S
  →  BONUS:ITEMCAPACITY|TYPE=Goods|0.25
SIZENAME:S
  →  BONUS:SKILL|Hide|4|TYPE=SIZE
SIZENAME:S
  →  BONUS:LOADMULT|TYPE=SIZE|0.25|PRELEGSGTEQ:4
SIZENAME:S
  →  BONUS:STAT|STR|2|PREBASESIZELT:Tiny|PREVAREQ:BypassSizeMods,0
  →  BONUS:STAT|STR|4|PREBASESIZELT:Small|PREVAREQ:BypassSizeMods,0
SIZENAME:S
  →  BONUS:STAT|DEX|-2|PREBASESIZEEQ:Fine|PREVAREQ:BypassSizeMods,0
  →  BONUS:STAT|DEX|-2|PREBASESIZELT:Tiny|PREVAREQ:BypassSizeMods,0
  →  BONUS:STAT|DEX|-2|PREBASESIZELT:Small|PREVAREQ:BypassSizeMods,0
SIZENAME:S
  →  SIZENUM:040

Tags

ABB

Optional: A one letter abbreviation of the size name.

Syntax

ABB:X , where X is a single letter.

Example

SIZENAME:Fine → ABB:F sets the abbreviation for the Fine size to the letter F .

Notes

The ABB tag is implemented in code/src/java/plugin/lsttokens/sizeadjustment/AbbToken.java .


ISDEFAULTSIZE

Mandatory: Marks which of the creature sizes is the default for the game mode.

Syntax

SIZENAME:size_1 → ISDEFAULTSIZE:Y indicates that size_1 is the default size for the game mode.

SIZENAME:size_2 → ISDEFAULTSIZE:N indicates that size_2 is not the default size.

Example

SIZENAME:Medium → ISDEFAULTSIZE:Y makes Medium the default size for this game mode.

Notes

There must be one, and only one, size marked as the default size.

If the ISDEFAULTSIZE tag is missing for a particular SIZENAME , then ISDEFAULTSIZE:N is assumed.


SIZENAME

Identifies a creature size category.

Each line of the sizeAdjustment.lst file MUST begin with a SIZENAME tag. Features are added to the category by adding sub-tags after the SIZENAME , such as BONUS tags.

The same SIZENAME may appear on multiple lines. The tokens following the SIZENAME are appended to any tokens for the same SIZENAME on preceding lines.

Status

New in 5.10.1.

Syntax

SIZENAME:size_name , where size_name is a single letter, i.e. S , M , L . This is the current standard for all game modes included in PCGen.

Alternately, size_name may be a single word such as Small , Medium , Large , etc.

Example:

SIZENAME:F defines a creature size named F . (This form is preferred.)

SIZENAME:Fine defines a creature size Fine .


SIZENUM

Mandatory: Defines the sorting order for the size categories.

Status

New in 6.05.04.

Before 6.05.04, the size order was inferred from the order of the SIZENAME tags in the sizeAdjustment.lst file. As of 6.05.04, the order is explicitly indicated using the SIZENUM tag.

Syntax:

SIZENAME:size_name → SIZENUM:size_number

size_number is an integer. Bigger numbers correspond to larger size categories.

Example:

The following code, included in the 35e version of sizeAdjustment.lst , defines the ordering of the 35e size categories:

SIZENAME:F  SIZENUM:010
SIZENAME:D  SIZENUM:020
SIZENAME:T  SIZENUM:030
SIZENAME:S  SIZENUM:040
SIZENAME:M  SIZENUM:050
SIZENAME:L  SIZENUM:060
SIZENAME:H  SIZENUM:070
SIZENAME:G  SIZENUM:080
SIZENAME:C  SIZENUM:090
SIZENAME:P  SIZENUM:100

Global BONUS tags which are useful in sizeAdjustment.lst

All global BONUS tags may be used in sizeAdjustment.lst .

Some useful tags include:


BONUS tags specific to sizeAdjustment.lst

The following BONUS tags function only in the sizeAdjustment.lst file.

BONUS:ACVALUE

Multiplies the AC bonus from a particular type of armour, such as Armor or Shield , based on the creature's size.

Status

New in 5.10.1.

Syntax

BONUS:ACVALUE|TYPE:type_1,TYPE:type_2, ...|ac_multiplier

Examples

Halves the benefit from armour and shields.

Doubles the benefit from armour and shields.


BONUS:ITEMCAPACITY

Changes the "item carrying capacity" based on the size of the character.

This is used to implement the DnD 3.5 rule for equipment made in different sizes for different creatures, such as backpacks and bed-rolls. These items "... weigh one-quarter this amount when made for Small characters. Containers for Small characters also carry one-quarter the normal amount. " ( Refer to the d20 SRD. )

Status

New in 5.10.1

Syntax

BONUS:ITEMCAPACITY|TYPE=item_type|capacity_multiplier

Examples

Reduces the carrying capacity of items of TYPE=Resizable to one quarter of the normal value.

Increases the carrying capacity of TYPE=Goods to double the normal value.


BONUS:ITEMCOST

Modifies the cost of items based on the item's size category, i.e. the size of the creature the item was made for.

For example, in 3.5e, a large-sized weapon costs twice as much as a medium-sized weapon, and large-sized armour costs twice as much as medium-sized armour.

Status

New in 5.10.1

Syntax

BONUS:ITEMCOST|TYPE=item_type_1,TYPE=item_type_2,...|cost_multiplier

Examples

Halves the cost of weapons.

Doubles the cost of weapons and armour.

Leaves the cost of scrolls and potions un-modified.

Doubles the costs of all items of type Alchemical, Liquid, Clothing, or Food.


BONUS:ITEMWEIGHT

Modifies the weight of items based on the item's size category, i.e. the size of the creature the item was made for.

For example, in 3.5e, armour for small-size creatures weighs half as much as armour for medium-sized creatures.

Status

New in 5.10.1.

Syntax

BONUS:ITEMWEIGHT|TYPE=item_type_1,TYPE=item_type_2,...|weight_multiplier

Example

Doubles the weight of armour made for a creature of this size.

Reduces the weight of Resiable items, such as backpacks and bedrolls, to one-quarter the normal value.


BONUS:LOADMULT

Adds to the SIZEMULT value as defined in the load.lst game mode file.

Mostly, the rules for "Large creatures can carry twice as much weight" and so on are implemented in load.lst . The BONUS:LOADMULT tag is used to implement rules for creatures with four legs having greater load-carrying capacity.

Status

New in 5.10.1

Syntax

BONUS:LOADMULT|TYPE=SIZE|sizemult_modifier

Examples

Increases the creature's carrying capacity by one multiple of the normal carrying capacity. This adds with the multiplier already defined for the creature's size category, in load.lst .

For example, in DnD 3.5e, a huge-size creature can already carry four times the load of a medium-size creature. This is defined by the code SIZEMULT:H|4 in load.lst .

The above BONUS:LOADMULT|...|2 increases this by a further two multiples of the medium-size creature's carrying capacity, to a total of six times.

Like the above, but will only apply if the creature has at least four legs.