Adds the antimatter engine (#1905)

* adds antimatter engine

* fixes some nullables

* fixes ALL OF THE NULLABLES

* adds explosions

* adds fancy lighting

* requested changes + license info

Co-authored-by: ancientpower <ancientpowerer@gmail.com>

Content.Server/GameObjects/Components/NodeContainer/NodeGroups/AMENodeGroup.cs

@@ -0,0 +1,152 @@
+using Content.Server.Explosions;
+using Content.Server.GameObjects.Components.NodeContainer.Nodes;
+using Content.Server.GameObjects.Components.Power.AME;
+using Robust.Shared.GameObjects.Components.Transform;
+using Robust.Shared.ViewVariables;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+
+namespace Content.Server.GameObjects.Components.NodeContainer.NodeGroups
+{
+    /// <summary>
+    /// Node group class for handling the Antimatter Engine's console and parts.
+    /// </summary>
+    [NodeGroup(NodeGroupID.AMEngine)]
+    public class AMENodeGroup : BaseNodeGroup
+    {
+        /// <summary>
+        /// The AME controller which is currently in control of this node group.
+        /// This could be tracked a few different ways, but this is most convenient,
+        /// since any part connected to the node group can easily find the master.
+        /// </summary>
+        [ViewVariables]
+        private AMEControllerComponent _masterController;
+
+        public AMEControllerComponent MasterController => _masterController;
+
+        private List<AMEShieldComponent> _cores = new List<AMEShieldComponent>();
+
+        public int CoreCount => _cores.Count;
+
+        protected override void OnAddNode(Node node)
+        {
+            base.OnAddNode(node);
+            if (_masterController == null)
+            {
+                node.Owner.TryGetComponent<AMEControllerComponent>(out var controller);
+                _masterController = controller;
+            }
+        }
+
+        protected override void OnRemoveNode(Node node)
+        {
+            base.OnRemoveNode(node);
+            RefreshAMENodes(_masterController);
+            if (_masterController != null && _masterController?.Owner == node.Owner) { _masterController = null; }
+        }
+
+        public void RefreshAMENodes(AMEControllerComponent controller)
+        {
+            if(_masterController == null && controller != null)
+            {
+                _masterController = controller;
+            }
+
+            if (_cores != null) {
+                foreach (AMEShieldComponent core in _cores)
+                {
+                    core.UnsetCore();
+                }
+                _cores.Clear();
+            }
+
+            //Check each shield node to see if it meets core criteria
+            foreach (Node node in Nodes)
+            {
+                if (!node.Owner.TryGetComponent<AMEShieldComponent>(out var shield)) { continue; }
+                var nodeNeighbors = node.Owner
+                    .GetComponent<SnapGridComponent>()
+                    .GetCellsInSquareArea()
+                    .Select(sgc => sgc.Owner)
+                    .Where(entity => entity != node.Owner)
+                    .Select(entity => entity.TryGetComponent<AMEShieldComponent>(out var adjshield) ? adjshield : null)
+                    .Where(adjshield => adjshield != null);
+
+                if (nodeNeighbors.Count() >= 8) { _cores.Add(shield); }
+            }
+
+            if (_cores == null) { return; }
+
+            foreach (AMEShieldComponent core in _cores)
+            {
+                core.SetCore();
+            }
+        }
+
+        public void UpdateCoreVisuals(int injectionAmount, bool injecting)
+        {
+
+            var injectionStrength = CoreCount > 0 ? injectionAmount / CoreCount : 0;
+
+            foreach (AMEShieldComponent core in _cores)
+            {
+                core.UpdateCoreVisuals(injectionStrength, injecting);
+            }
+        }
+
+        public int InjectFuel(int injectionAmount)
+        {
+            if(injectionAmount > 0 && CoreCount > 0)
+            {
+                var instability = 2 * (injectionAmount / CoreCount);
+                foreach(AMEShieldComponent core in _cores)
+                {
+                    core.CoreIntegrity -= instability;
+                }
+                return CoreCount * injectionAmount * 15000; //2 core engine injecting 2 fuel per core = 60kW(?)
+            }
+            return 0;
+        }
+
+        public int GetTotalStability()
+        {
+            if(CoreCount < 1) { return 100; }
+            var stability = 0;
+
+            foreach(AMEShieldComponent core in _cores)
+            {
+                stability += core.CoreIntegrity;
+            }
+
+            stability = stability / CoreCount;
+
+            return stability;
+        }
+
+        public void ExplodeCores()
+        {
+            if(_cores.Count < 1 || MasterController == null) { return; }
+
+            var intensity = 0;
+
+            /*
+             * todo: add an exact to the shielding and make this find the core closest to the controller
+             * so they chain explode, after helpers have been added to make it not cancer
+            */
+            var epicenter = _cores.First();
+
+            foreach (AMEShieldComponent core in _cores)
+            {
+                intensity += MasterController.InjectionAmount;
+            }
+
+            intensity = Math.Min(intensity, 8);
+
+            ExplosionHelper.SpawnExplosion(epicenter.Owner.Transform.GridPosition, intensity / 2, intensity, intensity * 2, intensity * 3);
+
+        }
+
+    }
+}

Content.Server/GameObjects/Components/NodeContainer/NodeGroups/NodeGroupFactory.cs

@@ -62,6 +62,7 @@ namespace Content.Server.GameObjects.Components.NodeContainer.NodeGroups
         HVPower,
         MVPower,
         Apc,
+        AMEngine,
         Pipe,
     }
 }

