CatStation/Content.Shared/EntityEffects/Effects/Solution/AdjustReagentEntityEffectSystem.cs
Ewanderer d7f7a91183
Documentation of e api (#44395)
* 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>
2026-07-01 08:38:04 +00:00

55 lines
2 KiB
C#

using Content.Shared.Chemistry.Components;
using Content.Shared.Chemistry.EntitySystems;
using Content.Shared.Chemistry.Reagent;
using Content.Shared.FixedPoint;
using Robust.Shared.Prototypes;
namespace Content.Shared.EntityEffects.Effects.Solution;
/// <summary>
/// Adjust a reagent in this solution by an amount modified by scale.
/// Quantity is modified by scale.
/// </summary>
/// <inheritdoc cref="EntityEffectSystem{T,TEffect}"/>
public sealed partial class AdjustReagentEntityEffectSystem : EntityEffectSystem<SolutionComponent, AdjustReagent>
{
[Dependency] private SharedSolutionContainerSystem _solutionContainer = default!;
protected override void Effect(Entity<SolutionComponent> entity, ref EntityEffectEvent<AdjustReagent> args)
{
var quantity = args.Effect.Amount * args.Scale;
var reagent = args.Effect.Reagent;
if (quantity > 0)
_solutionContainer.TryAddReagent(entity, reagent, quantity);
else
_solutionContainer.RemoveReagent(entity, reagent, -quantity);
}
}
/// <inheritdoc cref="EntityEffect"/>
public sealed partial class AdjustReagent : EntityEffectBase<AdjustReagent>
{
/// <summary>
/// The reagent ID to add or remove.
/// </summary>
[DataField(required: true)]
public ProtoId<ReagentPrototype> Reagent;
/// <summary>
/// The amount by which to adjust the reagent volume.
/// </summary>
[DataField(required: true)]
public FixedPoint2 Amount;
public override string? EntityEffectGuidebookText(IPrototypeManager prototype, IEntitySystemManager entSys)
{
return prototype.Resolve(Reagent, out ReagentPrototype? proto)
? Loc.GetString("entity-effect-guidebook-adjust-reagent-reagent",
("chance", Probability),
("deltasign", MathF.Sign(Amount.Float())),
("reagent", proto.LocalizedName),
("amount", MathF.Abs(Amount.Float())))
: null;
}
}