Files
OpenRA/OpenRA.Mods.Common/Traits/Carryable.cs
2022-05-28 00:35:10 -05:00

152 lines
4.1 KiB
C#

#region Copyright & License Information
/*
* Copyright 2007-2022 The OpenRA Developers (see AUTHORS)
* This file is part of OpenRA, which is free software. It is made
* available to you under the terms of the GNU General Public License
* as published by the Free Software Foundation, either version 3 of
* the License, or (at your option) any later version. For more
* information, see COPYING.
*/
#endregion
using System.Linq;
using OpenRA.Traits;
namespace OpenRA.Mods.Common.Traits
{
[Desc("Can be carried by actors with the `" + nameof(Carryall) + "` trait.")]
public class CarryableInfo : ConditionalTraitInfo
{
[GrantedConditionReference]
[Desc("The condition to grant to self while a carryall has been reserved.")]
public readonly string ReservedCondition = null;
[GrantedConditionReference]
[Desc("The condition to grant to self while being carried.")]
public readonly string CarriedCondition = null;
[GrantedConditionReference]
[Desc("The condition to grant to self while being locked for carry.")]
public readonly string LockedCondition = null;
[Desc("Carryall attachment point relative to body.")]
public readonly WVec LocalOffset = WVec.Zero;
public override object Create(ActorInitializer init) { return new Carryable(this); }
}
public enum LockResponse { Success, Pending, Failed }
public interface IDelayCarryallPickup
{
bool TryLockForPickup(Actor self, Actor carrier);
}
public class Carryable : ConditionalTrait<CarryableInfo>
{
int reservedToken = Actor.InvalidConditionToken;
int carriedToken = Actor.InvalidConditionToken;
int lockedToken = Actor.InvalidConditionToken;
Mobile mobile;
IDelayCarryallPickup[] delayPickups;
public Actor Carrier { get; private set; }
public bool Reserved => state != State.Free;
public CPos? Destination { get; protected set; }
public bool WantsTransport => Destination != null && !IsTraitDisabled;
protected enum State { Free, Reserved, Locked }
protected State state = State.Free;
protected bool attached;
public Carryable(CarryableInfo info)
: base(info) { }
protected override void Created(Actor self)
{
mobile = self.TraitOrDefault<Mobile>();
delayPickups = self.TraitsImplementing<IDelayCarryallPickup>().ToArray();
base.Created(self);
}
public virtual void Attached(Actor self)
{
if (attached)
return;
attached = true;
if (carriedToken == Actor.InvalidConditionToken)
carriedToken = self.GrantCondition(Info.CarriedCondition);
}
// This gets called by carrier after we touched down
public virtual void Detached(Actor self)
{
if (!attached)
return;
attached = false;
if (carriedToken != Actor.InvalidConditionToken)
carriedToken = self.RevokeCondition(carriedToken);
}
public virtual bool Reserve(Actor self, Actor carrier)
{
if (Reserved || IsTraitDisabled)
return false;
state = State.Reserved;
Carrier = carrier;
if (reservedToken == Actor.InvalidConditionToken)
reservedToken = self.GrantCondition(Info.ReservedCondition);
return true;
}
public virtual void UnReserve(Actor self)
{
state = State.Free;
Carrier = null;
if (reservedToken != Actor.InvalidConditionToken)
reservedToken = self.RevokeCondition(reservedToken);
if (lockedToken != Actor.InvalidConditionToken)
lockedToken = self.RevokeCondition(lockedToken);
}
// Prepare for transport pickup
public virtual LockResponse LockForPickup(Actor self, Actor carrier)
{
if (state == State.Locked && Carrier != carrier)
return LockResponse.Failed;
if (delayPickups.Any(d => d.IsTraitEnabled() && !d.TryLockForPickup(self, carrier)))
return LockResponse.Pending;
if (mobile != null && !mobile.CanStayInCell(self.Location))
return LockResponse.Pending;
if (state != State.Locked)
{
state = State.Locked;
Carrier = carrier;
if (lockedToken == Actor.InvalidConditionToken)
lockedToken = self.GrantCondition(Info.LockedCondition);
}
// Make sure we are not moving and at our normal position with respect to the cell grid
if (mobile != null && mobile.IsMovingBetweenCells)
return LockResponse.Pending;
return LockResponse.Success;
}
}
}