dynamic

Vars
candidates	List of candidates used on roundstart rulesets.
configuration	Dynamic configuration, loaded on pre_setup
current_midround_rulesets	The last drafted midround rulesets (without the current one included). Used for choosing different midround injections.
current_rules	Rules that are processed, rule_process is called on the rules in this list.
executed_rules	List of executed rulesets.
forced_injection	If TRUE, the next player to latejoin will guarantee roll for a random latejoin antag (this does not guarantee they get said antag roll, depending on preferences and circumstances)
forced_latejoin_rule	Forced ruleset to be executed for the next latejoin.
high_impact_ruleset_executed	If a high impact ruleset was executed. Only one will run at a time in most circumstances.
hijacked_random_event_injection_chance_modifier	The extra chance multiplier that a heavy impact midround ruleset will run next time. For example, if this is set to 50, then the next heavy roll will be about 50% more likely to happen.
initial_round_start_budget	The initial round start budget for logging purposes, set once at the beginning of the round.
last_midround_injection_attempt	The time when the last midround injection was attempted, whether or not it was successful
latejoin_delay_max	The maximum time the recurring latejoin ruleset timer is allowed to be.
latejoin_delay_min	The minimum time the recurring latejoin ruleset timer is allowed to be.
latejoin_injection_cooldown	When world.time is over this number the mode tries to inject a latejoin ruleset.
latejoin_roll_chance	The chance for latejoins to roll when ready
latejoin_rules	List of latejoin rules used for selecting the rules.
low_pop_maximum_threat	The maximum threat that can roll with zero players. As the number of players approaches `low_pop_player_threshold`, the maximum threat level will increase. For example, if `low_pop_maximum_threat` is 50, `low_pop_player_threshold` is 20, and the number of readied players is 10, then the highest threat that can roll is lerp(50, 100, 10 / 20), AKA 75.
low_pop_player_threshold	If there are less than this many players readied, threat level will be lowered. This number should be kept fairly low, as there are other measures that population impacts Dynamic, such as the requirements variable on rulesets.
max_threat_level	A number between 0 and 100. The maximum amount of threat allowed to generate.
mid_round_budget	Set at the beginning of the round. Spent by midrounds and latejoins.
midround_heavy_lower_bound	Any midround after this point is guaranteed to be heavy
midround_injection_timer_id	The timer ID for the cancellable midround rule injection
midround_light_upper_bound	Any midround before this point is guaranteed to be light
midround_lower_bound	The low bound for the midround roll time splits. This number influences where to place midround rolls, making this smaller will make midround rolls more frequent, and vice versa. A midround will never be able to roll before this.
midround_roll_distance	The distance between the chosen midround roll point (which is deterministic), and when it can actually roll. Basically, if this is set to 5 minutes, and a midround roll point is decided to be at 20 minutes, then it can roll anywhere between 15 and 25 minutes.
midround_rules	List of midround rules used for selecting the rules.
midround_upper_bound	The upper bound for the midround roll time splits. This number influences where to place midround rolls, making this larger will make midround rolls less frequent, and vice versa. A midround will never be able to roll farther than this.
only_ruleset_executed	If a only ruleset has been executed.
peaceful_percentage	How many percent of the rounds are more peaceful.
pop_per_requirement
random_event_hijack_maximum	The maximum amount of time for antag random events to be hijacked.
random_event_hijack_minimum	The minimum amount of time for antag random events to be hijacked.
random_event_hijacked	Whether or not a random event has been hijacked this midround cycle
round_start_budget	Set at the beginning of the round. Spent by the mode to "purchase" rules. Everything else goes in the postround budget.
roundend_threat_log	Threat log shown on the roundend report. Should only list player-made edits.
roundstart_pop_ready	Number of players who were ready on roundstart.
roundstart_split_curve_centre	A number between -5 and +5. Equivalent to threat_curve_centre, but for the budget split. A negative value will weigh towards midround rulesets, and a positive value will weight towards roundstart ones.
roundstart_split_curve_width	A number between 0.5 and 4. Equivalent to threat_curve_width, but for the budget split. Higher value will favour more variance in splits and lower value rounds closer to the average.
shown_threat	The amount of threat shown on the piece of paper. Can differ from the actual threat amount.
snapshots	A list of recorded "snapshots" of the round, stored in the dynamic.json log
threat_curve_centre	A number between -5 and +5. A negative value will give a more peaceful round and a positive value will give a round with higher threat.
threat_curve_width	A number between 0.5 and 4. Higher value will favour extreme rounds and lower value rounds closer to the average.
threat_level	The "threat cap", threat shouldn't normally go above this and is used in ruleset calculations
threat_log	Running information about the threat. Can store text or datum entries.
threat_per_midround_roll	The amount of threat per midround roll. Basically, if this is set to 5, then for every 5 threat, one midround roll will be added. The equation this is used in rounds up, meaning that if this is set to 5, and you have 6 threat, then you will get 2 midround rolls.
waittime_h	What is the higher bound of when the roundstart annoucement is sent out?
waittime_l	What is the lower bound of when the roundstart annoucement is sent out?
Procs
admin_cancel_midround	Fired when an admin cancels the current midround injection.
admin_different_midround	Fired when an admin requests a different midround injection.
check_blocking	Checks if a type in blocking_list is in rule_list.
configure_ruleset	Apply configurations to rule.
configure_station_trait	Apply configuration for station trait costs
configure_station_trait_costs	Get station traits and call for their config
create_threat	Generate threat and increase the threat_level if it goes beyond, capped at 100
execute_midround_latejoin_rule	Mainly here to facilitate delayed rulesets. All midround/latejoin rulesets are executed with a timered callback to this proc.
execute_midround_rule	Fired after admins do not cancel a midround injection.
execute_roundstart_rule	Mainly here to facilitate delayed rulesets. All roundstart rulesets are executed with a timered callback to this proc.
generate_advisory_level	Generate the advisory level depending on the shown threat level.
generate_budgets	Generates the midround and roundstart budgets
generate_threat	Generates the threat level using lorentz distribution and assigns peaceful_percentage.
generate_unfavourable_events	Filter the below list by which events can actually run on this map
generate_unfavourable_heavy_rulesets	Return a valid heavy dynamic ruleset, or an empty list if there's no time to run any rulesets
get_heavy_midround_injection_chance	Gets the chance for a heavy ruleset midround injection, the dry_run argument is only used for forced injection.
handle_executing_latejoin	This proc handles the execution of a latejoin ruleset, including removing it from latejoin rulesets if not repeatable, upping the injection cooldown, and starting a timer to execute the ruleset on delay.
init_rulesets	Returns a list of the provided rulesets. Configures their variables to match config.
log_dynamic_and_announce	Log to dynamic and message admins
lorentz_to_amount	Returns the comulative distribution of threat centre and width, and a random location of -0.5 to 0.5 plus or minus the otherwise unattainable lower and upper percentiles. All multiplied by the maximum threat and then rounded to the nearest interval. rand() calls without arguments returns a value between 0 and 1, allowing for smaller intervals.
make_antag_chance	Handles late-join antag assignments
new_snapshot	Creates a new snapshot with the given rulesets chosen, and writes to the JSON output.
next_midround_injection	Returns the world.time of the next midround injection. Will return a cached result from `next_midround_injection`, the variable. If that variable is null, will generate a new one.
pick_midround_rule	Executes a random midround ruleset from the list of drafted rules.
pick_ruleset	From a list of rulesets, returns one based on weight and availability. Mutates the list that is passed into it to remove invalid rules.
picking_roundstart_rule	Initializes the round start ruleset provided to it. Returns how much threat to spend.
picking_specific_rule	An experimental proc to allow admins to call rules on the fly or have rules call other rules.
refund_threat	Refund threat, but no more than threat_level.
remove_from_list	Removes type from the list
rigged_roundstart	A simple roundstart proc used when dynamic_forced_roundstart_ruleset has rules in it.
setup_rulesets	Initializes the internal ruleset variables
spend_midround_budget	Expend midround threat, can't fall under 0.
spend_roundstart_budget	Expend round start threat, can't fall under 0.
unfavorable_situation	An easy interface to make...waves hands bad things happen. This is used for impactful events like traitors hacking and creating more threat, or a revolutions victory. It tries to spawn a heavy midround if possible, otherwise it will trigger a "bad" random event after a short period. Calling this function will not use up any threat.
update_log	Updates the log for the current snapshots.

