Update: Translations from eints
[openttd-github.git] / src / order_cmd.cpp
blob1d6743106efe293e264bcab320395db21f4f7f47
1 /*
2 * This file is part of OpenTTD.
3 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
6 */
8 /** @file order_cmd.cpp Handling of orders. */
10 #include "stdafx.h"
11 #include "debug.h"
12 #include "command_func.h"
13 #include "company_func.h"
14 #include "news_func.h"
15 #include "strings_func.h"
16 #include "timetable.h"
17 #include "vehicle_func.h"
18 #include "depot_base.h"
19 #include "core/pool_func.hpp"
20 #include "core/random_func.hpp"
21 #include "aircraft.h"
22 #include "roadveh.h"
23 #include "station_base.h"
24 #include "waypoint_base.h"
25 #include "company_base.h"
26 #include "order_backup.h"
27 #include "cheat_type.h"
28 #include "order_cmd.h"
29 #include "train_cmd.h"
31 #include "table/strings.h"
33 #include "safeguards.h"
35 /* DestinationID must be at least as large as every these below, because it can
36 * be any of them
38 static_assert(sizeof(DestinationID) >= sizeof(DepotID));
39 static_assert(sizeof(DestinationID) >= sizeof(StationID));
41 OrderPool _order_pool("Order");
42 INSTANTIATE_POOL_METHODS(Order)
43 OrderListPool _orderlist_pool("OrderList");
44 INSTANTIATE_POOL_METHODS(OrderList)
46 /** Clean everything up. */
47 Order::~Order()
49 if (CleaningPool()) return;
51 /* We can visit oil rigs and buoys that are not our own. They will be shown in
52 * the list of stations. So, we need to invalidate that window if needed. */
53 if (this->IsType(OT_GOTO_STATION) || this->IsType(OT_GOTO_WAYPOINT)) {
54 BaseStation *bs = BaseStation::GetIfValid(this->GetDestination());
55 if (bs != nullptr && bs->owner == OWNER_NONE) InvalidateWindowClassesData(WC_STATION_LIST, 0);
59 /**
60 * 'Free' the order
61 * @note ONLY use on "current_order" vehicle orders!
63 void Order::Free()
65 this->type = OT_NOTHING;
66 this->flags = 0;
67 this->dest = 0;
68 this->next = nullptr;
71 /**
72 * Makes this order a Go To Station order.
73 * @param destination the station to go to.
75 void Order::MakeGoToStation(StationID destination)
77 this->type = OT_GOTO_STATION;
78 this->flags = 0;
79 this->dest = destination;
82 /**
83 * Makes this order a Go To Depot order.
84 * @param destination the depot to go to.
85 * @param order is this order a 'default' order, or an overridden vehicle order?
86 * @param non_stop_type how to get to the depot?
87 * @param action what to do in the depot?
88 * @param cargo the cargo type to change to.
90 void Order::MakeGoToDepot(DepotID destination, OrderDepotTypeFlags order, OrderNonStopFlags non_stop_type, OrderDepotActionFlags action, CargoID cargo)
92 this->type = OT_GOTO_DEPOT;
93 this->SetDepotOrderType(order);
94 this->SetDepotActionType(action);
95 this->SetNonStopType(non_stop_type);
96 this->dest = destination;
97 this->SetRefit(cargo);
101 * Makes this order a Go To Waypoint order.
102 * @param destination the waypoint to go to.
104 void Order::MakeGoToWaypoint(StationID destination)
106 this->type = OT_GOTO_WAYPOINT;
107 this->flags = 0;
108 this->dest = destination;
112 * Makes this order a Loading order.
113 * @param ordered is this an ordered stop?
115 void Order::MakeLoading(bool ordered)
117 this->type = OT_LOADING;
118 if (!ordered) this->flags = 0;
122 * Makes this order a Leave Station order.
124 void Order::MakeLeaveStation()
126 this->type = OT_LEAVESTATION;
127 this->flags = 0;
131 * Makes this order a Dummy order.
133 void Order::MakeDummy()
135 this->type = OT_DUMMY;
136 this->flags = 0;
140 * Makes this order an conditional order.
141 * @param order the order to jump to.
143 void Order::MakeConditional(VehicleOrderID order)
145 this->type = OT_CONDITIONAL;
146 this->flags = order;
147 this->dest = 0;
151 * Makes this order an implicit order.
152 * @param destination the station to go to.
154 void Order::MakeImplicit(StationID destination)
156 this->type = OT_IMPLICIT;
157 this->dest = destination;
161 * Make this depot/station order also a refit order.
162 * @param cargo the cargo type to change to.
163 * @pre IsType(OT_GOTO_DEPOT) || IsType(OT_GOTO_STATION).
165 void Order::SetRefit(CargoID cargo)
167 this->refit_cargo = cargo;
171 * Does this order have the same type, flags and destination?
172 * @param other the second order to compare to.
173 * @return true if the type, flags and destination match.
175 bool Order::Equals(const Order &other) const
177 /* In case of go to nearest depot orders we need "only" compare the flags
178 * with the other and not the nearest depot order bit or the actual
179 * destination because those get clear/filled in during the order
180 * evaluation. If we do not do this the order will continuously be seen as
181 * a different order and it will try to find a "nearest depot" every tick. */
182 if ((this->IsType(OT_GOTO_DEPOT) && this->type == other.type) &&
183 ((this->GetDepotActionType() & ODATFB_NEAREST_DEPOT) != 0 ||
184 (other.GetDepotActionType() & ODATFB_NEAREST_DEPOT) != 0)) {
185 return this->GetDepotOrderType() == other.GetDepotOrderType() &&
186 (this->GetDepotActionType() & ~ODATFB_NEAREST_DEPOT) == (other.GetDepotActionType() & ~ODATFB_NEAREST_DEPOT);
189 return this->type == other.type && this->flags == other.flags && this->dest == other.dest;
193 * Pack this order into a 32 bits integer, or actually only
194 * the type, flags and destination.
195 * @return the packed representation.
196 * @note unpacking is done in the constructor.
198 uint32_t Order::Pack() const
200 return this->dest << 16 | this->flags << 8 | this->type;
204 * Pack this order into a 16 bits integer as close to the TTD
205 * representation as possible.
206 * @return the TTD-like packed representation.
208 uint16_t Order::MapOldOrder() const
210 uint16_t order = this->GetType();
211 switch (this->type) {
212 case OT_GOTO_STATION:
213 if (this->GetUnloadType() & OUFB_UNLOAD) SetBit(order, 5);
214 if (this->GetLoadType() & OLFB_FULL_LOAD) SetBit(order, 6);
215 if (this->GetNonStopType() & ONSF_NO_STOP_AT_INTERMEDIATE_STATIONS) SetBit(order, 7);
216 order |= GB(this->GetDestination(), 0, 8) << 8;
217 break;
218 case OT_GOTO_DEPOT:
219 if (!(this->GetDepotOrderType() & ODTFB_PART_OF_ORDERS)) SetBit(order, 6);
220 SetBit(order, 7);
221 order |= GB(this->GetDestination(), 0, 8) << 8;
222 break;
223 case OT_LOADING:
224 if (this->GetLoadType() & OLFB_FULL_LOAD) SetBit(order, 6);
225 break;
227 return order;
232 * Updates the widgets of a vehicle which contains the order-data
235 void InvalidateVehicleOrder(const Vehicle *v, int data)
237 SetWindowDirty(WC_VEHICLE_VIEW, v->index);
239 if (data != 0) {
240 /* Calls SetDirty() too */
241 InvalidateWindowData(WC_VEHICLE_ORDERS, v->index, data);
242 InvalidateWindowData(WC_VEHICLE_TIMETABLE, v->index, data);
243 return;
246 SetWindowDirty(WC_VEHICLE_ORDERS, v->index);
247 SetWindowDirty(WC_VEHICLE_TIMETABLE, v->index);
252 * Assign data to an order (from another order)
253 * This function makes sure that the index is maintained correctly
254 * @param other the data to copy (except next pointer).
257 void Order::AssignOrder(const Order &other)
259 this->type = other.type;
260 this->flags = other.flags;
261 this->dest = other.dest;
263 this->refit_cargo = other.refit_cargo;
265 this->wait_time = other.wait_time;
266 this->travel_time = other.travel_time;
267 this->max_speed = other.max_speed;
271 * Recomputes everything.
272 * @param chain first order in the chain
273 * @param v one of vehicle that is using this orderlist
275 void OrderList::Initialize(Order *chain, Vehicle *v)
277 this->first = chain;
278 this->first_shared = v;
280 this->num_orders = 0;
281 this->num_manual_orders = 0;
282 this->num_vehicles = 1;
283 this->timetable_duration = 0;
285 for (Order *o = this->first; o != nullptr; o = o->next) {
286 ++this->num_orders;
287 if (!o->IsType(OT_IMPLICIT)) ++this->num_manual_orders;
288 this->total_duration += o->GetWaitTime() + o->GetTravelTime();
291 this->RecalculateTimetableDuration();
293 for (Vehicle *u = this->first_shared->PreviousShared(); u != nullptr; u = u->PreviousShared()) {
294 ++this->num_vehicles;
295 this->first_shared = u;
298 for (const Vehicle *u = v->NextShared(); u != nullptr; u = u->NextShared()) ++this->num_vehicles;
302 * Recomputes Timetable duration.
303 * Split out into a separate function so it can be used by afterload.
305 void OrderList::RecalculateTimetableDuration()
307 this->timetable_duration = 0;
308 for (Order *o = this->first; o != nullptr; o = o->next) {
309 this->timetable_duration += o->GetTimetabledWait() + o->GetTimetabledTravel();
314 * Free a complete order chain.
315 * @param keep_orderlist If this is true only delete the orders, otherwise also delete the OrderList.
316 * @note do not use on "current_order" vehicle orders!
318 void OrderList::FreeChain(bool keep_orderlist)
320 Order *next;
321 for (Order *o = this->first; o != nullptr; o = next) {
322 next = o->next;
323 delete o;
326 if (keep_orderlist) {
327 this->first = nullptr;
328 this->num_orders = 0;
329 this->num_manual_orders = 0;
330 this->timetable_duration = 0;
331 } else {
332 delete this;
337 * Get a certain order of the order chain.
338 * @param index zero-based index of the order within the chain.
339 * @return the order at position index.
341 Order *OrderList::GetOrderAt(int index) const
343 if (index < 0) return nullptr;
345 Order *order = this->first;
347 while (order != nullptr && index-- > 0) {
348 order = order->next;
350 return order;
354 * Get the next order which will make the given vehicle stop at a station
355 * or refit at a depot or evaluate a non-trivial condition.
356 * @param next The order to start looking at.
357 * @param hops The number of orders we have already looked at.
358 * @return Either of
359 * \li a station order
360 * \li a refitting depot order
361 * \li a non-trivial conditional order
362 * \li nullptr if the vehicle won't stop anymore.
364 const Order *OrderList::GetNextDecisionNode(const Order *next, uint hops) const
366 if (hops > this->GetNumOrders() || next == nullptr) return nullptr;
368 if (next->IsType(OT_CONDITIONAL)) {
369 if (next->GetConditionVariable() != OCV_UNCONDITIONALLY) return next;
371 /* We can evaluate trivial conditions right away. They're conceptually
372 * the same as regular order progression. */
373 return this->GetNextDecisionNode(
374 this->GetOrderAt(next->GetConditionSkipToOrder()),
375 hops + 1);
378 if (next->IsType(OT_GOTO_DEPOT)) {
379 if ((next->GetDepotActionType() & ODATFB_HALT) != 0) return nullptr;
380 if (next->IsRefit()) return next;
383 if (!next->CanLoadOrUnload()) {
384 return this->GetNextDecisionNode(this->GetNext(next), hops + 1);
387 return next;
391 * Recursively determine the next deterministic station to stop at.
392 * @param v The vehicle we're looking at.
393 * @param first Order to start searching at or nullptr to start at cur_implicit_order_index + 1.
394 * @param hops Number of orders we have already looked at.
395 * @return Next stopping station or INVALID_STATION.
396 * @pre The vehicle is currently loading and v->last_station_visited is meaningful.
397 * @note This function may draw a random number. Don't use it from the GUI.
399 StationIDStack OrderList::GetNextStoppingStation(const Vehicle *v, const Order *first, uint hops) const
402 const Order *next = first;
403 if (first == nullptr) {
404 next = this->GetOrderAt(v->cur_implicit_order_index);
405 if (next == nullptr) {
406 next = this->GetFirstOrder();
407 if (next == nullptr) return INVALID_STATION;
408 } else {
409 /* GetNext never returns nullptr if there is a valid station in the list.
410 * As the given "next" is already valid and a station in the list, we
411 * don't have to check for nullptr here. */
412 next = this->GetNext(next);
413 assert(next != nullptr);
417 do {
418 next = this->GetNextDecisionNode(next, ++hops);
420 /* Resolve possibly nested conditionals by estimation. */
421 while (next != nullptr && next->IsType(OT_CONDITIONAL)) {
422 /* We return both options of conditional orders. */
423 const Order *skip_to = this->GetNextDecisionNode(
424 this->GetOrderAt(next->GetConditionSkipToOrder()), hops);
425 const Order *advance = this->GetNextDecisionNode(
426 this->GetNext(next), hops);
427 if (advance == nullptr || advance == first || skip_to == advance) {
428 next = (skip_to == first) ? nullptr : skip_to;
429 } else if (skip_to == nullptr || skip_to == first) {
430 next = (advance == first) ? nullptr : advance;
431 } else {
432 StationIDStack st1 = this->GetNextStoppingStation(v, skip_to, hops);
433 StationIDStack st2 = this->GetNextStoppingStation(v, advance, hops);
434 while (!st2.IsEmpty()) st1.Push(st2.Pop());
435 return st1;
437 ++hops;
440 /* Don't return a next stop if the vehicle has to unload everything. */
441 if (next == nullptr || ((next->IsType(OT_GOTO_STATION) || next->IsType(OT_IMPLICIT)) &&
442 next->GetDestination() == v->last_station_visited &&
443 (next->GetUnloadType() & (OUFB_TRANSFER | OUFB_UNLOAD)) != 0)) {
444 return INVALID_STATION;
446 } while (next->IsType(OT_GOTO_DEPOT) || next->GetDestination() == v->last_station_visited);
448 return next->GetDestination();
452 * Insert a new order into the order chain.
453 * @param new_order is the order to insert into the chain.
454 * @param index is the position where the order is supposed to be inserted.
456 void OrderList::InsertOrderAt(Order *new_order, int index)
458 if (this->first == nullptr) {
459 this->first = new_order;
460 } else {
461 if (index == 0) {
462 /* Insert as first or only order */
463 new_order->next = this->first;
464 this->first = new_order;
465 } else if (index >= this->num_orders) {
466 /* index is after the last order, add it to the end */
467 this->GetLastOrder()->next = new_order;
468 } else {
469 /* Put the new order in between */
470 Order *order = this->GetOrderAt(index - 1);
471 new_order->next = order->next;
472 order->next = new_order;
475 ++this->num_orders;
476 if (!new_order->IsType(OT_IMPLICIT)) ++this->num_manual_orders;
477 this->timetable_duration += new_order->GetTimetabledWait() + new_order->GetTimetabledTravel();
478 this->total_duration += new_order->GetWaitTime() + new_order->GetTravelTime();
480 /* We can visit oil rigs and buoys that are not our own. They will be shown in
481 * the list of stations. So, we need to invalidate that window if needed. */
482 if (new_order->IsType(OT_GOTO_STATION) || new_order->IsType(OT_GOTO_WAYPOINT)) {
483 BaseStation *bs = BaseStation::Get(new_order->GetDestination());
484 if (bs->owner == OWNER_NONE) InvalidateWindowClassesData(WC_STATION_LIST, 0);
491 * Remove an order from the order list and delete it.
492 * @param index is the position of the order which is to be deleted.
494 void OrderList::DeleteOrderAt(int index)
496 if (index >= this->num_orders) return;
498 Order *to_remove;
500 if (index == 0) {
501 to_remove = this->first;
502 this->first = to_remove->next;
503 } else {
504 Order *prev = GetOrderAt(index - 1);
505 to_remove = prev->next;
506 prev->next = to_remove->next;
508 --this->num_orders;
509 if (!to_remove->IsType(OT_IMPLICIT)) --this->num_manual_orders;
510 this->timetable_duration -= (to_remove->GetTimetabledWait() + to_remove->GetTimetabledTravel());
511 this->total_duration -= (to_remove->GetWaitTime() + to_remove->GetTravelTime());
512 delete to_remove;
516 * Move an order to another position within the order list.
517 * @param from is the zero-based position of the order to move.
518 * @param to is the zero-based position where the order is moved to.
520 void OrderList::MoveOrder(int from, int to)
522 if (from >= this->num_orders || to >= this->num_orders || from == to) return;
524 Order *moving_one;
526 /* Take the moving order out of the pointer-chain */
527 if (from == 0) {
528 moving_one = this->first;
529 this->first = moving_one->next;
530 } else {
531 Order *one_before = GetOrderAt(from - 1);
532 moving_one = one_before->next;
533 one_before->next = moving_one->next;
536 /* Insert the moving_order again in the pointer-chain */
537 if (to == 0) {
538 moving_one->next = this->first;
539 this->first = moving_one;
540 } else {
541 Order *one_before = GetOrderAt(to - 1);
542 moving_one->next = one_before->next;
543 one_before->next = moving_one;
548 * Removes the vehicle from the shared order list.
549 * @note This is supposed to be called when the vehicle is still in the chain
550 * @param v vehicle to remove from the list
552 void OrderList::RemoveVehicle(Vehicle *v)
554 --this->num_vehicles;
555 if (v == this->first_shared) this->first_shared = v->NextShared();
559 * Checks whether all orders of the list have a filled timetable.
560 * @return whether all orders have a filled timetable.
562 bool OrderList::IsCompleteTimetable() const
564 for (Order *o = this->first; o != nullptr; o = o->next) {
565 /* Implicit orders are, by definition, not timetabled. */
566 if (o->IsType(OT_IMPLICIT)) continue;
567 if (!o->IsCompletelyTimetabled()) return false;
569 return true;
572 #ifdef WITH_ASSERT
574 * Checks for internal consistency of order list. Triggers assertion if something is wrong.
576 void OrderList::DebugCheckSanity() const
578 VehicleOrderID check_num_orders = 0;
579 VehicleOrderID check_num_manual_orders = 0;
580 uint check_num_vehicles = 0;
581 TimerGameTick::Ticks check_timetable_duration = 0;
582 TimerGameTick::Ticks check_total_duration = 0;
584 Debug(misc, 6, "Checking OrderList {} for sanity...", this->index);
586 for (const Order *o = this->first; o != nullptr; o = o->next) {
587 ++check_num_orders;
588 if (!o->IsType(OT_IMPLICIT)) ++check_num_manual_orders;
589 check_timetable_duration += o->GetTimetabledWait() + o->GetTimetabledTravel();
590 check_total_duration += o->GetWaitTime() + o->GetTravelTime();
592 assert(this->num_orders == check_num_orders);
593 assert(this->num_manual_orders == check_num_manual_orders);
594 assert(this->timetable_duration == check_timetable_duration);
595 assert(this->total_duration == check_total_duration);
597 for (const Vehicle *v = this->first_shared; v != nullptr; v = v->NextShared()) {
598 ++check_num_vehicles;
599 assert(v->orders == this);
601 assert(this->num_vehicles == check_num_vehicles);
602 Debug(misc, 6, "... detected {} orders ({} manual), {} vehicles, {} timetabled, {} total",
603 (uint)this->num_orders, (uint)this->num_manual_orders,
604 this->num_vehicles, this->timetable_duration, this->total_duration);
606 #endif
609 * Checks whether the order goes to a station or not, i.e. whether the
610 * destination is a station
611 * @param v the vehicle to check for
612 * @param o the order to check
613 * @return true if the destination is a station
615 static inline bool OrderGoesToStation(const Vehicle *v, const Order *o)
617 return o->IsType(OT_GOTO_STATION) ||
618 (v->type == VEH_AIRCRAFT && o->IsType(OT_GOTO_DEPOT) && o->GetDestination() != INVALID_STATION);
622 * Delete all news items regarding defective orders about a vehicle
623 * This could kill still valid warnings (for example about void order when just
624 * another order gets added), but assume the company will notice the problems,
625 * when they're changing the orders.
627 static void DeleteOrderWarnings(const Vehicle *v)
629 DeleteVehicleNews(v->index, STR_NEWS_VEHICLE_HAS_TOO_FEW_ORDERS);
630 DeleteVehicleNews(v->index, STR_NEWS_VEHICLE_HAS_VOID_ORDER);
631 DeleteVehicleNews(v->index, STR_NEWS_VEHICLE_HAS_DUPLICATE_ENTRY);
632 DeleteVehicleNews(v->index, STR_NEWS_VEHICLE_HAS_INVALID_ENTRY);
633 DeleteVehicleNews(v->index, STR_NEWS_PLANE_USES_TOO_SHORT_RUNWAY);
637 * Returns a tile somewhat representing the order destination (not suitable for pathfinding).
638 * @param v The vehicle to get the location for.
639 * @param airport Get the airport tile and not the station location for aircraft.
640 * @return destination of order, or INVALID_TILE if none.
642 TileIndex Order::GetLocation(const Vehicle *v, bool airport) const
644 switch (this->GetType()) {
645 case OT_GOTO_WAYPOINT:
646 case OT_GOTO_STATION:
647 case OT_IMPLICIT:
648 if (airport && v->type == VEH_AIRCRAFT) return Station::Get(this->GetDestination())->airport.tile;
649 return BaseStation::Get(this->GetDestination())->xy;
651 case OT_GOTO_DEPOT:
652 if (this->GetDestination() == INVALID_DEPOT) return INVALID_TILE;
653 return (v->type == VEH_AIRCRAFT) ? Station::Get(this->GetDestination())->xy : Depot::Get(this->GetDestination())->xy;
655 default:
656 return INVALID_TILE;
661 * Get the distance between two orders of a vehicle. Conditional orders are resolved
662 * and the bigger distance of the two order branches is returned.
663 * @param prev Origin order.
664 * @param cur Destination order.
665 * @param v The vehicle to get the distance for.
666 * @param conditional_depth Internal param for resolving conditional orders.
667 * @return Maximum distance between the two orders.
669 uint GetOrderDistance(const Order *prev, const Order *cur, const Vehicle *v, int conditional_depth)
671 if (cur->IsType(OT_CONDITIONAL)) {
672 if (conditional_depth > v->GetNumOrders()) return 0;
674 conditional_depth++;
676 int dist1 = GetOrderDistance(prev, v->GetOrder(cur->GetConditionSkipToOrder()), v, conditional_depth);
677 int dist2 = GetOrderDistance(prev, cur->next == nullptr ? v->orders->GetFirstOrder() : cur->next, v, conditional_depth);
678 return std::max(dist1, dist2);
681 TileIndex prev_tile = prev->GetLocation(v, true);
682 TileIndex cur_tile = cur->GetLocation(v, true);
683 if (prev_tile == INVALID_TILE || cur_tile == INVALID_TILE) return 0;
684 return v->type == VEH_AIRCRAFT ? DistanceSquare(prev_tile, cur_tile) : DistanceManhattan(prev_tile, cur_tile);
688 * Add an order to the orderlist of a vehicle.
689 * @param flags operation to perform
690 * @param veh ID of the vehicle
691 * @param sel_ord the selected order (if any). If the last order is given,
692 * the order will be inserted before that one
693 * the maximum vehicle order id is 254.
694 * @param new_order order to insert
695 * @return the cost of this operation or an error
697 CommandCost CmdInsertOrder(DoCommandFlag flags, VehicleID veh, VehicleOrderID sel_ord, const Order &new_order)
699 Vehicle *v = Vehicle::GetIfValid(veh);
700 if (v == nullptr || !v->IsPrimaryVehicle()) return CMD_ERROR;
702 CommandCost ret = CheckOwnership(v->owner);
703 if (ret.Failed()) return ret;
705 /* Validate properties we don't want to have different from default as they are set by other commands. */
706 if (new_order.GetRefitCargo() != CARGO_NO_REFIT || new_order.GetWaitTime() != 0 || new_order.GetTravelTime() != 0 || new_order.GetMaxSpeed() != UINT16_MAX) return CMD_ERROR;
708 /* Check if the inserted order is to the correct destination (owner, type),
709 * and has the correct flags if any */
710 switch (new_order.GetType()) {
711 case OT_GOTO_STATION: {
712 const Station *st = Station::GetIfValid(new_order.GetDestination());
713 if (st == nullptr) return CMD_ERROR;
715 if (st->owner != OWNER_NONE) {
716 ret = CheckOwnership(st->owner);
717 if (ret.Failed()) return ret;
720 if (!CanVehicleUseStation(v, st)) return CommandCost(STR_ERROR_CAN_T_ADD_ORDER, GetVehicleCannotUseStationReason(v, st));
721 for (Vehicle *u = v->FirstShared(); u != nullptr; u = u->NextShared()) {
722 if (!CanVehicleUseStation(u, st)) return CommandCost(STR_ERROR_CAN_T_ADD_ORDER_SHARED, GetVehicleCannotUseStationReason(u, st));
725 /* Non stop only allowed for ground vehicles. */
726 if (new_order.GetNonStopType() != ONSF_STOP_EVERYWHERE && !v->IsGroundVehicle()) return CMD_ERROR;
728 /* Filter invalid load/unload types. */
729 switch (new_order.GetLoadType()) {
730 case OLF_LOAD_IF_POSSIBLE:
731 case OLFB_NO_LOAD:
732 break;
734 case OLFB_FULL_LOAD:
735 case OLF_FULL_LOAD_ANY:
736 if (v->HasUnbunchingOrder()) return_cmd_error(STR_ERROR_UNBUNCHING_NO_FULL_LOAD);
737 break;
739 default:
740 return CMD_ERROR;
742 switch (new_order.GetUnloadType()) {
743 case OUF_UNLOAD_IF_POSSIBLE: case OUFB_UNLOAD: case OUFB_TRANSFER: case OUFB_NO_UNLOAD: break;
744 default: return CMD_ERROR;
747 /* Filter invalid stop locations */
748 switch (new_order.GetStopLocation()) {
749 case OSL_PLATFORM_NEAR_END:
750 case OSL_PLATFORM_MIDDLE:
751 if (v->type != VEH_TRAIN) return CMD_ERROR;
752 [[fallthrough]];
754 case OSL_PLATFORM_FAR_END:
755 break;
757 default:
758 return CMD_ERROR;
761 break;
764 case OT_GOTO_DEPOT: {
765 if ((new_order.GetDepotActionType() & ODATFB_NEAREST_DEPOT) == 0) {
766 if (v->type == VEH_AIRCRAFT) {
767 const Station *st = Station::GetIfValid(new_order.GetDestination());
769 if (st == nullptr) return CMD_ERROR;
771 ret = CheckOwnership(st->owner);
772 if (ret.Failed()) return ret;
774 if (!CanVehicleUseStation(v, st) || !st->airport.HasHangar()) {
775 return CMD_ERROR;
777 } else {
778 const Depot *dp = Depot::GetIfValid(new_order.GetDestination());
780 if (dp == nullptr) return CMD_ERROR;
782 ret = CheckOwnership(GetTileOwner(dp->xy));
783 if (ret.Failed()) return ret;
785 switch (v->type) {
786 case VEH_TRAIN:
787 if (!IsRailDepotTile(dp->xy)) return CMD_ERROR;
788 break;
790 case VEH_ROAD:
791 if (!IsRoadDepotTile(dp->xy)) return CMD_ERROR;
792 break;
794 case VEH_SHIP:
795 if (!IsShipDepotTile(dp->xy)) return CMD_ERROR;
796 break;
798 default: return CMD_ERROR;
803 if (new_order.GetNonStopType() != ONSF_STOP_EVERYWHERE && !v->IsGroundVehicle()) return CMD_ERROR;
804 if (new_order.GetDepotOrderType() & ~(ODTFB_PART_OF_ORDERS | ((new_order.GetDepotOrderType() & ODTFB_PART_OF_ORDERS) != 0 ? ODTFB_SERVICE : 0))) return CMD_ERROR;
805 if (new_order.GetDepotActionType() & ~(ODATFB_HALT | ODATFB_NEAREST_DEPOT | ODATFB_UNBUNCH)) return CMD_ERROR;
807 /* Vehicles cannot have a "service if needed" order that also has a depot action. */
808 if ((new_order.GetDepotOrderType() & ODTFB_SERVICE) && (new_order.GetDepotActionType() & (ODATFB_HALT | ODATFB_UNBUNCH))) return CMD_ERROR;
810 /* Check if we're allowed to have a new unbunching order. */
811 if ((new_order.GetDepotActionType() & ODATFB_UNBUNCH)) {
812 if (v->HasFullLoadOrder()) return CommandCost(STR_ERROR_CAN_T_ADD_ORDER, STR_ERROR_UNBUNCHING_NO_UNBUNCHING_FULL_LOAD);
813 if (v->HasUnbunchingOrder()) return CommandCost(STR_ERROR_CAN_T_ADD_ORDER, STR_ERROR_UNBUNCHING_ONLY_ONE_ALLOWED);
814 if (v->HasConditionalOrder()) return CommandCost(STR_ERROR_CAN_T_ADD_ORDER, STR_ERROR_UNBUNCHING_NO_UNBUNCHING_CONDITIONAL);
816 break;
819 case OT_GOTO_WAYPOINT: {
820 const Waypoint *wp = Waypoint::GetIfValid(new_order.GetDestination());
821 if (wp == nullptr) return CMD_ERROR;
823 switch (v->type) {
824 default: return CMD_ERROR;
826 case VEH_TRAIN: {
827 if (!(wp->facilities & FACIL_TRAIN)) return CommandCost(STR_ERROR_CAN_T_ADD_ORDER, STR_ERROR_NO_RAIL_WAYPOINT);
829 ret = CheckOwnership(wp->owner);
830 if (ret.Failed()) return ret;
831 break;
834 case VEH_ROAD: {
835 if (!(wp->facilities & (FACIL_BUS_STOP | FACIL_TRUCK_STOP))) return CommandCost(STR_ERROR_CAN_T_ADD_ORDER, STR_ERROR_NO_ROAD_WAYPOINT);
837 ret = CheckOwnership(wp->owner);
838 if (ret.Failed()) return ret;
839 break;
842 case VEH_SHIP:
843 if (!(wp->facilities & FACIL_DOCK)) return CommandCost(STR_ERROR_CAN_T_ADD_ORDER, STR_ERROR_NO_BUOY);
844 if (wp->owner != OWNER_NONE) {
845 ret = CheckOwnership(wp->owner);
846 if (ret.Failed()) return ret;
848 break;
851 /* Order flags can be any of the following for waypoints:
852 * [non-stop]
853 * non-stop orders (if any) are only valid for trains and road vehicles */
854 if (new_order.GetNonStopType() != ONSF_STOP_EVERYWHERE && !v->IsGroundVehicle()) return CMD_ERROR;
855 break;
858 case OT_CONDITIONAL: {
859 VehicleOrderID skip_to = new_order.GetConditionSkipToOrder();
860 if (skip_to != 0 && skip_to >= v->GetNumOrders()) return CMD_ERROR; // Always allow jumping to the first (even when there is no order).
861 if (new_order.GetConditionVariable() >= OCV_END) return CMD_ERROR;
862 if (v->HasUnbunchingOrder()) return_cmd_error(STR_ERROR_UNBUNCHING_NO_CONDITIONAL);
864 OrderConditionComparator occ = new_order.GetConditionComparator();
865 if (occ >= OCC_END) return CMD_ERROR;
866 switch (new_order.GetConditionVariable()) {
867 case OCV_REQUIRES_SERVICE:
868 if (occ != OCC_IS_TRUE && occ != OCC_IS_FALSE) return CMD_ERROR;
869 break;
871 case OCV_UNCONDITIONALLY:
872 if (occ != OCC_EQUALS) return CMD_ERROR;
873 if (new_order.GetConditionValue() != 0) return CMD_ERROR;
874 break;
876 case OCV_LOAD_PERCENTAGE:
877 case OCV_RELIABILITY:
878 if (new_order.GetConditionValue() > 100) return CMD_ERROR;
879 [[fallthrough]];
881 default:
882 if (occ == OCC_IS_TRUE || occ == OCC_IS_FALSE) return CMD_ERROR;
883 break;
885 break;
888 default: return CMD_ERROR;
891 if (sel_ord > v->GetNumOrders()) return CMD_ERROR;
893 if (v->GetNumOrders() >= MAX_VEH_ORDER_ID) return_cmd_error(STR_ERROR_TOO_MANY_ORDERS);
894 if (!Order::CanAllocateItem()) return_cmd_error(STR_ERROR_NO_MORE_SPACE_FOR_ORDERS);
895 if (v->orders == nullptr && !OrderList::CanAllocateItem()) return_cmd_error(STR_ERROR_NO_MORE_SPACE_FOR_ORDERS);
897 if (flags & DC_EXEC) {
898 Order *new_o = new Order();
899 new_o->AssignOrder(new_order);
900 InsertOrder(v, new_o, sel_ord);
903 return CommandCost();
907 * Insert a new order but skip the validation.
908 * @param v The vehicle to insert the order to.
909 * @param new_o The new order.
910 * @param sel_ord The position the order should be inserted at.
912 void InsertOrder(Vehicle *v, Order *new_o, VehicleOrderID sel_ord)
914 /* Create new order and link in list */
915 if (v->orders == nullptr) {
916 v->orders = new OrderList(new_o, v);
917 } else {
918 v->orders->InsertOrderAt(new_o, sel_ord);
921 Vehicle *u = v->FirstShared();
922 DeleteOrderWarnings(u);
923 for (; u != nullptr; u = u->NextShared()) {
924 assert(v->orders == u->orders);
926 /* If there is added an order before the current one, we need
927 * to update the selected order. We do not change implicit/real order indices though.
928 * If the new order is between the current implicit order and real order, the implicit order will
929 * later skip the inserted order. */
930 if (sel_ord <= u->cur_real_order_index) {
931 uint cur = u->cur_real_order_index + 1;
932 /* Check if we don't go out of bound */
933 if (cur < u->GetNumOrders()) {
934 u->cur_real_order_index = cur;
937 if (sel_ord == u->cur_implicit_order_index && u->IsGroundVehicle()) {
938 /* We are inserting an order just before the current implicit order.
939 * We do not know whether we will reach current implicit or the newly inserted order first.
940 * So, disable creation of implicit orders until we are on track again. */
941 uint16_t &gv_flags = u->GetGroundVehicleFlags();
942 SetBit(gv_flags, GVF_SUPPRESS_IMPLICIT_ORDERS);
944 if (sel_ord <= u->cur_implicit_order_index) {
945 uint cur = u->cur_implicit_order_index + 1;
946 /* Check if we don't go out of bound */
947 if (cur < u->GetNumOrders()) {
948 u->cur_implicit_order_index = cur;
951 /* Unbunching data is no longer valid. */
952 u->ResetDepotUnbunching();
954 /* Update any possible open window of the vehicle */
955 InvalidateVehicleOrder(u, INVALID_VEH_ORDER_ID | (sel_ord << 8));
958 /* As we insert an order, the order to skip to will be 'wrong'. */
959 VehicleOrderID cur_order_id = 0;
960 for (Order *order : v->Orders()) {
961 if (order->IsType(OT_CONDITIONAL)) {
962 VehicleOrderID order_id = order->GetConditionSkipToOrder();
963 if (order_id >= sel_ord) {
964 order->SetConditionSkipToOrder(order_id + 1);
966 if (order_id == cur_order_id) {
967 order->SetConditionSkipToOrder((order_id + 1) % v->GetNumOrders());
970 cur_order_id++;
973 /* Make sure to rebuild the whole list */
974 InvalidateWindowClassesData(GetWindowClassForVehicleType(v->type), 0);
978 * Declone an order-list
979 * @param *dst delete the orders of this vehicle
980 * @param flags execution flags
982 static CommandCost DecloneOrder(Vehicle *dst, DoCommandFlag flags)
984 if (flags & DC_EXEC) {
985 DeleteVehicleOrders(dst);
986 InvalidateVehicleOrder(dst, VIWD_REMOVE_ALL_ORDERS);
987 InvalidateWindowClassesData(GetWindowClassForVehicleType(dst->type), 0);
989 return CommandCost();
993 * Delete an order from the orderlist of a vehicle.
994 * @param flags operation to perform
995 * @param veh_id the ID of the vehicle
996 * @param sel_ord the order to delete (max 255)
997 * @return the cost of this operation or an error
999 CommandCost CmdDeleteOrder(DoCommandFlag flags, VehicleID veh_id, VehicleOrderID sel_ord)
1001 Vehicle *v = Vehicle::GetIfValid(veh_id);
1003 if (v == nullptr || !v->IsPrimaryVehicle()) return CMD_ERROR;
1005 CommandCost ret = CheckOwnership(v->owner);
1006 if (ret.Failed()) return ret;
1008 /* If we did not select an order, we maybe want to de-clone the orders */
1009 if (sel_ord >= v->GetNumOrders()) return DecloneOrder(v, flags);
1011 if (v->GetOrder(sel_ord) == nullptr) return CMD_ERROR;
1013 if (flags & DC_EXEC) DeleteOrder(v, sel_ord);
1014 return CommandCost();
1018 * Cancel the current loading order of the vehicle as the order was deleted.
1019 * @param v the vehicle
1021 static void CancelLoadingDueToDeletedOrder(Vehicle *v)
1023 assert(v->current_order.IsType(OT_LOADING));
1024 /* NON-stop flag is misused to see if a train is in a station that is
1025 * on its order list or not */
1026 v->current_order.SetNonStopType(ONSF_STOP_EVERYWHERE);
1027 /* When full loading, "cancel" that order so the vehicle doesn't
1028 * stay indefinitely at this station anymore. */
1029 if (v->current_order.GetLoadType() & OLFB_FULL_LOAD) v->current_order.SetLoadType(OLF_LOAD_IF_POSSIBLE);
1033 * Delete an order but skip the parameter validation.
1034 * @param v The vehicle to delete the order from.
1035 * @param sel_ord The id of the order to be deleted.
1037 void DeleteOrder(Vehicle *v, VehicleOrderID sel_ord)
1039 v->orders->DeleteOrderAt(sel_ord);
1041 Vehicle *u = v->FirstShared();
1042 DeleteOrderWarnings(u);
1043 for (; u != nullptr; u = u->NextShared()) {
1044 assert(v->orders == u->orders);
1046 if (sel_ord == u->cur_real_order_index && u->current_order.IsType(OT_LOADING)) {
1047 CancelLoadingDueToDeletedOrder(u);
1050 if (sel_ord < u->cur_real_order_index) {
1051 u->cur_real_order_index--;
1052 } else if (sel_ord == u->cur_real_order_index) {
1053 u->UpdateRealOrderIndex();
1056 if (sel_ord < u->cur_implicit_order_index) {
1057 u->cur_implicit_order_index--;
1058 } else if (sel_ord == u->cur_implicit_order_index) {
1059 /* Make sure the index is valid */
1060 if (u->cur_implicit_order_index >= u->GetNumOrders()) u->cur_implicit_order_index = 0;
1062 /* Skip non-implicit orders for the implicit-order-index (e.g. if the current implicit order was deleted */
1063 while (u->cur_implicit_order_index != u->cur_real_order_index && !u->GetOrder(u->cur_implicit_order_index)->IsType(OT_IMPLICIT)) {
1064 u->cur_implicit_order_index++;
1065 if (u->cur_implicit_order_index >= u->GetNumOrders()) u->cur_implicit_order_index = 0;
1068 /* Unbunching data is no longer valid. */
1069 u->ResetDepotUnbunching();
1071 /* Update any possible open window of the vehicle */
1072 InvalidateVehicleOrder(u, sel_ord | (INVALID_VEH_ORDER_ID << 8));
1075 /* As we delete an order, the order to skip to will be 'wrong'. */
1076 VehicleOrderID cur_order_id = 0;
1077 for (Order *order : v->Orders()) {
1078 if (order->IsType(OT_CONDITIONAL)) {
1079 VehicleOrderID order_id = order->GetConditionSkipToOrder();
1080 if (order_id >= sel_ord) {
1081 order_id = std::max(order_id - 1, 0);
1083 if (order_id == cur_order_id) {
1084 order_id = (order_id + 1) % v->GetNumOrders();
1086 order->SetConditionSkipToOrder(order_id);
1088 cur_order_id++;
1091 InvalidateWindowClassesData(GetWindowClassForVehicleType(v->type), 0);
1095 * Goto order of order-list.
1096 * @param flags operation to perform
1097 * @param veh_id The ID of the vehicle which order is skipped
1098 * @param sel_ord the selected order to which we want to skip
1099 * @return the cost of this operation or an error
1101 CommandCost CmdSkipToOrder(DoCommandFlag flags, VehicleID veh_id, VehicleOrderID sel_ord)
1103 Vehicle *v = Vehicle::GetIfValid(veh_id);
1105 if (v == nullptr || !v->IsPrimaryVehicle() || sel_ord == v->cur_implicit_order_index || sel_ord >= v->GetNumOrders() || v->GetNumOrders() < 2) return CMD_ERROR;
1107 CommandCost ret = CheckOwnership(v->owner);
1108 if (ret.Failed()) return ret;
1110 if (flags & DC_EXEC) {
1111 if (v->current_order.IsType(OT_LOADING)) v->LeaveStation();
1113 v->cur_implicit_order_index = v->cur_real_order_index = sel_ord;
1114 v->UpdateRealOrderIndex();
1116 /* Unbunching data is no longer valid. */
1117 v->ResetDepotUnbunching();
1119 InvalidateVehicleOrder(v, VIWD_MODIFY_ORDERS);
1121 /* We have an aircraft/ship, they have a mini-schedule, so update them all */
1122 if (v->type == VEH_AIRCRAFT) SetWindowClassesDirty(WC_AIRCRAFT_LIST);
1123 if (v->type == VEH_SHIP) SetWindowClassesDirty(WC_SHIPS_LIST);
1126 return CommandCost();
1130 * Move an order inside the orderlist
1131 * @param flags operation to perform
1132 * @param veh the ID of the vehicle
1133 * @param moving_order the order to move
1134 * @param target_order the target order
1135 * @return the cost of this operation or an error
1136 * @note The target order will move one place down in the orderlist
1137 * if you move the order upwards else it'll move it one place down
1139 CommandCost CmdMoveOrder(DoCommandFlag flags, VehicleID veh, VehicleOrderID moving_order, VehicleOrderID target_order)
1141 Vehicle *v = Vehicle::GetIfValid(veh);
1142 if (v == nullptr || !v->IsPrimaryVehicle()) return CMD_ERROR;
1144 CommandCost ret = CheckOwnership(v->owner);
1145 if (ret.Failed()) return ret;
1147 /* Don't make senseless movements */
1148 if (moving_order >= v->GetNumOrders() || target_order >= v->GetNumOrders() ||
1149 moving_order == target_order || v->GetNumOrders() <= 1) return CMD_ERROR;
1151 Order *moving_one = v->GetOrder(moving_order);
1152 /* Don't move an empty order */
1153 if (moving_one == nullptr) return CMD_ERROR;
1155 if (flags & DC_EXEC) {
1156 v->orders->MoveOrder(moving_order, target_order);
1158 /* Update shared list */
1159 Vehicle *u = v->FirstShared();
1161 DeleteOrderWarnings(u);
1163 for (; u != nullptr; u = u->NextShared()) {
1164 /* Update the current order.
1165 * There are multiple ways to move orders, which result in cur_implicit_order_index
1166 * and cur_real_order_index to not longer make any sense. E.g. moving another
1167 * real order between them.
1169 * Basically one could choose to preserve either of them, but not both.
1170 * While both ways are suitable in this or that case from a human point of view, neither
1171 * of them makes really sense.
1172 * However, from an AI point of view, preserving cur_real_order_index is the most
1173 * predictable and transparent behaviour.
1175 * With that decision it basically does not matter what we do to cur_implicit_order_index.
1176 * If we change orders between the implicit- and real-index, the implicit orders are mostly likely
1177 * completely out-dated anyway. So, keep it simple and just keep cur_implicit_order_index as well.
1178 * The worst which can happen is that a lot of implicit orders are removed when reaching current_order.
1180 if (u->cur_real_order_index == moving_order) {
1181 u->cur_real_order_index = target_order;
1182 } else if (u->cur_real_order_index > moving_order && u->cur_real_order_index <= target_order) {
1183 u->cur_real_order_index--;
1184 } else if (u->cur_real_order_index < moving_order && u->cur_real_order_index >= target_order) {
1185 u->cur_real_order_index++;
1188 if (u->cur_implicit_order_index == moving_order) {
1189 u->cur_implicit_order_index = target_order;
1190 } else if (u->cur_implicit_order_index > moving_order && u->cur_implicit_order_index <= target_order) {
1191 u->cur_implicit_order_index--;
1192 } else if (u->cur_implicit_order_index < moving_order && u->cur_implicit_order_index >= target_order) {
1193 u->cur_implicit_order_index++;
1195 /* Unbunching data is no longer valid. */
1196 u->ResetDepotUnbunching();
1199 assert(v->orders == u->orders);
1200 /* Update any possible open window of the vehicle */
1201 InvalidateVehicleOrder(u, moving_order | (target_order << 8));
1204 /* As we move an order, the order to skip to will be 'wrong'. */
1205 for (Order *order : v->Orders()) {
1206 if (order->IsType(OT_CONDITIONAL)) {
1207 VehicleOrderID order_id = order->GetConditionSkipToOrder();
1208 if (order_id == moving_order) {
1209 order_id = target_order;
1210 } else if (order_id > moving_order && order_id <= target_order) {
1211 order_id--;
1212 } else if (order_id < moving_order && order_id >= target_order) {
1213 order_id++;
1215 order->SetConditionSkipToOrder(order_id);
1219 /* Make sure to rebuild the whole list */
1220 InvalidateWindowClassesData(GetWindowClassForVehicleType(v->type), 0);
1223 return CommandCost();
1227 * Modify an order in the orderlist of a vehicle.
1228 * @param flags operation to perform
1229 * @param veh ID of the vehicle
1230 * @param sel_ord the selected order (if any). If the last order is given,
1231 * the order will be inserted before that one
1232 * the maximum vehicle order id is 254.
1233 * @param mof what data to modify (@see ModifyOrderFlags)
1234 * @param data the data to modify
1235 * @return the cost of this operation or an error
1237 CommandCost CmdModifyOrder(DoCommandFlag flags, VehicleID veh, VehicleOrderID sel_ord, ModifyOrderFlags mof, uint16_t data)
1239 if (mof >= MOF_END) return CMD_ERROR;
1241 Vehicle *v = Vehicle::GetIfValid(veh);
1242 if (v == nullptr || !v->IsPrimaryVehicle()) return CMD_ERROR;
1244 CommandCost ret = CheckOwnership(v->owner);
1245 if (ret.Failed()) return ret;
1247 /* Is it a valid order? */
1248 if (sel_ord >= v->GetNumOrders()) return CMD_ERROR;
1250 Order *order = v->GetOrder(sel_ord);
1251 assert(order != nullptr);
1252 switch (order->GetType()) {
1253 case OT_GOTO_STATION:
1254 if (mof != MOF_NON_STOP && mof != MOF_STOP_LOCATION && mof != MOF_UNLOAD && mof != MOF_LOAD) return CMD_ERROR;
1255 break;
1257 case OT_GOTO_DEPOT:
1258 if (mof != MOF_NON_STOP && mof != MOF_DEPOT_ACTION) return CMD_ERROR;
1259 break;
1261 case OT_GOTO_WAYPOINT:
1262 if (mof != MOF_NON_STOP) return CMD_ERROR;
1263 break;
1265 case OT_CONDITIONAL:
1266 if (mof != MOF_COND_VARIABLE && mof != MOF_COND_COMPARATOR && mof != MOF_COND_VALUE && mof != MOF_COND_DESTINATION) return CMD_ERROR;
1267 break;
1269 default:
1270 return CMD_ERROR;
1273 switch (mof) {
1274 default: NOT_REACHED();
1276 case MOF_NON_STOP:
1277 if (!v->IsGroundVehicle()) return CMD_ERROR;
1278 if (data >= ONSF_END) return CMD_ERROR;
1279 if (data == order->GetNonStopType()) return CMD_ERROR;
1280 break;
1282 case MOF_STOP_LOCATION:
1283 if (v->type != VEH_TRAIN) return CMD_ERROR;
1284 if (data >= OSL_END) return CMD_ERROR;
1285 break;
1287 case MOF_UNLOAD:
1288 if (order->GetNonStopType() & ONSF_NO_STOP_AT_DESTINATION_STATION) return CMD_ERROR;
1289 if ((data & ~(OUFB_UNLOAD | OUFB_TRANSFER | OUFB_NO_UNLOAD)) != 0) return CMD_ERROR;
1290 /* Unload and no-unload are mutual exclusive and so are transfer and no unload. */
1291 if (data != 0 && ((data & (OUFB_UNLOAD | OUFB_TRANSFER)) != 0) == ((data & OUFB_NO_UNLOAD) != 0)) return CMD_ERROR;
1292 if (data == order->GetUnloadType()) return CMD_ERROR;
1293 break;
1295 case MOF_LOAD:
1296 if (order->GetNonStopType() & ONSF_NO_STOP_AT_DESTINATION_STATION) return CMD_ERROR;
1297 if (data > OLFB_NO_LOAD || data == 1) return CMD_ERROR;
1298 if (data == order->GetLoadType()) return CMD_ERROR;
1299 if ((data & (OLFB_FULL_LOAD | OLF_FULL_LOAD_ANY)) && v->HasUnbunchingOrder()) return_cmd_error(STR_ERROR_UNBUNCHING_NO_FULL_LOAD);
1300 break;
1302 case MOF_DEPOT_ACTION:
1303 if (data >= DA_END) return CMD_ERROR;
1304 /* Check if we are allowed to add unbunching. We are always allowed to remove it. */
1305 if (data == DA_UNBUNCH) {
1306 /* Only one unbunching order is allowed in a vehicle's orders. If this order already has an unbunching action, no error is needed. */
1307 if (v->HasUnbunchingOrder() && !(order->GetDepotActionType() & ODATFB_UNBUNCH)) return_cmd_error(STR_ERROR_UNBUNCHING_ONLY_ONE_ALLOWED);
1308 /* We don't allow unbunching if the vehicle has a conditional order. */
1309 if (v->HasConditionalOrder()) return_cmd_error(STR_ERROR_UNBUNCHING_NO_UNBUNCHING_CONDITIONAL);
1310 /* We don't allow unbunching if the vehicle has a full load order. */
1311 if (v->HasFullLoadOrder()) return_cmd_error(STR_ERROR_UNBUNCHING_NO_UNBUNCHING_FULL_LOAD);
1313 break;
1315 case MOF_COND_VARIABLE:
1316 if (data >= OCV_END) return CMD_ERROR;
1317 break;
1319 case MOF_COND_COMPARATOR:
1320 if (data >= OCC_END) return CMD_ERROR;
1321 switch (order->GetConditionVariable()) {
1322 case OCV_UNCONDITIONALLY: return CMD_ERROR;
1324 case OCV_REQUIRES_SERVICE:
1325 if (data != OCC_IS_TRUE && data != OCC_IS_FALSE) return CMD_ERROR;
1326 break;
1328 default:
1329 if (data == OCC_IS_TRUE || data == OCC_IS_FALSE) return CMD_ERROR;
1330 break;
1332 break;
1334 case MOF_COND_VALUE:
1335 switch (order->GetConditionVariable()) {
1336 case OCV_UNCONDITIONALLY:
1337 case OCV_REQUIRES_SERVICE:
1338 return CMD_ERROR;
1340 case OCV_LOAD_PERCENTAGE:
1341 case OCV_RELIABILITY:
1342 if (data > 100) return CMD_ERROR;
1343 break;
1345 default:
1346 if (data > 2047) return CMD_ERROR;
1347 break;
1349 break;
1351 case MOF_COND_DESTINATION:
1352 if (data >= v->GetNumOrders()) return CMD_ERROR;
1353 break;
1356 if (flags & DC_EXEC) {
1357 switch (mof) {
1358 case MOF_NON_STOP:
1359 order->SetNonStopType((OrderNonStopFlags)data);
1360 if (data & ONSF_NO_STOP_AT_DESTINATION_STATION) {
1361 order->SetRefit(CARGO_NO_REFIT);
1362 order->SetLoadType(OLF_LOAD_IF_POSSIBLE);
1363 order->SetUnloadType(OUF_UNLOAD_IF_POSSIBLE);
1365 break;
1367 case MOF_STOP_LOCATION:
1368 order->SetStopLocation((OrderStopLocation)data);
1369 break;
1371 case MOF_UNLOAD:
1372 order->SetUnloadType((OrderUnloadFlags)data);
1373 break;
1375 case MOF_LOAD:
1376 order->SetLoadType((OrderLoadFlags)data);
1377 if (data & OLFB_NO_LOAD) order->SetRefit(CARGO_NO_REFIT);
1378 break;
1380 case MOF_DEPOT_ACTION: {
1381 switch (data) {
1382 case DA_ALWAYS_GO:
1383 order->SetDepotOrderType((OrderDepotTypeFlags)(order->GetDepotOrderType() & ~ODTFB_SERVICE));
1384 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() & ~ODATFB_HALT));
1385 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() & ~ODATFB_UNBUNCH));
1386 break;
1388 case DA_SERVICE:
1389 order->SetDepotOrderType((OrderDepotTypeFlags)(order->GetDepotOrderType() | ODTFB_SERVICE));
1390 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() & ~ODATFB_HALT));
1391 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() & ~ODATFB_UNBUNCH));
1392 order->SetRefit(CARGO_NO_REFIT);
1393 break;
1395 case DA_STOP:
1396 order->SetDepotOrderType((OrderDepotTypeFlags)(order->GetDepotOrderType() & ~ODTFB_SERVICE));
1397 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() | ODATFB_HALT));
1398 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() & ~ODATFB_UNBUNCH));
1399 order->SetRefit(CARGO_NO_REFIT);
1400 break;
1402 case DA_UNBUNCH:
1403 order->SetDepotOrderType((OrderDepotTypeFlags)(order->GetDepotOrderType() & ~ODTFB_SERVICE));
1404 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() & ~ODATFB_HALT));
1405 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() | ODATFB_UNBUNCH));
1406 break;
1408 default:
1409 NOT_REACHED();
1411 break;
1414 case MOF_COND_VARIABLE: {
1415 order->SetConditionVariable((OrderConditionVariable)data);
1417 OrderConditionComparator occ = order->GetConditionComparator();
1418 switch (order->GetConditionVariable()) {
1419 case OCV_UNCONDITIONALLY:
1420 order->SetConditionComparator(OCC_EQUALS);
1421 order->SetConditionValue(0);
1422 break;
1424 case OCV_REQUIRES_SERVICE:
1425 if (occ != OCC_IS_TRUE && occ != OCC_IS_FALSE) order->SetConditionComparator(OCC_IS_TRUE);
1426 order->SetConditionValue(0);
1427 break;
1429 case OCV_LOAD_PERCENTAGE:
1430 case OCV_RELIABILITY:
1431 if (order->GetConditionValue() > 100) order->SetConditionValue(100);
1432 [[fallthrough]];
1434 default:
1435 if (occ == OCC_IS_TRUE || occ == OCC_IS_FALSE) order->SetConditionComparator(OCC_EQUALS);
1436 break;
1438 break;
1441 case MOF_COND_COMPARATOR:
1442 order->SetConditionComparator((OrderConditionComparator)data);
1443 break;
1445 case MOF_COND_VALUE:
1446 order->SetConditionValue(data);
1447 break;
1449 case MOF_COND_DESTINATION:
1450 order->SetConditionSkipToOrder(data);
1451 break;
1453 default: NOT_REACHED();
1456 /* Update the windows and full load flags, also for vehicles that share the same order list */
1457 Vehicle *u = v->FirstShared();
1458 DeleteOrderWarnings(u);
1459 for (; u != nullptr; u = u->NextShared()) {
1460 /* Toggle u->current_order "Full load" flag if it changed.
1461 * However, as the same flag is used for depot orders, check
1462 * whether we are not going to a depot as there are three
1463 * cases where the full load flag can be active and only
1464 * one case where the flag is used for depot orders. In the
1465 * other cases for the OrderType the flags are not used,
1466 * so do not care and those orders should not be active
1467 * when this function is called.
1469 if (sel_ord == u->cur_real_order_index &&
1470 (u->current_order.IsType(OT_GOTO_STATION) || u->current_order.IsType(OT_LOADING)) &&
1471 u->current_order.GetLoadType() != order->GetLoadType()) {
1472 u->current_order.SetLoadType(order->GetLoadType());
1475 /* Unbunching data is no longer valid. */
1476 u->ResetDepotUnbunching();
1478 InvalidateVehicleOrder(u, VIWD_MODIFY_ORDERS);
1482 return CommandCost();
1486 * Check if an aircraft has enough range for an order list.
1487 * @param v_new Aircraft to check.
1488 * @param v_order Vehicle currently holding the order list.
1489 * @param first First order in the source order list.
1490 * @return True if the aircraft has enough range for the orders, false otherwise.
1492 static bool CheckAircraftOrderDistance(const Aircraft *v_new, const Vehicle *v_order, const Order *first)
1494 if (first == nullptr || v_new->acache.cached_max_range == 0) return true;
1496 /* Iterate over all orders to check the distance between all
1497 * 'goto' orders and their respective next order (of any type). */
1498 for (const Order *o = first; o != nullptr; o = o->next) {
1499 switch (o->GetType()) {
1500 case OT_GOTO_STATION:
1501 case OT_GOTO_DEPOT:
1502 case OT_GOTO_WAYPOINT:
1503 /* If we don't have a next order, we've reached the end and must check the first order instead. */
1504 if (GetOrderDistance(o, o->next != nullptr ? o->next : first, v_order) > v_new->acache.cached_max_range_sqr) return false;
1505 break;
1507 default: break;
1511 return true;
1515 * Clone/share/copy an order-list of another vehicle.
1516 * @param flags operation to perform
1517 * @param action action to perform
1518 * @param veh_dst destination vehicle to clone orders to
1519 * @param veh_src source vehicle to clone orders from, if any (none for CO_UNSHARE)
1520 * @return the cost of this operation or an error
1522 CommandCost CmdCloneOrder(DoCommandFlag flags, CloneOptions action, VehicleID veh_dst, VehicleID veh_src)
1524 Vehicle *dst = Vehicle::GetIfValid(veh_dst);
1525 if (dst == nullptr || !dst->IsPrimaryVehicle()) return CMD_ERROR;
1527 CommandCost ret = CheckOwnership(dst->owner);
1528 if (ret.Failed()) return ret;
1530 switch (action) {
1531 case CO_SHARE: {
1532 Vehicle *src = Vehicle::GetIfValid(veh_src);
1534 /* Sanity checks */
1535 if (src == nullptr || !src->IsPrimaryVehicle() || dst->type != src->type || dst == src) return CMD_ERROR;
1537 ret = CheckOwnership(src->owner);
1538 if (ret.Failed()) return ret;
1540 /* Trucks can't share orders with busses (and visa versa) */
1541 if (src->type == VEH_ROAD && RoadVehicle::From(src)->IsBus() != RoadVehicle::From(dst)->IsBus()) {
1542 return CMD_ERROR;
1545 /* Is the vehicle already in the shared list? */
1546 if (src->FirstShared() == dst->FirstShared()) return CMD_ERROR;
1548 for (const Order *order : src->Orders()) {
1549 if (!OrderGoesToStation(dst, order)) continue;
1551 /* Allow copying unreachable destinations if they were already unreachable for the source.
1552 * This is basically to allow cloning / autorenewing / autoreplacing vehicles, while the stations
1553 * are temporarily invalid due to reconstruction. */
1554 const Station *st = Station::Get(order->GetDestination());
1555 if (CanVehicleUseStation(src, st) && !CanVehicleUseStation(dst, st)) {
1556 return CommandCost(STR_ERROR_CAN_T_COPY_SHARE_ORDER, GetVehicleCannotUseStationReason(dst, st));
1560 /* Check for aircraft range limits. */
1561 if (dst->type == VEH_AIRCRAFT && !CheckAircraftOrderDistance(Aircraft::From(dst), src, src->GetFirstOrder())) {
1562 return_cmd_error(STR_ERROR_AIRCRAFT_NOT_ENOUGH_RANGE);
1565 if (src->orders == nullptr && !OrderList::CanAllocateItem()) {
1566 return_cmd_error(STR_ERROR_NO_MORE_SPACE_FOR_ORDERS);
1569 if (flags & DC_EXEC) {
1570 /* If the destination vehicle had a OrderList, destroy it.
1571 * We only reset the order indices, if the new orders are obviously different.
1572 * (We mainly do this to keep the order indices valid and in range.) */
1573 DeleteVehicleOrders(dst, false, dst->GetNumOrders() != src->GetNumOrders());
1575 dst->orders = src->orders;
1577 /* Link this vehicle in the shared-list */
1578 dst->AddToShared(src);
1580 InvalidateVehicleOrder(dst, VIWD_REMOVE_ALL_ORDERS);
1581 InvalidateVehicleOrder(src, VIWD_MODIFY_ORDERS);
1583 InvalidateWindowClassesData(GetWindowClassForVehicleType(dst->type), 0);
1585 break;
1588 case CO_COPY: {
1589 Vehicle *src = Vehicle::GetIfValid(veh_src);
1591 /* Sanity checks */
1592 if (src == nullptr || !src->IsPrimaryVehicle() || dst->type != src->type || dst == src) return CMD_ERROR;
1594 ret = CheckOwnership(src->owner);
1595 if (ret.Failed()) return ret;
1597 /* Trucks can't copy all the orders from busses (and visa versa),
1598 * and neither can helicopters and aircraft. */
1599 for (const Order *order : src->Orders()) {
1600 if (!OrderGoesToStation(dst, order)) continue;
1601 Station *st = Station::Get(order->GetDestination());
1602 if (!CanVehicleUseStation(dst, st)) {
1603 return CommandCost(STR_ERROR_CAN_T_COPY_SHARE_ORDER, GetVehicleCannotUseStationReason(dst, st));
1607 /* Check for aircraft range limits. */
1608 if (dst->type == VEH_AIRCRAFT && !CheckAircraftOrderDistance(Aircraft::From(dst), src, src->GetFirstOrder())) {
1609 return_cmd_error(STR_ERROR_AIRCRAFT_NOT_ENOUGH_RANGE);
1612 /* make sure there are orders available */
1613 if (!Order::CanAllocateItem(src->GetNumOrders()) || !OrderList::CanAllocateItem()) {
1614 return_cmd_error(STR_ERROR_NO_MORE_SPACE_FOR_ORDERS);
1617 if (flags & DC_EXEC) {
1618 Order *first = nullptr;
1619 Order **order_dst;
1621 /* If the destination vehicle had an order list, destroy the chain but keep the OrderList.
1622 * We only reset the order indices, if the new orders are obviously different.
1623 * (We mainly do this to keep the order indices valid and in range.) */
1624 DeleteVehicleOrders(dst, true, dst->GetNumOrders() != src->GetNumOrders());
1626 order_dst = &first;
1627 for (const Order *order : src->Orders()) {
1628 *order_dst = new Order();
1629 (*order_dst)->AssignOrder(*order);
1630 order_dst = &(*order_dst)->next;
1632 if (dst->orders == nullptr) {
1633 dst->orders = new OrderList(first, dst);
1634 } else {
1635 assert(dst->orders->GetFirstOrder() == nullptr);
1636 assert(!dst->orders->IsShared());
1637 delete dst->orders;
1638 assert(OrderList::CanAllocateItem());
1639 dst->orders = new OrderList(first, dst);
1642 InvalidateVehicleOrder(dst, VIWD_REMOVE_ALL_ORDERS);
1644 InvalidateWindowClassesData(GetWindowClassForVehicleType(dst->type), 0);
1646 break;
1649 case CO_UNSHARE: return DecloneOrder(dst, flags);
1650 default: return CMD_ERROR;
1653 return CommandCost();
1657 * Add/remove refit orders from an order
1658 * @param flags operation to perform
1659 * @param veh VehicleIndex of the vehicle having the order
1660 * @param order_number number of order to modify
1661 * @param cargo CargoID
1662 * @return the cost of this operation or an error
1664 CommandCost CmdOrderRefit(DoCommandFlag flags, VehicleID veh, VehicleOrderID order_number, CargoID cargo)
1666 if (cargo >= NUM_CARGO && cargo != CARGO_NO_REFIT && cargo != CARGO_AUTO_REFIT) return CMD_ERROR;
1668 const Vehicle *v = Vehicle::GetIfValid(veh);
1669 if (v == nullptr || !v->IsPrimaryVehicle()) return CMD_ERROR;
1671 CommandCost ret = CheckOwnership(v->owner);
1672 if (ret.Failed()) return ret;
1674 Order *order = v->GetOrder(order_number);
1675 if (order == nullptr) return CMD_ERROR;
1677 /* Automatic refit cargo is only supported for goto station orders. */
1678 if (cargo == CARGO_AUTO_REFIT && !order->IsType(OT_GOTO_STATION)) return CMD_ERROR;
1680 if (order->GetLoadType() & OLFB_NO_LOAD) return CMD_ERROR;
1682 if (flags & DC_EXEC) {
1683 order->SetRefit(cargo);
1685 /* Make the depot order an 'always go' order. */
1686 if (cargo != CARGO_NO_REFIT && order->IsType(OT_GOTO_DEPOT)) {
1687 order->SetDepotOrderType((OrderDepotTypeFlags)(order->GetDepotOrderType() & ~ODTFB_SERVICE));
1688 order->SetDepotActionType((OrderDepotActionFlags)(order->GetDepotActionType() & ~ODATFB_HALT));
1691 for (Vehicle *u = v->FirstShared(); u != nullptr; u = u->NextShared()) {
1692 /* Update any possible open window of the vehicle */
1693 InvalidateVehicleOrder(u, VIWD_MODIFY_ORDERS);
1695 /* If the vehicle already got the current depot set as current order, then update current order as well */
1696 if (u->cur_real_order_index == order_number && (u->current_order.GetDepotOrderType() & ODTFB_PART_OF_ORDERS)) {
1697 u->current_order.SetRefit(cargo);
1702 return CommandCost();
1708 * Check the orders of a vehicle, to see if there are invalid orders and stuff
1711 void CheckOrders(const Vehicle *v)
1713 /* Does the user wants us to check things? */
1714 if (_settings_client.gui.order_review_system == 0) return;
1716 /* Do nothing for crashed vehicles */
1717 if (v->vehstatus & VS_CRASHED) return;
1719 /* Do nothing for stopped vehicles if setting is '1' */
1720 if (_settings_client.gui.order_review_system == 1 && (v->vehstatus & VS_STOPPED)) return;
1722 /* do nothing we we're not the first vehicle in a share-chain */
1723 if (v->FirstShared() != v) return;
1725 /* Only check every 20 days, so that we don't flood the message log */
1726 if (v->owner == _local_company && v->day_counter % 20 == 0) {
1727 StringID message = INVALID_STRING_ID;
1729 /* Check the order list */
1730 int n_st = 0;
1732 for (const Order *order : v->Orders()) {
1733 /* Dummy order? */
1734 if (order->IsType(OT_DUMMY)) {
1735 message = STR_NEWS_VEHICLE_HAS_VOID_ORDER;
1736 break;
1738 /* Does station have a load-bay for this vehicle? */
1739 if (order->IsType(OT_GOTO_STATION)) {
1740 const Station *st = Station::Get(order->GetDestination());
1742 n_st++;
1743 if (!CanVehicleUseStation(v, st)) {
1744 message = STR_NEWS_VEHICLE_HAS_INVALID_ENTRY;
1745 } else if (v->type == VEH_AIRCRAFT &&
1746 (AircraftVehInfo(v->engine_type)->subtype & AIR_FAST) &&
1747 (st->airport.GetFTA()->flags & AirportFTAClass::SHORT_STRIP) &&
1748 !_cheats.no_jetcrash.value &&
1749 message == INVALID_STRING_ID) {
1750 message = STR_NEWS_PLANE_USES_TOO_SHORT_RUNWAY;
1755 /* Check if the last and the first order are the same */
1756 if (v->GetNumOrders() > 1) {
1757 const Order *last = v->GetLastOrder();
1759 if (v->orders->GetFirstOrder()->Equals(*last)) {
1760 message = STR_NEWS_VEHICLE_HAS_DUPLICATE_ENTRY;
1764 /* Do we only have 1 station in our order list? */
1765 if (n_st < 2 && message == INVALID_STRING_ID) message = STR_NEWS_VEHICLE_HAS_TOO_FEW_ORDERS;
1767 #ifdef WITH_ASSERT
1768 if (v->orders != nullptr) v->orders->DebugCheckSanity();
1769 #endif
1771 /* We don't have a problem */
1772 if (message == INVALID_STRING_ID) return;
1774 SetDParam(0, v->index);
1775 AddVehicleAdviceNewsItem(message, v->index);
1780 * Removes an order from all vehicles. Triggers when, say, a station is removed.
1781 * @param type The type of the order (OT_GOTO_[STATION|DEPOT|WAYPOINT]).
1782 * @param destination The destination. Can be a StationID, DepotID or WaypointID.
1783 * @param hangar Only used for airports in the destination.
1784 * When false, remove airport and hangar orders.
1785 * When true, remove either airport or hangar order.
1787 void RemoveOrderFromAllVehicles(OrderType type, DestinationID destination, bool hangar)
1789 /* Aircraft have StationIDs for depot orders and never use DepotIDs
1790 * This fact is handled specially below
1793 /* Go through all vehicles */
1794 for (Vehicle *v : Vehicle::Iterate()) {
1795 if ((v->type == VEH_AIRCRAFT && v->current_order.IsType(OT_GOTO_DEPOT) && !hangar ? OT_GOTO_STATION : v->current_order.GetType()) == type &&
1796 (!hangar || v->type == VEH_AIRCRAFT) && v->current_order.GetDestination() == destination) {
1797 v->current_order.MakeDummy();
1798 SetWindowDirty(WC_VEHICLE_VIEW, v->index);
1801 /* Clear the order from the order-list */
1802 int id = -1;
1803 for (Order *order : v->Orders()) {
1804 id++;
1805 restart:
1807 OrderType ot = order->GetType();
1808 if (ot == OT_GOTO_DEPOT && (order->GetDepotActionType() & ODATFB_NEAREST_DEPOT) != 0) continue;
1809 if (ot == OT_GOTO_DEPOT && hangar && v->type != VEH_AIRCRAFT) continue; // Not an aircraft? Can't have a hangar order.
1810 if (ot == OT_IMPLICIT || (v->type == VEH_AIRCRAFT && ot == OT_GOTO_DEPOT && !hangar)) ot = OT_GOTO_STATION;
1811 if (ot == type && order->GetDestination() == destination) {
1812 /* We want to clear implicit orders, but we don't want to make them
1813 * dummy orders. They should just vanish. Also check the actual order
1814 * type as ot is currently OT_GOTO_STATION. */
1815 if (order->IsType(OT_IMPLICIT)) {
1816 order = order->next; // DeleteOrder() invalidates current order
1817 DeleteOrder(v, id);
1818 if (order != nullptr) goto restart;
1819 break;
1822 /* Clear wait time */
1823 v->orders->UpdateTotalDuration(-order->GetWaitTime());
1824 if (order->IsWaitTimetabled()) {
1825 v->orders->UpdateTimetableDuration(-order->GetTimetabledWait());
1826 order->SetWaitTimetabled(false);
1828 order->SetWaitTime(0);
1830 /* Clear order, preserving travel time */
1831 bool travel_timetabled = order->IsTravelTimetabled();
1832 order->MakeDummy();
1833 order->SetTravelTimetabled(travel_timetabled);
1835 for (const Vehicle *w = v->FirstShared(); w != nullptr; w = w->NextShared()) {
1836 /* In GUI, simulate by removing the order and adding it back */
1837 InvalidateVehicleOrder(w, id | (INVALID_VEH_ORDER_ID << 8));
1838 InvalidateVehicleOrder(w, (INVALID_VEH_ORDER_ID << 8) | id);
1844 OrderBackup::RemoveOrder(type, destination, hangar);
1848 * Checks if a vehicle has a depot in its order list.
1849 * @return True iff at least one order is a depot order.
1851 bool Vehicle::HasDepotOrder() const
1853 for (const Order *order : this->Orders()) {
1854 if (order->IsType(OT_GOTO_DEPOT)) return true;
1857 return false;
1861 * Delete all orders from a vehicle
1862 * @param v Vehicle whose orders to reset
1863 * @param keep_orderlist If true, do not free the order list, only empty it.
1864 * @param reset_order_indices If true, reset cur_implicit_order_index and cur_real_order_index
1865 * and cancel the current full load order (if the vehicle is loading).
1866 * If false, _you_ have to make sure the order indices are valid after
1867 * your messing with them!
1869 void DeleteVehicleOrders(Vehicle *v, bool keep_orderlist, bool reset_order_indices)
1871 DeleteOrderWarnings(v);
1873 if (v->IsOrderListShared()) {
1874 /* Remove ourself from the shared order list. */
1875 v->RemoveFromShared();
1876 v->orders = nullptr;
1877 } else if (v->orders != nullptr) {
1878 /* Remove the orders */
1879 v->orders->FreeChain(keep_orderlist);
1880 if (!keep_orderlist) v->orders = nullptr;
1883 /* Unbunching data is no longer valid. */
1884 v->ResetDepotUnbunching();
1886 if (reset_order_indices) {
1887 v->cur_implicit_order_index = v->cur_real_order_index = 0;
1888 if (v->current_order.IsType(OT_LOADING)) {
1889 CancelLoadingDueToDeletedOrder(v);
1895 * Clamp the service interval to the correct min/max. The actual min/max values
1896 * depend on whether it's in days, minutes, or percent.
1897 * @param interval The proposed service interval.
1898 * @param ispercent Whether the interval is a percent.
1899 * @return The service interval clamped to use the chosen units.
1901 uint16_t GetServiceIntervalClamped(int interval, bool ispercent)
1903 /* Service intervals are in percents. */
1904 if (ispercent) return Clamp(interval, MIN_SERVINT_PERCENT, MAX_SERVINT_PERCENT);
1906 /* Service intervals are in minutes. */
1907 if (TimerGameEconomy::UsingWallclockUnits(_game_mode == GM_MENU)) return Clamp(interval, MIN_SERVINT_MINUTES, MAX_SERVINT_MINUTES);
1909 /* Service intervals are in days. */
1910 return Clamp(interval, MIN_SERVINT_DAYS, MAX_SERVINT_DAYS);
1915 * Check if a vehicle has any valid orders
1917 * @return false if there are no valid orders
1918 * @note Conditional orders are not considered valid destination orders
1921 static bool CheckForValidOrders(const Vehicle *v)
1923 for (const Order *order : v->Orders()) {
1924 switch (order->GetType()) {
1925 case OT_GOTO_STATION:
1926 case OT_GOTO_DEPOT:
1927 case OT_GOTO_WAYPOINT:
1928 return true;
1930 default:
1931 break;
1935 return false;
1939 * Compare the variable and value based on the given comparator.
1941 static bool OrderConditionCompare(OrderConditionComparator occ, int variable, int value)
1943 switch (occ) {
1944 case OCC_EQUALS: return variable == value;
1945 case OCC_NOT_EQUALS: return variable != value;
1946 case OCC_LESS_THAN: return variable < value;
1947 case OCC_LESS_EQUALS: return variable <= value;
1948 case OCC_MORE_THAN: return variable > value;
1949 case OCC_MORE_EQUALS: return variable >= value;
1950 case OCC_IS_TRUE: return variable != 0;
1951 case OCC_IS_FALSE: return variable == 0;
1952 default: NOT_REACHED();
1956 template <typename T, std::enable_if_t<std::is_base_of<StrongTypedefBase, T>::value, int> = 0>
1957 static bool OrderConditionCompare(OrderConditionComparator occ, T variable, int value)
1959 return OrderConditionCompare(occ, variable.base(), value);
1963 * Process a conditional order and determine the next order.
1964 * @param order the order the vehicle currently has
1965 * @param v the vehicle to update
1966 * @return index of next order to jump to, or INVALID_VEH_ORDER_ID to use the next order
1968 VehicleOrderID ProcessConditionalOrder(const Order *order, const Vehicle *v)
1970 if (order->GetType() != OT_CONDITIONAL) return INVALID_VEH_ORDER_ID;
1972 bool skip_order = false;
1973 OrderConditionComparator occ = order->GetConditionComparator();
1974 uint16_t value = order->GetConditionValue();
1976 switch (order->GetConditionVariable()) {
1977 case OCV_LOAD_PERCENTAGE: skip_order = OrderConditionCompare(occ, CalcPercentVehicleFilled(v, nullptr), value); break;
1978 case OCV_RELIABILITY: skip_order = OrderConditionCompare(occ, ToPercent16(v->reliability), value); break;
1979 case OCV_MAX_RELIABILITY: skip_order = OrderConditionCompare(occ, ToPercent16(v->GetEngine()->reliability), value); break;
1980 case OCV_MAX_SPEED: skip_order = OrderConditionCompare(occ, v->GetDisplayMaxSpeed() * 10 / 16, value); break;
1981 case OCV_AGE: skip_order = OrderConditionCompare(occ, TimerGameCalendar::DateToYear(v->age), value); break;
1982 case OCV_REQUIRES_SERVICE: skip_order = OrderConditionCompare(occ, v->NeedsServicing(), value); break;
1983 case OCV_UNCONDITIONALLY: skip_order = true; break;
1984 case OCV_REMAINING_LIFETIME: skip_order = OrderConditionCompare(occ, std::max(TimerGameCalendar::DateToYear(v->max_age - v->age + CalendarTime::DAYS_IN_LEAP_YEAR - 1), TimerGameCalendar::Year(0)), value); break;
1985 default: NOT_REACHED();
1988 return skip_order ? order->GetConditionSkipToOrder() : (VehicleOrderID)INVALID_VEH_ORDER_ID;
1992 * Update the vehicle's destination tile from an order.
1993 * @param order the order the vehicle currently has
1994 * @param v the vehicle to update
1995 * @param conditional_depth the depth (amount of steps) to go with conditional orders. This to prevent infinite loops.
1996 * @param pbs_look_ahead Whether we are forecasting orders for pbs reservations in advance. If true, the order indices must not be modified.
1998 bool UpdateOrderDest(Vehicle *v, const Order *order, int conditional_depth, bool pbs_look_ahead)
2000 if (conditional_depth > v->GetNumOrders()) {
2001 v->current_order.Free();
2002 v->SetDestTile(0);
2003 return false;
2006 switch (order->GetType()) {
2007 case OT_GOTO_STATION:
2008 v->SetDestTile(v->GetOrderStationLocation(order->GetDestination()));
2009 return true;
2011 case OT_GOTO_DEPOT:
2012 if ((order->GetDepotOrderType() & ODTFB_SERVICE) && !v->NeedsServicing()) {
2013 assert(!pbs_look_ahead);
2014 UpdateVehicleTimetable(v, true);
2015 v->IncrementRealOrderIndex();
2016 break;
2019 if (v->current_order.GetDepotActionType() & ODATFB_NEAREST_DEPOT) {
2020 /* If the vehicle can't find its destination, delay its next search.
2021 * In case many vehicles are in this state, use the vehicle index to spread out pathfinder calls. */
2022 if (v->dest_tile == 0 && TimerGameEconomy::date_fract != (v->index % Ticks::DAY_TICKS)) break;
2024 /* We need to search for the nearest depot (hangar). */
2025 ClosestDepot closestDepot = v->FindClosestDepot();
2027 if (closestDepot.found) {
2028 /* PBS reservations cannot reverse */
2029 if (pbs_look_ahead && closestDepot.reverse) return false;
2031 v->SetDestTile(closestDepot.location);
2032 v->current_order.SetDestination(closestDepot.destination);
2034 /* If there is no depot in front, reverse automatically (trains only) */
2035 if (v->type == VEH_TRAIN && closestDepot.reverse) Command<CMD_REVERSE_TRAIN_DIRECTION>::Do(DC_EXEC, v->index, false);
2037 if (v->type == VEH_AIRCRAFT) {
2038 Aircraft *a = Aircraft::From(v);
2039 if (a->state == FLYING && a->targetairport != closestDepot.destination) {
2040 /* The aircraft is now heading for a different hangar than the next in the orders */
2041 AircraftNextAirportPos_and_Order(a);
2044 return true;
2047 /* If there is no depot, we cannot help PBS either. */
2048 if (pbs_look_ahead) return false;
2050 UpdateVehicleTimetable(v, true);
2051 v->IncrementRealOrderIndex();
2052 } else {
2053 if (v->type != VEH_AIRCRAFT) {
2054 v->SetDestTile(Depot::Get(order->GetDestination())->xy);
2055 } else {
2056 Aircraft *a = Aircraft::From(v);
2057 DestinationID destination = a->current_order.GetDestination();
2058 if (a->targetairport != destination) {
2059 /* The aircraft is now heading for a different hangar than the next in the orders */
2060 a->SetDestTile(a->GetOrderStationLocation(destination));
2063 return true;
2065 break;
2067 case OT_GOTO_WAYPOINT:
2068 v->SetDestTile(Waypoint::Get(order->GetDestination())->xy);
2069 return true;
2071 case OT_CONDITIONAL: {
2072 assert(!pbs_look_ahead);
2073 VehicleOrderID next_order = ProcessConditionalOrder(order, v);
2074 if (next_order != INVALID_VEH_ORDER_ID) {
2075 /* Jump to next_order. cur_implicit_order_index becomes exactly that order,
2076 * cur_real_order_index might come after next_order. */
2077 UpdateVehicleTimetable(v, false);
2078 v->cur_implicit_order_index = v->cur_real_order_index = next_order;
2079 v->UpdateRealOrderIndex();
2080 v->current_order_time += v->GetOrder(v->cur_real_order_index)->GetTimetabledTravel();
2082 /* Disable creation of implicit orders.
2083 * When inserting them we do not know that we would have to make the conditional orders point to them. */
2084 if (v->IsGroundVehicle()) {
2085 uint16_t &gv_flags = v->GetGroundVehicleFlags();
2086 SetBit(gv_flags, GVF_SUPPRESS_IMPLICIT_ORDERS);
2088 } else {
2089 UpdateVehicleTimetable(v, true);
2090 v->IncrementRealOrderIndex();
2092 break;
2095 default:
2096 v->SetDestTile(0);
2097 return false;
2100 assert(v->cur_implicit_order_index < v->GetNumOrders());
2101 assert(v->cur_real_order_index < v->GetNumOrders());
2103 /* Get the current order */
2104 order = v->GetOrder(v->cur_real_order_index);
2105 if (order != nullptr && order->IsType(OT_IMPLICIT)) {
2106 assert(v->GetNumManualOrders() == 0);
2107 order = nullptr;
2110 if (order == nullptr) {
2111 v->current_order.Free();
2112 v->SetDestTile(0);
2113 return false;
2116 v->current_order = *order;
2117 return UpdateOrderDest(v, order, conditional_depth + 1, pbs_look_ahead);
2121 * Handle the orders of a vehicle and determine the next place
2122 * to go to if needed.
2123 * @param v the vehicle to do this for.
2124 * @return true *if* the vehicle is eligible for reversing
2125 * (basically only when leaving a station).
2127 bool ProcessOrders(Vehicle *v)
2129 switch (v->current_order.GetType()) {
2130 case OT_GOTO_DEPOT:
2131 /* Let a depot order in the orderlist interrupt. */
2132 if (!(v->current_order.GetDepotOrderType() & ODTFB_PART_OF_ORDERS)) return false;
2133 break;
2135 case OT_LOADING:
2136 return false;
2138 case OT_LEAVESTATION:
2139 if (v->type != VEH_AIRCRAFT) return false;
2140 break;
2142 default: break;
2146 * Reversing because of order change is allowed only just after leaving a
2147 * station (and the difficulty setting to allowed, of course)
2148 * this can be detected because only after OT_LEAVESTATION, current_order
2149 * will be reset to nothing. (That also happens if no order, but in that case
2150 * it won't hit the point in code where may_reverse is checked)
2152 bool may_reverse = v->current_order.IsType(OT_NOTHING);
2154 /* Check if we've reached a 'via' destination. */
2155 if (((v->current_order.IsType(OT_GOTO_STATION) && (v->current_order.GetNonStopType() & ONSF_NO_STOP_AT_DESTINATION_STATION)) || v->current_order.IsType(OT_GOTO_WAYPOINT)) &&
2156 IsTileType(v->tile, MP_STATION) &&
2157 v->current_order.GetDestination() == GetStationIndex(v->tile)) {
2158 v->DeleteUnreachedImplicitOrders();
2159 /* We set the last visited station here because we do not want
2160 * the train to stop at this 'via' station if the next order
2161 * is a no-non-stop order; in that case not setting the last
2162 * visited station will cause the vehicle to still stop. */
2163 v->last_station_visited = v->current_order.GetDestination();
2164 UpdateVehicleTimetable(v, true);
2165 v->IncrementImplicitOrderIndex();
2168 /* Get the current order */
2169 assert(v->cur_implicit_order_index == 0 || v->cur_implicit_order_index < v->GetNumOrders());
2170 v->UpdateRealOrderIndex();
2172 const Order *order = v->GetOrder(v->cur_real_order_index);
2173 if (order != nullptr && order->IsType(OT_IMPLICIT)) {
2174 assert(v->GetNumManualOrders() == 0);
2175 order = nullptr;
2178 /* If no order, do nothing. */
2179 if (order == nullptr || (v->type == VEH_AIRCRAFT && !CheckForValidOrders(v))) {
2180 if (v->type == VEH_AIRCRAFT) {
2181 /* Aircraft do something vastly different here, so handle separately */
2182 HandleMissingAircraftOrders(Aircraft::From(v));
2183 return false;
2186 v->current_order.Free();
2187 v->SetDestTile(0);
2188 return false;
2191 /* If it is unchanged, keep it. */
2192 if (order->Equals(v->current_order) && (v->type == VEH_AIRCRAFT || v->dest_tile != 0) &&
2193 (v->type != VEH_SHIP || !order->IsType(OT_GOTO_STATION) || Station::Get(order->GetDestination())->ship_station.tile != INVALID_TILE)) {
2194 return false;
2197 /* Otherwise set it, and determine the destination tile. */
2198 v->current_order = *order;
2200 InvalidateVehicleOrder(v, VIWD_MODIFY_ORDERS);
2201 switch (v->type) {
2202 default:
2203 NOT_REACHED();
2205 case VEH_ROAD:
2206 case VEH_TRAIN:
2207 break;
2209 case VEH_AIRCRAFT:
2210 case VEH_SHIP:
2211 SetWindowClassesDirty(GetWindowClassForVehicleType(v->type));
2212 break;
2215 return UpdateOrderDest(v, order) && may_reverse;
2219 * Check whether the given vehicle should stop at the given station
2220 * based on this order and the non-stop settings.
2221 * @param v the vehicle that might be stopping.
2222 * @param station the station to stop at.
2223 * @return true if the vehicle should stop.
2225 bool Order::ShouldStopAtStation(const Vehicle *v, StationID station) const
2227 bool is_dest_station = this->IsType(OT_GOTO_STATION) && this->dest == station;
2229 return (!this->IsType(OT_GOTO_DEPOT) || (this->GetDepotOrderType() & ODTFB_PART_OF_ORDERS) != 0) &&
2230 v->last_station_visited != station && // Do stop only when we've not just been there
2231 /* Finally do stop when there is no non-stop flag set for this type of station. */
2232 !(this->GetNonStopType() & (is_dest_station ? ONSF_NO_STOP_AT_DESTINATION_STATION : ONSF_NO_STOP_AT_INTERMEDIATE_STATIONS));
2235 bool Order::CanLoadOrUnload() const
2237 return (this->IsType(OT_GOTO_STATION) || this->IsType(OT_IMPLICIT)) &&
2238 (this->GetNonStopType() & ONSF_NO_STOP_AT_DESTINATION_STATION) == 0 &&
2239 ((this->GetLoadType() & OLFB_NO_LOAD) == 0 ||
2240 (this->GetUnloadType() & OUFB_NO_UNLOAD) == 0);
2244 * A vehicle can leave the current station with cargo if:
2245 * 1. it can load cargo here OR
2246 * 2a. it could leave the last station with cargo AND
2247 * 2b. it doesn't have to unload all cargo here.
2249 bool Order::CanLeaveWithCargo(bool has_cargo) const
2251 return (this->GetLoadType() & OLFB_NO_LOAD) == 0 || (has_cargo &&
2252 (this->GetUnloadType() & (OUFB_UNLOAD | OUFB_TRANSFER)) == 0);