ace/Source/ACE.Server/Entity/Actions/ActionChain.cs

using System;

using ACE.Server.Managers;

namespace ACE.Server.Entity.Actions
{
    public class ActionChain
    {
        public class ChainElement
        {
            public IAction Action { get; }
            public IActor Actor { get; }

            public ChainElement(IActor actor, IAction action)
            {
                Actor = actor;
                Action = action;
            }
        }

        public ChainElement FirstElement { get; private set; }
        private ChainElement lastElement;

        public ActionChain()
        {
            FirstElement = null;
            lastElement = null;
        }

        public ActionChain(IActor firstActor, Action firstAction)
        {
            FirstElement = new ChainElement(firstActor, new ActionEventDelegate(firstAction));
            lastElement = FirstElement;
        }

        public ActionChain(IActor firstActor, IAction firstAction)
        {
            FirstElement = new ChainElement(firstActor, firstAction);
            lastElement = FirstElement;
        }

        public ActionChain(ChainElement elm)
        {
            FirstElement = elm;
            lastElement = FirstElement;
        }

        public ActionChain AddAction(IActor actor, Action action)
        {
            ChainElement newElm = new ChainElement(actor, new ActionEventDelegate(action));
            AddAction(newElm);

            return this;
        }

        public ActionChain AddAction(IActor actor, IAction action)
        {
            ChainElement newElm = new ChainElement(actor, action);
            AddAction(newElm);

            return this;
        }

        public ActionChain AddAction(ChainElement elm)
        {
            if (FirstElement == null)
            {
                FirstElement = elm;
                lastElement = elm;
            }
            else
            {
                lastElement.Action.RunOnFinish(elm.Actor, elm.Action);
                lastElement = elm;
            }

            return this;
        }

        public ActionChain AddChain(ActionChain chain)
        {
            if (chain != null && chain.FirstElement != null)
            {
                // If we have a chain of our own
                if (lastElement != null)
                {
                    lastElement.Action.RunOnFinish(chain.FirstElement.Actor, chain.FirstElement.Action);
                    lastElement = chain.lastElement;
                }
                // If we're uninit'd, take their data
                else
                {
                    FirstElement = chain.FirstElement;
                    lastElement = chain.lastElement;
                }
            }

            return this;
        }

        public ActionChain AddBranch(IActor conditionActor, Func<bool> condition, ChainElement trueBranch, ChainElement falseBranch)
        {
            AddBranch(conditionActor, condition, new ActionChain(trueBranch), new ActionChain(falseBranch));

            return this;
        }

        public ActionChain AddBranch(IActor conditionActor, Func<bool> condition, ActionChain trueBranch, ActionChain falseBranch)
        {
            AddAction(new ChainElement(conditionActor, new ConditionalAction(condition, trueBranch, falseBranch)));

            return this;
        }

        public ActionChain AddLoop(IActor conditionActor, Func<bool> condition, ActionChain body)
        {
            AddAction(new ChainElement(conditionActor, new LoopAction(conditionActor, condition, body)));

            return this;
        }

        /// <summary>
        /// If timeInSeconds &lt;= 0, no action will be added. If you must wait for one tick, use AddDelayForOneTick() 
        /// </summary>
        public ActionChain AddDelaySeconds(double timeInSeconds)
        {
            if (Double.IsNaN(timeInSeconds))
            {
                Console.WriteLine("WARNING: ActionChain.AddDelaySeconds(" + timeInSeconds + ")");
                return this;
            }

            if (timeInSeconds <= 0)
                return this;

            AddAction(WorldManager.DelayManager, new DelayAction(timeInSeconds));

            return this;
        }

        public ActionChain AddDelayForOneTick()
        {
            // TODO: This should be expanded to gaurantee that a full world tick actually completes
            // TODO: If this gets called before the WorldObject.Tick->RunActions(), then it can end up executing on the same tick.
            AddAction(WorldManager.DelayManager, new DelayAction(0.001f));

            return this;
        }

        public void EnqueueChain()
        {
            if (FirstElement != null)
                FirstElement.Actor.EnqueueAction(FirstElement.Action);
        }
    }
}