#region Copyright & License Information /* * Copyright 2007-2020 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; using System.Collections.Generic; using OpenRA.Mods.Common.Activities; using OpenRA.Mods.Common.Orders; using OpenRA.Primitives; using OpenRA.Support; using OpenRA.Traits; namespace OpenRA.Mods.Common.Traits { [Desc("This actor can enter Cargo actors.")] public class PassengerInfo : ITraitInfo, IObservesVariablesInfo { public readonly string CargoType = null; [Desc("If defined, use a custom pip type defined on the transport's WithCargoPipsDecoration.CustomPipSequences list.")] public readonly string CustomPipType = null; public readonly int Weight = 1; [GrantedConditionReference] [Desc("The condition to grant to when this actor is loaded inside any transport.")] public readonly string CargoCondition = null; [Desc("Conditions to grant when this actor is loaded inside specified transport.", "A dictionary of [actor id]: [condition].")] public readonly Dictionary CargoConditions = new Dictionary(); [GrantedConditionReference] public IEnumerable LinterCargoConditions { get { return CargoConditions.Values; } } [VoiceReference] public readonly string Voice = "Action"; [ConsumedConditionReference] [Desc("Boolean expression defining the condition under which the regular (non-force) enter cursor is disabled.")] public readonly BooleanExpression RequireForceMoveCondition = null; public object Create(ActorInitializer init) { return new Passenger(this); } } public class Passenger : INotifyCreated, IIssueOrder, IResolveOrder, IOrderVoice, INotifyRemovedFromWorld, INotifyEnteredCargo, INotifyExitedCargo, INotifyKilled, IObservesVariables { public readonly PassengerInfo Info; public Actor Transport; bool requireForceMove; ConditionManager conditionManager; int anyCargoToken = ConditionManager.InvalidConditionToken; int specificCargoToken = ConditionManager.InvalidConditionToken; public Passenger(PassengerInfo info) { Info = info; } public Cargo ReservedCargo { get; private set; } IEnumerable IIssueOrder.Orders { get { yield return new EnterAlliedActorTargeter("EnterTransport", 5, IsCorrectCargoType, CanEnter); } } void INotifyCreated.Created(Actor self) { conditionManager = self.TraitOrDefault(); } public Order IssueOrder(Actor self, IOrderTargeter order, Target target, bool queued) { if (order.OrderID == "EnterTransport") return new Order(order.OrderID, self, target, queued); return null; } bool IsCorrectCargoType(Actor target, TargetModifiers modifiers) { if (requireForceMove && !modifiers.HasModifier(TargetModifiers.ForceMove)) return false; return IsCorrectCargoType(target); } bool IsCorrectCargoType(Actor target) { var ci = target.Info.TraitInfo(); return ci.Types.Contains(Info.CargoType); } bool CanEnter(Cargo cargo) { return cargo != null && cargo.HasSpace(Info.Weight); } bool CanEnter(Actor target) { return CanEnter(target.TraitOrDefault()); } public string VoicePhraseForOrder(Actor self, Order order) { if (order.OrderString != "EnterTransport") return null; if (order.Target.Type != TargetType.Actor || !CanEnter(order.Target.Actor)) return null; return Info.Voice; } void INotifyEnteredCargo.OnEnteredCargo(Actor self, Actor cargo) { string specificCargoCondition; if (conditionManager != null) { if (anyCargoToken == ConditionManager.InvalidConditionToken && !string.IsNullOrEmpty(Info.CargoCondition)) anyCargoToken = conditionManager.GrantCondition(self, Info.CargoCondition); if (specificCargoToken == ConditionManager.InvalidConditionToken && Info.CargoConditions.TryGetValue(cargo.Info.Name, out specificCargoCondition)) specificCargoToken = conditionManager.GrantCondition(self, specificCargoCondition); } // Allow scripted / initial actors to move from the unload point back into the cell grid on unload // This is handled by the RideTransport activity for player-loaded cargo if (self.IsIdle) { // IMove is not used anywhere else in this trait, there is no benefit to caching it from Created. var move = self.TraitOrDefault(); if (move != null) self.QueueActivity(move.ReturnToCell(self)); } } void INotifyExitedCargo.OnExitedCargo(Actor self, Actor cargo) { if (anyCargoToken != ConditionManager.InvalidConditionToken) anyCargoToken = conditionManager.RevokeCondition(self, anyCargoToken); if (specificCargoToken != ConditionManager.InvalidConditionToken) specificCargoToken = conditionManager.RevokeCondition(self, specificCargoToken); } void IResolveOrder.ResolveOrder(Actor self, Order order) { if (order.OrderString != "EnterTransport") return; // Enter orders are only valid for own/allied actors, // which are guaranteed to never be frozen. if (order.Target.Type != TargetType.Actor) return; var targetActor = order.Target.Actor; if (!CanEnter(targetActor)) return; if (!IsCorrectCargoType(targetActor)) return; self.QueueActivity(order.Queued, new RideTransport(self, order.Target)); self.ShowTargetLines(); } public bool Reserve(Actor self, Cargo cargo) { if (cargo == ReservedCargo) return true; Unreserve(self); if (!cargo.ReserveSpace(self)) return false; ReservedCargo = cargo; return true; } void INotifyRemovedFromWorld.RemovedFromWorld(Actor self) { Unreserve(self); } public void Unreserve(Actor self) { if (ReservedCargo == null) return; ReservedCargo.UnreserveSpace(self); ReservedCargo = null; } void INotifyKilled.Killed(Actor self, AttackInfo e) { if (Transport == null) return; // Something killed us, but it wasn't our transport blowing up. Remove us from the cargo. if (!Transport.IsDead) Transport.Trait().Unload(Transport, self); } IEnumerable IObservesVariables.GetVariableObservers() { if (Info.RequireForceMoveCondition != null) yield return new VariableObserver(RequireForceMoveConditionChanged, Info.RequireForceMoveCondition.Variables); } void RequireForceMoveConditionChanged(Actor self, IReadOnlyDictionary conditions) { requireForceMove = Info.RequireForceMoveCondition.Evaluate(conditions); } } }