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, this tracks the required temperature 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
metabolism_class	The metabolism type this container uses. For mobs.
my_atom	The atom this holder is attached to
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. Arguments
add_reagent_up_to	Adds a reagent up to a cap.
adjust_thermal_energy
clear_reagents	Removes all reagents
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	Removes an specific reagent from this holder Arguments
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
getHeatCapacity	Returns the total heat capacity for all of the reagents currently in this holder.
get_data	helper function to preserve data across reactions (needed for xenoarch)
get_external_reagent_log_string	Outputs a log-friendly list of reagents based on an external reagent list.
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_log_string	Outputs a log-friendly list of reagents based on the internal reagent_list.
get_reagent_names	Get a comma separated string of every reagent name in this holder. UNUSED
handle_reactions	Handle any reactions possible in this holder Also UPDATES the reaction list High potential for infinite loopsa if you're editing this.
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 change
has_chemical_flag	Check if this holder contains a reagent with a chemical_flags containing this flag Reagent takes the bitflag to search for Amount checks for having a specific amount of reagents matching that chemical
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.
has_reagent_list	Like has_reagent but you can enter a list.
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
is_reaction_overheating	Returns TRUE if this container's temp would overheat a reaction.
isolate_reagent	Remove every reagent except this one
metabolize	Triggers metabolizing for all the reagents in this holder
multiply_reagents	Multiplies the reagents inside this holder by a specific amount
reaction_message	Gives feedback that a reaction is occuring. Returns an icon2html string.
remove_all	Removes all reagents either proportionally(amount is the direct volume to remove) when proportional the total volume of all reagents removed will equal to amount or relatively(amount is a percentile between 0->1) when relative amount is the % of each reagent to be removed
remove_reagent	Removes a specific reagent. can supress reactions if needed Arguments
remove_reagent_list	Like remove_reagent but you can enter a list.
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. Accepts a reagent instance, but assumes the reagent is in src.
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, this tracks the required temperature 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
metabolism_class
–

The metabolism type this container uses. For mobs.

var
my_atom
– /atom

The atom this holder is attached to

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, no_react, 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
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. Arguments

[list_reagents][list] - list to add. Format it like this: list(/datum/reagent/toxin = 10, "beer" = 15)
[data][list] - additional data to add

proc
add_reagent_up_to
(reagent, amount, cap)

Adds a reagent up to a cap.

proc
adjust_thermal_energy
(delta_energy, min_temp, max_temp, handle_reactions)

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
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, no_react)

Copies the reagents to the target object

proc
del_reagent
(/datum/reagent/target_reagent_typepath)

Removes an specific reagent from this holder Arguments

target_reagent_typepath - type typepath of the reagent to remove

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, expose_volume, 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
getHeatCapacity
()

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

proc
get_data
(reagent_id)

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

proc
get_external_reagent_log_string
(external_list)

Outputs a log-friendly list of reagents based on an external reagent list.

Arguments:

external_list - Assoc list of (reagent_type) = list(REAGENT_TRANSFER_AMOUNT = amounts)

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_log_string
()

Outputs a log-friendly list of reagents based on the internal reagent_list.

Arguments:

external_list - Assoc list of (reagent_type) = list(REAGENT_TRANSFER_AMOUNT = amounts)

proc
get_reagent_names
()

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

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
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 change

proc
has_chemical_flag
(chemical_flag, amount)

Check if this holder contains a reagent with a chemical_flags containing this flag Reagent takes the bitflag to search for Amount checks for having a specific amount of reagents matching that chemical

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
has_reagent_list
(/list/list_reagents)

Like has_reagent but you can enter a list.

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
is_reaction_overheating
(/datum/chemical_reaction/reaction)

Returns TRUE if this container's temp would overheat a reaction.

proc
isolate_reagent
(reagent)

Remove every reagent except this one

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

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
reaction_message
(/datum/chemical_reaction/reaction, is_overheating, /atom/display_atom)

Gives feedback that a reaction is occuring. Returns an icon2html string.

proc
remove_all
(amount, relative)

