using System.Linq; using Content.Shared.Administration.Logs; using Content.Shared.Chemistry.Components; using Content.Shared.Chemistry.Reagent; using Content.Shared.Database; using Content.Shared.FixedPoint; using Robust.Shared.Prototypes; namespace Content.Shared.Chemistry.Reaction { public sealed class ChemicalReactionSystem : EntitySystem { /// /// The maximum number of reactions that may occur when a solution is changed. /// private const int MaxReactionIterations = 20; [Dependency] private readonly IPrototypeManager _prototypeManager = default!; [Dependency] private readonly SharedAudioSystem _audio = default!; [Dependency] private readonly ISharedAdminLogManager _adminLogger = default!; /// /// A cache of all existant chemical reactions indexed by one of their /// required reactants. /// private IDictionary> _reactions = default!; public override void Initialize() { base.Initialize(); InitializeReactionCache(); _prototypeManager.PrototypesReloaded += OnPrototypesReloaded; } public override void Shutdown() { base.Shutdown(); _prototypeManager.PrototypesReloaded -= OnPrototypesReloaded; } /// /// Handles building the reaction cache. /// private void InitializeReactionCache() { _reactions = new Dictionary>(); var reactions = _prototypeManager.EnumeratePrototypes(); foreach(var reaction in reactions) { CacheReaction(reaction); } } /// /// Caches a reaction by its first required reagent. /// Used to build the reaction cache. /// /// A reaction prototype to cache. private void CacheReaction(ReactionPrototype reaction) { var reagents = reaction.Reactants.Keys; foreach(var reagent in reagents) { if(!_reactions.TryGetValue(reagent, out var cache)) { cache = new List(); _reactions.Add(reagent, cache); } cache.Add(reaction); return; // Only need to cache based on the first reagent. } } /// /// Updates the reaction cache when the prototypes are reloaded. /// /// The set of modified prototypes. private void OnPrototypesReloaded(PrototypesReloadedEventArgs eventArgs) { if (!eventArgs.ByType.TryGetValue(typeof(ReactionPrototype), out var set)) return; foreach (var (reactant, cache) in _reactions) { cache.RemoveAll((reaction) => set.Modified.ContainsKey(reaction.ID)); if (cache.Count == 0) _reactions.Remove(reactant); } foreach (var prototype in set.Modified.Values) { CacheReaction((ReactionPrototype) prototype); } } /// /// Checks if a solution can undergo a specified reaction. /// /// The solution to check. /// The reaction to check. /// How many times this reaction can occur. /// private bool CanReact(Solution solution, ReactionPrototype reaction, EntityUid owner, ReactionMixerComponent? mixerComponent, out FixedPoint2 lowestUnitReactions) { lowestUnitReactions = FixedPoint2.MaxValue; if (solution.Temperature < reaction.MinimumTemperature) { lowestUnitReactions = FixedPoint2.Zero; return false; } else if(solution.Temperature > reaction.MaximumTemperature) { lowestUnitReactions = FixedPoint2.Zero; return false; } if((mixerComponent == null && reaction.MixingCategories != null) || mixerComponent != null && reaction.MixingCategories != null && reaction.MixingCategories.Except(mixerComponent.ReactionTypes).Any()) { lowestUnitReactions = FixedPoint2.Zero; return false; } var attempt = new ReactionAttemptEvent(reaction, solution); RaiseLocalEvent(owner, attempt, false); if (attempt.Cancelled) { lowestUnitReactions = FixedPoint2.Zero; return false; } foreach (var reactantData in reaction.Reactants) { var reactantName = reactantData.Key; var reactantCoefficient = reactantData.Value.Amount; if (!solution.TryGetReagent(reactantName, out var reactantQuantity)) return false; if (reactantData.Value.Catalyst) { // catalyst is not consumed, so will not limit the reaction. But it still needs to be present, and // for quantized reactions we need to have a minimum amount if (reactantQuantity == FixedPoint2.Zero || reaction.Quantized && reactantQuantity < reactantCoefficient) return false; continue; } var unitReactions = reactantQuantity / reactantCoefficient; if (unitReactions < lowestUnitReactions) { lowestUnitReactions = unitReactions; } } if (reaction.Quantized) lowestUnitReactions = (int) lowestUnitReactions; return lowestUnitReactions > 0; } /// /// Perform a reaction on a solution. This assumes all reaction criteria are met. /// Removes the reactants from the solution, adds products, and returns a list of products. /// private List PerformReaction(Solution solution, EntityUid owner, ReactionPrototype reaction, FixedPoint2 unitReactions) { var energy = reaction.ConserveEnergy ? solution.GetThermalEnergy(_prototypeManager) : 0; //Remove reactants foreach (var reactant in reaction.Reactants) { if (!reactant.Value.Catalyst) { var amountToRemove = unitReactions * reactant.Value.Amount; solution.RemoveReagent(reactant.Key, amountToRemove); } } //Create products var products = new List(); foreach (var product in reaction.Products) { products.Add(product.Key); solution.AddReagent(product.Key, product.Value * unitReactions); } if (reaction.ConserveEnergy) { var newCap = solution.GetHeatCapacity(_prototypeManager); if (newCap > 0) solution.Temperature = energy / newCap; } OnReaction(solution, reaction, null, owner, unitReactions); return products; } private void OnReaction(Solution solution, ReactionPrototype reaction, ReagentPrototype? reagent, EntityUid owner, FixedPoint2 unitReactions) { var args = new ReagentEffectArgs(owner, null, solution, reagent, unitReactions, EntityManager, null, 1f); var coordinates = Transform(owner).Coordinates; _adminLogger.Add(LogType.ChemicalReaction, reaction.Impact, $"Chemical reaction {reaction.ID:reaction} occurred with strength {unitReactions:strength} on entity {ToPrettyString(owner):metabolizer} at {coordinates}"); foreach (var effect in reaction.Effects) { if (!effect.ShouldApply(args)) continue; if (effect.ShouldLog) { var entity = args.SolutionEntity; _adminLogger.Add(LogType.ReagentEffect, effect.LogImpact, $"Reaction effect {effect.GetType().Name:effect} of reaction ${reaction.ID:reaction} applied on entity {ToPrettyString(entity):entity} at {Transform(entity).Coordinates:coordinates}"); } effect.Effect(args); } _audio.PlayPvs(reaction.Sound, owner); } /// /// Performs all chemical reactions that can be run on a solution. /// Removes the reactants from the solution, then returns a solution with all products. /// WARNING: Does not trigger reactions between solution and new products. /// private bool ProcessReactions(Solution solution, EntityUid owner, FixedPoint2 maxVolume, SortedSet reactions, ReactionMixerComponent? mixerComponent) { HashSet toRemove = new(); List? products = null; // attempt to perform any applicable reaction foreach (var reaction in reactions) { if (!CanReact(solution, reaction, owner, mixerComponent, out var unitReactions)) { toRemove.Add(reaction); continue; } products = PerformReaction(solution, owner, reaction, unitReactions); break; } // did any reaction occur? if (products == null) return false; if (products.Count == 0) return true; // remove excess product // TODO spill excess? var excessVolume = solution.Volume - maxVolume; if (excessVolume > 0) solution.RemoveSolution(excessVolume); // Add any reactions associated with the new products. This may re-add reactions that were already iterated // over previously. The new product may mean the reactions are applicable again and need to be processed. foreach (var product in products) { if (_reactions.TryGetValue(product, out var reactantReactions)) reactions.UnionWith(reactantReactions); } return true; } /// /// Continually react a solution until no more reactions occur. /// public void FullyReactSolution(Solution solution, EntityUid owner) => FullyReactSolution(solution, owner, FixedPoint2.MaxValue, null); /// /// Continually react a solution until no more reactions occur, with a volume constraint. /// If a reaction's products would exceed the max volume, some product is deleted. /// public void FullyReactSolution(Solution solution, EntityUid owner, FixedPoint2 maxVolume, ReactionMixerComponent? mixerComponent) { // construct the initial set of reactions to check. SortedSet reactions = new(); foreach (var reactant in solution.Contents) { if (_reactions.TryGetValue(reactant.ReagentId, out var reactantReactions)) reactions.UnionWith(reactantReactions); } // Repeatedly attempt to perform reactions, ending when there are no more applicable reactions, or when we // exceed the iteration limit. for (var i = 0; i < MaxReactionIterations; i++) { if (!ProcessReactions(solution, owner, maxVolume, reactions, mixerComponent)) return; } Logger.Error($"{nameof(Solution)} {owner} could not finish reacting in under {MaxReactionIterations} loops."); } } /// /// Raised directed at the owner of a solution to determine whether the reaction should be allowed to occur. /// /// /// Some solution containers (e.g., bloodstream, smoke, foam) use this to block certain reactions from occurring. /// public sealed class ReactionAttemptEvent : CancellableEntityEventArgs { public readonly ReactionPrototype Reaction; public readonly Solution Solution; public ReactionAttemptEvent(ReactionPrototype reaction, Solution solution) { Reaction = reaction; Solution = solution; } } }