# assign-attributes

Tags: fort | armok | units

Command: `assign-attributes`

Adjust physical and mental attributes.

Attributes are divided into tiers from -4 to 4. Tier 0 is the standard level and represents the average values for that attribute, tier 4 is the maximum level, and tier -4 is the minimum level.

For more information on attributes, please see the wiki.

## Usage

    assign-attributes [--unit <id>] <options>

Please run:

    devel/query --table df --maxdepth 1 --search [ physical_attribute_type mental_attribute_type ]

to see the list of valid attribute tokens.

## Example

    assign-attributes --reset --attributes [ STRENGTH 2 AGILITY -1 SPATIAL_SENSE -1 ]

This will reset all attributes to a neutral value and will then set the following values (the ranges will differ based on race; this example assumes a dwarf is selected in the UI):

> - Strength: a random value between 1750 and 1999 (tier 2);

> - Agility: a random value between 401 and 650 (tier -1);

> - Spatial sense: a random value between 1043 and 1292 (tier -1).

The final result will be: “She is very strong, but she is clumsy. She has a questionable spatial sense.”

## Options

`--unit <id>`

  The target unit ID. If not present, the currently selected unit will be the target.

`--attributes [ <attribute> <tier> [<attribute> <tier> ...] ]`

  The list of the attributes to modify and their tiers. The valid attribute names can be found in the Attribute (substitute any space with underscores). Tiers range from -4 to 4. There must be a space before and after each square bracket.

`--reset`

  Reset all attributes to the average level (tier 0). If both this option and `attributes` are specified, the unit attributes will be reset and then the listed attributes will be modified.

## Tiers

The tier corresponds to the text that DF will use to describe a unit with attributes in that tier’s range. For example, here is the mapping for the “Strength” attribute:

Tier | Description
--- | ---
4 | unbelievably strong
3 | mighty
2 | very strong
1 | strong
0 | (no description)
-1 | weak
-2 | very weak
-3 | unquestionably weak
-4 | unfathomably weak