Var Details

var
candidates
– /list

List of candidates used on roundstart rulesets.

var
configuration
– /list

Dynamic configuration, loaded on pre_setup

var
current_midround_rulesets
– /list

The last drafted midround rulesets (without the current one included). Used for choosing different midround injections.

var
current_rules
– /list

Rules that are processed, rule_process is called on the rules in this list.

var
executed_rules
– /list

List of executed rulesets.

var
forced_injection
–

If TRUE, the next player to latejoin will guarantee roll for a random latejoin antag (this does not guarantee they get said antag roll, depending on preferences and circumstances)

var
forced_latejoin_rule
– /datum/dynamic_ruleset/latejoin

Forced ruleset to be executed for the next latejoin.

var
high_impact_ruleset_executed
–

If a high impact ruleset was executed. Only one will run at a time in most circumstances.

var
hijacked_random_event_injection_chance_modifier
–

The extra chance multiplier that a heavy impact midround ruleset will run next time. For example, if this is set to 50, then the next heavy roll will be about 50% more likely to happen.

var
initial_round_start_budget
–

The initial round start budget for logging purposes, set once at the beginning of the round.

var
last_midround_injection_attempt
–

The time when the last midround injection was attempted, whether or not it was successful

var
latejoin_delay_max
–

The maximum time the recurring latejoin ruleset timer is allowed to be.

