supermatter_crystal

Vars
absorbed_gasmix	The gasmix we just recently absorbed. Tile's air multiplied by absorption_ratio
absorption_ratio	The portion of the gasmix we're on that we should remove
activation_logged	Boolean used to log the first activation of the SM.
bullet_energy	How much the bullets damage should be multiplied by when it is added to the internal variables
common_radio_cooldown	Cooldown for sending emergency alerts to the common radio channel
countdown	An effect we show to admins and ghosts the percentage of delam we're at
current_gas_behavior	The current gas behaviors for this particular crystal
damage	The amount of damage we have currently.
damage_archived	The damage we had before this cycle. Used to check if we are currently taking damage or healing.
danger_point	The point at which we consider the supermatter to be [SUPERMATTER_STATUS_DANGER] Spawns anomalies when more damaged than this too.
delam_priority	Whether the sm is forced in a specific delamination_strategy or not. All truthy values means it's forced. Only values greater or equal to the current one can change the strat.
delamination_strategy	How we are delaminating.
disable_damage	Disables all methods of taking damage.
disable_gas	Disables the calculation of gas effects and production of waste. SM still "breathes" though, still takes gas and spits it out. Nothing is done on them though. Cleaner code this way. Get rid of if it's too wasteful.
disable_power_change	Disables power changes.
disable_process	Disables the SM's proccessing totally when set to SM_PROCESS_DISABLED. Temporary disables the processing when it's set to SM_PROCESS_TIMESTOP. Make sure absorbed_gasmix and gas_percentage isnt null if this is on SM_PROCESS_DISABLED.
emergency_point	The point at which we consider the supermatter to be [SUPERMATTER_STATUS_EMERGENCY]
explosion_point	The point at which we delam [SUPERMATTER_STATUS_DELAMINATING].
explosion_power	A scaling value that affects the severity of explosions.
external_damage_immediate	External damage that are added to the sm on next [/obj/machinery/power/supermatter_crystal/process_atmos] call. SM will not take damage if its health is lower than emergency point.
external_power_immediate	External power that are added to the sm on next [/obj/machinery/power/supermatter_crystal/process_atmos] call.
external_power_trickle	External power that are added over time instead of immediately.
final_countdown	Are we exploding?
gas_heat_modifier	Affects the heat our SM makes.
gas_heat_power_generation	Affects the power gain the SM experiances from heat.
gas_heat_resistance	Affects the minimum point at which the SM takes heat damage
gas_percentage	The list of gases mapped against their current comp. We use this to calculate different values the supermatter uses, like power or heat resistance. Ranges from 0 to 1
gas_power_transmission_rate	Affects the amount of power the main SM zap makes.
gas_powerloss_inhibition	How much power decay is negated. Complete power decay negation at 1.
gl_uid	The amount of supermatters that have been created this round
hallucination_power	How much hallucination should we produce per unit of power?
holiday_lights	If the SM is decorated with holiday lights
hue_angle_shift	Hue shift of the zaps color based on the power of the crystal
include_in_cims	Do we show this crystal in the CIMS modular program
internal_energy	Refered to as EER on the monitor. This value effects gas output, damage, and power generation.
is_main_engine	Only main engines can have their sliver stolen, can trigger cascades, and can spawn stationwide anomalies.
last_accent_sound	cooldown tracker for accent sounds
last_energy_accumulation_perspective_machines	Stores the tick of the machines subsystem of when the last zap energy accumulation occurred. Gives a passage of time in the perspective of SSmachines.
last_high_energy_accumulation_perspective_machines	Same as [last_energy_accumulation_perspective_machines], but based around the high energy zaps found in handle_high_power().
last_power_zap	Stores the time of when the last zap occurred
lastwarning	Time in 1/10th of seconds since the last sent warning
moveable	Can it be moved?
powerloss_linear_offset	The offset of the linear powerloss function set so the transition is differentiable.
powerloss_linear_threshold	The power threshold required to transform the powerloss function into a linear function from a cubic function.
psy_coeff	Var that increases from 0 to 1 when a psychologist is nearby, and decreases in the same way
radio	Our internal radio
radio_key	The key our internal radio uses
saviors	Lazy list of the crazy engineers who managed to turn a cascading engine around.
soundloop	Our soundloop
supermatter_sliver_removed	If a sliver of the supermatter has been removed. Almost certainly by a traitor. Lowers the delamination countdown time.
temp_limit	The temperature at which we start taking damage
uid	The id of our supermatter
warning_point	The point at which we consider the supermatter to be [SUPERMATTER_STATUS_WARNING]
warp	Reference to the warp effect
waste_multiplier	Multiplies our waste gas amount and temperature.
zap_cutoff	The cutoff for a bolt jumping, grows with heat, lowers with higher mol count,
zap_energy_accumulation	Accumulated energy to be transferred from supermatter zaps.
zap_icon	Tracks the bolt color we are using
zap_transmission_rate	The zap power transmission over internal energy. W/MeV.
Procs
accumulate_energy	Accumulates energy for the zap_energy_accumulation key. Args:
calculate_damage	Perform calculation for the damage taken or healed. Description of each factors can be found in the defines.
calculate_gases	Perform calculation for variables that depend on gases. Description of each factors can be found in the defines.
calculate_internal_energy	Perform calculation for power lost and gained this tick. Description of each factors can be found in the defines.
calculate_temp_limit	Calculate at which temperature the sm starts taking damage. heat limit is given by: (T0C+40) * (1 + gas heat res + psy_coeff)
calculate_waste_multiplier	Perform calculation for the waste multiplier. This number affects the temperature, plasma, and oxygen of the waste gas. Multiplier is applied to energy for plasma and temperature but temperature for oxygen.
calculate_zap_transmission_rate	Perform calculation for the main zap power transmission rate in W/MeV. Description of each factors can be found in the defines.
count_down	Count down, spout some messages, and then execute the delam itself. We guard for last second delam strat changes here, mostly because some have diff messages.
discharge_energy	Depletes a portion of the accumulated energy for the given key and returns it. Used for discharging energy from the supermatter. Args:
get_integrity_percent	Returns the integrity percent of the Supermatter. No rounding made yet, round it yourself.
get_status	Encodes the current state of the supermatter.
holiday_hat_examine	Adds the hat flavor text when examined
holiday_item_interaction	Consume the santa hat and add it as an overlay
log_activation
set_delam	Sets the delam of our sm.
sm_ui_data	Returns data that are exclusively about this sm.
tram_contents_consume	Consume things that run into the supermatter from the tram. The tram calls forceMove (doesn't call Bump/ed) and not Move, and I'm afraid changing it will do something chaotic

Var Details

var
absorbed_gasmix
– /datum/gas_mixture

The gasmix we just recently absorbed. Tile's air multiplied by absorption_ratio

var
absorption_ratio

The portion of the gasmix we're on that we should remove

var
activation_logged

Boolean used to log the first activation of the SM.

var
bullet_energy

How much the bullets damage should be multiplied by when it is added to the internal variables

var
common_radio_cooldown

Cooldown for sending emergency alerts to the common radio channel

var
countdown
– /obj/effect/countdown/supermatter

An effect we show to admins and ghosts the percentage of delam we're at

var
current_gas_behavior
– /list

The current gas behaviors for this particular crystal

var
damage

The amount of damage we have currently.

var
damage_archived

The damage we had before this cycle. Used to check if we are currently taking damage or healing.

var
danger_point

The point at which we consider the supermatter to be [SUPERMATTER_STATUS_DANGER] Spawns anomalies when more damaged than this too.

var
delam_priority

Whether the sm is forced in a specific delamination_strategy or not. All truthy values means it's forced. Only values greater or equal to the current one can change the strat.

var
delamination_strategy
– /datum/sm_delam

How we are delaminating.

var
disable_damage

Disables all methods of taking damage.

var
disable_gas

Disables the calculation of gas effects and production of waste. SM still "breathes" though, still takes gas and spits it out. Nothing is done on them though. Cleaner code this way. Get rid of if it's too wasteful.

var
disable_power_change

Disables power changes.

var
disable_process

Disables the SM's proccessing totally when set to SM_PROCESS_DISABLED. Temporary disables the processing when it's set to SM_PROCESS_TIMESTOP. Make sure absorbed_gasmix and gas_percentage isnt null if this is on SM_PROCESS_DISABLED.

var
emergency_point

The point at which we consider the supermatter to be [SUPERMATTER_STATUS_EMERGENCY]

var
explosion_point

The point at which we delam [SUPERMATTER_STATUS_DELAMINATING].

var
explosion_power

A scaling value that affects the severity of explosions.

var
external_damage_immediate

External damage that are added to the sm on next [/obj/machinery/power/supermatter_crystal/process_atmos] call. SM will not take damage if its health is lower than emergency point.

var
external_power_immediate

External power that are added to the sm on next [/obj/machinery/power/supermatter_crystal/process_atmos] call.

var
external_power_trickle

External power that are added over time instead of immediately.

var
final_countdown

Are we exploding?

var
gas_heat_modifier

Affects the heat our SM makes.

var
gas_heat_power_generation

Affects the power gain the SM experiances from heat.

var
gas_heat_resistance

Affects the minimum point at which the SM takes heat damage

var
gas_percentage
– /list

The list of gases mapped against their current comp. We use this to calculate different values the supermatter uses, like power or heat resistance. Ranges from 0 to 1

var
gas_power_transmission_rate

Affects the amount of power the main SM zap makes.

var
gas_powerloss_inhibition

How much power decay is negated. Complete power decay negation at 1.

var
gl_uid
– /static

The amount of supermatters that have been created this round

var
hallucination_power

How much hallucination should we produce per unit of power?

var
holiday_lights

If the SM is decorated with holiday lights

var
hue_angle_shift

Hue shift of the zaps color based on the power of the crystal

var
include_in_cims

Do we show this crystal in the CIMS modular program

var
internal_energy

Refered to as EER on the monitor. This value effects gas output, damage, and power generation.

var
is_main_engine

Only main engines can have their sliver stolen, can trigger cascades, and can spawn stationwide anomalies.

var
last_accent_sound

cooldown tracker for accent sounds

var
last_energy_accumulation_perspective_machines

Stores the tick of the machines subsystem of when the last zap energy accumulation occurred. Gives a passage of time in the perspective of SSmachines.

var
last_high_energy_accumulation_perspective_machines

Same as [last_energy_accumulation_perspective_machines], but based around the high energy zaps found in handle_high_power().

var
last_power_zap

Stores the time of when the last zap occurred

var
lastwarning

Time in 1/10th of seconds since the last sent warning

var
moveable

Can it be moved?

var
powerloss_linear_offset

The offset of the linear powerloss function set so the transition is differentiable.

var
powerloss_linear_threshold

The power threshold required to transform the powerloss function into a linear function from a cubic function.

var
psy_coeff

Var that increases from 0 to 1 when a psychologist is nearby, and decreases in the same way

var
radio
– /obj/item/radio

Our internal radio

var
radio_key

The key our internal radio uses

var
saviors
– /list/datum/weakref

Lazy list of the crazy engineers who managed to turn a cascading engine around.

var
soundloop
– /datum/looping_sound/supermatter

Our soundloop

var
supermatter_sliver_removed

If a sliver of the supermatter has been removed. Almost certainly by a traitor. Lowers the delamination countdown time.

var
temp_limit

The temperature at which we start taking damage

var
uid

The id of our supermatter

var
warning_point

The point at which we consider the supermatter to be [SUPERMATTER_STATUS_WARNING]

var
warp
– /atom/movable/warp_effect

Reference to the warp effect

var
waste_multiplier

Multiplies our waste gas amount and temperature.

var
zap_cutoff

The cutoff for a bolt jumping, grows with heat, lowers with higher mol count,

var
zap_energy_accumulation
– /list

Accumulated energy to be transferred from supermatter zaps.

var
zap_icon

Tracks the bolt color we are using

var
zap_transmission_rate

The zap power transmission over internal energy. W/MeV.

Proc Details

proc
accumulate_energy
(key, energy)

Accumulates energy for the zap_energy_accumulation key. Args:

key: The zap energy accumulation key to use.
energy: The amount of energy to accumulate. Returns: The accumulated energy for that key.

proc
calculate_damage
()

Perform calculation for the damage taken or healed. Description of each factors can be found in the defines.

Updates: /obj/machinery/power/supermatter_crystal/var/damage

Returns: The factors that have influenced the calculation. list[FACTOR_DEFINE] = number

proc
calculate_gases
()

Perform calculation for variables that depend on gases. Description of each factors can be found in the defines.

Updates: [/obj/machinery/power/supermatter_crystal/var/list/gas_percentage] /obj/machinery/power/supermatter_crystal/var/gas_power_transmission_rate /obj/machinery/power/supermatter_crystal/var/gas_heat_modifier /obj/machinery/power/supermatter_crystal/var/gas_heat_resistance /obj/machinery/power/supermatter_crystal/var/gas_heat_power_generation /obj/machinery/power/supermatter_crystal/var/gas_powerloss_inhibition

Returns: null

proc
calculate_internal_energy
()

Perform calculation for power lost and gained this tick. Description of each factors can be found in the defines.

Updates: /obj/machinery/power/supermatter_crystal/var/internal_energy /obj/machinery/power/supermatter_crystal/var/external_power_trickle /obj/machinery/power/supermatter_crystal/var/external_power_immediate

Returns: The factors that have influenced the calculation. list[FACTOR_DEFINE] = number

proc
calculate_temp_limit
()

Calculate at which temperature the sm starts taking damage. heat limit is given by: (T0C+40) * (1 + gas heat res + psy_coeff)

Description of each factors can be found in the defines.

Updates: /obj/machinery/power/supermatter_crystal/var/temp_limit

Returns: The factors that have influenced the calculation. list[FACTOR_DEFINE] = number

proc
calculate_waste_multiplier
()

Perform calculation for the waste multiplier. This number affects the temperature, plasma, and oxygen of the waste gas. Multiplier is applied to energy for plasma and temperature but temperature for oxygen.

Description of each factors can be found in the defines.

Updates: /obj/machinery/power/supermatter_crystal/var/waste_multiplier

Returns: The factors that have influenced the calculation. list[FACTOR_DEFINE] = number

proc
calculate_zap_transmission_rate
()

Perform calculation for the main zap power transmission rate in W/MeV. Description of each factors can be found in the defines.

Updates: /obj/machinery/power/supermatter_crystal/var/zap_transmission_rate

Returns: The factors that have influenced the calculation. list[FACTOR_DEFINE] = number

proc
count_down
()

Count down, spout some messages, and then execute the delam itself. We guard for last second delam strat changes here, mostly because some have diff messages.

By last second changes, we mean that it's possible for say, a tesla delam to just explode normally if at the absolute last second it loses power and switches to default one. Even after countdown is already in progress.

proc
discharge_energy
(key, portion)

Depletes a portion of the accumulated energy for the given key and returns it. Used for discharging energy from the supermatter. Args:

key: The zap energy accumulation key to use.
portion: The portion of the accumulated energy that gets discharged. Returns: The discharged energy for that key.

proc
get_integrity_percent
()

Returns the integrity percent of the Supermatter. No rounding made yet, round it yourself.

proc
get_status
()

Encodes the current state of the supermatter.

proc
holiday_hat_examine
(/atom/source, /mob/user, /list/examine_list)

Adds the hat flavor text when examined

proc
holiday_item_interaction
(source, /mob/living/user, /obj/item/item, /list/modifiers)

Consume the santa hat and add it as an overlay

proc
log_activation
(who, how)

Log when the supermatter is activated for the first time.
Everything that can increase /obj/machinery/power/supermatter_crystal/var/internal_energy
either directly or indirectly MUST call this.
Arguments:
- who - Either a string or a datum. Whatever gave power to the SM. Mandatory.
- how - A datum. How they powered it. Optional.

proc
set_delam
(priority, manual_delam_path)

Sets the delam of our sm.

Arguments:

priority: Truthy values means a forced delam. If current forced_delam is higher than priority we dont run. Set to a number higher than SM_DELAM_PRIO_IN_GAME to fully force an admin delam.
delam_path: Typepath of a /datum/sm_delam. SM_DELAM_STRATEGY_PURGE means reset and put prio back to zero.

Returns: Not used for anything, just returns true on successful set, manual and automatic. Helps admins check stuffs.

proc
sm_ui_data
()

Returns data that are exclusively about this sm.

proc
tram_contents_consume
(/datum/source, /list/tram_contents)

Consume things that run into the supermatter from the tram. The tram calls forceMove (doesn't call Bump/ed) and not Move, and I'm afraid changing it will do something chaotic

supermatter_crystal /obj/machinery/power/supermatter_crystal

Vars

Procs

Var Details

var absorbed_gasmix – /datum/gas_mixture

var absorption_ratio

var activation_logged

var bullet_energy

var common_radio_cooldown

var countdown – /obj/effect/countdown/supermatter

var current_gas_behavior – /list

var damage

var damage_archived

var danger_point

var delam_priority

var delamination_strategy – /datum/sm_delam

var disable_damage

var disable_gas

var disable_power_change

var disable_process

var emergency_point

var explosion_point

var explosion_power

var external_damage_immediate

var external_power_immediate

var external_power_trickle

var final_countdown

var gas_heat_modifier

var gas_heat_power_generation

var gas_heat_resistance

var gas_percentage – /list

var gas_power_transmission_rate

var gas_powerloss_inhibition

var gl_uid – /static

var hallucination_power

var holiday_lights

var hue_angle_shift

var include_in_cims

var internal_energy

var is_main_engine

var last_accent_sound

var last_energy_accumulation_perspective_machines

var last_high_energy_accumulation_perspective_machines

var last_power_zap

var lastwarning

var moveable

var powerloss_linear_offset

var powerloss_linear_threshold

var psy_coeff

var radio – /obj/item/radio

var radio_key

var saviors – /list/datum/weakref

var soundloop – /datum/looping_sound/supermatter

var supermatter_sliver_removed

var temp_limit

var uid

var warning_point

var warp – /atom/movable/warp_effect

var waste_multiplier

var zap_cutoff

var zap_energy_accumulation – /list

var zap_icon

var zap_transmission_rate

Proc Details

proc accumulate_energy(key, energy)

proc calculate_damage()

proc calculate_gases()

proc calculate_internal_energy()

proc calculate_temp_limit()

proc calculate_waste_multiplier()

proc calculate_zap_transmission_rate()

proc count_down()

proc discharge_energy(key, portion)

proc get_integrity_percent()

proc get_status()

proc holiday_hat_examine(/atom/source, /mob/user, /list/examine_list)

proc holiday_item_interaction(source, /mob/living/user, /obj/item/item, /list/modifiers)

proc log_activation(who, how)

proc set_delam(priority, manual_delam_path)

proc sm_ui_data()

supermatter_crystal
/obj/machinery/power/supermatter_crystal

var
absorbed_gasmix
– /datum/gas_mixture

var
absorption_ratio

var
activation_logged

var
bullet_energy

var
common_radio_cooldown

var
countdown
– /obj/effect/countdown/supermatter

var
current_gas_behavior
– /list

var
damage

var
damage_archived

var
danger_point

var
delam_priority

var
delamination_strategy
– /datum/sm_delam

var
disable_damage

var
disable_gas

var
disable_power_change

var
disable_process

var
emergency_point

var
explosion_point

var
explosion_power

var
external_damage_immediate

var
external_power_immediate

var
external_power_trickle

var
final_countdown

var
gas_heat_modifier

var
gas_heat_power_generation

var
gas_heat_resistance

var
gas_percentage
– /list

var
gas_power_transmission_rate

var
gas_powerloss_inhibition

var
gl_uid
– /static

var
hallucination_power

var
holiday_lights

var
hue_angle_shift

var
include_in_cims

var
internal_energy

var
is_main_engine

var
last_accent_sound

var
last_energy_accumulation_perspective_machines

var
last_high_energy_accumulation_perspective_machines

var
last_power_zap

var
lastwarning

var
moveable

var
powerloss_linear_offset

var
powerloss_linear_threshold

var
psy_coeff

var
radio
– /obj/item/radio

var
radio_key

var
saviors
– /list/datum/weakref

var
soundloop
– /datum/looping_sound/supermatter

var
supermatter_sliver_removed

var
temp_limit

var
uid

var
warning_point

var
warp
– /atom/movable/warp_effect

var
waste_multiplier

var
zap_cutoff

var
zap_energy_accumulation
– /list

var
zap_icon

var
zap_transmission_rate

proc
accumulate_energy
(key, energy)

proc
calculate_damage
()

proc
calculate_gases
()

proc
calculate_internal_energy
()

proc
calculate_temp_limit
()

proc
calculate_waste_multiplier
()

proc
calculate_zap_transmission_rate
()

proc
count_down
()

proc
discharge_energy
(key, portion)

proc
get_integrity_percent
()

proc
get_status
()

proc
holiday_hat_examine
(/atom/source, /mob/user, /list/examine_list)

proc
holiday_item_interaction
(source, /mob/living/user, /obj/item/item, /list/modifiers)

proc
log_activation
(who, how)

proc
set_delam
(priority, manual_delam_path)

proc
sm_ui_data
()

proc
tram_contents_consume
(/datum/source, /list/tram_contents)