reagents

////////////////////////////Main reagents code///////////////////////////////////////////// Holder for a bunch of /datum/reagent

Vars
chem_temp	Current temp of the holder volume
failed_but_capable_reactions	If a reaction fails due to temperature or pH, this tracks the required temperature or pH for it to be enabled.
flags	various flags, see code__DEFINES\reagents.dm
is_reacting	Hard check to see if the reagents is presently reacting
last_tick	unused
maximum_volume	Max volume of this holder
my_atom	The atom this holder is attached to
ph	pH of the whole system
previous_reagent_list	cached list of reagents typepaths (not object references), this is a lazylist for optimisation
reaction_list	list of reactions currently on going, this is a lazylist for optimisation
reagent_list	The reagents being held
total_volume	Current volume of all the reagents
ui_beaker_sync	If we're syncing with the beaker - so return reactions that are actively happening
ui_reaction_id	UI lookup stuff Keeps the id of the reaction displayed in the ui
ui_reaction_index	What index we're at if we have multiple reactions for a reagent product
ui_reagent_id	Keeps the id of the reagent displayed in the ui
ui_tags_selected	The bitflag of the currently selected tags in the ui
Procs
add_reagent	Adds a reagent to this holder
add_reagent_list	Like add_reagent but you can enter a list. Format it like this: list(/datum/reagent/toxin = 10, "beer" = 15)
adjust_thermal_energy
clear_reagents	Removes all reagents
conditional_update	Calls /datum/reagent/proc/on_update on every reagent in this holder
conditional_update_move	Calls /datum/reagent/proc/on_move on every reagent in this holder
copy_data	Shallow copies (deep copy of viruses) data from the provided reagent into our copy of that reagent
copy_to	Copies the reagents to the target object
del_reagent	Fuck this one reagent
determine_reaction_thermics	Returns a string descriptor of a reactions themic_constant
end_metabolization	Signals that metabolization has stopped, triggering the end of trait-based effects
expose	Applies the relevant expose_ proc for every reagent in this holder
expose_single	Same as /datum/reagents/proc/expose but only for one reagent
expose_temperature	Applies heat to this holder
generate_taste_message	Returns what this holder's reagents taste like
generate_thermodynamic_profile	Generates a (rough) rate vs temperature graph profile
get_data	helper function to preserve data across reactions (needed for xenoarch)
get_master_reagent	Get a reference to the reagent there is the most of in this holder
get_master_reagent_id	Get the id of the reagent there is the most of in this holder
get_master_reagent_name	Get the name of the reagent there is the most of in this holder
get_priority_instant_reaction	Possibly remove - see if multiple instant reactions is okay (Though, this "sorts" reactions by temp decending) Presently unused
get_reagent	Get a reference to the reagent if it exists
get_reagent_amount	Get the amount of this reagent
get_reagent_names	Get a comma separated string of every reagent name in this holder. UNUSED
get_reagent_purity	Get the purity of this reagent
handle_reactions	Handle any reactions possible in this holder Also UPDATES the reaction list High potential for infinite loopsa if you're editing this.
handle_stasis_chems	Processes any chems that have the REAGENT_IGNORE_STASIS bitflag ONLY
has_changed_state	Checks to see if the reagents has a difference in reagents_list and previous_reagent_list (I.e. if there's a difference between the previous call and the last) Also checks to see if the saved reactions in failed_but_capable_reactions can start as a result of temp/pH change
has_reagent	Check if this holder contains this reagent. Reagent takes a PATH to a reagent. Amount checks for having a specific amount of that chemical. Needs matabolizing takes into consideration if the chemical is matabolizing when it's checked.
heat_capacity	Returns the total heat capacity for all of the reagents currently in this holder.
holder_full	Is this holder full or not
instant_react	Old reaction mechanics, edited to work on one only This is changed from the old - purity of the reagents will affect yield
isolate_reagent	Remove every reagent except this one
log_list	Used in attack logs for reagents in pills and such
metabolize	Triggers metabolizing for all the reagents in this holder
multiply_reagents	Multiplies the reagents inside this holder by a specific amount
remove_all	Removes all reagents from this holder
remove_all_type	Removes all reagent of X type. @strict set to 1 determines whether the childs of the type are included.
remove_any	Remove an amount of reagents without caring about what they are
remove_reagent	Remove a specific reagent
set_data	helper function to preserve data across reactions (needed for xenoarch)
set_temperature
trans_id_to	Transfer a specific reagent id to the target object
trans_to	Transfer some stuff from this holder to a target object
ui_interact	UI / REAGENTS LOOKUP CODE
update_total	Updates /datum/reagents/var/total_volume

Var Details

var
chem_temp
–

Current temp of the holder volume

var
failed_but_capable_reactions
– /list

If a reaction fails due to temperature or pH, this tracks the required temperature or pH for it to be enabled.

var
flags
–

various flags, see code__DEFINES\reagents.dm

var
is_reacting
–

Hard check to see if the reagents is presently reacting

var
last_tick
–

unused

var
maximum_volume
–

Max volume of this holder

var
my_atom
– /atom

The atom this holder is attached to

var
ph
–

pH of the whole system

var
previous_reagent_list
– /list/datum/reagent

cached list of reagents typepaths (not object references), this is a lazylist for optimisation

var
reaction_list
– /list/datum/equilibrium

list of reactions currently on going, this is a lazylist for optimisation

var
reagent_list
– /list/datum/reagent

The reagents being held

var
total_volume
–

Current volume of all the reagents

var
ui_beaker_sync
–

If we're syncing with the beaker - so return reactions that are actively happening

var
ui_reaction_id
–

UI lookup stuff Keeps the id of the reaction displayed in the ui

var
ui_reaction_index
–

What index we're at if we have multiple reactions for a reagent product

var
ui_reagent_id
–

Keeps the id of the reagent displayed in the ui

var
ui_tags_selected
–

The bitflag of the currently selected tags in the ui

Proc Details

proc
add_reagent
(reagent, amount, /list/data, reagtemp, added_purity, added_ph, no_react, override_base_ph, ignore_splitting)

Adds a reagent to this holder

Arguments:

reagent - The reagent id to add
amount - Amount to add
list/data - Any reagent data for this reagent, used for transferring data with reagents
reagtemp - Temperature of this reagent, will be equalized
no_react - prevents reactions being triggered by this addition
added_purity - override to force a purity when added
added_ph - override to force a pH when added
override_base_ph - ingore the present pH of the reagent, and instead use the default (i.e. if buffers/reactions alter it)
ignore splitting - Don't call the process that handles reagent spliting in a mob (impure/inverse) - generally leave this false unless you care about REAGENTS_DONOTSPLIT flags (see reagent defines)

proc
add_reagent_list
(/list/list_reagents, /list/data)

Like add_reagent but you can enter a list. Format it like this: list(/datum/reagent/toxin = 10, "beer" = 15)

proc
adjust_thermal_energy
(delta_energy, min_temp, max_temp)

Adjusts the thermal energy of the reagents in this holder by an amount.
Arguments:
- delta_energy: The amount to change the thermal energy by.
- min_temp: The minimum temperature that can be reached.
- max_temp: The maximum temperature that can be reached.

proc
clear_reagents
()

Removes all reagents

proc
conditional_update
(/atom/A)

Calls /datum/reagent/proc/on_update on every reagent in this holder

Arguments:

atom/A - passed to on_update

proc
conditional_update_move
(/atom/A, Running)

Calls /datum/reagent/proc/on_move on every reagent in this holder

Arguments:

atom/A - passed to on_move
Running - passed to on_move

proc
copy_data
(/datum/reagent/current_reagent)

Shallow copies (deep copy of viruses) data from the provided reagent into our copy of that reagent

proc
copy_to
(/obj/target, amount, multiplier, preserve_data)

Copies the reagents to the target object

proc
del_reagent
(target_reagent_typepath)

Fuck this one reagent

proc
determine_reaction_thermics
(/datum/chemical_reaction/reaction)

Returns a string descriptor of a reactions themic_constant

proc
end_metabolization
(/mob/living/carbon/C, keep_liverless)

Signals that metabolization has stopped, triggering the end of trait-based effects

proc
expose
(/atom/A, methods, volume_modifier, show_message)

Applies the relevant expose_ proc for every reagent in this holder

Arguments

Atom/A: What mob/turf/object is being exposed to reagents? This is your reaction target.
Methods: What reaction type is the reagent itself going to call on the reaction target? Types are TOUCH, INGEST, VAPOR, PATCH, and INJECT.
Volume_modifier: What is the reagent volume multiplied by when exposed? Note that this is called on the volume of EVERY reagent in the base body, so factor in your Maximum_Volume if necessary!
Show_message: Whether to display anything to mobs when they are exposed.

proc
expose_single
(/datum/reagent/R, /atom/A, methods, volume_modifier, show_message)

Same as /datum/reagents/proc/expose but only for one reagent

proc
expose_temperature
(temperature, coeff)

Applies heat to this holder

proc
generate_taste_message
(/mob/living/taster, minimum_percent)

Returns what this holder's reagents taste like

Arguments:

mob/living/taster - who is doing the tasting. Some mobs can pick up specific flavours.
minimum_percent - the lower the minimum percent, the more sensitive the message is.

proc
generate_thermodynamic_profile
(/datum/chemical_reaction/reaction)

Generates a (rough) rate vs temperature graph profile

proc
get_data
(reagent_id)

helper function to preserve data across reactions (needed for xenoarch)

proc
get_master_reagent
()

Get a reference to the reagent there is the most of in this holder

proc
get_master_reagent_id
()

Get the id of the reagent there is the most of in this holder

proc
get_master_reagent_name
()

Get the name of the reagent there is the most of in this holder

proc
get_priority_instant_reaction
(/list/possible_reactions)

Possibly remove - see if multiple instant reactions is okay (Though, this "sorts" reactions by temp decending) Presently unused

proc
get_reagent
(type)

Get a reference to the reagent if it exists

proc
get_reagent_amount
(reagent)

Get the amount of this reagent

proc
get_reagent_names
()

Get a comma separated string of every reagent name in this holder. UNUSED

proc
get_reagent_purity
(reagent)

Get the purity of this reagent

proc
handle_reactions
()

Handle any reactions possible in this holder Also UPDATES the reaction list High potential for infinite loopsa if you're editing this.

proc
handle_stasis_chems
(/mob/living/carbon/owner, delta_time, times_fired)

Processes any chems that have the REAGENT_IGNORE_STASIS bitflag ONLY

proc
has_changed_state
()

Checks to see if the reagents has a difference in reagents_list and previous_reagent_list (I.e. if there's a difference between the previous call and the last) Also checks to see if the saved reactions in failed_but_capable_reactions can start as a result of temp/pH change

proc
has_reagent
(reagent, amount, needs_metabolizing)

Check if this holder contains this reagent. Reagent takes a PATH to a reagent. Amount checks for having a specific amount of that chemical. Needs matabolizing takes into consideration if the chemical is matabolizing when it's checked.

proc
heat_capacity
()

Returns the total heat capacity for all of the reagents currently in this holder.

proc
holder_full
()

Is this holder full or not

proc
instant_react
(/datum/chemical_reaction/selected_reaction)

Old reaction mechanics, edited to work on one only This is changed from the old - purity of the reagents will affect yield

proc
isolate_reagent
(reagent)

Remove every reagent except this one

proc
log_list
(external_list)

Used in attack logs for reagents in pills and such

Arguments:

external_list - assoc list of reagent type = list(REAGENT_TRANSFER_AMOUNT = amounts, REAGENT_PURITY = purity)

proc
metabolize
(/mob/living/carbon/owner, delta_time, times_fired, can_overdose, liverless)

Triggers metabolizing for all the reagents in this holder

Arguments:

mob/living/carbon/carbon - The mob to metabolize in, if null it uses /datum/reagents/var/my_atom
delta_time - the time in server seconds between proc calls (when performing normally it will be 2)
times_fired - the number of times the owner's life() tick has been called aka The number of times SSmobs has fired
can_overdose - Allows overdosing
liverless - Stops reagents that aren't set as /datum/reagent/var/self_consuming from metabolizing

proc
multiply_reagents
(multiplier)

Multiplies the reagents inside this holder by a specific amount

proc
remove_all
(amount)

Removes all reagents from this holder

proc
remove_all_type
(reagent_type, amount, strict, safety)

Removes all reagent of X type. @strict set to 1 determines whether the childs of the type are included.

proc
remove_any
(amount)

Remove an amount of reagents without caring about what they are

proc
remove_reagent
(reagent, amount, safety)

Remove a specific reagent

proc
set_data
(reagent_id, new_data)

helper function to preserve data across reactions (needed for xenoarch)

proc
set_temperature
(_temperature)

Sets the temperature of this reagent container to a new value.
Handles setter signals.
Arguments:
- _temperature: The new temperature value.

proc
trans_id_to
(/obj/target, reagent, amount, preserve_data)

Transfer a specific reagent id to the target object

proc
trans_to
(/obj/target, amount, multiplier, preserve_data, no_react, /mob/transfered_by, remove_blacklisted, methods, show_message, round_robin, ignore_stomach)

Transfer some stuff from this holder to a target object

Arguments:

obj/target - Target to attempt transfer to
amount - amount of reagent volume to transfer
multiplier - multiplies amount of each reagent by this number
preserve_data - if preserve_data=0, the reagents data will be lost. Usefull if you use data for some strange stuff and don't want it to be transferred.
no_react - passed through to /datum/reagents/proc/add_reagent
mob/transfered_by - used for logging
remove_blacklisted - skips transferring of reagents without REAGENT_CAN_BE_SYNTHESIZED in chemical_flags
methods - passed through to /datum/reagents/proc/expose_single and /datum/reagent/proc/on_transfer
show_message - passed through to /datum/reagents/proc/expose_single
round_robin - if round_robin=TRUE, so transfer 5 from 15 water, 15 sugar and 15 plasma becomes 10, 15, 15 instead of 13.3333, 13.3333 13.3333. Good if you hate floating point errors
ignore_stomach - when using methods INGEST will not use the stomach as the target

↑
ui_interact
(/mob/user, /datum/tgui/ui)

UI / REAGENTS LOOKUP CODE

proc
update_total
()

Updates /datum/reagents/var/total_volume

reagents /datum/reagents

Vars

Procs

Var Details

var chem_temp –

var failed_but_capable_reactions – /list

var flags –

var is_reacting –

var last_tick –

var maximum_volume –

var my_atom – /atom

var ph –

var previous_reagent_list – /list/datum/reagent

var reaction_list – /list/datum/equilibrium

var reagent_list – /list/datum/reagent

var total_volume –

var ui_beaker_sync –

var ui_reaction_id –

var ui_reaction_index –

var ui_reagent_id –

var ui_tags_selected –

Proc Details

proc add_reagent(reagent, amount, /list/data, reagtemp, added_purity, added_ph, no_react, override_base_ph, ignore_splitting)

proc add_reagent_list(/list/list_reagents, /list/data)

proc adjust_thermal_energy(delta_energy, min_temp, max_temp)

proc clear_reagents()

proc conditional_update(/atom/A)

proc conditional_update_move(/atom/A, Running)

proc copy_data(/datum/reagent/current_reagent)

proc copy_to(/obj/target, amount, multiplier, preserve_data)

proc del_reagent(target_reagent_typepath)

proc determine_reaction_thermics(/datum/chemical_reaction/reaction)

proc end_metabolization(/mob/living/carbon/C, keep_liverless)

proc expose(/atom/A, methods, volume_modifier, show_message)

proc expose_single(/datum/reagent/R, /atom/A, methods, volume_modifier, show_message)

proc expose_temperature(temperature, coeff)

proc generate_taste_message(/mob/living/taster, minimum_percent)

proc generate_thermodynamic_profile(/datum/chemical_reaction/reaction)

proc get_data(reagent_id)

proc get_master_reagent()

proc get_master_reagent_id()

proc get_master_reagent_name()

proc get_priority_instant_reaction(/list/possible_reactions)

proc get_reagent(type)

proc get_reagent_amount(reagent)

proc get_reagent_names()

proc get_reagent_purity(reagent)

proc handle_reactions()

proc handle_stasis_chems(/mob/living/carbon/owner, delta_time, times_fired)

proc has_changed_state()

proc has_reagent(reagent, amount, needs_metabolizing)

proc heat_capacity()

proc holder_full()

proc instant_react(/datum/chemical_reaction/selected_reaction)

proc isolate_reagent(reagent)

proc log_list(external_list)

proc metabolize(/mob/living/carbon/owner, delta_time, times_fired, can_overdose, liverless)

proc multiply_reagents(multiplier)

proc remove_all(amount)

proc remove_all_type(reagent_type, amount, strict, safety)

proc remove_any(amount)

proc remove_reagent(reagent, amount, safety)

proc set_data(reagent_id, new_data)

proc set_temperature(_temperature)

proc trans_id_to(/obj/target, reagent, amount, preserve_data)

proc trans_to(/obj/target, amount, multiplier, preserve_data, no_react, /mob/transfered_by, remove_blacklisted, methods, show_message, round_robin, ignore_stomach)

↑ui_interact(/mob/user, /datum/tgui/ui)

proc update_total()

reagents
/datum/reagents

var
chem_temp
–

var
failed_but_capable_reactions
– /list

var
flags
–

var
is_reacting
–

var
last_tick
–

var
maximum_volume
–

var
my_atom
– /atom

var
ph
–

var
previous_reagent_list
– /list/datum/reagent

var
reaction_list
– /list/datum/equilibrium

var
reagent_list
– /list/datum/reagent

var
total_volume
–

var
ui_beaker_sync
–

var
ui_reaction_id
–

var
ui_reaction_index
–

var
ui_reagent_id
–

var
ui_tags_selected
–

proc
add_reagent
(reagent, amount, /list/data, reagtemp, added_purity, added_ph, no_react, override_base_ph, ignore_splitting)

proc
add_reagent_list
(/list/list_reagents, /list/data)

proc
adjust_thermal_energy
(delta_energy, min_temp, max_temp)

proc
clear_reagents
()

proc
conditional_update
(/atom/A)

proc
conditional_update_move
(/atom/A, Running)

proc
copy_data
(/datum/reagent/current_reagent)

proc
copy_to
(/obj/target, amount, multiplier, preserve_data)

proc
del_reagent
(target_reagent_typepath)

proc
determine_reaction_thermics
(/datum/chemical_reaction/reaction)

proc
end_metabolization
(/mob/living/carbon/C, keep_liverless)

proc
expose
(/atom/A, methods, volume_modifier, show_message)

proc
expose_single
(/datum/reagent/R, /atom/A, methods, volume_modifier, show_message)

proc
expose_temperature
(temperature, coeff)

proc
generate_taste_message
(/mob/living/taster, minimum_percent)

proc
generate_thermodynamic_profile
(/datum/chemical_reaction/reaction)

proc
get_data
(reagent_id)

proc
get_master_reagent
()

proc
get_master_reagent_id
()

proc
get_master_reagent_name
()

proc
get_priority_instant_reaction
(/list/possible_reactions)

proc
get_reagent
(type)

proc
get_reagent_amount
(reagent)

proc
get_reagent_names
()

proc
get_reagent_purity
(reagent)

proc
handle_reactions
()

proc
handle_stasis_chems
(/mob/living/carbon/owner, delta_time, times_fired)

proc
has_changed_state
()

proc
has_reagent
(reagent, amount, needs_metabolizing)

proc
heat_capacity
()

proc
holder_full
()

proc
instant_react
(/datum/chemical_reaction/selected_reaction)

proc
isolate_reagent
(reagent)

proc
log_list
(external_list)

proc
metabolize
(/mob/living/carbon/owner, delta_time, times_fired, can_overdose, liverless)

proc
multiply_reagents
(multiplier)

proc
remove_all
(amount)

proc
remove_all_type
(reagent_type, amount, strict, safety)

proc
remove_any
(amount)

proc
remove_reagent
(reagent, amount, safety)

proc
set_data
(reagent_id, new_data)

proc
set_temperature
(_temperature)

proc
trans_id_to
(/obj/target, reagent, amount, preserve_data)

proc
trans_to
(/obj/target, amount, multiplier, preserve_data, no_react, /mob/transfered_by, remove_blacklisted, methods, show_message, round_robin, ignore_stomach)

↑
ui_interact
(/mob/user, /datum/tgui/ui)

proc
update_total
()