Content.Server/GameObjects/Components/Power/AME/AMEControllerComponent.cs

@@ -0,0 +1,369 @@
+#nullable enable
+using Content.Server.GameObjects.Components.GUI;
+using Content.Server.GameObjects.Components.Items.Storage;
+using Content.Server.GameObjects.Components.NodeContainer;
+using Content.Server.GameObjects.Components.NodeContainer.NodeGroups;
+using Content.Server.GameObjects.Components.NodeContainer.Nodes;
+using Content.Server.GameObjects.Components.Power.ApcNetComponents;
+using Content.Server.GameObjects.Components.Power.PowerNetComponents;
+using Content.Server.Interfaces;
+using Content.Server.Interfaces.GameObjects.Components.Items;
+using Content.Server.Utility;
+using Content.Shared.GameObjects.Components.Power.AME;
+using Content.Shared.GameObjects.EntitySystems;
+using Content.Shared.Interfaces.GameObjects.Components;
+using Microsoft.EntityFrameworkCore.Internal;
+using Robust.Server.GameObjects;
+using Robust.Server.GameObjects.Components.Container;
+using Robust.Server.GameObjects.Components.UserInterface;
+using Robust.Server.GameObjects.EntitySystems;
+using Robust.Server.Interfaces.GameObjects;
+using Robust.Shared.Audio;
+using Robust.Shared.GameObjects;
+using Robust.Shared.GameObjects.Components.Transform;
+using Robust.Shared.GameObjects.Systems;
+using Robust.Shared.Interfaces.GameObjects;
+using Robust.Shared.Interfaces.GameObjects.Components;
+using Robust.Shared.IoC;
+using Robust.Shared.Localization;
+using Robust.Shared.ViewVariables;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Content.Server.GameObjects.Components.Power.AME
+{
+    [RegisterComponent]
+    [ComponentReference(typeof(IActivate))]
+    [ComponentReference(typeof(IInteractUsing))]
+    public class AMEControllerComponent : SharedAMEControllerComponent, IActivate, IInteractUsing
+    {
+        [Dependency] private readonly IServerNotifyManager _notifyManager = default!;
+
+        [ViewVariables] private BoundUserInterface? UserInterface => Owner.GetUIOrNull(AMEControllerUiKey.Key);
+        [ViewVariables] private bool _injecting;
+        [ViewVariables] public int InjectionAmount;
+
+        private AppearanceComponent? _appearance;
+        private PowerSupplierComponent? _powerSupplier;
+
+        private bool Powered => !Owner.TryGetComponent(out PowerReceiverComponent? receiver) || receiver.Powered;
+
+        [ViewVariables]
+        private int _stability = 100;
+
+        private ContainerSlot _jarSlot = default!;
+        [ViewVariables] private bool HasJar => _jarSlot.ContainedEntity != null;
+
+        public override void Initialize()
+        {
+            base.Initialize();
+
+            if (UserInterface != null)
+            {
+                UserInterface.OnReceiveMessage += OnUiReceiveMessage;
+            }
+
+            Owner.TryGetComponent(out _appearance);
+
+            if (Owner.TryGetComponent(out PowerReceiverComponent? receiver))
+            {
+                receiver.OnPowerStateChanged += OnPowerChanged;
+            }
+
+            Owner.TryGetComponent(out _powerSupplier);
+
+            _injecting = false;
+            InjectionAmount = 2;
+            _jarSlot = ContainerManagerComponent.Ensure<ContainerSlot>($"{Name}-fuelJarContainer", Owner);
+        }
+
+        internal void OnUpdate(float frameTime)
+        {
+            if(!_injecting)
+            {
+                return;
+            }
+
+            _jarSlot.ContainedEntity.TryGetComponent<AMEFuelContainerComponent>(out var fuelJar);
+            if(fuelJar != null && _powerSupplier != null && fuelJar.FuelAmount > InjectionAmount)
+            {
+                _powerSupplier.SupplyRate = GetAMENodeGroup().InjectFuel(InjectionAmount);
+                fuelJar.FuelAmount -= InjectionAmount;
+                InjectSound();
+                UpdateUserInterface();
+            }
+
+            _stability = GetAMENodeGroup().GetTotalStability();
+
+            UpdateDisplay(_stability);
+
+            if(_stability <= 0) { GetAMENodeGroup().ExplodeCores(); }
+
+        }
+
+        /// <summary>
+        /// Called when you click the owner entity with an empty hand. Opens the UI client-side if possible.
+        /// </summary>
+        /// <param name="args">Data relevant to the event such as the actor which triggered it.</param>
+        void IActivate.Activate(ActivateEventArgs args)
+        {
+            if (!args.User.TryGetComponent(out IActorComponent? actor))
+            {
+                return;
+            }
+
+            if (!args.User.TryGetComponent(out IHandsComponent? hands))
+            {
+                _notifyManager.PopupMessage(Owner.Transform.GridPosition, args.User,
+                    Loc.GetString("You have no hands."));
+                return;
+            }
+
+            var activeHandEntity = hands.GetActiveHand?.Owner;
+            if (activeHandEntity == null)
+            {
+                UserInterface?.Open(actor.playerSession);
+            }
+        }
+
+        private void OnPowerChanged(object? sender, PowerStateEventArgs e)
+        {
+            UpdateUserInterface();
+        }
+
+        private AMEControllerBoundUserInterfaceState GetUserInterfaceState()
+        {
+            var jar = _jarSlot.ContainedEntity;
+            if (jar == null)
+            {
+                return new AMEControllerBoundUserInterfaceState(Powered, IsMasterController(), false, HasJar, 0, InjectionAmount, GetCoreCount());
+            }
+
+            var jarcomponent = jar.GetComponent<AMEFuelContainerComponent>();
+            return new AMEControllerBoundUserInterfaceState(Powered, IsMasterController(), _injecting, HasJar, jarcomponent.FuelAmount, InjectionAmount, GetCoreCount());
+        }
+
+        /// <summary>
+        /// Checks whether the player entity is able to use the controller.
+        /// </summary>
+        /// <param name="playerEntity">The player entity.</param>
+        /// <returns>Returns true if the entity can use the controller, and false if it cannot.</returns>
+        private bool PlayerCanUseController(IEntity playerEntity, bool needsPower = true)
+        {
+            //Need player entity to check if they are still able to use the dispenser
+            if (playerEntity == null)
+                return false;
+            //Check if player can interact in their current state
+            if (!ActionBlockerSystem.CanInteract(playerEntity) || !ActionBlockerSystem.CanUse(playerEntity))
+                return false;
+            //Check if device is powered
+            if (needsPower && !Powered)
+                return false;
+
+            return true;
+        }
+
+        private void UpdateUserInterface()
+        {
+            var state = GetUserInterfaceState();
+            UserInterface?.SetState(state);
+        }
+
+        /// <summary>
+        /// Handles ui messages from the client. For things such as button presses
+        /// which interact with the world and require server action.
+        /// </summary>
+        /// <param name="obj">A user interface message from the client.</param>
+        private void OnUiReceiveMessage(ServerBoundUserInterfaceMessage obj)
+        {
+            if (obj.Session.AttachedEntity == null)
+            {
+                return;
+            }
+
+            var msg = (UiButtonPressedMessage) obj.Message;
+            var needsPower = msg.Button switch
+            {
+                UiButton.Eject => false,
+                _ => true,
+            };
+
+            if (!PlayerCanUseController(obj.Session.AttachedEntity, needsPower))
+                return;
+
+            switch (msg.Button)
+            {
+                case UiButton.Eject:
+                    TryEject(obj.Session.AttachedEntity);
+                    break;
+                case UiButton.ToggleInjection:
+                    ToggleInjection();
+                    break;
+                case UiButton.IncreaseFuel:
+                    InjectionAmount += 2;
+                    break;
+                case UiButton.DecreaseFuel:
+                    InjectionAmount = InjectionAmount > 0 ? InjectionAmount -= 2 : 0;
+                    break;
+                case UiButton.RefreshParts:
+                    RefreshParts();
+                    break;
+            }
+
+                GetAMENodeGroup().UpdateCoreVisuals(InjectionAmount, _injecting);
+
+            UpdateUserInterface();
+            ClickSound();
+        }
+
+        private void TryEject(IEntity user)
+        {
+            if (!HasJar || _injecting)
+                return;
+
+            var jar = _jarSlot.ContainedEntity;
+            _jarSlot.Remove(_jarSlot.ContainedEntity);
+            UpdateUserInterface();
+
+            if (!user.TryGetComponent<HandsComponent>(out var hands) || !jar.TryGetComponent<ItemComponent>(out var item))
+                return;
+            if (hands.CanPutInHand(item))
+                hands.PutInHand(item);
+        }
+
+        private void ToggleInjection()
+        {
+            if (!_injecting)
+            {
+                _appearance?.SetData(AMEControllerVisuals.DisplayState, "on");
+            }
+            else
+            {
+                _appearance?.SetData(AMEControllerVisuals.DisplayState, "off");
+                if (_powerSupplier != null)
+                {
+                    _powerSupplier.SupplyRate = 0;
+                }
+            }
+            _injecting = !_injecting;
+            UpdateUserInterface();
+        }
+
+
+        private void UpdateDisplay(int stability)
+        {
+            if(_appearance == null) { return; }
+
+            _appearance.TryGetData<string>(AMEControllerVisuals.DisplayState, out var state);
+
+            var newState = "on";
+            if (stability < 50) { newState = "critical"; }
+            if (stability < 10) { newState = "fuck"; }
+
+            if (state != newState)
+            {
+                _appearance?.SetData(AMEControllerVisuals.DisplayState, newState);
+            }
+
+        }
+
+        private void RefreshParts()
+        {
+            GetAMENodeGroup().RefreshAMENodes(this);
+            UpdateUserInterface();
+        }
+
+        private AMENodeGroup GetAMENodeGroup()
+        {
+            Owner.TryGetComponent(out NodeContainerComponent? nodeContainer);
+
+            var engineNodeGroup = nodeContainer?.Nodes
+            .Select(node => node.NodeGroup)
+            .OfType<AMENodeGroup>()
+            .First();
+
+            return engineNodeGroup ?? default!;
+        }
+
+        private bool IsMasterController()
+        {
+            if(GetAMENodeGroup().MasterController == this)
+            {
+                return true;
+            }
+
+            return false;
+        }
+
+        private int GetCoreCount()
+        {
+            var coreCount = 0;
+
+            if(GetAMENodeGroup() != null)
+            {
+                coreCount = GetAMENodeGroup().CoreCount;
+            }
+
+            return coreCount;
+        }
+
+
+        private void ClickSound()
+        {
+
+            EntitySystem.Get<AudioSystem>().PlayFromEntity("/Audio/Machines/machine_switch.ogg", Owner, AudioParams.Default.WithVolume(-2f));
+
+        }
+
+        private void InjectSound()
+        {
+            EntitySystem.Get<AudioSystem>().PlayFromEntity("/Audio/Effects/bang.ogg", Owner, AudioParams.Default.WithVolume(0f));
+        }
+
+        async Task<bool> IInteractUsing.InteractUsing(InteractUsingEventArgs args)
+        {
+            if (!args.User.TryGetComponent(out IHandsComponent? hands))
+            {
+                _notifyManager.PopupMessage(Owner.Transform.GridPosition, args.User,
+                    Loc.GetString("You have no hands."));
+                return true;
+            }
+
+            if (hands.GetActiveHand == null)
+            {
+                _notifyManager.PopupMessage(Owner.Transform.GridPosition, args.User,
+                    Loc.GetString("You have nothing on your hand."));
+                return false;
+            }
+
+            var activeHandEntity = hands.GetActiveHand.Owner;
+            if (activeHandEntity.TryGetComponent<AMEFuelContainerComponent>(out var fuelContainer))
+            {
+                if (HasJar)
+                {
+                    _notifyManager.PopupMessage(Owner.Transform.GridPosition, args.User,
+                        Loc.GetString("The controller already has a jar loaded."));
+                }
+
+                else
+                {
+                    _jarSlot.Insert(activeHandEntity);
+                    _notifyManager.PopupMessage(Owner.Transform.GridPosition, args.User,
+                        Loc.GetString("You insert the jar into the fuel slot."));
+                    UpdateUserInterface();
+                }
+            }
+            else
+            {
+                _notifyManager.PopupMessage(Owner.Transform.GridPosition, args.User,
+                    Loc.GetString("You can't put that in the controller..."));
+            }
+
+            return true;
+        }
+    }
+
+}

