mirror of
https://github.com/WWhiteDreamProject/wwdpublic.git
synced 2026-04-17 21:48:58 +03:00
<!-- Please read these guidelines before opening your PR: https://docs.spacestation14.io/en/getting-started/pr-guideline --> <!-- The text between the arrows are comments - they will not be visible on your PR. --> ## About the PR <!-- What did you change in this PR? --> EMP has been changed to target APC-powered-devices (most electrical devices) as well as batteries to disable them. This means EMP can interfere with autolathes, airlocks, atmos devices, substations and SMES. The power draw of a single EMP grenade now cuts out a substation, and the disabling effect prevents further recharge until it subsides. EMP duration now also stacks, which creates a novel way to quietly black out the station by attacking engineering SMES with 3 EMP grenades (6tc EMP bundle) to black out the station for 3 minutes. Edit, here's a detailed changelog of the PR, Functionality: - EMP disable has been generalised to kill and prevent further function of every device/battery by interrupting recharge - As a result of the above, some hard coded interactions have been culled - EMP disable duration now stacks with multiple EMP blasts - EMP is now capable of draining from gravity generators - The Charger system has been slightly reworked to facilitate communication between batteries and chargers Results: - EMP grenade can disable basically every powered machine, most notably doors - EMP grenade has had its power drain upped to 2.7MW, which is slightly more than a substation and 1/3 a SMES - EMP grenade can now instantly kill substations - EMP grenade can now instantly kill gravity generators - 3 EMP grenades (6tc) can be used to kill SMES and disable recharge for 3 minutes with no evidence on the power monitor. ## Why / Balance <!-- Why was it changed? Link any discussions or issues here. Please discuss how this would affect game balance. --> EMP at 2tc has a relatively low value-proposition when compared to C4 which is also 2tc. While EMP can probably black out one (or two if you're lucky) APCs and can be used as a defensive option against Stun/Lasers. C4 can be used to cut wires, substations, SMES, generators, doors, reinforced walls, people and the list probably continues. New EMP can be used to soft-bomb station power in an explosion that isn't globally alarming (salv boom). Targeting the captain's office directly may let you crowbar in and steal the locker but it leaves ephemeral evidence in the form of everything electrical shimmering blue. Opting to bomb substations blacks out a wider area, providing several degrees of separation from your target. That is to say, new EMP grenade favours map knowledge and rewards better stealth. ## Technical details <!-- If this is a code change, summarize at high level how your new code works. This makes it easier to review. --> - `C.S/.../EmpSystem.cs` uses TryComp to turn on/off charging for `C.S/Power/Components/PowerNetworkBatteryComponent` - `C.S/Power/EntitySystems/PowerReceiverSystem.cs` listens to `EmpPulseEvent` to turn off. Requests to turn back on are additionally intercepted by `EmpSystem.cs` and cancelled. - `C.S/.../GravityGeneratorSystem.cs` listens to `EmpPulseEvent` and converts energy consumption to a normalised charge - `C.S/Power/EntitySystems/ApcSystem.cs` no longer toggles its breaker, but still listens to `EmpPulseEvent` for updating visuals. - `C.S/Power/EntitySystems/ChargerSystem.cs` was refactored to add a `ChargingComponent` flag to power cells instead of `ActiveCharger` on itself. Battery and Charger communicate through this flag. Listens to `EmpPulseEvent` for updating its state machine. New `ChargerUpdateStatusEvent` allows batteries to update the charger's status. - `C.S/Power/EntitySystems/BatterySystem.cs` can now be disabled, and checks for disabling before updating its charge. Raises `ChargerUpdateStatusEvent` when hearing `EmpDisabledRemoved` to tell its charger to start charging again. - `C.S/Power/PowerWireAction.cs` checks for `EmpDisabledComponent` before turning power back on. - `C.S/SurveillanceCamera/Systems/SurveillanceCameraSystem.cs` and `C.S/VendingMachines/VendingMachineSystem.cs` had redundant `EmpPulseEvent` listeners culled. - `Resources/Prototypes/Entities/Objects/Weapons/Throwable/grenades.yml` buffed EMP grenade. ## Media <!-- PRs which make ingame changes (adding clothing, items, new features, etc) are required to have media attached that showcase the changes. Small fixes/refactors are exempt. Any media may be used in SS14 progress reports, with clear credit given. If you're unsure whether your PR will require media, ask a maintainer. Check the box below to confirm that you have in fact seen this (put an X in the brackets, like [X]): --> https://www.youtube.com/embed/rSVph6OIg1s?si=8o4bx9Vx16B6usuu - outdated video demonstrating changes on a wizden map https://www.youtube.com/embed/B3iPhLcfs-0?si=trB1HY2ccjMf96Bj - electrical anomaly crit with updated emp - [x] I have added screenshots/videos to this PR showcasing its changes ingame, **or** this PR does not require an ingame showcase **Changelog** <!-- Make players aware of new features and changes that could affect how they play the game by adding a Changelog entry. Please read the Changelog guidelines located at: https://docs.spacestation14.io/en/getting-started/pr-guideline#changelog --> 🆑 - tweak: EMP Grenades can now disable basically any electrical device, and stack in disable duration. --------- Signed-off-by: VMSolidus <evilexecutive@gmail.com> Co-authored-by: VMSolidus <evilexecutive@gmail.com>
202 lines
8.1 KiB
C#
202 lines
8.1 KiB
C#
using Content.Server.Cargo.Systems;
|
|
using Content.Server.Emp;
|
|
using Content.Shared.Emp;
|
|
using Content.Server.Power.Components;
|
|
using Content.Shared.Examine;
|
|
using Content.Shared.Rejuvenate;
|
|
using JetBrains.Annotations;
|
|
using Robust.Shared.Utility;
|
|
|
|
namespace Content.Server.Power.EntitySystems
|
|
{
|
|
[UsedImplicitly]
|
|
public sealed class BatterySystem : EntitySystem
|
|
{
|
|
public override void Initialize()
|
|
{
|
|
base.Initialize();
|
|
|
|
SubscribeLocalEvent<ExaminableBatteryComponent, ExaminedEvent>(OnExamine);
|
|
SubscribeLocalEvent<PowerNetworkBatteryComponent, RejuvenateEvent>(OnNetBatteryRejuvenate);
|
|
SubscribeLocalEvent<BatteryComponent, RejuvenateEvent>(OnBatteryRejuvenate);
|
|
SubscribeLocalEvent<BatteryComponent, PriceCalculationEvent>(CalculateBatteryPrice);
|
|
SubscribeLocalEvent<BatteryComponent, EmpPulseEvent>(OnEmpPulse);
|
|
SubscribeLocalEvent<BatteryComponent, EmpDisabledRemoved>(OnEmpDisabledRemoved);
|
|
|
|
SubscribeLocalEvent<NetworkBatteryPreSync>(PreSync);
|
|
SubscribeLocalEvent<NetworkBatteryPostSync>(PostSync);
|
|
}
|
|
|
|
private void OnNetBatteryRejuvenate(EntityUid uid, PowerNetworkBatteryComponent component, RejuvenateEvent args)
|
|
{
|
|
component.NetworkBattery.CurrentStorage = component.NetworkBattery.Capacity;
|
|
}
|
|
|
|
private void OnBatteryRejuvenate(EntityUid uid, BatteryComponent component, RejuvenateEvent args)
|
|
{
|
|
SetCharge(uid, component.MaxCharge, component);
|
|
}
|
|
|
|
private void OnExamine(EntityUid uid, ExaminableBatteryComponent component, ExaminedEvent args)
|
|
{
|
|
if (!TryComp<BatteryComponent>(uid, out var batteryComponent))
|
|
return;
|
|
if (args.IsInDetailsRange)
|
|
{
|
|
var effectiveMax = batteryComponent.MaxCharge;
|
|
if (effectiveMax == 0)
|
|
effectiveMax = 1;
|
|
var chargeFraction = batteryComponent.CurrentCharge / effectiveMax;
|
|
var chargePercentRounded = (int) (chargeFraction * 100);
|
|
args.PushMarkup(
|
|
Loc.GetString(
|
|
"examinable-battery-component-examine-detail",
|
|
("percent", chargePercentRounded),
|
|
("markupPercentColor", "green")
|
|
)
|
|
);
|
|
}
|
|
}
|
|
|
|
private void PreSync(NetworkBatteryPreSync ev)
|
|
{
|
|
// Ignoring entity pausing. If the entity was paused, neither component's data should have been changed.
|
|
var enumerator = AllEntityQuery<PowerNetworkBatteryComponent, BatteryComponent>();
|
|
while (enumerator.MoveNext(out var netBat, out var bat))
|
|
{
|
|
DebugTools.Assert(bat.CurrentCharge <= bat.MaxCharge && bat.CurrentCharge >= 0);
|
|
netBat.NetworkBattery.Capacity = bat.MaxCharge;
|
|
netBat.NetworkBattery.CurrentStorage = bat.CurrentCharge;
|
|
}
|
|
}
|
|
|
|
private void PostSync(NetworkBatteryPostSync ev)
|
|
{
|
|
// Ignoring entity pausing. If the entity was paused, neither component's data should have been changed.
|
|
var enumerator = AllEntityQuery<PowerNetworkBatteryComponent, BatteryComponent>();
|
|
while (enumerator.MoveNext(out var uid, out var netBat, out var bat))
|
|
{
|
|
SetCharge(uid, netBat.NetworkBattery.CurrentStorage, bat);
|
|
}
|
|
}
|
|
|
|
public override void Update(float frameTime)
|
|
{
|
|
var query = EntityQueryEnumerator<BatterySelfRechargerComponent, BatteryComponent>();
|
|
while (query.MoveNext(out var uid, out var comp, out var batt))
|
|
{
|
|
if (!comp.AutoRecharge) continue;
|
|
if (batt.IsFullyCharged) continue;
|
|
TrySetCharge(uid, batt.CurrentCharge + comp.AutoRechargeRate * frameTime, batt);
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the price for the power contained in an entity's battery.
|
|
/// </summary>
|
|
private void CalculateBatteryPrice(EntityUid uid, BatteryComponent component, ref PriceCalculationEvent args)
|
|
{
|
|
args.Price += component.CurrentCharge * component.PricePerJoule;
|
|
}
|
|
|
|
private void OnEmpPulse(EntityUid uid, BatteryComponent component, ref EmpPulseEvent args)
|
|
{
|
|
args.Affected = true;
|
|
args.Disabled = true;
|
|
UseCharge(uid, args.EnergyConsumption, component);
|
|
}
|
|
|
|
// if a disabled battery is put into a recharged,
|
|
// allow the recharger to start recharging again after the disable ends
|
|
private void OnEmpDisabledRemoved(EntityUid uid, BatteryComponent component, ref EmpDisabledRemoved args)
|
|
{
|
|
if (!TryComp<ChargingComponent>(uid, out var charging))
|
|
return;
|
|
|
|
var ev = new ChargerUpdateStatusEvent();
|
|
RaiseLocalEvent<ChargerUpdateStatusEvent>(charging.ChargerUid, ref ev);
|
|
}
|
|
|
|
public float UseCharge(EntityUid uid, float value, BatteryComponent? battery = null)
|
|
{
|
|
if (value <= 0 || !Resolve(uid, ref battery) || battery.CurrentCharge == 0)
|
|
return 0;
|
|
|
|
var newValue = Math.Clamp(0, battery.CurrentCharge - value, battery.MaxCharge);
|
|
var delta = newValue - battery.CurrentCharge;
|
|
battery.CurrentCharge = newValue;
|
|
var ev = new ChargeChangedEvent(battery.CurrentCharge, battery.MaxCharge);
|
|
RaiseLocalEvent(uid, ref ev);
|
|
return delta;
|
|
}
|
|
|
|
public void SetMaxCharge(EntityUid uid, float value, BatteryComponent? battery = null)
|
|
{
|
|
if (!Resolve(uid, ref battery))
|
|
return;
|
|
|
|
var old = battery.MaxCharge;
|
|
battery.MaxCharge = Math.Max(value, 0);
|
|
battery.CurrentCharge = Math.Min(battery.CurrentCharge, battery.MaxCharge);
|
|
if (MathHelper.CloseTo(battery.MaxCharge, old))
|
|
return;
|
|
|
|
var ev = new ChargeChangedEvent(battery.CurrentCharge, battery.MaxCharge);
|
|
RaiseLocalEvent(uid, ref ev);
|
|
}
|
|
|
|
public void SetCharge(EntityUid uid, float value, BatteryComponent? battery = null)
|
|
{
|
|
if (!Resolve(uid, ref battery))
|
|
return;
|
|
|
|
var old = battery.CurrentCharge;
|
|
battery.CurrentCharge = MathHelper.Clamp(value, 0, battery.MaxCharge);
|
|
if (MathHelper.CloseTo(battery.CurrentCharge, old))
|
|
return;
|
|
|
|
var ev = new ChargeChangedEvent(battery.CurrentCharge, battery.MaxCharge);
|
|
RaiseLocalEvent(uid, ref ev);
|
|
}
|
|
|
|
/// <summary>
|
|
/// If sufficient charge is available on the battery, use it. Otherwise, don't.
|
|
/// </summary>
|
|
public bool TryUseCharge(EntityUid uid, float value, BatteryComponent? battery = null)
|
|
{
|
|
if (!Resolve(uid, ref battery, false) || value > battery.CurrentCharge)
|
|
return false;
|
|
|
|
UseCharge(uid, value, battery);
|
|
return true;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Like SetCharge, but checks for conditions like EmpDisabled before executing
|
|
/// </summary>
|
|
public bool TrySetCharge(EntityUid uid, float value, BatteryComponent? battery = null)
|
|
{
|
|
if (!Resolve(uid, ref battery, false) || TryComp<EmpDisabledComponent>(uid, out var emp))
|
|
return false;
|
|
|
|
SetCharge(uid, value, battery);
|
|
return true;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns whether the battery is at least 99% charged, basically full.
|
|
/// </summary>
|
|
public bool IsFull(EntityUid uid, BatteryComponent? battery = null)
|
|
{
|
|
if (!Resolve(uid, ref battery))
|
|
return false;
|
|
|
|
// If the battery is full, remove its charging component.
|
|
if (TryComp<ChargingComponent>(uid, out _))
|
|
RemComp<ChargingComponent>(uid);
|
|
|
|
return battery.CurrentCharge / battery.MaxCharge >= 0.99f;
|
|
}
|
|
}
|
|
}
|