1# proficiency
2
3## definition
4
5```JSON
6{
7  "id": "prof_knapping",
8  "type": "proficiency",
9  "name": { "str": "Knapping" },
10  "description": "The ability to turn stones into usable tools.",
11  "can_learn": true,
12  "time_to_learn": "10 h",
13  "required_proficiencies": [ "prof_foo" ]
14},
15```
16### `id`
17Mandatory. String
18The id of the proficiency.
19
20### `type`
21Mandatory. String
22Must be `proficiency`.
23
24### `name`
25Mandatory. String
26The name of the proficiency.
27
28### `description`
29Mandatory. String
30The description of the proficiency.
31
32### `can_learn`
33Mandatory. Bool
34Whether or not this proficiency can be learned through normal means during the game.
35
36### `default_time_multiplier` and `default_fail_multiplier`
37Optional. Float
38When used in recipes these values are the amount the time to complete the recipe, and the chance to fail the recipe, will be multiplied by.
39
40- For proficiencies that represent core basic knowledge and foundational principles, the `time` should usually be low (1.5 or so), and the `fail` should be high (4 or more).
41- For "flavour" proficiencies that offer a small boost, these should be around 1.5 each.
42- Most other proficiencies should be in the 2-3 range for both values.
43
44### `time_to_learn`
45Optional. time_duration, as a string
46The (optimal) time required to learn this proficiency.
47
48### `required_proficiencies`
49Optional. Array of strings
50The proficiencies that must be obtained before this one can.  You cannot gain experience in a proficiency without the necessary prerequisites.
51