Skip to content

Bonus Format

Full format

All parameters but type are optional.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
{
    // Type of the bonus. See Bonus Types for full list
    "type":         "BONUS_TYPE",

    // Subtype of the bonus. Function depends on bonus type.
    "subtype":      0,

    // Value of the bonus. Function depends on bonus type.
    "val" :         0,

    // Describes how this bonus is accumulated with other bonuses of the same type
    "valueType":    "VALUE_TYPE",

    // Additional info that bonus might need. Function depends on bonus type.
    "addInfo" :     0, // or [1, 2, ...]

    // How long this bonus should be active until removal.
    // May use multiple triggers, in which case first event will remove this bonus
    "duration" :    "BONUS_DURATION", //or ["BONUS_DURATION1", "BONUS_DURATION2", ...]"

    // How long this bonus should remain, in days or battle turns (depending on bonus duration)
    "turns" :       0,

    // TODO
    "targetSourceType" : "SOURCE_TYPE",

    // TODO
    "sourceType" :  "SOURCE_TYPE",

    // TODO
    "sourceID" :    0,

    // TODO
    "effectRange" : "EFFECT_RANGE",

    // TODO
    "limiters" : [
        "PREDEFINED_LIMITER", optional_parameters (...), //whhich one is preferred?
        {"type" : LIMITER_TYPE, "parameters" : [1,2,3]}
    ],

    // TODO
    "propagator" :  ["PROPAGATOR_TYPE", optional_parameters (...)],

    // TODO
    "updater" :     {Bonus Updater},

    // TODO
    "propagationUpdater" :  {Bonus Updater, but works during propagation},

    // TODO
    "description" : "",

    // TODO
    "stacking" :    ""
}

Supported bonus types

Subtype resolution

All string identifiers of items can be used in "subtype" field. This allows cross-referencing between the mods and make config file more readable. See Game Identifiers for full list of available identifiers

Example

1
2
3
4
5
6
"bonus" :
{
    "type" : "HATE",
    "subtype" : "creature.enchanter",
    "val" : 50
}

This bonus makes creature do 50% more damage to Enchanters.