modtools/set-personality

Tags: dev

Command: modtools/set-personality

Change a unit’s personality.

Changes the personality of units.

Usage

modtools/set-personality --list
modtools/set-personality [<target option>] <trait option> <modifier option>

If no target option is given, the unit selected in the UI is used by default.

Target options

--citizens

All (sane) citizens of your fort will be affected. Will do nothing in adventure mode.

--unit <UNIT ID>

The given unit will be affected.

Trait options

--all

Apply the edit to all the target’s traits.

--trait <ID>

ID of the trait to edit. For example, 0 or HATE_PROPENSITY.

Modifier options

--set <0-100>

Set trait to given strength.

--tier <1-7>

Set trait to within the bounds of a strength tier.

Value

Strength

1

Lowest

2

Very Low

3

Low

4

Neutral

5

High

6

Very High

7

Highest

--modify <amount>

Modify current base trait strength by given amount. Negative values need a \\ before the negative symbol e.g. \\-1

--step <amount>

Modify current trait tier up/down by given amount. Negative values need a \\ before the negative symbol e.g. \\-1

--random

Set the trait to a new random value.

--average

Sets trait to the creature’s caste’s average value (as defined in the PERSONALITY creature tokens).

Other options

--list

Prints a list of all facets + their IDs.

--noneed

By default, unit’s needs will be recalculated to reflect new traits after every run. Use this argument to disable that functionality.

--listunit

Prints a list of all a unit’s personality traits, with their modified trait value in brackets.