Removes all reagents either proportionally(amount is the direct volume to remove) when proportional the total volume of all reagents removed will equal to amount or relatively(amount is a percentile between 0->1) when relative amount is the % of each reagent to be removed

Arguments

amount - the amount to remove
relative - if TRUE amount is treated as an percentage between 0->1. If FALSE amount is the direct volume to remove

proc
remove_reagent
(/datum/reagent/reagent_type, amount, safety, include_subtypes)

Removes a specific reagent. can supress reactions if needed Arguments

reagent_type - the type of reagent
amount - the volume to remove
safety - if FALSE will initiate reactions upon removing. used for trans_id_to
include_subtypes - if TRUE will remove the specified amount from all subtypes of reagent_type as well

proc
remove_reagent_list
(/list/list_reagents)

Like remove_reagent but you can enter a list.

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, /datum/reagent/reagent, amount, preserve_data)

Transfer a specific reagent id to the target object. Accepts a reagent instance, but assumes the reagent is in src.

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

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 with REAGENT_SPECIAL 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

↑
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 metabolism_class –

var my_atom – /atom

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, no_react, ignore_splitting)

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

proc add_reagent_up_to(reagent, amount, cap)

proc adjust_thermal_energy(delta_energy, min_temp, max_temp, handle_reactions)

proc clear_reagents()

proc copy_data(/datum/reagent/current_reagent)

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

proc del_reagent(/datum/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, expose_volume, 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 getHeatCapacity()

proc get_data(reagent_id)

proc get_external_reagent_log_string(external_list)

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_log_string()

proc get_reagent_names()

proc handle_reactions()

proc has_changed_state()

proc has_chemical_flag(chemical_flag, amount)

proc has_reagent(reagent, amount, needs_metabolizing)

proc has_reagent_list(/list/list_reagents)

proc holder_full()

proc instant_react(/datum/chemical_reaction/selected_reaction)

proc is_reaction_overheating(/datum/chemical_reaction/reaction)

proc isolate_reagent(reagent)

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

proc multiply_reagents(multiplier)

proc reaction_message(/datum/chemical_reaction/reaction, is_overheating, /atom/display_atom)

proc remove_all(amount, relative)

proc remove_reagent(/datum/reagent/reagent_type, amount, safety, include_subtypes)

proc remove_reagent_list(/list/list_reagents)

proc set_data(reagent_id, new_data)

proc set_temperature(_temperature)

proc trans_id_to(/obj/target, /datum/reagent/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)

↑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
metabolism_class
–

var
my_atom
– /atom

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, no_react, ignore_splitting)

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

proc
add_reagent_up_to
(reagent, amount, cap)

proc
adjust_thermal_energy
(delta_energy, min_temp, max_temp, handle_reactions)

proc
clear_reagents
()

proc
copy_data
(/datum/reagent/current_reagent)

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

proc
del_reagent
(/datum/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, expose_volume, 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
getHeatCapacity
()

proc
get_data
(reagent_id)

proc
get_external_reagent_log_string
(external_list)

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_log_string
()

proc
get_reagent_names
()

proc
handle_reactions
()

proc
has_changed_state
()

proc
has_chemical_flag
(chemical_flag, amount)

proc
has_reagent
(reagent, amount, needs_metabolizing)

proc
has_reagent_list
(/list/list_reagents)

proc
holder_full
()

proc
instant_react
(/datum/chemical_reaction/selected_reaction)

proc
is_reaction_overheating
(/datum/chemical_reaction/reaction)

proc
isolate_reagent
(reagent)

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

proc
multiply_reagents
(multiplier)

proc
reaction_message
(/datum/chemical_reaction/reaction, is_overheating, /atom/display_atom)

proc
remove_all
(amount, relative)

proc
remove_reagent
(/datum/reagent/reagent_type, amount, safety, include_subtypes)

proc
remove_reagent_list
(/list/list_reagents)

proc
set_data
(reagent_id, new_data)

proc
set_temperature
(_temperature)

proc
trans_id_to
(/obj/target, /datum/reagent/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)

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

proc
update_total
()