mirror of
https://github.com/space-syndicate/space-station-14.git
synced 2026-10-09 10:21:18 +03:00
* documentation pass on content.server -> E! * APi pass on content.server for the E folder. * documentation pass on content.shared for e. * Apply suggestions from code review Co-authored-by: SlamBamActionman <83650252+SlamBamActionman@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: SlamBamActionman <83650252+SlamBamActionman@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: SlamBamActionman <83650252+SlamBamActionman@users.noreply.github.com> * fixing documentation according to review part 1. * typo * Very minor fixes * And a short explanation about EUI --------- Co-authored-by: SlamBamActionman <83650252+SlamBamActionman@users.noreply.github.com> Co-authored-by: SlamBamActionman <slambamactionman@gmail.com>
349 lines
13 KiB
C#
349 lines
13 KiB
C#
using System.Linq;
|
|
using Content.Shared.Alert;
|
|
using Content.Shared.Damage.Components;
|
|
using Content.Shared.Damage.Systems;
|
|
using Content.Shared.DoAfter;
|
|
using Content.Shared.Ensnaring.Components;
|
|
using Content.Shared.Hands.EntitySystems;
|
|
using Content.Shared.IdentityManagement;
|
|
using Content.Shared.Movement.Systems;
|
|
using Content.Shared.Popups;
|
|
using Content.Shared.StepTrigger.Systems;
|
|
using Content.Shared.Strip.Components;
|
|
using Content.Shared.Throwing;
|
|
using Robust.Shared.Audio.Systems;
|
|
using Robust.Shared.Containers;
|
|
using Robust.Shared.Serialization;
|
|
|
|
namespace Content.Shared.Ensnaring;
|
|
|
|
[Serializable, NetSerializable]
|
|
public sealed partial class EnsnareableDoAfterEvent : SimpleDoAfterEvent
|
|
{
|
|
}
|
|
|
|
public abstract partial class SharedEnsnareableSystem : EntitySystem
|
|
{
|
|
[Dependency] private AlertsSystem _alerts = default!;
|
|
[Dependency] private MovementSpeedModifierSystem _speedModifier = default!;
|
|
[Dependency] protected SharedAppearanceSystem Appearance = default!;
|
|
[Dependency] private SharedAudioSystem _audio = default!;
|
|
[Dependency] protected SharedContainerSystem Container = default!;
|
|
[Dependency] private SharedDoAfterSystem _doAfter = default!;
|
|
[Dependency] private SharedHandsSystem _hands = default!;
|
|
[Dependency] protected SharedPopupSystem Popup = default!;
|
|
[Dependency] private SharedStaminaSystem _stamina = default!;
|
|
|
|
public override void Initialize()
|
|
{
|
|
base.Initialize();
|
|
|
|
SubscribeLocalEvent<EnsnareableComponent, ComponentInit>(OnEnsnareInit);
|
|
SubscribeLocalEvent<EnsnareableComponent, RefreshMovementSpeedModifiersEvent>(MovementSpeedModify);
|
|
SubscribeLocalEvent<EnsnareableComponent, EnsnareEvent>(OnEnsnare);
|
|
SubscribeLocalEvent<EnsnareableComponent, EnsnareRemoveEvent>(OnEnsnareRemove);
|
|
SubscribeLocalEvent<EnsnareableComponent, EnsnaredChangedEvent>(OnEnsnareChange);
|
|
SubscribeLocalEvent<EnsnareableComponent, AfterAutoHandleStateEvent>(OnHandleState);
|
|
SubscribeLocalEvent<EnsnareableComponent, StrippingEnsnareButtonPressed>(OnStripEnsnareMessage);
|
|
SubscribeLocalEvent<EnsnareableComponent, RemoveEnsnareAlertEvent>(OnRemoveEnsnareAlert);
|
|
SubscribeLocalEvent<EnsnareableComponent, EnsnareableDoAfterEvent>(OnDoAfter);
|
|
|
|
SubscribeLocalEvent<EnsnaringComponent, ComponentRemove>(OnComponentRemove);
|
|
SubscribeLocalEvent<EnsnaringComponent, StepTriggerAttemptEvent>(AttemptStepTrigger);
|
|
SubscribeLocalEvent<EnsnaringComponent, StepTriggeredOffEvent>(OnStepTrigger);
|
|
SubscribeLocalEvent<EnsnaringComponent, ThrowDoHitEvent>(OnThrowHit);
|
|
}
|
|
|
|
protected virtual void OnEnsnareInit(Entity<EnsnareableComponent> ent, ref ComponentInit args)
|
|
{
|
|
ent.Comp.Container = Container.EnsureContainer<Container>(ent.Owner, "ensnare");
|
|
}
|
|
|
|
private void OnHandleState(EntityUid uid, EnsnareableComponent component, ref AfterAutoHandleStateEvent args)
|
|
{
|
|
RaiseLocalEvent(uid, new EnsnaredChangedEvent(IsEnsnared(uid)));
|
|
}
|
|
|
|
private void OnDoAfter(EntityUid uid, EnsnareableComponent component, DoAfterEvent args)
|
|
{
|
|
if (args.Args.Target == null)
|
|
return;
|
|
|
|
if (args.Handled || !TryComp<EnsnaringComponent>(args.Args.Used, out var ensnaring))
|
|
return;
|
|
|
|
if (args.Cancelled || component.Container == null || !Container.Remove(args.Args.Used.Value, component.Container))
|
|
{
|
|
if (args.User == args.Target)
|
|
Popup.PopupPredicted(Loc.GetString("ensnare-component-try-free-fail", ("ensnare", args.Args.Used)), uid, args.User, PopupType.MediumCaution);
|
|
else if (args.Target != null)
|
|
Popup.PopupPredicted(Loc.GetString("ensnare-component-try-free-fail-other", ("ensnare", args.Args.Used), ("user", args.Target)), uid, args.User, PopupType.MediumCaution);
|
|
|
|
return;
|
|
}
|
|
|
|
_hands.PickupOrDrop(args.Args.User, args.Args.Used.Value);
|
|
|
|
Dirty(uid, component);
|
|
ensnaring.Ensnared = null;
|
|
|
|
if (args.User == args.Target)
|
|
Popup.PopupPredicted(Loc.GetString("ensnare-component-try-free-complete", ("ensnare", args.Args.Used)), uid, args.User, PopupType.Medium);
|
|
else if (args.Target != null)
|
|
Popup.PopupPredicted(Loc.GetString("ensnare-component-try-free-complete-other", ("ensnare", args.Args.Used), ("user", args.Target)), uid, args.User, PopupType.Medium);
|
|
|
|
UpdateAlert(args.Args.Target.Value, component);
|
|
var ev = new EnsnareRemoveEvent(ensnaring.WalkSpeed, ensnaring.SprintSpeed);
|
|
RaiseLocalEvent(uid, ev);
|
|
|
|
args.Handled = true;
|
|
}
|
|
|
|
private void OnEnsnare(EntityUid uid, EnsnareableComponent component, EnsnareEvent args)
|
|
{
|
|
component.WalkSpeed *= args.WalkSpeed;
|
|
component.SprintSpeed *= args.SprintSpeed;
|
|
|
|
_speedModifier.RefreshMovementSpeedModifiers(uid);
|
|
|
|
var ev = new EnsnaredChangedEvent(IsEnsnared(uid));
|
|
RaiseLocalEvent(uid, ev);
|
|
}
|
|
|
|
private void OnEnsnareRemove(EntityUid uid, EnsnareableComponent component, EnsnareRemoveEvent args)
|
|
{
|
|
component.WalkSpeed /= args.WalkSpeed;
|
|
component.SprintSpeed /= args.SprintSpeed;
|
|
|
|
_speedModifier.RefreshMovementSpeedModifiers(uid);
|
|
|
|
var ev = new EnsnaredChangedEvent(IsEnsnared(uid));
|
|
RaiseLocalEvent(uid, ev);
|
|
}
|
|
|
|
private void OnEnsnareChange(EntityUid uid, EnsnareableComponent component, EnsnaredChangedEvent args)
|
|
{
|
|
UpdateAppearance(uid, component);
|
|
}
|
|
|
|
private void UpdateAppearance(EntityUid uid, EnsnareableComponent component, AppearanceComponent? appearance = null)
|
|
{
|
|
Appearance.SetData(uid, EnsnareableVisuals.IsEnsnared, IsEnsnared(uid), appearance);
|
|
}
|
|
|
|
private void MovementSpeedModify(EntityUid uid, EnsnareableComponent component,
|
|
RefreshMovementSpeedModifiersEvent args)
|
|
{
|
|
if (!IsEnsnared(uid))
|
|
return;
|
|
|
|
args.ModifySpeed(component.WalkSpeed, component.SprintSpeed);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Used where you want to try to free an entity with the <see cref="EnsnareableComponent"/>
|
|
/// </summary>
|
|
/// <param name="target">The entity that will be freed</param>
|
|
/// <param name="user">The entity that is freeing the target</param>
|
|
/// <param name="ensnare">The entity used to ensnare</param>
|
|
/// <param name="component">The ensnaring component</param>
|
|
public void TryFree(EntityUid target, EntityUid user, EntityUid ensnare, EnsnaringComponent component)
|
|
{
|
|
// Don't do anything if they don't have the ensnareable component.
|
|
if (!HasComp<EnsnareableComponent>(target))
|
|
return;
|
|
|
|
var freeTime = user == target ? component.BreakoutTime : component.FreeTime;
|
|
var breakOnMove = !component.CanMoveBreakout;
|
|
|
|
var doAfterEventArgs = new DoAfterArgs(EntityManager, user, freeTime, new EnsnareableDoAfterEvent(), target, target: target, used: ensnare)
|
|
{
|
|
BreakOnMove = breakOnMove,
|
|
BreakOnDamage = false,
|
|
NeedHand = true,
|
|
BreakOnDropItem = false,
|
|
};
|
|
|
|
if (!_doAfter.TryStartDoAfter(doAfterEventArgs))
|
|
return;
|
|
|
|
if (user == target)
|
|
Popup.PopupPredicted(Loc.GetString("ensnare-component-try-free", ("ensnare", ensnare)), target, target);
|
|
else
|
|
Popup.PopupPredicted(Loc.GetString("ensnare-component-try-free-other", ("ensnare", ensnare), ("user", Identity.Entity(target, EntityManager))), user, user);
|
|
}
|
|
|
|
private void OnStripEnsnareMessage(EntityUid uid, EnsnareableComponent component, StrippingEnsnareButtonPressed args)
|
|
{
|
|
if (component.Container == null)
|
|
return;
|
|
|
|
foreach (var entity in component.Container.ContainedEntities)
|
|
{
|
|
if (!TryComp<EnsnaringComponent>(entity, out var ensnaring))
|
|
continue;
|
|
|
|
TryFree(uid, args.Actor, entity, ensnaring);
|
|
return;
|
|
}
|
|
}
|
|
|
|
private void OnRemoveEnsnareAlert(Entity<EnsnareableComponent> ent, ref RemoveEnsnareAlertEvent args)
|
|
{
|
|
if (args.Handled || ent.Comp.Container == null)
|
|
return;
|
|
|
|
foreach (var ensnare in ent.Comp.Container.ContainedEntities)
|
|
{
|
|
if (!TryComp<EnsnaringComponent>(ensnare, out var ensnaringComponent))
|
|
continue;
|
|
|
|
TryFree(ent, ent, ensnare, ensnaringComponent);
|
|
|
|
args.Handled = true;
|
|
// Only one snare at a time.
|
|
break;
|
|
}
|
|
}
|
|
|
|
private void OnComponentRemove(EntityUid uid, EnsnaringComponent component, ComponentRemove args)
|
|
{
|
|
if (!TryComp<EnsnareableComponent>(component.Ensnared, out var ensnared))
|
|
return;
|
|
|
|
if (IsEnsnared((component.Ensnared.Value, ensnared)))
|
|
ForceFree((uid, component));
|
|
}
|
|
|
|
private void AttemptStepTrigger(EntityUid uid, EnsnaringComponent component, ref StepTriggerAttemptEvent args)
|
|
{
|
|
args.Continue = true;
|
|
}
|
|
|
|
private void OnStepTrigger(EntityUid uid, EnsnaringComponent component, ref StepTriggeredOffEvent args)
|
|
{
|
|
TryEnsnare(args.Tripper, uid, component);
|
|
}
|
|
|
|
private void OnThrowHit(EntityUid uid, EnsnaringComponent component, ThrowDoHitEvent args)
|
|
{
|
|
if (!component.CanThrowTrigger)
|
|
return;
|
|
|
|
if (TryEnsnare(args.Target, uid, component))
|
|
{
|
|
_audio.PlayPvs(component.EnsnareSound, uid);
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Used where you want to try to ensnare an entity with the <see cref="EnsnareableComponent"/>
|
|
/// </summary>
|
|
/// <param name="target">The entity that will be ensnared</param>
|
|
/// <param name="ensnare"> The entity that is used to ensnare</param>
|
|
/// <param name="component">The ensnaring component</param>
|
|
public bool TryEnsnare(EntityUid target, EntityUid ensnare, EnsnaringComponent component)
|
|
{
|
|
//Don't do anything if they don't have the ensnareable component.
|
|
if (!TryComp<EnsnareableComponent>(target, out var ensnareable) || ensnareable.Container == null)
|
|
return false;
|
|
|
|
var numEnsnares = ensnareable.Container.ContainedEntities.Count;
|
|
|
|
//Don't do anything if the maximum number of ensnares is applied.
|
|
if (numEnsnares >= component.MaxEnsnares)
|
|
return false;
|
|
|
|
Container.Insert(ensnare, ensnareable.Container);
|
|
|
|
// Apply stamina damage to target
|
|
if (TryComp<StaminaComponent>(target, out var stamina))
|
|
{
|
|
_stamina.TakeStaminaDamage(target, component.StaminaDamage, with: ensnare, component: stamina);
|
|
}
|
|
|
|
component.Ensnared = target;
|
|
Dirty(target, ensnareable);
|
|
|
|
UpdateAlert(target, ensnareable);
|
|
var ev = new EnsnareEvent(component.WalkSpeed, component.SprintSpeed);
|
|
RaiseLocalEvent(target, ev);
|
|
return true;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Used to force free someone for things like if the <see cref="EnsnaringComponent"/> is removed
|
|
/// </summary>
|
|
public void ForceFree(Entity<EnsnaringComponent?> entity)
|
|
{
|
|
if (!Resolve(entity, ref entity.Comp, false))
|
|
return;
|
|
|
|
if (!TryComp<EnsnareableComponent>(entity.Comp.Ensnared, out var ensnareable) || ensnareable.Container == null)
|
|
return;
|
|
|
|
var target = entity.Comp.Ensnared.Value;
|
|
|
|
Container.Remove(entity.Owner, ensnareable.Container, force: true);
|
|
|
|
Dirty(entity.Comp.Ensnared.Value, ensnareable);
|
|
entity.Comp.Ensnared = null;
|
|
|
|
UpdateAlert(target, ensnareable);
|
|
var ev = new EnsnareRemoveEvent(entity.Comp.WalkSpeed, entity.Comp.SprintSpeed);
|
|
RaiseLocalEvent(target, ev);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Removes all ensnares from an entity.
|
|
/// </summary>
|
|
/// <param name="entity">The entity to remove snares from.</param>
|
|
/// <returns>The list of removed snares.</returns>
|
|
public List<EntityUid> ForceFreeAll(Entity<EnsnareableComponent?> entity)
|
|
{
|
|
if (!Resolve(entity, ref entity.Comp, false))
|
|
return new List<EntityUid>();
|
|
|
|
if (entity.Comp.Container == null)
|
|
return new List<EntityUid>();
|
|
|
|
List<EntityUid> snares = new();
|
|
|
|
foreach (var snare in entity.Comp.Container.ContainedEntities.ToList())
|
|
{
|
|
ForceFree(snare);
|
|
snares.Add(snare);
|
|
}
|
|
|
|
return snares;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks whether an entity is currently being ensnared.
|
|
/// </summary>
|
|
/// <param name="entity">The entity to check.</param>
|
|
/// <returns>True if ensnared, otherwise False.</returns>
|
|
public bool IsEnsnared(Entity<EnsnareableComponent?> entity)
|
|
{
|
|
if (!Resolve(entity, ref entity.Comp, false))
|
|
return false;
|
|
|
|
if (entity.Comp.Container == null)
|
|
return false;
|
|
|
|
return entity.Comp.Container.ContainedEntities.Count > 0;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Update the Ensnared alert for an entity.
|
|
/// </summary>
|
|
/// <param name="target">The entity that has been affected by a snare</param>
|
|
/// <param name="component">Entity's EnsnareableComponent.</param>
|
|
public void UpdateAlert(EntityUid target, EnsnareableComponent component)
|
|
{
|
|
if (!IsEnsnared(target))
|
|
_alerts.ClearAlert(target, component.EnsnaredAlert);
|
|
else
|
|
_alerts.ShowAlert(target, component.EnsnaredAlert);
|
|
}
|
|
}
|