The first way to give a player an effect in-game is through the drug system. To do this your item must have a use_action of type "consume_drug".
"use_action" : {
"type" : "consume_drug",
"activation_message" : "You take some oxycodone.",
"effects" : [
{
"id": "pkill3",
"duration": 20
},
{
"id": "pkill2",
"duration": 200
}
]
},Notice the "effects" field. Each effect has four potential fields:
"id" - Required
"duration" - Required
"bp" - This will cause the effect to target this body part specifically
"permanent" - This means the placed effect will be permanent, and will never decrease in durationValid "bp" entries are (no entry means the effect is untargeted):
"TORSO"
"HEAD"
"EYES"
"MOUTH"
"ARM_L"
"ARM_R"
"HAND_L"
"HAND_R"
"LEG_L"
"LEG_R"
"FOOT_L"
"FOOT_R"Creatures have a field that is almost identical to the one used in the "consume_drug" entry.
"attack_effs": [
{
"//": "applying this multiple times makes intensity go up by 3 instead of 1",
"id": "paralyzepoison",
"duration": 33
},
{
"id": "paralyzepoison",
"duration": 33
},
{
"id": "paralyzepoison",
"duration": 33
}
],The entries in each effect function identically to the ones for "consume_drug" except creatures also have an additional field:
"chance" - The percentage chance of the effect being applied on a good hit, defaults to 100%If a creature successfully damages the player and their chance roll succeeds they will apply all of the listed effects to the player one after another.
"type": "effect_type", - Required
"id": "xxxx" - Must be unique "max_intensity": 3 - Used for many later fields, defaults to 1 "name": ["XYZ"]
or
"name": [
"ABC",
"XYZ",
"123"
]If "max_intensity" > 1 and the number of entries in "name" >= "max_intensity" then it will attempt to use the proper intensity name. In this case that means an intensity of 1 would give the name "ABC", 2 would give "XYZ", and 3 would give "123". If "max_intensity" == 1 or the number of entries in "name" is less than "max_intensity", it will use the first entry followed by the intensity in brackets if the current intensity > 1, i.e. "ABC", "ABC [2]", "ABC [3]". If the desired entry of "name" is the empty string ("") or "name" is missing then the effect will not display to the player in the status screen.
"speed_name" : "XYZ" - Defaults to the first name valueThis is the value used in the list of modifiers on a player's speed. It will default to the first entry in "name" if it doesn't exist, and if neither one exists or if "speed_name" is the empty string (""), then it will not appear in the list of modifiers on the players speed (though the effect might still have an effect).
"desc": ["XYZ"]
or
"desc": [
"ABC",
"XYZ",
"123"
]Descriptions operate identical to the name field for picking which one to use. In general descriptions should be only 1 line. Stats and effects do not need to be included, and will be automatically generated from the other effect data. Should a description line be the empty string ("") it will only display the stat changes in the effect description.
Descriptions also have a second field that can act as a modifier:
"part_descs": true - Defaults to false if not presentIf "part_descs" == true then descriptions are preceded by "Your X", where X is the body part name, meaning the prior descriptions would appear as "Your left arm ABC".
Descriptions can also have a reduced form:
"reduced_desc": ["XYZ"]
or
"reduced_desc": [
"ABC",
"XYZ",
"123"
]This is the description that will be used if an effect is reduced. By default this will use the normal description if it doesn't exist.
"rating": "good" - Defaults to "neutral" if missingThis is used for how the messages when the effect is applied and removed are displayed. Valid entries are:
"good"
"neutral"
"bad"
"mixed" "apply_message": "message",
"remove_message": "message"If the "apply_message" or "remove_message" fields exist, the respective message will be displayed upon the addition or removal of the effect. Note: "apply_message" will only display if the effect is being added, not if it is simply incrementing a current effect (so only new bites, etc.).
"apply_memorial_log": "log",
"remove_memorial_log": "log"If the "apply_memorial_log" or "remove_memorial_log" fields exist, the game will add the respective message to the memorial log on addition or removal of the effect. Similar to the message fields the "apply_memorial_log" will only be added to the log for new effect additions.
"resist_trait": "NOPAIN",
"resist_effect": "flumed"These fields are used to determine if an effect is being resisted or not. If the player has the matching trait or effect then they are "resisting" the effect, which changes its effects and description. Effects can only have one "resist_trait" and one "resist_effect" at a time.
"removes_effects": ["bite", "flu"]This field will cause an effect to automatically remove any other copies of the listed effects if they are present. In the example above the placed effect would automatically cure any bite wounds or flu the player had. Any values here automatically count for "blocks_effects" as well, no need to duplicate them there.
"blocks_effects": ["cold", "flu"]This field will cause an effect to prevent the placement of the listed effects. In the example above the effect would prevent the player from catching the cold or the flu (BUT WOULD NOT CURE ANY ONGOING COLDS OR FLUS). Any effects present in "removes_effects" are automatically added to "blocks_effects", no need for manual duplication.
"max_duration": 100,
"dur_add_perc": 150 - Defaults to 100%These are utilized when adding to currently existing effects. "max_duration" limits the overall duration of the effect. "dur_add_perc" is the percentage value of the normal duration for adding to an existing. An example:
- I add effect A to the player for 100 ticks.
- I add effect A to the player again for 100 ticks. Because the "dur_add_perc" = 150 in the example above, the second addition adds a total of 100 * 150% = 150 ticks, for a total value of 250 ticks from the two. This can also be below 100%, and should be able to even be negative, leading to future applications decreasing the overall time left.
Intensities are used to control effect effects, names, and descriptions. They are defined with:
"int_add_val": 2 - Defaults to 0! This means future applications will not increase intensity unless changed!
and/or
"int_decay_step": -2, - Defaults to -1
"int_decay_tick": 10
or
"int_dur_factor": 700The first value is the amount an intensity will be incremented if adding to an already existing effect. As an example:
- I add effect A to the player
- I add effect A to the player again Because "int_add_val" = 2, the second addition will change the effect intensity from 1 to 1 + 2 = 3. NOTE: You must have at least one of the 3 intensity data sets for intensity to do anything!
"int_decay_step" and "int_decay_tick" require one another to do anything. If both exist then the game will automatically increment the current effect intensities by "int_decay_step" every "int_decay_tick" ticks, capping the result at [1, "max_intensity"]. This can be used to make effects automatically increase or decrease in intensity over time.
"int_dur_factor" overrides the other three intensities fields, and forces the intensity to be a number defined as intensity = duration / "int_dur_factor" rounded up (so from 0 to "int_dur_factor" is intensity 1).
"miss_messages": [["Your blisters distract you", 1]]
or
"miss_messages": [
["Your blisters distract you", 1],
["Your blisters don't like you", 10],
]This will add the following miss messages at the given chances while the effect is in effect.
"decay_messages": [["The jet injector's chemicals wear off. You feel AWFUL!", "bad"]]
or
"decay_messages": [
["The jet injector's chemicals wear off. You feel AWFUL!", "bad"],
["OOGA-BOOGA. You feel AWFUL!", "bad"],
]The messages are matched to intensities, so the first message is for intensity 1, the second for intensity 2, and so on. The messages will print whenever the intensity decreases to their matching intensity from a higher intensity, whether through decay ticks or through "int_dur_factor". So if it decayed to intensity 2 from 3+ it would display "OOGA-BOOGA. You feel AWFUL!" as a bad message to the player.
"main_parts_only": true - Defaults to falseThis automatically retargets any effect on a non-main part (hands, eyes, feet, etc.) to the matching main part (arms, head, legs, etc.).
"pkill_addict_reduces": true, - Defaults to false
"pain_sizing": true, - Defaults to false
"hurt_sizing": true, - Defaults to false
"harmful_cough": true - Defaults to false"pkill_addict_reduces" makes a player's addiction to painkillers reduce the chance of the effect giving them more pkill. "pain_sizing" and "hurt_sizing" cause large/huge mutations to affect the chance of pain and hurt effects triggering. "harmful_cough" means that the coughs caused by this effect can hurt the player.
"base_mods" : {
arguments
},
"scaling_mods": {
arguments
}This is where the real meat of the effect JSON definition lies. Each one can take a variety of arguments. Decimals are valid but must be formatted as "0.X" or "-0.X". The game will round towards zero at the end when calculating actually applied values
Valid arguments:
"str_mod"
"dex_mod"
"per_mod"
"int_mod"
"speed_mod"
"pain_amount"
"pain_min"
"pain_max" - if 0 or missing value will be exactly "pain_min"
"pain_max_val" - Defaults to 0, which means uncapped
"pain_chance"
"pain_chance_bot"
"pain_tick" - Defaults to every tick
"hurt_amount"
"hurt_min"
"hurt_max" - if 0 or missing value will be exactly "hurt_min"
"hurt_chance"
"hurt_chance_bot"
"hurt_tick" - Defaults to every tick
"sleep_amount"
"sleep_min"
"sleep_max" - if 0 or missing value will be exactly "sleep_min"
"sleep_chance"
"sleep_chance_bot"
"sleep_tick" - Defaults to every tick
"pkill_amount"
"pkill_min"
"pkill_max" - if 0 or missing value will be exactly "pkill_min"
"pkill_max_val" - Defaults to 0, which means uncapped
"pkill_chance"
"pkill_chance_bot"
"pkill_tick" - Defaults to every tick
"stim_amount"
"stim_min"
"stim_max" - if 0 or missing value will be exactly "stim_min"
"stim_min_val" - Defaults to 0, which means uncapped
"stim_max_val" - Defaults to 0, which means uncapped
"stim_chance"
"stim_chance_bot"
"stim_tick" - Defaults to every tick
"health_amount"
"health_min"
"health_max" - if 0 or missing value will be exactly "health_min"
"health_min_val" - Defaults to 0, which means uncapped
"health_max_val" - Defaults to 0, which means uncapped
"health_chance"
"health_chance_bot"
"health_tick" - Defaults to every tick
"h_mod_amount"
"h_mod_min"
"h_mod_max" - if 0 or missing value will be exactly "h_mod_min"
"h_mod_min_val" - Defaults to 0, which means uncapped
"h_mod_max_val" - Defaults to 0, which means uncapped
"h_mod_chance"
"h_mod_chance_bot"
"h_mod_tick" - Defaults to every tick
"rad_amount"
"rad_min"
"rad_max" - if 0 or missing value will be exactly "rad_min"
"rad_max_val" - Defaults to 0, which means uncapped
"rad_chance"
"rad_chance_bot"
"rad_tick" - Defaults to every tick
"hunger_amount"
"hunger_min"
"hunger_max" - if 0 or missing value will be exactly "hunger_min"
"hunger_min_val" - Defaults to 0, which means uncapped
"hunger_max_val" - Defaults to 0, which means uncapped
"hunger_chance"
"hunger_chance_bot"
"hunger_tick" - Defaults to every tick
"thirst_amount"
"thirst_min"
"thirst_max" - if 0 or missing value will be exactly "thirst_min"
"thirst_min_val" - Defaults to 0, which means uncapped
"thirst_max_val" - Defaults to 0, which means uncapped
"thirst_chance"
"thirst_chance_bot"
"thirst_tick" - Defaults to every tick
"fatigue_amount"
"fatigue_min"
"fatigue_max" - if 0 or missing value will be exactly "fatigue_min"
"fatigue_min_val" - Defaults to 0, which means uncapped
"fatigue_max_val" - Defaults to 0, which means uncapped
"fatigue_chance"
"fatigue_chance_bot"
"fatigue_tick" - Defaults to every tick
"stamina_amount"
"stamina_min"
"stamina_max" - if 0 or missing value will be exactly "stamina_min"
"stamina_min_val" - Defaults to 0, which means uncapped
"stamina_max_val" - Defaults to 0, which means uncapped
"stamina_chance"
"stamina_chance_bot"
"stamina_tick" - Defaults to every tick
"cough_chance"
"cough_chance_bot"
"cough_tick"
"vomit_chance"
"vomit_chance_bot"
"vomit_tick"Basic definitions:
"X_amount" - Amount applied of X when effect is placed. Like apply messages it will only trigger on new effects
"X_min" - Minimum amount of X applied when roll triggers
"X_max" - Maximum amount of X applied when roll triggers (no entry means it will give exactly X_min each time instead of rng(min, max)
"X_min_val" - Minimum value the effect will push you to, 0 means uncapped! Doesn't exist for some X's!
"X_max_val" - Maximum value the effect will push you to, 0 means uncapped! Doesn't exist for some X's!
"X_chance" - Basic chance of X triggering each time, depends on "X_chance_bot" for exact formula
"X_chance_bot" - If this doesn't exist then the trigger chance is (1 in "X_chance"). If this does exist then the chance is ("X_chance" in "X_chance_bot")
"X_tick" - Effect rolls for X triggering every Y ticksEach argument can also take either one or two values.
"thirst_min": [1]
or
"thirst_min": [1, 2]If an effect is "resisted" (either through "resist_effect" or "resist_trait") then it will use the second value. If there is only one value given it will always use that amount.
Base mods and Scaling mods: While on intensity = 1 an effect will only have the basic effects of its "base_mods". However for each additional intensity it gains it adds the value of each of its "scaling_mods" to the calculations. So:
Intensity 1 values = base_mods values
Intensity 2 values = base_mods values + scaling_mods values
Intensity 3 values = base_mods values + 2 * scaling_mods values
Intensity 4 values = base_mods values + 3 * scaling_mods valuesand so on.
Special case: The only special case is if base_mods' "X_chance_bot" + intensity * scaling_mods' "X_chance_bot" = 0 then it treats it as if it were equal to 1 (i.e. trigger every time)
"type": "effect_type",
"id": "drunk",
"name": [
"Tipsy",
"Drunk",
"Trashed",
"Wasted"
],
"max_intensity": 4,
"apply_message": "You feel lightheaded.",
"int_dur_factor": 1000,
"miss_messages": [["You feel woozy.", 1]],
"base_mods": {
"str_mod": [1],
"vomit_chance": [-43],
"sleep_chance": [-1003],
"sleep_min": [2500],
"sleep_max": [3500]
},
"scaling_mods": {
"str_mod": [-0.67],
"per_mod": [-1],
"dex_mod": [-1],
"int_mod": [-1.42],
"vomit_chance": [21],
"sleep_chance": [501]
}First when "drunk" is applied to the player if they aren't already drunk it prints the message, "You feel lightheaded". It also adds the "You feel woozy" miss message for as long as it is applied. It has "int_dur_factor": 1000, meaning that its intensity will always be equal to its duration / 1000 rounded up, and it has "max_intensity": 4 meaning the highest its intensity will go is 4 at a duration of 3000 or higher. As it moves up through the different intensities, its name will change. Its description will simply display the stat changes, with no additional description added.
As it moves up through the intensity levels its effects will be:
Intensity 1
+1 STR
No other effects (since both "X_chance"s are negative)
Intensity 2
1 - .67 = .33 = 0 STR (Round towards zero)
0 - 1 = -1 PER
0 - 1 = -1 DEX
0 -1.42 = -1 INT
-43 + 21 = still negative, so no vomiting
-1003 + 501 = still negative, so no passing out
Intensity 3
1 - 2 * .67 = -.34 = 0 STR (round towards zero)
0 - 2 * 1 = -2 PER
0 - 2 * 1 = -2 DEX
0 - 2 * 1.43 = -2 INT
-43 + 2 * 21 = -1 still negative, no vomiting
-1003 + 2 * 501 = -1 still negative, no passing out
Intensity 4
1 - 3 * .67 = - 1.01 = -1 STR
0 - 3 * 1 = -3 PER
0 - 3 * 1 = -3 DEX
0 - 3 * 1.43 = -4 INT
-43 + 3 * 21 = 20 "vomit_chance_bot" doesn't exist, so a 1 in 20 chance of vomiting. "vomit_tick" doesn't exist, so it rolls every turn.
-1003 + 3 * 501 = 500 "sleep_chance_bot" doesn't exist, so a 1 in 500 chance of passing out for rng(2500, 3500) turns. "sleep_tick" doesn't exist, so it rolls every turn.