Content.Server/GameObjects/Components/Power/AME/AMEFuelContainerComponent.cs

@@ -0,0 +1,45 @@
+using Robust.Shared.GameObjects;
+using Robust.Shared.ViewVariables;
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace Content.Server.GameObjects.Components.Power.AME
+{
+    [RegisterComponent]
+    public class AMEFuelContainerComponent : Component
+    {
+        public override string Name => "AMEFuelContainer";
+
+        private int _fuelAmount;
+        private int _maxFuelAmount;
+
+        /// <summary>
+        ///     The amount of fuel in the jar.
+        /// </summary>
+        [ViewVariables(VVAccess.ReadWrite)]
+        public int FuelAmount
+        {
+            get => _fuelAmount;
+            set => _fuelAmount = value;
+        }
+
+        /// <summary>
+        ///     The maximum fuel capacity of the jar.
+        /// </summary>
+        [ViewVariables(VVAccess.ReadWrite)]
+        public int MaxFuelAmount
+        {
+            get => _maxFuelAmount;
+            set => _maxFuelAmount = value;
+        }
+
+        public override void Initialize()
+        {
+            base.Initialize();
+            _maxFuelAmount = 1000;
+            _fuelAmount = 1000;
+        }
+
+    }
+}

Content.Server/GameObjects/Components/Power/AME/AMEPartComponent.cs

