add-thought
===========

Tags: fort | armok | units

Command: "add-thought"

  Adds a thought to the selected unit.


Usage
-----

"add-thought --gui [--unit <id>]"
   Allows you to choose the thought to apply to the selected (or specified) unit through a series of graphical prompts.

"add-thought [--unit <id>] [<options>]"
   Add a thought to the selected (or specified) unit.


Examples
--------

"add-thought --gui"
   Add a thought to the unit currently selected in the UI.

"add-thought --unit 23142 --emotion GRATITUDE --thought GoodMeal --strength 1"
   Make unit 23142 feel a light sense of gratitude for eating a good meal.


Options
-------

"--emotion <id>"
   Specifies an emotion for the unit to associate with the given thought. To see a list of possible emotions, run ":lua @df.emotion_type". If not specified, defaults to "-1" (i.e. no emotion).

"--thought <id>"
   The thought. To see a list of possible thoughts, run ":lua @df.unit_thought_type". If not specified, defaults to "180", or "NeedsUnfulfilled". The id could also be the name of a syndrome. To see a list of syndromes in your world, run "devel/query --table df.global.world.raws.syndromes.all --search syn_name --maxdepth 1". The id is the numerical index and the syn_name field is the name.

"--subthought <id>"
   The subthought identifier. If the thought is the name of a syndrome, then the subthought should be the syndrome id. If not specified, defaults to "0" (which is what you want for most thought types).

"--strength <strength>"
   The strength of the emotion, corresponding to the strength of the need that this emotion might cause or fulfill. Common values for this are "1" (Slight need), "2" (Moderate need), "5" (Strong need), and "10" (Intense need). If not specified, defaults to "0".

"--severity <severity>"
   If the thought is the name of a syndrome, then the severity will be used as the severity of the syndrome.
