Delta-v/Content.Server/_DV/Projectiles/Components/PiercingProjectileComponent.cs

54 lines
1.8 KiB
C#

using Content.Shared.Tag;
using Robust.Shared.Prototypes;
namespace Content.Server._DV.Projectiles.Components;
[RegisterComponent]
public sealed partial class PiercingProjectileComponent : Component
{
/// <summary>
/// The health threshold that a target has to supersede to block the projectile.
/// A normal wall has 200.
/// </summary>
[DataField(required: true)]
public float HealthThreshold;
/// <summary>
/// The number of entities it pierced.
/// It'll only count the entities with the <see cref="PierceBlockTag"/>.
/// </summary>
[DataField]
public float PierceCounter;
/// <summary>
/// The tag that will cause the piercing bullet to increment it's <see cref="PierceCounter"/>.
/// </summary>
[DataField]
public List<ProtoId<TagPrototype>> PierceBlockTag = ["Wall", "Window"];
/// <summary>
/// The number of entities it is allowed to pierce before being deleted.
/// When <see cref="PierceCounter"/> is higher than this number, it'll be deleted.
/// </summary>
/// <example>
/// A bullet with a MaxPierceNumberThreshold of 3 will pierce 3 entities with the <see cref="PierceBlockTag"/> and be deleted when hitting the fourth.
/// </example>
[DataField]
public float MaxPierceNumberThreshold = 1f;
/// <summary>
/// The cardinal direction that the bullet is flying toward.
/// </summary>
[DataField]
public Direction? Direction;
/// <summary>
/// The vertical/horizontal coordinate that will be ignored for <see cref="PierceCounter"/>.
/// </summary>
/// <example>
/// A bullet going positive Y hitting a wall at X 3 and Y 5 will not increment the <see cref="PierceCounter"/> when hitting other walls at Y 5.
/// </example>
[DataField]
public float? IgnoreRowCoordinate;
}