@@ -0,0 +1,51 @@
+using Content.Server.GameObjects.Components.Interactable;
+using Content.Server.Interfaces;
+using Content.Server.Interfaces.GameObjects.Components.Items;
+using Content.Shared.GameObjects.Components.Interactable;
+using Content.Shared.Interfaces.GameObjects.Components;
+using Robust.Server.Interfaces.GameObjects;
+using Robust.Shared.GameObjects;
+using Robust.Shared.GameObjects.Components.Transform;
+using Robust.Shared.Interfaces.Map;
+using Robust.Shared.IoC;
+using Robust.Shared.Localization;
+using System.Threading.Tasks;
+
+namespace Content.Server.GameObjects.Components.Power.AME
+{
+    [RegisterComponent]
+    [ComponentReference(typeof(IInteractUsing))]
+    public class AMEPartComponent : Component, IInteractUsing
+    {
+        [Dependency] private readonly IMapManager _mapManager = default!;
+        [Dependency] private readonly IServerEntityManager _serverEntityManager = default!;
+        [Dependency] private readonly IServerNotifyManager _notifyManager = default!;
+        public override string Name => "AMEPart";
+
+        async Task<bool> IInteractUsing.InteractUsing(InteractUsingEventArgs args)
+        {
+            if (!args.User.TryGetComponent(out IHandsComponent hands))
+            {
+                _notifyManager.PopupMessage(Owner.Transform.GridPosition, args.User,
+                    Loc.GetString("You have no hands."));
+                return true;
+            }
+
+            var activeHandEntity = hands.GetActiveHand.Owner;
+            if (activeHandEntity.TryGetComponent<ToolComponent>(out var multitool) && multitool.Qualities == ToolQuality.Multitool)
+            {
+
+                var mapGrid = _mapManager.GetGrid(args.ClickLocation.GridID);
+                var tile = mapGrid.GetTileRef(args.ClickLocation);
+                var snapPos = mapGrid.SnapGridCellFor(args.ClickLocation, SnapGridOffset.Center);
+
+                var ent = _serverEntityManager.SpawnEntity("AMEShielding", mapGrid.GridTileToLocal(snapPos));
+                ent.Transform.LocalRotation = Owner.Transform.LocalRotation;
+
+                Owner.Delete();
+            }
+
+            return true;
+        }
+    }
+}