var
latejoin_delay_min
–

The minimum time the recurring latejoin ruleset timer is allowed to be.

var
latejoin_injection_cooldown
–

When world.time is over this number the mode tries to inject a latejoin ruleset.

var
latejoin_roll_chance
–

The chance for latejoins to roll when ready

var
latejoin_rules
– /list

List of latejoin rules used for selecting the rules.

var
low_pop_maximum_threat
–

The maximum threat that can roll with zero players. As the number of players approaches low_pop_player_threshold, the maximum threat level will increase. For example, if low_pop_maximum_threat is 50, low_pop_player_threshold is 20, and the number of readied players is 10, then the highest threat that can roll is lerp(50, 100, 10 / 20), AKA 75.

var
low_pop_player_threshold
–

If there are less than this many players readied, threat level will be lowered. This number should be kept fairly low, as there are other measures that population impacts Dynamic, such as the requirements variable on rulesets.

var
max_threat_level
–

A number between 0 and 100. The maximum amount of threat allowed to generate.

var
mid_round_budget
–

Set at the beginning of the round. Spent by midrounds and latejoins.

var
midround_heavy_lower_bound
–

Any midround after this point is guaranteed to be heavy

var
midround_injection_timer_id
–

The timer ID for the cancellable midround rule injection

var
midround_light_upper_bound
–

Any midround before this point is guaranteed to be light

var
midround_lower_bound
–

The low bound for the midround roll time splits. This number influences where to place midround rolls, making this smaller will make midround rolls more frequent, and vice versa. A midround will never be able to roll before this.

var
midround_roll_distance
–

The distance between the chosen midround roll point (which is deterministic), and when it can actually roll. Basically, if this is set to 5 minutes, and a midround roll point is decided to be at 20 minutes, then it can roll anywhere between 15 and 25 minutes.

var
midround_rules
– /list

List of midround rules used for selecting the rules.

var
midround_upper_bound
–

The upper bound for the midround roll time splits. This number influences where to place midround rolls, making this larger will make midround rolls less frequent, and vice versa. A midround will never be able to roll farther than this.

var
only_ruleset_executed
–

If a only ruleset has been executed.

var
peaceful_percentage
–

How many percent of the rounds are more peaceful.

var
pop_per_requirement
–

Pop range per requirement.

* If the value is five the range is:
* 0-4, 5-9, 10-14, 15-19, 20-24, 25-29, 30-34, 35-39, 40-54, 45+
* If it is six the range is:
* 0-5, 6-11, 12-17, 18-23, 24-29, 30-35, 36-41, 42-47, 48-53, 54+
* If it is seven the range is:
* 0-6, 7-13, 14-20, 21-27, 28-34, 35-41, 42-48, 49-55, 56-62, 63+

var
random_event_hijack_maximum
–

