energy_shield

Vars
action_slots	Grant the action button when attached as accessory on jumpsuit
blocks_melee	Whether the shield blocks melee damage
blocks_projectiles	Whether the shield blocks projectile damage
emp_retention	Fraction of shield health retained after an EMP (0 = full wipe, 0.5 = halved)
enabled	Whether the shield is enabled by the user (toggle via action button)
max_armor_class	Maximum armor rating on outer clothing before the shield refuses to activate (default)
max_shield_health	Maximum shield health
pending_absorption	Damage absorbed in the current hit, pending application in on_after_damage
pending_def_zone	Bodypart struck in the pending hit (for visual effects)
persistent_visuals	Whether shield visuals stay on continuously while active (until collapse)
recharge_delay	Delay before recharge begins after being hit
recharge_rate	Health restored per second during recharge
recharge_visual_pending	Whether the recharge visual has been shown for the current recharge cycle
shield_active	Whether the shield is active (has charge and is worn)
shield_color	The color tint of the shield effects
shield_health	Current shield health — starts empty, must charge after equipping
showing_recharge	Whether filters are showing because of active recharging (persistent until full)
visual_cooldown	Controls how long filters linger after a hit
visuals_shown	Whether the outline/pattern filters are currently applied
wearer	Cached reference to the mob wearing this item
Procs
apply_shield_hit	Shared post-hit logic: deducts shield health, triggers cooldowns, visuals, and collapse check.
clear_shield_hud	Clears the shield HUD bar on the wearer.
emp_act	Drains shield health on EMP. Amount retained is controlled by emp_retention.
equipped	Handles activation when attached as an accessory on a jumpsuit. accessory_equipped() calls equipped(), so this single override covers it.
get_shield_status_text	Returns a span-formatted string describing the shield's current status.
get_shield_tint_color	Builds a "#RRGGBBAA" color string with alpha proportional to current shield health.
hide_shield_visuals	Removes the outline glow and texture pattern filters from the wearer.
on_after_damage	Applies shield health deduction and visual/audio feedback after damage is dealt. Consumes the pending absorption computed by on_damage_modifiers.
on_check_block	Fully blocks melee and thrown attacks when the shield can absorb the entire hit. Mirrors on_pre_bullet for projectiles — prevents wounds, embeds, and blood naturally.
on_damage_modifiers	Computes the damage modifier for melee/self-attack shield absorption. Projectiles are fully handled by on_pre_bullet — this skips them. Full melee blocks are handled by on_check_block. This covers partial melee absorption and self-attacks (where check_block is skipped). Must remain pure — side effects are in on_after_damage via COMSIG_MOB_AFTER_APPLY_DAMAGE.
on_pre_bullet	Absorbs projectile damage, secondary damage, and stamina with the shield. Fully blocked projectiles return COMPONENT_BULLET_BLOCKED (prevents wounds/embed/blood). Partially absorbed projectiles have each absorbed damage pool reduced and proceed normally.
on_uniform_examined	Appends shield status when examining the uniform this shield is attached to.
process	Handles passive recharge after the cooldown expires.
round_shield_for_hud	Maps shield percentage to existing health bar icon state names.
shield_collapse	Called when shield health reaches zero. Visual and audio feedback for collapse.
shield_hit_effect	Flashes the wearer with the shield color and spawns a ripple at the struck limb's position.
show_shield_visuals	Applies outline glow and texture pattern filters to the wearer.
spawn_shield_ripple	Spawns the concentric ripple effect at a limb's position. Separate proc because new() can yield.
turn_off	Disables the shield and clears transient combat/recharge state.
ui_action_click	Toggles the shield on/off via the action button.
update_shield_hud	Updates the shield health bar visible to medical HUD users. Reuses existing health bar icon states from hud.dmi, colored blue.
update_shield_visuals	Updates the outline filter alpha to reflect current shield health.
wearer_has_heavy_armor	Returns TRUE if the wearer's outer clothing has LASER, ENERGY, or BULLET armor above class II.

Var Details

↑
action_slots

Grant the action button when attached as accessory on jumpsuit

var
blocks_melee

Whether the shield blocks melee damage

var
blocks_projectiles

Whether the shield blocks projectile damage

var
emp_retention

Fraction of shield health retained after an EMP (0 = full wipe, 0.5 = halved)

var
enabled

Whether the shield is enabled by the user (toggle via action button)

var
max_armor_class

Maximum armor rating on outer clothing before the shield refuses to activate (default)

var
max_shield_health

Maximum shield health

var
pending_absorption

Damage absorbed in the current hit, pending application in on_after_damage

var
pending_def_zone
– /obj/item/bodypart

Bodypart struck in the pending hit (for visual effects)

var
persistent_visuals

Whether shield visuals stay on continuously while active (until collapse)

var
recharge_delay

Delay before recharge begins after being hit

var
recharge_rate

Health restored per second during recharge

var
recharge_visual_pending

Whether the recharge visual has been shown for the current recharge cycle

var
shield_active

Whether the shield is active (has charge and is worn)

var
shield_color

The color tint of the shield effects

var
shield_health

Current shield health — starts empty, must charge after equipping

var
showing_recharge

Whether filters are showing because of active recharging (persistent until full)

var
visual_cooldown

Controls how long filters linger after a hit

var
visuals_shown

Whether the outline/pattern filters are currently applied

var
wearer
– /mob/living/carbon

Cached reference to the mob wearing this item

Proc Details

proc
apply_shield_hit
(absorbed, /obj/item/bodypart/limb)

Shared post-hit logic: deducts shield health, triggers cooldowns, visuals, and collapse check.