Content.Server/GameObjects/Components/Power/AME/AMEShieldComponent.cs

@@ -0,0 +1,73 @@
+#nullable enable
+using Content.Shared.GameObjects.Components.Power.AME;
+using Robust.Server.GameObjects;
+using Robust.Shared.GameObjects;
+using Robust.Shared.ViewVariables;
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace Content.Server.GameObjects.Components.Power.AME
+{
+    [RegisterComponent]
+    public class AMEShieldComponent : SharedAMEShieldComponent
+    {
+
+        private bool _isCore = false;
+
+        [ViewVariables]
+        public int CoreIntegrity = 100;
+
+        private AppearanceComponent? _appearance;
+        private PointLightComponent? _pointLight;
+
+        public override void Initialize()
+        {
+            base.Initialize();
+            Owner.TryGetComponent(out _appearance);
+            Owner.TryGetComponent(out _pointLight);
+        }
+
+        internal void OnUpdate(float frameTime)
+        {
+            throw new NotImplementedException();
+        }
+
+        public void SetCore()
+        {
+            if(_isCore) { return; }
+            _isCore = true;
+            _appearance?.SetData(AMEShieldVisuals.Core, "isCore");
+        }
+
+        public void UnsetCore()
+        {
+            _isCore = false;
+            _appearance?.SetData(AMEShieldVisuals.Core, "isNotCore");
+        }
+
+        public void UpdateCoreVisuals(int injectionStrength, bool injecting)
+        {
+            if (!injecting)
+            {
+                _appearance?.SetData(AMEShieldVisuals.CoreState, "off");
+                if (_pointLight != null) { _pointLight.Enabled = false; }
+                return;
+            }
+
+            if (_pointLight != null)
+            {
+                _pointLight.Radius = Math.Clamp(injectionStrength, 1, 12);
+                _pointLight.Enabled = true;
+            }
+
+            if (injectionStrength > 2)
+            {
+                _appearance?.SetData(AMEShieldVisuals.CoreState, "strong");
+                return;
+            }
+
+            _appearance?.SetData(AMEShieldVisuals.CoreState, "weak");
+        }
+    }
+}