The maximum amount of time for antag random events to be hijacked.

var
random_event_hijack_minimum
–

The minimum amount of time for antag random events to be hijacked.

var
random_event_hijacked
–

Whether or not a random event has been hijacked this midround cycle

var
round_start_budget
–

Set at the beginning of the round. Spent by the mode to "purchase" rules. Everything else goes in the postround budget.

var
roundend_threat_log
– /list

Threat log shown on the roundend report. Should only list player-made edits.

var
roundstart_pop_ready
–

Number of players who were ready on roundstart.

var
roundstart_split_curve_centre
–

A number between -5 and +5. Equivalent to threat_curve_centre, but for the budget split. A negative value will weigh towards midround rulesets, and a positive value will weight towards roundstart ones.

var
roundstart_split_curve_width
–

A number between 0.5 and 4. Equivalent to threat_curve_width, but for the budget split. Higher value will favour more variance in splits and lower value rounds closer to the average.

var
shown_threat
–

The amount of threat shown on the piece of paper. Can differ from the actual threat amount.

var
snapshots
– /list/datum/dynamic_snapshot

A list of recorded "snapshots" of the round, stored in the dynamic.json log

var
threat_curve_centre
–

A number between -5 and +5. A negative value will give a more peaceful round and a positive value will give a round with higher threat.

var
threat_curve_width
–

A number between 0.5 and 4. Higher value will favour extreme rounds and lower value rounds closer to the average.

var
threat_level
–

The "threat cap", threat shouldn't normally go above this and is used in ruleset calculations

var
threat_log
– /list

Running information about the threat. Can store text or datum entries.

var
threat_per_midround_roll
–

The amount of threat per midround roll. Basically, if this is set to 5, then for every 5 threat, one midround roll will be added. The equation this is used in rounds up, meaning that if this is set to 5, and you have 6 threat, then you will get 2 midround rolls.

var
waittime_h
–

What is the higher bound of when the roundstart annoucement is sent out?

var
waittime_l
–

What is the lower bound of when the roundstart annoucement is sent out?

Proc Details

proc
admin_cancel_midround
(/mob/user, timer_id)

Fired when an admin cancels the current midround injection.

proc
admin_different_midround
(/mob/user, timer_id)

Fired when an admin requests a different midround injection.

proc
check_blocking
(/list/blocking_list, /list/rule_list)

Checks if a type in blocking_list is in rule_list.

proc
configure_ruleset
(/datum/dynamic_ruleset/ruleset)

Apply configurations to rule.

proc
configure_station_trait
(/datum/station_trait/station_trait)

Apply configuration for station trait costs

proc
configure_station_trait_costs
()

Get station traits and call for their config

proc
create_threat
(gain, /list/threat_log, reason)

Generate threat and increase the threat_level if it goes beyond, capped at 100

proc
execute_midround_latejoin_rule
(sent_rule)

Mainly here to facilitate delayed rulesets. All midround/latejoin rulesets are executed with a timered callback to this proc.

proc
execute_midround_rule
(/datum/dynamic_ruleset/rule)

Fired after admins do not cancel a midround injection.

proc
execute_roundstart_rule
(sent_rule)

Mainly here to facilitate delayed rulesets. All roundstart rulesets are executed with a timered callback to this proc.

proc
generate_advisory_level
()

Generate the advisory level depending on the shown threat level.

proc
generate_budgets
()

Generates the midround and roundstart budgets

proc
generate_threat
()

Generates the threat level using lorentz distribution and assigns peaceful_percentage.

proc
generate_unfavourable_events
()

Filter the below list by which events can actually run on this map

proc
generate_unfavourable_heavy_rulesets
()

Return a valid heavy dynamic ruleset, or an empty list if there's no time to run any rulesets

proc
get_heavy_midround_injection_chance
(dry_run)

Gets the chance for a heavy ruleset midround injection, the dry_run argument is only used for forced injection.

proc
handle_executing_latejoin
(/datum/dynamic_ruleset/ruleset, /mob/living/carbon/human/only_candidate, forced)

This proc handles the execution of a latejoin ruleset, including removing it from latejoin rulesets if not repeatable, upping the injection cooldown, and starting a timer to execute the ruleset on delay.

