From d08cd9dbee72c1e78d814232b9d53d5fb54d8cf8 Mon Sep 17 00:00:00 2001
From: John Willard <53777086+JohnFulpWillard@users.noreply.github.com>
Date: Sat, 28 Mar 2026 04:42:49 -0400
Subject: [PATCH] Replaces the Space Suit stat panel entry (#95463)
## About The Pull Request
When you put on a space suit, it gives you stat panel entries for
whether the thermal regulator is on, and the charge in the cell.
This replaces it with the already-existing HUD element, and improves
upon it.
1. Re-uses mod's "very low" icon for the HUD, now "max" charge is
100-60%, "mid" is 60-40%, "low" is 40-20% and under that is "very low"
2. The icon now displays "OFF" when the thermal regulator isn't running
3. You can click on the HUD element to turn the thermal regulator on
4. You can hover over the HUD element to see the exact percentage your
space suit is at
https://github.com/user-attachments/assets/3a6cc33d-25d1-479d-99d5-f8160316c230
Maybe in the future we could remove the action button as well if the HUD
element is preferable, as we already seem to have an excess amount of
action buttons. Alternatively we can remove the HUD element entirely and
move the behaviour to the action button, like what we did with the
internals HUD. I'll leave that up to future discussion though I lean
more on it being a HUD element.
## Why It's Good For The Game
Helps me kill the stat panel as part of
https://hackmd.io/443_dE5lRWeEAp9bjGcKYw?view
Space suits is one of the larger parts of this issue as people are
typically expected to wear a space suit, so I think it's pretty
important we get this one done sooner rather than later. Same as my
other recent PRs, this one is also a complement of
https://github.com/tgstation/tgstation/pull/95383
## Changelog
:cl:
qol: The stat panel entry for space suits has been replaced with the HUD
element. You can now hover over it to see exact cell percentage, and
click it to turn the regulator on, while it'll also display when it's
off.
/:cl:
---------
Co-authored-by: MrMelbert <51863163+MrMelbert@users.noreply.github.com>
---
code/__DEFINES/clothing.dm | 9 +++
code/_onclick/hud/hud.dm | 4 +-
code/_onclick/hud/human.dm | 4 +-
code/_onclick/hud/screen_objects.dm | 57 ++++++++++++++++
.../clothing/spacesuits/_spacesuits.dm | 62 ++++++++----------
code/modules/mob/living/carbon/carbon.dm | 3 -
code/modules/mod/mod_control.dm | 8 +--
code/modules/mod/mod_core.dm | 38 +++++------
icons/hud/screen_gen.dmi | Bin 114129 -> 114408 bytes
9 files changed, 122 insertions(+), 63 deletions(-)
diff --git a/code/__DEFINES/clothing.dm b/code/__DEFINES/clothing.dm
index 805d3eccb38..264f07c92fd 100644
--- a/code/__DEFINES/clothing.dm
+++ b/code/__DEFINES/clothing.dm
@@ -68,3 +68,12 @@
#define GMESSENGER "Grey Messenger Bag"
/// Backpack type: Leather satchel
#define LSATCHEL "Leather Satchel"
+
+//Defines for space suits. The respective define is also an icon.
+#define SPACESUIT_NO_ICON "none"
+#define SPACESUIT_CELL_MISSING "missing"
+#define SPACESUIT_CELL_EMPTY "empty"
+#define SPACESUIT_CELL_HIGH "high"
+#define SPACESUIT_CELL_MID "mid"
+#define SPACESUIT_CELL_LOW "low"
+#define SPACESUIT_CELL_VERY_LOW "very_low"
diff --git a/code/_onclick/hud/hud.dm b/code/_onclick/hud/hud.dm
index 6af2635972b..0f722a1bc11 100644
--- a/code/_onclick/hud/hud.dm
+++ b/code/_onclick/hud/hud.dm
@@ -93,7 +93,7 @@ GLOBAL_LIST_INIT(available_ui_styles, list(
var/atom/movable/screen/healths
var/atom/movable/screen/stamina
var/atom/movable/screen/healthdoll/healthdoll
- var/atom/movable/screen/spacesuit
+ var/atom/movable/screen/spacesuit/spacesuit_hud
var/atom/movable/screen/hunger/hunger
/// Subtypes can override this to force a specific UI style
@@ -245,7 +245,7 @@ GLOBAL_LIST_INIT(available_ui_styles, list(
healths = null
stamina = null
healthdoll = null
- spacesuit = null
+ spacesuit_hud = null
hunger = null
alien_plasma_display = null
alien_queen_finder = null
diff --git a/code/_onclick/hud/human.dm b/code/_onclick/hud/human.dm
index a4a69508a85..4e6ef6f0e2b 100644
--- a/code/_onclick/hud/human.dm
+++ b/code/_onclick/hud/human.dm
@@ -291,8 +291,8 @@
sleep_icon.icon = ui_style
sleep_icon.screen_loc = ui_above_throw
- spacesuit = new /atom/movable/screen/spacesuit(null, src)
- infodisplay += spacesuit
+ spacesuit_hud = new /atom/movable/screen/spacesuit(null, src)
+ infodisplay += spacesuit_hud
healths = new /atom/movable/screen/healths(null, src)
infodisplay += healths
diff --git a/code/_onclick/hud/screen_objects.dm b/code/_onclick/hud/screen_objects.dm
index 250219e8740..2514376f911 100644
--- a/code/_onclick/hud/screen_objects.dm
+++ b/code/_onclick/hud/screen_objects.dm
@@ -407,6 +407,63 @@
name = "Space suit cell status"
icon_state = "spacesuit_0"
screen_loc = ui_spacesuit
+ mouse_over_pointer = MOUSE_HAND_POINTER
+ ///The overlay added on top of the HUD when the thermal regulator is off.
+ var/static/mutable_appearance/off_overlay = mutable_appearance('icons/hud/screen_gen.dmi', "off")
+ ///Boolean on whether a mouse is being hovered over us right now.
+ var/hovering = FALSE
+ ///Boolean on whether or not the space suit's thermal mode is on. Start at TRUE so we auto-update when we are first equipped.
+ var/cached_thermal_on = TRUE
+
+/atom/movable/screen/spacesuit/Click(location, control, params)
+ if(usr != get_mob())
+ return
+ . = ..()
+ var/mob/living/carbon/human/wearer = hud?.mymob
+ astype(wearer.wear_suit, /obj/item/clothing/suit/space)?.toggle_spacesuit(wearer, manual_toggle = TRUE)
+
+/atom/movable/screen/spacesuit/MouseEntered(location,control,params)
+ if(usr != get_mob())
+ return
+ . = ..()
+ hovering = TRUE
+ var/mob/living/carbon/human/wearer = hud?.mymob
+ astype(wearer.wear_suit, /obj/item/clothing/suit/space)?.update_hud_icon(usr)
+
+/atom/movable/screen/spacesuit/MouseExited(location, control, params)
+ if(usr != get_mob())
+ return
+ . = ..()
+ hovering = FALSE
+ var/mob/living/carbon/human/wearer = hud?.mymob
+ astype(wearer.wear_suit, /obj/item/clothing/suit/space)?.update_hud_icon(usr)
+
+/atom/movable/screen/spacesuit/proc/update_spacesuit_hud_icon(cell_state, cell_percent, thermal_on = TRUE)
+ if(cell_state)
+ switch(cell_state)
+ if(SPACESUIT_NO_ICON)
+ icon_state = null
+ maptext = null
+ cached_thermal_on = TRUE //for next use
+ update_appearance(UPDATE_ICON)
+ return
+ if(SPACESUIT_CELL_MISSING, SPACESUIT_CELL_EMPTY)
+ icon_state = "spacesuit_[cell_state]"
+ maptext = null
+ else
+ icon_state = "spacesuit_[cell_state]"
+ if(cell_percent && hovering)
+ maptext = MAPTEXT("[round(cell_percent, 0.1)]%
")
+ else
+ maptext = null
+ if(thermal_on != cached_thermal_on)
+ cached_thermal_on = thermal_on
+ update_appearance(UPDATE_ICON)
+
+/atom/movable/screen/spacesuit/update_overlays()
+ . = ..()
+ if(!cached_thermal_on && icon_state)
+ . |= off_overlay
/atom/movable/screen/mov_intent
name = "run/walk toggle"
diff --git a/code/modules/clothing/spacesuits/_spacesuits.dm b/code/modules/clothing/spacesuits/_spacesuits.dm
index d269dfae05e..d5283c7c20c 100644
--- a/code/modules/clothing/spacesuits/_spacesuits.dm
+++ b/code/modules/clothing/spacesuits/_spacesuits.dm
@@ -116,21 +116,14 @@
if(slot & ITEM_SLOT_OCLOTHING) // Check that the slot is valid
START_PROCESSING(SSobj, src)
update_hud_icon(user) // update the hud
- RegisterSignal(user, COMSIG_MOB_GET_STATUS_TAB_ITEMS, PROC_REF(get_status_tab_item))
// On removal stop processing, save battery
/obj/item/clothing/suit/space/dropped(mob/living/user)
. = ..()
STOP_PROCESSING(SSobj, src)
- UnregisterSignal(user, COMSIG_MOB_GET_STATUS_TAB_ITEMS)
- var/mob/living/carbon/carbon_user = user
- if(istype(carbon_user))
- carbon_user.update_spacesuit_hud_icon("0")
-
-/obj/item/clothing/suit/space/proc/get_status_tab_item(mob/living/source, list/items)
- SIGNAL_HANDLER
- items += "Thermal Regulator: [thermal_on ? "On" : "Off"]"
- items += "Cell Charge: [cell ? "[round(cell.percent(), 0.1)]%" : "No Cell!"]"
+ var/mob/living/carbon/human/human_user = user
+ if(istype(human_user) && human_user.hud_used)
+ human_user.hud_used.spacesuit_hud.update_spacesuit_hud_icon(SPACESUIT_NO_ICON)
// Space Suit temperature regulation and power usage
/obj/item/clothing/suit/space/process(seconds_per_tick)
@@ -165,8 +158,8 @@
if(isatom(cell))
QDEL_NULL(cell)
var/mob/living/carbon/human/human = src.loc
- if(istype(human))
- human.update_spacesuit_hud_icon("0")
+ if(istype(human) && human.hud_used)
+ human.hud_used.spacesuit_hud.update_spacesuit_hud_icon(SPACESUIT_NO_ICON)
STOP_PROCESSING(SSobj, src)
return ..()
@@ -226,6 +219,7 @@
if(user.transferItemToLoc(I, src))
cell = I
to_chat(user, span_notice("You successfully install \the [cell] into [src]."))
+ update_hud_icon(user)
return
/// Open the cell cover when ALT+Click on the suit
@@ -246,12 +240,14 @@
/// Remove the cell from the suit if the cell cover is open
/obj/item/clothing/suit/space/proc/remove_cell(mob/user)
- if(cell_cover_open && cell)
- user.visible_message(span_notice("[user] removes \the [cell] from [src]!"), \
- span_notice("You remove [cell]."))
- cell.add_fingerprint(user)
- user.put_in_hands(cell)
- cell = null
+ if(!cell_cover_open || isnull(cell))
+ return
+ user.visible_message(span_notice("[user] removes \the [cell] from [src]!"), \
+ span_notice("You remove [cell]."))
+ cell.add_fingerprint(user)
+ user.put_in_hands(cell)
+ cell = null
+ update_hud_icon(user)
/// Toggle the space suit's cell cover
/obj/item/clothing/suit/space/proc/toggle_spacesuit_cell(mob/user)
@@ -280,6 +276,8 @@
min_cold_protection_temperature = thermal_on ? SPACE_SUIT_MIN_TEMP_PROTECT : SPACE_SUIT_MIN_TEMP_PROTECT_OFF
update_item_action_buttons()
+ if(isnull(toggler) && ishuman(loc))
+ update_hud_icon(loc)
if(!toggler)
return
@@ -305,31 +303,29 @@
// update the HUD icon
/obj/item/clothing/suit/space/proc/update_hud_icon(mob/user)
var/mob/living/carbon/human/human = user
-
- if(!show_hud)
+ if(!show_hud || human.wear_suit != src || isnull(human.hud_used))
return
if(!cell)
- human.update_spacesuit_hud_icon("missing")
+ human.hud_used.spacesuit_hud.update_spacesuit_hud_icon(SPACESUIT_CELL_MISSING, 0, thermal_on)
return
var/cell_percent = cell.percent()
-
// Check if there's enough charge to trigger a thermal regulator tick and
// if there is, whethere the cell's capacity indicates high, medium or low
// charge based on it.
- if(cell.charge >= THERMAL_REGULATOR_COST)
- if(cell_percent > 60)
- human.update_spacesuit_hud_icon("high")
- return
- if(cell_percent > 20)
- human.update_spacesuit_hud_icon("mid")
- return
- human.update_spacesuit_hud_icon("low")
+ if(cell.charge < THERMAL_REGULATOR_COST)
+ human.hud_used.spacesuit_hud.update_spacesuit_hud_icon(SPACESUIT_CELL_EMPTY, cell_percent, thermal_on)
return
-
- human.update_spacesuit_hud_icon("empty")
- return
+ switch(cell_percent)
+ if(0 to 20)
+ human.hud_used.spacesuit_hud.update_spacesuit_hud_icon(SPACESUIT_CELL_VERY_LOW, cell_percent, thermal_on)
+ if(21 to 40)
+ human.hud_used.spacesuit_hud.update_spacesuit_hud_icon(SPACESUIT_CELL_LOW, cell_percent, thermal_on)
+ if(41 to 60)
+ human.hud_used.spacesuit_hud.update_spacesuit_hud_icon(SPACESUIT_CELL_MID, cell_percent, thermal_on)
+ if(61 to 100)
+ human.hud_used.spacesuit_hud.update_spacesuit_hud_icon(SPACESUIT_CELL_HIGH, cell_percent, thermal_on)
// zap the cell if we get hit with an emp
/obj/item/clothing/suit/space/emp_act(severity)
diff --git a/code/modules/mob/living/carbon/carbon.dm b/code/modules/mob/living/carbon/carbon.dm
index bc884201e83..db83e9222a9 100644
--- a/code/modules/mob/living/carbon/carbon.dm
+++ b/code/modules/mob/living/carbon/carbon.dm
@@ -669,9 +669,6 @@
else
hud_used.healths.icon_state = "health6"
-/mob/living/carbon/proc/update_spacesuit_hud_icon(cell_state = "empty")
- hud_used?.spacesuit?.icon_state = "spacesuit_[cell_state]"
-
/mob/living/carbon/set_health(new_value)
. = ..()
if(. > hardcrit_threshold)
diff --git a/code/modules/mod/mod_control.dm b/code/modules/mod/mod_control.dm
index e2554be5646..e9e1f1a05fe 100644
--- a/code/modules/mod/mod_control.dm
+++ b/code/modules/mod/mod_control.dm
@@ -524,7 +524,7 @@
module.on_unequip()
UnregisterSignal(wearer, list(COMSIG_ATOM_EXITED, COMSIG_SPECIES_GAIN, COMSIG_MOB_CLICKON))
SEND_SIGNAL(src, COMSIG_MOD_WEARER_UNSET, wearer)
- wearer.update_spacesuit_hud_icon("0")
+ wearer.hud_used?.spacesuit_hud.update_spacesuit_hud_icon()
wearer = null
/obj/item/mod/control/proc/get_sealed_slots(list/parts)
@@ -715,17 +715,17 @@
* Updates the wearer's hud according to the current state of the MODsuit
*/
/obj/item/mod/control/proc/update_charge_alert()
- if(isnull(wearer))
+ if(isnull(wearer) || isnull(wearer.client))
return
var/state_to_use
if(!active)
- state_to_use = "0"
+ state_to_use = SPACESUIT_NO_ICON
else if(isnull(core))
state_to_use = "coreless"
else
state_to_use = core.get_charge_icon_state()
- wearer.update_spacesuit_hud_icon(state_to_use || "0")
+ wearer.hud_used.spacesuit_hud.update_spacesuit_hud_icon(state_to_use || SPACESUIT_NO_ICON)
/obj/item/mod/control/proc/update_speed()
var/total_slowdown = 0
diff --git a/code/modules/mod/mod_core.dm b/code/modules/mod/mod_core.dm
index 6a36fae818f..70c4fb90d95 100644
--- a/code/modules/mod/mod_core.dm
+++ b/code/modules/mod/mod_core.dm
@@ -52,7 +52,7 @@
/// Returns what icon state to display on the HUD for the charge level of this core
/obj/item/mod/core/proc/get_charge_icon_state()
- return "0"
+ return SPACESUIT_NO_ICON
/// Gets what the UI should use for the charge bar color.
/obj/item/mod/core/proc/get_chargebar_color()
@@ -90,7 +90,7 @@
return TRUE
/obj/item/mod/core/infinite/get_charge_icon_state()
- return "high"
+ return SPACESUIT_CELL_HIGH
/obj/item/mod/core/infinite/get_chargebar_color()
return "teal"
@@ -171,19 +171,19 @@
/obj/item/mod/core/standard/get_charge_icon_state()
if(isnull(charge_source()))
- return "missing"
+ return SPACESUIT_CELL_MISSING
switch(round(charge_amount() / max_charge_amount(), 0.01))
if(0.75 to INFINITY)
- return "high"
+ return SPACESUIT_CELL_HIGH
if(0.5 to 0.75)
- return "mid"
+ return SPACESUIT_CELL_MID
if(0.25 to 0.5)
- return "low"
+ return SPACESUIT_CELL_LOW
if(0.02 to 0.25)
- return "very_low"
+ return SPACESUIT_CELL_VERY_LOW
- return "empty"
+ return SPACESUIT_CELL_EMPTY
/obj/item/mod/core/standard/get_chargebar_color()
if(isnull(charge_source()))
@@ -335,7 +335,7 @@
return charge_amount() >= amount * charge_modifier
/obj/item/mod/core/ethereal/get_charge_icon_state()
- return isnull(charge_source()) ? "missing" : "0"
+ return isnull(charge_source()) ? SPACESUIT_CELL_MISSING : SPACESUIT_NO_ICON
/obj/item/mod/core/ethereal/get_chargebar_color()
if(isnull(charge_source()))
@@ -405,15 +405,15 @@
/obj/item/mod/core/plasma/get_charge_icon_state()
switch(round(charge_amount() / max_charge_amount(), 0.01))
if(0.75 to INFINITY)
- return "high"
+ return SPACESUIT_CELL_HIGH
if(0.5 to 0.75)
- return "mid"
+ return SPACESUIT_CELL_MID
if(0.25 to 0.5)
- return "low"
+ return SPACESUIT_CELL_LOW
if(0.02 to 0.25)
- return "very_low"
+ return SPACESUIT_CELL_VERY_LOW
- return "empty"
+ return SPACESUIT_CELL_EMPTY
/obj/item/mod/core/plasma/get_chargebar_color()
switch(round(charge_amount() / max_charge_amount(), 0.01))
@@ -648,15 +648,15 @@
/obj/item/mod/core/soul/get_charge_icon_state()
switch(round(charge_amount() / max_charge_amount(), 0.01))
if(0.75 to INFINITY)
- return "high"
+ return SPACESUIT_CELL_HIGH
if(0.5 to 0.75)
- return "mid"
+ return SPACESUIT_CELL_MID
if(0.25 to 0.5)
- return "low"
+ return SPACESUIT_CELL_LOW
if(0.02 to 0.25)
- return "very_low"
+ return SPACESUIT_CELL_VERY_LOW
- return "empty"
+ return SPACESUIT_CELL_EMPTY
/obj/item/mod/core/soul/vv_edit_var(vname, vval)
. = ..()
diff --git a/icons/hud/screen_gen.dmi b/icons/hud/screen_gen.dmi
index e4f4bb4eda7f6ec6c92b1d49f476f9d8d0e15700..a86278be2af118945c796b4426ec7e3638471756 100644
GIT binary patch
delta 48593
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