assign-skills

Tags: fort | armok | units

Command: assign-skills

Adjust a unit’s skills.

Skills are defined by their token and their rank. You can see a list of valid skill tokens by running devel/query --table df.job_skill or by browsing the wiki.

Usage

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

Example

assign-skills --reset --skills [ WOODCUTTING 3 AXE 2 ]

Clears all the unit skills, then adds the Wood cutter skill (competent level) and the Axeman skill (adequate level).

Options

--unit <id>

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

--skills [ <skill> <rank> [<skill> <rank> ...] ]

The list of the skills to modify and their ranks. Rank values range from -1 (the skill is not learned) to 20 (legendary + 5). It is actually possible to go beyond 20 (no check is performed), but the effect on the game may not be predictable. There must be a space before and after each square bracket.

--reset

Clear all skills. If the script is called with both this option and --skills, first all the unit skills will be cleared and then the listed skills will be added.

Skill ranks

Here is the mapping from rank value to description:

Rank

Rank description

0

Dabbling

1

Novice

2

Adequate

3

Competent

4

Skilled

5

Proficient

6

Talented

7

Adept

8

Expert

9

Professional

10

Accomplished

11

Great

12

Master

13

High Master

14

Grand Master

15+

Legendary

For more information, please see: https://dwarffortresswiki.org/index.php/DF2014:Skill#Skill_level_names