Files
BatrachophrenoandGitHub 387cee9243 Object Examine Text Overhaul (#20923)
Extends and reworks how various extended information text (desc_info,
desc_build, desc_upgrades) are handled to make object interactions and
mechanics A.) much more clearly documented in-game and B.) much easier
to support from the back-end.

Almost certainly a candidate for test merge.

Assembly/Disassembly instructions are noticeably sporadic, largely due
to our current lack of a unified framework. That's a future thing I'd
like to attack so that it can be handled programmatically, but for now I
only targeted the biggest culprits as I came across them.

---------

Signed-off-by: Batrachophreno <Batrochophreno@gmail.com>
2025-07-21 15:35:14 +00:00

177 lines
5.4 KiB
Plaintext

//TODO: Put this under a common parent type with freezers to cut down on the copypasta
#define HEATER_PERF_MULT 2.5
/obj/machinery/atmospherics/unary/heater
name = "gas heating system"
desc = "Heats gas when connected to a pipe network."
icon = 'icons/obj/machinery/sleeper.dmi'
icon_state = "heater_0"
density = 1
anchored = 1
use_power = POWER_USE_OFF
idle_power_usage = 5 //5 Watts for thermostat related circuitry
var/max_temperature = T20C + 680
var/internal_volume = 600 //L
var/max_power_rating = 20000 //power rating when the usage is turned up to 100
var/power_setting = 100
var/set_temperature = T20C //thermostat
var/heating = 0 //mainly for icon updates
component_types = list(
/obj/item/circuitboard/unary_atmos/heater,
/obj/item/stock_parts/matter_bin,
/obj/item/stock_parts/capacitor = 2,
/obj/item/stack/cable_coil{amount = 5}
)
/obj/machinery/atmospherics/unary/heater/mechanics_hints(mob/user, distance, is_adjacent)
. += ..()
. += "heats up the gas of the pipe it is connected to. It uses massive amounts of electricity while on."
/obj/machinery/atmospherics/unary/heater/upgrade_hints(mob/user, distance, is_adjacent)
. += ..()
. += "Upgraded <b>matter bins</b> will increase maximum temperature setting and the volume of air it can heat at once."
. += "Upgraded <b>capacitors</b> will increase maximum power setting and maximum temperature setting."
/obj/machinery/atmospherics/unary/heater/Initialize()
initialize_directions = dir
. = ..()
/obj/machinery/atmospherics/unary/heater/atmos_init()
if(node)
return
var/node_connect = dir
//check that there is something to connect to
for(var/obj/machinery/atmospherics/target in get_step(src, node_connect))
if(target.initialize_directions & get_dir(target, src))
node = target
break
//copied from pipe construction code since heaters/freezers don't use fittings and weren't doing this check - this all really really needs to be refactored someday.
//check that there are no incompatible pipes/machinery in our own location
for(var/obj/machinery/atmospherics/M in src.loc)
if(M != src && (M.initialize_directions & node_connect) && M.check_connect_types(M,src)) // matches at least one direction on either type of pipe & same connection type
node = null
break
update_icon()
/obj/machinery/atmospherics/unary/heater/update_icon()
if(node)
if(use_power && heating)
icon_state = "heater_1"
else
icon_state = "heater"
else
icon_state = "heater_0"
return
/obj/machinery/atmospherics/unary/heater/process()
..()
if(stat & (NOPOWER|BROKEN) || !use_power)
heating = 0
update_icon()
return
if(network && air_contents.total_moles && air_contents.temperature < set_temperature)
air_contents.add_thermal_energy(power_rating * HEATER_PERF_MULT)
use_power_oneoff(power_rating)
heating = 1
network.update = 1
else
heating = 0
update_icon()
/obj/machinery/atmospherics/unary/heater/attack_ai(mob/user as mob)
if(!ai_can_interact(user))
return
ui_interact(user)
/obj/machinery/atmospherics/unary/heater/attack_hand(mob/user as mob)
ui_interact(user)
/obj/machinery/atmospherics/unary/heater/ui_interact(mob/user, var/datum/tgui/ui)
ui = SStgui.try_update_ui(user, src, ui)
if(!ui)
ui = new(user, src, "Freezer", "Gas Heating System", 440, 300)
ui.open()
/obj/machinery/atmospherics/unary/heater/ui_data(mob/user)
var/list/data = list()
data["on"] = !!use_power
data["gasPressure"] = round(air_contents.return_pressure())
data["gasTemperature"] = round(air_contents.temperature)
data["minGasTemperature"] = 0
data["maxGasTemperature"] = round(T20C + 600)
data["targetGasTemperature"] = round(set_temperature)
data["powerSetting"] = power_setting
data["gasTemperatureBadTop"] = (T20C + 40)
data["gasTemperatureBadBottom"] = null
data["gasTemperatureAvgTop"] = null
data["gasTemperatureAvgBottom"] = null
return data
/obj/machinery/atmospherics/unary/heater/ui_act(action, list/params, datum/tgui/ui, datum/ui_state/state)
. = ..()
if(.)
return TRUE
switch(action)
if("power")
update_use_power(use_power ? POWER_USE_OFF : POWER_USE_ACTIVE)
update_icon()
. = TRUE
if("temp")
var/amount = text2num(params["temp"])
set_temperature = between(0, amount, 1000)
. = TRUE
if("setPower") //setting power to 0 is redundant anyways
var/new_setting = between(0, text2num(params["setPower"]), 100)
set_power_level(new_setting)
. = TRUE
add_fingerprint(usr)
//upgrading parts
/obj/machinery/atmospherics/unary/heater/RefreshParts()
..()
var/cap_rating = 0
var/bin_rating = 0
for(var/obj/item/stock_parts/P in component_parts)
if(iscapacitor(P))
cap_rating += P.rating
else if(ismatterbin(P))
bin_rating += P.rating
max_power_rating = initial(max_power_rating) * cap_rating / 2
max_temperature = max(initial(max_temperature) - T20C, 0) * ((bin_rating * 4 + cap_rating) / 5) + T20C
air_contents.volume = max(initial(internal_volume) - 200, 0) + 200 * bin_rating
set_power_level(power_setting)
/obj/machinery/atmospherics/unary/heater/proc/set_power_level(var/new_power_setting)
power_setting = new_power_setting
power_rating = max_power_rating * (power_setting/100)
/obj/machinery/atmospherics/unary/heater/attackby(obj/item/attacking_item, mob/user)
if(default_deconstruction_screwdriver(user, attacking_item))
return TRUE
if(default_deconstruction_crowbar(user, attacking_item))
return TRUE
if(default_part_replacement(user, attacking_item))
return TRUE
return ..()