proc
clear_shield_hud
()

Clears the shield HUD bar on the wearer.

↑
emp_act
(severity)

Drains shield health on EMP. Amount retained is controlled by emp_retention.

↑
equipped
(/mob/living/user, slot)

Handles activation when attached as an accessory on a jumpsuit. accessory_equipped() calls equipped(), so this single override covers it.

proc
get_shield_status_text
()

Returns a span-formatted string describing the shield's current status.

proc
get_shield_tint_color
()

Builds a "#RRGGBBAA" color string with alpha proportional to current shield health.

proc
hide_shield_visuals
()

Removes the outline glow and texture pattern filters from the wearer.

proc
on_after_damage
(/mob/living/carbon/source, damage_dealt, damagetype, def_zone, blocked, wound_bonus, exposed_wound_bonus, sharpness, attack_direction, attacking_item)

Applies shield health deduction and visual/audio feedback after damage is dealt. Consumes the pending absorption computed by on_damage_modifiers.

proc
on_check_block
(/mob/living/carbon/source, /atom/hit_by, damage, attack_text, attack_type, armour_penetration, damage_type)

Fully blocks melee and thrown attacks when the shield can absorb the entire hit. Mirrors on_pre_bullet for projectiles — prevents wounds, embeds, and blood naturally.

proc
on_damage_modifiers
(/mob/living/carbon/source, /list/damage_mods, damage, damagetype, def_zone, sharpness, attack_direction, attacking_item)

Computes the damage modifier for melee/self-attack shield absorption. Projectiles are fully handled by on_pre_bullet — this skips them. Full melee blocks are handled by on_check_block. This covers partial melee absorption and self-attacks (where check_block is skipped). Must remain pure — side effects are in on_after_damage via COMSIG_MOB_AFTER_APPLY_DAMAGE.

proc
on_pre_bullet
(/mob/living/carbon/source, /obj/projectile/proj, def_zone, piercing_hit)

Absorbs projectile damage, secondary damage, and stamina with the shield. Fully blocked projectiles return COMPONENT_BULLET_BLOCKED (prevents wounds/embed/blood). Partially absorbed projectiles have each absorbed damage pool reduced and proceed normally.

proc
on_uniform_examined
(/obj/item/clothing/under/source, /mob/user, /list/examine_list)

Appends shield status when examining the uniform this shield is attached to.

↑
process
(seconds_per_tick)

Handles passive recharge after the cooldown expires.

proc
round_shield_for_hud
(percent)

Maps shield percentage to existing health bar icon state names.

proc
shield_collapse
()

Called when shield health reaches zero. Visual and audio feedback for collapse.

proc
shield_hit_effect
(/obj/item/bodypart/limb)

Flashes the wearer with the shield color and spawns a ripple at the struck limb's position.

proc
show_shield_visuals
()

Applies outline glow and texture pattern filters to the wearer.

proc
spawn_shield_ripple
(/obj/item/bodypart/limb)

Spawns the concentric ripple effect at a limb's position. Separate proc because new() can yield.

proc
turn_off
(detach_wearer, quiet, force_sound)

Disables the shield and clears transient combat/recharge state.

↑
ui_action_click
(/mob/user, /datum/action/action)

Toggles the shield on/off via the action button.

proc
update_shield_hud
()

Updates the shield health bar visible to medical HUD users. Reuses existing health bar icon states from hud.dmi, colored blue.

proc
update_shield_visuals
()

Updates the outline filter alpha to reflect current shield health.

proc
wearer_has_heavy_armor
()

Returns TRUE if the wearer's outer clothing has LASER, ENERGY, or BULLET armor above class II.

energy_shield /obj/item/clothing/accessory/energy_shield

Vars

Procs

Var Details

↑action_slots

var blocks_melee

var blocks_projectiles

var emp_retention

var enabled

var max_armor_class

var max_shield_health

var pending_absorption

var pending_def_zone – /obj/item/bodypart

var persistent_visuals

var recharge_delay

var recharge_rate

var recharge_visual_pending

var shield_active

var shield_color

var shield_health

var showing_recharge

var visual_cooldown

var visuals_shown

var wearer – /mob/living/carbon

Proc Details

proc apply_shield_hit(absorbed, /obj/item/bodypart/limb)

proc clear_shield_hud()

↑emp_act(severity)

↑equipped(/mob/living/user, slot)

proc get_shield_status_text()

proc get_shield_tint_color()

proc hide_shield_visuals()

proc on_after_damage(/mob/living/carbon/source, damage_dealt, damagetype, def_zone, blocked, wound_bonus, exposed_wound_bonus, sharpness, attack_direction, attacking_item)

proc on_check_block(/mob/living/carbon/source, /atom/hit_by, damage, attack_text, attack_type, armour_penetration, damage_type)

proc on_damage_modifiers(/mob/living/carbon/source, /list/damage_mods, damage, damagetype, def_zone, sharpness, attack_direction, attacking_item)

proc on_pre_bullet(/mob/living/carbon/source, /obj/projectile/proj, def_zone, piercing_hit)

proc on_uniform_examined(/obj/item/clothing/under/source, /mob/user, /list/examine_list)

↑process(seconds_per_tick)

proc round_shield_for_hud(percent)

proc shield_collapse()

proc shield_hit_effect(/obj/item/bodypart/limb)

proc show_shield_visuals()

proc spawn_shield_ripple(/obj/item/bodypart/limb)

proc turn_off(detach_wearer, quiet, force_sound)

↑ui_action_click(/mob/user, /datum/action/action)

proc update_shield_hud()

proc update_shield_visuals()

proc wearer_has_heavy_armor()