proc
init_rulesets
(ruleset_subtype)

Returns a list of the provided rulesets. Configures their variables to match config.

proc
log_dynamic_and_announce
(text)

Log to dynamic and message admins

proc
lorentz_to_amount
(centre, scale, max_threat, interval)

Returns the comulative distribution of threat centre and width, and a random location of -0.5 to 0.5 plus or minus the otherwise unattainable lower and upper percentiles. All multiplied by the maximum threat and then rounded to the nearest interval. rand() calls without arguments returns a value between 0 and 1, allowing for smaller intervals.

proc
make_antag_chance
(/mob/living/carbon/human/newPlayer)

Handles late-join antag assignments

proc
new_snapshot
(/datum/dynamic_ruleset/ruleset_chosen)

Creates a new snapshot with the given rulesets chosen, and writes to the JSON output.

proc
next_midround_injection
()

Returns the world.time of the next midround injection. Will return a cached result from next_midround_injection, the variable. If that variable is null, will generate a new one.

proc
pick_midround_rule
(/list/drafted_rules, description)

Executes a random midround ruleset from the list of drafted rules.

proc
pick_ruleset
(/list/drafted_rules, max_allowed_attempts)

From a list of rulesets, returns one based on weight and availability. Mutates the list that is passed into it to remove invalid rules.

max_allowed_attempts - Allows you to configure how many times the proc will attempt to pick a ruleset before giving up.

proc
picking_roundstart_rule
(/datum/dynamic_ruleset/roundstart/ruleset, scaled_times, forced)

Initializes the round start ruleset provided to it. Returns how much threat to spend.

proc
picking_specific_rule
(ruletype, forced, ignore_cost)

An experimental proc to allow admins to call rules on the fly or have rules call other rules.

proc
refund_threat
(regain)

Refund threat, but no more than threat_level.

proc
remove_from_list
(/list/type_list, type)

Removes type from the list

proc
rigged_roundstart
()

A simple roundstart proc used when dynamic_forced_roundstart_ruleset has rules in it.

proc
setup_rulesets
()

Initializes the internal ruleset variables

proc
spend_midround_budget
(cost, /list/threat_log, reason)

Expend midround threat, can't fall under 0.

proc
spend_roundstart_budget
(cost, /list/threat_log, reason)

Expend round start threat, can't fall under 0.

proc
unfavorable_situation
()

An easy interface to make...waves hands bad things happen. This is used for impactful events like traitors hacking and creating more threat, or a revolutions victory. It tries to spawn a heavy midround if possible, otherwise it will trigger a "bad" random event after a short period. Calling this function will not use up any threat.

proc
update_log
()

Updates the log for the current snapshots.

dynamic /datum/controller/subsystem/dynamic

Vars

Procs

Var Details

var candidates – /list

var configuration – /list

var current_midround_rulesets – /list

var current_rules – /list

var executed_rules – /list

var forced_injection –

var forced_latejoin_rule – /datum/dynamic_ruleset/latejoin

var high_impact_ruleset_executed –

var hijacked_random_event_injection_chance_modifier –

var initial_round_start_budget –

var last_midround_injection_attempt –

var latejoin_delay_max –

var latejoin_delay_min –

var latejoin_injection_cooldown –

var latejoin_roll_chance –

var latejoin_rules – /list

var low_pop_maximum_threat –

var low_pop_player_threshold –

var max_threat_level –

var mid_round_budget –

var midround_heavy_lower_bound –

var midround_injection_timer_id –

var midround_light_upper_bound –

var midround_lower_bound –

var midround_roll_distance –

var midround_rules – /list

var midround_upper_bound –

var only_ruleset_executed –

var peaceful_percentage –

var pop_per_requirement –

var random_event_hijack_maximum –

var random_event_hijack_minimum –

var random_event_hijacked –

var round_start_budget –

var roundend_threat_log – /list

var roundstart_pop_ready –

var roundstart_split_curve_centre –

var roundstart_split_curve_width –

var shown_threat –

var snapshots – /list/datum/dynamic_snapshot

var threat_curve_centre –

var threat_curve_width –

var threat_level –

var threat_log – /list

var threat_per_midround_roll –

var waittime_h –

var waittime_l –